@indielayer/ui 2.0.0 → 2.1.0

package/docs/search/index.json

@@ -1 +1 @@
-[{"name":"Icons","description":"Custom icon set integration for Indielayer UI components.","url":"/icons","category":"guide"},{"name":"Colors","description":"Color palette, semantic tokens, and color props on components.","url":"/colors","category":"guide"},{"name":"Typography","description":"Type scale and typography utilities used across the library.","url":"/typography","category":"guide"},{"name":"Accordion","description":"Accordion is a component that allows you to collapse and expand content.","url":"/component/accordion","category":"component"},{"name":"Alert","description":"Alerts are used to communicate a state that affects a system, feature or page.","url":"/component/alert","category":"component"},{"name":"Avatar","description":"Avatars are used to represent a user.","url":"/component/avatar","category":"component"},{"name":"Badge","description":"Badges are used to display a small amount of information.","url":"/component/badge","category":"component"},{"name":"Breadcrumbs","description":"Breadcrumbs are used to indicate the current page\\","url":"/component/breadcrumbs","category":"component"},{"name":"Button","description":"Buttons allow users to perform actions and make choices with a single click. They are commonly used for submitting forms, opening dialogs or menus, and executing commands. Buttons can be customized with different styles, sizes, and icons to fit various use cases.","url":"/component/button","category":"component"},{"name":"Card","description":"Cards are used to display content in an organized manner.","url":"/component/card","category":"component"},{"name":"Carousel","description":"A carousel is a rotating set of images.","url":"/component/carousel","category":"component"},{"name":"Checkbox","description":"Checkboxes enable users to select one or multiple options from a list. They are ideal for toggling settings or making selections where more than one choice is allowed. Each checkbox can be checked or unchecked independently.","url":"/component/checkbox","category":"component"},{"name":"Container","description":"Containers provide a flexible layout element for grouping and organizing content. They help structure pages by controlling width, alignment, and spacing, ensuring consistent presentation across different sections.","url":"/component/container","category":"component"},{"name":"Datepicker","description":"The datepicker component is used to select a date or time.","url":"/component/datepicker","category":"component"},{"name":"Divider","description":"Dividers are used to separate content.","url":"/component/divider","category":"component"},{"name":"Drawer","description":"Drawers slide in from the edge of the screen to present navigation, options, or additional content without disrupting the main view. They are ideal for menus, filters, or contextual panels.","url":"/component/drawer","category":"component"},{"name":"Empty","description":"Empty states communicate when there is no content to show. Use them in tables, lists, and panels with a title, description, optional icon, and actions.","url":"/component/empty","category":"component"},{"name":"Form","description":"Forms provide a structured way to collect and validate user input, such as text, selections, and files. They support features like validation, grouping, and submission handling, making it easy to build interactive and accessible data entry interfaces.","url":"/component/form","category":"component"},{"name":"FormGroup","description":"Form groups organize related form elements together, providing structure and shared validation. They help group checkboxes, radio buttons, or inputs that belong to the same logical section.","url":"/component/formGroup","category":"component"},{"name":"Icon","description":"Icons visually represent actions and concepts. Register SVG paths in a global map, then reference them by name on XIcon.","url":"/component/icon","category":"component"},{"name":"Image","description":"Loads a remote image after preloading. Use a background on the wrapper for a visible placeholder until load completes.","url":"/component/image","category":"component"},{"name":"InfiniteLoader","description":"InfiniteLoader is a component that allows you to load data on demand as users scroll through a list.","url":"/component/infiniteLoader","category":"component"},{"name":"Input","description":"This is a text input component that allows users to enter and edit text.","url":"/component/input","category":"component"},{"name":"Input Group","description":"Input groups combine multiple inline fields (Input, Textarea, Select, Datepicker, Button) into one control with a shared label and footer.","url":"/component/inputGroup","category":"component"},{"name":"Link","description":"Links are used to navigate to a different page.","url":"/component/link","category":"component"},{"name":"Loader","description":"Loader component is used to show a loading state.","url":"/component/loader","category":"component"},{"name":"Menu","description":"Menus are used to display a list of options.","url":"/component/menu","category":"component"},{"name":"Modal","description":"Modals are used to display content on top of the current page.","url":"/component/modal","category":"component"},{"name":"Notifications","description":"Notifications provide timely feedback or alerts to users, such as success messages, warnings, or errors. They help keep users informed about important events or actions.","url":"/component/notifications","category":"component"},{"name":"Pagination","description":"Pagination divides large sets of content into manageable pages, allowing users to navigate through items efficiently. It is commonly used in tables, lists, and search results to improve usability and performance.","url":"/component/pagination","category":"component"},{"name":"Popover","description":"Popovers display additional information or interactive content in a floating overlay, anchored to a trigger element. They are useful for tooltips, menus, or contextual actions without navigating away from the current view.","url":"/component/popover","category":"component"},{"name":"Progress","description":"Progress indicators visually communicate the completion status of a task or process, such as file uploads or data loading. They help users understand how much work remains.","url":"/component/progress","category":"component"},{"name":"QR Code","description":"The QR Code component is used to generate a QR code.","url":"/component/qrCode","category":"component"},{"name":"Radio","description":"Radios allow the user to select one option from a set. Use classic radios for standard options, or x-radio-button for a button-shaped variant. Place several x-radio-button options inside x-form-group for a joined segmented control.","url":"/component/radio","category":"component"},{"name":"Scroll","description":"The Scroll component enhances scrolling experiences by adding visual cues, such as inner shadows, to indicate additional content. It is useful for horizontally or vertically scrolling lists and containers.","url":"/component/scroll","category":"component"},{"name":"Select","description":"Selects allow the user to select one or more options from a set.","url":"/component/select","category":"component"},{"name":"Skeleton","description":"Skeletons provide placeholder elements that mimic the layout of content while data is loading. They improve perceived performance by giving users a visual cue that content is being fetched.","url":"/component/skeleton","category":"component"},{"name":"Slider","description":"Sliders allow users to select a numeric value or range by dragging a handle along a track. They are ideal for adjusting settings such as volume, brightness, or price filters.","url":"/component/slider","category":"component"},{"name":"Spacer","description":"Spacers create adjustable gaps between elements within flex layouts, helping to control spacing and alignment without using margin or padding directly.","url":"/component/spacer","category":"component"},{"name":"Spinner","description":"Spinners visually indicate that a background process or operation is ongoing, such as loading data or submitting a form. They help manage user expectations by signaling that the system is working.","url":"/component/spinner","category":"component"},{"name":"Stepper","description":"Multi-step wizard with declarative steps, named panel slots, programmatic next/prev navigation, validation hooks, and optional sidebar summaries.","url":"/component/stepper","category":"component"},{"name":"Table","description":"Tables display tabular data with single- or multi-column sorting, selection, expandable rows, and virtual lists.","url":"/component/table","category":"component"},{"name":"Tabs","description":"Tabs are used to navigate through a set of views.","url":"/component/tabs","category":"component"},{"name":"Tag","description":"Tags are compact elements used to display brief information, such as categories, statuses, or labels. They help organize content and provide quick context or filtering options within lists and interfaces.","url":"/component/tag","category":"component"},{"name":"Textarea","description":"Textareas provide a multi-line input field for users to enter longer text, such as comments, descriptions, or messages. They support resizing and can be customized for different use cases.","url":"/component/textarea","category":"component"},{"name":"Toggle","description":"Toggles provide a simple switch interface for enabling or disabling a setting, or switching between two mutually exclusive states. They are ideal for binary options such as on/off, active/inactive, or show/hide.","url":"/component/toggle","category":"component"},{"name":"Tooltip","description":"Tooltips display contextual help on hover. Use XToggleTip for a compact info-icon pattern beside labels.","url":"/component/tooltip","category":"component"},{"name":"Upload","description":"Upload is a component that allows you to upload files.","url":"/component/upload","category":"component"},{"name":"VirtualGrid","description":"VirtualGrid is a component that allows you to render a grid of items in a virtualized way. It is a high-performance component that is used to render large grids of items.","url":"/component/virtualGrid","category":"component"},{"name":"VirtualList","description":"VirtualList is a component that allows you to render a list of items in a virtualized way. It is a high-performance component that is used to render large lists of items.","url":"/component/virtualList","category":"component"}]
+[{"name":"Icons","description":"Custom icon set integration for Indielayer UI components.","url":"/icons","category":"guide"},{"name":"Colors","description":"Color palette, semantic tokens, and color props on components.","url":"/colors","category":"guide"},{"name":"Typography","description":"Type scale and typography utilities used across the library.","url":"/typography","category":"guide"},{"name":"Accordion","description":"Collapsible panels for showing and hiding related content. Use x-accordion with x-accordion-item when space is limited and users need progressive disclosure.","url":"/component/accordion","category":"component"},{"name":"Alert","description":"Inline notices for system, feature, or page status—success, warning, error, or info. Use alerts when the message should stay visible until addressed.","url":"/component/alert","category":"component"},{"name":"Avatar","description":"Displays a user's photo, initials, or icon in a compact frame. Use avatars in lists, headers, and comments to identify people at a glance.","url":"/component/avatar","category":"component"},{"name":"Badge","description":"Small status indicators that overlay or sit beside another element—counts, labels, or presence dots. Use badges to draw attention without interrupting the layout.","url":"/component/badge","category":"component"},{"name":"Breadcrumbs","description":"Shows the current page's place in a navigational hierarchy. Use breadcrumbs for deep page trees so users can jump back to parent sections.","url":"/component/breadcrumbs","category":"component"},{"name":"Button","description":"Clickable controls for primary actions—submit, open dialogs, or run commands. Customize style, size, and icons; group related actions with x-button-group.","url":"/component/button","category":"component"},{"name":"Card","description":"A bordered content container for grouping related information, media, and actions. Use cards in grids and dashboards when each block should stand alone.","url":"/component/card","category":"component"},{"name":"Carousel","description":"A sliding viewport for cycling through images or content panels. Use carousels for galleries and featured items when horizontal space is limited.","url":"/component/carousel","category":"component"},{"name":"Checkbox","description":"Multi-select controls for choosing one or more options independently. Use checkboxes for settings and lists where more than one choice can be active.","url":"/component/checkbox","category":"component"},{"name":"Container","description":"Layout wrapper that constrains content width and alignment for consistent page structure. Use containers to center and pad main content across breakpoints.","url":"/component/container","category":"component"},{"name":"Datepicker","description":"Date and time picker styled as a wrapper around @vuepic/vue-datepicker. Use it for forms that need calendar or datetime selection with Indielayer look and feel.","url":"/component/datepicker","category":"component"},{"name":"Divider","description":"A horizontal or vertical rule that separates sections of content. Use dividers in lists, toolbars, and layouts to create clear visual breaks.","url":"/component/divider","category":"component"},{"name":"Drawer","description":"Panels that slide in from the screen edge for navigation, filters, or extra content. Use drawers when side context should overlay without leaving the page.","url":"/component/drawer","category":"component"},{"name":"Empty","description":"Empty states communicate when there is no content to show. Use them in tables, lists, and panels with a title, description, optional icon, and actions.","url":"/component/empty","category":"component"},{"name":"Form","description":"Structured form wrapper for collecting and validating user input. Use x-form to group fields, run validation, and handle submit in one place.","url":"/component/form","category":"component"},{"name":"FormGroup","description":"Groups related fields with a shared label and validation context. Use form groups for checkboxes, radios, or inputs that belong to one logical section.","url":"/component/formGroup","category":"component"},{"name":"Icon","description":"Icons visually represent actions and concepts. Register SVG paths in a global map, then reference them by name on XIcon.","url":"/component/icon","category":"component"},{"name":"Image","description":"Loads a remote image after preloading. Use a background on the wrapper for a visible placeholder until load completes.","url":"/component/image","category":"component"},{"name":"InfiniteLoader","description":"Loads more list items as the user scrolls near the end of a container. Use InfiniteLoader for feeds and catalogs that grow on demand.","url":"/component/infiniteLoader","category":"component"},{"name":"Input","description":"Single-line text field for entering and editing short values. Use x-input in forms for names, emails, search, and other one-line data.","url":"/component/input","category":"component"},{"name":"Input Group","description":"Input groups combine multiple inline fields (Input, Textarea, Select, Datepicker, Button) into one control with a shared label and footer.","url":"/component/inputGroup","category":"component"},{"name":"Link","description":"Styled anchor for navigating to another page or external URL. Use x-link when you need consistent link styling, external indicators, and accessibility.","url":"/component/link","category":"component"},{"name":"Loader","description":"Full-area loading overlay that blocks interaction while content or an action completes. Use Loader when the whole region should wait before continuing.","url":"/component/loader","category":"component"},{"name":"Menu","description":"Dropdown list of actionable items triggered from a button or other control. Use x-menu with x-menu-item for contextual actions and navigation.","url":"/component/menu","category":"component"},{"name":"Modal","description":"Dialog overlay that focuses attention on a task or message above the current page. Use modals for confirmations, forms, and details that need temporary focus.","url":"/component/modal","category":"component"},{"name":"Notifications","description":"Toast-style feedback for success, warning, or error after an action. Use notifications for transient messages that should not block the page.","url":"/component/notifications","category":"component"},{"name":"Pagination","description":"Controls for moving through large result sets page by page. Use pagination with tables, lists, and search results to keep each view manageable.","url":"/component/pagination","category":"component"},{"name":"Popover","description":"Floating panel anchored to a trigger for extra content or actions. Use popovers for menus and contextual UI without leaving the current view.","url":"/component/popover","category":"component"},{"name":"Progress","description":"Bar that shows how far a task or process has completed. Use progress for uploads, multi-step jobs, and determinate loading states.","url":"/component/progress","category":"component"},{"name":"QR Code","description":"Renders a QR code from a string or URL for scanning with mobile devices. Use it for share links, payments, and quick machine-readable payloads.","url":"/component/qrCode","category":"component"},{"name":"Radio","description":"Radios allow the user to select one option from a set. Use classic radios for standard options, or x-radio-button for a button-shaped variant. Place several x-radio-button options inside x-form-group for a joined segmented control.","url":"/component/radio","category":"component"},{"name":"Scroll","description":"Scroll container with optional edge shadows that hint at more content. Use Scroll for overflow lists and panels that scroll vertically or horizontally.","url":"/component/scroll","category":"component"},{"name":"Select","description":"Dropdown for choosing one or more options from a predefined list. Use Select for enums, filters, and form fields where free text is not needed.","url":"/component/select","category":"component"},{"name":"Skeleton","description":"Placeholder shapes that mirror content layout while data loads. Use skeletons to reduce layout shift and improve perceived loading performance.","url":"/component/skeleton","category":"component"},{"name":"Slider","description":"Track with a draggable handle for picking a numeric value or range. Use sliders for volume, brightness, price filters, and similar continuous settings.","url":"/component/slider","category":"component"},{"name":"Spacer","description":"Flex-friendly gap that expands or shrinks between siblings without extra margin or padding. Use spacers to push items apart in toolbars and rows.","url":"/component/spacer","category":"component"},{"name":"Spinner","description":"Animated indicator that a background process is still running. Use spinners for indeterminate loading when completion percentage is unknown.","url":"/component/spinner","category":"component"},{"name":"Stepper","description":"Multi-step wizard with declarative steps, named panel slots, programmatic next/prev navigation, validation hooks, and optional sidebar summaries.","url":"/component/stepper","category":"component"},{"name":"Table","description":"Tables display tabular data with single- or multi-column sorting, selection, expandable rows, and virtual lists.","url":"/component/table","category":"component"},{"name":"Tabs","description":"Tabbed navigation that switches between related views in the same region. Use x-tab-group with x-tab when content shares context but not space.","url":"/component/tabs","category":"component"},{"name":"Tag","description":"Compact labels for categories, statuses, or filters. Use tags in lists and chip groups when a short keyword should stand out.","url":"/component/tag","category":"component"},{"name":"Textarea","description":"Multi-line text field for longer content such as comments and descriptions. Use Textarea when a single-line input is not enough.","url":"/component/textarea","category":"component"},{"name":"Toggle","description":"Binary switch for on/off settings and mutually exclusive states. Use toggles when the choice should feel instant and reversible.","url":"/component/toggle","category":"component"},{"name":"Tooltip","description":"Tooltips display contextual help on hover. Use XToggleTip for a compact info-icon pattern beside labels.","url":"/component/tooltip","category":"component"},{"name":"Upload","description":"File picker with drag-and-drop for selecting one or more files to upload. Use Upload when forms need images, documents, or other file input with accept filters.","url":"/component/upload","category":"component"},{"name":"VirtualGrid","description":"Renders only visible cells of a large grid for better scroll performance. Use VirtualGrid when a dense grid would be too heavy to mount all at once.","url":"/component/virtualGrid","category":"component"},{"name":"VirtualList","description":"Renders only visible rows of a long list for better scroll performance. Use VirtualList for feeds and catalogs with thousands of items.","url":"/component/virtualList","category":"component"}]

