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

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

@@ -1,18 +1,19 @@
-import { EventEmitter } from '../../stencil-public-runtime';
 import { DataUnit, KeyboardManager } from '@sankhyalabs/core';
 import { IGridConfig, IStatusResolver, StatusResolverFunction } from '@sankhyalabs/ezui/dist/types/components/ez-grid/controller/EzGridController';
-import { DataState, SnkDataUnit } from '../snk-data-unit/snk-data-unit';
-import { Action, TaskbarManager } from '../snk-taskbar/snk-taskbar';
-import { SnkApplication } from '../snk-application/snk-application';
-import { PresentationMode } from '../../lib/@types';
-import TaskbarProcessor from '../snk-taskbar/processor/taskbar-processor';
-import { SnkMessageBuilder } from '../../lib/message/SnkMessageBuilder';
 import { ICustomFormatter, ISelectionToastConfig } from '@sankhyalabs/ezui/dist/types/components/ez-grid/interfaces';
-import { IRecordValidator } from '@sankhyalabs/ezui/dist/types/utils/form/interfaces';
 import { IMultiSelectionListDataSource } from '@sankhyalabs/ezui/dist/types/components/ez-multi-selection-list/interfaces/IMultiSelectionListDataSource';
 import { ICustomEditor, ICustomRender } from '@sankhyalabs/ezui/dist/types/utils';
+import { IRecordValidator } from '@sankhyalabs/ezui/dist/types/utils/form/interfaces';
+import { EventEmitter } from '../../stencil-public-runtime';
+import { PresentationMode } from '../../lib/@types';
 import RmPrecisionCustomValueFormatter from '../../lib/DefaultCustomFormatters/RmPrecisionCustomValueFormatter';
+import { SnkMessageBuilder } from '../../lib/message/SnkMessageBuilder';
+import { SnkApplication } from '../snk-application/snk-application';
 import { IExporterStrategyMode } from '../snk-data-exporter/interfaces/IRecordID';
