quasar 2.15.1 → 2.15.3

package/src/components/tooltip/QTooltip.json

@@ -1,5 +1,5 @@
 {
-  "mixins": [ "composables/private/use-model-toggle", "composables/private/use-portal", "composables/private/use-transition" ],
+  "mixins": [ "composables/private.use-model-toggle/use-model-toggle", "composables/private.use-portal/use-portal", "composables/private.use-transition/use-transition" ],
 
   "meta": {
     "docsUrl": "https://v2.quasar.dev/vue-components/tooltip"
@@ -9,7 +9,7 @@
     "max-height": {
       "extends": "size",
       "type": [ "String", "null" ],
-      "default": null,
+      "default": "null",
       "desc": "The maximum height of the Tooltip; Size in CSS units, including unit name",
       "category": "content"
     },
@@ -17,28 +17,28 @@
     "max-width": {
       "extends": "size",
       "type": [ "String", "null" ],
-      "default": null,
+      "default": "null",
       "desc": "The maximum width of the Tooltip; Size in CSS units, including unit name",
       "category": "content"
     },
 
     "transition-show": {
-      "default": "jump-down"
+      "default": "'jump-down'"
     },
 
     "transition-hide": {
-      "default": "jump-up"
+      "default": "'jump-up'"
     },
 
     "anchor": {
       "type": "String",
       "desc": "Two values setting the starting position or anchor point of the Tooltip relative to its target",
       "values": [
-        "top left", "top middle", "top right", "top start", "top end",
-        "center left", "center middle", "center right", "center start", "center end",
-        "bottom left", "bottom middle", "bottom right", "bottom start", "bottom end"
+        "'top left'", "'top middle'", "'top right'", "'top start'", "'top end'",
+        "'center left'", "'center middle'", "'center right'", "'center start'", "'center end'",
+        "'bottom left'", "'bottom middle'", "'bottom right'", "'bottom start'", "'bottom end'"
       ],
-      "default": "bottom middle",
+      "default": "'bottom middle'",
       "category": "position"
     },
 
@@ -46,19 +46,19 @@
       "type": "String",
       "desc": "Two values setting the Tooltip's own position relative to its target",
       "values": [
-        "top left", "top middle", "top right", "top start", "top end",
-        "center left", "center middle", "center right", "center start", "center end",
-        "bottom left", "bottom middle", "bottom right", "bottom start", "bottom end"
+        "'top left'", "'top middle'", "'top right'", "'top start'", "'top end'",
+        "'center left'", "'center middle'", "'center right'", "'center start'", "'center end'",
+        "'bottom left'", "'bottom middle'", "'bottom right'", "'bottom start'", "'bottom end'"
       ],
-      "default": "top middle",
+      "default": "'top middle'",
       "category": "position"
     },
 
     "offset": {
       "type": "Array",
       "desc": "An array of two numbers to offset the Tooltip horizontally and vertically in pixels",
-      "default": "[14, 14]",
-      "examples": [ "[8, 8]", "[5, 10]" ],
+      "default": "[ 14, 14 ]",
+      "examples": [ "[ 8, 8 ]", "[ 5, 10 ]" ],
       "category": "position"
     },
 
@@ -69,12 +69,8 @@
     "target": {
       "type": [ "Boolean", "String" ],
       "desc": "Configure a target element to trigger Tooltip toggle; 'true' means it enables the parent DOM element, 'false' means it disables attaching events to any DOM elements; By using a String (CSS selector) it attaches the events to the specified DOM element (if it exists)",
-      "default": true,
-      "values": [ "(Boolean) true", "(Boolean) false", "(CSS selector)" ],
-      "examples": [
-        ":target=\"false\"",
-        "target=\".my-parent\""
-      ],
+      "default": "true",
+      "examples": [ "# :target=\"false\"", "# target=\".my-parent\"" ],
       "category": "behavior"
     },
 
@@ -87,14 +83,14 @@
     "delay": {
       "type": "Number",
       "desc": "Configure Tooltip to appear with delay",
-      "default": 0,
+      "default": "0",
       "category": "behavior"
     },
 
     "hide-delay": {
       "type": "Number",
       "desc": "Configure Tooltip to disappear with delay",
-      "default": 0,
+      "default": "0",
       "category": "behavior"
     },
 
@@ -113,7 +109,9 @@
 
   "methods": {
     "updatePosition": {
-      "desc": "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"
+      "desc": "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",
+      "params": null,
+      "returns": null
     }
   }
 }

