quasar 2.1.0

package/src/utils/private/render.js

@@ -0,0 +1,63 @@
+import { h, withDirectives } from 'vue'
+
+export function hSlot (slot, otherwise) {
+  return slot !== void 0
+    ? slot() || otherwise
+    : otherwise
+}
+
+export function hUniqueSlot (slot, otherwise) {
+  if (slot !== void 0) {
+    const vnode = slot()
+    if (vnode !== void 0 && vnode !== null) {
+      return vnode.slice()
+    }
+  }
+
+  return otherwise
+}
+
+/**
+ * Source definitely exists,
+ * so it's merged with the possible slot
+ */
+export function hMergeSlot (slot, source) {
+  return slot !== void 0
+    ? source.concat(slot())
+    : source
+}
+
+/**
+ * Merge with possible slot,
+ * even if source might not exist
+ */
+export function hMergeSlotSafely (slot, source) {
+  if (slot === void 0) {
+    return source
+  }
+
+  return source !== void 0
+    ? source.concat(slot())
+    : slot()
+}
+
+/*
+ * (String)  key       - unique vnode key
+ * (Boolean) condition - should change ONLY when adding/removing directive
+ */
+export function hDir (
+  tag,
+  data,
+  children,
+  key,
+  condition,
+  getDirsFn
+) {
+  data.key = key + condition
+
+  const vnode = h(tag, data, children)
+
+  return condition === true
+    ? withDirectives(vnode, getDirsFn())
+    : vnode
+}

package/src/utils/private/selection.js

@@ -0,0 +1,17 @@
+import Platform from '../../plugins/Platform.js'
+
+export function clearSelection () {
+  if (window.getSelection !== void 0) {
+    const selection = window.getSelection()
+    if (selection.empty !== void 0) {
+      selection.empty()
+    }
+    else if (selection.removeAllRanges !== void 0) {
+      selection.removeAllRanges()
+      Platform.is.mobile !== true && selection.addRange(document.createRange())
+    }
+  }
+  else if (document.selection !== void 0) {
+    document.selection.empty()
+  }
+}

package/src/utils/private/sort.js

@@ -0,0 +1,20 @@
+export function sortString (a, b) {
+  if (typeof a !== 'string') {
+    throw new TypeError('The value for sorting must be a String')
+  }
+  return a.localeCompare(b)
+}
+
+export function sortNumber (a, b) {
+  return a - b
+}
+
+export function sortDate (a, b) {
+  return (new Date(a)) - (new Date(b))
+}
+
+export function sortBoolean (a, b) {
+  return a && !b
+    ? -1
+    : (!a && b ? 1 : 0)
+}

package/src/utils/private/symbols.js

@@ -0,0 +1,9 @@
+export const quasarKey = '_q_'
+export const timelineKey = '_q_t_'
+export const stepperKey = '_q_s_'
+export const layoutKey = '_q_l_'
+export const pageContainerKey = '_q_pc_'
+export const fabKey = '_q_f_'
+export const formKey = '_q_fo_'
+export const tabsKey = '_q_tabs_'
+export const uploaderKey = '_q_u_'

package/src/utils/private/touch.js

@@ -0,0 +1,55 @@
+const modifiersAll = {
+  left: true,
+  right: true,
+  up: true,
+  down: true,
+  horizontal: true,
+  vertical: true
+}
+
+const directionList = Object.keys(modifiersAll)
+
+modifiersAll.all = true
+
+export function getModifierDirections (mod) {
+  const dir = {}
+
+  for (const direction of directionList) {
+    if (mod[ direction ] === true) {
+      dir[ direction ] = true
+    }
+  }
+
+  if (Object.keys(dir).length === 0) {
+    return modifiersAll
+  }
+
+  if (dir.horizontal === true) {
+    dir.left = dir.right = true
+  }
+  else if (dir.left === true && dir.right === true) {
+    dir.horizontal = true
+  }
+
+  if (dir.vertical === true) {
+    dir.up = dir.down = true
+  }
+  else if (dir.up === true && dir.down === true) {
+    dir.vertical = true
+  }
+
+  if (dir.horizontal === true && dir.vertical === true) {
+    dir.all = true
+  }
+
+  return dir
+}
+
+export function shouldStart (evt, ctx) {
+  return ctx.event === void 0
+    && evt.target !== void 0
+    && evt.target.draggable !== true
+    && typeof ctx.handler === 'function'
+    && evt.target.nodeName.toUpperCase() !== 'INPUT'
+    && (evt.qClonedBy === void 0 || evt.qClonedBy.indexOf(ctx.uid) === -1)
+}

