matcha-components 20.276.0 → 20.278.0

package/index.d.ts

@@ -2,7 +2,7 @@ import * as i0 from '@angular/core';
 import { OnInit, OnChanges, EventEmitter, SimpleChanges, AfterContentInit, OnDestroy, QueryList, ElementRef, Renderer2, InjectionToken, ChangeDetectorRef, AfterViewInit, PipeTransform, AfterViewChecked, TemplateRef, NgZone, ApplicationRef, Injector, RendererFactory2, Type, ComponentRef } from '@angular/core';
 import * as i2 from '@angular/common';
 import * as i3 from '@angular/forms';
-import { ControlValueAccessor, FormControlName, Validator, FormControl, ValidationErrors, NgControl, AbstractControl } from '@angular/forms';
+import { ControlValueAccessor, FormControlName, Validator, FormControl, ValidationErrors, NgControl, FormGroup, AbstractControl } from '@angular/forms';
 import * as rxjs from 'rxjs';
 import { Observable, Subject } from 'rxjs';
 import { HttpClient } from '@angular/common/http';
@@ -267,6 +267,18 @@ interface MatchaOptionParent {
      * @param option - A instância do MatchaOptionComponent selecionado
      */
     selectOption(option: any): void;
+    /**
+     * Quando true, as opções renderizam em modo múltiplo (com matcha-checkbox).
+     * Lido pela matcha-option para decidir a renderização já no primeiro ciclo.
+     * Usado por matcha-select-multiple.
+     */
+    multiple?: boolean;
+    /**
+     * Retorna se um value está selecionado (modo múltiplo).
+     * Permite que a matcha-option reflita o estado "marcado" já no primeiro render,
+     * evitando depender de atualização imperativa posterior.
+     */
+    isSelected?(value: any): boolean;
 }
 /**
  * Token de injeção para MatchaOptionParent
@@ -278,6 +290,27 @@ declare class MatchaOptionComponent {
     private parent;
     private elRef;
     value: any;
+    /**
+     * Modo múltiplo: renderiza um matcha-checkbox (puramente visual) à esquerda
+     * do conteúdo. Quando não definido explicitamente, é derivado do componente
+     * pai (matcha-select-multiple) — assim o checkbox aparece já no primeiro
+     * render, mesmo quando as opções são reprojetadas de forma assíncrona.
+     */
+    private _multiple;
+    set multiple(value: boolean);
+    get multiple(): boolean;
+    /**
+     * Estado "marcado" exibido no checkbox em modo múltiplo. Derivado do pai
+     * (via isSelected) para refletir corretamente já no primeiro render; cai
+     * para `selected` quando o pai não expõe isSelected.
+     */
+    get checked(): boolean;
+    /**
+     * Destaque de navegação por teclado, independente de `selected`
+     * (que em modo múltiplo representa o estado "marcado/checado").
+     */
+    active: boolean;
+    get multipleClass(): boolean;
     private _disabled;
     get disabled(): boolean;
     set disabled(value: boolean | string);
