@muxima-ui/core 1.0.0 → 1.1.0

package/styles/components/time-picker.css

@@ -0,0 +1,39 @@
+/* ---------- Time picker ---------- */
+
+.mx-time-picker {
+  display: block;
+  width: 100%;
+  font-family: var(--mx-font-sans);
+}
+.mx-time-picker-field {
+  position: relative;
+}
+.mx-time-picker-input.mx-input {
+  padding-right: 36px;
+  font-variant-numeric: tabular-nums;
+}
+.mx-time-picker-icon {
+  position: absolute;
+  right: 11px;
+  top: 50%;
+  width: 16px;
+  height: 16px;
+  color: var(--mx-muted);
+  transform: translateY(-50%);
+  pointer-events: none;
+}
+.mx-time-picker-panel {
+  max-height: 240px;
+  font-variant-numeric: tabular-nums;
+}
+ul.mx-time-picker-panel {
+  list-style: none;
+}
+.mx-time-picker[data-mx-state='hover'] .mx-input:not(:disabled) {
+  border-color: var(--mx-muted);
+}
+.mx-time-picker[data-mx-state='focus'] .mx-input {
+  border-color: var(--mx-accent);
+  outline: var(--mx-focus-width) solid var(--mx-accent);
+  outline-offset: var(--mx-focus-offset);
+}

package/styles/muxima.css

@@ -25,9 +25,12 @@
 @import './components/tabs.css';
 @import './components/table.css';
 @import './components/badge.css';
+@import './components/chips.css';
 @import './components/card.css';
 @import './components/alert.css';
 @import './components/separator.css';
+@import './components/rating.css';
+@import './components/clipboard.css';
 @import './components/avatar.css';
 @import './components/skeleton.css';
 @import './components/progress.css';
@@ -41,7 +44,9 @@
 @import './components/pagination.css';
 @import './components/combobox.css';
 @import './components/date-picker.css';
+@import './components/time-picker.css';
 @import './components/otp.css';
+@import './components/file-upload.css';
 @import './components/stepper.css';
 @import './components/command.css';
 @import './motion.css';

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-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 };

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

@@ -0,0 +1,64 @@
+import * as _angular_core from '@angular/core';
+import { ControlValueAccessor } from '@angular/forms';
+import { MxFormFieldControl, MxFormField } from '@muxima-ui/core/form-field';
+
+/**
+ * Avaliação com estrelas. Para escolher, são botões de rádio nativos (setas mudam a nota,
+ * Tab sai do grupo); em `readonly` é uma imagem com o texto "4 de 5 estrelas".
+ *
+ * ```html
+ * <mx-form-field>
+ *   <label mxLabel>Como correu o atendimento?</label>
+ *   <mx-rating formControlName="nota" />
+ * </mx-form-field>
+ * <mx-rating [value]="4.5" readonly />
+ * ```
+ */
+declare class MxRating implements ControlValueAccessor, MxFormFieldControl {
+    readonly value: _angular_core.ModelSignal<number | null>;
+    readonly max: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Só mostra a nota (aceita meias estrelas, ex.: 4,5). */
+    readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Carregar outra vez na nota escolhida limpa a avaliação. */
+    readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Mostra o número ao lado ("4,5"). */
+    readonly showValue: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly starLabel: _angular_core.InputSignal<(n: number) => string>;
+    readonly locale: _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>;
+    protected readonly field: MxFormField | null;
+    private readonly ngControl;
+    protected readonly star = "M12 3.2l2.7 5.6 6.1.8-4.5 4.2 1.1 6.1L12 17l-5.4 2.9 1.1-6.1-4.5-4.2 6.1-.8z";
+    protected readonly name: string;
+    private readonly generatedId;
+    readonly controlId: _angular_core.Signal<string>;
+    protected readonly hover: _angular_core.WritableSignal<number>;
+    private readonly formDisabled;
+    protected readonly isDisabled: _angular_core.Signal<boolean>;
+    protected readonly stars: _angular_core.Signal<number[]>;
+    protected readonly shown: _angular_core.Signal<number>;
+    protected readonly valueText: _angular_core.Signal<string>;
+    protected readonly readonlyLabel: _angular_core.Signal<string>;
+    private onChange;
+    protected onTouched: () => void;
+    constructor();
+    protected fillPct(s: number): number;
+    protected choose(s: number): void;
+    protected onClick(s: number): void;
+    private set;
+    errorState(): boolean;
+    isRequired(): boolean;
+    writeValue(value: number | null): void;
+    registerOnChange(fn: (value: number | null) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MxRating, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MxRating, "mx-rating", ["mxRating"], { "value": { "alias": "value"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "showValue": { "alias": "showValue"; "required": false; "isSignal": true; }; "starLabel": { "alias": "starLabel"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "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"; }, never, never, true, never>;
+}
+
+export { MxRating };