package/src/utils/private/vm.js

@@ -0,0 +1,38 @@
+// used directly by docs too
+export function getParentVm (vm) {
+  if (vm.$parent !== void 0 && vm.$parent !== null) {
+    return vm.$parent
+  }
+
+  vm = vm.$.parent
+
+  while (vm !== void 0 && vm !== null) {
+    if (vm.proxy !== void 0 && vm.proxy !== null) {
+      return vm.proxy
+    }
+
+    vm = vm.parent
+  }
+}
+
+// vnodes from rendered in advanced slots
+export function getNormalizedVNodes (vnodes) {
+  const children = new Set()
+
+  vnodes.forEach(vnode => {
+    if (typeof vnode.type === 'symbol' && Array.isArray(vnode.children) === true) {
+      vnode.children.forEach(child => {
+        children.add(child)
+      })
+    }
+    else {
+      children.add(vnode)
+    }
+  })
+
+  return Array.from(children)
+}
+
+export function vmHasRouter (vm) {
+  return vm.appContext.config.globalProperties.$router !== void 0
+}

package/src/utils/private/web-storage.js

@@ -0,0 +1,135 @@
+import { noop } from '../event.js'
+
+function encode (value) {
+  if (Object.prototype.toString.call(value) === '[object Date]') {
+    return '__q_date|' + value.toUTCString()
+  }
+  if (Object.prototype.toString.call(value) === '[object RegExp]') {
+    return '__q_expr|' + value.source
+  }
+  if (typeof value === 'number') {
+    return '__q_numb|' + value
+  }
+  if (typeof value === 'boolean') {
+    return '__q_bool|' + (value ? '1' : '0')
+  }
+  if (typeof value === 'string') {
+    return '__q_strn|' + value
+  }
+  if (typeof value === 'function') {
+    return '__q_strn|' + value.toString()
+  }
+  if (value === Object(value)) {
+    return '__q_objt|' + JSON.stringify(value)
+  }
+
+  // hmm, we don't know what to do with it,
+  // so just return it as is
+  return value
+}
+
+function decode (value) {
+  const length = value.length
+  if (length < 9) {
+    // then it wasn't encoded by us
+    return value
+  }
+
+  const type = value.substr(0, 8)
+  const source = value.substring(9)
+
+  switch (type) {
+    case '__q_date':
+      return new Date(source)
+
+    case '__q_expr':
+      return new RegExp(source)
+
+    case '__q_numb':
+      return Number(source)
+
+    case '__q_bool':
+      return Boolean(source === '1')
+
+    case '__q_strn':
+      return '' + source
+
+    case '__q_objt':
+      return JSON.parse(source)
+
+    default:
+      // hmm, we reached here, we don't know the type,
+      // then it means it wasn't encoded by us, so just
+      // return whatever value it is
+      return value
+  }
+}
+
+export function getEmptyStorage () {
+  const getVal = () => null
+
+  return {
+    has: () => false,
+    getLength: () => 0,
+    getItem: getVal,
+    getIndex: getVal,
+    getKey: getVal,
+    getAll: () => {},
+    getAllKeys: () => [],
+    set: noop,
+    remove: noop,
+    clear: noop,
+    isEmpty: () => true
+  }
+}
+
+export function getStorage (type) {
+  const
+    webStorage = window[ type + 'Storage' ],
+    get = key => {
+      const item = webStorage.getItem(key)
+      return item
+        ? decode(item)
+        : null
+    }
+
+  return {
+    has: key => webStorage.getItem(key) !== null,
+    getLength: () => webStorage.length,
+    getItem: get,
+    getIndex: index => {
+      return index < webStorage.length
+        ? get(webStorage.key(index))
+        : null
+    },
+    getKey: index => {
+      return index < webStorage.length
+        ? webStorage.key(index)
+        : null
+    },
+    getAll: () => {
+      let key
+      const result = {}, len = webStorage.length
+
+      for (let i = 0; i < len; i++) {
+        key = webStorage.key(i)
+        result[ key ] = get(key)
+      }
+
+      return result
+    },
+    getAllKeys: () => {
+      const result = [], len = webStorage.length
+
+      for (let i = 0; i < len; i++) {
+        result.push(webStorage.key(i))
+      }
+
+      return result
+    },
+    set: (key, value) => { webStorage.setItem(key, encode(value)) },
+    remove: key => { webStorage.removeItem(key) },
+    clear: () => { webStorage.clear() },
+    isEmpty: () => webStorage.length === 0
+  }
+}

