@sankhyalabs/ezui 1.1.76 → 1.1.77

package/dist/types/components/ez-grid/controller/EzGridController.d.ts

@@ -0,0 +1,195 @@
+import { DataUnit } from "@sankhyalabs/core";
+/**
+ * O intuito desta abstração, é isolar o componente EzGrid de uma implementação
+ * específica, permitindo que usemos componentes de terceiros sem um acoplamento
+ * direto.
+ * Isso permitirá que no futuro possamos trocar a implementação usada sem prejuízo
+ * às aplicações que o usam.
+ *
+ * IMPORTANTE: Como consumidores de API de terceiros precisamos manter toda e qualquer
+ * funcionalidade abstrata, ou seja, se o componente usa determinada funcionalidade da
+ * implementação de referência essa funcionalidade deve estar COMPLETAMENTE abstraída
+ * pelo controller, sob pena de inviabilizar a troca da implementação usada.
+ */
+export default interface EzGridController {
+  /**
+   * Chamado pelo EzGrid para criar os elementos DOM da grade.
+   * @param container - O elemento que será usado como host para construir a grade.
+   * @param options - A contextualização dessa instância de grade.
+  */
+  initDatagrid(container: HTMLElement, options: EzGridOptions): void;
+  /**
+   * Método responsável por receber a definição das colunas.
+   * @param cols - Array contendo a definição de todas as colunas.
+   * @param showCheckSelection - Quando true adiciona uma coluna extra na grade,
+   * para controlar a seleção.
+   */
+  setColumnsDef(cols: Array<EzGridColumn>, showCheckSelection: boolean): void;
+  /**
+  * Retorna a definição das colunas.
+  * @return - Array contendo as definições de cada coluna.
+  */
+  getColumnsDef(): Array<EzGridColumn>;
+  /**
+   * Recebe o estado das colunas. Geralmente o estado pode ser persistido separadamete
+   * da definição básica da coluna. Nesse caso esse método o recebe e aplica.
+   * @param state - Array contendo as informações de estado de cada coluna.
+   */
+  setColumnsState(state: Array<EzGridColumn>): void;
+  /**
+   * Retorna o estado das colunas.
+   * @return - Array contendo as informações de estado de cada coluna.
+   */
+  getColumnsState(): Array<EzGridColumn>;
+  /**
+   * Seleção de linhas.
+   * @returns Retorna um array com a(s) linha(s) selecionada(s).
+   */
+  getSelection(): Array<any>;
+  /**
+   * Adiciona um item de menu a ser colocado no cabeçalho das colunas.
+   * @param item - A definição do item que deve ser inserido no menu.
+   */
+  addColumnMenuItem(item: EzGridColumnMenuItemDef): void;
+  /**
+   * Método responsável por atribuir o array de linhas da grade.
+   * @param data - Array contendo objetos json que representam
+   * as linhas da grade (os dados propriamente ditos).
+   */
+  setData(data: Array<any>): void;
+  /**
+   * Quando no modo paginado, aciona o carregamento da próxima página
+   */
+  nextPage(): void;
+  /**
+   * Quando no modo paginado, aciona o carregamento da página anterior
+   */
+  previousPage(): void;
+}
+/**
+ * Carrega as informações necessárias para contextualizar corretamente a instância.
+ */
+export interface EzGridOptions {
+  /**
+   * Callback a ser chamado quando algum atributo das colunas é alterado.
+   */
+  onColumnStateChange: Function;
+  /**
+   * Callback a ser chamado quando as linhas selecionadas mudam.
+   */
+  onSelectionChange: Function;
+  /**
+  * Callback para reagir à paginação
+  */
+  onPaginationChange: Function;
+  /**
+   * Usado para permitir múltipla seleção.
+   */
+  allowMultipleSelection: boolean;
+  /**
+   * Determina o número de linhas de cada página. Caso informado o valor -1
+   * não haverá paginação.
+   */
+  pageSize: number;
+  /**
+   * Endereço do servidor para buscar os dados.
+   */
+  serverURL: string;
+  dataUnit: DataUnit;
+}
+/**
+ * Representa cada coluna da grade.
+ */
+export interface EzGridColumn {
+  /**
+   * Texto exibido no cabeçalho da coluna.
+   */
+  label: string;
+  /**
+   * ID da coluna. Em cada linha do array de dados, esse ID deve coincidir com
+   * o nome do atributo que a coluna representa.
+   */
+  name: string;
+  /**
+   * [Opcional] Representa a ordenação da coluna. Pode variar entre ASC e DESC
+   */
+  sort?: string;
+  /**
+   * [Opcional] Número inteiro positivo que representa a sequência de ordenação.
+   * Importante quando há ordenação por mais de uma coluna.
+   */
+  sortIndex?: number;
+  /**
+   * [Opcional] Largura da coluna em pixels absolutos.
+   */
+  width?: number;
+  /**
+   * [Opcional] Indica que a coluna está fixada.
+   */
+  pinned?: boolean;
+  /**
+   * [Opcional] Indica que a coluna não está visível.
+   */
+  hidden?: boolean;
+}
+/**
+ * Interface utilizada para se inserir menus personalizados no cabeçalho das colunas.
+ */
+export interface EzGridColumnMenuItemDef {
+  /**
+   * Texto exibido no item de menu.
+   */
+  label: string;
+  /**
+   * Identificador do item de menu. Esse valor será disponibilizado junto com o ID da
+   * coluna ao disparar a ação respectiva.
+   */
+  name: string;
+  /**
+   * Ação executada quando o usuário aciona o menu.
+   */
+  action: Function;
+}
+/**
+ * Evento de alteração de estado. Sempre que o estado das colunas for alterado, esse evento é disparado.
+ */
+export interface EzGridColumStateEvent {
+  /**
+   * Tipo de alteração de estado ["sort", "columnResize", "columnPinned", "columnMoved", "visibleChange"].
+   */
+  type: string;
+  /**
+   * O estado de todas as colunas depois da alteração. Usado para persistir o novo estado.
+   */
+  state: Array<EzGridColumn>;
+}
+/**
+ * Sempre que há alterações na paginação, o grid controller passará esse status através do
+ * callback "onPaginationChange" para o host (EzGrid) reagir.
+ */
+export interface EzGridPaginationStatus {
+  /**
+   * Se existe página anterior.
+   */
+  hasPrevious: boolean;
+  /**
+   * Se existe próxima página.
+   */
+  hasNext: boolean;
+  /**
+   * Número da página atual.
+   */
+  currentPage: number;
+  /**
+   * Número da primeira linha da página.
+   */
+  pageStart: number;
+  /**
+   * Número da última linha da página.
+   */
+  pageEnd: number;
+  /**
+   * Número total de linhas.
+   */
+  totalRows: number;
+}

