quasar 2.15.1 → 2.15.3

package/src/components/page-scroller/QPageScroller.json

@@ -9,7 +9,7 @@
     "scroll-offset": {
       "type": "Number",
       "desc": "Scroll offset (in pixels) from which point the component is shown on page; Measured from the top of the page (or from the bottom if in 'reverse' mode)",
-      "default": 1000,
+      "default": "1000",
       "category": "behavior"
     },
 
@@ -22,12 +22,12 @@
     "duration": {
       "type": "Number",
       "desc": "Duration (in milliseconds) of the scrolling until it reaches its target",
-      "default": 300,
+      "default": "300",
       "category": "behavior"
     },
 
     "offset": {
-      "default": [ 18, 18 ],
+      "default": "[ 18, 18 ]",
       "category": "content"
     }
   }

package/src/components/page-sticky/QPageSticky.js

@@ -1,4 +1,4 @@
-import { createComponent } from '../../utils/private/create.js'
+import { createComponent } from '../../utils/private.create/create.js'
 import usePageSticky, { usePageStickyProps } from './use-page-sticky'
 
 export default createComponent({

package/src/components/page-sticky/QPageSticky.json

@@ -7,11 +7,11 @@
     "position": {
       "type": "String",
       "desc": "Page side/corner to stick to",
-      "default": "bottom-right",
+      "default": "'bottom-right'",
       "values": [
-        "top-right", "top-left",
-        "bottom-right", "bottom-left",
-        "top", "right", "bottom", "left"
+        "'top-right'", "'top-left'",
+        "'bottom-right'", "'bottom-left'",
+        "'top'", "'right'", "'bottom'", "'left'"
       ],
       "category": "position"
     },
@@ -19,7 +19,7 @@
     "offset": {
       "type": "Array",
       "desc": "An array of two numbers to offset the component horizontally and vertically in pixels",
-      "examples": [ "[8, 8]", "[5, 10]" ],
+      "examples": [ "[ 8, 8 ]", "[ 5, 10 ]" ],
       "category": "position"
     },
 

package/src/components/page-sticky/use-page-sticky.js

@@ -1,7 +1,7 @@
 import { h, computed, inject, getCurrentInstance } from 'vue'
 
-import { hSlot } from '../../utils/private/render.js'
-import { layoutKey, emptyRenderFn } from '../../utils/private/symbols.js'
+import { hSlot } from '../../utils/private.render/render.js'
+import { layoutKey, emptyRenderFn } from '../../utils/private.symbols/symbols.js'
 
 export const usePageStickyProps = {
   position: {

package/src/components/pagination/QPagination.js

@@ -3,12 +3,12 @@ import { h, ref, watch, computed, getCurrentInstance } from 'vue'
 import QBtn from '../btn/QBtn.js'
 import QInput from '../input/QInput.js'
 
-import useDark, { useDarkProps } from '../../composables/private/use-dark.js'
+import useDark, { useDarkProps } from '../../composables/private.use-dark/use-dark.js'
 import { btnDesignOptions, btnPadding, getBtnDesign } from '../btn/use-btn.js'
 
-import { createComponent } from '../../utils/private/create.js'
-import { between } from '../../utils/format.js'
-import { isKeyCode } from '../../utils/private/key-composition.js'
+import { createComponent } from '../../utils/private.create/create.js'
+import { between } from '../../utils/format/format.js'
+import { isKeyCode } from '../../utils/private.keyboard/key-composition.js'
 
 function getBool (val, otherwise) {
   return [ true, false ].includes(val)

package/src/components/pagination/QPagination.json

@@ -13,7 +13,7 @@
     "min": {
       "type": [ "Number", "String" ],
       "desc": "Minimum page (must be lower than 'max')",
-      "default": 1,
+      "default": "1",
       "category": "model"
     },
 
@@ -32,7 +32,7 @@
     "size": {
       "type": "String",
       "desc": "Button size in CSS units, including unit name",
-      "examples": [ "20px" ],
+      "examples": [ "'20px'" ],
       "category": "style"
     },
 
@@ -75,41 +75,41 @@
         "type": [ "Object", "String" ],
         "desc": "Object or String that can be passed to a <router-link> as 'to' parameter"
       },
-      "examples": [ ":to-fn=\"page => ({ query: { page } })\"" ],
+      "examples": [ "page => ({ query: { page } })" ],
       "category": "content"
     },
 
     "boundary-links": {
       "type": [ "Boolean", "null" ],
-      "default": null,
+      "default": "null",
       "desc": "Show boundary button links",
       "category": "content"
     },
 
     "boundary-numbers": {
       "type": [ "Boolean", "null" ],
-      "default": null,
+      "default": "null",
       "desc": "Always show first and last page buttons (if not using 'input')",
       "category": "content"
     },
 
     "direction-links": {
       "type": [ "Boolean", "null" ],
-      "default": null,
+      "default": "null",
       "desc": "Show direction buttons",
       "category": "content"
     },
 
     "ellipses": {
       "type": [ "Boolean", "null" ],
-      "default": null,
+      "default": "null",
       "desc": "Show ellipses (...) when pages are available",
       "category": "content"
     },
 
     "max-pages": {
       "type": [ "Number", "String" ],
-      "default": 0,
+      "default": "0",
       "desc": "Maximum number of page links to display at a time; 0 means Infinite",
       "category": "content"
     },
@@ -141,7 +141,7 @@
     "color": {
       "extends": "color",
       "desc": "Color name from the Quasar Color Palette for the non-active buttons",
-      "default": "primary"
+      "default": "'primary'"
     },
 
     "text-color": {
@@ -152,7 +152,7 @@
     "active-design": {
       "type": "String",
       "desc": "The design of the ACTIVE button, similar to the flat/outline/push/unelevated props (but those are used for non-active buttons)",
-      "values": [ "flat", "outline", "push", "unelevated" ],
+      "values": [ "'flat'", "'outline'", "'push'", "'unelevated'" ],
       "category": "style",
       "addedIn": "v2.10"
     },
@@ -160,7 +160,7 @@
     "active-color": {
       "extends": "color",
       "desc": "Color name from the Quasar Color Palette for the ACTIVE button",
-      "default": "primary"
+      "default": "'primary'"
     },
 
     "active-text-color": {
@@ -189,8 +189,8 @@
     "gutter": {
       "type": "String",
       "desc": "Apply custom gutter; Size in CSS units, including unit name or standard size name (none|xs|sm|md|lg|xl)",
-      "default": "2px",
-      "examples": [ "16px", "10px 5px", "2rem", "xs", "md lg", "2px 2px 5px 7px" ],
+      "default": "'2px'",
+      "examples": [ "'16px'", "'10px 5px'", "'2rem'", "'xs'", "'md lg'", "'2px 2px 5px 7px'" ],
       "category": "style",
       "addedIn": "v2.10"
     },
@@ -198,7 +198,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", "2px 2px 5px 7px" ],
+      "examples": [ "'16px'", "'10px 5px'", "'2rem'", "'xs'", "'md lg'", "'2px 2px 5px 7px'" ],
       "category": "style"
     },
 
@@ -207,8 +207,8 @@
       "tsType": "VueStyleProp",
       "desc": "Style definitions to be attributed to the input (if using one)",
       "examples": [
-        "background-color: #ff0000",
-        ":input-style=\"{ backgroundColor: '#ff0000' }\""
+        "'background-color: #ff0000'",
+        "{ backgroundColor: '#ff0000' }"
       ],
       "category": "style"
     },
@@ -218,8 +218,8 @@
       "tsType": "VueClassProp",
       "desc": "Class definitions to be attributed to the input (if using one)",
       "examples": [
-        "my-special-class",
-        ":input-class=\"{ 'my-special-class': <condition> }\""
+        "'my-special-class'",
+        "{ 'my-special-class': true }"
       ],
       "category": "style"
     },
@@ -227,8 +227,8 @@
     "ripple": {
       "type": [ "Boolean", "Object", "null" ],
       "desc": "Configure buttons material ripple (disable it by setting it to 'false' or supply a config object); Does not applies to boundary and ellipsis buttons",
-      "default": true,
-      "examples": [ false, "{ early: true, center: true, color: 'teal', keyCodes: [] }" ],
+      "default": "true",
+      "examples": [ "false", "{ early: true, center: true, color: 'teal', keyCodes: [] }" ],
       "category": "style"
     }
   },
@@ -252,7 +252,8 @@
           "type": "Number",
           "desc": "Page number to go to"
         }
