quasar 2.3.0 → 2.3.4

package/src/composables/private/use-split-attrs.js

@@ -2,27 +2,30 @@ import { ref, onBeforeUpdate } from 'vue'
 
 const listenerRE = /^on[A-Z]/
 
-export default function (attrs) {
+export default function (attrs, vnode) {
   const acc = {
     listeners: ref({}),
     attributes: ref({})
   }
 
   function update () {
-    const listeners = {}
     const attributes = {}
+    const listeners = {}
 
     Object.keys(attrs).forEach(key => {
-      if (listenerRE.test(key) === true) {
-        listeners[ key ] = attrs[ key ]
-      }
-      else if (key !== 'class' && key !== 'style') {
+      if (key !== 'class' && key !== 'style' && listenerRE.test(key) === false) {
         attributes[ key ] = attrs[ key ]
       }
     })
 
-    acc.listeners.value = listeners
+    Object.keys(vnode.props).forEach(key => {
+      if (listenerRE.test(key) === true) {
+        listeners[ key ] = vnode.props[ key ]
+      }
+    })
+
     acc.attributes.value = attributes
+    acc.listeners.value = listeners
   }
 
   onBeforeUpdate(update)

package/src/composables/use-dialog-plugin-component.js

@@ -36,6 +36,7 @@ function useDialogPluginComponent () {
   }
 }
 
+// Don't forget to update the types in "ui/types/composables.d.ts"
 const emits = [ 'ok', 'hide' ]
 
 useDialogPluginComponent.emits = emits

package/src/css/core/transitions.sass

@@ -1,4 +1,6 @@
-// default easing is easeOutCubic
+// should not need this, but it's good as fallback
+\:root
+  --q-transition-duration: .3s
 
 .q-transition
   &--slide-right,

package/src/directives/Mutation.json

@@ -27,9 +27,8 @@
           },
 
           "target": {
-            "type": "Object",
-            "desc": "The DOM element that the mutation affected, depending on the mutation type",
-            "__exemption": [ "examples" ]
+            "type": "Element",
+            "desc": "The DOM element that the mutation affected, depending on the mutation type"
           },
 
           "addedNodes": {

package/src/directives/ScrollFire.json

@@ -8,9 +8,8 @@
     "desc": "Function to call when scrolling and element comes into the viewport (use a non-function to disable)",
     "params": {
       "el": {
-        "type": "Object",
-        "desc": "DOM element that scroll-fire is applied to",
-        "__exemption": [ "examples" ]
+        "type": "Element",
+        "desc": "DOM element that scroll-fire is applied to"
       }
     },
     "returns": null,

package/src/install-quasar.js

@@ -84,6 +84,7 @@ export default __QUASAR_SSR_SERVER__
         _meta: {
           htmlAttrs: '',
           headTags: '',
+          endingHeadTags: '',
           bodyClasses: '',
           bodyAttrs: 'data-server-rendered',
           bodyTags: ''

package/src/plugins/AppFullscreen.json

@@ -17,9 +17,9 @@
     },
 
     "activeEl": {
-      "type": "Object",
+      "type": [ "Element", "null" ],
       "desc": "The DOM element used as root for fullscreen, otherwise 'null'",
-      "__exemption": [ "examples" ]
+      "examples": [ "document.fullscreenElement", "null" ]
     }
   },
 
@@ -34,8 +34,8 @@
         }
       },
       "returns": {
-        "type": "Promise<any>",
-        "desc": "A Promise with the outcome (true -> validation was a success, false -> invalid models detected)",
+        "type": "Promise<void>",
+        "desc": "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.",
         "examples": [
           "request().then(response => { ... }).catch(err => { ... })"
         ]
@@ -45,8 +45,8 @@
     "exit": {
       "desc": "Request exiting out of Fullscreen mode",
       "returns": {
-        "type": "Promise<any>",
-        "desc": "A Promise with the outcome (true -> validation was a success, false -> invalid models detected)",
+        "type": "Promise<void>",
+        "desc": "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.",
         "examples": [
           "exit().then(response => { ... }).catch(err => { ... })"
         ]
@@ -63,8 +63,8 @@
         }
       },
       "returns": {
-        "type": "Promise<any>",
-        "desc": "A Promise with the outcome (true -> validation was a success, false -> invalid models detected)",
+        "type": "Promise<void>",
+        "desc": "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.",
         "examples": [
           "toggle().then(response => { ... }).catch(err => { ... })"
         ]

package/src/plugins/Cookies.json

@@ -73,8 +73,8 @@
             },
             "sameSite": {
               "type": "String",
-              "desc": "SameSite cookie option (not supported by IE11)",
-              "examples": [ "Strict", "Lax" ]
+              "desc": "SameSite cookie option",
+              "values": [ "Lax", "Strict", "None" ]
             },
             "httpOnly": {
               "type": "Boolean",

package/src/plugins/Dialog.json

@@ -46,8 +46,8 @@
               "definition": {
                 "model": {
                   "type": "String",
-                  "desc": "The initial value of the input",
                   "required": true,
+                  "desc": "The initial value of the input",
                   "__exemption": [ "examples" ]
                 },
 
@@ -64,6 +64,7 @@
                   "params": {
                     "val": {
                       "type": "String",
+                      "required": true,
                       "desc": "The value of the input",
                       "__exemption": [ "examples" ]
                     }
@@ -151,8 +152,8 @@
               "definition": {
                 "model": {
                   "type": [ "String", "Array" ],
-                  "desc": "The value of the selection (String if it's of type radio or Array otherwise)",
                   "required": true,
+                  "desc": "The value of the selection (String if it's of type radio or Array otherwise)",
                   "examples": [ "[]" ]
                 },
 
@@ -177,6 +178,7 @@
                   "params": {
                     "model": {
                       "type": [ "String", "Array" ],
+                      "required": true,
                       "desc": "The current model (String if it's of type radio or Array otherwise)",
                       "examples": [
                         "opt2",
@@ -304,9 +306,8 @@
             },
 
             "component": {
-              "type": "Any",
-              "desc": "Use custom dialog component; use along with 'componentProps' prop where possible",
-              "__exemption": [ "examples" ]
+              "type": "Component",
+              "desc": "Use custom dialog component; use along with 'componentProps' prop where possible"
             },
 
             "componentProps": {

package/src/plugins/LoadingBar.json

@@ -23,6 +23,7 @@
         "speed": {
           "type": "Number",
           "desc": "Delay (in milliseconds) between bar progress increments",
+          "default": 300,
           "examples": [ 150 ]
         }
       }
@@ -46,11 +47,11 @@
     "setDefaults": {
       "desc": "Set the inner QAjaxBar's props",
       "params": {
-        "...props": {
+        "props": {
           "type": "Object",
-          "desc": "QAjaxBar component props",
           "required": true,
-          "__exemption": [ "examples" ]
+          "desc": "QAjaxBar component props",
+          "examples": [ "{ position: 'bottom', reverse: true }" ]
         }
       }
     }

package/src/plugins/Notify.json

@@ -164,6 +164,7 @@
       "params": {
         "opts": {
           "type": [ "Object", "String" ],
+          "required": true,
           "desc": "Notification options",
           "definition": {
             "type": {
@@ -214,7 +215,7 @@
             "spinner": {
               "type": [ "Boolean", "Component" ],
               "desc": "Useful for notifications that are updated; Displays a Quasar spinner instead of an avatar or icon; If value is Boolean 'true' then the default QSpinner is shown",
-              "__exemption": [ "examples" ]
+              "examples": [ true, "QSpinnerBars" ]
             },
 
             "position": {
@@ -225,8 +226,7 @@
                 "top-left", "top-right",
                 "bottom-left", "bottom-right",
                 "top", "bottom", "left", "right", "center"
-              ],
-              "examples": [ "top-right" ]
+              ]
             },
 
             "group": {
@@ -251,8 +251,7 @@
               "values": [
                 "top-left", "top-right",
                 "bottom-left", "bottom-right"
-              ],
-              "examples": [ "bottom-right" ]
+              ]
             },
             "badgeStyle": {
               "type": [ "Array", "String", "Object" ],
@@ -339,9 +338,7 @@
               "type": "Boolean",
               "desc": "Ignore the default configuration (set by setDefaults()) for this instance only"
             }
-          },
-          "required": true,
-          "__exemption": [ "examples" ]
+          }
         }
       },
       "returns": {
@@ -350,6 +347,7 @@
         "params": {
           "props": {
             "type": "Object",
+            "required": false,
             "desc": "Notification properties that will be shallow merged to previous ones in order to update the non-grouped notification",
             "definition": {
               "type": {
@@ -483,6 +481,7 @@
       "params": {
         "opts": {
           "type": "Object",
+          "required": true,
           "desc": "Notification options",
           "definition": {
             "type": {
@@ -607,8 +606,7 @@
             "attrs": {
               "type": "Object",
               "desc": "Key-value for attributes to be set on the notification",
-              "examples": [ "{ role: 'alertdialog' }" ],
-              "__exemption": [ "definition" ]
+              "examples": [ "{ role: 'alertdialog' }" ]
             },
 
             "timeout": {
@@ -646,9 +644,7 @@
               "type": "Boolean",
               "desc": "Put notification into multi-line mode; If this prop isn't used and more than one 'action' is specified then notification goes into multi-line mode by default"
             }
-          },
-          "required": true,
-          "__exemption": [ "examples" ]
+          }
         }
       }
     },
@@ -658,13 +654,14 @@
       "params": {
         "typeName": {
           "type": "String",
-          "desc": "Name of the type (to be used as 'type' prop later on)",
           "required": true,
+          "desc": "Name of the type (to be used as 'type' prop later on)",
           "examples": [ "my-type" ]
         },
 
         "typeOpts": {
           "type": "Object",
+          "required": true,
           "desc": "Notification options",
           "definition": {
             "type": {
@@ -789,8 +786,7 @@
             "attrs": {
               "type": "Object",
               "desc": "Key-value for attributes to be set on the notification",
-              "examples": [ "{ role: 'alertdialog' }" ],
-              "__exemption": [ "definition" ]
+              "examples": [ "{ role: 'alertdialog' }" ]
             },
 
             "timeout": {
@@ -828,9 +824,7 @@
               "type": "Boolean",
               "desc": "Put notification into multi-line mode; If this prop isn't used and more than one 'action' is specified then notification goes into multi-line mode by default"
             }
-          },
-          "required": true,
-          "__exemption": [ "examples" ]
+          }
         }
       }
     }

package/src/utils/private/global-dialog.json

@@ -29,14 +29,23 @@
         "definition": {
           "onOk": {
             "type": "Function",
+            "required": true,
             "desc": "Receives a Function param to tell what to do when OK is pressed / option is selected",
             "params": {
               "callbackFn": {
                 "type": "Function",
                 "desc": "Tell what to do",
                 "required": true,
-                "params": null,
-                "returns": null
+                "params": {
+                  "payload": {
+                    "type": "Any",
+                    "desc": "The payload if called onDialogOK with the parameter or emitted one with the 'ok' event",
+                    "required": false,
+                    "examples": [ "'Quasar Framework'", "[ 1, 2, 6, 3 ]", "{ book: { id: 1, name: 'Lorem Ipsum' }, user: { name: 'Lorem J. Ipsum', role: 'admin' } }" ]
+                  }
+                },
+                "returns": null,
+                "examples": [ "() => console.log('OK!')", "(payload) => Notify.create({ type: 'positive', message: `Successfully saved '${payload.book.name}' book!` })" ]
               }
             },
             "returns": {
@@ -49,6 +58,7 @@
 
           "onCancel": {
             "type": "Function",
+            "required": true,
             "desc": "Receives a Function as param to tell what to do when Cancel is pressed / dialog is dismissed",
             "params": {
               "callbackFn": {
@@ -69,6 +79,7 @@
 
           "onDismiss": {
             "type": "Function",
+            "required": true,
             "desc": "Receives a Function param to tell what to do when the dialog is closed",
             "params": {
               "callbackFn": {
@@ -89,6 +100,7 @@
 
           "hide": {
             "type": "Function",
+            "required": true,
             "desc": "Hides the dialog when called",
             "params": null,
             "returns": {
@@ -101,10 +113,12 @@
 
           "update": {
             "type": "Function",
+            "required": true,
             "desc": "Updates the initial properties (given as create() param) except for 'component'",
             "params": {
               "opts": {
                 "type": "Object",
+                "required": true,
                 "desc": "Props (except 'component') which will overwrite the initial create() params; If create() was invoked with a custom dialog component then this param should contain the new componentProps",
                 "__exemption": [ "examples" ]
               }

package/src/utils/private/web-storage.json

@@ -118,6 +118,16 @@
           "type": [ "Date", "RegExp", "Number", "Boolean", "Function", "Object", "Array", "String", "null" ],
           "desc": "Entry value",
           "required": true,
+          "params": {
+            "...params": {
+              "type": "Any",
+              "__exemption": [ "desc", "examples" ]
+            }
+          },
+          "returns": {
+            "type": "Any",
+            "__exemption": [ "desc", "examples" ]
+          },
           "examples": [ "john12" ]
         }
       }

package/wrappers/index.js

@@ -14,6 +14,10 @@ module.exports.ssrMiddleware = function (callback) {
   return callback
 }
 
+module.exports.ssrProductionExport = function (callback) {
+  return callback
+}
+
 module.exports.configure = function (callback) {
   return callback
 }