@sankhyalabs/sankhyablocks 9.2.0-dev.8 → 9.2.0-ms.1

package/dist/types/components/snk-grid/snk-grid.d.ts

@@ -44,12 +44,9 @@ export declare class SnkGrid {
   _showSnkFilterBar: boolean;
   _enableContinuousInsert: boolean;
   _application: SnkApplication;
-  /**
-   * Define o data source para o filtro de colunas.
-   */
   columnFilterDataSource: IMultiSelectionListDataSource;
   /**
-   * Define se o componente deve usar o LockManager para controle de carregamento da aplicação.
+   * Define se o componente deve usar o LockManager para controle de carregamento da aplicação
    */
   enableLockManagerLoadingComp?: boolean;
   /**
@@ -57,48 +54,45 @@ export declare class SnkGrid {
    */
   enableLockManagerTaskbarClick?: boolean;
   /**
-   * Nome usado para salvar e recuperar a configuração da grade.
+   * Nome usado para salvar/recuperar a configuração.
    */
   configName: string;
   /**
-   * Título que será apresentado na barra de filtros.
+   * Título que será apresentado na barra de filtros
    */
   filterBarTitle: string;
   /**
-   * Identificador de recursos, como configurações e permissões de acesso.
+   * Identificador de recursos como configurações e acesso.
    */
   resourceID: string;
   /**
-   * Configuração do toast de seleção da grade.
+   * Configuração da seleção de grade no toast.
    */
   selectionToastConfig: ISelectionToastConfig;
   /**
-   * Lista de ações que devem ser usadas no botão "Mais opções" do `snk-taskbar`.
+   * Lista de ações que devem ser usadas no botão "Mais opções" do componente snk-taskbar.
    */
   actionsList: Array<Action>;
   /**
-   * Determina se a grade está vinculada a um detalhe de outra tela.
+   * Determina se a grade está vinculada a um detalhe.
    */
   isDetail: boolean;
   /**
-  * Gerenciador das barras de tarefas. Permite determinar botões específicos
-  * ou gerenciar o estado dos botões.
+  * Gerenciador das barras de tarefas. É possível determinar botões específicos
+  * ou mesmo gerenciar o estado dos botões.
   */
   taskbarManager: TaskbarManager;
   /**
-   * Define a configuração de cores para a coluna de status.
-   * @example
-   * ```json
-   * '{ "RECDESP": { "-1" : "#BD0025", "1" : "#157A00" } }'
-   * ```
+   * Configuração do valor da coluna de status.
+   * Exemplo: '{ "RECDESP": { "-1" : "#BD0025", "1" : "#157A00" } }'
    */
   statusResolver: IStatusResolver | StatusResolverFunction;
   /**
-   * Determina se a seleção de múltiplas linhas é permitida.
+   * Determina se pode haver mais de uma linha selecionada.
    */
   multipleSelection: boolean;
   /**
-   * Altera o modo de apresentação dos botões do `snk-taskbar`.
+   * Altera o modo de apresentação dos botões do snk-taskbar.
    */
   presentationMode: PresentationMode;
   /**
@@ -106,191 +100,139 @@ export declare class SnkGrid {
   */
   messagesBuilder: SnkMessageBuilder;
   /**
-   * Quando `true`, a tecla ENTER navega entre as células como a tecla TAB.
+   * Quando verdadeiro, o ENTER fará a navegação como se fosse a tecla TAB na grade.
    */
   useEnterLikeTab: boolean;
   /**
-   * Validador responsável por verificar a integridade dos dados de um registro.
+   * Validador responsável por checar a integridade das informações do registro.
    */
   recordsValidator: IRecordValidator;
   /**
-   * Define se a edição de dados na grade está habilitada.
+   * Define se a edição está habilitada na grid.
    */
   canEdit: boolean;
   /**
-   * Define o identificador do contêiner de elementos customizados da `Taskbar`.
+   * Define o identificador do container de elementos customizados da Taskbar.
    */
   taskbarCustomContainerId: string;
   /**
-   * Define o nome do slot para elementos customizados na `Taskbar` do cabeçalho da grade.
+   * Nome do slot de elementos customizados da Taskbar do cabeçalho da grade.
    */
   gridHeaderCustomSlotId: string;
   /**
-   * Define o nome do slot para elementos customizados na `Taskbar` principal do componente.
+   * Nome do slot de elementos customizados da Taskbar principal do componente.
    */
   topTaskbarCustomSlotId: string;
   /**
-  * Desabilita a apresentação da opção de filtros personalizados na barra de filtros (chip de filtros)
-  * e no modal lateral de filtros (contêiner de filtros personalizados).
+  * Desabilita a apresentação da opção de filtros personalizados na filter bar (chip de filtros)
+  * e no modal lateral de filtros (container de filtros personalizados).
   */
   disablePersonalizedFilter: boolean;
   /**
-   * Chave da configuração legada da grade.
+   * Chave da configuração legado da grade.
    */
   gridLegacyConfigName: string;
   /**
-   * Chave da configuração legada da barra de filtros.
+   * Chave da configuração legado da barra de filtros.
    */
   filterBarLegacyConfigName: string;
   /**
-   * Define se os dados serão carregados automaticamente na inicialização do componente.
+   * Define se a carga dos dados será feita assim que o componente for carregado.
    */
   autoLoad?: boolean;
   /**
-   * Define se a grade receberá o foco automaticamente ao ser carregada.
+   * Define se a grid será focada ao ser carregada.
    */
   autoFocus?: boolean;
   /**
-   * Habilita a inserção de registros diretamente na grade.
+   * Ativa inserção de registros no modo grade.
    */
   enableGridInsert?: boolean;
   /**
-  * Altera a aparência das bordas e sombras do componente.
-  * Se `false`, aplica o padrão de sombras (ideal para o elemento principal do layout).
-  * Se `true`, aplica um contorno (ideal para quando o componente está dentro de outro, como um painel ou pop-up).
+  * Altera visualmente as sombras e bordas do componente
+  * Quando false, aplica o padrão de sombras ao componente (Utilizar quando for o elemento principal do layout)
+  * Quando true, aplica o padrão de outline ao componente (Utilizar quando estiver contido em outro elemento como um painel ou pop-up)
   */
   outlineMode?: boolean;
   /**
-   * Define se a grade deve suprimir a barra de rolagem horizontal.
+   * Define se a grade deve suprimir o scroll horizontal.
    */
   suppressHorizontalScroll: boolean;
   /**
-   * Define o modo de exportação dos dados.
+   * Modo de exportação dos dados.
    */
   strategyExporter: IExporterStrategyMode;
   /**
-   * Define se a grade deve exibir um buscador de colunas ao pressionar `Ctrl+F`.
+   * Define se a grade deve exibir um buscador de coluna com uso do Ctrl+F
    */
   useSearchColumn: boolean;
   /**
-   * Habilita a edição de múltiplos registros simultaneamente.
+   * Habilita a edição de múltiplos registros simultâneos.
    */
   multipleEditionEnabled: boolean;
   /**
-   * Define o modo de exibição do contador de paginação.
+   * Define se a grid será focada ao ser carregada.
    */
   paginationCounterMode?: 'show' | 'hidden' | 'auto';
   /**
-   * Informa se a coluna de checkbox deve ser suprimida.
+   * Informa se a coluna de chechbox deve ser suprimida
    */
   suppressCheckboxColumn: boolean;
   /**
-   * Informa se a grade deve suprimir o filtro de coluna.
-   */
-  suppressFilterColumn?: boolean;
-  /**
-   * Define se a grade deve ser exibida em modo compacto.
+   * Define se a grade deve ser exibida em modo compacto
    */
   compact: boolean;
   /**
-   * Emitido ao clicar em um botão de ação ou item de menu.
-   * @description Este evento é acionado quando o usuário clica em um botão de ação ou item de menu na grade, permitindo a execução de ações específicas.
-   * @param {string} detail - O identificador da ação clicada, que pode ser usado para determinar qual ação executar.
+   * Emitido sempre que houver click de botão ou ação.
    */
   actionClick: EventEmitter<string>;
   /**
-  * Emitido ao realizar um duplo clique em uma linha da grade.
-  * @description Este evento é acionado quando o usuário clica duas vezes em uma linha da grade, permitindo ações como edição rápida ou visualização de detalhes.
-  * @param {any} detail - Detalhes do evento, contendo a linha clicada.
+  * Emitido sempre que houver duplo click na grade.
   */
   gridDoubleClick: EventEmitter<any>;
   /**
-   * @deprecated Esta propriedade foi descontinuada. Ela não tem mais efeito sobre o componente.
+   * Emitido quando o componente estiver completamente carregado.
    */
   componentReady: EventEmitter<void>;
-  /**
-   * Recarrega a configuração da grade.
-   * @description Este método força o recarregamento da configuração da grade a partir do `ConfigStorage`. A operação é assíncrona, mas o método não aguarda sua conclusão.
-   */
   reloadConfig(): void;
   /**
    * Exibe a janela de configurações da grade.
-   * @async
-   * @description Este método abre o pop-up de configuração de colunas da grade, permitindo ao usuário ajustar a visibilidade, ordem e largura das colunas.
-   * @returns {Promise<void>} Uma promessa que é resolvida quando a janela de configuração é exibida.
    */
   showConfig(): Promise<void>;
   /**
    * Fecha a janela de configurações da grade.
-   * @async
-   * @description Este método fecha o pop-up de configuração de colunas da grade.
-   * @returns {Promise<void>} Uma promessa que é resolvida quando a janela de configuração é fechada.
    */
   hideConfig(): Promise<void>;
   /**
-   * Define a configuração da grade.
-   * @async
-   * @description Aplica uma nova configuração de colunas e ordenação à grade.
-   * @param {IGridConfig} config O objeto de configuração a ser aplicado na grade.
-   * @returns {Promise<void>} Uma promessa que é resolvida quando a configuração é aplicada.
+   * Atribui o valor da configuração da grade.
    */
   setConfig(config: IGridConfig): Promise<void>;
   /**
-   * Recarrega a barra de filtros da grade, buscando o estado do servidor.
-   * @async
-   * @description Força o recarregamento da barra de filtros, atualizando suas configurações e filtros a partir do servidor.
-   * @returns {Promise<void>} Uma promessa que é resolvida quando a barra de filtros é recarregada.
+   * Faz o recarregamento da filter-bar da grade buscando o state no servidor.
    */
   reloadFilterBar(): Promise<void>;
   /**
-   * Retorna o elemento da barra de filtros da grade.
-   * @async
-   * @description Este método permite acessar o elemento da barra de filtros, que pode ser útil para manipulações adicionais ou para obter o estado atual dos filtros aplicados.
-   * @returns {Promise<HTMLSnkFilterBarElement>} O elemento da barra de filtros.
+   * Retorna o elemento da filter-bar da grade.
    */
   getFilterBar(): Promise<HTMLSnkFilterBarElement>;
   /**
-   * Registra um editor customizado para um campo da grade ou formulário.
-   * @async
-   * @description Adiciona um componente de edição personalizado para um campo específico. Este editor será usado tanto na edição em linha na grade quanto em formulários de detalhe.
-   * @param {string} fieldName O nome do campo que receberá o editor customizado.
-   * @param {ICustomEditor} customEditor A instância do editor customizado.
-   * @param {string} [detailContext] O contexto de detalhe onde o editor será aplicado (opcional).
-   * @returns {Promise<void>} Uma promessa que é resolvida quando o editor é registrado.
+   * Registra um editor customizado para campos da grade e formulário
    */
   addCustomEditor(fieldName: string, customEditor: ICustomEditor, detailContext?: string): Promise<void>;
   /**
-   * Registra um renderizador customizado para uma coluna da grade.
-   * @async
-   * @description Adiciona um componente de renderização personalizado para uma coluna específica, permitindo a exibição de conteúdo customizado nas células.
-   * @param {string} fieldName O nome do campo (coluna) que receberá o renderizador customizado.
-   * @param {ICustomRender} customRender A instância do renderizador customizado.
-   * @param {string} [detailContext] O contexto de detalhe onde o renderizador será aplicado (opcional).
-   * @returns {Promise<void>} Uma promessa que é resolvida quando o renderizador é registrado.
+   * Registra um render customizado para colunas da grid.
    */
   addGridCustomRender(fieldName: string, customRender: ICustomRender, detailContext?: string): Promise<void>;
   /**
-   * Registra um formatador de valor customizado para uma coluna da grade.
-   * @async
-   * @description Adiciona uma função de formatação personalizada para os valores de uma coluna específica, afetando como os dados são exibidos.
-   * @param {string} columnName O nome da coluna que receberá o formatador.
-   * @param {ICustomFormatter} customFormatter A instância do formatador de valor.
-   * @returns {Promise<void>} Uma promessa que é resolvida quando o formatador é registrado.
+   * Registra um formatador de valores para uma coluna da grid.
    */
   addCustomValueFormatter(columnName: string, customFormatter: ICustomFormatter): Promise<void>;
   /**
-   * Remove um formatador de valor customizado de uma coluna da grade.
-   * @async
-   * @description Remove uma função de formatação personalizada previamente registrada para uma coluna.
-   * @param {string} columnName O nome da coluna da qual o formatador será removido.
-   * @returns {Promise<void>} Uma promessa que é resolvida quando o formatador é removido.
+   * Remove o formatador de valores de uma coluna da grid.
    */
   removeCustomValueFormatter(columnName: string): Promise<void>;
   /**
    * Atribui o foco para a grade.
-   * @async
-   * @description Move o foco do navegador para o componente da grade, permitindo a navegação por teclado.
-   * @returns {Promise<void>} Uma promessa que é resolvida quando o foco é atribuído.
    */
   setFocus(): Promise<void>;
   handleClick(event: MouseEvent): Promise<void>;

package/dist/types/components/snk-taskbar/snk-taskbar.d.ts

@@ -26,81 +26,79 @@ export declare class SnkTaskbar {
   _hasToUpdateOverFlow: boolean;
   _isWaitingForSave: boolean;
   /**
-   * @description Define o alinhamento dos itens da barra de tarefas à direita.
+   * Usado para determinar O alinhamento dos items na taskbar.
    */
   alignRigth: boolean;
   /**
-   * @description Define o identificador do slot que recebe elementos personalizados.
+   * Usado para determinar o identificador do slot que recebe elementos personalizados.
    */
   customSlotId: string;
   /**
-   * @description Define o identificador do contêiner na DOM que é responsável por guardar os elementos personalizados
+   * Usado para determinar o identificador do container na DOM que é responsavel por guardar os elementos personalizados
    * que não podem ser passados por slot.
-   * @example
-   * Elementos customizados na Taskbar da aba de detalhes.
+   *
+   * Exemplo: Elementos customizados na Taskbar da aba de detalhes.
    */
   customContainerId: string;
   /**
-   * @description Define como será o comportamento da barra de tarefas quando ocorrer um overflow de itens.
+   * Define como será o comportamento da taskbar quando ocorrer overflow
    */
   overflowStrategy: 'hiddenItems' | 'none';
   /**
-   * @description Nome da configuração usada para salvar ou recuperar as configurações do formulário. Também é utilizado como fallback para a chave de armazenamento do exportador de dados.
+   * Usado para guardar ou recuperar as configurações do formulário.
    */
   configName: string;
   /**
-   * @description Identificador de recursos, como configurações e permissões de acesso.
+   * Identificador de recursos como configurações e acesso.
    */
   resourceID: string;
   /**
-   * @description Lista de botões, separados por vírgula, que define todos os elementos a serem criados na barra de tarefas.
+   * Lista separada por virgula, contendo todos os elementos a serem criados.
    */
   buttons: string;
   /**
-   * @description Mapa com definições de botões personalizados. A chave do mapa deve ser informada na propriedade `buttons` no local onde o botão deve ser renderizado.
+   * Mapa com definição de botões personalizados. A chave do mapa deve ser
+   * passada na lista "buttons" no lugar onde o botão irá aparecer.
    */
   customButtons: Map<string, CustomButton>;
   /**
-   * @description Lista de ações a serem exibidas no botão "Mais opções".
+   * Lista de ações que devem ser usadas no botão "Mais opções" do componente snk-taskbar.
    */
   actionsList: Array<Action>;
   /**
-   * @description Lista de ações que devem ser usadas no botão "Mais opções" do componente snk-taskbar.
+   * Lista de ações que devem ser usadas no botão "Mais opções" do componente snk-taskbar.
    */
   actionsSettingsList: Array<Action>;
   /**
-   * @description Define qual botão deve ter a aparência de destaque (primário).
+   * Determina qual botão deve ter aparência primária.
    */
   primaryButton: string;
   /**
-   * @description Array contendo os identificadores de todos os botões que devem ser desabilitados.
+   * Array contendo todos os botões a serem desabilitados.
    */
   disabledButtons: Array<string>;
   /**
-   * @description Instância do `DataUnit` com a qual a barra de tarefas irá interagir para realizar operações de dados (ex: salvar, próximo, anterior).
+   * Instância do DataUnit.
    */
   dataUnit: DataUnit;
   /**
-   * @description Altera o modo de apresentação dos botões da barra de tarefas.
+   * Altera o modo de apresentação dos botões do snk-taskbar.
   */
   presentationMode: PresentationMode;
   /**
-   * @description Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção.
+   * Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção.
    */
   messagesBuilder: SnkMessageBuilder;
   /**
-   * @description Emitido sempre que um botão ou uma ação da barra de tarefas é clicado.
-   * @eventProperty
+   * Emitido sempre que houver click de botão ou ação.
    */
   actionClick: EventEmitter<string>;
   /**
-   * @description Emitido quando uma ação de salvar é iniciada pela barra de tarefas, indicando um estado de bloqueio para evitar ações concorrentes.
-   * @eventProperty
+   * Emitido sempre que um save é iniciado pela taskbar.
    */
   taskbarSaveLocker: EventEmitter<void>;
   /**
-   * @description Emitido quando a ação de salvar é concluída ou cancelada, liberando o estado de bloqueio.
-   * @eventProperty
+   * Emitido sempre que o ocorre alguma action que libera o save.
    */
   taskbarSaveUnlocker: EventEmitter<void>;
   handleCustomSlotElementsLoaded(event: CustomEvent): void;