quasar 2.15.1 → 2.15.3

package/src/components/fab/QFabAction.json

@@ -9,9 +9,7 @@
     "anchor": {
       "type": "String",
       "desc": "How to align the Fab Action relative to Fab expand side; By default it uses the align specified in QFab",
-      "values": [
-        "start", "center", "end"
-      ],
+      "values": [ "'start'", "'center'", "'end'" ],
       "category": "style|content"
     },
 
@@ -19,8 +17,8 @@
       "type": [ "String", "Object" ],
       "desc": "Equivalent to Vue Router <router-link> 'to' property",
       "examples": [
-        "/home/dashboard",
-        ":to=\"{ name: 'my-route-name' }\""
+        "'/home/dashboard'",
+        "{ name: 'my-route-name' }"
       ],
       "category": "router"
     },
@@ -61,7 +59,8 @@
         "evt": {
           "extends": "evt"
         }
-      }
+      },
+      "returns": null
     }
   }
 }

package/src/components/fab/use-fab.json

@@ -7,10 +7,8 @@
     "type":{
       "type": "String",
       "desc": "Define the button HTML DOM type",
-      "default": "a",
-      "values": [
-        "a", "submit", "button", "reset"
-      ],
+      "default": "'a'",
+      "values": [ "'a'", "'submit'", "'button'", "'reset'" ],
       "category": "general"
     },
 
@@ -41,7 +39,7 @@
     "padding": {
       "type": "String",
       "desc": "Apply custom padding (vertical [horizontal]); Size in CSS units, including unit name or standard size name (none|xs|sm|md|lg|xl); Also removes the min width and height when set",
-      "examples": [ "16px", "10px 5px", "2rem", "xs", "md lg" ],
+      "examples": [ "'16px'", "'10px 5px'", "'2rem'", "'xs'", "'md lg'" ],
       "category": "style"
     },
 
@@ -68,20 +66,20 @@
     "label": {
       "type": [ "String", "Number" ],
       "desc": "The label that will be shown when Fab is extended",
-      "examples": [ "Button Label" ],
+      "examples": [ "'Button Label'" ],
       "category": "content"
     },
 
     "label-position": {
       "type": "String",
       "desc": "Position of the label around the icon",
-      "values": [ "top", "right", "bottom", "left" ],
+      "values": [ "'top'", "'right'", "'bottom'", "'left'" ],
       "category": "style|content"
     },
 
     "hide-label": {
       "type": [ "Boolean", "null" ],
-      "default": null,
+      "default": "null",
       "desc": "Hide the label; Useful for animation purposes where you toggle the visibility of the label",
       "category": "style|content"
     },
@@ -91,8 +89,8 @@
       "tsType": "VueClassProp",
       "desc": "Class definitions to be attributed to the label container",
       "examples": [
-        "my-special-class",
-        ":input-class=\"{ 'my-special-class': <condition> }\""
+        "'my-special-class'",
+        "{ 'my-special-class': true }"
       ],
       "category": "style"
     },
@@ -102,8 +100,8 @@
       "tsType": "VueStyleProp",
       "desc": "Style definitions to be attributed to the label container",
       "examples": [
-        "background-color: #ff0000",
-        ":input-style=\"{ backgroundColor: '#ff0000' }\""
+        "'background-color: #ff0000'",
+        "{ backgroundColor: '#ff0000' }"
       ],
       "category": "style"
     },

package/src/components/field/QField.js

@@ -1,6 +1,6 @@
-import useField, { useFieldState, useFieldProps, useFieldEmits } from '../../composables/private/use-field.js'
+import useField, { useFieldState, useFieldProps, useFieldEmits } from '../../composables/private.use-field/use-field.js'
 