package/dist/types/components/ez-grid/controller/ag-grid/AgGridController.d.ts

@@ -0,0 +1,34 @@
+import EzGridController, { EzGridColumn, EzGridColumnMenuItemDef, EzGridOptions } from "../EzGridController";
+export default class AgGridController implements EzGridController {
+  private _grid;
+  private _gridOptions;
+  private _columnStateChangeCallback;
+  private _selectionChangeCallback;
+  private _paginationChangeCallback;
+  private _enterprise;
+  private _menuItems;
+  private _multipleSelection;
+  private _pageSize;
+  private _serverURL;
+  private _dataUnit;
+  constructor(enterprise: boolean);
+  initDatagrid(container: HTMLElement, options: EzGridOptions): void;
+  private setOptionsEvents;
+  private setOptionsPagination;
+  private setOptionsSupress;
+  setData(data: Array<any>): void;
+  setColumnsDef(cols: Array<EzGridColumn>, showCheckSelection: boolean): void;
+  getColumnsDef(): Array<EzGridColumn>;
+  setColumnsState(state: Array<EzGridColumn>): void;
+  getColumnsState(): Array<EzGridColumn>;
+  getSelection(): Array<any>;
+  addColumnMenuItem(item: EzGridColumnMenuItemDef): void;
+  nextPage(): void;
+  previousPage(): void;
+  private buildColDef;
+  private buildColState;
+  private onCallStateChange;
+  private onSelectionChange;
+  private onPaginationChange;
+  private conditionalSet;
+}

package/dist/types/components/ez-grid/controller/ag-grid/DataSource.d.ts

@@ -0,0 +1,11 @@
+import { IServerSideDatasource, IServerSideGetRowsParams } from "ag-grid-community";
+import { DataUnit } from "@sankhyalabs/core";
+export default class DataSource implements IServerSideDatasource {
+  private _serverURL;
+  private _dataUnit;
+  private _useMockedServer;
+  private _mockedServer;
+  constructor(dataUnit: DataUnit, serverURL: string);
+  getRows(params: IServerSideGetRowsParams): void;
+  private loadData;
+}

package/dist/types/components/ez-grid/controller/ag-grid/i18n/pt-BR.d.ts

@@ -0,0 +1,2 @@
+declare const gridTerms: any;
+export default gridTerms;

