quasar 2.15.2 → 2.15.3

package/src/plugins/lang/Lang.test.js

@@ -0,0 +1,267 @@
+import { describe, test, expect } from 'vitest'
+import { mount } from '@vue/test-utils'
+
+import Lang from './Lang.js'
+
+const mountPlugin = () => mount({ template: '<div />' })
+
+describe('[Lang API]', () => {
+  describe('[Injection]', () => {
+    test('is injected into $q', () => {
+      const wrapper = mountPlugin()
+
+      expect(wrapper.vm.$q.lang).toBeDefined()
+      expect(wrapper.vm.$q.lang.name).toBe(Lang.props.name)
+      expect(wrapper.vm.$q.lang.set).toBe(Lang.set)
+    })
+  })
+
+  describe('[Props]', () => {
+    describe('[(prop)props]', () => {
+      test('is correct type', () => {
+        mountPlugin()
+
+        expect(Lang.props).toStrictEqual({
+          isoName: expect.any(String),
+          nativeName: expect.any(String),
+          rtl: expect.any(Boolean),
+          label: {
+            clear: expect.any(String),
+            ok: expect.any(String),
+            cancel: expect.any(String),
+            close: expect.any(String),
+            set: expect.any(String),
+            select: expect.any(String),
+            reset: expect.any(String),
+            remove: expect.any(String),
+            update: expect.any(String),
+            create: expect.any(String),
+            search: expect.any(String),
+            filter: expect.any(String),
+            refresh: expect.any(String),
+            expand: expect.any(Function),
+            collapse: expect.any(Function)
+          },
+          date: {
+            days: expect.any(Array),
+            daysShort: expect.any(Array),
+            months: expect.any(Array),
+            monthsShort: expect.any(Array),
+            firstDayOfWeek: expect.any(Number),
+            format24h: expect.any(Boolean),
+            pluralDay: expect.any(String)
+          },
+          table: {
+            noData: expect.any(String),
+            noResults: expect.any(String),
+            loading: expect.any(String),
+            selectedRecords: expect.any(Function),
+            recordsPerPage: expect.any(String),
+            allRows: expect.any(String),
+            pagination: expect.any(Function),
+            columns: expect.any(String)
+          },
+          editor: {
+            url: expect.any(String),
+            bold: expect.any(String),
+            italic: expect.any(String),
+            strikethrough: expect.any(String),
+            underline: expect.any(String),
+            unorderedList: expect.any(String),
+            orderedList: expect.any(String),
+            subscript: expect.any(String),
+            superscript: expect.any(String),
+            hyperlink: expect.any(String),
+            toggleFullscreen: expect.any(String),
+            quote: expect.any(String),
+            left: expect.any(String),
+            center: expect.any(String),
+            right: expect.any(String),
+            justify: expect.any(String),
+            print: expect.any(String),
+            outdent: expect.any(String),
+            indent: expect.any(String),
+            removeFormat: expect.any(String),
+            formatting: expect.any(String),
+            fontSize: expect.any(String),
+            align: expect.any(String),
+            hr: expect.any(String),
+            undo: expect.any(String),
+            redo: expect.any(String),
+            heading1: expect.any(String),
+            heading2: expect.any(String),
+            heading3: expect.any(String),
+            heading4: expect.any(String),
+            heading5: expect.any(String),
+            heading6: expect.any(String),
+            paragraph: expect.any(String),
+            code: expect.any(String),
+            size1: expect.any(String),
+            size2: expect.any(String),
+            size3: expect.any(String),
+            size4: expect.any(String),
+            size5: expect.any(String),
+            size6: expect.any(String),
+            size7: expect.any(String),
+            defaultFont: expect.any(String),
+            viewSource: expect.any(String)
+          },
+          tree: {
+            noNodes: expect.any(String),
+            noResults: expect.any(String)
+          }
+        })
+      })
+
+      test('can be set', () => {
+        const { vm: { $q } } = mountPlugin()
+
+        Lang.props.nativeName = 'new-lang'
+        expect(Lang.props.nativeName).toBe('new-lang')
+        expect($q.lang.nativeName).toBe('new-lang')
+
+        $q.lang.nativeName = 'another-lang'
+        expect(Lang.props.nativeName).toBe('another-lang')
+        expect($q.lang.nativeName).toBe('another-lang')
+      })
+    })
+  })
+
+  describe('[Methods]', () => {
+    describe('[(method)set]', () => {
+      test('should be callable', () => {
+        const wrapper = mountPlugin()
+
+        expect(
+          Lang.set({
+            isoName: 'en-US',
+            nativeName: 'New Language',
+            rtl: true,
+            label: {
+              clear: 'Clear',
+              ok: 'OK',
+              cancel: 'Cancel',
+              close: 'Close',
+              set: 'Set',
+              select: 'Select',
+              reset: 'Reset',
+              remove: 'Remove',
+              update: 'Update',
+              create: 'Create',
+              search: 'Search',
+              filter: 'Filter',
+              refresh: 'Refresh',
+              expand: label => (label ? `Expand '${ label }'` : 'Expand'),
+              collapse: label => (label ? `Collapse '${ label }'` : 'Collapse')
+            },
+            date: {
+              days: [ 'Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday' ],
+              daysShort: [ 'Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat' ],
+              months: [ 'January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December' ],
+              monthsShort: [ 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec' ],
+              firstDayOfWeek: 0,
+              format24h: true,
+              pluralDay: 'days'
+            },
+            table: {
+              noData: 'No data available',
+              noResults: 'No matching records found',
+              loading: 'Loading...',
+              selectedRecords: rows => `${ rows } records selected`,
+              recordsPerPage: 'Records per page:',
+              allRows: 'All',
+              pagination: (start, end, total) => start + '-' + end + ' of ' + total,
+              columns: 'Columns'
+            },
+            editor: {
+              url: 'URL',
+              bold: 'Bold',
+              italic: 'Italic',
+              strikethrough: 'Strikethrough',
+              underline: 'Underline',
+              unorderedList: 'Unordered List',
+              orderedList: 'Ordered List',
+              subscript: 'Subscript',
+              superscript: 'Superscript',
+              hyperlink: 'Hyperlink',
+              toggleFullscreen: 'Toggle Fullscreen',
+              quote: 'Quote',
+              left: 'Left align',
+              center: 'Center align',
+              right: 'Right align',
+              justify: 'Justify align',
+              print: 'Print',
+              outdent: 'Decrease indentation',
+              indent: 'Increase indentation',
+              removeFormat: 'Remove formatting',
+              formatting: 'Formatting',
+              fontSize: 'Font Size',
+              align: 'Align',
+              hr: 'Insert Horizontal Rule',
+              undo: 'Undo',
+              redo: 'Redo',
+              heading1: 'Heading 1',
+              heading2: 'Heading 2',
+              heading3: 'Heading 3',
+              heading4: 'Heading 4',
+              heading5: 'Heading 5',
+              heading6: 'Heading 6',
+              paragraph: 'Paragraph',
+              code: 'Code',
+              size1: 'Very small',
+              size2: 'A bit small',
+              size3: 'Normal',
+              size4: 'Medium-large',
+              size5: 'Big',
+              size6: 'Very big',
+              size7: 'Maximum',
+              defaultFont: 'Default Font',
+              viewSource: 'View Source'
+            },
+            tree: {
+              noNodes: 'No nodes available',
+              noResults: 'No matching nodes found'
+            }
+          })
+        ).toBeUndefined()
+
+        expect(Lang.props.nativeName).toBe('New Language')
+        expect(wrapper.vm.$q.lang.nativeName).toBe('New Language')
+      })
+
+      test('should work with an imported lang pack', async () => {
+        const { vm: { $q } } = mountPlugin()
+        const { default: deLang } = await import('quasar/lang/de-DE.mjs')
+
+        Lang.set(deLang)
+        expect(Lang.props.nativeName).toBe(deLang.nativeName)
+        expect($q.lang.nativeName).toBe(deLang.nativeName)
+
+        const { default: itLang } = await import('quasar/lang/it.mjs')
+        $q.lang.set(itLang)
+        expect(Lang.props.nativeName).toBe(itLang.nativeName)
+        expect($q.lang.nativeName).toBe(itLang.nativeName)
+      })
+    })
+
+    describe('[(method)getLocale]', () => {
+      test('should be callable', () => {
+        const wrapper = mountPlugin()
+
+        expect(
+          Lang.getLocale()
+        ).$any([
+          expect.any(String),
+          undefined
+        ])
+
+        expect(
+          wrapper.vm.$q.lang.getLocale()
+        ).$any([
+          expect.any(String),
+          undefined
+        ])
+      })
+    })
+  })
+})

package/src/plugins/loading/Loading.js

@@ -4,10 +4,10 @@ import QSpinner from '../../components/spinner/QSpinner.js'
 
 import { createChildApp } from '../../install-quasar.js'
 
-import defineReactivePlugin from '../../utils/private/define-reactive-plugin.js'
-import { createGlobalNode, removeGlobalNode } from '../../utils/private/global-nodes.js'
-import preventScroll from '../../utils/prevent-scroll.js'
-import { isObject } from '../../utils/is.js'
+import { createReactivePlugin } from '../../utils/private.create/create.js'
+import { createGlobalNode, removeGlobalNode } from '../../utils/private.global/global-nodes.js'
+import preventScroll from '../../utils/scroll/prevent-scroll.js'
+import { isObject } from '../../utils/is/is.js'
 
 let
   app,
@@ -46,7 +46,7 @@ function registerProps (opts) {
   return newProps
 }
 
-const Plugin = defineReactivePlugin({
+const Plugin = createReactivePlugin({
   isActive: false
 }, {
   show (opts) {

package/src/plugins/loading/Loading.json

@@ -166,7 +166,8 @@
           "examples": [ "'some-api-call'" ],
           "addedIn": "v2.8"
         }
-      }
+      },
+      "returns": null
     },
 
     "setDefaults": {
@@ -220,7 +221,8 @@
             }
           }
         }