-import { createComponent } from '../../utils/private/create.js'
+import { createComponent } from '../../utils/private.create/create.js'
 
 export default createComponent({
   name: 'QField',

package/src/components/field/QField.json

@@ -1,5 +1,5 @@
 {
-  "mixins": [ "composables/private/use-field" ],
+  "mixins": [ "composables/private.use-field/use-field" ],
 
   "meta": {
     "docsUrl": "https://v2.quasar.dev/vue-components/field"
@@ -20,8 +20,8 @@
 
     "tag": {
       "extends": "tag",
-      "default": "label",
-      "examples": [ "div", "label" ],
+      "default": "'label'",
+      "examples": [ "'div'", "'label'" ],
       "addedIn": "v2.13.1"
     }
   },
@@ -33,7 +33,7 @@
         "id": {
           "type": "String",
           "desc": "Element id used in the 'for' attribute of the field label. Can be used to link the control to the label",
-          "examples": [ "qf_363270c0-7a83-62b1-8dcf-6dfd64ee38fa" ]
+          "examples": [ "'qf_363270c0-7a83-62b1-8dcf-6dfd64ee38fa'" ]
         },
         "field": {
           "type": "Element",
@@ -54,7 +54,7 @@
         "modelValue": {
           "type": "Any",
           "desc": "Field's value",
-          "examples": [ 0.241, "Text" ]
+          "examples": [ "0.241", "'Text'" ]
         },
         "emitValue": {
           "type": "Function",
@@ -64,7 +64,7 @@
               "type": "Any",
               "required": true,
               "desc": "Value to be emitted",
-              "examples": [ 0, "Changed text" ]
+              "examples": [ "0", "'Changed text'" ]
             }
           },
           "returns": null
@@ -104,11 +104,15 @@
 
   "methods": {
     "focus": {
-      "desc": "Focus field"
+      "desc": "Focus field",
+      "params": null,
+      "returns": null
     },
 
     "blur": {
-      "desc": "Blur field (lose focus)"
+      "desc": "Blur field (lose focus)",
+      "params": null,
+      "returns": null
     }
   }
 }

package/src/components/file/QFile.js

@@ -2,15 +2,15 @@ import { h, ref, computed, getCurrentInstance } from 'vue'
 
 import QChip from '../chip/QChip.js'
 
-import useField, { useFieldState, useFieldProps, useFieldEmits, fieldValueIsFilled } from '../../composables/private/use-field.js'
-import { useFormProps, useFormInputNameAttr } from '../../composables/private/use-form.js'
-import useFile, { useFileProps, useFileEmits } from '../../composables/private/use-file.js'
-import useFileFormDomProps from '../../composables/private/use-file-dom-props.js'
-
-import { createComponent } from '../../utils/private/create.js'
-import { humanStorageSize } from '../../utils/format.js'
-import { prevent } from '../../utils/event.js'
-import { injectProp } from '../../utils/private/inject-obj-prop.js'
+import useField, { useFieldState, useFieldProps, useFieldEmits, fieldValueIsFilled } from '../../composables/private.use-field/use-field.js'
+import { useFormProps, useFormInputNameAttr } from '../../composables/use-form/private.use-form.js'
+import useFile, { useFileProps, useFileEmits } from '../../composables/private.use-file/use-file.js'
+import useFileFormDomProps from '../../composables/private.use-file/use-file-dom-props.js'
+
+import { createComponent } from '../../utils/private.create/create.js'
+import { humanStorageSize } from '../../utils/format/format.js'
+import { prevent } from '../../utils/event/event.js'
+import { injectProp } from '../../utils/private.inject-obj-prop/inject-obj-prop.js'
 
 export default createComponent({
   name: 'QFile',

package/src/components/file/QFile.json

@@ -1,5 +1,5 @@
 {
-  "mixins": [ "composables/private/use-field", "composables/private/use-file", "composables/private/use-form" ],
+  "mixins": [ "composables/private.use-field/use-field", "composables/private.use-file/use-file", "composables/use-form/private.use-form" ],
 
   "meta": {
     "docsUrl": "https://v2.quasar.dev/vue-components/file"
@@ -10,7 +10,7 @@
       "extends": "model-value",
       "type": [ "File", "FileList", "Array", "null", "undefined" ],
       "desc": "Model of the component; Must be FileList or Array if using 'multiple' prop; Either use this property (along with a listener for 'update:modelValue' event) OR use v-model directive",
-      "examples": [ "v-model=\"myModel\"" ]
+      "examples": [ "# v-model=\"myModel\"" ]
     },
 
     "append": {
@@ -22,7 +22,7 @@
     "display-value": {
       "type": [ "Number", "String" ],
       "desc": "Override default selection string, if not using 'file' or 'selected' scoped slots and if not using 'use-chips' prop",
-      "examples": [ "Options: x, y, z" ],
+      "examples": [ "'Options: x, y, z'" ],
       "category": "selection"
     },
 
@@ -44,7 +44,7 @@
               "type": "String",
               "required": true,
               "desc": "The total size of files in human readable format",
-              "examples": [ "1.42MB" ]
+              "examples": [ "'1.42MB'" ]
             },
             "filesNumber": {
               "type": "Number",
@@ -63,9 +63,7 @@
         "type": "String",
         "desc": "String to display for the counter label"
       },
-      "examples": [
-        ":counter-label=\"counterLabelFn\""
-      ],
+      "examples": [ "(totalSize, filesNumber, maxFiles) => `${ filesNumber }${ maxFiles !== void 0 ? ' / ' + maxFiles : '' } (${ totalSize })`" ],
       "category": "behavior"
     },
 
@@ -78,8 +76,8 @@
       "tsType": "VueClassProp",
       "desc": "Class definitions to be attributed to the underlying selection container",
       "examples": [
-        "my-special-class",
-        ":input-class=\"{ 'my-special-class': <condition> }\""
+        "'my-special-class'",
+        "{ 'my-special-class': true }"
       ],
       "category": "style"
     },
@@ -89,10 +87,14 @@
       "tsType": "VueStyleProp",
       "desc": "Style definitions to be attributed to the underlying selection container",
       "examples": [
-        "background-color: #ff0000",
-        ":input-style=\"{ backgroundColor: '#ff0000' }\""
+        "'background-color: #ff0000'",
+        "{ backgroundColor: '#ff0000' }"
       ],
       "category": "style"
+    },
+
+    "name": {
+      "desc": "Used to specify the name of the control; Useful if dealing with forms; If not specified, it takes the value of 'for' prop, if it exists"
     }
   },
 
@@ -122,7 +124,7 @@
       "desc": "Override default selection slot; Suggestion: QChip",
       "scope": {
         "files": {
-          "type": [ "FileList", "Array" ],
+          "type": [ "Array", "FileList" ],
           "desc": "Array of File objects"
         },
 
@@ -150,7 +152,8 @@
           "desc": "Index at which to remove selection",
           "required": true
         }
-      }
+      },
+      "returns": null
     },
 
     "removeFile": {
@@ -161,11 +164,13 @@
           "desc": "File to remove (instance of File)",
           "required": true
         }
