@bildvitta/quasar-ui-asteroid 3.1.0 → 3.2.0-beta.0

package/src/components/tree-generator/QasTreeGenerator.yml

@@ -0,0 +1,81 @@
+type: component
+
+meta:
+  desc: Componente de árvore onde é possível adicionar/editar/excluir sem limites de ramos.
+
+props:
+  form-generator-props:
+    desc: Propriedades enviadas para o "QasFormGenerator".
+    type: Object
+    default: {}
+
+  form-view-props:
+    desc: Propriedades enviadas para o "QasFormView".
+    type: Object
+    default: {}
+
+  label-key:
+    desc: Chave identificadora da label, por padrão o componente considera label, é possível alterar o valor enviado para API através desta chave.
+    type: String
+    default: name
+
+  lazy-nodes:
+    desc: Model do lazy, toda vez que é adicionado/editado/excluído um nó este model é atualizado, ele não é um "two way data binding" alterações fora do componente não afetarão o componente.
+    type: Array
+    default: []
+    model: true
+    examples: [v-model:lazyNodes="lazyNodes"]
+
+  nodes:
+    desc: Nested de Array de objeto contendo label, uuid, lazy e children, é a propriedade responsável por montar a árvore, precisa ser enviado toda a árvore de uma vez.
+    type: Array
+    default: []
+
+  readonly:
+    desc: Habilita a árvore para modo de visualização somente, não sendo possível adicionar/editar/remover nenhum ramo.
+    type: Boolean
+
+  resource:
+    desc: Usado como endpoint da API para adicionar/remover/excluir, quando não utilizar o QasFormView.
+    type: String
+    default: ''
+
+  tree-props:
+    desc: Propriedades enviada para o QTree.
+    default: {}
+    type: Object
+
+  use-add-button:
+    desc: Habilita o botão de adicionar novos ramos.
+    default: true
+    type: Boolean
+
+  use-destroy-button:
+    desc: Habilita o botão de remover os ramos.
+    default: true
+    type: Boolean
+
+  use-destroy-on-first-node:
+    desc: Habilita o botão de remover o primeiro ramo da árvore.
+    type: Boolean
+
+  use-edit-button:
+    desc: Habilita o botão de editar os ramos.
+    default: true
+    type: Boolean
+
+  use-form-view-edit:
+    desc: Habilita o form-view como componente a ser renderizado ao abrir o dialog em modo de edição.
+    type: Boolean
+
+  use-form-view-add:
+    desc: Habilita o form-view como componente a ser renderizado ao abrir o dialog em modo de adição.
+    type: Boolean
+
+events:
+  '@update:lazy-nodes -> function(value)':
+    desc: Dispara toda vez que é adicionado/editado/excluído um nó este model é atualizado, também usado para v-model.
+    params:
+      value:
+        desc: Novo valor do model.
+        type: Array

package/src/helpers/destroy-nested-children-by-key.js

@@ -0,0 +1,33 @@
+export default function destroyNestedChildrenByKey (nested = [], destroyedKey = 'destroyed') {
+  if (!Array.isArray(nested)) {
+    throw new Error('Please provide a valid array.')
+  }
+
+  let index = 0
+
+  function hasNext () {
+    return index < nested.length
+  }
+
+  function next () {
+    return nested[index++]
+  }
+
+  while (hasNext()) {
+    const current = next()
+
+    if (current[destroyedKey]) {
+      index--
+      nested.splice(index, 1)
+      continue
+    }
+
+    for (const key in current) {
+      if (Array.isArray(current[key]) && current[key].length) {
+        destroyNestedChildrenByKey(nested[index - 1][key])
+      }
+    }
+  }
+
+  return nested
+}

package/src/helpers/find-children-by-key.js

@@ -0,0 +1,14 @@
+export default (nested = [], key, value) => {
+  let response = null
+
+  nested.some(function findNodes (item) {
+    if (item[key] === value) {
+      response = item
+      return true
+    }
+
+    return Array.isArray(item.children) && item.children.some(findNodes)
+  })
+
+  return response
+}

package/src/helpers/index.js

@@ -11,6 +11,10 @@ export { default as filterListByHandle } from './filter-list-by-handle.js'
 export { default as camelizeFieldsName } from './camelize-fields-name.js'
 export { default as getNormalizedOptions } from './get-normalized-options.js'
 export { default as handleProcess } from './handle-process.js'
+export { default as destroyNestedChildrenByKey } from './destroy-nested-children-by-key.js'
+export { default as promiseHandler } from './promise-handler.js'
+export { default as findChildrenByKey } from './find-children-by-key'
 
 export * from './filters.js'
 export * from './images.js'
+export * from './rules'

package/src/helpers/promise-handler.js

@@ -0,0 +1,37 @@
+import { Loading } from 'quasar'
+import { NotifySuccess, NotifyError } from '../plugins'
+
+/** Função para lidar com promises, por exemplo requests.
+ *
+ * @param {Promise} promise
+ * @param {object} config={successMessage, errorMessage, useLoading}
+ * @example promiseHandle(new Promise(), { errorMessage: 'Erro', successMessage: 'Sucesso' })
+ */
+export default async function (promise, config = {}) {
+  const {
+    successMessage,
+    errorMessage,
+    useLoading = true,
+    onLoading
+  } = config
+
+  onLoading && onLoading(true)
+  useLoading && Loading.show()
+
+  const promiseToBeExec = typeof promise === 'function' ? promise() : promise
+
+  try {
+    const data = await (Array.isArray(promise) ? Promise.all(promise) : promiseToBeExec)
+
+    if (successMessage) NotifySuccess(successMessage)
+
+    return { data, error: null }
+  } catch (error) {
+    if (errorMessage) NotifyError(errorMessage)
+
+    return { data: null, error }
+  } finally {
+    onLoading && onLoading(false)
+    Loading.hide()
+  }
+}

package/src/helpers/rules.js

@@ -0,0 +1,7 @@
+const required = (value = '', message = 'Campo obrigatório') => {
+  return String(value).length || message
+}
+
+export {
+  required
+}

package/src/vue-plugin.js

@@ -45,6 +45,7 @@ import QasTableGenerator from './components/table-generator/QasTableGenerator.vu
 import QasTabsGenerator from './components/tabs-generator/QasTabsGenerator.vue'
 import QasTextTruncate from './components/text-truncate/QasTextTruncate.vue'
 import QasTransfer from './components/transfer/QasTransfer.vue'
+import QasTreeGenerator from './components/tree-generator/QasTreeGenerator.vue'
 import QasUploader from './components/uploader/QasUploader.vue'
 
 import VueGoogleMaps from '@fawmi/vue-google-maps'
@@ -114,6 +115,7 @@ function install (app) {
   app.component('QasTabsGenerator', QasTabsGenerator)
   app.component('QasTextTruncate', QasTextTruncate)
   app.component('QasTransfer', QasTransfer)
+  app.component('QasTreeGenerator', QasTreeGenerator)
   app.component('QasUploader', QasUploader)
 
   app.use(Quasar, { plugins: { Notify, QuasarDialog, Dialog } })
@@ -184,6 +186,7 @@ export {
   QasTabsGenerator,
   QasTextTruncate,
   QasTransfer,
+  QasTreeGenerator,
   QasUploader,
 
   // plugins