-      }
+      },
+      "returns": null
     }
   }
 }

package/src/plugins/loading-bar/LoadingBar.js

@@ -3,14 +3,14 @@ import { h, ref } from 'vue'
 import QAjaxBar from '../../components/ajax-bar/QAjaxBar.js'
 import { createChildApp } from '../../install-quasar.js'
 
-import defineReactivePlugin from '../../utils/private/define-reactive-plugin.js'
-import { noop } from '../../utils/event.js'
-import { createGlobalNode } from '../../utils/private/global-nodes.js'
-import { isObject } from '../../utils/is.js'
+import { createReactivePlugin } from '../../utils/private.create/create.js'
+import { noop } from '../../utils/event/event.js'
+import { createGlobalNode } from '../../utils/private.global/global-nodes.js'
+import { isObject } from '../../utils/is/is.js'
 
 const barRef = ref(null)
 
-const Plugin = defineReactivePlugin({
+const Plugin = createReactivePlugin({
   isActive: false
 }, {
   start: noop,

package/src/plugins/loading-bar/LoadingBar.json

@@ -30,11 +30,14 @@
           "desc": "Delay (in milliseconds) between bar progress increments",
           "default": "300"
         }
-      }
+      },
+      "returns": null
     },
 
     "stop": {
-      "desc": "Notify bar one background activity has finalized"
+      "desc": "Notify bar one background activity has finalized",
+      "params": null,
+      "returns": null
     },
 
     "increment": {
@@ -44,7 +47,8 @@
           "type": "Number",
           "desc": "Amount (0.0 < x < 1.0) to increment with"
         }