@@ -293,7 +326,7 @@ declare class MatchaOptionComponent {
     get nativeElement(): HTMLElement;
     getTextContent(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<MatchaOptionComponent, [{ optional: true; }, null]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatchaOptionComponent, "matcha-option", never, { "value": { "alias": "value"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "optionClick": "optionClick"; "optionSelect": "optionSelect"; }, never, ["*"], false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatchaOptionComponent, "matcha-option", never, { "value": { "alias": "value"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "optionClick": "optionClick"; "optionSelect": "optionSelect"; }, never, ["*"], false, never>;
 }
 
 interface PanelPosition {
@@ -481,9 +514,68 @@ declare class MatchaAutocompleteTriggerDirective implements AfterViewInit, OnDes
     static ɵdir: i0.ɵɵDirectiveDeclaration<MatchaAutocompleteTriggerDirective, "[matchaAutocomplete]", never, { "panel": { "alias": "matchaAutocomplete"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, {}, never, never, false, never>;
 }
 
+declare class MatchaCheckboxComponent implements ControlValueAccessor {
+    private cdr;
+    inputElement: ElementRef<HTMLInputElement>;
+    private _color;
+    get colorAttr(): string;
+    get color(): string;
+    set color(value: string);
+    private _indeterminate;
+    get indeterminate(): boolean;
+    set indeterminate(value: boolean);
+    private _disabled;
+    get disabledAttr(): string | null;
+    get disabled(): boolean;
+    set disabled(value: boolean | string);
+    private _checked;
+    get checked(): boolean;
+    set checked(value: boolean | string);
+    checkedChange: EventEmitter<{
+        checked: boolean;
+    }>;
+    change: EventEmitter<{
+        source: MatchaCheckboxComponent;
+        checked: boolean;
+    }>;
+    onChange: any;
+    onTouched: any;
+    writeValue(value: boolean): void;
+    registerOnChange(fn: any): void;
+    registerOnTouched(fn: any): void;
+    setDisabledState(isDisabled: boolean): void;
+    constructor(cdr: ChangeDetectorRef);
+    onInputChange(event: Event): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaCheckboxComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatchaCheckboxComponent, "matcha-checkbox", never, { "color": { "alias": "color"; "required": false; }; "indeterminate": { "alias": "indeterminate"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "checked": { "alias": "checked"; "required": false; }; }, { "checkedChange": "checkedChange"; "change": "change"; }, never, ["*"], false, never>;
+}
+
+declare class MatchaRippleDirective implements OnDestroy {
+    private el;
+    rippleColor: string;
+    private ripples;
+    constructor(el: ElementRef);
+    onMouseDown(event: MouseEvent): void;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaRippleDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MatchaRippleDirective, "[matchaRipple]", never, { "rippleColor": { "alias": "rippleColor"; "required": false; }; }, {}, never, never, false, never>;
+}
+
+declare class MatchaRippleModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaRippleModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<MatchaRippleModule, [typeof MatchaRippleDirective], [typeof i2.CommonModule], [typeof MatchaRippleDirective]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<MatchaRippleModule>;
+}
+
+declare class MatchaCheckboxModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaCheckboxModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<MatchaCheckboxModule, [typeof MatchaCheckboxComponent], [typeof i2.CommonModule, typeof MatchaRippleModule], [typeof MatchaCheckboxComponent]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<MatchaCheckboxModule>;
+}
+
 declare class MatchaOptionModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<MatchaOptionModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<MatchaOptionModule, [typeof MatchaOptionComponent], [typeof i2.CommonModule], [typeof MatchaOptionComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<MatchaOptionModule, [typeof MatchaOptionComponent], [typeof i2.CommonModule, typeof MatchaCheckboxModule], [typeof MatchaOptionComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<MatchaOptionModule>;
 }
 
@@ -603,215 +695,114 @@ declare class MatchaSelectModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<MatchaSelectModule>;
 }
 
-declare class MatchaButtonToggleComponent implements AfterContentInit {
-    private elementRef;
-    private _multiple;
-    get multiple(): boolean | string;
-    set multiple(v: boolean | string);
-    private _disabled;
-    get disabled(): boolean | string;
-    set disabled(v: boolean | string);
-    get isDisabled(): string | true | null;
-    private _required;
-    get required(): boolean | string;
-    set required(v: boolean | string);
-    inactiveColor: string;
-    inactiveType: string;
-    private _gap;
-    set gap(v: string | number);
-    get gapClass(): string;
-    get gap(): number;
-    buttons: QueryList<MatchaButtonComponent>;
-    constructor(elementRef: ElementRef);
-    ngAfterContentInit(): void;
-    private setButtonState;
-    private onButtonSelected;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaButtonToggleComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatchaButtonToggleComponent, "matcha-button-toggle", never, { "multiple": { "alias": "multiple"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "required": { "alias": "required"; "required": false; }; "inactiveColor": { "alias": "inactiveColor"; "required": false; }; "inactiveType": { "alias": "inactiveType"; "required": false; }; "gap": { "alias": "gap"; "required": false; }; }, {}, ["buttons"], ["*"], false, never>;
-}
-
-declare class MatchaButtonToggleModule {
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaButtonToggleModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<MatchaButtonToggleModule, [typeof MatchaButtonToggleComponent], [typeof i2.CommonModule, typeof MatchaTooltipModule], [typeof MatchaButtonToggleComponent]>;
-    static ɵinj: i0.ɵɵInjectorDeclaration<MatchaButtonToggleModule>;
-}
-
-declare class MatchaCardComponent {
-    private _color;
-    get color(): string | null;
-    set color(v: string | null);
-    get colorAttr(): string | null;
-    blockquote: 'left' | 'right' | 'none' | null;
-    blockquoteColor: string | null;
-    class: string | null;
-    private _alpha;
-    get alpha(): boolean | string;
-    set alpha(v: boolean | string);
-    get alphaAttr(): string | null;
-    private _tint;
-    get tint(): boolean | string;
-    set tint(v: boolean | string);
-    get tintAttr(): string | null;
-    private _loading;
-    get loading(): boolean | string;
-    set loading(v: boolean | string);
-    get classes(): string;
-    hasBlockquotePosition(): boolean;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaCardComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatchaCardComponent, "matcha-card", never, { "color": { "alias": "color"; "required": false; }; "blockquote": { "alias": "blockquote"; "required": false; }; "blockquoteColor": { "alias": "blockquoteColor"; "required": false; }; "class": { "alias": "class"; "required": false; }; "alpha": { "alias": "alpha"; "required": false; }; "tint": { "alias": "tint"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; }, {}, never, ["*"], false, never>;
-}
-
-declare class MatchaElevationDirective {
-    private _elementRef;
-    private _renderer;
-    elevation: number | string;
-    constructor(_elementRef: ElementRef, _renderer: Renderer2);
-    ngOnChanges(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaElevationDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MatchaElevationDirective, "[elevation]", never, { "elevation": { "alias": "elevation"; "required": false; }; }, {}, never, never, false, never>;
-}
-
-declare class MatchaElevationModule {
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaElevationModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<MatchaElevationModule, [typeof MatchaElevationDirective], [typeof i2.CommonModule], [typeof MatchaElevationDirective]>;
-    static ɵinj: i0.ɵɵInjectorDeclaration<MatchaElevationModule>;
-}
-
-declare class MatchaCardModule {
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaCardModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<MatchaCardModule, [typeof MatchaCardComponent], [typeof i2.CommonModule, typeof MatchaElevationModule, typeof MatchaIconModule, typeof MatchaTitleModule, typeof MatchaDividerModule, typeof MatchaTooltipModule], [typeof MatchaCardComponent]>;
-    static ɵinj: i0.ɵɵInjectorDeclaration<MatchaCardModule>;
-}
-
-declare class MatchaCheckboxComponent implements ControlValueAccessor {
-    private cdr;
-    inputElement: ElementRef<HTMLInputElement>;
-    private _color;
-    get colorAttr(): string;
-    get color(): string;
-    set color(value: string);
-    private _indeterminate;
-    get indeterminate(): boolean;
-    set indeterminate(value: boolean);
-    private _disabled;
-    get disabledAttr(): string | null;
-    get disabled(): boolean;
-    set disabled(value: boolean | string);
-    private _checked;
-    get checked(): boolean;
-    set checked(value: boolean | string);
-    checkedChange: EventEmitter<{
-        checked: boolean;
-    }>;
-    change: EventEmitter<{
-        source: MatchaCheckboxComponent;
-        checked: boolean;
-    }>;
-    onChange: any;
-    onTouched: any;
-    writeValue(value: boolean): void;
-    registerOnChange(fn: any): void;
-    registerOnTouched(fn: any): void;
-    setDisabledState(isDisabled: boolean): void;
-    constructor(cdr: ChangeDetectorRef);
-    onInputChange(event: Event): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaCheckboxComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatchaCheckboxComponent, "matcha-checkbox", never, { "color": { "alias": "color"; "required": false; }; "indeterminate": { "alias": "indeterminate"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "checked": { "alias": "checked"; "required": false; }; }, { "checkedChange": "checkedChange"; "change": "change"; }, never, ["*"], false, never>;
-}
-
-declare class MatchaRippleDirective implements OnDestroy {
-    private el;
-    rippleColor: string;
-    private ripples;
-    constructor(el: ElementRef);
-    onMouseDown(event: MouseEvent): void;
-    ngOnDestroy(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaRippleDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MatchaRippleDirective, "[matchaRipple]", never, { "rippleColor": { "alias": "rippleColor"; "required": false; }; }, {}, never, never, false, never>;
-}
-
-declare class MatchaRippleModule {
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaRippleModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<MatchaRippleModule, [typeof MatchaRippleDirective], [typeof i2.CommonModule], [typeof MatchaRippleDirective]>;
-    static ɵinj: i0.ɵɵInjectorDeclaration<MatchaRippleModule>;
-}
-
-declare class MatchaCheckboxModule {
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaCheckboxModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<MatchaCheckboxModule, [typeof MatchaCheckboxComponent], [typeof i2.CommonModule, typeof MatchaRippleModule], [typeof MatchaCheckboxComponent]>;
-    static ɵinj: i0.ɵɵInjectorDeclaration<MatchaCheckboxModule>;
-}
-
-declare class MatchaRadioComponent implements ControlValueAccessor {
+declare class MatchaSelectMultipleComponent implements AfterContentInit, AfterViewInit, OnDestroy, MatchaOptionParent, ControlValueAccessor {
+    elRef: ElementRef;
     private cdr;
-    inputElement: ElementRef<HTMLInputElement>;
-    color: string;
-    value: any;
-    name: string;
-    private _disabled;
-    set disabled(value: boolean | string);
-    get disabled(): boolean;
-    get checked(): boolean;
-    set checked(value: boolean);
-    private _checked;
-    private _modelValue;
-    checkedChange: EventEmitter<{
-        checked: boolean;
-    }>;
-    change: EventEmitter<{
-        source: MatchaRadioComponent;
-        value: any;
-    }>;
-    onChange: any;
-    onTouched: any;
-    writeValue(value: any): void;
-    registerOnChange(fn: any): void;
-    registerOnTouched(fn: any): void;
-    setDisabledState(isDisabled: boolean): void;
-    constructor(cdr: ChangeDetectorRef);
-    onInputChange(event: Event): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaRadioComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatchaRadioComponent, "matcha-radio", never, { "color": { "alias": "color"; "required": false; }; "value": { "alias": "value"; "required": false; }; "name": { "alias": "name"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "checked": { "alias": "checked"; "required": false; }; }, { "checkedChange": "checkedChange"; "change": "change"; }, never, ["*"], false, never>;
-}
-
-declare class MatchaRadioGroupComponent implements ControlValueAccessor, AfterContentInit, OnDestroy {
-    private _cdr;
-    radios: QueryList<MatchaRadioComponent>;
-    get value(): any;
-    set value(newValue: any);
-    private _value;
-    name: string;
-    get disabled(): boolean;
-    set disabled(value: boolean);
-    private _disabled;
-    change: EventEmitter<{
-        source: MatchaRadioComponent;
+    options: QueryList<MatchaOptionComponent>;
+    panel: MatchaPanelComponent;
+    searchInputRef?: ElementRef<HTMLInputElement>;
+    selectedValues: any[];
+    /**
+     * Lido pela matcha-option (via MATCHA_OPTION_PARENT) para renderizar o
+     * checkbox já no primeiro ciclo, mesmo quando as opções são reprojetadas.
+     */
+    readonly multiple = true;
+    /**
+     * Itens selecionados renderizados na seção fixa do topo do painel.
+     * Mantidos pelo próprio componente (com labels capturados) para que
+     * permaneçam visíveis mesmo que a busca do pai remova suas opções.
+     */
+    selectedItems: {
         value: any;
+        label: string;
+    }[];
+    private selectedLabels;
+    placement: 'bottom' | 'top' | 'auto';
+    maxHeight: number;
+    minWidth: number;
+    placeholder: string;
+    disabled: boolean;
+    label: string;
+    /** Título da seção fixa de opções selecionadas no topo do painel. */
+    selectedHeader: string;
+    searchable: boolean;
+    searchPlaceholder: string;
+    searchDebounce: number;
+    opened: EventEmitter<void>;
+    closed: EventEmitter<void>;
+    selectionChange: EventEmitter<{
+        source: MatchaSelectMultipleComponent;
+        value: any[];
     }>;
-    onChange: (value: any) => void;
-    onTouched: () => void;
-    private _unsubscribeAll;
-    private _radioSubscriptions;
-    private _isInitialized;
-    constructor(_cdr: ChangeDetectorRef);
+    openedChange: EventEmitter<boolean>;
+    /** Emitido (com debounce) conforme o usuário digita no campo de busca. */
+    searchChange: EventEmitter<string>;
+    open: boolean;
+    triggerElement?: HTMLElement;
+    private activeIndex;
+    private optionsSub?;
+    private search$;
+    private searchSub?;
+    private onChange;
+    private onTouched;
+    private isDisabledByForm;
+    get isCurrentlyDisabled(): boolean;
+    get hostDisabledClass(): boolean;
+    get hostDisabledAttr(): string | null;
+    constructor(elRef: ElementRef, cdr: ChangeDetectorRef);
     ngAfterContentInit(): void;
-    private updateNames;
-    private subscribeToRadios;
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    /** Handler do input de busca: empurra o valor para o fluxo com debounce. */
+    onSearchInput(event: Event): void;
+    /** Permite navegar/alternar/fechar usando o teclado a partir do campo de busca. */
+    onSearchKeydown(event: KeyboardEvent): void;
+    /** Dá foco ao campo de busca (chamado ao abrir o painel). */
+    private focusSearchInput;
+    /** Sincroniza o estado checado das opções (o modo múltiplo é derivado do pai). */
+    private setupOptions;
+    private setupKeyboardNavigation;
+    onTriggerClick(): void;
+    openPanel(): void;
+    closePanel(): void;
+    togglePanel(): void;
+    /** Chamado pelo matcha-option (via MATCHA_OPTION_PARENT) ao clicar na opção ou no checkbox. */
+    selectOption(option: MatchaOptionComponent): void;
+    /** Alterna a marcação de um value. Usado pelas opções e pela seção fixa de selecionados. */
+    toggleByValue(value: any): void;
+    private toggleValue;
+    isSelected(value: any): boolean;
+    trackByValue: (_: number, item: {
+        value: any;
+    }) => any;
+    private syncOptionStates;
+    /** Reconstrói a lista de selecionados, capturando/atualizando os labels. */
+    private rebuildSelectedItems;
+    private emitChange;
+    /** Retorna as opções com as marcadas primeiro, preservando a ordem de declaração. */
+    private getOrderedOptions;
+    /** Opções navegáveis por teclado: visíveis (não selecionadas) e habilitadas. */
+    private getNavigableOptions;
+    /** Reanexa os elementos no DOM colocando as opções marcadas no início. */
+    private reorderOptions;
+    private resetActive;
+    private clearActive;
+    private updateActiveStates;
+    highlightNext(): void;
+    highlightPrevious(): void;
+    private scrollToActive;
+    private toggleActive;
+    getSelectedLabel(): string;
+    get hasSelection(): boolean;
+    /** Limpa toda a seleção. */
+    clearSelection(): void;
     writeValue(value: any): void;
     registerOnChange(fn: (value: any) => void): void;
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
-    private updateSelectedRadioFromValue;
-    private updateDisabledState;
-    ngOnDestroy(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaRadioGroupComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatchaRadioGroupComponent, "matcha-radio-group", never, { "value": { "alias": "value"; "required": false; }; "name": { "alias": "name"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "change": "change"; }, ["radios"], ["*"], false, never>;
-}
-
-declare class MatchaRadioModule {
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaRadioModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<MatchaRadioModule, [typeof MatchaRadioComponent, typeof MatchaRadioGroupComponent], [typeof i2.CommonModule, typeof MatchaRippleModule], [typeof MatchaRadioComponent, typeof MatchaRadioGroupComponent]>;
-    static ɵinj: i0.ɵɵInjectorDeclaration<MatchaRadioModule>;
+    private ensurePanelClosed;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaSelectMultipleComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatchaSelectMultipleComponent, "matcha-select-multiple", never, { "placement": { "alias": "placement"; "required": false; }; "maxHeight": { "alias": "maxHeight"; "required": false; }; "minWidth": { "alias": "minWidth"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "label": { "alias": "label"; "required": false; }; "selectedHeader": { "alias": "selectedHeader"; "required": false; }; "searchable": { "alias": "searchable"; "required": false; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; }; "searchDebounce": { "alias": "searchDebounce"; "required": false; }; }, { "opened": "opened"; "closed": "closed"; "selectionChange": "selectionChange"; "openedChange": "openedChange"; "searchChange": "searchChange"; }, ["options"], ["*"], false, never>;
 }
 
 declare class MatchaFormFieldComponent implements AfterViewInit, OnDestroy {
@@ -1161,6 +1152,164 @@ declare class MatchaFormFieldModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<MatchaFormFieldModule>;
 }
 
+declare class MatchaSelectMultipleModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaSelectMultipleModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<MatchaSelectMultipleModule, [typeof MatchaSelectMultipleComponent], [typeof i2.CommonModule, typeof MatchaOptionModule, typeof MatchaPanelModule, typeof MatchaFormFieldModule, typeof MatchaIconModule, typeof MatchaDividerModule], [typeof MatchaSelectMultipleComponent, typeof MatchaOptionModule, typeof MatchaDividerModule]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<MatchaSelectMultipleModule>;
+}
+
+declare class MatchaButtonToggleComponent implements AfterContentInit {
+    private elementRef;
+    private _multiple;
+    get multiple(): boolean | string;
+    set multiple(v: boolean | string);
+    private _disabled;
+    get disabled(): boolean | string;
+    set disabled(v: boolean | string);
+    get isDisabled(): string | true | null;
+    private _required;
+    get required(): boolean | string;
+    set required(v: boolean | string);
+    inactiveColor: string;
+    inactiveType: string;
+    private _gap;
+    set gap(v: string | number);
+    get gapClass(): string;
+    get gap(): number;
+    buttons: QueryList<MatchaButtonComponent>;
+    constructor(elementRef: ElementRef);
+    ngAfterContentInit(): void;
+    private setButtonState;
+    private onButtonSelected;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaButtonToggleComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatchaButtonToggleComponent, "matcha-button-toggle", never, { "multiple": { "alias": "multiple"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "required": { "alias": "required"; "required": false; }; "inactiveColor": { "alias": "inactiveColor"; "required": false; }; "inactiveType": { "alias": "inactiveType"; "required": false; }; "gap": { "alias": "gap"; "required": false; }; }, {}, ["buttons"], ["*"], false, never>;
+}
+
+declare class MatchaButtonToggleModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaButtonToggleModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<MatchaButtonToggleModule, [typeof MatchaButtonToggleComponent], [typeof i2.CommonModule, typeof MatchaTooltipModule], [typeof MatchaButtonToggleComponent]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<MatchaButtonToggleModule>;
+}
+
+declare class MatchaCardComponent {
+    private _color;
+    get color(): string | null;
+    set color(v: string | null);
+    get colorAttr(): string | null;
+    blockquote: 'left' | 'right' | 'none' | null;
+    blockquoteColor: string | null;
+    class: string | null;
+    private _alpha;
+    get alpha(): boolean | string;
+    set alpha(v: boolean | string);
+    get alphaAttr(): string | null;
+    private _tint;
+    get tint(): boolean | string;
+    set tint(v: boolean | string);
+    get tintAttr(): string | null;
+    private _loading;
+    get loading(): boolean | string;
+    set loading(v: boolean | string);
+    get classes(): string;
+    hasBlockquotePosition(): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaCardComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatchaCardComponent, "matcha-card", never, { "color": { "alias": "color"; "required": false; }; "blockquote": { "alias": "blockquote"; "required": false; }; "blockquoteColor": { "alias": "blockquoteColor"; "required": false; }; "class": { "alias": "class"; "required": false; }; "alpha": { "alias": "alpha"; "required": false; }; "tint": { "alias": "tint"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; }, {}, never, ["*"], false, never>;
+}
+
+declare class MatchaElevationDirective {
+    private _elementRef;
+    private _renderer;
+    elevation: number | string;
+    constructor(_elementRef: ElementRef, _renderer: Renderer2);
+    ngOnChanges(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaElevationDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MatchaElevationDirective, "[elevation]", never, { "elevation": { "alias": "elevation"; "required": false; }; }, {}, never, never, false, never>;
+}
+
+declare class MatchaElevationModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaElevationModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<MatchaElevationModule, [typeof MatchaElevationDirective], [typeof i2.CommonModule], [typeof MatchaElevationDirective]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<MatchaElevationModule>;
+}
+
+declare class MatchaCardModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaCardModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<MatchaCardModule, [typeof MatchaCardComponent], [typeof i2.CommonModule, typeof MatchaElevationModule, typeof MatchaIconModule, typeof MatchaTitleModule, typeof MatchaDividerModule, typeof MatchaTooltipModule], [typeof MatchaCardComponent]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<MatchaCardModule>;
+}
+
+declare class MatchaRadioComponent implements ControlValueAccessor {
+    private cdr;
+    inputElement: ElementRef<HTMLInputElement>;
+    color: string;
+    value: any;
+    name: string;
+    private _disabled;
+    set disabled(value: boolean | string);
+    get disabled(): boolean;
+    get checked(): boolean;
+    set checked(value: boolean);
+    private _checked;
+    private _modelValue;
+    checkedChange: EventEmitter<{
+        checked: boolean;
+    }>;
+    change: EventEmitter<{
+        source: MatchaRadioComponent;
+        value: any;
+    }>;
+    onChange: any;
+    onTouched: any;
+    writeValue(value: any): void;
+    registerOnChange(fn: any): void;
+    registerOnTouched(fn: any): void;
+    setDisabledState(isDisabled: boolean): void;
+    constructor(cdr: ChangeDetectorRef);
+    onInputChange(event: Event): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaRadioComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatchaRadioComponent, "matcha-radio", never, { "color": { "alias": "color"; "required": false; }; "value": { "alias": "value"; "required": false; }; "name": { "alias": "name"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "checked": { "alias": "checked"; "required": false; }; }, { "checkedChange": "checkedChange"; "change": "change"; }, never, ["*"], false, never>;
+}
+
+declare class MatchaRadioGroupComponent implements ControlValueAccessor, AfterContentInit, OnDestroy {
+    private _cdr;
+    radios: QueryList<MatchaRadioComponent>;
+    get value(): any;
+    set value(newValue: any);
+    private _value;
+    name: string;
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    private _disabled;
+    change: EventEmitter<{
+        source: MatchaRadioComponent;
+        value: any;
+    }>;
+    onChange: (value: any) => void;
+    onTouched: () => void;
+    private _unsubscribeAll;
+    private _radioSubscriptions;
+    private _isInitialized;
+    constructor(_cdr: ChangeDetectorRef);
+    ngAfterContentInit(): void;
+    private updateNames;
+    private subscribeToRadios;
+    writeValue(value: any): void;
+    registerOnChange(fn: (value: any) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    private updateSelectedRadioFromValue;
+    private updateDisabledState;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaRadioGroupComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatchaRadioGroupComponent, "matcha-radio-group", never, { "value": { "alias": "value"; "required": false; }; "name": { "alias": "name"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "change": "change"; }, ["radios"], ["*"], false, never>;
+}
+
+declare class MatchaRadioModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaRadioModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<MatchaRadioModule, [typeof MatchaRadioComponent, typeof MatchaRadioGroupComponent], [typeof i2.CommonModule, typeof MatchaRippleModule], [typeof MatchaRadioComponent, typeof MatchaRadioGroupComponent]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<MatchaRadioModule>;
+}
+
 declare class MatchaHintTextComponent {
     type: string;
     size: string;
@@ -2020,19 +2169,183 @@ declare class MatchaDateRangeComponent implements AfterContentInit, OnDestroy {
     static ɵcmp: i0.ɵɵComponentDeclaration<MatchaDateRangeComponent, "matcha-date-range", never, {}, {}, ["controls"], ["*"], false, never>;
 }
 
-declare class MatchaDateComponent implements ControlValueAccessor {
+/**
+ * Serviço de internacionalização do matcha-calendar-picker.
+ * Inspirado no MatchaPaginatorIntl, porém registrado APENAS via
+ * `providedIn: 'root'` — nunca em `providers:` de módulo. Isso garante uma
+ * única instância em todo o app mesmo com lazy loading (o registro em
+ * `providers` de um módulo lazy criaria uma instância separada no injector
+ * daquele módulo, e as alterações de label não chegariam ao componente).
+ *
+ * Uso no app consumidor:
+ *   constructor(private calendarIntl: MatchaCalendarIntl) {}
+ *   setEnglish() {
+ *     this.calendarIntl.monthNames = ['January', ...];
+ *     this.calendarIntl.changes.next();
+ *   }
+ */
+declare class MatchaCalendarIntl {
+    /** Emite quando os labels mudam. O picker reconstrói as células ao receber. */
+    readonly changes: Subject<void>;
+    /** Nomes completos dos meses (view de meses). Índice 0 = Janeiro. */
+    monthNames: string[];
+    /** Nomes abreviados dos meses (cabeçalho da view de dias). Índice 0 = Jan. */
+    monthNamesShort: string[];
+    /** Abreviações dos dias da semana (cabeçalho do grid). Índice 0 = Domingo. */
+    weekdayNamesShort: string[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaCalendarIntl, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MatchaCalendarIntl>;
+}
+
+/** Níveis de navegação do calendário. */
+type MatchaCalendarView = 'day' | 'month' | 'year';
+interface MatchaCalendarDayCell {
+    /** Data no formato 'YYYY-MM-DD'. */
+    date: string;
+    day: number;
+    inCurrentMonth: boolean;
+    selected: boolean;
+    disabled: boolean;
+    isToday: boolean;
+}
+interface MatchaCalendarMonthCell {
+    month: number;
+    label: string;
+    selected: boolean;
+    disabled: boolean;
+}
+interface MatchaCalendarYearCell {
+    year: number;
+    selected: boolean;
+    disabled: boolean;
+}
+/**
+ * Calendário/datepicker apresentacional com três views (dias, meses, anos).
+ *
+ * É um componente "burro": recebe `value`/`min`/`max` (todos no formato
+ * 'YYYY-MM-DD') e emite `dateChange` com a data selecionada. Não implementa
+ * ControlValueAccessor — o host (ex: matcha-date) é quem mantém o valor.
+ *
+ * Tradução via {@link MatchaCalendarIntl} (global) ou pelos @Inputs de label
+ * (override por instância). Os arrays de label são CACHEADOS dentro das
+ * células, por isso reconstruímos as células quando `intl.changes` emite.
+ */
+declare class MatchaCalendarPickerComponent implements OnChanges, OnDestroy {
+    intl: MatchaCalendarIntl;
+    private cdr;
+    /** Data selecionada no formato 'YYYY-MM-DD' (ou null). */
+    value: string | null;
+    /** Limite inferior 'YYYY-MM-DD' (ou '' para sem limite). */
+    min: string;
+    /** Limite superior 'YYYY-MM-DD' (ou '' para sem limite). */
+    max: string;
+    /** Override por instância dos nomes completos de mês (12). */
+    monthNames?: string[];
+    /** Override por instância dos nomes abreviados de mês (12). */
+    monthNamesShort?: string[];
+    /** Override por instância das abreviações de dia da semana (7, índice 0 = Domingo). */
+    weekdayNamesShort?: string[];
+    /** Emite a data selecionada no formato 'YYYY-MM-DD'. */
+    dateChange: EventEmitter<string>;
+    view: MatchaCalendarView;
+    activeYear: number;
+    activeMonth: number;
+    decadeStart: number;
+    weekdayHeaders: string[];
+    dayCells: MatchaCalendarDayCell[];
+    monthCells: MatchaCalendarMonthCell[];
+    yearCells: MatchaCalendarYearCell[];
+    private selectedDate;
+    private minDate;
+    private maxDate;
+    private userNavigated;
+    private intlSub;
+    constructor(intl: MatchaCalendarIntl, cdr: ChangeDetectorRef);
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
+    private get months();
+    private get monthsShort();
+    private get weekdays();
+    get activeMonthLabelShort(): string;
+    get decadeLabel(): string;
+    private parseYmd;
+    private formatYmd;
+    private parseSelection;
+    private parseBounds;
+    private initActiveFromToday;
+    /** Posiciona o período exibido na seleção, ou hoje, clampando para [min,max]. */
+    private syncActiveToSelection;
+    /** Reposiciona a view ao reabrir (chamado pelo host). */
+    resetView(): void;
+    private rebuildAll;
+    private buildDayGrid;
+    private buildMonthGrid;
+    private buildYearGrid;
+    private isSelected;
+    private isToday;
+    private isDateDisabled;
+    private isMonthFullyOutOfRange;
+    private isYearFullyOutOfRange;
+    prev(): void;
+    next(): void;
+    private shift;
+    openMonthView(): void;
+    openYearView(): void;
+    selectDay(cell: MatchaCalendarDayCell): void;
+    selectMonth(cell: MatchaCalendarMonthCell): void;
+    selectYear(cell: MatchaCalendarYearCell): void;
+    /** trackBy para os grids (evita recriar nós ao reconstruir). */
+    trackByDate(_: number, cell: MatchaCalendarDayCell): string;
+    trackByMonth(_: number, cell: MatchaCalendarMonthCell): number;
+    trackByYear(_: number, cell: MatchaCalendarYearCell): number;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaCalendarPickerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatchaCalendarPickerComponent, "matcha-calendar-picker", never, { "value": { "alias": "value"; "required": false; }; "min": { "alias": "min"; "required": false; }; "max": { "alias": "max"; "required": false; }; "monthNames": { "alias": "monthNames"; "required": false; }; "monthNamesShort": { "alias": "monthNamesShort"; "required": false; }; "weekdayNamesShort": { "alias": "weekdayNamesShort"; "required": false; }; }, { "dateChange": "dateChange"; }, never, never, false, never>;
+}
+
+declare class MatchaDateComponent implements ControlValueAccessor, AfterViewInit {
+    private elRef;
+    private cdr;
     placeholder: string;
     min: string;
     max: string;
     disabled: boolean;
     showNativePicker: boolean;
+    /**
+     * Define o que o botão de calendário faz ao ser clicado.
+     * - true (padrão): abre o datepicker nativo do navegador (comportamento histórico).
+     * - false: NÃO abre o nativo. A abertura passa a ser responsabilidade do
+     *   matcha-calendar-picker (Parte 2), que conterá essa lógica.
+     */
+    useNativePicker: boolean;
+    /**
+     * Quando true, o painel do matcha-calendar-picker NÃO dispara o evento global
+     * que fecha os demais painéis. Use quando este matcha-date estiver ANINHADO
+     * dentro de outro matcha-panel (ex: o modo "Personalizado" do matcha-period),
+     * para que abrir o calendário não feche o painel pai.
+     */
+    suppressPanelGlobalClose: boolean;
+    /**
+     * Emite o elemento do painel do calendário quando ele abre/fecha. O painel
+     * pai (quando aninhado) usa esses elementos em `ignoreClickOutsideElements`
+     * para não fechar ao clicar dentro do calendário.
+     */
+    calendarPanelOpened: EventEmitter<HTMLElement>;
+    calendarPanelClosed: EventEmitter<HTMLElement>;
     textInput: ElementRef<HTMLInputElement>;
     nativeDateInput: ElementRef<HTMLInputElement>;
+    calendarPanel?: MatchaPanelComponent;
+    calendarPicker?: MatchaCalendarPickerComponent;
     value: string;
     displayValue: string;
     isDisabled: boolean;
     private onChange;
     private onTouched;
+    /** Overlay do calendário atualmente aberto (emitido ao pai quando aninhado). */
+    private lastCalendarPane?;
+    constructor(elRef: ElementRef, cdr: ChangeDetectorRef);
+    ngAfterViewInit(): void;
+    /** Elemento âncora do painel: o matcha-form-field envolvente, ou o host. */
+    private panelAnchor;
     writeValue(value: any): void;
     registerOnChange(fn: any): void;
     registerOnTouched(fn: any): void;
@@ -2043,17 +2356,26 @@ declare class MatchaDateComponent implements ControlValueAccessor {
     onNativeDateChange(event: Event): void;
     onBlur(): void;
     openNativeDatePicker(): void;
+    /** Dia selecionado no matcha-calendar-picker (recebe 'YYYY-MM-DD'). */
+    onCalendarDateSelected(ymd: string): void;
+    onCalendarPanelClosed(): void;
     private isValidDateFormat;
     private isValidDate;
     private convertToYYYYMMDD;
     private formatDateForDisplay;
     static ɵfac: i0.ɵɵFactoryDeclaration<MatchaDateComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatchaDateComponent, "matcha-date", never, { "placeholder": { "alias": "placeholder"; "required": false; }; "min": { "alias": "min"; "required": false; }; "max": { "alias": "max"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "showNativePicker": { "alias": "showNativePicker"; "required": false; }; }, {}, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatchaDateComponent, "matcha-date", never, { "placeholder": { "alias": "placeholder"; "required": false; }; "min": { "alias": "min"; "required": false; }; "max": { "alias": "max"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "showNativePicker": { "alias": "showNativePicker"; "required": false; }; "useNativePicker": { "alias": "useNativePicker"; "required": false; }; "suppressPanelGlobalClose": { "alias": "suppressPanelGlobalClose"; "required": false; }; }, { "calendarPanelOpened": "calendarPanelOpened"; "calendarPanelClosed": "calendarPanelClosed"; }, never, never, false, never>;
+}
+
+declare class MatchaCalendarPickerModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaCalendarPickerModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<MatchaCalendarPickerModule, [typeof MatchaCalendarPickerComponent], [typeof i2.CommonModule, typeof MatchaCardModule, typeof MatchaIconModule, typeof MatchaDividerModule], [typeof MatchaCalendarPickerComponent]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<MatchaCalendarPickerModule>;
 }
 
 declare class MatchaDateModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<MatchaDateModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<MatchaDateModule, [typeof MatchaDateComponent], [typeof i2.CommonModule, typeof i3.FormsModule], [typeof MatchaDateComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<MatchaDateModule, [typeof MatchaDateComponent], [typeof i2.CommonModule, typeof i3.FormsModule, typeof MatchaPanelModule, typeof MatchaCalendarPickerModule], [typeof MatchaDateComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<MatchaDateModule>;
 }
 
@@ -2063,6 +2385,144 @@ declare class MatchaDateRangeModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<MatchaDateRangeModule>;
 }
 
+/**
+ * Tipagem pública do componente matcha-period (seletor de período / presets).
+ */
+/** Intervalo de datas (início e fim). */
+interface MatchaPeriodRange {
+    start: Date;
+    end: Date;
+}
+/**
+ * Preset de período passado via @Input.
+ *
+ * Padrão rígido: cada preset é auto-contido e sabe calcular o próprio intervalo
+ * através de `getRange()`. Isso permite presets dinâmicos (ex.: "Hoje", "Últimos
+ * 7 dias") que recalculam a data relativa ao momento da seleção.
+ */
+interface MatchaPeriodPreset {
+    /** Identificador único e estável do preset (usado no valor emitido). */
+    key: string;
+    /** Texto exibido na lista. */
+    label: string;
+    /** Calcula o intervalo de datas deste preset. */
+    getRange: () => MatchaPeriodRange;
+}
+/**
+ * Valor do componente: intervalo selecionado + a chave do preset de origem.
+ * `presetKey` é `null` quando o intervalo veio do modo "Personalizado".
+ */
+interface MatchaPeriodValue {
+    start: Date;
+    end: Date;
+    presetKey: string | null;
+}
+/** Formatos aceitos para exibir o intervalo no gatilho do componente. */
+type MatchaPeriodDisplayFormat = 'dd/MM/yy' | 'dd/MM/yyyy';
+
+declare class MatchaPeriodComponent implements AfterViewInit, ControlValueAccessor {
+    elRef: ElementRef;
+    private cdr;
+    panel: MatchaPanelComponent;
+    /** Lista de presets exibidos. Cada preset é auto-contido (ver matcha-period.types). */
+    presets: MatchaPeriodPreset[];
+    /** Habilita a opção "Personalizado" (com Data início / Data fim). */
+    allowCustom: boolean;
+    /** Texto exibido no gatilho quando não há valor. */
+    placeholder: string;
+    /** Rótulo da opção de período personalizado. */
+    customLabel: string;
+    /** Formato do intervalo exibido no gatilho. */
+    displayFormat: MatchaPeriodDisplayFormat;
+    disabled: boolean;
+    placement: PanelPlacement;
+    maxHeight: number;
+    minWidth: number;
+    /** Emite sempre que um intervalo é definido (preset selecionado ou "Aplicar" do custom). */
+    periodChange: EventEmitter<MatchaPeriodValue>;
+    opened: EventEmitter<void>;
+    closed: EventEmitter<void>;
+    openedChange: EventEmitter<boolean>;
+    value: MatchaPeriodValue | null;
+    open: boolean;
+    showingCustom: boolean;
+    /**
+     * Overlays dos calendários (matcha-date aninhados no modo personalizado).
+     * Repassados ao painel via `ignoreClickOutsideElements` para que clicar
+     * dentro de um calendário não feche o painel do período.
+     */
+    calendarOverlays: HTMLElement[];
+    customForm: FormGroup<{
+        start: FormControl<string | null>;
+        end: FormControl<string | null>;
+    }>;
+    customError: string;
+    activeIndex: number;
+    triggerElement?: HTMLElement;
+    private onChange;
+    private onTouched;
+    private isDisabledByForm;
+    constructor(elRef: ElementRef, cdr: ChangeDetectorRef);
+    get isCurrentlyDisabled(): boolean;
+    get hostDisabledClass(): boolean;
+    get hostDisabledAttr(): string | null;
+    /** Quantidade total de itens navegáveis (presets + custom, se habilitado). */
+    private get navCount();
+    ngAfterViewInit(): void;
+    /** Rótulo exibido no gatilho: intervalo formatado ou placeholder. */
+    get triggerLabel(): string;
+    get hasValue(): boolean;
+    isPresetSelected(preset: MatchaPeriodPreset): boolean;
+    get isCustomSelected(): boolean;
+    get customStartMax(): string;
+    get customEndMin(): string;
+    private formatDate;
+    onTriggerClick(): void;
+    openPanel(): void;
+    closePanel(): void;
+    selectPreset(preset: MatchaPeriodPreset): void;
+    /**
+     * Registra o overlay de um calendário aninhado (ao abrir) para ignorá-lo no
+     * click-outside do painel do período.
+     *
+     * NÃO removemos o overlay quando o calendário fecha: selecionar uma data fecha
+     * o calendário no MESMO clique que ainda propaga até o listener de click-outside
+     * do período. Como o `composedPath()` desse clique ainda contém o pane (mesmo já
+     * destruído), mantê-lo na lista evita que o período feche junto. Panes destruídos
+     * são inofensivos (nunca casam com cliques futuros) e a lista é zerada ao abrir/
+     * fechar o período.
+     */
+    registerCalendarOverlay(el: HTMLElement): void;
+    /** Abre/realça a área de período personalizado, mantendo o painel aberto. */
+    toggleCustom(): void;
+    applyCustom(): void;
+    private commitValue;
+    /** Converte uma string 'YYYY-MM-DD' válida em Date; retorna null caso contrário. */
+    private parseDate;
+    private syncCustomInputsFromValue;
+    /** Formata um Date para o formato consumido pelo matcha-date ('YYYY-MM-DD'). */
+    private toInputValue;
+    onTriggerKeyDown(event: KeyboardEvent): void;
+    private moveActive;
+    isActiveIndex(index: number): boolean;
+    get isCustomActive(): boolean;
+    private activateCurrent;
+    writeValue(value: MatchaPeriodValue | null): void;
+    registerOnChange(fn: (value: MatchaPeriodValue | null) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    /** Garante que start/end sejam Date (aceita strings/ISO vindas do FormControl). */
+    private normalizeValue;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaPeriodComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatchaPeriodComponent, "matcha-period", never, { "presets": { "alias": "presets"; "required": false; }; "allowCustom": { "alias": "allowCustom"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "customLabel": { "alias": "customLabel"; "required": false; }; "displayFormat": { "alias": "displayFormat"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "placement": { "alias": "placement"; "required": false; }; "maxHeight": { "alias": "maxHeight"; "required": false; }; "minWidth": { "alias": "minWidth"; "required": false; }; }, { "periodChange": "periodChange"; "opened": "opened"; "closed": "closed"; "openedChange": "openedChange"; }, never, never, false, never>;
+}
+
+declare class MatchaPeriodModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatchaPeriodModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<MatchaPeriodModule, [typeof MatchaPeriodComponent], [typeof i2.CommonModule, typeof i3.FormsModule, typeof i3.ReactiveFormsModule, typeof MatchaPanelModule, typeof MatchaButtonModule, typeof MatchaIconModule, typeof MatchaDividerModule, typeof MatchaDateModule, typeof MatchaDateRangeModule, typeof MatchaFormFieldModule], [typeof MatchaPeriodComponent]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<MatchaPeriodModule>;
+}
+
 declare class MatchaTimeComponent implements ControlValueAccessor, Validator {
     placeholder: string;
     disabled: boolean;
@@ -2763,7 +3223,7 @@ declare class MatchaSnackBarComponent implements OnInit, OnDestroy {
     visible: boolean;
     private timeoutId;
     get colorAttr(): "error" | "warning" | "info" | "success";
-    get positionAttr(): "bottom" | "top";
+    get positionAttr(): "top" | "bottom";
     get classes(): string;
     constructor(snackBarService: MatchaSnackBarService);
     ngOnInit(): void;
@@ -2907,7 +3367,7 @@ declare class MatchaAvatarModule {
 
 declare class MatchaComponentsModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<MatchaComponentsModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<MatchaComponentsModule, [typeof MatchaOverflowDraggableComponent], [typeof i2.CommonModule, typeof i3.FormsModule, typeof i3.ReactiveFormsModule, typeof MatchaAccordionModule, typeof MatchaAutocompleteModule, typeof MatchaOptionModule, typeof MatchaPanelModule, typeof MatchaSelectModule, typeof MatchaButtonModule, typeof MatchaButtonToggleModule, typeof MatchaCardModule, typeof MatchaCheckboxModule, typeof MatchaRadioModule, typeof MatchaDividerModule, typeof MatchaElevationModule, typeof MatchaFormFieldModule, typeof MatchaHintTextModule, typeof MatchaIconModule, typeof MatchaInfiniteScrollModule, typeof MatchaLazyloadModule, typeof MatchaInputPhoneModule, typeof MatchaMasonryModule, typeof MatchaModalModule, typeof MatchaPaginatorModule, typeof MatchaRippleModule, typeof MatchaSlideToggleModule, typeof MatchaMsgBoxModule, typeof MatchaSliderModule, typeof MatchaSpinModule, typeof MatchaSpinnerModule, typeof MatchaProgressBarModule, typeof MatchaStepperModule, typeof MatchaTabsModule, typeof MatchaTitleModule, typeof MatchaTooltipModule, typeof MatchaDateRangeModule, typeof MatchaTimeModule, typeof MatchaTimeRangeModule, typeof MatchaDropListModule, typeof MatchaPageLayoutModule, typeof MatchaDrawerModule, typeof MatchaHighlightModule, typeof MatchaMaskModule, typeof MatchaChipModule, typeof MatchaMenuModule, typeof MatchaListModule, typeof MatchaSnackBarModule, typeof MatchaTextEditorModule], [typeof MatchaAccordionModule, typeof MatchaAutocompleteModule, typeof MatchaOptionModule, typeof MatchaPanelModule, typeof MatchaSelectModule, typeof MatchaButtonModule, typeof MatchaButtonToggleModule, typeof MatchaCardModule, typeof MatchaCheckboxModule, typeof MatchaRadioModule, typeof MatchaDividerModule, typeof MatchaElevationModule, typeof MatchaFormFieldModule, typeof MatchaHintTextModule, typeof MatchaIconModule, typeof MatchaInfiniteScrollModule, typeof MatchaLazyloadModule, typeof MatchaInputPhoneModule, typeof MatchaMasonryModule, typeof MatchaModalModule, typeof MatchaPaginatorModule, typeof MatchaRippleModule, typeof MatchaSlideToggleModule, typeof MatchaMsgBoxModule, typeof MatchaSliderModule, typeof MatchaSpinModule, typeof MatchaSpinnerModule, typeof MatchaProgressBarModule, typeof MatchaStepperModule, typeof MatchaTabsModule, typeof MatchaTitleModule, typeof MatchaTooltipModule, typeof MatchaDateRangeModule, typeof MatchaTimeModule, typeof MatchaTimeRangeModule, typeof MatchaDropListModule, typeof MatchaPageLayoutModule, typeof MatchaAvatarModule, typeof MatchaDrawerModule, typeof MatchaHighlightModule, typeof MatchaMaskModule, typeof MatchaChipModule, typeof MatchaMenuModule, typeof MatchaListModule, typeof MatchaSnackBarModule, typeof MatchaTextEditorModule]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<MatchaComponentsModule, [typeof MatchaOverflowDraggableComponent], [typeof i2.CommonModule, typeof i3.FormsModule, typeof i3.ReactiveFormsModule, typeof MatchaAccordionModule, typeof MatchaAutocompleteModule, typeof MatchaOptionModule, typeof MatchaPanelModule, typeof MatchaSelectModule, typeof MatchaSelectMultipleModule, typeof MatchaButtonModule, typeof MatchaButtonToggleModule, typeof MatchaCardModule, typeof MatchaCheckboxModule, typeof MatchaRadioModule, typeof MatchaDividerModule, typeof MatchaElevationModule, typeof MatchaFormFieldModule, typeof MatchaHintTextModule, typeof MatchaIconModule, typeof MatchaInfiniteScrollModule, typeof MatchaLazyloadModule, typeof MatchaInputPhoneModule, typeof MatchaMasonryModule, typeof MatchaModalModule, typeof MatchaPaginatorModule, typeof MatchaRippleModule, typeof MatchaSlideToggleModule, typeof MatchaMsgBoxModule, typeof MatchaSliderModule, typeof MatchaSpinModule, typeof MatchaSpinnerModule, typeof MatchaProgressBarModule, typeof MatchaStepperModule, typeof MatchaTabsModule, typeof MatchaTitleModule, typeof MatchaTooltipModule, typeof MatchaDateRangeModule, typeof MatchaPeriodModule, typeof MatchaCalendarPickerModule, typeof MatchaTimeModule, typeof MatchaTimeRangeModule, typeof MatchaDropListModule, typeof MatchaPageLayoutModule, typeof MatchaDrawerModule, typeof MatchaHighlightModule, typeof MatchaMaskModule, typeof MatchaChipModule, typeof MatchaMenuModule, typeof MatchaListModule, typeof MatchaSnackBarModule, typeof MatchaTextEditorModule], [typeof MatchaAccordionModule, typeof MatchaAutocompleteModule, typeof MatchaOptionModule, typeof MatchaPanelModule, typeof MatchaSelectModule, typeof MatchaSelectMultipleModule, typeof MatchaButtonModule, typeof MatchaButtonToggleModule, typeof MatchaCardModule, typeof MatchaCheckboxModule, typeof MatchaRadioModule, typeof MatchaDividerModule, typeof MatchaElevationModule, typeof MatchaFormFieldModule, typeof MatchaHintTextModule, typeof MatchaIconModule, typeof MatchaInfiniteScrollModule, typeof MatchaLazyloadModule, typeof MatchaInputPhoneModule, typeof MatchaMasonryModule, typeof MatchaModalModule, typeof MatchaPaginatorModule, typeof MatchaRippleModule, typeof MatchaSlideToggleModule, typeof MatchaMsgBoxModule, typeof MatchaSliderModule, typeof MatchaSpinModule, typeof MatchaSpinnerModule, typeof MatchaProgressBarModule, typeof MatchaStepperModule, typeof MatchaTabsModule, typeof MatchaTitleModule, typeof MatchaTooltipModule, typeof MatchaDateRangeModule, typeof MatchaPeriodModule, typeof MatchaCalendarPickerModule, typeof MatchaTimeModule, typeof MatchaTimeRangeModule, typeof MatchaDropListModule, typeof MatchaPageLayoutModule, typeof MatchaAvatarModule, typeof MatchaDrawerModule, typeof MatchaHighlightModule, typeof MatchaMaskModule, typeof MatchaChipModule, typeof MatchaMenuModule, typeof MatchaListModule, typeof MatchaSnackBarModule, typeof MatchaTextEditorModule]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<MatchaComponentsModule>;
 }
 
@@ -3286,5 +3746,5 @@ declare class MatchaToolbarModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<MatchaToolbarModule>;
 }
 
-export { CopyButtonComponent, INITIAL_CONFIG, MATCHA_MASK_CONFIG, MATCHA_OPTION_PARENT, MaskExpression, MatchaAccordionComponent, MatchaAccordionContentComponent, MatchaAccordionHeaderComponent, MatchaAccordionItemComponent, MatchaAccordionModule, MatchaAutocompleteComponent, MatchaAutocompleteModule, MatchaAutocompleteTriggerDirective, MatchaAvatarComponent, MatchaAvatarModule, MatchaBreakpointObservableModule, MatchaBreakpointObserver, MatchaButtonComponent, MatchaButtonModule, MatchaButtonToggleComponent, MatchaButtonToggleModule, MatchaCardComponent, MatchaCardModule, MatchaCheckboxComponent, MatchaCheckboxModule, MatchaChipComponent, MatchaChipListComponent, MatchaChipModule, MatchaComponentsModule, MatchaDateComponent, MatchaDateModule, MatchaDateRangeComponent, MatchaDateRangeModule, MatchaDividerComponent, MatchaDividerModule, MatchaDragDirective, MatchaDragHandleDirective, MatchaDrawerComponent, MatchaDrawerContainerComponent, MatchaDrawerContentComponent, MatchaDrawerModule, MatchaDropListComponent, MatchaDropListModule, MatchaDropListService, MatchaDropZoneDirective, MatchaElevationDirective, MatchaElevationModule, MatchaErrorComponent, MatchaFormFieldComponent, MatchaFormFieldModule, MatchaGridComponent, MatchaGridModule, MatchaHighlightComponent, MatchaHighlightModule, MatchaHintTextComponent, MatchaHintTextModule, MatchaIconComponent, MatchaIconModule, MatchaInfiniteScrollComponent, MatchaInfiniteScrollDataComponent, MatchaInfiniteScrollModule, MatchaInputPhoneComponent, MatchaInputPhoneModule, MatchaLabelComponent, MatchaLazyloadComponent, MatchaLazyloadDataComponent, MatchaLazyloadModule, MatchaListComponent, MatchaListItemComponent, MatchaListModule, MatchaMaskApplierService, MatchaMaskCompatibleDirective, MatchaMaskModule, MatchaMaskPipe, MatchaMaskService, MatchaMasonryComponent, MatchaMasonryModule, MatchaMenuComponent, MatchaMenuItemDirective, MatchaMenuModule, MatchaMenuTriggerDirective, MatchaModalComponent, MatchaModalContentComponent, MatchaModalFooterComponent, MatchaModalHeaderComponent, MatchaModalModule, MatchaModalOptionsComponent, MatchaModalService, MatchaMsgBoxActionsComponent, MatchaMsgBoxComponent, MatchaMsgBoxModule, MatchaOptionComponent, MatchaOptionModule, MatchaOverlayService, MatchaPageBuilderComponent, MatchaPageBuilderModule, MatchaPageLayoutComponent, MatchaPageLayoutModule, MatchaPaginatorComponent, MatchaPaginatorIntl, MatchaPaginatorModule, MatchaPanelComponent, MatchaPanelModule, MatchaProgressBarComponent, MatchaProgressBarModule, MatchaRadioComponent, MatchaRadioGroupComponent, MatchaRadioModule, MatchaRippleDirective, MatchaRippleModule, MatchaSelectComponent, MatchaSelectModule, MatchaSelectTriggerDirective, MatchaSkeletonComponent, MatchaSkeletonModule, MatchaSlideToggleComponent, MatchaSlideToggleModule, MatchaSliderComponent, MatchaSliderModule, MatchaSnackBarComponent, MatchaSnackBarModule, MatchaSnackBarService, MatchaSpinComponent, MatchaSpinModule, MatchaSpinnerComponent, MatchaSpinnerModule, MatchaStepperComponent, MatchaStepperContentComponent, MatchaStepperControllerComponent, MatchaStepperModule, MatchaStepperStateService, MatchaSubmenuTriggerDirective, MatchaTabItemComponent, MatchaTableComponent, MatchaTableModule, MatchaTabsComponent, MatchaTabsModule, MatchaTextEditorComponent, MatchaTextEditorModule, MatchaTimeComponent, MatchaTimeModule, MatchaTimeRangeComponent, MatchaTimeRangeModule, MatchaTitleComponent, MatchaTitleModule, MatchaToolbarButtonComponent, MatchaToolbarComponent, MatchaToolbarContentComponent, MatchaToolbarCustomButtonComponent, MatchaToolbarMainButtonComponent, MatchaToolbarModule, MatchaTooltipDirective, MatchaTooltipModule, NEW_CONFIG, NextStepDirective, PrevStepDirective, StepComponent, StepContentDirective, buildSunEditorConfig, compatibleOptions, initialConfig, timeMasks, withoutValidation };
-export type { BreakpointState, DrawerMode, DrawerPosition, ILevelClasses, InputTransformFn, MatchaDropListConnectedToEvent, MatchaDropListDroppedEvent, MatchaDropZoneDroppedEvent, MatchaMaskConfig, MatchaMaskOptions, MatchaOptionParent, MatchaSnackBarConfig, MatchaTextEditorOptions, ModalComponent, OutputTransformFn, PageEvent, PanelPlacement, PanelPosition, SliderOptions, TabChangeEvent };
+export { CopyButtonComponent, INITIAL_CONFIG, MATCHA_MASK_CONFIG, MATCHA_OPTION_PARENT, MaskExpression, MatchaAccordionComponent, MatchaAccordionContentComponent, MatchaAccordionHeaderComponent, MatchaAccordionItemComponent, MatchaAccordionModule, MatchaAutocompleteComponent, MatchaAutocompleteModule, MatchaAutocompleteTriggerDirective, MatchaAvatarComponent, MatchaAvatarModule, MatchaBreakpointObservableModule, MatchaBreakpointObserver, MatchaButtonComponent, MatchaButtonModule, MatchaButtonToggleComponent, MatchaButtonToggleModule, MatchaCalendarIntl, MatchaCalendarPickerComponent, MatchaCalendarPickerModule, MatchaCardComponent, MatchaCardModule, MatchaCheckboxComponent, MatchaCheckboxModule, MatchaChipComponent, MatchaChipListComponent, MatchaChipModule, MatchaComponentsModule, MatchaDateComponent, MatchaDateModule, MatchaDateRangeComponent, MatchaDateRangeModule, MatchaDividerComponent, MatchaDividerModule, MatchaDragDirective, MatchaDragHandleDirective, MatchaDrawerComponent, MatchaDrawerContainerComponent, MatchaDrawerContentComponent, MatchaDrawerModule, MatchaDropListComponent, MatchaDropListModule, MatchaDropListService, MatchaDropZoneDirective, MatchaElevationDirective, MatchaElevationModule, MatchaErrorComponent, MatchaFormFieldComponent, MatchaFormFieldModule, MatchaGridComponent, MatchaGridModule, MatchaHighlightComponent, MatchaHighlightModule, MatchaHintTextComponent, MatchaHintTextModule, MatchaIconComponent, MatchaIconModule, MatchaInfiniteScrollComponent, MatchaInfiniteScrollDataComponent, MatchaInfiniteScrollModule, MatchaInputPhoneComponent, MatchaInputPhoneModule, MatchaLabelComponent, MatchaLazyloadComponent, MatchaLazyloadDataComponent, MatchaLazyloadModule, MatchaListComponent, MatchaListItemComponent, MatchaListModule, MatchaMaskApplierService, MatchaMaskCompatibleDirective, MatchaMaskModule, MatchaMaskPipe, MatchaMaskService, MatchaMasonryComponent, MatchaMasonryModule, MatchaMenuComponent, MatchaMenuItemDirective, MatchaMenuModule, MatchaMenuTriggerDirective, MatchaModalComponent, MatchaModalContentComponent, MatchaModalFooterComponent, MatchaModalHeaderComponent, MatchaModalModule, MatchaModalOptionsComponent, MatchaModalService, MatchaMsgBoxActionsComponent, MatchaMsgBoxComponent, MatchaMsgBoxModule, MatchaOptionComponent, MatchaOptionModule, MatchaOverlayService, MatchaPageBuilderComponent, MatchaPageBuilderModule, MatchaPageLayoutComponent, MatchaPageLayoutModule, MatchaPaginatorComponent, MatchaPaginatorIntl, MatchaPaginatorModule, MatchaPanelComponent, MatchaPanelModule, MatchaPeriodComponent, MatchaPeriodModule, MatchaProgressBarComponent, MatchaProgressBarModule, MatchaRadioComponent, MatchaRadioGroupComponent, MatchaRadioModule, MatchaRippleDirective, MatchaRippleModule, MatchaSelectComponent, MatchaSelectModule, MatchaSelectMultipleComponent, MatchaSelectMultipleModule, MatchaSelectTriggerDirective, MatchaSkeletonComponent, MatchaSkeletonModule, MatchaSlideToggleComponent, MatchaSlideToggleModule, MatchaSliderComponent, MatchaSliderModule, MatchaSnackBarComponent, MatchaSnackBarModule, MatchaSnackBarService, MatchaSpinComponent, MatchaSpinModule, MatchaSpinnerComponent, MatchaSpinnerModule, MatchaStepperComponent, MatchaStepperContentComponent, MatchaStepperControllerComponent, MatchaStepperModule, MatchaStepperStateService, MatchaSubmenuTriggerDirective, MatchaTabItemComponent, MatchaTableComponent, MatchaTableModule, MatchaTabsComponent, MatchaTabsModule, MatchaTextEditorComponent, MatchaTextEditorModule, MatchaTimeComponent, MatchaTimeModule, MatchaTimeRangeComponent, MatchaTimeRangeModule, MatchaTitleComponent, MatchaTitleModule, MatchaToolbarButtonComponent, MatchaToolbarComponent, MatchaToolbarContentComponent, MatchaToolbarCustomButtonComponent, MatchaToolbarMainButtonComponent, MatchaToolbarModule, MatchaTooltipDirective, MatchaTooltipModule, NEW_CONFIG, NextStepDirective, PrevStepDirective, StepComponent, StepContentDirective, buildSunEditorConfig, compatibleOptions, initialConfig, timeMasks, withoutValidation };
+export type { BreakpointState, DrawerMode, DrawerPosition, ILevelClasses, InputTransformFn, MatchaCalendarDayCell, MatchaCalendarMonthCell, MatchaCalendarView, MatchaCalendarYearCell, MatchaDropListConnectedToEvent, MatchaDropListDroppedEvent, MatchaDropZoneDroppedEvent, MatchaMaskConfig, MatchaMaskOptions, MatchaOptionParent, MatchaPeriodDisplayFormat, MatchaPeriodPreset, MatchaPeriodRange, MatchaPeriodValue, MatchaSnackBarConfig, MatchaTextEditorOptions, ModalComponent, OutputTransformFn, PageEvent, PanelPlacement, PanelPosition, SliderOptions, TabChangeEvent };