@muxima-ui/core 1.0.0 → 1.1.0

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

@@ -1,6 +1,7 @@
-import * as i0 from '@angular/core';
+import * as _angular_core from '@angular/core';
 import { OnInit } from '@angular/core';
-import { MxNativeControl } from '@muxima-ui/core/form-field';
+import { MxNativeControl, MxFormFieldControl, MxFormField } from '@muxima-ui/core/form-field';
+import { ControlValueAccessor } from '@angular/forms';
 
 /**
  * Cursor de intervalo sobre o `<input type="range">` nativo: setas, Page Up/Down,
@@ -15,13 +16,74 @@ import { MxNativeControl } from '@muxima-ui/core/form-field';
  */
 declare class MxSlider extends MxNativeControl implements OnInit {
     /** Espessura da barra: sm 4 px, md 6 px, lg 8 px. */
-    readonly size: i0.InputSignal<"sm" | "md" | "lg">;
+    readonly size: _angular_core.InputSignal<"sm" | "md" | "lg">;
     constructor();
     private readonly destroyRef;
     ngOnInit(): void;
     protected paint(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MxSlider, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MxSlider, "input[type=range][mxSlider]", ["mxSlider"], { "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MxSlider, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MxSlider, "input[type=range][mxSlider]", ["mxSlider"], { "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-export { MxSlider };
+/**
+ * Intervalo com dois cursores (mínimo e máximo), feito com dois `<input type="range">`
+ * nativos: cada cursor tem o seu teclado e é anunciado como "Preço, mínimo, 20 000 Kz".
+ *
+ * ```html
+ * <mx-form-field>
+ *   <label mxLabel>Preço</label>
+ *   <mx-range-slider formControlName="preco" [min]="0" [max]="100000" [step]="1000" [format]="kz" />
+ * </mx-form-field>
+ * ```
+ *
+ * O valor é `[mínimo, máximo]`. Os cursores não se cruzam: ficam a pelo menos `minGap` um do outro.
+ */
+declare class MxRangeSlider implements ControlValueAccessor, MxFormFieldControl {
+    readonly value: _angular_core.ModelSignal<[number, number] | null>;
+    readonly min: _angular_core.InputSignalWithTransform<number, unknown>;
+    readonly max: _angular_core.InputSignalWithTransform<number, unknown>;
+    readonly step: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Distância mínima entre os dois cursores. */
+    readonly minGap: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Texto de cada valor, para o leitor de ecrã e as etiquetas. */
+    readonly format: _angular_core.InputSignal<(v: number) => string>;
+    /** Mostra os dois valores por baixo da barra. */
+    readonly showValues: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly lowLabel: _angular_core.InputSignal<string>;
+    readonly highLabel: _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;
+    private readonly generatedId;
+    readonly controlId: _angular_core.Signal<string>;
+    protected readonly lowId: string;
+    protected readonly highId: string;
+    protected readonly nameId: string;
+    private readonly formDisabled;
+    protected readonly isDisabled: _angular_core.Signal<boolean>;
+    protected readonly low: _angular_core.Signal<number>;
+    protected readonly high: _angular_core.Signal<number>;
+    private pct;
+    protected readonly fromPct: _angular_core.Signal<number>;
+    protected readonly toPct: _angular_core.Signal<number>;
+    private onChange;
+    protected onTouched: () => void;
+    constructor();
+    protected labelledBy(partId: string): string;
+    protected onInput(which: 0 | 1, event: Event): void;
+    errorState(): boolean;
+    isRequired(): boolean;
+    writeValue(value: [number, number] | null): void;
+    registerOnChange(fn: (value: [number, number] | null) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MxRangeSlider, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MxRangeSlider, "mx-range-slider", ["mxRangeSlider"], { "value": { "alias": "value"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "minGap": { "alias": "minGap"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; "lowLabel": { "alias": "lowLabel"; "required": false; "isSignal": true; }; "highLabel": { "alias": "highLabel"; "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 { MxRangeSlider, MxSlider };

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

@@ -0,0 +1,83 @@
+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';
+
+/**
+ * Converte o que se escreve numa hora "HH:mm". Aceita "9", "930", "9:30", "9h30", "9.30" e "21h".
+ * Devolve null se não for uma hora válida.
+ */
+declare function mxParseTime(text: string): string | null;
+/** Minutos desde a meia-noite de uma hora "HH:mm". */
+declare function mxTimeToMinutes(time: string): number;
+/**
+ * Campo de hora: escreve-se (9, 930, 9h30, 09:30) ou escolhe-se numa lista com o intervalo
+ * definido em `step`. Padrão WAI-ARIA "combobox com lista".
+ *
+ * ```html
+ * <mx-form-field>
+ *   <label mxLabel>Hora da reunião</label>
+ *   <mx-time-picker formControlName="hora" [step]="15" min="08:00" max="18:00" />
+ * </mx-form-field>
+ * ```
+ *
+ * O valor é uma string "HH:mm" (24 horas) ou null. Uma hora fora de min/max deixa o campo com erro.
+ * Para uma hora isolada sem lista, o input type=time nativo com mxInput também serve.
+ */
+declare class MxTimePicker implements ControlValueAccessor, MxFormFieldControl {
+    readonly value: _angular_core.ModelSignal<string | null>;
+    /** Minutos entre as horas da lista. */
+    readonly step: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Primeira e última hora permitidas, "HH:mm". */
+    readonly min: _angular_core.InputSignal<string | null>;
+    readonly max: _angular_core.InputSignal<string | null>;
+    readonly placeholder: _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;
+    protected readonly positions: ConnectedPosition[];
+    protected readonly listId: string;
+    private readonly generatedId;
+    readonly controlId: _angular_core.Signal<string>;
+    protected readonly isOpen: _angular_core.WritableSignal<boolean>;
+    protected readonly panelWidth: _angular_core.WritableSignal<number>;
+    protected readonly active: _angular_core.WritableSignal<number>;
+    private readonly draft;
+    private readonly formDisabled;
+    protected readonly isDisabled: _angular_core.Signal<boolean>;
+    protected readonly text: _angular_core.Signal<string>;
+    protected readonly slots: _angular_core.Signal<string[]>;
+    /** Texto que não é hora, ou hora fora de min/max. */
+    readonly badValue: _angular_core.Signal<boolean>;
+    private onChange;
+    private onTouched;
+    constructor();
+    protected optionId(i: number): string;
+    /** Índice da hora da lista mais próxima de um valor (ou da hora actual). */
+    private nearest;
+    open(): void;
+    close(): void;
+    protected scrollToActive(): void;
+    protected choose(time: string): void;
+    protected onInput(event: Event): void;
+    protected onKeydown(event: KeyboardEvent): void;
+    protected onOutside(event: MouseEvent): void;
+    protected onBlur(): void;
+    private setValue;
+    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<MxTimePicker, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MxTimePicker, "mx-time-picker", ["mxTimePicker"], { "value": { "alias": "value"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "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 { MxTimePicker, mxParseTime, mxTimeToMinutes };

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

@@ -1,3 +1,3 @@
-declare const MUXIMA_VERSION = "1.0.0";
+declare const MUXIMA_VERSION = "1.1.0";
 
 export { MUXIMA_VERSION };