package/lib/common/buttonGroupRadius.d.ts

@@ -0,0 +1,3 @@
+import type { InputGroupPosition } from './inputGroupRadius';
+export type ButtonGroupPosition = InputGroupPosition;
+export declare function buttonGroupRadiusClasses(position?: ButtonGroupPosition | null, pill?: boolean): string[];

package/lib/common/buttonGroupRadius.js

@@ -0,0 +1,6 @@
+//#region src/common/buttonGroupRadius.ts
+function e(e, t = !1) {
+	return e ? e === "only" ? [t ? "rounded-full" : "rounded-md"] : e === "first" ? [t ? "rounded-s-full" : "rounded-s-md"] : e === "last" ? [t ? "rounded-e-full" : "rounded-e-md"] : ["rounded-none"] : [];
+}
+//#endregion
+export { e as buttonGroupRadiusClasses };

package/lib/common/props.d.ts

@@ -14,7 +14,7 @@ import type { Prop } from 'vue';
  * Plain `Boolean` props are cast to `false` when absent in Vue 3.
  * @see https://vuejs.org/guide/components/props.html#boolean-casting
  */
-export declare function optionalBooleanProp(): Prop<boolean | undefined>;
+export declare function optionalBooleanProp(description?: string): Prop<boolean | undefined>;
 /** Shared variant booleans for Button and ButtonGroup. */
 export declare const variantBooleanProps: () => {
     outlined: Prop<boolean | undefined>;

package/lib/common/props.js

@@ -1,18 +1,19 @@
 //#region src/common/props.ts
-function e() {
+function e(e) {
 	return {
 		type: Boolean,
-		default: void 0
+		default: void 0,
+		...e ? { description: e } : {}
 	};
 }
 var t = () => ({
-	outlined: e(),
-	rounded: e(),
-	glow: e(),
-	ghost: e(),
-	light: e(),
-	flat: e(),
-	block: e()
+	outlined: e("Outline style with a transparent fill."),
+	rounded: e("Fully rounded corners (pill shape)."),
+	glow: e("Soft colored glow behind the control."),
+	ghost: e("Minimal style with no background until hover."),
+	light: e("Tinted background using the color at low opacity."),
+	flat: e("Removes elevation and border emphasis."),
+	block: e("Stretches to the full width of the parent.")
 });
 //#endregion
 export { e as optionalBooleanProp, t as variantBooleanProps };

package/lib/components/accordion/Accordion.vue.d.ts

@@ -4,15 +4,26 @@ declare const accordionProps: {
     tag: {
         type: StringConstructor;
         default: string;
+        description: string;
+    };
+    disabled: {
+        type: BooleanConstructor;
+        description: string;
     };
-    disabled: BooleanConstructor;
     expanded: import("vue").Prop<boolean | undefined>;
     showIcon: {
         type: BooleanConstructor;
         default: boolean;
+        description: string;
+    };
+    icon: {
+        type: StringConstructor;
+        description: string;
+    };
+    iconAlign: {
+        type: PropType<"left" | "right">;
+        description: string;
     };
-    icon: StringConstructor;
-    iconAlign: PropType<"left" | "right">;
 };
 export type AccordionProps = ExtractPublicPropTypes<typeof accordionProps>;
 export type AccordionInjection = AccordionProps & {
@@ -25,28 +36,50 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
     tag: {
         type: StringConstructor;
         default: string;
+        description: string;
+    };
+    disabled: {
+        type: BooleanConstructor;
+        description: string;
     };
-    disabled: BooleanConstructor;
     expanded: import("vue").Prop<boolean | undefined>;
     showIcon: {
         type: BooleanConstructor;
         default: boolean;
+        description: string;
+    };
+    icon: {
+        type: StringConstructor;
+        description: string;
+    };
+    iconAlign: {
+        type: PropType<"left" | "right">;
+        description: string;
     };
-    icon: StringConstructor;
-    iconAlign: PropType<"left" | "right">;
 }>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
     tag: {
         type: StringConstructor;
         default: string;
+        description: string;
+    };
+    disabled: {
+        type: BooleanConstructor;
+        description: string;
     };
-    disabled: BooleanConstructor;
     expanded: import("vue").Prop<boolean | undefined>;
     showIcon: {
         type: BooleanConstructor;
         default: boolean;
+        description: string;
+    };
+    icon: {
+        type: StringConstructor;
+        description: string;
+    };
+    iconAlign: {
+        type: PropType<"left" | "right">;
+        description: string;
     };
-    icon: StringConstructor;
-    iconAlign: PropType<"left" | "right">;
 }>> & Readonly<{}>, {
     disabled: boolean;
     tag: string;

package/lib/components/accordion/Accordion.vue_vue_type_script_setup_true_lang.js

@@ -6,19 +6,31 @@ import { createElementBlock as r, defineComponent as i, normalizeClass as a, nor
 var d = /* @__PURE__ */ i({
 	name: "XAccordion",
 	validators: {},
+	docs: { slots: { default: "Accordion items (typically x-accordion-item children)." } },
 	props: {
 		tag: {
 			type: String,
-			default: "div"
+			default: "div",
+			description: "Root element tag."
 		},
-		disabled: Boolean,
-		expanded: n(),
+		disabled: {
+			type: Boolean,
+			description: "Disables all accordion items when set."
+		},
+		expanded: n("Default expanded state passed to child items."),
 		showIcon: {
 			type: Boolean,
-			default: !0
+			default: !0,
+			description: "Shows the expand/collapse icon on child items."
 		},
-		icon: String,
-		iconAlign: String
+		icon: {
+			type: String,
+			description: "Default expand/collapse icon name for child items."
+		},
+		iconAlign: {
+			type: String,
+			description: "Default icon alignment for child items (left or right)."
+		}
 	},
 	setup(n) {
 		let i = n;

package/lib/components/accordion/AccordionItem.vue.d.ts

@@ -5,17 +5,26 @@ declare const accordionItemProps: {
     tag: {
         type: StringConstructor;
         default: string;
+        description: string;
+    };
+    disabled: {
+        type: BooleanConstructor;
+        description: string;
     };
-    disabled: BooleanConstructor;
     expanded: import("vue").Prop<boolean | undefined>;
     showIcon: {
         type: BooleanConstructor;
         default: boolean;
+        description: string;
+    };
+    icon: {
+        type: StringConstructor;
+        description: string;
     };
-    icon: StringConstructor;
     iconAlign: {
         type: PropType<"left" | "right">;
         default: string;
+        description: string;
     };
 };
 export type AccordionItemAlign = typeof accordionItemAlign[number];
@@ -31,17 +40,26 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
     tag: {
         type: StringConstructor;
         default: string;
+        description: string;
+    };
+    disabled: {
+        type: BooleanConstructor;
+        description: string;
     };
-    disabled: BooleanConstructor;
     expanded: import("vue").Prop<boolean | undefined>;
     showIcon: {
         type: BooleanConstructor;
         default: boolean;
+        description: string;
+    };
+    icon: {
+        type: StringConstructor;
+        description: string;
     };
-    icon: StringConstructor;
     iconAlign: {
         type: PropType<"left" | "right">;
         default: string;
+        description: string;
     };
 }>, {
     toggle: () => void;
@@ -51,17 +69,26 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
     tag: {
         type: StringConstructor;
         default: string;
+        description: string;
+    };
+    disabled: {
+        type: BooleanConstructor;
+        description: string;
     };
-    disabled: BooleanConstructor;
     expanded: import("vue").Prop<boolean | undefined>;
     showIcon: {
         type: BooleanConstructor;
         default: boolean;
+        description: string;
+    };
+    icon: {
+        type: StringConstructor;
+        description: string;
     };
-    icon: StringConstructor;
     iconAlign: {
         type: PropType<"left" | "right">;
         default: string;
+        description: string;
     };
 }>> & Readonly<{
     onChange?: ((...args: any[]) => any) | undefined;

package/lib/components/accordion/AccordionItem.vue_vue_type_script_setup_true_lang.js

@@ -14,22 +14,47 @@ var T = { class: "flex-1 overflow-hidden" }, E = {
 }, D = ["left", "right"], O = {
 	tag: {
 		type: String,
-		default: "div"
+		default: "div",
+		description: "Root element tag."
 	},
-	disabled: Boolean,
-	expanded: n(),
+	disabled: {
+		type: Boolean,
+		description: "Prevents expanding and collapsing."
+	},
+	expanded: n("Whether the item content starts expanded."),
 	showIcon: {
 		type: Boolean,
-		default: !0
+		default: !0,
+		description: "Shows the expand/collapse icon."
+	},
+	icon: {
+		type: String,
+		description: "Custom expand/collapse icon name. Falls back to a chevron."
 	},
-	icon: String,
 	iconAlign: {
 		type: String,
-		default: "right"
+		default: "right",
+		description: "Icon placement relative to the header (left or right)."
 	}
 }, k = /* @__PURE__ */ d({
 	name: "XAccordionItem",
 	validators: { iconAlign: D },
+	docs: {
+		slots: {
+			default: "Header label. Slot props: expand, collapsed.",
+			summary: "Optional summary below the header. Slot props: expand, collapsed.",
+			content: "Collapsible body. Slot props: expand, collapsed."
+		},
+		emits: {
+			expand: "Emitted when expand() is called from a slot.",
+			change: "Emitted when expanded state changes. Payload is the new expanded boolean."
+		},
+		methods: {
+			toggle: "Toggle expanded state when not disabled.",
+			open: "Expand the item. Pass false to skip animation.",
+			close: "Collapse the item. Pass false to skip animation."
+		}
+	},
 	props: O,
 	emits: ["expand", "change"],
 	setup(n, { expose: d, emit: D }) {

package/lib/components/alert/Alert.vue.d.ts

@@ -2,15 +2,22 @@ import { type ExtractPublicPropTypes, type PropType } from 'vue';
 import { type ThemeComponent } from '../../composables/useTheme';
 declare const alertType: readonly ["info", "success", "error", "warning"];
 declare const alertProps: {
-    type: PropType<"error" | "info" | "success" | "warning">;
+    type: {
+        type: PropType<"error" | "info" | "success" | "warning">;
+        description: string;
+    };
     glow: import("vue").Prop<boolean | undefined>;
     light: import("vue").Prop<boolean | undefined>;
     outlined: import("vue").Prop<boolean | undefined>;
     removable: import("vue").Prop<boolean | undefined>;
-    closeLabel: StringConstructor;
+    closeLabel: {
+        type: StringConstructor;
+        description: string;
+    };
     color: {
         readonly type: StringConstructor;
         readonly default: string | undefined;
+        readonly description: "Theme or CSS color used for the control accents.";
     };
 };
 export type AlertType = typeof alertType[number];
@@ -19,26 +26,40 @@ type InternalClasses = 'wrapper';
 export interface AlertTheme extends ThemeComponent<AlertProps, InternalClasses> {
 }
 declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<import("vue").ExtractPropTypes<{
-    type: PropType<"error" | "info" | "success" | "warning">;
+    type: {
+        type: PropType<"error" | "info" | "success" | "warning">;
+        description: string;
+    };
     glow: import("vue").Prop<boolean | undefined>;
     light: import("vue").Prop<boolean | undefined>;
     outlined: import("vue").Prop<boolean | undefined>;
     removable: import("vue").Prop<boolean | undefined>;
-    closeLabel: StringConstructor;
+    closeLabel: {
+        type: StringConstructor;
+        description: string;
+    };
     color: {
         readonly type: StringConstructor;
         readonly default: string | undefined;
+        readonly description: "Theme or CSS color used for the control accents.";
     };
 }>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, "remove"[], "remove", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
-    type: PropType<"error" | "info" | "success" | "warning">;
+    type: {
+        type: PropType<"error" | "info" | "success" | "warning">;
+        description: string;
+    };
     glow: import("vue").Prop<boolean | undefined>;
     light: import("vue").Prop<boolean | undefined>;
     outlined: import("vue").Prop<boolean | undefined>;
     removable: import("vue").Prop<boolean | undefined>;
-    closeLabel: StringConstructor;
+    closeLabel: {
+        type: StringConstructor;
+        description: string;
+    };
     color: {
         readonly type: StringConstructor;
         readonly default: string | undefined;
+        readonly description: "Theme or CSS color used for the control accents.";
     };
 }>> & Readonly<{
     onRemove?: ((...args: any[]) => any) | undefined;

package/lib/components/alert/Alert.vue_vue_type_script_setup_true_lang.js

@@ -13,15 +13,29 @@ var C = ["aria-label"], w = [
 	"warning"
 ], T = {
 	...t.props(),
-	type: String,
-	glow: r(),
-	light: r(),
-	outlined: r(),
-	removable: r(),
-	closeLabel: String
+	type: {
+		type: String,
+		description: "Semantic alert type (info, success, error, warning). Controls the default icon."
+	},
+	glow: r("Soft colored glow behind the alert."),
+	light: r("Tinted background using the color at low opacity."),
+	outlined: r("Outline style with a transparent fill."),
+	removable: r("Shows a close control that emits `remove`."),
+	closeLabel: {
+		type: String,
+		description: "Accessible label for the remove button."
+	}
 }, E = /* @__PURE__ */ _({
 	name: "XAlert",
 	validators: { type: w },
+	docs: {
+		slots: {
+			default: "Alert message content.",
+			icon: "Custom icon; overrides the type-based icon.",
+			removeIcon: "Custom icon for the remove button."
+		},
+		emits: { remove: "Emitted when the remove button is clicked." }
+	},
 	props: T,
 	emits: ["remove"],
 	setup(t) {

package/lib/components/avatar/Avatar.vue.d.ts

@@ -4,20 +4,32 @@ declare const avatarProps: {
     tag: {
         type: StringConstructor;
         default: string;
+        description: string;
+    };
+    name: {
+        type: StringConstructor;
+        description: string;
+    };
+    alt: {
+        type: StringConstructor;
+        description: string;
+    };
+    image: {
+        type: StringConstructor;
+        description: string;
     };
-    name: StringConstructor;
-    alt: StringConstructor;
-    image: StringConstructor;
     outlined: import("vue").Prop<boolean | undefined>;
     rounded: 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: 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 AvatarProps = ExtractPublicPropTypes<typeof avatarProps>;
@@ -31,39 +43,63 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
     tag: {
         type: StringConstructor;
         default: string;
+        description: string;
+    };
+    name: {
+        type: StringConstructor;
+        description: string;
+    };
+    alt: {
+        type: StringConstructor;
+        description: string;
+    };
+    image: {
+        type: StringConstructor;
+        description: string;
     };
-    name: StringConstructor;
-    alt: StringConstructor;
-    image: StringConstructor;
     outlined: import("vue").Prop<boolean | undefined>;
     rounded: 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: 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.";
     };
 }>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
     tag: {
         type: StringConstructor;
         default: string;
+        description: string;
+    };
+    name: {
+        type: StringConstructor;
+        description: string;
+    };
+    alt: {
+        type: StringConstructor;
+        description: string;
+    };
+    image: {
+        type: StringConstructor;
+        description: string;
     };
-    name: StringConstructor;
-    alt: StringConstructor;
-    image: StringConstructor;
     outlined: import("vue").Prop<boolean | undefined>;
     rounded: 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: 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<{}>, {
     tag: string;

package/lib/components/avatar/Avatar.vue_vue_type_script_setup_true_lang.js

@@ -14,16 +14,27 @@ var S = ["alt", "src"], C = {
 	...e.props("primary"),
 	tag: {
 		type: String,
-		default: "div"
+		default: "div",
+		description: "Root element tag."
 	},
-	name: String,
-	alt: String,
-	image: String,
-	outlined: n(),
-	rounded: n()
+	name: {
+		type: String,
+		description: "Display name used to derive initials when no image is loaded."
+	},
+	alt: {
+		type: String,
+		description: "Alt text for the image when `image` is set."
+	},
+	image: {
+		type: String,
+		description: "Image URL. Falls back to initials or the avatar icon if unloadable."
+	},
+	outlined: n("Outline style with a transparent fill."),
+	rounded: n("Fully rounded corners (circle).")
 }, T = /* @__PURE__ */ d({
 	name: "XAvatar",
 	validators: r.validators(),
+	docs: { slots: { avatarIcon: "Fallback icon when no name or image is available." } },
 	props: w,
 	setup(e) {
 		let n = e, r = h(), d = o(() => {