+import { DataState, SnkDataUnit } from '../snk-data-unit/snk-data-unit';
+import { SnkFilterItemConfig } from '../snk-filter-bar/filter-item/snk-filter-item';
+import TaskbarProcessor from '../snk-taskbar/processor/taskbar-processor';
+import { Action, TaskbarManager } from '../snk-taskbar/snk-taskbar';
 export declare class SnkGrid {
   _grid: HTMLEzGridElement;
   _snkDataUnit: HTMLSnkDataUnitElement;
@@ -44,9 +45,13 @@ export declare class SnkGrid {
   _showSnkFilterBar: boolean;
   _enableContinuousInsert: boolean;
   _application: SnkApplication;
+  /**
+   * Define o data source para o filtro de colunas.
+   */
   columnFilterDataSource: IMultiSelectionListDataSource;
+  refreshColumnFilterDataSource(): Promise<void>;
   /**
-   * 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;
   /**
@@ -54,185 +59,251 @@ export declare class SnkGrid {
    */
   enableLockManagerTaskbarClick?: boolean;
   /**
-   * Nome usado para salvar/recuperar a configuração.
+   * Nome usado para salvar e recuperar a configuração da grade.
    */
   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 acesso.
+   * Identificador de recursos, como configurações e permissões de acesso.
    */
   resourceID: string;
   /**
-   * Configuração da seleção de grade no toast.
+   * Configuração do toast de seleção da grade.
    */
   selectionToastConfig: ISelectionToastConfig;
   /**
-   * 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 `snk-taskbar`.
    */
   actionsList: Array<Action>;
   /**
-   * Determina se a grade está vinculada a um detalhe.
+   * Determina se a grade está vinculada a um detalhe de outra tela.
    */
   isDetail: boolean;
   /**
-  * Gerenciador das barras de tarefas. É possível determinar botões específicos
-  * ou mesmo gerenciar o estado dos botões.
-  */
+   * Gerenciador das barras de tarefas. Permite determinar botões específicos
+   * ou gerenciar o estado dos botões.
+   */
   taskbarManager: TaskbarManager;
   /**
-   * Configuração do valor da coluna de status.
-   * Exemplo: '{ "RECDESP": { "-1" : "#BD0025", "1" : "#157A00" } }'
+   * Define a configuração de cores para a coluna de status.
+   * @example
+   * ```json
+   * '{ "RECDESP": { "-1" : "#BD0025", "1" : "#157A00" } }'
+   * ```
    */
   statusResolver: IStatusResolver | StatusResolverFunction;
   /**
-   * Determina se pode haver mais de uma linha selecionada.
+   * Determina se a seleção de múltiplas linhas é permitida.
    */
   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;
   /**
    * Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção.
-  */
+   */
   messagesBuilder: SnkMessageBuilder;
   /**
-   * Quando verdadeiro, o ENTER fará a navegação como se fosse a tecla TAB na grade.
+   * Quando `true`, a tecla ENTER navega entre as células como a tecla TAB.
    */
   useEnterLikeTab: boolean;
   /**
-   * Validador responsável por checar a integridade das informações do registro.
+   * Validador responsável por verificar a integridade dos dados de um registro.
    */
   recordsValidator: IRecordValidator;
   /**
-   * Define se a edição está habilitada na grid.
+   * Define se a edição de dados na grade está habilitada.
    */
   canEdit: boolean;
   /**
-   * Define o identificador do container de elementos customizados da Taskbar.
+   * Define o identificador do contêiner de elementos customizados da `Taskbar`.
    */
   taskbarCustomContainerId: string;
   /**
-   * Nome do slot de elementos customizados da Taskbar do cabeçalho da grade.
+   * Define o nome do slot para elementos customizados na `Taskbar` do cabeçalho da grade.
    */
   gridHeaderCustomSlotId: string;
   /**
-   * Nome do slot de elementos customizados da Taskbar principal do componente.
+   * Define o nome do slot para elementos customizados na `Taskbar` principal do componente.
    */
   topTaskbarCustomSlotId: string;
   /**
-  * 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).
-  */
+   * 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).
+   */
   disablePersonalizedFilter: boolean;
   /**
-   * Chave da configuração legado da grade.
+   * Chave da configuração legada da grade.
    */
   gridLegacyConfigName: string;
   /**
-   * Chave da configuração legado da barra de filtros.
+   * Chave da configuração legada da barra de filtros.
    */
   filterBarLegacyConfigName: string;
   /**
-   * Define se a carga dos dados será feita assim que o componente for carregado.
+   * Define se os dados serão carregados automaticamente na inicialização do componente.
    */
   autoLoad?: boolean;
   /**
-   * Define se a grid será focada ao ser carregada.
+   * Define se a grade receberá o foco automaticamente ao ser carregada.
    */
   autoFocus?: boolean;
   /**
-   * Ativa inserção de registros no modo grade.
+   * Habilita a inserção de registros diretamente na grade.
    */
   enableGridInsert?: boolean;
   /**
-  * 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)
-  */
+   * 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).
+   */
   outlineMode?: boolean;
   /**
-   * Define se a grade deve suprimir o scroll horizontal.
+   * Define se a grade deve suprimir a barra de rolagem horizontal.
    */
   suppressHorizontalScroll: boolean;
   /**
-   * Modo de exportação dos dados.
+   * Define o modo de exportação dos dados.
    */
   strategyExporter: IExporterStrategyMode;
   /**
-   * Define se a grade deve exibir um buscador de coluna com uso do Ctrl+F
+   * Define se a grade deve exibir um buscador de colunas ao pressionar `Ctrl+F`.
    */
   useSearchColumn: boolean;
   /**
-   * Habilita a edição de múltiplos registros simultâneos.
+   * Habilita a edição de múltiplos registros simultaneamente.
    */
   multipleEditionEnabled: boolean;
   /**
-   * Define se a grid será focada ao ser carregada.
+   * Define o modo de exibição do contador de paginação.
    */
   paginationCounterMode?: 'show' | 'hidden' | 'auto';
   /**
-   * Informa se a coluna de chechbox deve ser suprimida
+   * Informa se a coluna de checkbox deve ser suprimida.
    */
   suppressCheckboxColumn: boolean;
   /**
-   * Define se a grade deve ser exibida em modo compacto
+   * Informa se a grade deve suprimir o filtro de coluna.
+   */
+  suppressFilterColumn?: boolean;
+  /**
+   * Define se a grade deve ser exibida em modo compacto.
    */
   compact: boolean;
   /**
-   * Emitido sempre que houver click de botão ou ação.
+   * @description Configuração customizada dos filtros.
+   * @param {Array<SnkFilterItemConfig>} config - Lista de configurações de filtros.
+   */
+  filterCustomConfig?: Array<SnkFilterItemConfig>;
+  /**
+   * @description Intercepta a configuração dos filtros antes de serem aplicadas.
+   * @param {Array<SnkFilterItemConfig>} config - Lista de configurações de filtros.
+   * @returns {Array<SnkFilterItemConfig>} Retorna a lista de configurações de filtros.
+   */
+  filterCustomConfigInterceptor?: (config: Array<SnkFilterItemConfig>) => Array<SnkFilterItemConfig>;
+  /**
+   * 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.
    */
   actionClick: EventEmitter<string>;
   /**
-  * Emitido sempre que houver duplo click na grade.
-  */
+   * 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.
+   */
   gridDoubleClick: EventEmitter<any>;
   /**
    * 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>;
   /**
-   * Atribui o valor da configuração da grade.
+   * 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.
    */
   setConfig(config: IGridConfig): Promise<void>;
   /**
-   * Faz o recarregamento da filter-bar da grade buscando o state no servidor.
+   * 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.
    */
   reloadFilterBar(): Promise<void>;
   /**
-   * Retorna o elemento da filter-bar da grade.
+   * 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.
    */
   getFilterBar(): Promise<HTMLSnkFilterBarElement>;
   /**
-   * Registra um editor customizado para campos da grade e formulário
+   * 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.
    */
   addCustomEditor(fieldName: string, customEditor: ICustomEditor, detailContext?: string): Promise<void>;
   /**
-   * Registra um render customizado para colunas da grid.
+   * 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.
    */
   addGridCustomRender(fieldName: string, customRender: ICustomRender, detailContext?: string): Promise<void>;
   /**
-   * Registra um formatador de valores para uma coluna da grid.
+   * 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.
    */
   addCustomValueFormatter(columnName: string, customFormatter: ICustomFormatter): Promise<void>;
   /**
-   * Remove o formatador de valores de uma coluna da grid.
+   * 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.
    */
   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>;
