quasar 2.10.0 → 2.10.2

package/dist/types/api/dialog.d.ts

@@ -0,0 +1,101 @@
+// Error on "quasar" import shown in IDE is normal, as we only have Components/Directives/Plugins types after the build step
+// The import will work correctly at runtime
+import { QInputProps, QOptionGroupProps } from "quasar";
+
+// Taken from https://www.typescriptlang.org/docs/handbook/release-notes/typescript-2-8.html#distributive-conditional-types
+type NonFunctionPropertyNames<T> = {
+  [K in keyof T]: T[K] extends Function ? never : K;
+}[keyof T];
+type NonFunctionProperties<T> = Pick<T, NonFunctionPropertyNames<T>>;
+
+// https://html.spec.whatwg.org/multipage/input.html#attr-input-type
+type InputType =
+  | "button"
+  | "checkbox"
+  | "color"
+  | "date"
+  | "datetime-local"
+  | "email"
+  | "file"
+  | "hidden"
+  | "image"
+  | "month"
+  | "number"
+  | "password"
+  | "radio"
+  | "range"
+  | "reset"
+  | "search"
+  | "submit"
+  | "tel"
+  | "text"
+  | "time"
+  | "url"
+  | "week";
+type DatalessInputType = Extract<InputType, "submit" | "reset">;
+
+type PromptInputType = "textarea" | Exclude<InputType, DatalessInputType>;
+
+export type QDialogInputPrompt<T = string> = {
+  /**
+   * The initial value of the input
+   */
+  model: T;
+  /**
+   * Optional property to determine the input field type
+   *
+   * @defaultValue "text"
+   */
+  type?: PromptInputType;
+
+  /**
+   * Is typed content valid?
+   *
+   * @param val The value of the input
+   * @returns The text passed validation or not
+   */
+  isValid?: (value: T) => boolean;
+} & Partial<Omit<QInputProps, "modelValue" | "onUpdate:modelValue" | "type">> &
+  Partial<NonFunctionProperties<HTMLInputElement>>;
+
+type SelectionPromptType = NonNullable<QOptionGroupProps["type"]>
+export type QDialogSelectionPrompt<
+  // As this gets used as is in generated types, we must define default values for generic params.
+  // Example: `options?: QDialogSelectionPrompt;` <- notice the missing type params.
+  // We can't use "radio" as the default either, because that would make it the only value.
+  TType extends SelectionPromptType = SelectionPromptType,
+  TModel = TType extends "radio" ? string : readonly any[]
+> = {
+  /**
+   * The value of the selection
+   * If the `type` is "radio"(default), the value is a string, otherwise it's an array
+   */
+  model: TModel;
+
+  /**
+   * The type of the selection
+   *
+   * @defaultValue "radio"
+   */
+  type?: TType;
+
+  /**
+   * The list of options to interact with
+   * Equivalent to `options` prop of the `QOptionGroup` component
+   */
+  items?: QOptionGroupProps["options"];
+
+  /**
+   * Is the model valid?
+   *
+   * @param model The current model (If the `type` is "radio"(default), the value is a string, otherwise it's an array)
+   * @returns The selection passed validation or not
+   */
+  isValid?: (value: TModel) => boolean;
+} & Partial<
+  Omit<
+    QOptionGroupProps,
+    "modelValue" | "onUpdate:modelValue" | "type" | "options"
+  >
+> &
+  Partial<NonFunctionProperties<HTMLElement>>;

package/dist/types/api/qpopupproxy.d.ts

@@ -0,0 +1,3 @@
+import { QMenu, QDialog } from "quasar";
+
+export type QPopupProxyInnerComponent = QMenu | QDialog;

package/dist/types/api.d.ts

@@ -1,11 +1,13 @@
 export * from "./api/vue-prop-types";
 export * from "./api/cookies";
+export * from "./api/dialog";
 export * from "./api/qfile";
 export * from "./api/qselect";
 export * from "./api/qtable";
 export * from "./api/qtree";
 export * from "./api/quploader";
 export * from "./api/qnotify";
+export * from "./api/qpopupproxy";
 export * from "./api/qeditor";
 export * from "./api/qloading";
 export * from "./api/touchswipe";

package/dist/types/index.d.ts