-      }
+      },
+      "returns": null
     },
 
     "setDefaults": {
@@ -57,7 +61,8 @@
           "desc": "QAjaxBar component props",
           "examples": [ "{ position: 'bottom', reverse: true }" ]
         }
-      }
+      },
+      "returns": null
     }
   }
 }

package/src/plugins/meta/Meta.js

@@ -1,5 +1,5 @@
 import { isRuntimeSsrPreHydration } from '../platform/Platform.js'
-import extend from '../../utils/extend.js'
+import extend from '../../utils/extend/extend.js'
 
 let updateId = null, currentClientMeta
 export const clientList = []

package/src/plugins/notify/Notify.js

@@ -7,10 +7,10 @@ import QSpinner from '../../components/spinner/QSpinner.js'
 
 import { createChildApp } from '../../install-quasar.js'
 
-import { createComponent } from '../../utils/private/create.js'
-import { noop } from '../../utils/event.js'
-import { createGlobalNode } from '../../utils/private/global-nodes.js'
-import { isObject } from '../../utils/is.js'
+import { createComponent } from '../../utils/private.create/create.js'
+import { noop } from '../../utils/event/event.js'
+import { createGlobalNode } from '../../utils/private.global/global-nodes.js'
+import { isObject } from '../../utils/is/is.js'
 
 let uid = 0
 

package/src/plugins/notify/Notify.json

@@ -131,7 +131,7 @@
         "desc": "Class definitions to be attributed to the badge",
         "examples": [
           "'my-special-class'",
-          "{ 'my-special-class': <condition> }"
+          "{ 'my-special-class': true }"
         ]
       },
 