-      }
+      },
+      "returns": null
     },
 
     "setByOffset": {
@@ -262,7 +263,8 @@
           "type": "Number",
           "desc": "Offset page, can be negative or positive"
         }
-      }
+      },
+      "returns": null
     }
   }
 }

package/src/components/parallax/QParallax.js

@@ -1,11 +1,11 @@
 import { h, ref, watch, onMounted, onBeforeUnmount } from 'vue'
 
-import { createComponent } from '../../utils/private/create.js'
-import { height, offset } from '../../utils/dom.js'
-import frameDebounce from '../../utils/frame-debounce.js'
-import { getScrollTarget } from '../../utils/scroll.js'
-import { hSlot } from '../../utils/private/render.js'
-import { listenOpts } from '../../utils/event.js'
+import { createComponent } from '../../utils/private.create/create.js'
+import { height, offset } from '../../utils/dom/dom.js'
+import frameDebounce from '../../utils/frame-debounce/frame-debounce.js'
+import { getScrollTarget } from '../../utils/scroll/scroll.js'
+import { hSlot } from '../../utils/private.render/render.js'
+import { listenOpts } from '../../utils/event/event.js'
 
 const { passive } = listenOpts
 

package/src/components/parallax/QParallax.json

@@ -9,10 +9,10 @@
       "desc": "Path to image (unless a 'media' slot is used)",
       "transformAssetUrls": true,
       "examples": [
-        "(public folder) src=\"img/something.png\"",
-        "(assets folder) src=\"~assets/my-img.png\"",
-        "(relative path format) :src=\"require('./my_img.jpg')\"",
-        "(URL) src=\"https://some-site.net/some-img.jpg\""
+        "# (public folder) src=\"img/something.png\"",
+        "# (assets folder) src=\"~assets/my-img.png\"",
+        "# (relative path format) :src=\"require('./my_img.jpg')\"",
+        "# (URL) src=\"https://some-site.net/some-img.jpg\""
       ],
       "category": "model"
     },