-      }
+      },
+      "returns": null
     },
 
     "getNativeElement": {
       "desc": "DEPRECATED; Access 'nativeEl' directly; Gets the native input DOM Element",
+      "params": null,
       "returns": {
         "type": "Element",
         "tsType": "QFileNativeElement",

package/src/components/footer/QFooter.js

@@ -1,12 +1,12 @@
 import { h, ref, computed, watch, onBeforeUnmount, inject, getCurrentInstance } from 'vue'
 
-import { isRuntimeSsrPreHydration } from '../../plugins/Platform.js'
+import { isRuntimeSsrPreHydration } from '../../plugins/platform/Platform.js'
 
 import QResizeObserver from '../resize-observer/QResizeObserver.js'
 
-import { createComponent } from '../../utils/private/create.js'
-import { hMergeSlot } from '../../utils/private/render.js'
-import { layoutKey, emptyRenderFn } from '../../utils/private/symbols.js'
+import { createComponent } from '../../utils/private.create/create.js'
+import { hMergeSlot } from '../../utils/private.render/render.js'
+import { layoutKey, emptyRenderFn } from '../../utils/private.symbols/symbols.js'
 
 export default createComponent({
   name: 'QFooter',

package/src/components/footer/QFooter.json

@@ -8,11 +8,9 @@
       "extends": "model-value",
       "type": "Boolean",
       "desc": "Model of the component defining if it is shown or hidden to the user; Either use this property (along with a listener for 'update:modelValue' event) OR use v-model directive",
-      "default": true,
+      "default": "true",
       "required": false,
-      "examples": [
-        "v-model=\"footerState\""
-      ]
+      "examples": [ "# v-model=\"footerState\"" ]
     },
 
     "reveal": {
@@ -34,7 +32,7 @@
     "height-hint": {
       "type": [ "Number", "String" ],
       "desc": "When using SSR, you can optionally hint of the height (in pixels) of the QFooter",
-      "default": 50,
+      "default": "50",
       "category": "behavior"
     }
   },

package/src/components/form/QForm.js

@@ -1,11 +1,11 @@
 import { h, ref, onActivated, onDeactivated, onMounted, getCurrentInstance, nextTick, provide } from 'vue'
 
-import { createComponent } from '../../utils/private/create.js'
-import { stopAndPrevent } from '../../utils/event.js'
-import { addFocusFn } from '../../utils/private/focus-manager.js'
-import { hSlot } from '../../utils/private/render.js'
-import { formKey } from '../../utils/private/symbols.js'
-import { vmIsDestroyed } from '../../utils/private/vm.js'
+import { createComponent } from '../../utils/private.create/create.js'
+import { stopAndPrevent } from '../../utils/event/event.js'
+import { addFocusFn } from '../../utils/private.focus/focus-manager.js'
+import { hSlot } from '../../utils/private.render/render.js'
+import { formKey } from '../../utils/private.symbols/symbols.js'
+import { vmIsDestroyed } from '../../utils/private.vm/vm.js'
 
 export default createComponent({
   name: 'QForm',

package/src/components/form/QForm.json

@@ -67,7 +67,9 @@
 
   "methods": {
     "focus": {
-      "desc": "Focus on first focusable element/component in the form"
+      "desc": "Focus on first focusable element/component in the form",
+      "params": null,
+      "returns": null
     },
 
     "validate": {
@@ -81,14 +83,14 @@
       "returns": {
         "type": "Promise<boolean>",
         "desc": "Promise is always fulfilled and receives the outcome (true -> validation was a success, false -> invalid models detected)",
-        "examples": [
-          "validate().then(outcome => { ... })"
-        ]
+        "examples": [ "validate().then(outcome => { ... })" ]
       }
     },
 
     "resetValidation": {
-      "desc": "Resets the validation on all applicable inner Quasar components"
+      "desc": "Resets the validation on all applicable inner Quasar components",
+      "params": null,
+      "returns": null
     },
 
     "submit": {
@@ -97,7 +99,8 @@
         "evt": {
           "extends": "evt"
         }
-      }
+      },
+      "returns": null
     },
 
     "reset": {
@@ -106,11 +109,13 @@
         "evt": {
           "extends": "evt"
         }
-      }
+      },
+      "returns": null
     },
 
     "getValidationComponents": {
       "desc": "Get an array of children Vue component instances that support Quasar validation API (derived from QField, or using useFormChild()/QFormChildMixin)",
+      "params": null,
       "returns": {
         "type": "Array",
         "tsType": "QFormChildComponent",

package/src/components/form/QFormChildMixin.js

@@ -1,5 +1,5 @@
-import { noop } from '../../utils/event.js'
-import { formKey } from '../../utils/private/symbols.js'
+import { noop } from '../../utils/event/event.js'
+import { formKey } from '../../utils/private.symbols/symbols.js'
 
 export default {
   inject: {

package/src/components/form/QFormChildMixin.json

@@ -6,17 +6,18 @@
   "methods": {
     "validate": {
       "desc": "Needs to be overwritten when getting extended/mixed in",
+      "params": null,
       "returns": {
         "type": [ "Boolean", "Promise<boolean>" ],
         "desc": "Promise is always fulfilled and receives the outcome (true -> validation was a success, false -> invalid models detected)",
-        "examples": [
-          "validate().then(outcome => { ... })"
-        ]
+        "examples": [ "validate().then(outcome => { ... })" ]
       }
     },
 
     "resetValidation": {
-      "desc": "Needs to be overwritten when getting extended/mixed in"
+      "desc": "Needs to be overwritten when getting extended/mixed in",
+      "params": null,
+      "returns": null
     }
   }
 }

package/src/components/header/QHeader.js

@@ -2,9 +2,9 @@ import { h, ref, computed, watch, onBeforeUnmount, inject, getCurrentInstance }
 
 import QResizeObserver from '../resize-observer/QResizeObserver.js'
 
-import { createComponent } from '../../utils/private/create.js'
-import { hUniqueSlot } from '../../utils/private/render.js'
-import { layoutKey, emptyRenderFn } from '../../utils/private/symbols.js'
+import { createComponent } from '../../utils/private.create/create.js'
+import { hUniqueSlot } from '../../utils/private.render/render.js'
+import { layoutKey, emptyRenderFn } from '../../utils/private.symbols/symbols.js'
 
 export default createComponent({
   name: 'QHeader',

package/src/components/header/QHeader.json

@@ -8,11 +8,9 @@
       "extends": "model-value",
       "type": "Boolean",
       "desc": "Model of the component defining if it is shown or hidden to the user; Either use this property (along with a listener for 'update:modelValue' event) OR use v-model directive",
-      "default": true,
+      "default": "true",
       "required": false,
-      "examples": [
-        "v-model=\"headerState\""
-      ]
+      "examples": [ "# v-model=\"headerState\"" ]
     },
 
     "reveal": {
@@ -24,7 +22,7 @@
     "reveal-offset": {
       "type": "Number",
       "desc": "Amount of scroll (in pixels) that should trigger a 'reveal' state change",
-      "default": 250,
+      "default": "250",
       "category": "behavior"
     },
 
@@ -41,7 +39,7 @@
     "height-hint": {
       "type": [ "Number", "String" ],
       "desc": "When using SSR, you can optionally hint of the height (in pixels) of the QHeader",
-      "default": 50,
+      "default": "50",
       "category": "behavior"
     }
   },

package/src/components/icon/QIcon.js

@@ -1,9 +1,9 @@
 import { h, computed, getCurrentInstance } from 'vue'
 
-import useSize, { useSizeProps } from '../../composables/private/use-size.js'
+import useSize, { useSizeProps } from '../../composables/private.use-size/use-size.js'
 
-import { createComponent } from '../../utils/private/create.js'
-import { hSlot, hMergeSlot } from '../../utils/private/render.js'
+import { createComponent } from '../../utils/private.create/create.js'
+import { hSlot, hMergeSlot } from '../../utils/private.render/render.js'
 
 const defaultViewBox = '0 0 24 24'
 

package/src/components/icon/QIcon.json

@@ -1,5 +1,5 @@
 {
-  "mixins": [ "composables/private/use-size" ],
+  "mixins": [ "composables/private.use-size/use-size" ],
 
   "meta": {
     "docsUrl": "https://v2.quasar.dev/vue-components/icon"
@@ -9,8 +9,8 @@
     "tag": {
       "extends": "tag",
       "desc": "HTML tag to render, unless no icon is supplied or it's an svg icon",
-      "default": "i",
-      "examples": [ "div", "i" ]
+      "default": "'i'",
+      "examples": [ "'div'", "'i'" ]
     },
 
     "name": {

package/src/components/img/QImg.js

@@ -2,13 +2,13 @@ import { h, ref, computed, watch, onMounted, Transition, getCurrentInstance } fr
 
 import QSpinner from '../spinner/QSpinner.js'
 
-import { isRuntimeSsrPreHydration } from '../../plugins/Platform.js'
-import useRatio, { useRatioProps } from '../../composables/private/use-ratio.js'
+import { isRuntimeSsrPreHydration } from '../../plugins/platform/Platform.js'
+import useRatio, { useRatioProps } from '../../composables/private.use-ratio/use-ratio.js'
 
-import { createComponent } from '../../utils/private/create.js'
-import { hSlot } from '../../utils/private/render.js'
-import { vmIsDestroyed } from '../../utils/private/vm.js'
-import useTimeout from '../../composables/use-timeout.js'
+import { createComponent } from '../../utils/private.create/create.js'
+import { hSlot } from '../../utils/private.render/render.js'
+import { vmIsDestroyed } from '../../utils/private.vm/vm.js'
+import useTimeout from '../../composables/use-timeout/use-timeout.js'
 
 const defaultRatio = 1.7778 /* 16/9 */