@@ -145,7 +145,7 @@
         "desc": "Class definitions to be attributed to the progress bar",
         "examples": [
           "'my-special-class'",
-          "{ 'my-special-class': <condition> }"
+          "{ 'my-special-class': true }"
         ]
       },
 
@@ -349,7 +349,7 @@
               "desc": "Class definitions to be attributed to the badge",
               "examples": [
                 "'my-special-class'",
-                "{ 'my-special-class': <condition> }"
+                "{ 'my-special-class': true }"
               ]
             },
 
@@ -363,7 +363,7 @@
               "desc": "Class definitions to be attributed to the progress bar",
               "examples": [
                 "'my-special-class'",
-                "{ 'my-special-class': <condition> }"
+                "{ 'my-special-class': true }"
               ]
             },
 
@@ -464,7 +464,8 @@
           "desc": "Notification options except 'ignoreDefaults' (See 'opts' param of 'create()' for object properties)",
           "__exemption": [ "definition" ]
         }
-      }
+      },
+      "returns": null
     },
 
     "registerType": {
@@ -484,7 +485,8 @@
           "desc": "Notification options except 'ignoreDefaults' (See 'opts' param of 'create()' for object properties)",
           "__exemption": [ "definition" ]
         }
-      }
+      },
+      "returns": null
     }
   }
 }

package/src/plugins/platform/Platform.js

@@ -1,7 +1,7 @@
 /* eslint-disable no-useless-escape */
 
 import { ref, reactive } from 'vue'
-import { injectProp } from '../../utils/private/inject-obj-prop.js'
+import { injectProp } from '../../utils/private.inject-obj-prop/inject-obj-prop.js'
 
 /**
  * __ QUASAR_SSR __            -> runs on SSR on client or server
@@ -35,8 +35,7 @@ function getMatch (userAgent, platformMatch) {
 
   return {
     browser: match[ 5 ] || match[ 3 ] || match[ 1 ] || '',
-    version: match[ 2 ] || match[ 4 ] || '0',
-    versionNumber: match[ 4 ] || match[ 2 ] || '0',
+    version: match[ 4 ] || match[ 2 ] || '0',
     platform: platformMatch[ 0 ] || ''
   }
 }
@@ -75,7 +74,7 @@ function getPlatform (UA) {
   if (matched.browser) {
     browser[ matched.browser ] = true
     browser.version = matched.version
-    browser.versionNumber = parseInt(matched.versionNumber, 10)
+    browser.versionNumber = parseInt(matched.version, 10)
   }
 
   if (matched.platform) {

package/src/plugins/platform/Platform.json

@@ -80,6 +80,12 @@
           "desc": "Type of the native mobile wrapper"
         },
 
+        "webkit": {
+          "type": "Boolean",
+          "required": false,
+          "desc": "Whether the browser is a Webkit one"
+        },
+
         "chrome": {
           "type": "Boolean",
           "required": false,

package/src/plugins/platform/Platform.test.js

@@ -0,0 +1,104 @@
+/**
+ * Ignored specs:
+ * [(method)parseSSR]
+ */
+
+import { describe, test, expect } from 'vitest'
+import { mount } from '@vue/test-utils'
+
+import Platform from './Platform.js'
+
+const mountPlugin = () => mount({ template: '<div />' })
+
+describe('[Platform API]', () => {
+  describe('[Injection]', () => {
+    test('is injected into $q', () => {
+      const wrapper = mountPlugin()
+      expect(Platform).toBe(wrapper.vm.$q.platform)
+    })
+  })
+
+  describe('[Props]', () => {
+    describe('[(prop)userAgent]', () => {
+      test('is correct type', () => {
+        mountPlugin()
+        expect(Platform.userAgent).toBeTypeOf('string')
+      })
+    })
+
+    describe('[(prop)is]', () => {
+      test('is correct type', () => {
+        mountPlugin()
+
+        const expected = {
+          name: expect.any(String),
+          platform: expect.any(String),
+          version: expect.any(String),
+          versionNumber: expect.any(Number),
+          desktop: expect.any(Boolean),
+          mobile: expect.any(Boolean),
+          electron: expect.any(Boolean),
+          bex: expect.any(Boolean),
+          capacitor: expect.any(Boolean),
+          cordova: expect.any(Boolean),
+          nativeMobile: expect.any(Boolean),
+          nativeMobileWrapper: expect.$any([
+            'cordova',
+            'capacitor'
+          ]),
+          webkit: expect.any(Boolean),
+          chrome: expect.any(Boolean),
+          firefox: expect.any(Boolean),
+          safari: expect.any(Boolean),
+          edgeChromium: expect.any(Boolean),
+          edge: expect.any(Boolean),
+          opera: expect.any(Boolean),
+          vivaldi: expect.any(Boolean),
+          win: expect.any(Boolean),
+          linux: expect.any(Boolean),
+          mac: expect.any(Boolean),
+          cros: expect.any(Boolean),
+          android: expect.any(Boolean),
+          ios: expect.any(Boolean),
+          winphone: expect.any(Boolean),
+          iphone: expect.any(Boolean),
+          ipad: expect.any(Boolean),
+          ipod: expect.any(Boolean),
+          kindle: expect.any(Boolean),
+          silk: expect.any(Boolean)
+        }
+
+        const actualKeys = Object.keys(Platform.is)
+
+        expect(actualKeys).not.toHaveLength(0)
+
+        expect(actualKeys).toSatisfy(
+          keys => keys.every(key => expected[ key ] !== void 0)
+        )
+
+        actualKeys.forEach(key => {
+          expect(Platform.is[ key ]).toStrictEqual(expected[ key ])
+        })
+      })
+    })
+
+    describe('[(prop)has]', () => {
+      test('is correct type', () => {
+        mountPlugin()
+        expect(Platform.has).toStrictEqual({
+          touch: expect.any(Boolean),
+          webStorage: expect.any(Boolean)
+        })
+      })
+    })
+
+    describe('[(prop)within]', () => {
+      test('is correct type', () => {
+        mountPlugin()
+        expect(Platform.within).toStrictEqual({
+          iframe: expect.any(Boolean)
+        })
+      })
+    })
+  })
+})

