quasar 2.3.2 → 2.3.3

package/dist/types/index.d.ts

@@ -27,24 +27,24 @@ export interface AppFullscreen {
   /**
    * The DOM element used as root for fullscreen, otherwise 'null'
    */
-  activeEl: LooseDictionary;
+  activeEl: Element | null;
   /**
    * Request going into Fullscreen (with optional target)
    * @param target Optional Element of target to request Fullscreen on
-   * @returns A Promise with the outcome (true -> validation was a success, false -> invalid models detected)
+   * @returns A Promise which is resolved when transitioned to fullscreen mode. It gets rejected with 'Not capable' if the browser is not capable, and with an Error object if something else went wrong.
    */
-  request: (target?: Element) => Promise<any>;
+  request: (target?: Element) => Promise<void>;
   /**
    * Request exiting out of Fullscreen mode
-   * @returns A Promise with the outcome (true -> validation was a success, false -> invalid models detected)
+   * @returns A Promise which is resolved when exited out of fullscreen mode. It gets rejected with 'Not capable' if the browser is not capable, and with an Error object if something else went wrong.
    */
-  exit: () => Promise<any>;
+  exit: () => Promise<void>;
   /**
    * Request toggling Fullscreen mode (with optional target if requesting going into Fullscreen only)
    * @param target Optional Element of target to request Fullscreen on
-   * @returns A Promise with the outcome (true -> validation was a success, false -> invalid models detected)
+   * @returns A Promise which is resolved when transitioned to / exited out of fullscreen mode. It gets rejected with 'Not capable' if the browser is not capable, and with an Error object if something else went wrong.
    */
-  toggle: (target?: Element) => Promise<any>;
+  toggle: (target?: Element) => Promise<void>;
 }
 
 export interface AppVisibility {
@@ -156,9 +156,9 @@ export interface Cookies {
        */
       domain?: string;
       /**
-       * SameSite cookie option (not supported by IE11)
+       * SameSite cookie option
        */
-      sameSite?: string;
+      sameSite?: "Lax" | "Strict" | "None";
       /**
        * Is cookie Http Only?
        */
@@ -351,9 +351,9 @@ export interface LoadingBar {
   increment: (amount?: number) => void;
   /**
    * Set the inner QAjaxBar's props
-   * @param ...props QAjaxBar component props
+   * @param props QAjaxBar component props
    */
-  setDefaults: (...props: any[]) => void;
+  setDefaults: (props: LooseDictionary) => void;
 }
 
 export interface LocalStorage {
@@ -2344,6 +2344,7 @@ export interface QCarouselSlots {
     btnProps: LooseDictionary;
     /**
      * Default trigger when clicked/tapped on
+     * @param evt JS event object
      */
     onClick: (evt: LooseDictionary) => void;
   }) => VNode[];
@@ -2975,14 +2976,20 @@ export interface QDateProps {
   yearsInMonthView?: boolean | undefined;
   /**
    * A list of events to highlight on the calendar; If using a function, it receives the date as a String and must return a Boolean (matches or not); If using a function then for best performance, reference it from your scope and do not define it inline
+   * @param date The current date being processed.
+   * @returns If true, the current date will be highlighted
    */
   events?: any[] | ((date: string) => boolean) | undefined;
   /**
    * Color name (from the Quasar Color Palette); If using a function, it receives the date as a String and must return a String (color for the received date); If using a function then for best performance, reference it from your scope and do not define it inline
+   * @param date The current date being processed.
+   * @returns Color for the current date.
    */
   eventColor?: string | ((date: string) => string) | undefined;
   /**
    * Optionally configure the days that are selectable; If using a function, it receives the date as a String and must return a Boolean (is date acceptable or not); If using a function then for best performance, reference it from your scope and do not define it inline; Incompatible with 'range' prop
+   * @param date The current date being processed.
+   * @returns If true, the current date will be made available for selection
    */
   options?: any[] | ((date: string) => boolean) | undefined;
   /**
@@ -3055,7 +3062,7 @@ export interface QDateProps {
       /**
        * Object of properties of the range starting point (only if range)
        */
-      from: {
+      from?: {
         /**
          * The year
          */
@@ -3072,7 +3079,7 @@ export interface QDateProps {
       /**
        * Object of properties of the range ending point (only if range)
        */
-      to: {
+      to?: {
         /**
          * The year
          */
@@ -3617,6 +3624,7 @@ export interface QEditorProps {
         param?: string;
         /**
          * Is button disabled?
+         * @returns If true, the button will be disabled
          */
         disable?: boolean | (() => boolean);
         /**
@@ -4419,7 +4427,7 @@ export interface QFieldSlots {
     /**
      * DOM element of the field
      */
-    field: LooseDictionary;
+    field: Element;
     /**
      * Field is editable
      */
@@ -4438,6 +4446,7 @@ export interface QFieldSlots {
     modelValue: any;
     /**
      * Function that emits an @input event in the context of the field
+     * @param value Value to be emitted
      */
     emitValue: (value: any) => void;
   }) => VNode[];
@@ -4499,6 +4508,8 @@ export interface QFileProps {
   maxFiles?: number | string | undefined;
   /**
    * Custom filter for added files; Only files that pass this filter will be added to the queue and uploaded; For best performance, reference it from your scope and do not define it inline
+   * @param files Candidate files to be added to queue
+   * @returns Filtered files to be added to queue
    */
   filter?: ((files: FileList | any[]) => any[]) | undefined;
   /**
@@ -4659,6 +4670,8 @@ export interface QFileProps {
   useChips?: boolean | undefined;
   /**
    * Label for the counter; The 'counter' prop is necessary to enable this one
+   * @param props Object containing counter label information
+   * @returns String to display for the counter label
    */
   counterLabel?:
     | ((props: {
@@ -5196,7 +5209,7 @@ export interface QInfiniteScrollProps {
    * @param index The index parameter can be used to make some sort of pagination on the content you load. It takes numeric values starting with 1 and incrementing with each call
    * @param done Function to call when you made all necessary updates. DO NOT forget to call it otherwise your loading message will continue to be displayed
    */
-  onLoad?: (index: number, done: (stop: boolean) => void) => void;
+  onLoad?: (index: number, done: (stop?: boolean) => void) => void;
 }
 
 export interface QInfiniteScrollSlots {
@@ -6503,6 +6516,9 @@ export interface QPageProps {
   /**
    * Override default CSS style applied to the component (sets minHeight); Function(offset: Number) => CSS props/value: Object; For best performance, reference it from your scope and do not define it inline
    * Default value: (see source code)
+   * @param offset Header + Footer height (in pixels)
+   * @param height Value in pixels of container height (if containerized) or window height otherwise
+   * @returns Object with CSS properties to apply to Page DOM element
    */
   styleFn?: ((offset: number, height: number) => LooseDictionary) | undefined;
 }
@@ -6540,7 +6556,6 @@ export interface QPaginationProps {
   min?: number | undefined;
   /**
    * Number of last page (must be higher than 'min')
-   * Default value: 100
    */
   max: number;
   /**
@@ -6603,6 +6618,8 @@ export interface QPaginationProps {
   iconLast?: string | undefined;
   /**
    * Generate link for page buttons; For best performance, reference it from your scope and do not define it inline
+   * @param page Page number to navigate to
+   * @returns Object or String that can be passed to a <router-link> as `to` parameter
    */
   toFn?: ((page: number) => LooseDictionary | string) | undefined;
   /**
@@ -6768,6 +6785,8 @@ export interface QPopupEditProps {
   color?: string | undefined;
   /**
    * Validates model then triggers 'save' and closes Popup; Returns a Boolean ('true' means valid, 'false' means abort); Syntax: validate(value); For best performance, reference it from your scope and do not define it inline
+   * @param value Model to validate
+   * @returns Is the model valid or not?
    */
   validate?: ((value: any) => boolean) | undefined;
   /**
@@ -6902,6 +6921,8 @@ export interface QPopupEditSlots {
     value: any;
     /**
      * Function that checks if the value is valid
+     * @param value Value to be checked
+     * @returns Checked value is valid or not
      */
     validate: (value: any) => boolean;
     /**
@@ -7903,6 +7924,8 @@ export interface QSelectProps {
   /**
    * Property of option which holds the 'value'; If using a function then for best performance, reference it from your scope and do not define it inline
    * Default value: value
+   * @param option The current option being processed
+   * @returns Value of the current option
    */
   optionValue?:
     | ((option: string | LooseDictionary) => any)
@@ -7911,6 +7934,8 @@ export interface QSelectProps {
   /**
    * Property of option which holds the 'label'; If using a function then for best performance, reference it from your scope and do not define it inline
    * Default value: label
+   * @param option The current option being processed
+   * @returns Label of the current option
    */
   optionLabel?:
     | ((option: string | LooseDictionary) => string)
@@ -7919,6 +7944,8 @@ export interface QSelectProps {
   /**
    * Property of option which tells it's disabled; The value of the property must be a Boolean; If using a function then for best performance, reference it from your scope and do not define it inline
    * Default value: disable
+   * @param option The current option being processed
+   * @returns If true, the current option will be disabled
    */
   optionDisable?:
     | ((option: string | LooseDictionary) => boolean)
@@ -8158,7 +8185,7 @@ export interface QSelectProps {
    */
   onNewValue?: (
     inputValue: string,
-    doneFn: (item: any, mode: "add" | "add-unique" | "toggle") => void
+    doneFn: (item?: any, mode?: "add" | "add-unique" | "toggle") => void
   ) => void;
   /**
    * Emitted when user wants to filter a value
@@ -8170,7 +8197,7 @@ export interface QSelectProps {
     inputValue: string,
     doneFn: (
       callbackFn: () => void,
-      afterFn: (ref: LooseDictionary) => void
+      afterFn?: (ref: LooseDictionary) => void
     ) => void,
     abortFn: () => void
   ) => void;
@@ -8272,10 +8299,12 @@ export interface QSelectSlots {
     selected: boolean;
     /**
      * Remove selected option located at specific index
+     * @param index Index at which to remove selection
      */
     removeAtIndex: (index: number) => void;
     /**
      * Add/remove option from model
+     * @param opt Option to add to model
      */
     toggleOption: (opt: any) => void;
     /**
@@ -8306,10 +8335,12 @@ export interface QSelectSlots {
     focused: boolean;
     /**
      * Add/remove option from model
+     * @param opt Option to add to model
      */
     toggleOption: (opt: any) => void;
     /**
      * Sets option from menu as 'focused'
+     * @param index Index of option from menu
      */
     setOptionIndex: (index: number) => void;
     /**
@@ -8412,7 +8443,7 @@ export interface QSelect extends ComponentPublicInstance<QSelectProps> {
    * @param value String to set the input value to
    * @param noFilter Set to true if you don't want the filter (if any) to be also triggered
    */
-  updateInputValue: (value?: string, noFilter?: boolean) => void;
+  updateInputValue: (value: string, noFilter?: boolean) => void;
   /**
    * Tells if an option is selected
    * @param opt Option entry
@@ -9668,6 +9699,8 @@ export interface QTableProps {
   /**
    * Property of each row that defines the unique key of each row (the result must be a primitive, not Object, Array, etc); The value of property must be string or a function taking a row and returning the desired (nested) key in the row; If supplying a function then for best performance, reference it from your scope and do not define it inline
    * Default value: id
+   * @param row The current row being processed
+   * @returns Current row's key
    */
   rowKey?: string | ((row: LooseDictionary) => any) | undefined;
   /**
@@ -9756,6 +9789,8 @@ export interface QTableProps {
         label: string;
         /**
          * Row Object property to determine value for this column or function which maps to the required property
+         * @param row The current row being processed
+         * @returns Value for this column
          */
         field: string | ((row: LooseDictionary) => any);
         /**
@@ -9773,6 +9808,11 @@ export interface QTableProps {
         sortable?: boolean;
         /**
          * Compare function if you have some custom data or want a specific way to compare two rows
+         * @param a Value of the first comparison term
+         * @param b Value of the second comparison term
+         * @param rowA Full Row object in which is contained the first term
+         * @param rowB Full Row object in which is contained the second term
+         * @returns Comparison result of term 'a' with term 'b'. Less than 0 when 'a' should come first; greater than 0 if 'b' should come first; equal to 0 if their position must not be changed with respect to each other
          */
         sort?: (
           a: any,
@@ -9787,14 +9827,19 @@ export interface QTableProps {
         sortOrder?: "ad" | "da";
         /**
          * Function you can apply to format your data
+         * @param val Value of the cell
+         * @param row Full Row object in which the cell is contained
+         * @returns The resulting formatted value
          */
         format?: (val: any, row: LooseDictionary) => any;
         /**
          * Style to apply on normal cells of the column
+         * @param row The current row being processed
          */
         style?: string | ((row: LooseDictionary) => string);
         /**
          * Classes to add on normal cells of the column
+         * @param row The current row being processed
          */
         classes?: string | ((row: LooseDictionary) => string);
         /**
@@ -9887,6 +9932,8 @@ export interface QTableProps {
   loadingLabel?: string | undefined;
   /**
    * Text to display when user selected at least one row; For best performance, reference it from your scope and do not define it inline
+   * @param numberOfRows Number of rows available
+   * @returns Label to display
    */
   selectedRowsLabel?: ((numberOfRows: number) => string) | undefined;
   /**
@@ -9895,6 +9942,10 @@ export interface QTableProps {
   rowsPerPageLabel?: string | undefined;
   /**
    * Text to override default pagination label at bottom of table (unless 'pagination' scoped slot is used); For best performance, reference it from your scope and do not define it inline
+   * @param firstRowIndex Index of first displayed row
+   * @param endRowIndex Index of last displayed row
+   * @param totalRowsNumber Number of total rows available in data
+   * @returns Label to display
    */
   paginationLabel?:
     | ((
@@ -9946,6 +9997,11 @@ export interface QTableProps {
   /**
    * The actual filtering mechanism; For best performance, reference it from your scope and do not define it inline
    * Default value: (see source code)
+   * @param rows Array of rows
+   * @param terms Terms to filter with (is essentially the 'filter' prop value)
+   * @param cols Column definitions
+   * @param getCellValue Optional function to get a cell value
+   * @returns Filtered rows
    */
   filterMethod?:
     | ((
@@ -10005,6 +10061,10 @@ export interface QTableProps {
   /**
    * The actual sort mechanism. Function (rows, sortBy, descending) => sorted rows; For best performance, reference it from your scope and do not define it inline
    * Default value: (see source code)
+   * @param rows Array with rows
+   * @param sortBy Column name (from column definition)
+   * @param descending Is sorting in descending order?
+   * @returns Sorted rows
    */
   sortMethod?:
     | ((rows: any[], sortBy: string, descending: boolean) => any[])
@@ -10070,15 +10130,23 @@ export interface QTableProps {
     };
     /**
      * Filter method (the 'filter-method' prop)
+     * @param rows Array of rows
+     * @param terms Terms to filter with (is essentially the 'filter' prop value)
+     * @param cols Optional column definitions
+     * @param getCellValue Optional function to get a cell value
+     * @returns Filtered rows
      */
     filter: (
       rows: any[],
       terms: string | LooseDictionary,
-      cols: any[],
-      getCellValue: (col: LooseDictionary, row: LooseDictionary) => any
+      cols?: any[],
+      getCellValue?: (col: LooseDictionary, row: LooseDictionary) => any
     ) => any[];
     /**
-     * Optional function to get a cell value
+     * Function to get a cell value
+     * @param col Column name from column definitions
+     * @param row The row object
+     * @returns Parsed/Processed cell value
      */
     getCellValue: (col: LooseDictionary, row: LooseDictionary) => any;
   }) => void;
@@ -10125,6 +10193,10 @@ export interface QTableProps {
      * How many rows per page? 0 means Infinite
      */
     rowsPerPage: number;
+    /**
+     * For server-side fetching only. How many total database rows are there to be added to the table.
+     */
+    rowsNumber?: number;
   }) => void;
   /**
    * Used by Vue on 'v-model:selected' prop for updating its value
@@ -10196,6 +10268,7 @@ export interface QTableSlots {
     colsMap: LooseDictionary;
     /**
      * Trigger a table sort
+     * @param col Column name or column definition object
      */
     sort: (col: string | LooseDictionary) => void;
     /**
@@ -10208,7 +10281,6 @@ export interface QTableSlots {
     expand: boolean;
     /**
      * Color name for component from the Quasar Color Palette
-     * Default value: grey-8
      */
     color: string;
     /**
@@ -10251,6 +10323,7 @@ export interface QTableSlots {
     colsMap: LooseDictionary;
     /**
      * Trigger a table sort
+     * @param col Column name or column definition object
      */
     sort: (col: string | LooseDictionary) => void;
     /**
@@ -10263,7 +10336,6 @@ export interface QTableSlots {
     expand: boolean;
     /**
      * Color name for component from the Quasar Color Palette
-     * Default value: grey-8
      */
     color: string;
     /**
@@ -10318,6 +10390,7 @@ export interface QTableSlots {
     colsMap: LooseDictionary;
     /**
      * Trigger a table sort
+     * @param col Column name or column definition object
      */
     sort: (col: string | LooseDictionary) => void;
     /**
@@ -10330,7 +10403,6 @@ export interface QTableSlots {
     expand: boolean;
     /**
      * Color name for component from the Quasar Color Palette
-     * Default value: grey-8
      */
     color: string;
     /**
@@ -10381,6 +10453,7 @@ export interface QTableSlots {
     colsMap: LooseDictionary;
     /**
      * Trigger a table sort
+     * @param col Column name or column definition object
      */
     sort: (col: string | LooseDictionary) => void;
     /**
@@ -10393,7 +10466,6 @@ export interface QTableSlots {
     expand: boolean;
     /**
      * Color name for component from the Quasar Color Palette
-     * Default value: grey-8
      */
     color: string;
     /**
@@ -10420,6 +10492,7 @@ export interface QTableSlots {
     colsMap: LooseDictionary;
     /**
      * Trigger a table sort
+     * @param col Column name or column definition object
      */
     sort: (col: string | LooseDictionary) => void;
     /**
@@ -10432,7 +10505,6 @@ export interface QTableSlots {
     expand: boolean;
     /**
      * Color name for component from the Quasar Color Palette
-     * Default value: grey-8
      */
     color: string;
     /**
@@ -10471,6 +10543,7 @@ export interface QTableSlots {
     colsMap: LooseDictionary;
     /**
      * Trigger a table sort
+     * @param col Column name or column definition object
      */
     sort: (col: string | LooseDictionary) => void;
     /**
@@ -10483,7 +10556,6 @@ export interface QTableSlots {
     expand: boolean;
     /**
      * Color name for component from the Quasar Color Palette
-     * Default value: grey-8
      */
     color: string;
     /**
@@ -10514,6 +10586,7 @@ export interface QTableSlots {
     colsMap: LooseDictionary;
     /**
      * Trigger a table sort
+     * @param col Column name or column definition object
      */
     sort: (col: string | LooseDictionary) => void;
     /**
@@ -10526,7 +10599,6 @@ export interface QTableSlots {
     expand: boolean;
     /**
      * Color name for component from the Quasar Color Palette
-     * Default value: grey-8
      */
     color: string;
     /**
@@ -10569,6 +10641,7 @@ export interface QTableSlots {
     colsMap: LooseDictionary;
     /**
      * Trigger a table sort
+     * @param col Column name or column definition object
      */
     sort: (col: string | LooseDictionary) => void;
     /**
@@ -10581,7 +10654,6 @@ export interface QTableSlots {
     expand: boolean;
     /**
      * Color name for component from the Quasar Color Palette
-     * Default value: grey-8
      */
     color: string;
     /**
@@ -10608,6 +10680,7 @@ export interface QTableSlots {
     colsMap: LooseDictionary;
     /**
      * Trigger a table sort
+     * @param col Column name or column definition object
      */
     sort: (col: string | LooseDictionary) => void;
     /**
@@ -10620,7 +10693,6 @@ export interface QTableSlots {
     expand: boolean;
     /**
      * Color name for component from the Quasar Color Palette
-     * Default value: grey-8
      */
     color: string;
     /**
@@ -11087,12 +11159,17 @@ export interface QTable extends ComponentPublicInstance<QTableProps> {
     };
     /**
      * Filtering method (the 'filter-method' prop)
+     * @param rows Array of rows
+     * @param terms Terms to filter with (is essentially the 'filter' prop value)
+     * @param cols Optional column definitions
+     * @param getCellValue Optional function to get a cell value
+     * @returns Filtered rows
      */
     filter?: (
       rows: any[],
       terms: string | LooseDictionary,
-      cols: any[],
-      getCellValue: (col: LooseDictionary, row: LooseDictionary) => any
+      cols?: any[],
+      getCellValue?: (col?: LooseDictionary, row?: LooseDictionary) => any
     ) => any[];
   }) => void;
   /**
@@ -11170,7 +11247,7 @@ export interface QTable extends ComponentPublicInstance<QTableProps> {
   /**
    * Scroll the table to the row with the specified index in page (0 based)
    * @param index The index of the row in page (0 based)
-   * @param edge Only for virtual scroll - the edge to align to if the row is not visible already (by default it aligns to end if scrolling towards the end and to start otherwise); If the '-force' version is used then it always aligns
+   * @param edge Only for virtual scroll - the edge to align to if the row is not visible already; If the '-force' version is used then it always aligns
    */
   scrollTo: (
     index: string | number,
@@ -11571,6 +11648,9 @@ export interface QTimeProps {
   defaultDate?: string | undefined;
   /**
    * Optionally configure what time is the user allowed to set; Overridden by 'hour-options', 'minute-options' and 'second-options' if those are set; For best performance, reference it from your scope and do not define it inline
+   * @param hr Hour
+   * @param min Minutes
+   * @param sec Seconds
    */
   options?: ((hr: number, min: number, sec: number) => void) | undefined;
   /**
@@ -12121,6 +12201,9 @@ export interface QTreeProps {
   /**
    * The function to use to filter the tree nodes; For best performance, reference it from your scope and do not define it inline
    * Default value: (see source code)
+   * @param node Node currently being filtered
+   * @param filter Filter text to match against
+   * @returns Matches or not
    */
   filterMethod?:
     | ((node: LooseDictionary, filter: string) => boolean)
@@ -12158,8 +12241,9 @@ export interface QTreeProps {
     key: string;
     /**
      * The callback to be carried out when the loading is successful
+     * @param children Array of nodes
      */
-    done: (children: any[]) => void;
+    done: (children?: any[]) => void;
     /**
      * The callback to be carried out should the loading fails
      */
@@ -12378,24 +12462,34 @@ export interface QTree extends ComponentPublicInstance<QTreeProps> {
 export interface QUploaderProps {
   /**
    * Function which should return an Object or a Promise resolving with an Object; For best performance, reference it from your scope and do not define it inline
+   * @param files Uploaded files
+   * @returns Optional configuration for the upload process; You can override QUploader props in this Object (url, method, headers, formFields, fieldName, withCredentials, sendRaw); Props of these Object can also be Functions with the form of (file[s]) => value
    */
   factory?: ((files: any[]) => LooseDictionary | Promise<any>) | undefined;
   /**
    * URL or path to the server which handles the upload. Takes String or factory function, which returns String. Function is called right before upload; If using a function then for best performance, reference it from your scope and do not define it inline
+   * @param files Uploaded files
+   * @returns URL or path to the server which handles the upload
    */
   url?: string | ((files: any[]) => string) | undefined;
   /**
    * HTTP method to use for upload; Takes String or factory function which returns a String; Function is called right before upload; If using a function then for best performance, reference it from your scope and do not define it inline
    * Default value: POST
+   * @param files Uploaded files
+   * @returns HTTP method to use for upload
    */
   method?: "POST" | "PUT" | ((files: any[]) => string) | undefined;
   /**
    * Field name for each file upload; This goes into the following header: 'Content-Disposition: form-data; name="__HERE__"; filename="somefile.png"; If using a function then for best performance, reference it from your scope and do not define it inline
    * Default value: (file) => file.name
+   * @param files The current file being processed
+   * @returns Field name for the current file upload
    */
   fieldName?: string | ((files: File) => string) | undefined;
   /**
    * Array or a factory function which returns an array; Array consists of objects with header definitions; Function is called right before upload; If using a function then for best performance, reference it from your scope and do not define it inline
+   * @param files Uploaded files
+   * @returns An array consists of objects with header definitions
    */
   headers?:
     | {
@@ -12412,6 +12506,8 @@ export interface QUploaderProps {
     | undefined;
   /**
    * Array or a factory function which returns an array; Array consists of objects with additional fields definitions (used by Form to be uploaded); Function is called right before upload; If using a function then for best performance, reference it from your scope and do not define it inline
+   * @param files Uploaded files
+   * @returns An array consists of objects with additional fields definitions (used by Form to be uploaded)
    */
   formFields?:
     | {
@@ -12428,14 +12524,20 @@ export interface QUploaderProps {
     | undefined;
   /**
    * Sets withCredentials to true on the XHR that manages the upload; Takes boolean or factory function for Boolean; Function is called right before upload; If using a function then for best performance, reference it from your scope and do not define it inline
+   * @param files Uploaded files
+   * @returns If true, withCredentials will be set to true on the XHR that manages the upload
    */
   withCredentials?: boolean | ((files: any[]) => boolean) | undefined;
   /**
    * Send raw files without wrapping into a Form(); Takes boolean or factory function for Boolean; Function is called right before upload; If using a function then for best performance, reference it from your scope and do not define it inline
+   * @param files Uploaded files
+   * @returns If true, raw files will get sent without wrapping into a Form()
    */
   sendRaw?: boolean | ((files: any[]) => boolean) | undefined;
   /**
    * Upload files in batch (in one XHR request); Takes boolean or factory function for Boolean; Function is called right before upload; If using a function then for best performance, reference it from your scope and do not define it inline
+   * @param files Uploaded files
+   * @returns If true, files will be uploaded in a batch (in one XHR request)
    */
   batch?: boolean | ((files: any[]) => boolean) | undefined;
   /**
@@ -12464,6 +12566,8 @@ export interface QUploaderProps {
   maxFiles?: number | string | undefined;
   /**
    * Custom filter for added files; Only files that pass this filter will be added to the queue and uploaded; For best performance, reference it from your scope and do not define it inline
+   * @param files Candidate files to be added to queue
+   * @returns Filtered files to be added to queue
    */
   filter?: ((files: FileList | any[]) => any[]) | undefined;
   /**
@@ -12558,10 +12662,10 @@ export interface QUploaderProps {
   }) => void;
   /**
    * Emitted when factory function is supplied with a Promise which is rejected
-   * @param err Error Object which is the Promise rejection reason
+   * @param err Error object which is the Promise rejection reason
    * @param files Files which were to get uploaded
    */
-  onFactoryFailed?: (err: LooseDictionary, files: any[]) => void;
+  onFactoryFailed?: (err: Error, files: any[]) => void;
   /**
    * Emitted after files are picked and some do not pass the validation props (accept, max-file-size, max-total-size, filter, etc)
    * @param rejectedEntries Array of { failedPropValidation: string, file: File } Objects for files that do not pass the validation
@@ -12714,6 +12818,9 @@ export interface QVirtualScrollProps {
   itemsSize?: number | undefined;
   /**
    * Function to return the scope for the items to be displayed; Should return an array for items starting from 'from' index for size length; For best performance, reference it from your scope and do not define it inline
+   * @param from Index of the first item (0 based)
+   * @param size Number of items to return
+   * @returns List of scope for items to be displayed
    */
   itemsFn?: ((from: number, size: number) => any[]) | undefined;
   /**
@@ -12807,7 +12914,7 @@ export interface DialogChainObject {
    * @param callbackFn Tell what to do
    * @returns Chained Object
    */
-  onOk: (callbackFn: (payload: any) => void) => DialogChainObject;
+  onOk: (callbackFn: (payload?: any) => void) => DialogChainObject;
   /**
    * Receives a Function as param to tell what to do when Cancel is pressed / dialog is dismissed
    * @param callbackFn Tell what to do
@@ -12875,6 +12982,8 @@ export interface QDialogOptions {
     type?: string;
     /**
      * Is typed content valid?
+     * @param val The value of the input
+     * @returns The text passed validation or not
      */
     isValid?: (val: string) => boolean;
     /**
@@ -12945,6 +13054,8 @@ export interface QDialogOptions {
     items?: 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 | any[]) => boolean;
   };