package/dist/types/components/ez-grid/controller/ag-grid/mock/Server.d.ts

@@ -0,0 +1,8 @@
+import { IServerSideGetRowsRequest, LoadSuccessParams } from "ag-grid-community";
+export default class Server {
+  private _data;
+  constructor(data: Array<any>);
+  getData(request: IServerSideGetRowsRequest): LoadSuccessParams;
+  private filter;
+  private sort;
+}

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

@@ -0,0 +1,78 @@
+import { EventEmitter } from "../../stencil-public-runtime";
+import EzGridController, { EzGridColumn, EzGridColumStateEvent } from "./controller/EzGridController";
+import { DataUnit } from "@sankhyalabs/core";
+import DataUnitBridge from "./controller/DataUnitBridge";
+export declare class EzGrid {
+  _gridConfig: HTMLGridConfigElement;
+  _container: HTMLElement;
+  _gridController: EzGridController;
+  _dataUnitBridge: DataUnitBridge;
+  private _navigationHasPrevious;
+  private _navigationHasNext;
+  private _navigationFirstRow;
+  private _navigationLastRow;
+  private _navigationTotalRows;
+  private _popUpVisible;
+  /**
+  * Evento disparado ao mudar o estado das colunas do grid. Ordenação, largura, etc.
+  */
+  ezColumnStateChange: EventEmitter<EzGridColumStateEvent>;
+  /**
+  * Evento disparado ao selecionar linhas da grade.
+  */
+  ezSelectionChange: EventEmitter<Array<any>>;
+  /**
+  * Habilita a seleção de várias linhas
+  */
+  multipleSelection: boolean;
+  /**
+  * Determina o número de linhas de cada página. Caso informado o valor -1
+  * não haverá paginação.
+  */
+  pageSize: number;
+  /**
+   * Endereço do servidor. Se informado, o próprio datagrid controlará a obtenção
+   * dos dados, anulando a necessidade de acionar o método "setData(data)"
+   */
+  serverUrl: string;
+  /**
+   *
+   */
+  dataUnit: DataUnit;
+  /**
+  * Método responsável por receber a definição das colunas
+  */
+  setColumnsDef(cols: Array<EzGridColumn>): Promise<any>;
+  /**
+  * Adiciona item de menu nas colunas.
+  */
+  addColumnMenuItem(label: string, name: string, action: Function): Promise<any>;
+  /**
+  * Método responsável por aplicar estado pré-existente nas colunas do grid.
+  */
+  setColumnsState(state: Array<EzGridColumn>): Promise<any>;
+  /**
+  * Método de carga dos registros. Os objetos deste array devem conter atributos
+  * para as colunas desejadas.
+  */
+  setData(data: Array<any>): Promise<any>;
+  /**
+  * Retorna as linhas selecionadas na grade.
+  */
+  getSelection(): Promise<Array<any>>;
+  /**
+  * Método retornar o estado atual das colunas do grid.
+  */
+  getColumnsState(): Promise<Array<EzGridColumn>>;
+  /**
+  * Método retornar o estado atual das colunas do grid.
+  */
+  getColumns(): Promise<Array<EzGridColumn>>;
+  componentWillLoad(): void;
+  componentDidLoad(): void;
+  getPaginationControl(): Array<HTMLElement>;
+  applyConfig(cols: Array<EzGridColumn>): void;
+  closeConfig(): void;
+  openConfig(): void;
+  render(): any;
+}

package/dist/types/components/ez-grid/subcomponents/gridconfig/grid-config.d.ts

@@ -0,0 +1,30 @@
+import { EventEmitter } from '../../../../stencil-public-runtime';
+import { EzGridColumn } from '../../controller/EzGridController';
+export declare class GridConfig {
+  private _columnList;
+  private _orderList;
+  private _searchElement;
+  private _columnListHistory;
+  private _orderListItems;
+  private _columListItems;
+  selectedTab: string;
+  private _selectedIndex;
+  columns: Array<EzGridColumn>;
+  configFinish: EventEmitter<Array<EzGridColumn>>;
+  configCancel: EventEmitter<void>;
+  private createOrderList;
+  private createColumnList;
+  private buildColumnListSlot;
+  private buildOrderListSlot;
+  private updateOrder;
+  switchColumnGroup(ev: any, switchedItem: any): void;
+  finish(): void;
+  locateColumn(evt: KeyboardEvent, searchingText?: string): Promise<void>;
+  private compareWords;
+  closeConfig(): void;
+  handleTabChange(ev: any): void;
+  handleColumnListChange(ev: any): void;
+  componentWillRender(): void;
+  componentDidRender(): void;
+  render(): any;
+}