package/src/components/tree/QTree.js

@@ -8,12 +8,12 @@ import QCheckbox from '../checkbox/QCheckbox.js'
 import QSlideTransition from '../slide-transition/QSlideTransition.js'
 import QSpinner from '../spinner/QSpinner.js'
 
-import useDark, { useDarkProps } from '../../composables/private/use-dark.js'
+import useDark, { useDarkProps } from '../../composables/private.use-dark/use-dark.js'
 
-import { createComponent } from '../../utils/private/create.js'
-import { stopAndPrevent } from '../../utils/event.js'
-import { shouldIgnoreKey } from '../../utils/private/key-composition.js'
-import { injectProp } from '../../utils/private/inject-obj-prop.js'
+import { createComponent } from '../../utils/private.create/create.js'
+import { stopAndPrevent } from '../../utils/event/event.js'
+import { shouldIgnoreKey } from '../../utils/private.keyboard/key-composition.js'
+import { injectProp } from '../../utils/private.inject-obj-prop/inject-obj-prop.js'
 
 const tickStrategyOptions = [ 'none', 'strict', 'leaf', 'leaf-filtered' ]
 

package/src/components/tree/QTree.json

@@ -9,7 +9,7 @@
       "tsType": "QTreeNode",
       "desc": "The array of nodes that designates the tree structure",
       "required": true,
-      "examples": [ "[ {...}, {...} ]" ],
+      "examples": [ "[ {}, {} ]" ],
       "category": "content"
     },
 
@@ -17,23 +17,23 @@
       "type": "String",
       "desc": "The property name of each node object that holds a unique node id",
       "required": true,
-      "examples": [ "key", "id" ],
+      "examples": [ "'key'", "'id'" ],
       "category": "content"
     },
 
     "label-key": {
       "type": "String",
       "desc": "The property name of each node object that holds the label of the node",
-      "default": "label",
-      "examples": [ "name", "description" ],
+      "default": "'label'",
+      "examples": [ "'name'", "'description'" ],
       "category": "content"
     },
 
     "children-key": {
       "type": "String",
       "desc": "The property name of each node object that holds the list of children of the node",
-      "default": "children",
-      "examples": [ "roles", "relatives" ],
+      "default": "'children'",
+      "examples": [ "'roles'", "'relatives'" ],
       "category": "content"
     },
 
@@ -78,8 +78,8 @@
     "tick-strategy": {
       "type": "String",
       "desc": "The type of strategy to use for the selection of the nodes",
-      "default": "none",
-      "values": [ "none", "strict", "leaf", "leaf-filtered" ],
+      "default": "'none'",
+      "values": [ "'none'", "'strict'", "'leaf'", "'leaf-filtered'" ],
       "category": "behavior"
     },
 
@@ -87,7 +87,7 @@
       "type": "Array",
       "desc": "Keys of nodes that are ticked",
       "sync": true,
-      "examples": [ "v-model:ticked=\"tickedKeys\"" ],
+      "examples": [ "# v-model:ticked=\"tickedKeys\"" ],
       "category": "state"
     },
 
@@ -95,7 +95,7 @@
       "type": "Array",
       "desc": "Keys of nodes that are expanded",
       "sync": true,
-      "examples": [ "v-model:expanded=\"expandedKeys\"" ],
+      "examples": [ "# v-model:expanded=\"expandedKeys\"" ],
       "category": "state"
     },
 
