quasar 2.15.1 → 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.js → loading/Loading.js}

@@ -1,12 +1,13 @@
 import { h, Transition, onMounted } from 'vue'
 
-import QSpinner from '../components/spinner/QSpinner.js'
+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 { createChildApp } from '../../install-quasar.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,
@@ -45,7 +46,7 @@ function registerProps (opts) {
   return newProps
 }
 
-const Plugin = defineReactivePlugin({
+const Plugin = createReactivePlugin({
   isActive: false
 }, {
   show (opts) {

package/src/plugins/{Loading.json → loading/Loading.json}

@@ -12,18 +12,18 @@
       "delay": {
         "type": "Number",
         "desc": "Wait a number of millisecond before showing; Not worth showing for 100ms for example then hiding it, so wait until you're sure it's a process that will take some considerable amount of time",
-        "examples": [ 400 ]
+        "examples": [ "400" ]
       },
       "message": {
         "type": "String",
         "desc": "Message to display",
-        "examples": [ "Processing your request" ]
+        "examples": [ "'Processing your request'" ]
       },
       "group": {
         "type": "String",
         "desc": "Default Loading group name",
-        "default": "__default_quasar_group__",
-        "examples": [ "default-group-name" ],
+        "default": "'__default_quasar_group__'",
+        "examples": [ "'default-group-name'" ],
         "addedIn": "v2.8"
       },
       "html": {
@@ -33,7 +33,7 @@
       "boxClass": {
         "type": "String",
         "desc": "Content wrapped element custom classes",
-        "examples": [ "bg-amber text-black", "q-pa-xl" ]
+        "examples": [ "'bg-amber text-black'", "'q-pa-xl'" ]
       },
       "spinnerSize": {
         "type": "Number",
@@ -60,7 +60,7 @@
       "customClass": {
         "type": "String",
         "desc": "Add a CSS class to the container element to easily customize the component",
-        "examples": [ "my-class" ]
+        "examples": [ "'my-class'" ]
       }
     }
   },
@@ -90,12 +90,12 @@
             "message": {
               "type": "String",
               "desc": "Message to display",
-              "examples": [ "Processing your request" ]
+              "examples": [ "'Processing your request'" ]
             },
             "group": {
               "type": "String",
               "desc": "Loading group name",
-              "examples": [ "some-api-call" ],
+              "examples": [ "'some-api-call'" ],
               "addedIn": "v2.8"
             },
             "html": {
@@ -105,7 +105,7 @@
             "boxClass": {
               "type": "String",
               "desc": "Content wrapped element custom classes",
-              "examples": [ "bg-amber text-black", "q-pa-xl" ]
+              "examples": [ "'bg-amber text-black'", "'q-pa-xl'" ]
             },
             "spinnerSize": {
               "type": "Number",
@@ -130,7 +130,7 @@
             "customClass": {
               "type": "String",
               "desc": "Add a CSS class to easily customize the component",
-              "examples": [ "my-class" ]
+              "examples": [ "'my-class'" ]
             },
             "ignoreDefaults": {
               "type": "Boolean",
@@ -163,10 +163,11 @@
           "type": "String",
           "desc": "Optional Loading group name to hide instead of hiding all groups",
           "required": false,
-          "examples": [ "some-api-call" ],
+          "examples": [ "'some-api-call'" ],
           "addedIn": "v2.8"
         }
-      }
+      },
+      "returns": null
     },
 
     "setDefaults": {
@@ -184,13 +185,13 @@
             "message": {
               "type": "String",
               "desc": "Message to display",
-              "examples": [ "Processing your request" ]
+              "examples": [ "'Processing your request'" ]
             },
             "group": {
               "type": "String",
               "desc": "Default Loading group name",
-              "default": "__default_quasar_group__",
-              "examples": [ "default-group-name" ],
+              "default": "'__default_quasar_group__'",
+              "examples": [ "'default-group-name'" ],
               "addedIn": "v2.8"
             },
             "spinnerSize": {
@@ -216,11 +217,12 @@
             "customClass": {
               "type": "String",
               "desc": "Add a CSS class to easily customize the component",
-              "examples": [ "my-class" ]
+              "examples": [ "'my-class'" ]
             }
           }
         }
-      }
+      },
+      "returns": null
     }
   }
 }

package/src/plugins/{LoadingBar.js → loading-bar/LoadingBar.js}

@@ -1,16 +1,16 @@
 import { h, ref } from 'vue'
 
-import defineReactivePlugin from '../utils/private/define-reactive-plugin.js'
-import { noop } from '../utils/event.js'
-import { createGlobalNode } from '../utils/private/global-nodes.js'
-import { createChildApp } from '../install-quasar.js'
+import QAjaxBar from '../../components/ajax-bar/QAjaxBar.js'
+import { createChildApp } from '../../install-quasar.js'
 
-import QAjaxBar from '../components/ajax-bar/QAjaxBar.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/{LoadingBar.json → loading-bar/LoadingBar.json}

@@ -28,13 +28,16 @@
         "speed": {
           "type": "Number",
           "desc": "Delay (in milliseconds) between bar progress increments",
-          "default": 300
+          "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.js → meta/Meta.js}

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

package/src/plugins/{Notify.js → notify/Notify.js}

@@ -1,15 +1,16 @@
 import { h, ref, markRaw, TransitionGroup } from 'vue'
 
-import QAvatar from '../components/avatar/QAvatar.js'
-import QIcon from '../components/icon/QIcon.js'
-import QBtn from '../components/btn/QBtn.js'
-import QSpinner from '../components/spinner/QSpinner.js'
-
-import { createComponent } from '../utils/private/create.js'
-import { noop } from '../utils/event.js'
-import { createGlobalNode } from '../utils/private/global-nodes.js'
-import { createChildApp } from '../install-quasar.js'
-import { isObject } from '../utils/is.js'
+import QAvatar from '../../components/avatar/QAvatar.js'
+import QIcon from '../../components/icon/QIcon.js'
+import QBtn from '../../components/btn/QBtn.js'
+import QSpinner from '../../components/spinner/QSpinner.js'
+
+import { createChildApp } from '../../install-quasar.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