@sankhyalabs/sankhyablocks 9.2.0-dev.2 → 9.2.0-dev.20

package/dist/collection/components/snk-personalized-filter/snk-personalized-filter.js

@@ -1,3 +1,21 @@
+/**
+ * Componente responsável pela criação, edição e gerenciamento de filtros personalizados.
+ *
+ * Permite alternar entre os modos assistente e avançado, salvar, cancelar e manipular filtros.
+ *
+ * @component
+ * @example
+ * <snk-personalized-filter
+ *    entityUri="sua/entidade"
+ *    filterId="idFiltro"
+ *    configName="nomeConfig"
+ *    resourceID="resourceId"
+ *    isDefaultFilter={false}
+ *    messagesBuilder={messagesBuilderInstance}
+ *    onEzSave={handler}
+ *    onEzCancel={handler}
+ * />
+ */
 import { h, Host, Fragment } from '@stencil/core';
 import { ApplicationContext, StringUtils } from '@sankhyalabs/core';
 import { PersonalizedFilterUtils } from './subcomponents/snk-filter-param-config/utils/PersonalizedFilterUtils';
@@ -34,8 +52,10 @@ export class SnkPersonalizedFilter {
     this.resourceID = undefined;
     this.isDefaultFilter = false;
   }
-  /*
-   * Cria um novo filtro se não houver nenhum filtro existente
+  /**
+   * Cria um novo filtro personalizado caso não exista nenhum.
+   * @method
+   * @returns {Promise<void>}
    */
   async createPersonalizedFilter() {
     const newPersonalizedFilter = {
@@ -71,6 +91,12 @@ export class SnkPersonalizedFilter {
     this._originalFilterAssistent = ObjectUtils.copy(newPersonalizedFilter);
     this._filterAssistent = ObjectUtils.copy(newPersonalizedFilter);
   }
+  /**
+   * Carrega o filtro personalizado com base no identificador informado.
+   * @watch filterId
+   * @param newValue Novo valor do filtroId.
+   * @param oldValue Valor anterior do filtroId.
+   */
   loadFilter(newValue, oldValue) {
     if (newValue == null || oldValue == newValue || this.resourceID == undefined) {
       return;
@@ -357,7 +383,10 @@ export class SnkPersonalizedFilter {
         "required": false,
         "optional": false,
         "docs": {
-          "tags": [],
+          "tags": [{
+              "name": "property",
+              "text": undefined
+            }],
           "text": "Respons\u00E1vel por flexibilizar e padronizar o uso de mensagens nos blocos de constru\u00E7\u00E3o."
         }
       },
@@ -372,8 +401,11 @@ export class SnkPersonalizedFilter {
         "required": false,
         "optional": false,
         "docs": {
-          "tags": [],
-          "text": "Respons\u00E1vel por receber a URI da entidade."
+          "tags": [{
+              "name": "property",
+              "text": undefined
+            }],
+          "text": "URI da entidade utilizada para buscar os campos dispon\u00EDveis para filtro."
         },
         "attribute": "entity-uri",
         "reflect": false
@@ -389,8 +421,11 @@ export class SnkPersonalizedFilter {
         "required": false,
         "optional": false,
         "docs": {
-          "tags": [],
-          "text": "Id do filtro que ser\u00E1 carregado."
+          "tags": [{
+              "name": "property",
+              "text": undefined
+            }],
+          "text": "Identificador do filtro a ser carregado."
         },
         "attribute": "filter-id",
         "reflect": false
@@ -406,8 +441,11 @@ export class SnkPersonalizedFilter {
         "required": false,
         "optional": false,
         "docs": {
-          "tags": [],
-          "text": "Nome da configura\u00E7\u00E3o. Serve para distinguir v\u00E1rias inst\u00E2ncias do componente."
+          "tags": [{
+              "name": "property",
+              "text": undefined
+            }],
+          "text": "Nome da configura\u00E7\u00E3o, utilizado para distinguir m\u00FAltiplas inst\u00E2ncias do componente."
         },
         "attribute": "config-name",
         "reflect": false
@@ -423,8 +461,11 @@ export class SnkPersonalizedFilter {
         "required": false,
         "optional": false,
         "docs": {
-          "tags": [],
-          "text": "Nome da configura\u00E7\u00E3o. Serve para distinguir v\u00E1rias inst\u00E2ncias do componente."
+          "tags": [{
+              "name": "property",
+              "text": undefined
+            }],
+          "text": "Identificador do recurso utilizado para salvar e recuperar filtros."
         },
         "attribute": "resource-i-d",
         "reflect": false
@@ -440,8 +481,14 @@ export class SnkPersonalizedFilter {
         "required": false,
         "optional": false,
         "docs": {
-          "tags": [],
-          "text": "Define se o filtro em quest\u00E3o \u00E9 um filtro padr\u00E3o."
+          "tags": [{
+              "name": "property",
+              "text": undefined
+            }, {
+              "name": "default",
+              "text": "false"
+            }],
+          "text": "Indica se o filtro \u00E9 o filtro padr\u00E3o do sistema."
         },
         "attribute": "is-default-filter",
         "reflect": false,
@@ -463,8 +510,11 @@ export class SnkPersonalizedFilter {
         "cancelable": true,
         "composed": true,
         "docs": {
-          "tags": [],
-          "text": ""
+          "tags": [{
+              "name": "event",
+              "text": undefined
+            }],
+          "text": "Evento emitido ao cancelar a personaliza\u00E7\u00E3o do filtro."
         },
         "complexType": {
           "original": "void",
@@ -478,8 +528,11 @@ export class SnkPersonalizedFilter {
         "cancelable": true,
         "composed": true,
         "docs": {
-          "tags": [],
-          "text": ""
+          "tags": [{
+              "name": "event",
+              "text": undefined
+            }],
+          "text": "Evento emitido ao salvar as altera\u00E7\u00F5es do filtro personalizado."
         },
         "complexType": {
           "original": "string",
@@ -493,8 +546,11 @@ export class SnkPersonalizedFilter {
         "cancelable": true,
         "composed": true,
         "docs": {
-          "tags": [],
-          "text": ""
+          "tags": [{
+              "name": "event",
+              "text": undefined
+            }],
+          "text": "Evento emitido ap\u00F3s salvar as altera\u00E7\u00F5es do filtro personalizado."
         },
         "complexType": {
           "original": "void",
@@ -521,8 +577,14 @@ export class SnkPersonalizedFilter {
           "return": "Promise<void>"
         },
         "docs": {
-          "text": "",
-          "tags": []
+          "text": "Cria um novo filtro personalizado caso n\u00E3o exista nenhum.",
+          "tags": [{
+              "name": "method",
+              "text": undefined
+            }, {
+              "name": "returns",
+              "text": undefined
+            }]
         }
       }
     };

package/dist/collection/components/snk-pesquisa/snk-pesquisa.js

@@ -416,8 +416,20 @@ export class SnkPesquisa {
         "required": false,
         "optional": false,
         "docs": {
-          "tags": [],
-          "text": "Fun\u00E7\u00E3o respons\u00E1vel em carregar os itens do componente snk-pesquisa."
+          "tags": [{
+              "name": "type",
+              "text": "{(text: string) => Promise<any>}"
+            }, {
+              "name": "param",
+              "text": "text Texto utilizado como argumento de pesquisa."
+            }, {
+              "name": "returns",
+              "text": "Promise com os dados da pesquisa."
+            }, {
+              "name": "example",
+              "text": "searchLoader={(text) => fetchItems(text)}"
+            }],
+          "text": "Fun\u00E7\u00E3o respons\u00E1vel em carregar os itens do componente snk-pesquisa.\nDeve retornar uma Promise com os dados encontrados."
         }
       },
       "treeLoader": {
@@ -435,8 +447,17 @@ export class SnkPesquisa {
         "required": false,
         "optional": true,
         "docs": {
-          "tags": [],
-          "text": "Fun\u00E7\u00E3o respons\u00E1vel por carregar a \u00E1rvore hier\u00E1rquica do componente"
+          "tags": [{
+              "name": "type",
+              "text": "{(text: string) => Promise<any>}"
+            }, {
+              "name": "param",
+              "text": "text Texto utilizado como argumento de pesquisa para a \u00E1rvore."
+            }, {
+              "name": "returns",
+              "text": "Promise com os dados da \u00E1rvore."
+            }],
+          "text": "Fun\u00E7\u00E3o respons\u00E1vel por carregar a \u00E1rvore hier\u00E1rquica do componente.\nOpcional. Caso n\u00E3o seja fornecida, o modo \u00E1rvore n\u00E3o estar\u00E1 dispon\u00EDvel."
         }
       },
       "selectItem": {
@@ -455,8 +476,20 @@ export class SnkPesquisa {
         "required": false,
         "optional": false,
         "docs": {
-          "tags": [],
-          "text": "Fun\u00E7\u00E3o disparada ao selecionar um item."
+          "tags": [{
+              "name": "type",
+              "text": "{(option: IOption) => void}"
+            }, {
+              "name": "param",
+              "text": "option Item selecionado."
+            }, {
+              "name": "returns",
+              "text": "void"
+            }, {
+              "name": "example",
+              "text": "selectItem={(option) => handleSelect(option)}"
+            }],
+          "text": "Fun\u00E7\u00E3o disparada ao selecionar um item da pesquisa."
         }
       },
       "entityName": {
@@ -470,8 +503,14 @@ export class SnkPesquisa {
         "required": false,
         "optional": false,
         "docs": {
-          "tags": [],
-          "text": "Nome da entidade onde a pesquisa \u00E9 aplicada."
+          "tags": [{
+              "name": "type",
+              "text": "{string}"
+            }, {
+              "name": "example",
+              "text": "entityName=\"Produto\""
+            }],
+          "text": "Nome da entidade sobre a qual a pesquisa ser\u00E1 realizada."
         },
         "attribute": "entity-name",
         "reflect": false
@@ -487,8 +526,17 @@ export class SnkPesquisa {
         "required": false,
         "optional": false,
         "docs": {
-          "tags": [],
-          "text": "Argumentos que ser\u00E3o usados ao chamar a fun\u00E7\u00E3o searchLoader."
+          "tags": [{
+              "name": "type",
+              "text": "{string}"
+            }, {
+              "name": "mutable",
+              "text": undefined
+            }, {
+              "name": "example",
+              "text": "argument=\"Texto para pesquisa\""
+            }],
+          "text": "Argumento utilizado ao chamar a fun\u00E7\u00E3o searchLoader.\nPode ser alterado externamente."
         },
         "attribute": "argument",
         "reflect": false
@@ -504,8 +552,17 @@ export class SnkPesquisa {
         "required": false,
         "optional": false,
         "docs": {
-          "tags": [],
-          "text": "Define se a popup de pesquisa possuir\u00E1 ou n\u00E3o modo Hierarquico."
+          "tags": [{
+              "name": "type",
+              "text": "{boolean}"
+            }, {
+              "name": "default",
+              "text": "false"
+            }, {
+              "name": "example",
+              "text": "isHierarchyEntity={true}"
+            }],
+          "text": "Define se a popup de pesquisa ter\u00E1 ou n\u00E3o modo hier\u00E1rquico."
         },
         "attribute": "is-hierarchy-entity",
         "reflect": false,
@@ -522,8 +579,17 @@ export class SnkPesquisa {
         "required": false,
         "optional": false,
         "docs": {
-          "tags": [],
-          "text": "Define se permite sele\u00E7\u00E3o de items n\u00E3o anal\u00EDticos"
+          "tags": [{
+              "name": "type",
+              "text": "{boolean}"
+            }, {
+              "name": "default",
+              "text": "false"
+            }, {
+              "name": "example",
+              "text": "allowsNonAnalytic={true}"
+            }],
+          "text": "Define se permite a sele\u00E7\u00E3o de itens n\u00E3o anal\u00EDticos."
         },
         "attribute": "allows-non-analytic",
         "reflect": false,

package/dist/collection/components/snk-simple-bar/snk-simple-bar.js

@@ -7,11 +7,11 @@ export class SnkSimpleBar {
     this.messagesBuilder = undefined;
   }
   /**
-   * Conforme mecanismo de mensagens, é possível customizar as mensagens dos blocos de construção
-   * através de um pequeno modulo na estrutura da aplicação:
-   * - Criar um arquivo no seguinte caminho: /messages/appmessages.msg.js.
-   * Para conhecer os detalhes do módulo, vide o arquivo neste projeto "/src/lib/message/resources/snk-simple-bar.msg.ts"
-  */
+   * Permite customizar as mensagens dos blocos de construção
+   * através de um pequeno módulo na estrutura da aplicação:
+   * - Crie um arquivo no seguinte caminho: /messages/appmessages.msg.js.
+   * Para conhecer os detalhes do módulo, veja o arquivo neste projeto: "/src/lib/message/resources/snk-simple-bar.msg.ts"
+   */
   getMessage(key, params) {
     var _a;
     if (this.messagesBuilder)
@@ -54,7 +54,7 @@ export class SnkSimpleBar {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Define o t\u00EDtulo do header"
+          "text": "Define o t\u00EDtulo do header."
         },
         "attribute": "label",
         "reflect": false
@@ -79,7 +79,7 @@ export class SnkSimpleBar {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Define os itens que ser\u00E3o apresentados pelo breadcrumb"
+          "text": "Define os itens que ser\u00E3o apresentados no breadcrumb."
         }
       },
       "messagesBuilder": {
@@ -113,7 +113,7 @@ export class SnkSimpleBar {
         "composed": true,
         "docs": {
           "tags": [],
-          "text": "Emitido quando algum item do breadcrumb \u00E9 clicado"
+          "text": "Emitido quando algum item do breadcrumb \u00E9 clicado."
         },
         "complexType": {
           "original": "IBreadcrumbItem",
@@ -133,7 +133,7 @@ export class SnkSimpleBar {
         "composed": true,
         "docs": {
           "tags": [],
-          "text": "Emitido quando o bot\u00E3o voltar \u00E9 acionado"
+          "text": "Emitido quando o bot\u00E3o \"voltar\" \u00E9 acionado."
         },
         "complexType": {
           "original": "void",