quasar 2.8.4 → 2.9.0

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

@@ -0,0 +1,17 @@
+// src/components/editor/editor-caret.js#Caret
+// We are not exposing the whole API, just the ones that might be needed outside.
+export interface QEditorCaret {
+  readonly selection: Selection | null;
+  readonly hasSelection: boolean;
+  readonly range: Range | null;
+  readonly parent: Element | null;
+  readonly blockParent: Element | null;
+
+  save(range: Range): void;
+  restore(range?: Range): void;
+  savePosition(): void;
+  restorePosition(length?: number): void;
+  is(commandId: string, param?: string): boolean;
+  can(commandId: string): boolean;
+  apply(commandId: string, param?: string, done?: () => void): boolean;
+}

package/dist/types/api.d.ts

@@ -6,6 +6,7 @@ export * from "./api/qtable";
 export * from "./api/qtree";
 export * from "./api/quploader";
 export * from "./api/qnotify";
+export * from "./api/qeditor";
 export * from "./api/qloading";
 export * from "./api/touchswipe";
 export * from "./api/web-storage";

package/dist/types/index.d.ts

@@ -1110,6 +1110,28 @@ export interface QBreadcrumbsElProps {
    * Default value: true
    */
   ripple?: boolean | any | undefined;
+  /**
+   * Emitted when the component is clicked
+   * @param evt JS event object; If you are using route navigation ('to'/'replace' props) and you want to cancel navigation then call evt.preventDefault() synchronously in your event handler
+   * @param go Available ONLY if you are using route navigation ('to'/'replace' props); When you need to control the time at which the component should trigger the route navigation then call evt.preventDefault() synchronously and then call this function at your convenience; Useful if you have async work to be done before the actual route navigation or if you want to redirect somewhere else
+   */
+  onClick?: (
+    evt: Event,
+    go?: (opts?: {
+      /**
+       * Equivalent to Vue Router <router-link> 'to' property; Specify it explicitly otherwise it will be set with same value as component's 'to' prop
+       */
+      to?: string | any;
+      /**
+       * Equivalent to Vue Router <router-link> 'replace' property; Specify it explicitly otherwise it will be set with same value as component's 'replace' prop
+       */
+      replace?: boolean;
+      /**
+       * Return the router error, if any; Otherwise the returned Promise will always fulfill
+       */
+      returnRouterError?: boolean;
+    }) => Promise<any>
+  ) => void;
 }
 
 export interface QBreadcrumbsElSlots {
@@ -1769,11 +1791,27 @@ export interface QBtnProps {
    */
   darkPercentage?: boolean | undefined;
   /**
-   * Emitted when component is clicked (activated)
-   * @param evt JS event object; If you want to cancel navigation set synchronously 'evt.navigate' to false
-   * @param navigateFn When you need to control the time at which the button should trigger the route navigation then set 'evt.navigate' to false and call this function; Useful if you have async work to be done before the actual route navigation
+   * Emitted when the component is clicked
+   * @param evt JS event object; If you are using route navigation ('to'/'replace' props) and you want to cancel navigation then call evt.preventDefault() synchronously in your event handler
+   * @param go Available ONLY if you are using route navigation ('to'/'replace' props); When you need to control the time at which the component should trigger the route navigation then call evt.preventDefault() synchronously and then call this function at your convenience; Useful if you have async work to be done before the actual route navigation or if you want to redirect somewhere else
    */
-  onClick?: (evt: Event, navigateFn: () => void) => void;
+  onClick?: (
+    evt: Event,
+    go?: (opts?: {
+      /**
+       * Equivalent to Vue Router <router-link> 'to' property; Specify it explicitly otherwise it will be set with same value as component's 'to' prop
+       */
+      to?: string | any;
+      /**
+       * Equivalent to Vue Router <router-link> 'replace' property; Specify it explicitly otherwise it will be set with same value as component's 'replace' prop
+       */
+      replace?: boolean;
+      /**
+       * Return the router error, if any; Otherwise the returned Promise will always fulfill
+       */
+      returnRouterError?: boolean;
+    }) => Promise<any>
+  ) => void;
 }
 
 export interface QBtnSlots {
@@ -3435,6 +3473,10 @@ export interface QEditor extends ComponentPublicInstance<QEditorProps> {
    * @returns Provides the pure HTML within the editable area
    */
   getContentEl: () => Element;
+  /**
+   * The current caret state
+   */
+  readonly caret: QEditorCaret;
 }
 
 export interface QExpansionItemProps {
@@ -5538,6 +5580,28 @@ export interface QItemProps {
    * Determines focus state, ONLY if 'manual-focus' is enabled / set to true
    */
   focused?: boolean | undefined;
+  /**
+   * Emitted when the component is clicked
+   * @param evt JS event object; If you are using route navigation ('to'/'replace' props) and you want to cancel navigation then call evt.preventDefault() synchronously in your event handler
+   * @param go Available ONLY if you are using route navigation ('to'/'replace' props); When you need to control the time at which the component should trigger the route navigation then call evt.preventDefault() synchronously and then call this function at your convenience; Useful if you have async work to be done before the actual route navigation or if you want to redirect somewhere else
+   */
+  onClick?: (
+    evt: Event,
+    go?: (opts?: {
+      /**
+       * Equivalent to Vue Router <router-link> 'to' property; Specify it explicitly otherwise it will be set with same value as component's 'to' prop
+       */
+      to?: string | any;
+      /**
+       * Equivalent to Vue Router <router-link> 'replace' property; Specify it explicitly otherwise it will be set with same value as component's 'replace' prop
+       */
+      replace?: boolean;
+      /**
+       * Return the router error, if any; Otherwise the returned Promise will always fulfill
+       */
+      returnRouterError?: boolean;
+    }) => Promise<any>
+  ) => void;
 }
 
 export interface QItemSlots {
@@ -7325,6 +7389,10 @@ export interface QRatingProps {
    * Icon name following Quasar convention to be used when selected (optional); make sure you have the icon library installed unless you are using 'img:' prefix; If an array is provided each rating value will use the corresponding icon in the array (0 based)
    */
   iconHalf?: string | readonly any[] | undefined;
+  /**
+   * Label to be set on aria-label for Icon; If an array is provided each rating value will use the corresponding aria-label in the array (0 based); If string value is provided the rating value will be appended; If not provided the name of the icon will be used
+   */
+  iconAriaLabel?: string | readonly any[] | undefined;
   /**
    * Color name for component from the Quasar Color Palette; v1.5.0+: If an array is provided each rating value will use the corresponding color in the array (0 based)
    */
@@ -11490,11 +11558,27 @@ export interface QRouteTabProps {
    */
   tabindex?: number | string | undefined;
   /**
-   * Emitted when component is clicked (activated)
-   * @param evt JS event object; If you want to cancel navigation set synchronously 'evt.navigate' to false
-   * @param navigateFn When you need to control the time at which the tab should trigger the route navigation then set 'evt.navigate' to false and call this function; Useful if you have async work to be done before the actual route navigation
+   * Emitted when the component is clicked
+   * @param evt JS event object; If you want to cancel navigation then call evt.preventDefault() synchronously in your event handler
+   * @param go When you need to control the time at which the component should trigger the route navigation then call evt.preventDefault() synchronously and then call this function at your convenience; Useful if you have async work to be done before the actual route navigation or if you want to redirect somewhere else
    */
-  onClick?: (evt: Event, navigateFn: () => void) => void;
+  onClick?: (
+    evt: Event,
+    go?: (opts?: {
+      /**
+       * Equivalent to Vue Router <router-link> 'to' property; Specify it explicitly otherwise it will be set with same value as component's 'to' prop
+       */
+      to?: string | any;
+      /**
+       * Equivalent to Vue Router <router-link> 'replace' property; Specify it explicitly otherwise it will be set with same value as component's 'replace' prop
+       */
+      replace?: boolean;
+      /**
+       * Return the router error, if any; Otherwise the returned Promise will always fulfill
+       */
+      returnRouterError?: boolean;
+    }) => Promise<any>
+  ) => void;
 }
 
 export interface QRouteTabSlots {
@@ -13612,6 +13696,7 @@ export interface QEditorCommand {
 }
 
 import { VueStyleObjectProp } from "./api";
+import { QEditorCaret } from "./api";
 import { ValidationRule } from "./api";
 import { QRejectedEntry } from "./api";
 import { SliderMarkerLabels } from "./api";

package/dist/types/utils/run-sequential-promises.d.ts

@@ -43,7 +43,7 @@ export type RunSequentialPromisesResult<TKey extends number | string, TValue> =
 export interface RunSequentialPromisesOptions {
   /**
    * When making HTTP requests, be aware of the maximum threads that
-   * the hosting browser supports (usually 3). Any number of threads
+   * the hosting browser supports (usually 5). Any number of threads
    * above that won't add any real benefits.
    *
    * @default 1

package/dist/vetur/quasar-attributes.json

@@ -3691,6 +3691,10 @@
     "type": "string|array",
     "description": "Icon name following Quasar convention to be used when selected (optional); make sure you have the icon library installed unless you are using 'img:' prefix; If an array is provided each rating value will use the corresponding icon in the array (0 based)"
   },
+  "q-rating/icon-aria-label": {
+    "type": "string|array",
+    "description": "Label to be set on aria-label for Icon; If an array is provided each rating value will use the corresponding aria-label in the array (0 based); If string value is provided the rating value will be appended; If not provided the name of the icon will be used"
+  },
   "q-rating/color": {
     "type": "string|array",
     "description": "Color name for component from the Quasar Color Palette; v1.5.0+: If an array is provided each rating value will use the corresponding color in the array (0 based)"

package/dist/vetur/quasar-tags.json

@@ -1237,6 +1237,7 @@
       "icon",
       "icon-selected",
       "icon-half",
+      "icon-aria-label",
       "color",
       "color-selected",
       "color-half",

package/dist/web-types/web-types.json

@@ -2,7 +2,7 @@
   "$schema": "",
   "framework": "vue",
   "name": "quasar",
-  "version": "2.8.4",
+  "version": "2.9.0",
   "contributions": {
     "html": {
       "types-syntax": "typescript",
@@ -575,6 +575,27 @@
               "default": "true"
             }
           ],
+          "events": [
+            {
+              "name": "click",
+              "arguments": [
+                {
+                  "name": "evt",
+                  "type": "Event",
+                  "description": "JS event object; If you are using route navigation ('to'/'replace' props) and you want to cancel navigation then call evt.preventDefault() synchronously in your event handler",
+                  "doc-url": "https://v2.quasar.dev/vue-components/breadcrumbs"
+                },
+                {
+                  "name": "go",
+                  "type": "Function",
+                  "description": "Available ONLY if you are using route navigation ('to'/'replace' props); When you need to control the time at which the component should trigger the route navigation then call evt.preventDefault() synchronously and then call this function at your convenience; Useful if you have async work to be done before the actual route navigation or if you want to redirect somewhere else",
+                  "doc-url": "https://v2.quasar.dev/vue-components/breadcrumbs"
+                }
+              ],
+              "description": "Emitted when the component is clicked",
+              "doc-url": "https://v2.quasar.dev/vue-components/breadcrumbs"
+            }
+          ],
           "slots": [
             {
               "name": "default",
@@ -1885,17 +1906,17 @@
                 {
                   "name": "evt",
                   "type": "Event",
-                  "description": "JS event object; If you want to cancel navigation set synchronously 'evt.navigate' to false",
+                  "description": "JS event object; If you are using route navigation ('to'/'replace' props) and you want to cancel navigation then call evt.preventDefault() synchronously in your event handler",
                   "doc-url": "https://v2.quasar.dev/vue-components/button"
                 },
                 {
-                  "name": "navigateFn",
+                  "name": "go",
                   "type": "Function",
-                  "description": "When you need to control the time at which the button should trigger the route navigation then set 'evt.navigate' to false and call this function; Useful if you have async work to be done before the actual route navigation",
+                  "description": "Available ONLY if you are using route navigation ('to'/'replace' props); When you need to control the time at which the component should trigger the route navigation then call evt.preventDefault() synchronously and then call this function at your convenience; Useful if you have async work to be done before the actual route navigation or if you want to redirect somewhere else",
                   "doc-url": "https://v2.quasar.dev/vue-components/button"
                 }
               ],
-              "description": "Emitted when component is clicked (activated)",
+              "description": "Emitted when the component is clicked",
               "doc-url": "https://v2.quasar.dev/vue-components/button"
             }
           ],
@@ -8591,6 +8612,27 @@
               "type": "boolean"
             }
           ],
+          "events": [
+            {
+              "name": "click",
+              "arguments": [
+                {
+                  "name": "evt",
+                  "type": "Event",
+                  "description": "JS event object; If you are using route navigation ('to'/'replace' props) and you want to cancel navigation then call evt.preventDefault() synchronously in your event handler",
+                  "doc-url": "https://v2.quasar.dev/vue-components/list-and-list-items"
+                },
+                {
+                  "name": "go",
+                  "type": "Function",
+                  "description": "Available ONLY if you are using route navigation ('to'/'replace' props); When you need to control the time at which the component should trigger the route navigation then call evt.preventDefault() synchronously and then call this function at your convenience; Useful if you have async work to be done before the actual route navigation or if you want to redirect somewhere else",
+                  "doc-url": "https://v2.quasar.dev/vue-components/list-and-list-items"
+                }
+              ],
+              "description": "Emitted when the component is clicked",
+              "doc-url": "https://v2.quasar.dev/vue-components/list-and-list-items"
+            }
+          ],
           "slots": [
             {
               "name": "default",
@@ -11720,6 +11762,15 @@
               "description": "Icon name following Quasar convention to be used when selected (optional); make sure you have the icon library installed unless you are using 'img:' prefix; If an array is provided each rating value will use the corresponding icon in the array (0 based)\n\nExamples:\nmap\nion-add\nimg:https://cdn.quasar.dev/logo-v2/svg/logo.svg\nimg:path/to/some_image.png",
               "doc-url": "https://v2.quasar.dev/vue-components/rating"
             },
+            {
+              "name": "icon-aria-label",
+              "value": {
+                "kind": "expression",
+                "type": "string|any[]"
+              },
+              "description": "Label to be set on aria-label for Icon; If an array is provided each rating value will use the corresponding aria-label in the array (0 based); If string value is provided the rating value will be appended; If not provided the name of the icon will be used\n\nExamples:\nRating\n[\"Bad\", \"Normal\", \"Good\"]",
+              "doc-url": "https://v2.quasar.dev/vue-components/rating"
+            },
             {
               "name": "color",
               "value": {
@@ -16693,17 +16744,17 @@
                 {
                   "name": "evt",
                   "type": "Event",
-                  "description": "JS event object; If you want to cancel navigation set synchronously 'evt.navigate' to false",
+                  "description": "JS event object; If you want to cancel navigation then call evt.preventDefault() synchronously in your event handler",
                   "doc-url": "https://v2.quasar.dev/vue-components/tabs"
                 },
                 {
-                  "name": "navigateFn",
+                  "name": "go",
                   "type": "Function",
-                  "description": "When you need to control the time at which the tab should trigger the route navigation then set 'evt.navigate' to false and call this function; Useful if you have async work to be done before the actual route navigation",
+                  "description": "When you need to control the time at which the component should trigger the route navigation then call evt.preventDefault() synchronously and then call this function at your convenience; Useful if you have async work to be done before the actual route navigation or if you want to redirect somewhere else",
                   "doc-url": "https://v2.quasar.dev/vue-components/tabs"
                 }
               ],
-              "description": "Emitted when component is clicked (activated)",
+              "description": "Emitted when the component is clicked",
               "doc-url": "https://v2.quasar.dev/vue-components/tabs"
             }
           ],

package/lang/nl.js

@@ -20,8 +20,8 @@ module.exports = {
     search: 'Zoek',
     filter: 'Filter',
     refresh: 'Ververs',
-    expand: label => (label ? `Vouw "${ label }" uit` : 'Uitbreiden'),
-    collapse: label => (label ? `"${ label }" samenvouwen` : 'Instorten')
+    expand: label => (label ? `"${ label }" uitklappen` : 'Uitklappen'),
+    collapse: label => (label ? `"${ label }" inklappen` : 'Inklappen')
   },
   date: {
     days: 'Zondag_Maandag_Dinsdag_Woensdag_Donderdag_Vrijdag_Zaterdag'.split('_'),

package/lang/nl.mjs

@@ -15,8 +15,8 @@ export default {
     search: 'Zoek',
     filter: 'Filter',
     refresh: 'Ververs',
-    expand: label => (label ? `Vouw "${ label }" uit` : 'Uitbreiden'),
-    collapse: label => (label ? `"${ label }" samenvouwen` : 'Instorten')
+    expand: label => (label ? `"${ label }" uitklappen` : 'Uitklappen'),
+    collapse: label => (label ? `"${ label }" inklappen` : 'Inklappen')
   },
   date: {
     days: 'Zondag_Maandag_Dinsdag_Woensdag_Donderdag_Vrijdag_Zaterdag'.split('_'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quasar",
-  "version": "2.8.4",
+  "version": "2.9.0",
   "description": "Build high-performance VueJS user interfaces (SPA, PWA, SSR, Mobile and Desktop) in record time",
   "main": "dist/quasar.cjs.prod.js",
   "module": "dist/quasar.esm.prod.js",
@@ -29,8 +29,10 @@
     "build": "node build/script.build.js",
     "lint": "eslint --ext .js,.vue src dev",
     "lint-fix": "eslint --ext .js,.vue src dev --fix",
-    "test:component": "node build/script.build.js && cd ./dev && cypress open-ct && cd ..",
-    "test:component:ci": "node build/script.build.js && cd ./dev && cypress run-ct --record --parallel && cd ..",
+    "test:build": "node build/script.build.js js api && node build/script.build.js js transforms",
+    "test:component": "yarn test:build && cd ./dev && cypress open-ct && cd ..",
+    "test:component:run": "yarn test:build && cd ./dev && cypress run-ct && cd ..",
+    "test:component:ci": "yarn test:build && cd ./dev && cypress run-ct --record --parallel && cd ..",
     "test:create": "node ./test/cypress/helpers/create-spec.js -c"
   },
   "repository": {

package/src/components/breadcrumbs/QBreadcrumbsEl.js

@@ -21,20 +21,19 @@ export default createComponent({
     }
   },
 
+  emits: [ 'click' ],
+
   setup (props, { slots }) {
-    const { linkTag, linkProps, linkClass, hasRouterLink, navigateToRouterLink } = useRouterLink()
+    const { linkTag, linkAttrs, linkClass, navigateOnClick } = useRouterLink()
 
     const data = computed(() => {
-      const acc = {
+      return {
         class: 'q-breadcrumbs__el q-link '
           + 'flex inline items-center relative-position '
           + (props.disable !== true ? 'q-link--focusable' + linkClass.value : 'q-breadcrumbs__el--disable'),
-        ...linkProps.value
-      }
-      if (hasRouterLink.value === true) {
-        acc.onClick = navigateToRouterLink
+        ...linkAttrs.value,
+        onClick: navigateOnClick
       }
-      return acc
     })
 
     const iconClass = computed(() =>

package/src/components/breadcrumbs/QBreadcrumbsEl.json

@@ -32,5 +32,58 @@
     "default": {
       "desc": "This is where custom content goes, unless 'icon' and 'label' props are not enough"
     }
+  },
+
+  "events": {
+    "click": {
+      "desc": "Emitted when the component is clicked",
+      "params": {
+        "evt": {
+          "extends": "evt",
+          "desc": "JS event object; If you are using route navigation ('to'/'replace' props) and you want to cancel navigation then call evt.preventDefault() synchronously in your event handler"
+        },
+        "go": {
+          "type": "Function",
+          "desc": "Available ONLY if you are using route navigation ('to'/'replace' props); When you need to control the time at which the component should trigger the route navigation then call evt.preventDefault() synchronously and then call this function at your convenience; Useful if you have async work to be done before the actual route navigation or if you want to redirect somewhere else",
+          "required": false,
+          "addedIn": "v2.9",
+          "params": {
+            "opts": {
+              "type": "Object",
+              "desc": "Optional options",
+              "required": false,
+              "definition": {
+                "to": {
+                  "type": [ "String", "Object" ],
+                  "desc": "Equivalent to Vue Router <router-link> 'to' property; Specify it explicitly otherwise it will be set with same value as component's 'to' prop",
+                  "required": false,
+                  "examples": [
+                    "/home/dashboard",
+                    "{ name: 'my-route-name' }"
+                  ]
+                },
+
+                "replace": {
+                  "type": "Boolean",
+                  "desc": "Equivalent to Vue Router <router-link> 'replace' property; Specify it explicitly otherwise it will be set with same value as component's 'replace' prop",
+                  "required": false
+                },
+
+                "returnRouterError": {
+                  "type": "Boolean",
+                  "desc": "Return the router error, if any; Otherwise the returned Promise will always fulfill",
+                  "required": false
+                }
+              }
+            }
+          },
+          "returns": {
+            "type": "Promise<any>",
+            "desc": "Returns the router's navigation promise",
+            "__exemption": [ "examples" ]
+          }
+        }
+      }
+    }
   }
 }

package/src/components/btn/QBtn.js

@@ -26,10 +26,12 @@ export default createComponent({
     ...useBtnProps,
 
     percentage: Number,
-    darkPercentage: Boolean
+    darkPercentage: Boolean,
+
+    onTouchstart: [ Function, Array ]
   },
 
-  emits: [ 'click', 'keydown', 'touchstart', 'mousedown', 'keyup' ],
+  emits: [ 'click', 'keydown', 'mousedown', 'keyup' ],
 
   setup (props, { slots, emit }) {
     const { proxy } = getCurrentInstance()
@@ -37,7 +39,7 @@ export default createComponent({
     const {
       classes, style, innerClasses,
       attributes,
-      hasRouterLink, hasLink, linkTag, navigateToRouterLink,
+      hasLink, linkTag, navigateOnClick,
       isActionable
     } = useBtn(props)
 
@@ -72,7 +74,7 @@ export default createComponent({
       if (props.loading === true) {
         return {
           onMousedown: onLoadingEvt,
-          onTouchstartPassive: onLoadingEvt,
+          onTouchstart: onLoadingEvt,
           onClick: onLoadingEvt,
           onKeydown: onLoadingEvt,
           onKeyup: onLoadingEvt
@@ -80,12 +82,21 @@ export default createComponent({
       }
 
       if (isActionable.value === true) {
-        return {
+        const acc = {
           onClick,
           onKeydown,
-          onMousedown,
-          onTouchstart
+          onMousedown
+        }
+
+        if (proxy.$q.platform.has.touch === true) {
+          const suffix = props.onTouchstart !== void 0
+            ? ''
+            : 'Passive'
+
+          acc[ `onTouchstart${ suffix }` ] = onTouchstart
         }
+
+        return acc
       }
 
       return {
@@ -135,18 +146,7 @@ export default createComponent({
         }
       }
 
-      if (hasRouterLink.value === true) {
-        const go = () => {
-          e.__qNavigate = true
-          navigateToRouterLink(e)
-        }
-
-        emit('click', e, go)
-        e.defaultPrevented !== true && go()
-      }
-      else {
-        emit('click', e)
-      }
+      navigateOnClick(e)
     }
 
     function onKeydown (e) {

package/src/components/btn/QBtn.json

@@ -49,17 +49,52 @@
 
   "events": {
     "click": {
-      "desc": "Emitted when component is clicked (activated)",
+      "desc": "Emitted when the component is clicked",
       "params": {
         "evt": {
           "extends": "evt",
-          "desc": "JS event object; If you want to cancel navigation set synchronously 'evt.navigate' to false"
+          "desc": "JS event object; If you are using route navigation ('to'/'replace' props) and you want to cancel navigation then call evt.preventDefault() synchronously in your event handler"
         },
-        "navigateFn": {
+        "go": {
           "type": "Function",
-          "desc": "When you need to control the time at which the button should trigger the route navigation then set 'evt.navigate' to false and call this function; Useful if you have async work to be done before the actual route navigation",
-          "params": null,
-          "returns": null
+          "desc": "Available ONLY if you are using route navigation ('to'/'replace' props); When you need to control the time at which the component should trigger the route navigation then call evt.preventDefault() synchronously and then call this function at your convenience; Useful if you have async work to be done before the actual route navigation or if you want to redirect somewhere else",
+          "required": false,
+          "addedIn": "v2.9",
+          "params": {
+            "opts": {
+              "type": "Object",
+              "desc": "Optional options",
+              "required": false,
+              "definition": {
+                "to": {
+                  "type": [ "String", "Object" ],
+                  "desc": "Equivalent to Vue Router <router-link> 'to' property; Specify it explicitly otherwise it will be set with same value as component's 'to' prop",
+                  "required": false,
+                  "examples": [
+                    "/home/dashboard",
+                    "{ name: 'my-route-name' }"
+                  ]
+                },
+
+                "replace": {
+                  "type": "Boolean",
+                  "desc": "Equivalent to Vue Router <router-link> 'replace' property; Specify it explicitly otherwise it will be set with same value as component's 'replace' prop",
+                  "required": false
+                },
+
+                "returnRouterError": {
+                  "type": "Boolean",
+                  "desc": "Return the router error, if any; Otherwise the returned Promise will always fulfill",
+                  "required": false
+                }
+              }
+            }
+          },
+          "returns": {
+            "type": "Promise<any>",
+            "desc": "Returns the router's navigation promise",
+            "__exemption": [ "examples" ]
+          }
         }
       }
     }

package/src/components/btn/use-btn.js

@@ -80,7 +80,9 @@ export const useBtnProps = {
 export default function (props) {
   const sizeStyle = useSize(props, defaultSizes)
   const alignClass = useAlign(props)
-  const { hasRouterLink, hasLink, linkTag, linkProps, navigateToRouterLink } = useRouterLink('button')
+  const { hasRouterLink, hasLink, linkTag, linkAttrs, navigateOnClick } = useRouterLink({
+    fallbackTag: 'button'
+  })
 
   const style = computed(() => {
     const obj = props.fab === false && props.fabMini === false
@@ -123,7 +125,7 @@ export default function (props) {
     const acc = { tabindex: tabIndex.value }
 
     if (hasLink.value === true) {
-      Object.assign(acc, linkProps.value)
+      Object.assign(acc, linkAttrs.value)
     }
     else if (formTypes.includes(props.type) === true) {
       acc.type = props.type
@@ -136,6 +138,7 @@ export default function (props) {
       else if (acc.href === void 0) {
         acc.role = 'button'
       }
+
       if (hasRouterLink.value !== true && mediaTypeRE.test(props.type) === true) {
         acc.type = props.type
       }
@@ -198,10 +201,9 @@ export default function (props) {
     style,
     innerClasses,
     attributes,
-    hasRouterLink,
     hasLink,
     linkTag,
-    navigateToRouterLink,
+    navigateOnClick,
     isActionable
   }
 }