@@ -20,7 +20,7 @@
     "height": {
       "type": "Number",
       "desc": "Height of component (in pixels)",
-      "default": 500,
+      "default": "500",
       "category": "style"
     },
 

package/src/components/popup-edit/QPopupEdit.js

@@ -3,10 +3,10 @@ import { h, ref, computed, nextTick, getCurrentInstance } from 'vue'
 import QMenu from '../menu/QMenu.js'
 import QBtn from '../btn/QBtn.js'
 
-import { createComponent } from '../../utils/private/create.js'
-import clone from '../../utils/clone.js'
-import { isDeepEqual } from '../../utils/is.js'
-import { injectProp } from '../../utils/private/inject-obj-prop.js'
+import { createComponent } from '../../utils/private.create/create.js'
+import clone from '../../utils/clone/clone.js'
+import { isDeepEqual } from '../../utils/is/is.js'
+import { injectProp } from '../../utils/private.inject-obj-prop/inject-obj-prop.js'
 
 export default createComponent({
   name: 'QPopupEdit',

package/src/components/popup-edit/QPopupEdit.json

@@ -7,13 +7,13 @@
     "model-value": {
       "extends": "model-value",
       "type": "Any",
-      "examples": [ "v-model=\"myValue\"" ]
+      "examples": [ "# v-model=\"myValue\"" ]
     },
 
     "title": {
       "type": "String",
       "desc": "Optional title (unless 'title' slot is used)",
-      "examples": [ "Calories" ],
+      "examples": [ "'Calories'" ],
       "category": "content"
     },
 
@@ -26,14 +26,14 @@
     "label-set": {
       "type": "String",
       "desc": "Override Set button label",
-      "examples": [ "OK" ],
+      "examples": [ "'OK'" ],
       "category": "content"
     },
 
     "label-cancel": {
       "type": "String",
       "desc": "Override Cancel button label",
-      "examples": [ "Cancel" ],
+      "examples": [ "'Cancel'" ],
       "category": "content"
     },
 
@@ -45,7 +45,7 @@
 
     "color": {
       "extends": "color",
-      "default": "primary"
+      "default": "'primary'"
     },
 
     "validate": {
@@ -55,16 +55,14 @@
         "value": {
           "type": "Any",
           "desc": "Model to validate",
-          "examples": [ "My car" ]
+          "examples": [ "'My car'" ]
         }
       },
       "returns": {
         "type": "Boolean",
         "desc": "Is the model valid or not?"
       },
-      "examples": [
-        ":validate=\"myValidation\""
-      ],
+      "examples": [ "# :validate=\"myValidation\"" ],
       "category": "model"
     },
 
@@ -75,12 +73,13 @@
     "fit": {
       "type": "Boolean",
       "desc": "Allows the menu to match at least the full width of its target",
-      "category": "position"
+      "category": "position",
+      "passthrough": true
     },
 
     "cover": {
       "type": "Boolean",
-      "default": true,
+      "default": "true",
       "desc": "Allows the menu to cover its target. When used, the 'self' and 'fit' props are no longer effective",
       "category": "position"
     },
@@ -89,65 +88,74 @@
       "type": "String",
       "desc": "Two values setting the starting position or anchor point of the menu 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'"
       ],
