@avenirs-esr/avenirs-dsav 0.1.57 → 0.1.59

package/dist/components/interaction/inputs/AvInput/AvInput.vue.d.ts

@@ -25,6 +25,7 @@ export interface AvInputProps {
     isTextarea?: boolean;
     /**
      * Whether the label is visible
+     * @default true
      */
     labelVisible?: boolean;
     /**

package/dist/components/overlay/dropdowns/AvDropdown/AvDropdown.stories.d.ts

@@ -0,0 +1,61 @@
+import type { Meta, StoryFn } from '@storybook/vue3';
+import { type AvDropdownProps } from '@/components/overlay/dropdowns/AvDropdown/AvDropdown.vue';
+/**
+ * <h1 class="n1">Dropdowns - <code>AvDropdown</code></h1>
+ *
+ * <h2 class="n2">✨ Introduction</h2>
+ *
+ * <p>
+ *   <span class="b2-regular">
+ *     The <code>AvDropdown</code> is a contextual menu component that displays a list of actionable items in a popover.
+ *   </span>
+ * </p>
+ *
+ * <p>
+ *   <span class="b2-regular">
+ *     The <code>AvDropdown</code> is built on top of <code>AvPopover</code> and <code>AvButton</code> components,
+ *     providing a convenient way to create dropdown menus with customizable trigger buttons and menu items.
+ *   </span>
+ * </p>
+ *
+ * <p>
+ *   <span class="b2-regular">
+ *     Each menu item can have an optional icon and emits an event when clicked, making it perfect for settings menus,
+ *     action lists, or contextual operations.
+ *   </span>
+ * </p>
+ *
+ * <h2 class="n2">🏗️ Structure</h2>
+ *
+ * <p><span class="b2-regular">The dropdown consists of:</span></p>
+ *
+ * <ul>
+ *   <li>
+ *     <span class="b2-regular">
+ *       A trigger button - mandatory, configured via <code>trigger*</code> props;
+ *     </span>
+ *   </li>
+ *   <li>
+ *     <span class="b2-regular">
+ *       A list of menu items - mandatory, defined via the <code>items</code> prop, each with a name, label, and optional icon;
+ *     </span>
+ *   </li>
+ *   <li>
+ *     <span class="b2-regular">
+ *       A popover container - automatically managed, with customizable width and padding.
+ *     </span>
+ *   </li>
+ * </ul>
+ */
+declare const meta: Meta<AvDropdownProps>;
+export default meta;
+export declare const Default: StoryFn<AvDropdownProps>;
+export declare const WithLabel: StoryFn<AvDropdownProps>;
+export declare const FlatTrigger: StoryFn<AvDropdownProps>;
+export declare const DefaultTrigger: StoryFn<AvDropdownProps>;
+export declare const LargeTrigger: StoryFn<AvDropdownProps>;
+export declare const WideMenu: StoryFn<AvDropdownProps>;
+export declare const LargeItems: StoryFn<AvDropdownProps>;
+export declare const PrimaryItems: StoryFn<AvDropdownProps>;
+export declare const WithoutIcons: StoryFn<AvDropdownProps>;
+export declare const SettingsMenu: StoryFn<AvDropdownProps>;

package/dist/components/overlay/dropdowns/AvDropdown/AvDropdown.stub.d.ts

@@ -0,0 +1,19 @@
+export declare const AvDropdownStub: import("vue").DefineComponent<{
+    padding?: any;
+    items?: any;
+    triggerAriaLabel?: any;
+    triggerIcon?: any;
+    triggerLabel?: any;
+    triggerVariant?: any;
+    triggerSize?: any;
+}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, "itemSelected"[], "itemSelected", import("vue").PublicProps, Readonly<{
+    padding?: any;
+    items?: any;
+    triggerAriaLabel?: any;
+    triggerIcon?: any;
+    triggerLabel?: any;
+    triggerVariant?: any;
+    triggerSize?: any;
+}> & Readonly<{
+    onItemSelected?: ((...args: any[]) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/components/overlay/dropdowns/AvDropdown/AvDropdown.vue.d.ts

@@ -0,0 +1,81 @@
+import { type AvButtonProps } from '@/components/interaction/buttons/AvButton/AvButton.vue';
+/**
+ * AvDropdownItem interface representing a single menu item.
+ */
+export interface AvDropdownItem {
+    /**
+     * Unique identifier for the item.
+     */
+    name: string;
+    /**
+     * Display text for the item.
+     */
+    label: string;
+    /**
+     * Optional icon (MDI icon name).
+     */
+    icon?: string;
+}
+/**
+ * AvDropdown props interface.
+ */
+export interface AvDropdownProps {
+    /**
+     * Array of menu items to display. Each item must have `name` and `label`, with optional `icon`.
+     */
+    items: AvDropdownItem[];
+    /**
+     * Accessibility label for the trigger button.
+     */
+    triggerAriaLabel: string;
+    /**
+     * Icon for the trigger button.
+     * @default MDI_ICONS.DOTS_VERTICAL
+     */
+    triggerIcon?: string;
+    /**
+     * Text label for the trigger button. If not provided, only the icon is shown.
+     */
+    triggerLabel?: string;
+    /**
+     * Variant of the trigger button.
+     * @default 'OUTLINED'
+     */
+    triggerVariant?: AvButtonProps['variant'];
+    /**
+     * Size of the trigger button.
+     * @default 'sm'
+     */
+    triggerSize?: AvButtonProps['size'];
+    /**
+     * Width of the dropdown menu.
+     * @default '15rem'
+     */
+    width?: string;
+    /**
+     * Internal padding of the dropdown menu.
+     * @default 'var(--spacing-xs)'
+     */
+    padding?: string;
+    /**
+     * Size of menu item buttons.
+     * @default 'sm'
+     */
+    itemSize?: AvButtonProps['size'];
+    /**
+     * Theme of menu item buttons.
+     * @default 'SECONDARY'
+     */
+    itemTheme?: AvButtonProps['theme'];
+    /**
+     * Scale factor for menu item icons.
+     * @default 1.3
+     */
+    itemIconScale?: number;
+}
+declare const _default: import("vue").DefineComponent<AvDropdownProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    itemSelected: (itemName: string) => any;
+}, string, import("vue").PublicProps, Readonly<AvDropdownProps> & Readonly<{
+    onItemSelected?: ((itemName: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

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

@@ -1,3 +1,4 @@
 export { default as AvDrawer } from './drawers/AvDrawer/AvDrawer.vue';
+export { default as AvDropdown, type AvDropdownItem, type AvDropdownProps } from './dropdowns/AvDropdown/AvDropdown.vue';
 export { default as AvModal, type AvModalProps } from './modals/AvModal/AvModal.vue';
 export { default as AvPopover } from './popovers/AvPopover/AvPopover.vue';