package/dist/types/components/ez-grid/subcomponents/select-box/select-box.d.ts

@@ -0,0 +1,9 @@
+import { EventEmitter } from '../../../../stencil-public-runtime';
+export declare class SelectBox {
+  private _selectElem;
+  ezChange: EventEmitter<string>;
+  selectedOption: string;
+  changeSelection(): void;
+  componentDidRender(): void;
+  render(): any;
+}

package/dist/types/components/ez-list/ez-list.d.ts

@@ -1,34 +1,87 @@
+import { EventEmitter } from '../../stencil-public-runtime';
 export interface ListItem {
-  value: string;
-  checked?: boolean;
+  label: string;
+  selected?: boolean;
+}
+export interface ListGroup {
+  group: string;
+  items: ListItem[];
+  sort?: string;
+}
+export interface ListItemGroup {
+  item: ListItem;
+  groupName?: string;
+  index?: number;
 }
 export declare class EzList {
-  private _draggableList;
-  private _hostElement;
-  private _selectedItem;
-  private _listItems;
+  _listItems: ListItem[];
+  _listGroupItems: ListGroup[];
+  private _dragStartItem;
+  private _listItemsHistory;
+  private _groupContainer;
+  private _element;
+  private _itemContainer;
+  private _draggingElement;
   /**
   * Define a lista inicial do componente.
   */
-  initialList: ListItem[];
+  dataSource: any[];
+  /**
+  * Define se o componente renderizará os itens separados em grupos..
+  */
+  useGroups: boolean;
   /**
   * Define se o componente terá o comportamento de arrasto de linhas.
   */
-  draggable: boolean;
+  ezDraggable: boolean;
+  /**
+  * Define se os items da lista serão selecionáveis.
+  */
+  ezSelectable: boolean;
   /**
   * Define se é possível selecionar mais de um registro.
   */
-  isMultipleSelection: boolean;
+  /**
+ * Função responsável por renderizar um conteúdo dentro do item da lista.
+ */
+  itemSlotBuilder: (item: any, group?: any) => HTMLElement;
   createList(): void;
-  selectLine(e: any): void;
-  handleEventListeners(listItems: any, dragableList: any, hostElement: any, removeEvents: any): void;
   /**
-  *  Retorna      uma promessa com o estado da atual lista composta por objetos do tipo {value: string, checked: boolean}.
+ * Evento disparado ao modificar ordenação nas linhas da grade.
+ */
+  ezChange: EventEmitter<ListItem[] | ListGroup[]>;
+  private sortGroup;
+  /**
+  * Recebe   como argumento um ListItem {label: string} e um booleano que define se o componente deve fazer scroll para exibir o item específico (opcional).
   */
-  getState(): Promise<ListItem[]>;
-  getChecked(item: any): any;
-  getValueItem(item: any): any;
-  componentDidLoad(): void;
-  disconnectedCallback(): void;
+  setSelection(selectedItem: ListItem, scrollToOption?: boolean): Promise<void>;
+  removeSelection(): void;
+  /**
+   * Retorna   o item selecionado.
+  */
+  getSelection(): Promise<any>;
+  /**
+   * Retorna   a lista de items conforme o modo de uso.
+   */
+  getList(): Promise<ListItem[] | ListGroup[]>;
+  componentWillLoad(): void;
+  componentWillRender(): void;
+  onDrop(ev: any, dragEndItem: ListItemGroup): void;
+  onDropGroup(groupSelected: any): void;
+  onDragEnd(): void;
+  addOverClass(ev: any): void;
+  addOverGroupClass(ev: any, group: ListGroup): void;
+  removeOverClass(ev: any): void;
+  removeOverGroupClass(ev: any, group: any): void;
+  onDragStart(event: any, item: any, group?: any, index?: any): void;
+  onDrag(event: any): void;
+  selectFirstItem(): void;
+  nextOption(selectedItem: ListItem): void;
+  previousOption(selectedItem: ListItem): void;
+  private keyDownHandler;
+  getItemId(itemLabel: String): string;
+  getDivGroupId(groupName: String): string;
+  onDragOverGroup(event: DragEvent, group: ListGroup): void;
+  onDragOverItem(event: DragEvent, group?: ListGroup): void;
   render(): any;
 }

package/dist/types/components/ez-number-input/ez-number-input.d.ts