-      "category": "position"
+      "category": "position",
+      "passthrough": true
     },
 
     "self": {
       "type": "String",
       "desc": "Two values setting the menu'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'"
       ],
-      "category": "position"
+      "category": "position",
+      "passthrough": true
     },
 
     "offset": {
       "type": "Array",
       "desc": "An array of two numbers to offset the menu horizontally and vertically in pixels",
-      "examples": [ "[8, 8]", "[5, 10]" ],
-      "category": "style"
+      "examples": [ "[ 8, 8 ]", "[ 5, 10 ]" ],
+      "category": "style",
+      "passthrough": true
     },
 
     "touch-position": {
       "type": "Boolean",
       "desc": "Allows for the target position to be set by the mouse position, when the target of the menu is either clicked or touched",
-      "category": "behavior"
+      "category": "behavior",
+      "passthrough": true
     },
 
     "persistent": {
       "type": "Boolean",
       "desc": "Avoid menu closing by hitting ESC key or by clicking/tapping outside of the Popup",
-      "category": "behavior"
+      "category": "behavior",
+      "passthrough": true
     },
 
     "separate-close-popup": {
       "type": "Boolean",
       "desc": "Separate from parent menu, marking it as a separate closing point for v-close-popup (without this, chained menus close all together)",
-      "category": "behavior"
+      "category": "behavior",
+      "passthrough": true
     },
 
     "square": {
       "type": "Boolean",
       "desc": "Forces menu to have squared borders",
-      "category": "style"
+      "category": "style",
+      "passthrough": true
     },
 
     "max-height": {
       "extends": "size",
       "desc": "The maximum height of the menu; Size in CSS units, including unit name",
-      "category": "style"
+      "category": "style",
+      "passthrough": true
     },
 
     "max-width": {
       "extends": "size",
       "desc": "The maximum width of the menu; Size in CSS units, including unit name",
-      "category": "style"
+      "category": "style",
+      "passthrough": true
     }
   },
 