package/src/utils/private/web-storage.json

@@ -0,0 +1,150 @@
+{
+  "meta": {
+    "docsUrl": "https://v2.quasar.dev/quasar-plugins/web-storage"
+  },
+
+  "methods": {
+    "has": {
+      "desc": "Check if storage item exists",
+      "params": {
+        "key": {
+          "type": "String",
+          "desc": "Entry key",
+          "required": true,
+          "examples": [ "userId" ]
+        }
+      },
+      "returns": {
+        "type": "Boolean",
+        "desc": "Does the item exists or not?"
+      }
+    },
+
+    "getLength": {
+      "desc": "Get storage number of entries",
+      "returns": {
+        "type": "Number",
+        "desc": "Number of entries",
+        "examples": [ 21 ]
+      }
+    },
+
+    "getItem": {
+      "tsType": "WebStorageGetItemMethodType",
+      "desc": "Get a storage item value",
+      "params": {
+        "key": {
+          "type": "String",
+          "desc": "Entry key",
+          "required": true,
+          "examples": [ "userId" ]
+        }
+      },
+      "returns": {
+        "type": [ "Date", "RegExp", "Number", "Boolean", "Function", "Object", "Array", "String", "null" ],
+        "desc": "Storage item value",
+        "examples": [ "john12", 702 ]
+      }
+    },
+
+    "getIndex": {
+      "tsType": "WebStorageGetIndexMethodType",
+      "desc": "Get the storage item value at specific index",
+      "params": {
+        "index": {
+          "type": "Number",
+          "desc": "Entry index",
+          "required": true,
+          "examples": [ 5 ]
+        }
+      },
+      "returns": {
+        "type": [ "Number", "null" ],
+        "desc": "Storage item index",
+        "examples": [ 7 ]
+      }
+    },
+
+    "getKey": {
+      "tsType": "WebStorageGetKeyMethodType",
+      "desc": "Get the storage key at specific index",
+      "params": {
+        "index": {
+          "type": "Number",
+          "desc": "Entry index",
+          "required": true,
+          "examples": [ 5 ]
+        }
+      },
+      "returns": {
+        "type": [ "String", "null" ],
+        "desc": "Storage key",
+        "examples": [ "userId" ]
+      }
+    },
+
+    "getAll": {
+      "desc": "Retrieve all items in storage",
+      "returns": {
+        "type": "Object",
+        "desc": "Object syntax: item name as Object key and its value",
+        "examples": [
+          "{ userId: 'jon12', timesLoggedIn: 14 }"
+        ]
+      }
+    },
+
+    "getAllKeys": {
+      "tsType": "WebStorageGetAllKeysMethodType",
+      "desc": "Retrieve all keys in storage",
+      "returns": {
+        "type": "Array",
+        "desc": "Storage keys (Array of Strings)",
+        "examples": [ "['userId', 'password']" ]
+      }
+    },
+
+    "set": {
+      "desc": "Set item in storage",
+      "params": {
+        "key": {
+          "type": "String",
+          "desc": "Entry key",
+          "required": true,
+          "examples": [ "userId" ]
+        },
+
+        "value": {
+          "type": [ "Date", "RegExp", "Number", "Boolean", "Function", "Object", "Array", "String", "null" ],
+          "desc": "Entry value",
+          "required": true,
+          "examples": [ "john12" ]
+        }
+      }
+    },
+
+    "remove": {
+      "desc": "Remove a storage item",
+      "params": {
+        "key": {
+          "type": "String",
+          "desc": "Storage key",
+          "required": true,
+          "examples": [ "userId" ]
+        }
+      }
+    },
+
+    "clear": {
+      "desc": "Remove everything from the storage"
+    },
+
+    "isEmpty": {
+      "desc": "Determine if storage has any items",
+      "returns": {
+        "type": "Boolean",
+        "desc": "Tells if storage is empty or not"
+      }
+    }
+  }
+}