Merge remote-tracking branch 'origin/dev' into dev

app-vite/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quasar/app-vite",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "Quasar Framework App CLI with Vite",
   "bin": {
     "quasar": "./bin/quasar"
@@ -61,7 +61,7 @@
     "cross-spawn": "^7.0.3",
     "dot-prop": "6.0.1",
     "elementtree": "0.1.7",
-    "esbuild": "0.14.47",
+    "esbuild": "0.14.51",
     "express": "^4.17.3",
     "fast-glob": "3.2.11",
     "fs-extra": "^10.0.1",

app-webpack/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quasar/app-webpack",
-  "version": "3.5.7",
+  "version": "3.5.9",
   "description": "Quasar Framework App CLI with Webpack",
   "bin": {
     "quasar": "./bin/quasar"

create-quasar/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-quasar",
-  "version": "1.0.29",
+  "version": "1.0.30",
   "description": "Scaffolds Quasar Apps, AppExtensions or UI kits",
   "author": {
     "name": "Razvan Stoenescu",

docs/src/pages/app-extensions/development-guide/introduction.md

@@ -9,7 +9,27 @@ It is assumed you have already installed one of the official App Extensions. Hav
 
 ## Getting started
 
-An App Extension is an npm package. There are two official kits for creating App Extensions. The official `App Extension` starter kit should be used to create App Extensions that do not provide a UI, like a component or directive, unless the objective is to install a 3rd-party library into Vue. The second official kit is the `UI` kit. This has a `ui` folder for creating your component/directive, a `ui/dev` Quasar application for testing your component/directive in isolation, and an `app-extension` folder for creating the App Extension that will be used for injecting your component/directive via the Quasar CLI into a Quasar app. The UI kit can also be used such that your component/directive can also be used with the Quasar Vite plugin or Vue CLI or UMD.
+An App Extension is an npm package. There are two official kits for creating App Extensions:
+
+1. App Extension (AE) kit
+2. UI kit
+
+### App Extension (AE) kit
+
+If your app extension does _not_ involve UI (i.e. does _not_ have components or directives) then use the AE kit. An example of this would be an extension that creates a boot file only. 
+
+### UI kit
+
+If your app extension does involve UI (i.e. does have components or directives) then use the UI kit. An example of this would be an extension that provides a UI element for use in your app. This has a `ui` folder for creating your component/directive, a `ui/dev` Quasar application for testing your component/directive in isolation, and an `app-extension` folder for creating the App Extension that will be used for injecting your component/directive via the Quasar CLI into a Quasar app. The UI kit can also be used such that your component/directive can also be used with the Quasar Vite plugin or Vue CLI or UMD.
+
+### 3rd party integration
+
+If your objective is to install a 3rd-party library into Vue, then it depends upon the library...
+
+- If you also aim to provide some UI components or such that uses that Vue plugin, you should use the _UI Kit_. This would be a good choice for including something like a Calendar extension.
+- If the only objective is to load it through a simple `app.use(SomeVuePlugin)` in a boot file, and maybe some config updates and such, the _AE Kit_ may be a better choice. This is a good choice for example for something like including Axios.
+
+### Creating the App Extension
 
 ```bash
 $ yarn create quasar

docs/src/pages/quasar-utils/date-utils.md

@@ -332,7 +332,7 @@ To mutate the original date object by setting it to the start of a unit of time
 ```js
 import { date } from 'quasar'
 
-let newDate = new Date(2000)
+let newDate = new Date('2000')
 // set to beginning of year 2000 (January 1st, 2000, 00:00:00.000)
 newDate = date.startOfDate(newDate, 'year')
 // set to end of year 2000 (December 31st, 2000, 23:59:59.999)

ui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quasar",
-  "version": "2.7.5",
+  "version": "2.7.6",
   "description": "Build high-performance VueJS user interfaces (SPA, PWA, SSR, Mobile and Desktop) in record time",
   "main": "dist/quasar.cjs.prod.js",
   "module": "dist/quasar.esm.prod.js",