@@ -158,12 +166,12 @@
         "initialValue": {
           "type": "Any",
           "desc": "Initial value",
-          "examples": [ 0.241, "Text" ]
+          "examples": [ "0.241", "'Text'" ]
         },
         "value": {
           "type": "Any",
           "desc": "Current value",
-          "examples": [ 0.241, "Text" ]
+          "examples": [ "0.241", "'Text'" ]
         },
         "validate": {
           "type": "Function",
@@ -173,7 +181,7 @@
               "type": "Any",
               "required": true,
               "desc": "Value to be checked",
-              "examples": [ 0, "Changed text" ]
+              "examples": [ "0", "'Changed text'" ]
             }
           },
           "returns": {
@@ -256,11 +264,15 @@
 
   "methods": {
     "set": {
-      "desc": "Trigger a model update; Validates model (and emits 'save' event if it's the case) then closes Popup"
+      "desc": "Trigger a model update; Validates model (and emits 'save' event if it's the case) then closes Popup",
+      "params": null,
+      "returns": null
     },
 
     "cancel": {
-      "desc": "Triggers a model reset to its initial value ('cancel' event is emitted) then closes Popup"
+      "desc": "Triggers a model reset to its initial value ('cancel' event is emitted) then closes Popup",
+      "params": null,
+      "returns": null
     },
 
     "show": {
@@ -272,7 +284,9 @@
     },
 
     "updatePosition": {
-      "desc": "There are some custom scenarios for which Quasar cannot automatically reposition the component 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 component 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/popup-proxy/QPopupProxy.js

@@ -3,10 +3,10 @@ import { h, ref, computed, watch, getCurrentInstance } from 'vue'
 import QDialog from '../dialog/QDialog.js'
 import QMenu from '../menu/QMenu.js'
 
-import useAnchor, { useAnchorProps } from '../../composables/private/use-anchor.js'
+import useAnchor, { useAnchorProps } from '../../composables/private.use-anchor/use-anchor.js'
 
-import { createComponent } from '../../utils/private/create.js'
-import { injectProp } from '../../utils/private/inject-obj-prop.js'
+import { createComponent } from '../../utils/private.create/create.js'
+import { injectProp } from '../../utils/private.inject-obj-prop/inject-obj-prop.js'
 
 export default createComponent({
   name: 'QPopupProxy',

package/src/components/popup-proxy/QPopupProxy.json

@@ -1,5 +1,5 @@
 {
-  "mixins": [ "composables/private/use-anchor" ],
+  "mixins": [ "composables/private.use-anchor/use-anchor" ],
 
   "meta": {
     "docsUrl": "https://v2.quasar.dev/vue-components/popup-proxy"
@@ -10,13 +10,14 @@
       "extends": "model-value",
       "type": "Boolean",
       "desc": "Defines the state of the component (shown/hidden); Either use this property (along with a listener for 'update:modelValue' event) OR use v-model directive",
-      "required": false
+      "required": false,
+      "passthrough": true
     },
 
     "breakpoint": {
       "type": [ "Number", "String" ],
       "desc": "Breakpoint (in pixels) of window width/height (whichever is smaller) from where a Menu will get to be used instead of a Dialog",
-      "default": 450,
+      "default": "450",
       "category": "behavior"
     }
   },
@@ -29,11 +30,13 @@
 
   "events": {
     "update:model-value": {
-      "extends": "update:model-value"
+      "extends": "update:model-value",
+      "passthrough": true
     },
 
     "before-show": {
-      "extends": "before-show"
+      "extends": "before-show",
+      "passthrough": true
     },
 
     "show": {
@@ -41,7 +44,8 @@
     },
 
     "before-hide": {
-      "extends": "before-hide"
+      "extends": "before-hide",
+      "passthrough": true
     },
 
     "hide": {
@@ -71,7 +75,7 @@
         "type": {
           "type": "String",
           "desc": "Component type",
-          "values": [ "dialog", "menu" ]
+          "values": [ "'dialog'", "'menu'" ]
         },
         "ref": {
           "type": "Component",

package/src/components/pull-to-refresh/QPullToRefresh.js

@@ -2,13 +2,13 @@ import { h, ref, computed, watch, onMounted, onBeforeUnmount, getCurrentInstance
 
 import QIcon from '../icon/QIcon.js'
 import QSpinner from '../spinner/QSpinner.js'
-import TouchPan from '../../directives/TouchPan.js'
+import TouchPan from '../../directives/touch-pan/TouchPan.js'
 
-import { createComponent } from '../../utils/private/create.js'
-import { getScrollTarget, getVerticalScrollPosition } from '../../utils/scroll.js'
-import { between } from '../../utils/format.js'
-import { prevent } from '../../utils/event.js'
-import { hSlot, hDir } from '../../utils/private/render.js'
+import { createComponent } from '../../utils/private.create/create.js'
+import { getScrollTarget, getVerticalScrollPosition } from '../../utils/scroll/scroll.js'
+import { between } from '../../utils/format/format.js'
+import { prevent } from '../../utils/event/event.js'
+import { hSlot, hDir } from '../../utils/private.render/render.js'
 
 const
   PULLER_HEIGHT = 40,

package/src/components/pull-to-refresh/QPullToRefresh.json

@@ -56,11 +56,15 @@
 
   "methods": {
     "trigger": {
-      "desc": "Triggers a refresh"
+      "desc": "Triggers a refresh",
+      "params": null,
+      "returns": null
     },
 
     "updateScrollTarget": {
-      "desc": "Updates the scroll target; Useful when the parent elements change so that the scrolling target also changes"
+      "desc": "Updates the scroll target; Useful when the parent elements change so that the scrolling target also changes",
+      "params": null,
+      "returns": null
     }
   }
 }