@@ -1,24 +1,22 @@
-import { EventEmitter } from '../../stencil-public-runtime';
-export declare class NumberInput {
-  private _inputElem;
-  private _labelElem;
-  private _messageBoxElem;
-  el: HTMLElement;
+import { EventEmitter } from "../../stencil-public-runtime";
+export declare class EzNumberInput {
+  private _textInput;
+  private _hostElement;
+  private slotElement;
   /**
-   * Valor digitado pelo usuário. Este valor é o que fica visível no campo.
-   */
-  strvalue: string;
+  * Evento disparado quando o estado do componente é alterado (onEzChange).
+  */
+  ezChange: EventEmitter<string>;
   /**
-   * Valor guardado pelo componente. Este valor é o que ira ser utilizado para alimentar o backend.
-   * Esta variável pode ser setada para alimentar o componente.
-   */
-  value: number;
+  * Título do campo
+  */
+  label: string;
   /**
-   * Label é o título do campo
+   * O valor informado pelo usuário
    */
-  label: string;
+  value: string | number;
   /**
-   * Deixa o campo disponível ou não para digitação.
+   * Deixa o campo disponível ou não para uso.
    */
   enabled: boolean;
   /**
@@ -26,15 +24,21 @@ export declare class NumberInput {
    */
   errorMessage: string;
   /**
-   * Precisão de arredondamento do número
+   * Precisão decimal, ou seja, quantas casas decimais podem ser exibidas. Caso a
+   * quantidade de casas decimais do valor seja maior que precision, haverá arredondamento
    */
   precision: number;
   /**
-   * Números de zeros retirados após arredondamento
+   * Esse atributo determina qual é o número mínimo de casas depois da vírgula.
+   * Exemplo: Digamos que a precision seja igual a 4, assim qualquer número será
+   * representado com 4 casas decimais mesmo que iguais a zero: 1,0100.
+   * Se prettiprecision igual a 2, como não há necessidade de mais de duas casas decimais
+   * o valor exibido será 1,01. Por outro lado, até a quarta casa não haverá arredondamento
+   * (1,1234 = 1,1234) mas a partir da quinta casa sim (1,12345 = 1,1235).
    */
-  prettyprecision: number;
+  prettyPrecision: number;
   /**
-   * Deixa o campo disponível ou não para digitação.
+   * Configura o alinhamento do texto.
    */
   textleft: boolean;
   /**
@@ -43,38 +47,17 @@ export declare class NumberInput {
    * Qualquer outro valor que não seja "en-US", adotará a formatação "pt-BR"
    * Não é case sensitive
    */
-  formatnumber: string;
-  /**
-  * Um evento disparado quando o estado do componente é alterado (onEzChange).
-  */
-  ezChange: EventEmitter<{
-    strValue: string;
-    value: number;
-  }>;
-  showError(): void;
+  formatNumber: string;
+  _leftSlotItem: any;
+  _rightSlotItem: any;
+  setLabel(): void;
+  setErrorMessage(): void;
+  applyValueToInput(): void;
   onPrecisionChanged(newPrecision: number): void;
   onPrettyPrecisionChanged(newPrettyPrecision: number): void;
-  onValueChanged(newValue: number): void;
-  adjustFloatingLabel(): void;
-  /**
-   * Faz o foco no componente de input
-   */
-  setFocus(): Promise<void>;
-  /**
-   * Remove o foco no componente de input
-   */
-  setBlur(): Promise<void>;
-  /**
-   * Promove a atualização do componente
-   */
-  handleFocusout(): Promise<void>;
-  handleChange(): void;
-  handleSlotChange(ev: Event): void;
-  doFocus(): void;
-  settingComponent(): void;
-  settingStrValueIntNumber: (strvalue: string) => string;
-  checkNumberValidation: (valuePtBRorNumber: string) => boolean;
-  settingValue(): void;
+  changeValue(newValue: number): void;
+  private parseNumber;
+  private getTextValue;
   componentDidLoad(): void;
   componentWillLoad(): void;
   render(): any;

package/dist/types/components/ez-tabselector/ez-tabselector.d.ts

@@ -22,7 +22,7 @@ export declare class EzTabselector {
    */
   tabs: string;
   /**
-  * Evento emitido ao clicar para abrir o popup (onChange).
+  * Evento emitido ao clicar para abrir o popup (ezChange).
   */
   ezChange: EventEmitter<string>;
   handleTabClick(tab: string, index: number): void;

package/dist/types/components/test-du/test-du.d.ts

@@ -0,0 +1,6 @@
+import { DataUnit } from '@sankhyalabs/core';
+export declare class TestDu {
+  _dataUnit: DataUnit;
+  componentDidLoad(): void;
+  render(): any;
+}