@muxima-ui/core 1.0.0 → 1.2.0

package/types/muxima-ui-core-chips.d.ts

@@ -0,0 +1,120 @@
+import * as _angular_core from '@angular/core';
+import { ControlValueAccessor } from '@angular/forms';
+import { MxFormFieldControl, MxFormField } from '@muxima-ui/core/form-field';
+
+/**
+ * Etiqueta curta, opcionalmente com botão para remover.
+ *
+ * ```html
+ * <mx-chip>Luanda</mx-chip>
+ * <mx-chip removable (removed)="tirar('Luanda')">Luanda</mx-chip>
+ * ```
+ *
+ * O botão de remover chama-se "Remover Luanda" (o texto do chip). Em listas, põe os chips num
+ * `<ul>` com `<li>`, para o leitor de ecrã dizer quantos são.
+ */
+declare class MxChip {
+    readonly removable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly variant: _angular_core.InputSignal<"default" | "outline" | "accent">;
+    readonly size: _angular_core.InputSignal<"sm" | "md">;
+    /** Verbo do botão de remover, seguido do texto do chip. */
+    readonly removeLabel: _angular_core.InputSignal<string>;
+    readonly removed: _angular_core.OutputEmitterRef<void>;
+    private readonly label;
+    protected readonly text: _angular_core.WritableSignal<string>;
+    constructor();
+    /** Põe o foco no botão de remover (usado pelo MxTagInput). */
+    focusRemove(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MxChip, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MxChip, "mx-chip", ["mxChip"], { "removable": { "alias": "removable"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "removeLabel": { "alias": "removeLabel"; "required": false; "isSignal": true; }; }, { "removed": "removed"; }, never, ["*"], true, never>;
+}
+/**
+ * Chip que liga e desliga, para filtros. É um `<button>` com aria-pressed.
+ *
+ * ```html
+ * <div role="group" aria-label="Estado">
+ *   <button mxChipToggle [(selected)]="soPagas">Pagas</button>
+ * </div>
+ * ```
+ */
+declare class MxChipToggle {
+    readonly selected: _angular_core.ModelSignal<boolean>;
+    readonly size: _angular_core.InputSignal<"sm" | "md">;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MxChipToggle, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MxChipToggle, "button[mxChipToggle]", ["mxChipToggle"], { "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, { "selected": "selectedChange"; }, never, never, true, never>;
+}
+/**
+ * Campo de etiquetas: escreve-se e Enter (ou vírgula) acrescenta; Backspace no campo vazio
+ * vai para a última etiqueta. O valor é `string[]`.
+ *
+ * ```html
+ * <mx-form-field>
+ *   <label mxLabel>Destinatários</label>
+ *   <mx-tag-input formControlName="emails" placeholder="Escreve e carrega Enter" />
+ * </mx-form-field>
+ * ```
+ *
+ * Cada etiqueta acrescentada ou removida é anunciada pelo leitor de ecrã.
+ */
+declare class MxTagInput implements ControlValueAccessor, MxFormFieldControl {
+    readonly value: _angular_core.ModelSignal<string[]>;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    /** Teclas que acrescentam a etiqueta, além de Enter. */
+    readonly separators: _angular_core.InputSignal<string[]>;
+    readonly maxTags: _angular_core.InputSignalWithTransform<number, unknown>;
+    readonly allowDuplicates: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Valida cada etiqueta antes de a acrescentar (ex.: email). Devolve a mensagem de erro ou null. */
+    readonly validate: _angular_core.InputSignal<(tag: string) => string | null>;
+    /** Nome da lista para o leitor de ecrã. */
+    readonly listLabel: _angular_core.InputSignal<string>;
+    readonly helpText: _angular_core.InputSignal<string>;
+    readonly size: _angular_core.InputSignal<"sm" | "md" | "lg">;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly id: _angular_core.InputSignal<string | undefined>;
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    /** Emite a etiqueta rejeitada por `validate`, duplicada ou acima do máximo. */
+    readonly rejected: _angular_core.OutputEmitterRef<{
+        tag: string;
+        reason: string;
+    }>;
+    protected readonly field: MxFormField | null;
+    private readonly ngControl;
+    private readonly announcer;
+    private readonly host;
+    private readonly input;
+    private readonly injector;
+    private readonly generatedId;
+    readonly controlId: _angular_core.Signal<string>;
+    protected readonly helpId: string;
+    protected readonly draft: _angular_core.WritableSignal<string>;
+    protected readonly tags: _angular_core.Signal<string[]>;
+    private readonly formDisabled;
+    protected readonly isDisabled: _angular_core.Signal<boolean>;
+    protected readonly describedBy: _angular_core.Signal<string>;
+    private onChange;
+    private onTouched;
+    constructor();
+    /** Acrescenta uma etiqueta. Devolve false se foi rejeitada. */
+    add(raw: string): boolean;
+    remove(index: number): void;
+    private update;
+    protected onKeydown(event: KeyboardEvent): void;
+    private clearDraft;
+    protected onChipKey(event: KeyboardEvent, index: number): void;
+    protected onPaste(event: ClipboardEvent): void;
+    protected onBlur(): void;
+    protected focusInput(event: MouseEvent): void;
+    errorState(): boolean;
+    isRequired(): boolean;
+    writeValue(value: string[] | null): void;
+    registerOnChange(fn: (value: string[]) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MxTagInput, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MxTagInput, "mx-tag-input", ["mxTagInput"], { "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "separators": { "alias": "separators"; "required": false; "isSignal": true; }; "maxTags": { "alias": "maxTags"; "required": false; "isSignal": true; }; "allowDuplicates": { "alias": "allowDuplicates"; "required": false; "isSignal": true; }; "validate": { "alias": "validate"; "required": false; "isSignal": true; }; "listLabel": { "alias": "listLabel"; "required": false; "isSignal": true; }; "helpText": { "alias": "helpText"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "rejected": "rejected"; }, never, never, true, never>;
+}
+
+export { MxChip, MxChipToggle, MxTagInput };

package/types/muxima-ui-core-clipboard.d.ts

@@ -0,0 +1,42 @@
+import * as _angular_core from '@angular/core';
+
+/**
+ * Copia texto para a área de transferência quando o elemento é clicado.
+ * Durante 2 s o elemento fica com data-copied, e "Copiado" é anunciado ao leitor de ecrã.
+ *
+ * ```html
+ * <button mxButton variant="outline" [mxCopy]="iban">Copiar IBAN</button>
+ * ```
+ */
+declare class MxCopy {
+    readonly text: _angular_core.InputSignal<string>;
+    /** Mensagem anunciada ao copiar. */
+    readonly copiedMessage: _angular_core.InputSignal<string>;
+    readonly copiedChange: _angular_core.OutputEmitterRef<boolean>;
+    private readonly clipboard;
+    private readonly announcer;
+    readonly copied: _angular_core.WritableSignal<boolean>;
+    private timer?;
+    constructor();
+    /** Copia; devolve false se o navegador recusar. */
+    copy(): boolean;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MxCopy, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MxCopy, "[mxCopy]", ["mxCopy"], { "text": { "alias": "mxCopy"; "required": true; "isSignal": true; }; "copiedMessage": { "alias": "mxCopyMessage"; "required": false; "isSignal": true; }; }, { "copiedChange": "mxCopied"; }, never, never, true, never>;
+}
+/**
+ * Botão de ícone que copia um valor. O nome acessível muda para "Copiado" durante 2 s.
+ *
+ * ```html
+ * <button mxCopyButton [value]="chave" label="Copiar chave da API"></button>
+ * ```
+ */
+declare class MxCopyButton {
+    protected readonly copy: MxCopy;
+    readonly label: _angular_core.InputSignal<string>;
+    readonly copiedLabel: _angular_core.InputSignal<string>;
+    readonly size: _angular_core.InputSignal<"sm" | "md">;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MxCopyButton, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MxCopyButton, "button[mxCopyButton]", ["mxCopyButton"], { "label": { "alias": "label"; "required": false; "isSignal": true; }; "copiedLabel": { "alias": "copiedLabel"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, [{ directive: typeof MxCopy; inputs: { "mxCopy": "value"; }; outputs: { "mxCopied": "mxCopied"; }; }]>;
+}
+
+export { MxCopy, MxCopyButton };

package/types/muxima-ui-core-color-picker.d.ts

@@ -0,0 +1,153 @@
+import * as _angular_core from '@angular/core';
+import { ConnectedPosition } from '@angular/cdk/overlay';
+import { ControlValueAccessor } from '@angular/forms';
+import { MxFormFieldControl, MxFormField } from '@muxima-ui/core/form-field';
+
+/** Cor em HSV (h 0–360, s e v 0–1) com opacidade a 0–1. */
+interface MxHsva {
+    h: number;
+    s: number;
+    v: number;
+    a: number;
+}
+/**
+ * Lê uma cor escrita: "#1f6f78", "1f6f78", "#1f6", "#1f6f7880" ou "rgb(31, 111, 120)" / "rgba(...)".
+ * Devolve o hex normalizado ("#1F6F78" ou "#1F6F7880" com opacidade) ou null.
+ */
+declare function mxParseColor(text: string): string | null;
+declare function mxHexToRgba(hex: string): {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+};
+declare function mxHexToHsva(hex: string): MxHsva;
+declare function mxHsvaToHex({ h, s, v, a }: MxHsva): string;
+/** Contraste WCAG entre duas cores (1 a 21). */
+declare function mxContrast(a: string, b: string): number;
+/** Nome aproximado da cor em português, para o leitor de ecrã: "azul escuro", "cinzento claro". */
+declare function mxColorName(hex: string): string;
+
+/** Amostra pronta: só a cor, ou cor e nome. */
+type MxColorSwatch = string | {
+    color: string;
+    label: string;
+};
+/**
+ * Editor de cor: área de saturação e brilho, matiz, opacidade opcional, campo hex,
+ * amostras e conta-gotas (quando o navegador o tem). O valor é um hex ("#1F6F78",
+ * ou "#1F6F7880" com opacidade).
+ *
+ * ```html
+ * <mx-color-panel [(value)]="cor" [swatches]="marca" />
+ * ```
+ *
+ * Teclado na área: ← → mudam a saturação, ↑ ↓ o brilho (Shift para passos de 10).
+ * A matiz e a opacidade são input range nativos.
+ */
+declare class MxColorPanel {
+    readonly value: _angular_core.ModelSignal<string | null>;
+    /** Mostra o controlo de opacidade e devolve hex de 8 dígitos quando < 100%. */
+    readonly alpha: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly swatches: _angular_core.InputSignal<MxColorSwatch[]>;
+    readonly showInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Só as amostras: uma paleta fechada, sem área nem matiz. */
+    readonly swatchesOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly areaLabel: _angular_core.InputSignal<string>;
+    readonly hueLabel: _angular_core.InputSignal<string>;
+    readonly alphaLabel: _angular_core.InputSignal<string>;
+    readonly swatchesLabel: _angular_core.InputSignal<string>;
+    /** Emite ao largar o rato, escolher amostra ou terminar de escrever (para guardar). */
+    readonly committed: _angular_core.OutputEmitterRef<string>;
+    private readonly area;
+    protected readonly inputId: string;
+    protected readonly eyeDropper: boolean;
+    /** HSVA interno: guarda a matiz quando a cor é cinzenta (o hex não a tem). */
+    protected readonly hsva: _angular_core.WritableSignal<MxHsva>;
+    protected readonly hex: _angular_core.Signal<string>;
+    protected readonly opaque: _angular_core.Signal<string>;
+    protected readonly draft: _angular_core.WritableSignal<string | null>;
+    protected readonly draftInvalid: _angular_core.Signal<boolean>;
+    protected readonly hueName: _angular_core.Signal<string>;
+    protected readonly areaText: _angular_core.Signal<string>;
+    protected readonly swatchList: _angular_core.Signal<{
+        color: string;
+        label: string;
+    }[]>;
+    constructor();
+    protected round(n: number): number;
+    protected pct(n: number): number;
+    private update;
+    setHex(hex: string): void;
+    protected setHue(e: Event): void;
+    protected setAlpha(e: Event): void;
+    protected onHexInput(e: Event): void;
+    protected onAreaKey(e: KeyboardEvent): void;
+    protected onAreaDown(e: PointerEvent): void;
+    protected pickFromScreen(): Promise<void>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MxColorPanel, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MxColorPanel, "mx-color-panel", ["mxColorPanel"], { "value": { "alias": "value"; "required": false; "isSignal": true; }; "alpha": { "alias": "alpha"; "required": false; "isSignal": true; }; "swatches": { "alias": "swatches"; "required": false; "isSignal": true; }; "showInput": { "alias": "showInput"; "required": false; "isSignal": true; }; "swatchesOnly": { "alias": "swatchesOnly"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "areaLabel": { "alias": "areaLabel"; "required": false; "isSignal": true; }; "hueLabel": { "alias": "hueLabel"; "required": false; "isSignal": true; }; "alphaLabel": { "alias": "alphaLabel"; "required": false; "isSignal": true; }; "swatchesLabel": { "alias": "swatchesLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "committed": "committed"; }, never, never, true, never>;
+}
+
+/**
+ * Campo de cor: escreve-se o hex (ou rgb()) ou escolhe-se no painel que abre no botão
+ * da amostra. Funciona com ngModel e Reactive Forms; o valor é um hex ou null.
+ *
+ * ```html
+ * <mx-form-field>
+ *   <label mxLabel>Cor da marca</label>
+ *   <mx-color-picker formControlName="cor" [swatches]="sugestoes" />
+ * </mx-form-field>
+ * ```
+ */
+declare class MxColorPicker implements ControlValueAccessor, MxFormFieldControl {
+    readonly value: _angular_core.ModelSignal<string | null>;
+    readonly alpha: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly swatches: _angular_core.InputSignal<MxColorSwatch[]>;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    readonly dialogLabel: _angular_core.InputSignal<string>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly size: _angular_core.InputSignal<"sm" | "md" | "lg">;
+    readonly id: _angular_core.InputSignal<string | undefined>;
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    protected readonly field: MxFormField | null;
+    private readonly ngControl;
+    private readonly host;
+    private readonly toggleButton;
+    private readonly panel;
+    protected readonly positions: ConnectedPosition[];
+    private readonly generatedId;
+    readonly controlId: _angular_core.Signal<string>;
+    protected readonly isOpen: _angular_core.WritableSignal<boolean>;
+    protected readonly draft: _angular_core.WritableSignal<string | null>;
+    private readonly formDisabled;
+    protected readonly isDisabled: _angular_core.Signal<boolean>;
+    readonly badFormat: _angular_core.Signal<boolean>;
+    protected readonly toggleLabel: _angular_core.Signal<string>;
+    private onChange;
+    private onTouched;
+    constructor();
+    open(): void;
+    toggle(): void;
+    close(restoreFocus?: boolean): void;
+    protected onAttach(): void;
+    protected onOverlayKey(e: KeyboardEvent): void;
+    protected onOutside(e: MouseEvent): void;
+    protected setValue(v: string | null): void;
+    protected onInput(e: Event): void;
+    protected onBlur(): void;
+    errorState(): boolean;
+    isRequired(): boolean;
+    writeValue(value: string | null): void;
+    registerOnChange(fn: (value: string | null) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MxColorPicker, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MxColorPicker, "mx-color-picker", ["mxColorPicker"], { "value": { "alias": "value"; "required": false; "isSignal": true; }; "alpha": { "alias": "alpha"; "required": false; "isSignal": true; }; "swatches": { "alias": "swatches"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "dialogLabel": { "alias": "dialogLabel"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+}
+
+export { MxColorPanel, MxColorPicker, mxColorName, mxContrast, mxHexToHsva, mxHexToRgba, mxHsvaToHex, mxParseColor };
+export type { MxColorSwatch, MxHsva };

package/types/muxima-ui-core-date-picker.d.ts

@@ -6,13 +6,22 @@ import { MxFormFieldControl, MxFormField } from '@muxima-ui/core/form-field';
 /** Data sem horas, para comparar dias. */
 declare function mxStartOfDay(d: Date): Date;
 declare function mxSameDay(a: Date | null | undefined, b: Date | null | undefined): boolean;
+/** Intervalo de datas. Enquanto se escolhe, `end` fica null. */
+interface MxDateRange {
+    start: Date | null;
+    end: Date | null;
+}
 /**
  * Calendário mensal acessível (grelha WAI-ARIA). Pode ser usado sozinho ou dentro do MxDatePicker.
  *
  * ```html
  * <mx-calendar [(value)]="data" [min]="hoje" />
+ * <mx-calendar mode="range" [(range)]="periodo" />
  * ```
  *
+ * Em `mode="range"` o primeiro clique marca o início e o segundo o fim (se for anterior,
+ * os dois trocam). Entre os dois cliques o intervalo é pré-visualizado com o rato ou o teclado.
+ *
  * Teclas: setas (dia e semana), Home/End (início e fim da semana), Page Up/Down (mês),
  * Shift + Page Up/Down (ano), Enter ou Espaço para escolher.
  */
@@ -26,12 +35,26 @@ declare class MxCalendar {
     /** Primeiro dia da semana: 1 = segunda-feira. */
     readonly firstDayOfWeek: _angular_core.InputSignal<number>;
     readonly selected: _angular_core.OutputEmitterRef<Date>;
+    /** `single` escolhe um dia; `range` escolhe um intervalo em [(range)]. */
+    readonly mode: _angular_core.InputSignal<"single" | "range">;
+    readonly range: _angular_core.ModelSignal<MxDateRange | null>;
+    /** Emite quando o intervalo fica completo (início e fim). */
+    readonly rangeSelected: _angular_core.OutputEmitterRef<{
+        start: Date;
+        end: Date;
+    }>;
     private readonly host;
     private readonly injector;
     protected readonly titleId: string;
     /** Dia com foco na grelha. */
     readonly focusDate: _angular_core.WritableSignal<Date>;
     private initialised;
+    /** Dia sob o rato ou o foco enquanto falta o fim do intervalo. */
+    private readonly preview;
+    private readonly awaitingEnd;
+    protected readonly rangeHint: _angular_core.Signal<string>;
+    /** Início e fim efectivos (com pré-visualização), ordenados. */
+    private readonly bounds;
     protected readonly weekdays: _angular_core.Signal<{
         short: string;
         long: string;
@@ -42,6 +65,9 @@ declare class MxCalendar {
         label: string;
         outside: boolean;
         today: boolean;
+        rangeStart: boolean;
+        rangeEnd: boolean;
+        inRange: boolean;
         selected: boolean;
         focus: boolean;
         disabled: boolean;
@@ -51,13 +77,14 @@ declare class MxCalendar {
     focus(): void;
     protected monthLabel(delta: number): string;
     protected moveMonth(delta: number): void;
+    protected hover(date: Date): void;
     protected select(date: Date): void;
     protected onKeydown(event: KeyboardEvent): void;
     private clamp;
     private isDisabled;
     private focusActiveDay;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MxCalendar, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MxCalendar, "mx-calendar", ["mxCalendar"], { "value": { "alias": "value"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "dateDisabled": { "alias": "dateDisabled"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "selected": "selected"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MxCalendar, "mx-calendar", ["mxCalendar"], { "value": { "alias": "value"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "dateDisabled": { "alias": "dateDisabled"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "range": { "alias": "range"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "selected": "selected"; "range": "rangeChange"; "rangeSelected": "rangeSelected"; }, never, never, true, never>;
 }
 
 /** Converte "dd/mm/aaaa" numa data. Aceita também "-" e "." como separadores. */
@@ -130,4 +157,105 @@ declare class MxDatePicker implements ControlValueAccessor, MxFormFieldControl {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<MxDatePicker, "mx-date-picker", ["mxDatePicker"], { "value": { "alias": "value"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "dateDisabled": { "alias": "dateDisabled"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
 }
 
-export { MxCalendar, MxDatePicker, mxFormatDate, mxParseDate, mxSameDay, mxStartOfDay };
+/** Atalho de intervalo mostrado ao lado do calendário. */
+interface MxDateRangePreset {
+    label: string;
+    /** Função, para que "hoje" seja calculado no momento do clique. */
+    range: () => {
+        start: Date;
+        end: Date;
+    };
+}
+/** Atalhos comuns: últimos 7 e 30 dias, este mês e o mês passado. */
+declare function mxDefaultRangePresets(): MxDateRangePreset[];
+/**
+ * Campo de intervalo de datas: dois campos (início e fim) que se escrevem em "dd/mm/aaaa"
+ * ou se escolhem num calendário, com atalhos opcionais.
+ *
+ * ```html
+ * <mx-form-field>
+ *   <label mxLabel>Período</label>
+ *   <mx-date-range-picker formControlName="periodo" [presets]="atalhos" />
+ * </mx-form-field>
+ * ```
+ *
+ * O valor é `{ start, end }` (datas sem horas) ou null. Cada campo é anunciado com o rótulo
+ * do campo e "início" ou "fim". Fim anterior ao início deixa o campo com erro.
+ */
+declare class MxDateRangePicker implements ControlValueAccessor, MxFormFieldControl {
+    readonly value: _angular_core.ModelSignal<MxDateRange | null>;
+    readonly min: _angular_core.InputSignal<Date | null>;
+    readonly max: _angular_core.InputSignal<Date | null>;
+    readonly dateDisabled: _angular_core.InputSignal<(d: Date) => boolean>;
+    readonly presets: _angular_core.InputSignal<MxDateRangePreset[]>;
+    readonly locale: _angular_core.InputSignal<string>;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    readonly startLabel: _angular_core.InputSignal<string>;
+    readonly endLabel: _angular_core.InputSignal<string>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly size: _angular_core.InputSignal<"sm" | "md" | "lg">;
+    readonly id: _angular_core.InputSignal<string | undefined>;
+    /** Nome do campo quando não há mxLabel. */
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    protected readonly field: MxFormField | null;
+    private readonly ngControl;
+    private readonly host;
+    private readonly calendar;
+    private readonly toggleButton;
+    protected readonly positions: ConnectedPosition[];
+    private readonly generatedId;
+    readonly controlId: _angular_core.Signal<string>;
+    protected readonly startLabelId: string;
+    protected readonly endLabelId: string;
+    protected readonly nameId: string;
+    protected readonly isOpen: _angular_core.WritableSignal<boolean>;
+    /** Intervalo a ser escolhido no calendário aberto. */
+    protected readonly draftRange: _angular_core.WritableSignal<MxDateRange | null>;
+    /** Texto escrito que ainda não é uma data válida, por campo. */
+    private readonly draftText;
+    private readonly formDisabled;
+    protected readonly isDisabled: _angular_core.Signal<boolean>;
+    protected readonly startText: _angular_core.Signal<string>;
+    protected readonly endText: _angular_core.Signal<string>;
+    /** true quando há texto que não é data, ou o fim é anterior ao início. */
+    readonly badFormat: _angular_core.Signal<boolean>;
+    protected readonly toggleLabel: _angular_core.Signal<string>;
+    private onChange;
+    protected onTouched: () => void;
+    constructor();
+    /** aria-labelledby: rótulo do form field (ou aria-label) + "início"/"fim". */
+    protected labelledBy(partId: string): string;
+    protected readonly nameText: _angular_core.Signal<string>;
+    open(): void;
+    toggle(): void;
+    close(restoreFocus?: boolean): void;
+    protected onAttach(): void;
+    protected onOverlayKey(event: KeyboardEvent): void;
+    protected onOutside(event: MouseEvent): void;
+    protected choose(range: {
+        start: Date;
+        end: Date;
+    }): void;
+    protected applyPreset(p: MxDateRangePreset): void;
+    protected onInput(part: 'start' | 'end', event: Event): void;
+    private setValue;
+    errorState(): boolean;
+    isRequired(): boolean;
+    writeValue(value: MxDateRange | null): void;
+    registerOnChange(fn: (value: MxDateRange | null) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MxDateRangePicker, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MxDateRangePicker, "mx-date-range-picker", ["mxDateRangePicker"], { "value": { "alias": "value"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "dateDisabled": { "alias": "dateDisabled"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "startLabel": { "alias": "startLabel"; "required": false; "isSignal": true; }; "endLabel": { "alias": "endLabel"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+}
+/** Validador: exige início e fim. Usa com `Validators.required` não chega, porque {start, end: null} não é vazio. */
+declare function mxDateRangeComplete(control: {
+    value: MxDateRange | null;
+}): {
+    rangeIncomplete: true;
+} | null;
+
+export { MxCalendar, MxDatePicker, MxDateRangePicker, mxDateRangeComplete, mxDefaultRangePresets, mxFormatDate, mxParseDate, mxSameDay, mxStartOfDay };
+export type { MxDateRange, MxDateRangePreset };

package/types/muxima-ui-core-file-upload.d.ts

@@ -0,0 +1,96 @@
+import * as _angular_core from '@angular/core';
+import { ControlValueAccessor } from '@angular/forms';
+import { MxFormFieldControl, MxFormField } from '@muxima-ui/core/form-field';
+
+interface MxFileRejection {
+    file: File;
+    reason: 'type' | 'size' | 'count';
+    message: string;
+}
+/** "1,2 MB", "340 kB". */
+declare function mxFormatBytes(bytes: number, locale?: string): string;
+/** true se o ficheiro corresponde a `accept` (".pdf,image/*"). */
+declare function mxFileMatches(file: File, accept: string): boolean;
+/**
+ * Envio de ficheiros: arrastar para a área ou carregar no botão (que abre o seletor nativo).
+ * Valida tipo, tamanho e número, mostra a lista com tamanho, progresso e botão de remover.
+ *
+ * ```html
+ * <mx-form-field>
+ *   <label mxLabel>Comprovativos</label>
+ *   <mx-file-upload formControlName="ficheiros" accept=".pdf,image/*" [maxSize]="5_000_000" multiple />
+ *   <mx-hint>PDF ou imagem, até 5 MB cada.</mx-hint>
+ * </mx-form-field>
+ * ```
+ *
+ * O valor é `File[]`. O envio para o servidor fica do teu lado: passa a percentagem de cada
+ * ficheiro em `[progress]` (pelo nome) e os erros em `[errors]`.
+ */
+declare class MxFileUpload implements ControlValueAccessor, MxFormFieldControl {
+    readonly value: _angular_core.ModelSignal<File[]>;
+    /** Tipos aceites, como no input nativo: ".pdf,image/*". */
+    readonly accept: _angular_core.InputSignal<string>;
+    readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Tamanho máximo de cada ficheiro, em bytes. */
+    readonly maxSize: _angular_core.InputSignalWithTransform<number, unknown>;
+    readonly maxFiles: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Percentagem de envio por nome de ficheiro. */
+    readonly progress: _angular_core.InputSignal<Record<string, number>>;
+    /** Erro de envio por nome de ficheiro. */
+    readonly errors: _angular_core.InputSignal<Record<string, string>>;
+    readonly dropText: _angular_core.InputSignal<string>;
+    readonly buttonText: _angular_core.InputSignal<string>;
+    /** Linha de ajuda dentro da área (ex.: "PDF até 5 MB"). */
+    readonly description: _angular_core.InputSignal<string>;
+    readonly listLabel: _angular_core.InputSignal<string>;
+    readonly removeText: _angular_core.InputSignal<string>;
+    readonly doneText: _angular_core.InputSignal<string>;
+    readonly locale: _angular_core.InputSignal<string>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly id: _angular_core.InputSignal<string | undefined>;
+    readonly rejected: _angular_core.OutputEmitterRef<MxFileRejection[]>;
+    protected readonly field: MxFormField | null;
+    private readonly ngControl;
+    private readonly announcer;
+    private readonly host;
+    private readonly input;
+    private readonly injector;
+    private readonly generatedId;
+    readonly controlId: _angular_core.Signal<string>;
+    protected readonly descId: string;
+    protected readonly files: _angular_core.Signal<File[]>;
+    protected readonly dragging: _angular_core.WritableSignal<boolean>;
+    protected readonly rejections: _angular_core.WritableSignal<MxFileRejection[]>;
+    private readonly formDisabled;
+    protected readonly isDisabled: _angular_core.Signal<boolean>;
+    protected readonly describedBy: _angular_core.Signal<string | null>;
+    private dragDepth;
+    private onChange;
+    private onTouched;
+    constructor();
+    protected size(bytes: number): string;
+    /** Abre o seletor de ficheiros do sistema. */
+    browse(): void;
+    /** Acrescenta ficheiros, com as mesmas validações do arrastar e do seletor. */
+    addFiles(list: Iterable<File> | ArrayLike<File>): void;
+    remove(index: number): void;
+    private update;
+    protected onPick(event: Event): void;
+    protected onDragEnter(event: DragEvent): void;
+    protected onDragOver(event: DragEvent): void;
+    protected onDragLeave(event: DragEvent): void;
+    protected onDrop(event: DragEvent): void;
+    errorState(): boolean;
+    isRequired(): boolean;
+    writeValue(value: File[] | null): void;
+    registerOnChange(fn: (value: File[]) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MxFileUpload, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MxFileUpload, "mx-file-upload", ["mxFileUpload"], { "value": { "alias": "value"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "maxSize": { "alias": "maxSize"; "required": false; "isSignal": true; }; "maxFiles": { "alias": "maxFiles"; "required": false; "isSignal": true; }; "progress": { "alias": "progress"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "dropText": { "alias": "dropText"; "required": false; "isSignal": true; }; "buttonText": { "alias": "buttonText"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "listLabel": { "alias": "listLabel"; "required": false; "isSignal": true; }; "removeText": { "alias": "removeText"; "required": false; "isSignal": true; }; "doneText": { "alias": "doneText"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "rejected": "rejected"; }, never, never, true, never>;
+}
+
+export { MxFileUpload, mxFileMatches, mxFormatBytes };
+export type { MxFileRejection };