@sankhyalabs/ezui 7.3.2 → 7.3.3-rc.1

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

@@ -13,14 +13,20 @@ export declare class EzClassicInput {
   label?: string;
   /** Texto de ajuda exibido abaixo do input */
   helpText?: string;
+  /** Texto de erro exibido abaixo do input */
+  errorMessage?: string;
   /** Placeholder do input */
   placeholder?: string;
   /** Define se o input está habilitado */
   enabled?: boolean;
   /** Define se o input é somente leitura */
   readonly?: boolean;
+  /** Define se o input é obrigatório (visualmente) */
+  required?: boolean;
   /** Nome do input */
   name?: string;
+  /** Tamanho do input */
+  size?: "default" | "small" | "xsmall";
   /** Tamanho mínimo do valor */
   minlength?: number;
   /** Tamanho máximo do valor */
@@ -74,12 +80,29 @@ export declare class EzClassicInput {
    */
   setBlur(): Promise<void>;
   syncValue(): Promise<void>;
+  observeErrorMessage(newValue: string): Promise<void>;
   private onInput;
+  private processInputWithMask;
+  private processCgcCpfMask;
+  private processRegularMask;
+  private isDataChar;
+  private countDataCharsBefore;
+  private skipLeadingSeparators;
+  private findPositionAfterDataChars;
+  private getCursorPositionAfterFormat;
+  private restoreCursorSelection;
+  private updateInputValue;
+  private updateInputValueWithoutMask;
   private onBlur;
   private onFocus;
   private handleIconClick;
   private addInfoId;
-  componentWillLoad(): void;
+  private buildPlaceholder;
+  private buildMaskFormatter;
+  private getMaskToBuilder;
+  private getPhoneMask;
+  private getCGCCpfMask;
+  componentDidRender(): void;
   componentDidLoad(): void;
   render(): any;
 }

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

@@ -0,0 +1,101 @@
+import { WaitingChange } from "@sankhyalabs/core";
+import { EventEmitter } from "../../stencil-public-runtime";
+import { OptionsSetFocus } from "../ez-classic-input/interfaces/optionsSetFocus";
+export declare class EzClassicNumberInput {
+  private _textInput;
+  private _focused;
+  private _changePending;
+  private _valuePromiseCallbacks;
+  private i18n;
+  private _elem;
+  private _value;
+  /**
+   * Emitido quando acontece a alteração de valor do campo.
+   */
+  ezChange: EventEmitter<number>;
+  /**
+   * Emitido ao iniciar a alteração (digitação incompleta).
+   */
+  ezStartChange: EventEmitter<WaitingChange>;
+  /**
+   * Emitido quando não foi possível completar a alteração entre o evento ezStartChange e ezChange.
+   */
+  ezCancelWaitingChange: EventEmitter<void>;
+  /**
+  * Texto a ser apresentado como título do campo.
+  */
+  label: string;
+  /**
+   * Define o valor do campo.
+   */
+  value: number;
+  /**
+   * Se false, o usuário não pode interagir com o campo.
+   */
+  enabled: boolean;
+  /** Define se o input é obrigatório (visualmente) */
+  required?: boolean;
+  /**
+   * Se false deixa de exibir a mensagem de erro dentro do campo.
+   */
+  canShowError: boolean;
+  /**
+   * Define uma mensagem de orientação ao usuário, colocando o campo em modo inválido.
+   */
+  errorMessage: string;
+  /**
+   * Se false, o input não aceitará números negativos.
+   */
+  allowNegative: boolean;
+  /**
+   * Define quantas casas decimais serão exibidas. Caso haja mais casas haverá arredondamento.
+   */
+  precision: number;
+  /**
+   * Define qual é o mínimo de casas depois da vírgula.
+   * Exemplo: 1,1 será exibido como 1,1000 quando `prettyPrecision = 4`.
+   */
+  prettyPrecision: number;
+  /**
+   * Define o tamanho do campo.
+   */
+  mode: "slim" | "regular";
+  /** Tamanho do input */
+  size?: "default" | "small" | "xsmall";
+  /**   * Se true o campo de texto receberá o foco ao ser renderizado.
+  */
+  autoFocus: boolean;
+  /**
+   * Texto alternativo a ser apresentado como título do campo.
+   */
+  alternativePlaceholder: string;
+  /**
+   * Aplica o foco no campo.
+   */
+  setFocus(options?: OptionsSetFocus): Promise<void>;
+  /**
+   * Remove o foco do campo.
+   */
+  setBlur(): Promise<void>;
+  /**
+   * Retorna se o conteúdo é inválido.
+   */
+  isInvalid(): Promise<boolean>;
+  getValueAsync(): Promise<number>;
+  observeLabel(): void;
+  observeErrorMessage(): void;
+  observeValue(newValue: number, oldValue: number): void;
+  observePrecision(): void;
+  private handleNewValue;
+  private validateValue;
+  private getTextValue;
+  private changeValue;
+  private setError;
+  private handleBlur;
+  private handleInput;
+  private getParsedNumber;
+  private setInputValue;
+  componentWillLoad(): Promise<void>;
+  componentDidLoad(): void;
+  render(): any;
+}

package/dist/types/components/ez-classic-search/ez-classic-search.d.ts

@@ -0,0 +1,219 @@
+import { EventEmitter } from "../../stencil-public-runtime";
+import { IEzCheckBoxListPosition } from '../ez-combo-box/ez-combo-box';
+import { SearchMode } from "../../utils";
+import { OptionsSetFocus } from "../ez-classic-input/interfaces/optionsSetFocus";
+export declare class EzClassicSearch {
+  private _textInput;
+  private _classicSearchList;
+  private _optionsList;
+  private _ezPopOverPlusElement;
+  private _itemValueBasis;
+  private _source;
+  private _changeDeboucingTimeout;
+  private _limitCharsToSearch;
+  private _deboucingTime;
+  _maxWidthValue: number;
+  private _tabPressed;
+  private _resizeObserver;
+  private _intersectionObserver;
+  private _startHighlightTag;
+  private _endHighlightTag;
+  private _currentValue;
+  private i18n;
+  private el;
+  private _preSelection;
+  private _visibleOptions;
+  private _startLoading;
+  private _showLoading;
+  private _criteria;
+  /**
+   * Define o valor do campo.
+   */
+  value: IOption | string;
+  /**
+   * Texto a ser apresentado como título do campo.
+   */
+  label: string;
+  /**
+   * Se false o usuário não pode interagir com o campo.
+   */
+  enabled: boolean;
+  /**
+   * Define uma mensagem de orientação ao usuário, colocando o campo em modo inválido.
+   */
+  errorMessage: string;
+  /** Tamanho do input */
+  size?: "default" | "small" | "xsmall";
+  /**
+   * Carrega as opções dinamicamente.
+   */
+  optionLoader: (argument: ISearchArgument, ctxProperties?: any) => Promise<Array<IOption>> | Array<IOption> | IOption;
+  /**
+   * Propriedades de contexto da aplicação.
+   */
+  contextProperties?: any;
+  /**
+   * Se false a opção selecionada deve exibir somente o `label`.
+   */
+  showSelectedValue: boolean;
+  /**
+   * Se false cada opção na lista deve exibir somente o `label`.
+   */
+  showOptionValue: boolean;
+  /**
+   * Se true remove a opção vazia da lista.
+   */
+  suppressEmptyOption: boolean;
+  /**
+   * Se true, ineterrompe a propagação do evento de KeyDown da tecla enter
+   */
+  stopPropagateEnterKeyEvent: boolean;
+  /**
+   * Define o tamanho do campo.
+   */
+  mode: "slim" | "regular";
+  /**
+   * Se true, muda o tipo do text-input para classic.
+   */
+  classic: boolean;
+  /** Define se o campo é obrigatório */
+  required?: boolean;
+  /**
+   * Se false deixa de exibir a mensagem de erro dentro do campo.
+   */
+  canShowError: boolean;
+  /**
+   * Quando verdadeiro deixa de exibir a mensagem de erro (se existente) quando focar em um elemento diferente.
+   */
+  hideErrorOnFocusOut: boolean;
+  /**
+   * Define um posicionamento fixo para a lista de opções do CheckBox.
+   */
+  listOptionsPosition: IEzCheckBoxListPosition;
+  /**
+   * Informa se a pesquisa é do tipo texto.
+   */
+  isTextSearch: boolean;
+  /**
+   * Define se deve ignorar o limite de caracteres mínimo para realizar uma pesquisa
+   */
+  ignoreLimitCharsToSearch: boolean;
+  /**
+   * Emitido quando acontece a alteração de valor do campo.
+   */
+  ezChange: EventEmitter<IOption>;
+  /**
+   * Array com as opções do ez-combo-box. Os elementos devem obedecer
+   * o formato: `{value: string, label: string}`.
+   */
+  options: Array<IOption>;
+  /**
+   * Se true desabilita a digitação dentro do componente.
+   */
+  suppressSearch: boolean;
+  /**
+   * Garante que o botão de limpar pesquisa está sempre visível
+   */
+  ensureClearButtonVisible: boolean;
+  /**
+   * Se true, desabilita pré-load das opções ao carregar componente
+   */
+  suppressPreLoad: boolean;
+  /**
+   * Se true o campo de texto receberá o foco ao ser renderizado.
+   */
+  autoFocus: boolean;
+  /**
+   * Texto alternativo a ser apresentado como título do campo.
+   */
+  alternativePlaceholder: string;
+  /**
+   * Informa se deve exibir a opção de mostrar mais resultados.
+   */
+  showMore: boolean;
+  /**
+   * Informa se o valor da opção selecionada deve persistir no input de texto.
+   */
+  suppressInputPersist: boolean;
+  /**
+   * Se true o campo de de apresentação não será exibido.
+   */
+  hideDescriptionInput: boolean;
+  observeErrorMessage(): void;
+  private getValue;
+  private validateNewValue;
+  observeValue(newValue: IOption | string, oldValue: IOption | string): Promise<void>;
+  observeOptions(newOptions: IOption[], oldOptions: IOption[]): void;
+  getValueAsync(): Promise<unknown>;
+  /**
+   * Aplica o foco no campo.
+   */
+  setFocus(options?: OptionsSetFocus): Promise<void>;
+  /**
+   * Remove o foco do campo.
+   */
+  setBlur(): Promise<void>;
+  /**
+   * Retorna se o conteúdo é inválido.
+   */
+  isInvalid(): Promise<boolean>;
+  /**
+   * Limpa o valor do campo de pesquisa
+   */
+  clearValue(): Promise<void>;
+  private handleValueAsString;
+  private isDifferentValues;
+  private getFormattedText;
+  private getText;
+  private getSelectedOption;
+  private updateVisibleOptions;
+  private getMaxWidthValue;
+  private getWidthValue;
+  private showOptions;
+  private hideOptions;
+  private isOptionsVisible;
+  private selectCurrentOption;
+  private updateSource;
+  private clearSource;
+  private selectOption;
+  private loadOptions;
+  private cancelPreselection;
+  private setInputValue;
+  private clearSearch;
+  private controlListWithOnlyOne;
+  private controlEmptySearch;
+  private loadDescriptionValue;
+  private setDescriptionValue;
+  private setTextInputValue;
+  private loadOptionValue;
+  private showNoResultMessage;
+  private getFieldLabel;
+  private resetOptions;
+  private handleResetOptionsWithShowMoreVisible;
+  private handleInitialValue;
+  componentWillLoad(): Promise<void>;
+  componentDidRender(): void;
+  componentDidLoad(): Promise<void>;
+  disconnectedCallback(): void;
+  private handleClassicIconClick;
+  private buildNumberArgument;
+  private onTextInputChangeHandler;
+  private clearDeboucingTimeout;
+  private keyDownHandler;
+  private handleEventPropagation;
+  private onTextInputFocusOutHandler;
+  private canShowListOptions;
+  private onChangePreSelection;
+  private handleClickShowMore;
+  private renderShowMore;
+  render(): any;
+}
+export interface IOption {
+  value: string;
+  label: string;
+  details?: any;
+}
+export interface ISearchArgument {
+  mode: SearchMode;
+  argument: string;
+}

package/dist/types/components/ez-classic-search/subcomponent/classic-search-list/classic-search-list.d.ts

@@ -0,0 +1,29 @@
+import { EventEmitter } from '../../../../stencil-public-runtime';
+import { IOption } from '../../ez-classic-search';
+export declare class ClassicSearchList {
+  private _startHighlightTag;
+  private _endHighlightTag;
+  private _optionsList;
+  private readonly MAX_HEIGHT;
+  private readonly HEADER_MENU_HEIGHT;
+  showLoading: boolean;
+  visibleOptions: Array<IOption>;
+  textEmptyList: string;
+  canShowListOptions: boolean;
+  value: IOption | string;
+  showOptionValue: boolean;
+  preSelection: number;
+  changeValue: EventEmitter<IOption>;
+  changePreSelection: EventEmitter<number>;
+  nextOption(): Promise<void>;
+  previousOption(): Promise<void>;
+  private selectOption;
+  private createOption;
+  private scrollToOption;
+  private buildItem;
+  componentDidLoad(): void;
+  componentDidUpdate(): void;
+  private adjustMaxHeight;
+  private cleanEmptyObjectArray;
+  render(): any;
+}

package/dist/types/components/ez-classic-search/utils/searchFormatters.d.ts

@@ -0,0 +1,2 @@
+export declare function replaceHighlight(value: string): string;
+export declare function replaceQuotes(text: string): string;

package/dist/types/components/ez-classic-search-plus/ez-classic-search-plus.d.ts

@@ -0,0 +1,189 @@
+import { EventEmitter } from "../../stencil-public-runtime";
+import { ISearchOption, SearchMode } from "../../utils";
+import { IEzCheckBoxListPosition } from "../ez-combo-box/ez-combo-box";
+import { OptionsSetFocus } from "../ez-classic-input/interfaces/optionsSetFocus";
+export declare class EzClassicSearchPlus {
+  private readonly SEARCH_DESCRIPTION_TIMEOUT;
+  private readonly INTERVAL_TO_RETRY_ASYNC_VALUE;
+  private _textInputDescriptionValue;
+  private _textInputCodeValue;
+  private _popover;
+  private _classicSearchList;
+  private _debounceSearch;
+  private _latestFocusedInputElement;
+  private _keyboardManager;
+  private _ignoreNextValue;
+  private i18n;
+  private el;
+  /**
+  * Emitido quando acontece a alteração de valor do campo.
+  */
+  ezChange: EventEmitter<IOption>;
+  /**
+   * Define o valor do campo.
+   */
+  value: IOption | string;
+  /**
+   * Se false o usuário não pode interagir com o campo.
+   */
+  enabled: boolean;
+  /**
+   * Se true o campo de código ficara desabilitado.
+   */
+  disableCodeInput: boolean;
+  /**
+   * Se true o campo de de apresentação ficara desabilitado.
+   */
+  disableDescriptionInput: boolean;
+  /**
+   * Texto a ser apresentado como título do campo.
+   */
+  label: string;
+  /**
+   * Se true o campo de de apresentação não será exibido.
+   */
+  hideDescriptionInput: boolean;
+  /**
+   * Se false deixa de exibir a mensagem de erro dentro do campo.
+   */
+  canShowError: boolean;
+  /**
+   * Define uma mensagem de orientação ao usuário, colocando o campo em modo inválido.
+   */
+  errorMessage: string;
+  /**
+  * Define o tamanho do campo.
+  */
+  mode: "slim" | "regular";
+  /** Tamanho do input */
+  size?: "default" | "small" | "xsmall";
+  /** Define se o campo é obrigatório */
+  required?: boolean;
+  /**
+  * Propriedades de contexto da aplicação.
+  */
+  contextProperties?: any;
+  /**
+   * Carrega as opções dinamicamente.
+   */
+  optionLoader: OptionLoaderFunction;
+  /**
+   * Se false cada opção na lista deve exibir somente o `label`.
+   */
+  showOptionValue: boolean;
+  /**
+   * Se true, interrompe a propagação do evento de KeyDown da tecla enter
+   */
+  stopPropagateEnterKeyEvent: boolean;
+  /**
+  * Se true o campo de texto receberá o foco ao ser renderizado.
+  */
+  autoFocus: boolean;
+  /**
+  * Propriedade depreciada na nova versão do componente de pesquisa.
+  */
+  showSelectedValue: boolean;
+  /**
+  * Propriedade depreciada na nova versão do componente de pesquisa.
+  */
+  suppressEmptyOption: boolean;
+  /**
+   * Propriedade depreciada na nova versão do componente de pesquisa.
+   */
+  hideErrorOnFocusOut: boolean;
+  /**
+   * Propriedade depreciada na nova versão do componente de pesquisa.
+   */
+  listOptionsPosition: IEzCheckBoxListPosition;
+  /**
+   * Propriedade depreciada na nova versão do componente de pesquisa.
+   */
+  isTextSearch: boolean;
+  /**
+   * Propriedade depreciada na nova versão do componente de pesquisa.
+   */
+  ignoreLimitCharsToSearch: boolean;
+  /**
+   * Propriedade depreciada na nova versão do componente de pesquisa.
+   */
+  suppressSearch: boolean;
+  /**
+  * Propriedade depreciada na nova versão do componente de pesquisa.
+  */
+  suppressPreLoad: boolean;
+  /**
+  * Garante que o botão de limpar pesquisa está sempre visível
+  */
+  ensureClearButtonVisible: boolean;
+  private descriptionValue;
+  private codeValue;
+  private isLoadingDescription;
+  private searchDescriptionIsOpen;
+  private visibleOptions;
+  private showLoading;
+  private canShowClearButton;
+  private isHoveringDescription;
+  observeValue(newValue: IOption | string, oldValue: IOption | string): Promise<void>;
+  /**
+   * Aplica o foco no campo.
+   */
+  setFocus(options?: OptionsSetFocus): Promise<void>;
+  /**
+  * Obtém o valor do componente só após a compo de apresentação
+  * ter sido resolvido pelo option loader quando necessário
+  */
+  getValueAsync(): Promise<IOption>;
+  /**
+  * Limpa o valor do campo de pesquisa
+  */
+  clearValue(): Promise<void>;
+  /**
+  * Remove o foco do campo.
+  */
+  setBlur(): Promise<void>;
+  /**
+  * Retorna se o conteúdo é inválido.
+  */
+  isInvalid(): Promise<boolean>;
+  componentWillLoad(): Promise<void>;
+  componentDidLoad(): void;
+  connectedCallback(): void;
+  private clearSearch;
+  private normalizeCodeToDescriptionValue;
+  private normalizeValueToCodeValue;
+  private loadDescriptionValueByCode;
+  private handleCodeInputFocusOut;
+  private handleSearchClick;
+  private loadAdvancedSearch;
+  private buildCurrentValue;
+  private handleTextInputChangeHandler;
+  private debounceLoaderOptions;
+  private updateKeyOption;
+  private parseSearchOptions;
+  private processOptionsLoader;
+  private handleSelectItem;
+  private handleArrowUp;
+  private handleArrowDown;
+  private selectCurrentItem;
+  private cancelSelection;
+  private handleInputTab;
+  private handleInputEsc;
+  private initKeyboardManager;
+  disconnectedCallback(): void;
+  private isOptionsVisible;
+  private setLatestFocusedInputElement;
+  private handleCodeInputFocus;
+  private handleDescriptionInputFocus;
+  private handleOnEzVisibilityChange;
+  private getClearButtonStatus;
+  render(): any;
+}
+export interface IOption {
+  value: string;
+  label: string;
+}
+export interface ISearchArgument {
+  mode: SearchMode;
+  argument: string;
+}
+export type OptionLoaderFunction = (argument: ISearchArgument, ctxProperties?: any) => Promise<Array<IOption | ISearchOption> | IOption | ISearchOption> | Array<ISearchOption | IOption> | IOption | ISearchOption;

package/dist/types/components/ez-classic-search-plus/subcomponent/ez-search-result-list/ez-classic-search-result-list.d.ts

@@ -0,0 +1,29 @@
+import { EventEmitter } from '../../../../stencil-public-runtime';
+import { IOption } from '../../ez-classic-search-plus';
+export declare class EzClassicSearchResultList {
+  private readonly _startHighlightTag;
+  private readonly _endHighlightTag;
+  private _optionsList;
+  private i18n;
+  showLoading: boolean;
+  visibleOptions: Array<IOption>;
+  value: IOption | string;
+  showOptionValue: boolean;
+  changeValue: EventEmitter<IOption>;
+  _preSelection: number;
+  observerVisivleOptions(newValue: Array<IOption>): void;
+  nextOption(): Promise<void>;
+  previousOption(): Promise<void>;
+  private preSelectItemByIndex;
+  private selectOption;
+  private removeHighLight;
+  private createAndSelectOption;
+  private scrollToOption;
+  private buildItem;
+  selectCurrentItem(): Promise<void>;
+  cancelSelection(): Promise<void>;
+  private cancelPreselection;
+  private canShowListOptions;
+  componentWillLoad(): Promise<void>;
+  render(): any;
+}

package/dist/types/components/ez-classic-text-area/ez-classic-text-area.d.ts

@@ -13,6 +13,8 @@ export declare class EzClassicTextArea {
   value?: string;
   /** Texto de ajuda exibido abaixo da textarea */
   helpText?: string;
+  /** Define uma mensagem de orientação ao usuário, colocando o campo em modo inválido */
+  errorMessage?: string;
   /** Estado visual da textarea: default, error, success ou warning */
   state?: "default" | "error" | "success" | "warning";
   /** Define se a textarea está habilitada */
@@ -52,6 +54,7 @@ export declare class EzClassicTextArea {
   setFocus(option?: OptionsSetFocus): Promise<void>;
   /** Remove o foco do campo. */
   setBlur(): Promise<void>;
+  observeErrorMessage(newValue: string): Promise<void>;
   private onBlur;
   private handleInput;
   private handleIconClick;

package/dist/types/components/ez-empty-card/ez-empty-card.d.ts

@@ -8,11 +8,11 @@ export declare class EzEmptyCard {
   /**
    * Define o tamanho do componente, sobrescrevendo o padrão da propriedade size.
    */
-  height?: number;
+  height?: number | string;
   /**
    * Define a largura do componente, sobrescrevendo o padrão da propriedade size.
    */
-  width?: number;
+  width?: number | string;
   componentDidRender(): void;
   render(): any;
 }

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

@@ -4,6 +4,7 @@ import { ICustomEditor } from "../../utils/customEditor/interfaces/ICustomEditor
 import { IFieldConfig, IFormConfig, IRecordValidator } from '../../utils/form/interfaces';
 import { FormItems } from "../ez-form-view/structure";
 import { Tab } from "../ez-tabselector/ez-tabselector";
+import { UiFieldBuilders } from "../ez-form-view/fieldbuilder/FieldBuilder";
 export declare class EzForm {
   private _element;
   private _formView;
@@ -19,6 +20,7 @@ export declare class EzForm {
   private _i18n;
   private _fieldsProps;
   private _singleColumn;
+  private _formLayout;
   /**
    * Unidade de dados. Responsável pelo controle de edição de registros e
    * informações pertinentes aos campos.
@@ -48,6 +50,10 @@ export declare class EzForm {
    * Define uma ancoragem
    */
   elementFocusSearchField: HTMLElement;
+  /**
+   * Define construtores customizados para tipos de campos específicos
+   */
+  customUiBuilders: UiFieldBuilders;
   /**
    * Emitido quando o campo recebe foco
    */