@@ -103,7 +103,7 @@
       "type": "Any",
       "desc": "Key of node currently selected",
       "sync": true,
-      "examples": [ "v-model:selected=\"selectedKey\"" ],
+      "examples": [ "# v-model:selected=\"selectedKey\"" ],
       "category": "state"
     },
 
@@ -136,14 +136,14 @@
     "filter": {
       "type": "String",
       "desc": "The text value to be used for filtering nodes",
-      "examples": [ ":filter=\"searchText\"" ],
+      "examples": [ "'car'" ],
       "category": "filter"
     },
 
     "filter-method": {
       "type": "Function",
       "desc": "The function to use to filter the tree nodes; For best performance, reference it from your scope and do not define it inline",
-      "default": "(see source code)",
+      "default": "# see source code",
       "params": {
         "node": {
           "type": "Object",
@@ -164,21 +164,21 @@
     "duration": {
       "type": "Number",
       "desc": "Toggle animation duration (in milliseconds)",
-      "default": 300,
+      "default": "300",
       "category": "style"
     },
 
     "no-nodes-label": {
       "type": "String",
       "desc": "Override default such label for when no nodes are available",
-      "examples": [ "No nodes to show!" ],
+      "examples": [ "'No nodes to show!'" ],
       "category": "content"
     },
 
     "no-results-label": {
       "type": "String",
       "desc": "Override default such label for when no nodes are available due to filtering",
-      "examples": [ "No results" ],
+      "examples": [ "'No results'" ],
       "category": "content"
     }
   },
@@ -213,7 +213,7 @@
         "color": {
           "type": "String",
           "desc": "QTree instance 'color' supplied prop value",
-          "examples": [ "primary" ]
+          "examples": [ "'primary'" ]
         },
         "dark": {
           "type": "Boolean",
@@ -251,7 +251,7 @@
         "color": {
           "type": "String",
           "desc": "QTree instance 'color' supplied prop value",
-          "examples": [ "primary" ]
+          "examples": [ "'primary'" ]
         },
         "dark": {
           "type": "Boolean",
@@ -289,7 +289,7 @@
         "color": {
           "type": "String",
           "desc": "QTree instance 'color' supplied prop value",
-          "examples": [ "primary" ]
+          "examples": [ "'primary'" ]
         },
         "dark": {
           "type": "Boolean",
@@ -327,7 +327,7 @@
         "color": {
           "type": "String",
           "desc": "QTree instance 'color' supplied prop value",
-          "examples": [ "primary" ]
+          "examples": [ "'primary'" ]
         },
         "dark": {
           "type": "Boolean",
@@ -365,7 +365,7 @@
               "type": "String",
               "required": true,
               "desc": "The key of the node getting the newly loaded child nodes",
-              "examples": [ "New Node" ]
+              "examples": [ "'New Node'" ]
             },
             "done": {
               "type": "Function",
@@ -409,7 +409,7 @@
         "target": {
           "type": "Any",
           "desc": "The selected node key",
-          "examples": [ "Node 1" ]
+          "examples": [ "'Node 1'" ]
         }
       }
     },
@@ -431,7 +431,7 @@
           "type": "Any",
           "required": true,
           "desc": "The key of a node",
-          "examples": [ "Node 1" ]
+          "examples": [ "'Node 1'" ]
         }
       },
       "returns": {
@@ -442,6 +442,7 @@
 
     "getTickedNodes": {
       "desc": "Get array of nodes that are ticked",
+      "params": null,
       "returns": {
         "type": "Array",
         "desc": "Ticked node objects"
@@ -450,6 +451,7 @@
 
     "getExpandedNodes": {
       "desc": "Get array of nodes that are expanded",
+      "params": null,
       "returns": {
         "type": "Array",
         "desc": "Expanded node objects"
@@ -463,7 +465,7 @@
           "type": "Any",
           "required": true,
           "desc": "The key of a node",
-          "examples": [ "Node 1" ]
+          "examples": [ "'Node 1'" ]
         }
       },
       "returns": {
@@ -473,11 +475,15 @@
     },
 
     "expandAll": {
-      "desc": "Use to expand all branches of the tree"
+      "desc": "Use to expand all branches of the tree",
+      "params": null,
+      "returns": null
     },
 
     "collapseAll": {
-      "desc": "Use to collapse all branches of the tree"
+      "desc": "Use to collapse all branches of the tree",
+      "params": null,
+      "returns": null
     },
 
     "setExpanded": {
@@ -487,14 +493,15 @@
           "type": "Any",
           "required": true,
           "desc": "The key of a node",
-          "examples": [ "Node 1" ]
+          "examples": [ "'Node 1'" ]
         },
         "state": {
           "type": "Boolean",
           "required": true,
           "desc": "Set to 'true' to expand the branch of the tree, otherwise 'false' collapses it"
         }
-      }
+      },
+      "returns": null
     },
 
     "isTicked": {
@@ -504,7 +511,7 @@
           "type": "Any",
           "required": true,
           "desc": "The key of a node",
-          "examples": [ "Node 1" ]
+          "examples": [ "'Node 1'" ]
         }
       },
       "returns": {
@@ -527,7 +534,8 @@
           "required": true,
           "desc": "Set to 'true' to tick the checkbox of nodes, otherwise 'false' unticks them"
         }
-      }
+      },
+      "returns": null
     }
   }
 }

