@quidgest/ui 0.9.9 → 0.10.1

package/dist/index.d.ts

@@ -22,6 +22,14 @@ import { VNodeProps } from 'vue';
 import { WatchOptions } from 'vue';
 import { WatchStopHandle } from 'vue';
 
+/**
+ * Alignment of the overlay, along the alignment axis.
+ */
+declare type Alignment = 'start' | 'end';
+
+/**
+ * Appearance of the overlay.
+ */
 declare type Appearance = 'regular' | 'inverted';
 
 declare type AppThemes = {
@@ -85,7 +93,10 @@ declare type FrameworkConfig = {
 };
 
 declare type Group = QListItemGroupProps & {
-    id: string;
+    /**
+     * Whether the entire item group is disabled.
+     */
+    disabled?: boolean;
 };
 
 export declare type Icon = {
@@ -113,7 +124,12 @@ declare type Item = Omit<QListItemProps, 'value' | 'label'> & {
     [key: string]: any;
 };
 
-declare type Placement = 'top' | 'bottom' | 'left' | 'right';
+/**
+ * Placement of the overlay.
+ * It can be a single side or a combination of side and alignment.
+ * Example: 'top', 'bottom-start', 'left-end', etc.
+ */
+declare type Placement = Side | `${Side}-${Alignment}`;
 
 declare type Primitive = string | number | boolean | symbol;
 
@@ -2148,7 +2164,7 @@ export declare const QList: {
         };
         groups: {
             type: PropType<(QListItemGroupProps & {
-                id: string;
+                disabled?: boolean | undefined;
             })[]>;
             default: () => never[];
         };
@@ -2187,7 +2203,7 @@ export declare const QList: {
         };
         groups: {
             type: PropType<(QListItemGroupProps & {
-                id: string;
+                disabled?: boolean | undefined;
             })[]>;
             default: () => never[];
         };
@@ -2203,7 +2219,7 @@ export declare const QList: {
         class: string | unknown[];
         highlighted: Primitive;
         groups: (QListItemGroupProps & {
-            id: string;
+            disabled?: boolean | undefined;
         })[];
         itemValue: string;
         itemLabel: string;
@@ -2235,7 +2251,7 @@ export declare const QList: {
         };
         groups: {
             type: PropType<(QListItemGroupProps & {
-                id: string;
+                disabled?: boolean | undefined;
             })[]>;
             default: () => never[];
         };
@@ -2257,7 +2273,7 @@ export declare const QList: {
         class: string | unknown[];
         highlighted: Primitive;
         groups: (QListItemGroupProps & {
-            id: string;
+            disabled?: boolean | undefined;
         })[];
         itemValue: string;
         itemLabel: string;
@@ -2286,7 +2302,7 @@ export declare const QList: {
     };
     groups: {
         type: PropType<(QListItemGroupProps & {
-            id: string;
+            disabled?: boolean | undefined;
         })[]>;
         default: () => never[];
     };
@@ -2308,7 +2324,7 @@ export declare const QList: {
     class: string | unknown[];
     highlighted: Primitive;
     groups: (QListItemGroupProps & {
-        id: string;
+        disabled?: boolean | undefined;
     })[];
     itemValue: string;
     itemLabel: string;
@@ -2471,16 +2487,18 @@ export declare const QListItemGroup: {
             type: PropType<string>;
             default: string;
         };
-        disabled: {
-            type: PropType<boolean>;
+        id: {
+            type: PropType<string>;
+            required: true;
         };
     }>>, {}, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, VNodeProps & AllowedComponentProps & ComponentCustomProps & Readonly<ExtractPropTypes<{
         title: {
             type: PropType<string>;
             default: string;
         };
-        disabled: {
-            type: PropType<boolean>;
+        id: {
+            type: PropType<string>;
+            required: true;
         };
     }>>, {
         title: string;
@@ -2496,8 +2514,9 @@ export declare const QListItemGroup: {
             type: PropType<string>;
             default: string;
         };
-        disabled: {
-            type: PropType<boolean>;
+        id: {
+            type: PropType<string>;
+            required: true;
         };
     }>>, {}, {}, {}, {}, {
         title: string;
@@ -2510,8 +2529,9 @@ export declare const QListItemGroup: {
         type: PropType<string>;
         default: string;
     };
-    disabled: {
-        type: PropType<boolean>;
+    id: {
+        type: PropType<string>;
+        required: true;
     };
 }>>, {}, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, {
     title: string;
@@ -2523,13 +2543,13 @@ export declare const QListItemGroup: {
 
 export declare type QListItemGroupProps = {
     /**
-     * The title of the group.
+     * The id of the group.
      */
-    title?: string;
+    id: string;
     /**
-     * Whether the entire list group is disabled.
+     * The title of the group.
      */
-    disabled?: boolean;
+    title?: string;
 };
 
 export declare type QListItemProps = {
@@ -2609,6 +2629,14 @@ export declare const QOverlay: {
             type: PropType<string>;
             default: string;
         };
+        offset: {
+            type: PropType<number>;
+            default: number;
+        };
+        placement: {
+            type: PropType<Placement>;
+            default: string;
+        };
         width: {
             type: PropType<"anchor" | "auto">;
             default: string;
@@ -2631,20 +2659,15 @@ export declare const QOverlay: {
             type: PropType<number>;
             default: number;
         };
-        scrollLock: {
+        nonModal: {
             type: PropType<boolean>;
         };
-        offset: {
-            type: PropType<number>;
-            default: number;
+        scrollLock: {
+            type: PropType<boolean>;
         };
         persistent: {
             type: PropType<boolean>;
         };
-        placement: {
-            type: PropType<Placement>;
-            default: string;
-        };
         spy: {
             type: PropType<boolean>;
         };
@@ -2672,6 +2695,14 @@ export declare const QOverlay: {
             type: PropType<string>;
             default: string;
         };
+        offset: {
+            type: PropType<number>;
+            default: number;
+        };
+        placement: {
+            type: PropType<Placement>;
+            default: string;
+        };
         width: {
             type: PropType<"anchor" | "auto">;
             default: string;
@@ -2694,20 +2725,15 @@ export declare const QOverlay: {
             type: PropType<number>;
             default: number;
         };
-        scrollLock: {
+        nonModal: {
             type: PropType<boolean>;
         };
-        offset: {
-            type: PropType<number>;
-            default: number;
+        scrollLock: {
+            type: PropType<boolean>;
         };
         persistent: {
             type: PropType<boolean>;
         };
-        placement: {
-            type: PropType<Placement>;
-            default: string;
-        };
         spy: {
             type: PropType<boolean>;
         };
@@ -2722,12 +2748,12 @@ export declare const QOverlay: {
         class: string | unknown[];
         anchor: Selector;
         transition: string;
+        offset: number;
+        placement: Placement;
         width: "anchor" | "auto";
         appearance: Appearance;
         attach: string;
         delay: number;
-        offset: number;
-        placement: Placement;
         trigger: Trigger;
     }, true, {}, {}, {
         P: {};
@@ -2750,6 +2776,14 @@ export declare const QOverlay: {
             type: PropType<string>;
             default: string;
         };
+        offset: {
+            type: PropType<number>;
+            default: number;
+        };
+        placement: {
+            type: PropType<Placement>;
+            default: string;
+        };
         width: {
             type: PropType<"anchor" | "auto">;
             default: string;
@@ -2772,20 +2806,15 @@ export declare const QOverlay: {
             type: PropType<number>;
             default: number;
         };
-        scrollLock: {
+        nonModal: {
             type: PropType<boolean>;
         };
-        offset: {
-            type: PropType<number>;
-            default: number;
+        scrollLock: {
+            type: PropType<boolean>;
         };
         persistent: {
             type: PropType<boolean>;
         };
-        placement: {
-            type: PropType<Placement>;
-            default: string;
-        };
         spy: {
             type: PropType<boolean>;
         };
@@ -2800,12 +2829,12 @@ export declare const QOverlay: {
         class: string | unknown[];
         anchor: Selector;
         transition: string;
+        offset: number;
+        placement: Placement;
         width: "anchor" | "auto";
         appearance: Appearance;
         attach: string;
         delay: number;
-        offset: number;
-        placement: Placement;
         trigger: Trigger;
     }>;
     __isFragment?: undefined;
@@ -2825,6 +2854,14 @@ export declare const QOverlay: {
         type: PropType<string>;
         default: string;
     };
+    offset: {
+        type: PropType<number>;
+        default: number;
+    };
+    placement: {
+        type: PropType<Placement>;
+        default: string;
+    };
     width: {
         type: PropType<"anchor" | "auto">;
         default: string;
@@ -2847,20 +2884,15 @@ export declare const QOverlay: {
         type: PropType<number>;
         default: number;
     };
-    scrollLock: {
+    nonModal: {
         type: PropType<boolean>;
     };
-    offset: {
-        type: PropType<number>;
-        default: number;
+    scrollLock: {
+        type: PropType<boolean>;
     };
     persistent: {
         type: PropType<boolean>;
     };
-    placement: {
-        type: PropType<Placement>;
-        default: string;
-    };
     spy: {
         type: PropType<boolean>;
     };
@@ -2878,12 +2910,12 @@ export declare const QOverlay: {
     class: string | unknown[];
     anchor: Selector;
     transition: string;
+    offset: number;
+    placement: Placement;
     width: "anchor" | "auto";
     appearance: Appearance;
     attach: string;
     delay: number;
-    offset: number;
-    placement: Placement;
     trigger: Trigger;
 }, {}, string, {}> & VNodeProps & AllowedComponentProps & ComponentCustomProps & (new () => {
     $slots: {
@@ -2894,25 +2926,29 @@ export declare const QOverlay: {
 export declare const QPopover: {
     new (...args: any[]): CreateComponentPublicInstance<Readonly<ExtractPropTypes<{
         modelValue: PropType<boolean>;
+        anchor: {
+            type: PropType<Selector>;
+            required: true;
+        };
         html: {
             type: PropType<boolean>;
             default: boolean;
         };
         title: {
             type: PropType<string>;
-            required: true;
+            default: string;
         };
         text: {
             type: PropType<string>;
             required: true;
         };
-        anchor: {
-            type: PropType<Selector>;
-            required: true;
-        };
         disabled: {
             type: PropType<boolean>;
         };
+        placement: {
+            type: PropType<Placement>;
+            default: string;
+        };
         arrow: {
             type: PropType<boolean>;
             default: boolean;
@@ -2921,31 +2957,31 @@ export declare const QPopover: {
             type: PropType<string>;
             default: string;
         };
-        placement: {
-            type: PropType<Placement>;
-            default: string;
-        };
     }>>, {}, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, VNodeProps & AllowedComponentProps & ComponentCustomProps & Readonly<ExtractPropTypes<{
         modelValue: PropType<boolean>;
+        anchor: {
+            type: PropType<Selector>;
+            required: true;
+        };
         html: {
             type: PropType<boolean>;
             default: boolean;
         };
         title: {
             type: PropType<string>;
-            required: true;
+            default: string;
         };
         text: {
             type: PropType<string>;
             required: true;
         };
-        anchor: {
-            type: PropType<Selector>;
-            required: true;
-        };
         disabled: {
             type: PropType<boolean>;
         };
+        placement: {
+            type: PropType<Placement>;
+            default: string;
+        };
         arrow: {
             type: PropType<boolean>;
             default: boolean;
@@ -2954,15 +2990,12 @@ export declare const QPopover: {
             type: PropType<string>;
             default: string;
         };
-        placement: {
-            type: PropType<Placement>;
-            default: string;
-        };
     }>>, {
         html: boolean;
+        title: string;
+        placement: Placement;
         arrow: boolean;
         attach: string;
-        placement: Placement;
     }, true, {}, {}, {
         P: {};
         B: {};
@@ -2972,25 +3005,29 @@ export declare const QPopover: {
         Defaults: {};
     }, Readonly<ExtractPropTypes<{
         modelValue: PropType<boolean>;
+        anchor: {
+            type: PropType<Selector>;
+            required: true;
+        };
         html: {
             type: PropType<boolean>;
             default: boolean;
         };
         title: {
             type: PropType<string>;
-            required: true;
+            default: string;
         };
         text: {
             type: PropType<string>;
             required: true;
         };
-        anchor: {
-            type: PropType<Selector>;
-            required: true;
-        };
         disabled: {
             type: PropType<boolean>;
         };
+        placement: {
+            type: PropType<Placement>;
+            default: string;
+        };
         arrow: {
             type: PropType<boolean>;
             default: boolean;
@@ -2999,40 +3036,41 @@ export declare const QPopover: {
             type: PropType<string>;
             default: string;
         };
-        placement: {
-            type: PropType<Placement>;
-            default: string;
-        };
     }>>, {}, {}, {}, {}, {
         html: boolean;
+        title: string;
+        placement: Placement;
         arrow: boolean;
         attach: string;
-        placement: Placement;
     }>;
     __isFragment?: undefined;
     __isTeleport?: undefined;
     __isSuspense?: undefined;
 } & ComponentOptionsBase<Readonly<ExtractPropTypes<{
     modelValue: PropType<boolean>;
+    anchor: {
+        type: PropType<Selector>;
+        required: true;
+    };
     html: {
         type: PropType<boolean>;
         default: boolean;
     };
     title: {
         type: PropType<string>;
-        required: true;
+        default: string;
     };
     text: {
         type: PropType<string>;
         required: true;
     };
-    anchor: {
-        type: PropType<Selector>;
-        required: true;
-    };
     disabled: {
         type: PropType<boolean>;
     };
+    placement: {
+        type: PropType<Placement>;
+        default: string;
+    };
     arrow: {
         type: PropType<boolean>;
         default: boolean;
@@ -3041,15 +3079,12 @@ export declare const QPopover: {
         type: PropType<string>;
         default: string;
     };
-    placement: {
-        type: PropType<Placement>;
-        default: string;
-    };
 }>>, {}, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, {
     html: boolean;
+    title: string;
+    placement: Placement;
     arrow: boolean;
     attach: string;
-    placement: Placement;
 }, {}, string, {}> & VNodeProps & AllowedComponentProps & ComponentCustomProps & (new () => {
     $slots: {
         header?(_: {}): any;
@@ -3733,6 +3768,10 @@ export declare const QTooltip: {
             type: PropType<string | unknown[]>;
             default: undefined;
         };
+        anchor: {
+            type: PropType<Selector>;
+            required: true;
+        };
         html: {
             type: PropType<boolean>;
             default: boolean;
@@ -3741,10 +3780,6 @@ export declare const QTooltip: {
             type: PropType<string>;
             required: true;
         };
-        anchor: {
-            type: PropType<Selector>;
-            required: true;
-        };
         disabled: {
             type: PropType<boolean>;
         };
@@ -3752,6 +3787,10 @@ export declare const QTooltip: {
             type: PropType<string>;
             default: undefined;
         };
+        placement: {
+            type: PropType<Placement>;
+            default: string;
+        };
         appearance: {
             type: PropType<Appearance>;
             default: string;
@@ -3768,10 +3807,6 @@ export declare const QTooltip: {
             type: PropType<number>;
             default: number;
         };
-        placement: {
-            type: PropType<Placement>;
-            default: string;
-        };
         trigger: {
             type: PropType<Trigger>;
             default: string;
@@ -3782,6 +3817,10 @@ export declare const QTooltip: {
             type: PropType<string | unknown[]>;
             default: undefined;
         };
+        anchor: {
+            type: PropType<Selector>;
+            required: true;
+        };
         html: {
             type: PropType<boolean>;
             default: boolean;
@@ -3790,10 +3829,6 @@ export declare const QTooltip: {
             type: PropType<string>;
             required: true;
         };
-        anchor: {
-            type: PropType<Selector>;
-            required: true;
-        };
         disabled: {
             type: PropType<boolean>;
         };
@@ -3801,6 +3836,10 @@ export declare const QTooltip: {
             type: PropType<string>;
             default: undefined;
         };
+        placement: {
+            type: PropType<Placement>;
+            default: string;
+        };
         appearance: {
             type: PropType<Appearance>;
             default: string;
@@ -3817,10 +3856,6 @@ export declare const QTooltip: {
             type: PropType<number>;
             default: number;
         };
-        placement: {
-            type: PropType<Placement>;
-            default: string;
-        };
         trigger: {
             type: PropType<Trigger>;
             default: string;
@@ -3829,11 +3864,11 @@ export declare const QTooltip: {
         class: string | unknown[];
         html: boolean;
         id: string;
+        placement: Placement;
         appearance: Appearance;
         arrow: boolean;
         attach: string;
         delay: number;
-        placement: Placement;
         trigger: Trigger;
     }, true, {}, {}, {
         P: {};
@@ -3848,6 +3883,10 @@ export declare const QTooltip: {
             type: PropType<string | unknown[]>;
             default: undefined;
         };
+        anchor: {
+            type: PropType<Selector>;
+            required: true;
+        };
         html: {
             type: PropType<boolean>;
             default: boolean;
@@ -3856,10 +3895,6 @@ export declare const QTooltip: {
             type: PropType<string>;
             required: true;
         };
-        anchor: {
-            type: PropType<Selector>;
-            required: true;
-        };
         disabled: {
             type: PropType<boolean>;
         };
@@ -3867,6 +3902,10 @@ export declare const QTooltip: {
             type: PropType<string>;
             default: undefined;
         };
+        placement: {
+            type: PropType<Placement>;
+            default: string;
+        };
         appearance: {
             type: PropType<Appearance>;
             default: string;
@@ -3883,10 +3922,6 @@ export declare const QTooltip: {
             type: PropType<number>;
             default: number;
         };
-        placement: {
-            type: PropType<Placement>;
-            default: string;
-        };
         trigger: {
             type: PropType<Trigger>;
             default: string;
@@ -3895,11 +3930,11 @@ export declare const QTooltip: {
         class: string | unknown[];
         html: boolean;
         id: string;
+        placement: Placement;
         appearance: Appearance;
         arrow: boolean;
         attach: string;
         delay: number;
-        placement: Placement;
         trigger: Trigger;
     }>;
     __isFragment?: undefined;
@@ -3911,6 +3946,10 @@ export declare const QTooltip: {
         type: PropType<string | unknown[]>;
         default: undefined;
     };
+    anchor: {
+        type: PropType<Selector>;
+        required: true;
+    };
     html: {
         type: PropType<boolean>;
         default: boolean;
@@ -3919,10 +3958,6 @@ export declare const QTooltip: {
         type: PropType<string>;
         required: true;
     };
-    anchor: {
-        type: PropType<Selector>;
-        required: true;
-    };
     disabled: {
         type: PropType<boolean>;
     };
@@ -3930,6 +3965,10 @@ export declare const QTooltip: {
         type: PropType<string>;
         default: undefined;
     };
+    placement: {
+        type: PropType<Placement>;
+        default: string;
+    };
     appearance: {
         type: PropType<Appearance>;
         default: string;
@@ -3946,10 +3985,6 @@ export declare const QTooltip: {
         type: PropType<number>;
         default: number;
     };
-    placement: {
-        type: PropType<Placement>;
-        default: string;
-    };
     trigger: {
         type: PropType<Trigger>;
         default: string;
@@ -3958,11 +3993,11 @@ export declare const QTooltip: {
     class: string | unknown[];
     html: boolean;
     id: string;
+    placement: Placement;
     appearance: Appearance;
     arrow: boolean;
     attach: string;
     delay: number;
-    placement: Placement;
     trigger: Trigger;
 }, {}, string, {}> & VNodeProps & AllowedComponentProps & ComponentCustomProps & (new () => {
     $slots: {
@@ -3976,6 +4011,11 @@ export declare const QTooltip: {
 
 declare type Selector = string | HTMLElement;
 
+/**
+ * Side of the overlay, relative to the anchor element.
+ */
+declare type Side = 'top' | 'bottom' | 'left' | 'right';
+
 declare type ThemeDefinition = {
     name: string;
     mode: ThemeMode;
@@ -3989,6 +4029,9 @@ declare type ThemeInstance = {
 
 declare type ThemeMode = 'light' | 'dark';
 
+/**
+ * Triggering mechanism for the overlay.
+ */
 declare type Trigger = 'hover' | 'click' | 'manual';
 
 /**