package/src/{body.js → plugins/private.body/Body.js}

@@ -1,7 +1,8 @@
-import setCssVar from './utils/set-css-var.js'
-import { noop } from './utils/event.js'
-import { onKeyDownComposition } from './utils/private/key-composition.js'
-import { isRuntimeSsrPreHydration, client } from './plugins/platform/Platform.js'
+import setCssVar from '../../utils/css-var/set-css-var.js'
+import { noop } from '../../utils/event/event.js'
+import { onKeyDownComposition } from '../../utils/private.keyboard/key-composition.js'
+
+import { isRuntimeSsrPreHydration, client } from '../platform/Platform.js'
 
 function getMobilePlatform (is) {
   if (is.ios === true) return 'ios'

package/src/{history.js → plugins/private.history/History.js}

@@ -1,5 +1,5 @@
-import { client } from './plugins/platform/Platform.js'
-import { noop } from './utils/event.js'
+import { client } from '../platform/Platform.js'
+import { noop } from '../../utils/event/event.js'
 
 const getTrue = () => true
 

package/src/plugins/screen/Screen.js

@@ -1,13 +1,13 @@
 import { isRuntimeSsrPreHydration, client } from '../platform/Platform.js'
 
-import defineReactivePlugin from '../../utils/private/define-reactive-plugin.js'
-import { listenOpts, noop } from '../../utils/event.js'
-import debounce from '../../utils/debounce.js'
+import { createReactivePlugin } from '../../utils/private.create/create.js'
+import { listenOpts, noop } from '../../utils/event/event.js'
+import debounce from '../../utils/debounce/debounce.js'
 
 const SIZE_LIST = [ 'sm', 'md', 'lg', 'xl' ]
 const { passive } = listenOpts
 
-export default defineReactivePlugin({
+export default createReactivePlugin({
   width: 0,
   height: 0,
   name: 'xs',

package/src/plugins/screen/Screen.json

@@ -171,7 +171,8 @@
           },
           "required": true
         }
-      }
+      },
+      "returns": null
     },
 
     "setDebounce": {
@@ -182,7 +183,8 @@
           "desc": "Amount in milliseconds",
           "required": true
         }
-      }
+      },
+      "returns": null
     }
   }
 }

package/src/plugins/{local-storage → storage}/LocalStorage.js

@@ -1,5 +1,5 @@
 import { client } from '../platform/Platform.js'
-import { getEmptyStorage, getStorage } from '../../utils/private/web-storage.js'
+import { getEmptyStorage, getStorage } from './engine/web-storage.js'
 
 const storage = __QUASAR_SSR_SERVER__ || client.has.webStorage === false
   ? getEmptyStorage()

package/src/plugins/storage/LocalStorage.json

@@ -0,0 +1,5 @@
+{
+  "mixins": [ "plugins/storage/engine/web-storage" ],
+
+  "injection": "$q.localStorage"
+}