package/src/components/uploader/QUploader.js

@@ -1,4 +1,4 @@
-import createUploaderComponent from '../../utils/create-uploader-component.js'
+import createUploaderComponent from '../../utils/create-uploader-component/create-uploader-component.js'
 import xhrUploaderPlugin from './xhr-uploader-plugin.js'
 
 export default createUploaderComponent(xhrUploaderPlugin)

package/src/components/uploader/QUploader.json

@@ -1,5 +1,5 @@
 {
-  "mixins": [ "composables/private/use-file", "components/uploader/xhr-uploader-plugin" ],
+  "mixins": [ "composables/private.use-file/use-file", "components/uploader/xhr-uploader-plugin" ],
 
   "meta": {
     "docsUrl": "https://v2.quasar.dev/vue-components/uploader"
@@ -9,7 +9,7 @@
     "label": {
       "type": "String",
       "desc": "Label for the uploader",
-      "examples": ["Upload photo here"],
+      "examples": [ "'Upload photo here'" ],
       "category": "content"
     },
 
@@ -120,23 +120,33 @@
 
   "methods": {
     "upload": {
-      "desc": "Start uploading (same as clicking the upload button)"
+      "desc": "Start uploading (same as clicking the upload button)",
+      "params": null,
+      "returns": null
     },
 
     "abort": {
-      "desc": "Abort upload of all files (same as clicking the abort button)"
+      "desc": "Abort upload of all files (same as clicking the abort button)",
+      "params": null,
+      "returns": null
     },
 
     "reset": {
-      "desc": "Resets uploader to default; Empties queue, aborts current uploads"
+      "desc": "Resets uploader to default; Empties queue, aborts current uploads",
+      "params": null,
+      "returns": null
     },
 
     "removeUploadedFiles": {
-      "desc": "Removes already uploaded files from the list"
+      "desc": "Removes already uploaded files from the list",
+      "params": null,
+      "returns": null
     },
 
     "removeQueuedFiles": {
-      "desc": "Remove files that are waiting for upload to start (same as clicking the left clear button)"
+      "desc": "Remove files that are waiting for upload to start (same as clicking the left clear button)",
+      "params": null,
+      "returns": null
     },
 
     "removeFile": {
@@ -147,7 +157,8 @@
           "desc": "The file to remove",
           "required": true
         }
-      }
+      },
+      "returns": null
     },
 
     "updateFileStatus": {
@@ -161,7 +172,7 @@
         "status": {
           "type": "String",
           "desc": "Status of file",
-          "values": [ "idle", "failed", "uploading", "uploaded" ],
+          "values": [ "'idle'", "'failed'", "'uploading'", "'uploaded'" ],
           "required": true
         },
         "uploadedSize": {
@@ -169,11 +180,13 @@
           "desc": "The number of uploaded bytes of the file; Is required explicitly only when status is NOT 'uploaded'",
           "required": true
         }
-      }
+      },
+      "returns": null
     },
 
     "isAlive": {
       "desc": "Is the component alive (activated but not unmounted); Useful to determine if you still need to compute anything going further",
+      "params": null,
       "returns": {
         "type": "Boolean",
         "desc": "If true, the current component is still activated and mounted"
@@ -188,7 +201,8 @@
           "required": true,
           "desc": "JS event object of the original user interaction handler"
         }
-      }
+      },
+      "returns": null
     },
 
     "addFiles": {
@@ -199,7 +213,8 @@
           "required": true,
           "desc": "Must be an array of instances of JS File type"
         }