@@ -3166,8 +3166,13 @@ export interface QDialog extends ComponentPublicInstance<QDialogProps> {
   focus: (selector?: string) => void;
   /**
    * Shakes dialog
+   * @param focusTarget Optional DOM Element to be focused after shake
    */
-  shake: () => void;
+  shake: (focusTarget?: Element) => void;
+  /**
+   * The DOM Element of the rendered content
+   */
+  readonly contentEl: Element;
 }
 
 export interface QDrawerProps {
@@ -4661,14 +4666,18 @@ export interface QFile extends ComponentPublicInstance<QFileProps> {
    */
   removeFile: (file: File) => void;
   /**
-   * Get the native input DOM Element
+   * DEPRECATED; Access 'nativeEl' directly; Gets the native input DOM Element
    * @returns The underlying native input DOM Element
    */
-  getNativeElement: () => any;
+  getNativeElement: () => Element;
   /**
    * Whether the component is in error state
    */
   readonly hasError: boolean;
+  /**
+   * The native input DOM Element
+   */
+  readonly nativeEl: Element;
 }
 
 export interface QFooterProps {
@@ -5094,8 +5103,9 @@ export interface QInfiniteScroll
   resume: () => void;
   /**
    * Overwrite the current pagination index
+   * @param newIndex New pagination index
    */
-  setIndex: () => void;
+  setIndex: (newIndex: number) => void;
   /**
    * Updates the scroll target; Useful when the parent elements change so that the scrolling target also changes
    */
@@ -5454,14 +5464,18 @@ export interface QInput extends ComponentPublicInstance<QInputProps> {
    */
   select: () => void;
   /**
-   * Get the native input/textarea DOM Element
+   * DEPRECATED; Access 'nativeEl' directly instead; Get the native input/textarea DOM Element
    * @returns The underlying native input/textarea DOM Element
    */
-  getNativeElement: () => any;
+  getNativeElement: () => Element;
   /**
    * Whether the component is in error state
    */
   readonly hasError: boolean;
+  /**
+   * The native input/textarea DOM Element
+   */
+  readonly nativeEl: Element;
 }
 
 export interface QIntersectionProps {
@@ -5705,6 +5719,11 @@ export interface QListProps {
    * Applies a material design-like padding on top and bottom
    */
   padding?: boolean | undefined;
+  /**
+   * HTML tag to use
+   * Default value: div
+   */
+  tag?: string | undefined;
 }
 
 export interface QListSlots {
@@ -6195,6 +6214,10 @@ export interface QMenu extends ComponentPublicInstance<QMenuProps> {
    * Focus menu; if you have content with autofocus attribute, it will directly focus it
    */
   focus: () => void;
+  /**
+   * The DOM Element of the rendered content
+   */
+  readonly contentEl: Element;
 }
 
 export interface QNoSsrProps {
@@ -6968,6 +6991,19 @@ export interface QPopupProxy extends ComponentPublicInstance<QPopupProxyProps> {
    * @param evt JS event object
    */
   toggle: (evt?: Event) => void;
+  /**
+   * Access current underlying component (QMenu or QDialog)
+   */
+  readonly currentComponent: {
+    /**
+     * Component type
+     */
+    type?: "dialog" | "menu";
+    /**
+     * The actual component (QMenu or QDialog); Access it directly, without '.value'
+     */
+    ref?: QPopupProxyInnerComponent;
+  };
 }
 
 export interface QPullToRefreshProps {
@@ -8720,7 +8756,7 @@ export interface QSlideItemProps {
      */
     side: "left" | "right" | "top" | "bottom";
     /**
-     * Ratio of how much of the required slide was performed (0..1)
+     * Ratio of how much of the required slide was performed (0 <= x <= 1)
      */
     ratio: number;
     /**
@@ -12318,6 +12354,10 @@ export interface QTooltip extends ComponentPublicInstance<QTooltipProps> {
    * There are some custom scenarios for which Quasar cannot automatically reposition the tooltip without significant performance drawbacks so the optimal solution is for you to call this method when you need it
    */
   updatePosition: () => void;
+  /**
+   * The DOM Element of the rendered content
+   */
+  readonly contentEl: Element;
 }
 
 export interface QTreeProps {
@@ -12945,17 +12985,17 @@ export interface QUploader extends ComponentPublicInstance<QUploaderProps> {
   removeQueuedFiles: () => void;
   /**
    * Remove specified file from the queue
-   * @param file File to remove (instance of File)
+   * @param file The file to remove
    */
-  removeFile: (file: any) => void;
+  removeFile: (file: File) => void;
   /**
    * Update the status of a file
-   * @param file File to update (instance of File)
+   * @param file The file to update
    * @param status Status of file
    * @param uploadedSize The number of uploaded bytes of the file; Is required explicitly only when status is NOT 'uploaded'
    */
   updateFileStatus: (
-    file: any,
+    file: File,
     status: "idle" | "failed" | "uploading" | "uploaded",
     uploadedSize: number
   ) => void;
@@ -13237,6 +13277,8 @@ export interface DialogChainObject {
 }
 
 import { CookiesGetMethodType } from "./api";
+import { QDialogInputPrompt } from "./api";
+import { QDialogSelectionPrompt } from "./api";
 export interface QDialogOptions {
   /**
    * CSS Class name to apply to the Dialog's QCard
@@ -13266,95 +13308,11 @@ export interface QDialogOptions {
   /**
    * An object definition of the input field for the prompting question.
    */
-  prompt?: {
-    /**
-     * The initial value of the input
-     */
-    model: string;
-    /**
-     * Optional property to determine the input field type
-     * Default value: text
-     */
-    type?: string;
-    /**
-     * Is typed content valid?
-     * @param val The value of the input
-     * @returns The text passed validation or not
-     */
-    isValid?: (val: string) => boolean;
-    /**
-     * Attributes to pass to prompt control
-     */
-    attrs?: any;
-    /**
-     * A text label that will “float” up above the input field, once the field gets focus
-     */
-    label?: string;
-    /**
-     * Label will be always shown above the field regardless of field content (if any)
-     */
-    stackLabel?: boolean;
-    /**
-     * Use 'filled' design for the field
-     */
-    filled?: boolean;
-    /**
-     * Use 'outlined' design for the field
-     */
-    outlined?: boolean;
-    /**
-     * Use 'standout' design for the field; Specifies classes to be applied when focused (overriding default ones)
-     */
-    standout?: boolean | string;
-    /**
-     * Applies a small standard border-radius for a squared shape of the component
-     */
-    rounded?: boolean;
-    /**
-     * Remove border-radius so borders are squared; Overrides 'rounded' prop
-     */
-    square?: boolean;
-    /**
-     * Show an automatic counter on bottom right
-     */
-    counter?: boolean;
-    /**
-     * Specify a max length of model
-     */
-    maxlength?: string | number;
-    /**
-     * Prefix
-     */
-    prefix?: string;
-    /**
-     * Suffix
-     */
-    suffix?: string;
-  };
+  prompt?: QDialogInputPrompt;
   /**
    * An object definition for creating the selection form content
    */
-  options?: {
-    /**
-     * The value of the selection (String if it's of type radio or Array otherwise)
-     */
-    model: string | readonly any[];
-    /**
-     * The type of selection
-     * Default value: radio
-     */
-    type?: "radio" | "checkbox" | "toggle";
-    /**
-     * The list of options to interact with; Equivalent to options prop of the QOptionsGroup component
-     */
-    items?: readonly any[];
-    /**
-     * Is the model valid?
-     * @param model The current model (String if it's of type radio or Array otherwise)
-     * @returns The selection passed validation or not
-     */
-    isValid?: (model: string | readonly any[]) => boolean;
-  };
+  options?: QDialogSelectionPrompt;
   /**
    * Display a Quasar spinner (if value is true, then the defaults are used); Useful for conveying the idea that something is happening behind the covers; Tip: use along with persistent, ok: false and update() method
    */
@@ -13718,6 +13676,7 @@ import { VueStyleObjectProp } from "./api";
 import { QEditorCaret } from "./api";
 import { ValidationRule } from "./api";
 import { QRejectedEntry } from "./api";
+import { QPopupProxyInnerComponent } from "./api";
 import { SliderMarkerLabels } from "./api";
 import { SliderMarkerLabelConfig } from "./api";
 import { SliderMarkerLabelArrayConfig } from "./api";

package/dist/vetur/quasar-attributes.json

@@ -2799,6 +2799,10 @@
     "type": "boolean",
     "description": "Applies a material design-like padding on top and bottom"
   },
+  "q-list/tag": {
+    "type": "string",
+    "description": "HTML tag to use"
+  },
   "q-knob/name": {
     "type": "string",
     "description": "Used to specify the name of the control; Useful if dealing with forms submitted directly to a URL"

package/dist/vetur/quasar-tags.json

@@ -919,7 +919,8 @@
       "dense",
       "separator",
       "dark",
-      "padding"
+      "padding",
+      "tag"
     ],
     "description": ""
   },