@@ -246,12 +317,15 @@ export declare class SnkGrid {
   private normalizeGridConfig;
   private loadConfig;
   private addGridLegacyConfigName;
+  private hasCalculatedFields;
   private gridConfigChangeHandler;
   private modalConfigChangeHandler;
+  private hasToForceClientSideExporter;
   private dataExporterProviderStore;
   private addElementID;
   private loadGridCustomFormatters;
   private interceptMetadataLoaded;
+  private interceptLoadData;
   private dataUnitInterceptor;
   private finishLoading;
   private setCustomRenders;

package/dist/types/components/snk-personalized-filter/snk-personalized-filter.d.ts

@@ -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 { EventEmitter } from '../../stencil-public-runtime';
 import { IFilterLink, IFilterField, FilterFieldsDataSource } from "../snk-filter-field-search/interfaces";
 import { SnkMessageBuilder } from '../../lib/message/SnkMessageBuilder';
@@ -16,32 +34,62 @@ export declare class SnkPersonalizedFilter {
   private _filterAssistent;
   /**
    * Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção.
+   * @property
    */
   messagesBuilder: SnkMessageBuilder;
   /**
-   * Responsável por receber a URI da entidade.
+   * URI da entidade utilizada para buscar os campos disponíveis para filtro.
+   * @property
    */
   entityUri: string;
   /**
-   * Id do filtro que será carregado.
+   * Identificador do filtro a ser carregado.
+   * @property
    */
   filterId: string;
   /**
-   * Nome da configuração. Serve para distinguir várias instâncias do componente.
+   * Nome da configuração, utilizado para distinguir múltiplas instâncias do componente.
+   * @property
    */
   configName: string;
   /**
-   * Nome da configuração. Serve para distinguir várias instâncias do componente.
+   * Identificador do recurso utilizado para salvar e recuperar filtros.
+   * @property
    */
   resourceID: string;
   /**
-   * Define se o filtro em questão é um filtro padrão.
+   * Indica se o filtro é o filtro padrão do sistema.
+   * @property
+   * @default false
    */
   isDefaultFilter: boolean;
+  /**
+   * Evento emitido ao cancelar a personalização do filtro.
+   * @event
+   */
   ezCancel: EventEmitter<void>;
+  /**
+   * Evento emitido ao salvar as alterações do filtro personalizado.
+   * @event
+   */
   ezSave: EventEmitter<string>;
+  /**
+   * Evento emitido após salvar as alterações do filtro personalizado.
+   * @event
+   */
   ezAfterSave: EventEmitter<void>;
+  /**
+   * Cria um novo filtro personalizado caso não exista nenhum.
+   * @method
+   * @returns {Promise<void>}
+   */
   createPersonalizedFilter(): Promise<void>;
+  /**
+   * 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: string, oldValue: string): void;
   _dataSourceFetcher: FilterFieldsDataSource;
   componentWillLoad(): void;

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

@@ -28,30 +28,68 @@ export declare class SnkPesquisa {
   private _valideDataSource;
   /**
    * Função responsável em carregar os itens do componente snk-pesquisa.
+   * Deve retornar uma Promise com os dados encontrados.
+   *
+   * @type {(text: string) => Promise<any>}
+   * @param text Texto utilizado como argumento de pesquisa.
+   * @returns Promise com os dados da pesquisa.
+   * @example
+   * searchLoader={(text) => fetchItems(text)}
    */
   searchLoader: (text: string) => Promise<any>;
   /**
-   * Função responsável por carregar a árvore hierárquica do componente
+   * Função responsável por carregar a árvore hierárquica do componente.
+   * Opcional. Caso não seja fornecida, o modo árvore não estará disponível.
+   *
+   * @type {(text: string) => Promise<any>}
+   * @param text Texto utilizado como argumento de pesquisa para a árvore.
+   * @returns Promise com os dados da árvore.
    */
   treeLoader?: (text: string) => Promise<any>;
   /**
-   * Função disparada ao selecionar um item.
+   * Função disparada ao selecionar um item da pesquisa.
+   *
+   * @type {(option: IOption) => void}
+   * @param option Item selecionado.
+   * @returns void
+   * @example
+   * selectItem={(option) => handleSelect(option)}
    */
   selectItem: (option: IOption) => void;
   /**
-   * Nome da entidade onde a pesquisa é aplicada.
+   * Nome da entidade sobre a qual a pesquisa será realizada.
+   *
+   * @type {string}
+   * @example
+   * entityName="Produto"
    */
   entityName: string;
   /**
-   * Argumentos que serão usados ao chamar a função searchLoader.
+   * Argumento utilizado ao chamar a função searchLoader.
+   * Pode ser alterado externamente.
+   *
+   * @type {string}
+   * @mutable
+   * @example
+   * argument="Texto para pesquisa"
    */
   argument: string;
   /**
-   * Define se a popup de pesquisa possuirá ou não modo Hierarquico.
+   * Define se a popup de pesquisa terá ou não modo hierárquico.
+   *
+   * @type {boolean}
+   * @default false
+   * @example
+   * isHierarchyEntity={true}
    */
   isHierarchyEntity: boolean;
   /**
-   * Define se permite seleção de items não analíticos
+   * Define se permite a seleção de itens não analíticos.
+   *
+   * @type {boolean}
+   * @default false
+   * @example
+   * allowsNonAnalytic={true}
    */
   allowsNonAnalytic: boolean;
   observeArgument(): void;

package/dist/types/components/snk-simple-bar/snk-simple-bar.d.ts

@@ -6,31 +6,31 @@ export declare class SnkSimpleBar {
   private _element;
   _application: SnkApplication;
   /**
-  * Define o título do header
-  */
+   * Define o título do header.
+   */
   label: string;
   /**
-  * Define os itens que serão apresentados pelo breadcrumb
-  */
+   * Define os itens que serão apresentados no breadcrumb.
+   */
   breadcrumbItens: Array<IBreadcrumbItem>;
   /**
-  * 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;
   /**
-  * Emitido quando algum item do breadcrumb é clicado
-  */
+   * Emitido quando algum item do breadcrumb é clicado.
+   */
   clickBreadcrumbItem: EventEmitter<IBreadcrumbItem>;
   /**
-  * Emitido quando o botão voltar é acionado
-  */
+   * Emitido quando o botão "voltar" é acionado.
+   */
   exit: EventEmitter<void>;
   /**
-   * 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"
+   */
   private getMessage;
   componentDidLoad(): void;
   render(): any;