-      }
+      },
+      "returns": null
     }
   },
 
@@ -227,13 +242,13 @@
     "uploadSizeLabel": {
       "type": "String",
       "desc": "Label for the size total of all files",
-      "examples": [ "1.0MB" ]
+      "examples": [ "'1.0MB'" ]
     },
 
     "uploadProgressLabel": {
       "type": "String",
       "desc": "Label for the upload progress (in %)",
-      "examples": [ "52.76%" ]
+      "examples": [ "'52.76%'" ]
     },
 
     "canAddFiles": {

package/src/components/uploader/QUploaderAddTrigger.js

@@ -1,7 +1,7 @@
 import { inject } from 'vue'
 
-import { createComponent } from '../../utils/private/create.js'
-import { uploaderKey, emptyRenderFn } from '../../utils/private/symbols.js'
+import { createComponent } from '../../utils/private.create/create.js'
+import { uploaderKey, emptyRenderFn } from '../../utils/private.symbols/symbols.js'
 
 export default createComponent({
   name: 'QUploaderAddTrigger',

package/src/components/uploader/uploader-core.js

@@ -5,14 +5,14 @@ import QIcon from '../icon/QIcon.js'
 import QSpinner from '../spinner/QSpinner.js'
 import QCircularProgress from '../circular-progress/QCircularProgress.js'
 
-import useDark, { useDarkProps } from '../../composables/private/use-dark.js'
-import useFile, { useFileProps, useFileEmits } from '../../composables/private/use-file.js'
-
-import { stop } from '../../utils/event.js'
-import { humanStorageSize } from '../../utils/format.js'
-import { uploaderKey } from '../../utils/private/symbols.js'
-import { injectProp, injectMultipleProps } from '../../utils/private/inject-obj-prop.js'
-import { vmIsDestroyed } from '../../utils/private/vm.js'
+import useDark, { useDarkProps } from '../../composables/private.use-dark/use-dark.js'
+import useFile, { useFileProps, useFileEmits } from '../../composables/private.use-file/use-file.js'
+
+import { stop } from '../../utils/event/event.js'
+import { humanStorageSize } from '../../utils/format/format.js'
+import { uploaderKey } from '../../utils/private.symbols/symbols.js'
+import { injectProp, injectMultipleProps } from '../../utils/private.inject-obj-prop/inject-obj-prop.js'
+import { vmIsDestroyed } from '../../utils/private.vm/vm.js'
 
 function getProgressLabel (p) {
   return (p * 100).toFixed(2) + '%'

package/src/components/uploader/xhr-uploader-plugin.js

@@ -6,6 +6,8 @@ function getFn (prop) {
     : () => prop
 }
 
+const name = 'QUploader'
+
 const props = {
   url: [ Function, String ],
   method: {
@@ -251,7 +253,7 @@ function injectPlugin ({ props, emit, helpers }) {
 }
 
 export default {
-  name: 'QUploader',
+  name,
   props,
   emits,
   injectPlugin