@truenas/ui-components 0.1.64 → 0.1.66

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@truenas/ui-components",
-  "version": "0.1.64",
+  "version": "0.1.66",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "public"

package/types/truenas-ui-components.d.ts

@@ -952,11 +952,12 @@ interface IconButtonHarnessFilters extends BaseHarnessFilters {
 
 declare enum InputType {
     Email = "email",
+    Number = "number",
     Password = "password",
     PlainText = "text"
 }
 
-declare class TnInputComponent implements AfterViewInit, ControlValueAccessor {
+declare class TnInputComponent implements AfterViewInit, OnDestroy, ControlValueAccessor {
     inputEl: _angular_core.Signal<ElementRef<HTMLInputElement | HTMLTextAreaElement>>;
     inputType: _angular_core.InputSignal<InputType>;
     placeholder: _angular_core.InputSignal<string>;
@@ -964,6 +965,25 @@ declare class TnInputComponent implements AfterViewInit, ControlValueAccessor {
     disabled: _angular_core.InputSignal<boolean>;
     multiline: _angular_core.InputSignal<boolean>;
     rows: _angular_core.InputSignal<number>;
+    /**
+     * Accessible name for the control. Rendered as `aria-label` on the input/textarea.
+     *
+     * Leave unset when the input is wrapped in a `tn-form-field` (or otherwise has a
+     * visible `<label>`); set it for standalone usage so the control isn't unnamed in
+     * the a11y tree.
+     */
+    ariaLabel: _angular_core.InputSignal<string | undefined>;
+    /**
+     * Integer/decimal switch — only meaningful when `inputType` is `InputType.Number`.
+     *
+     * - **`true` (default) → decimal mode**: accepts a single `.` and emits via
+     *   `parseFloat`, so a `Number` field accepts `"3.5"` out of the box.
+     * - **`false` → integer mode**: strips `.` and emits via `parseInt`.
+     *
+     * Range enforcement is intentionally left to the consumer's form validators
+     * (e.g. `Validators.min`/`max`), which work because the control emits real numbers.
+     */
+    allowDecimals: _angular_core.InputSignal<boolean>;
     prefixIcon: _angular_core.InputSignal<string | undefined>;
     prefixIconLibrary: _angular_core.InputSignal<IconLibraryType | undefined>;
     suffixIcon: _angular_core.InputSignal<string | undefined>;
@@ -972,22 +992,37 @@ declare class TnInputComponent implements AfterViewInit, ControlValueAccessor {
     onSuffixAction: _angular_core.OutputEmitterRef<MouseEvent>;
     hasPrefixIcon: _angular_core.Signal<boolean>;
     hasSuffixIcon: _angular_core.Signal<boolean>;
+    isNumeric: _angular_core.Signal<boolean>;
+    /** True when the field only accepts whole numbers (i.e. `allowDecimals` is false). */
+    integerOnly: _angular_core.Signal<boolean>;
+    /** The `type` attribute actually rendered. Number mode uses a text input + inputmode to avoid the native type="number" footguns. */
+    resolvedType: _angular_core.Signal<InputType>;
+    /** `inputmode` hint: numeric keypad for integers, decimal keypad otherwise. Null (omitted) when not in number mode. */
+    numericInputMode: _angular_core.Signal<"numeric" | "decimal" | null>;
+    /** Number mode is always single-line; it wins over `multiline` if both are set. */
+    showTextarea: _angular_core.Signal<boolean>;
     id: string;
-    value: string;
+    protected value: string;
     private formDisabled;
     isDisabled: _angular_core.Signal<boolean>;
     private onChange;
     private onTouched;
     private focusMonitor;
+    private monitoredEl?;
     ngAfterViewInit(): void;
-    writeValue(value: string): void;
-    registerOnChange(fn: (value: string) => void): void;
+    ngOnDestroy(): void;
+    writeValue(value: string | number | null | undefined): void;
+    registerOnChange(fn: (value: string | number | null) => void): void;
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
-    onValueChange(event: Event): void;
-    onBlur(): void;
+    protected onValueChange(event: Event): void;
+    protected onBlur(): void;
+    /** Strips any character that can't appear in the current numeric mode (single leading '-', single '.' for decimals). */
+    private sanitizeNumeric;
+    /** Parses a sanitized string to a number, mapping empty/partial input to null (never 0). */
+    private parseNumeric;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TnInputComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnInputComponent, "tn-input", never, { "inputType": { "alias": "inputType"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "testId": { "alias": "testId"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "multiline": { "alias": "multiline"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "prefixIcon": { "alias": "prefixIcon"; "required": false; "isSignal": true; }; "prefixIconLibrary": { "alias": "prefixIconLibrary"; "required": false; "isSignal": true; }; "suffixIcon": { "alias": "suffixIcon"; "required": false; "isSignal": true; }; "suffixIconLibrary": { "alias": "suffixIconLibrary"; "required": false; "isSignal": true; }; "suffixIconAriaLabel": { "alias": "suffixIconAriaLabel"; "required": false; "isSignal": true; }; }, { "onSuffixAction": "onSuffixAction"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnInputComponent, "tn-input", never, { "inputType": { "alias": "inputType"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "testId": { "alias": "testId"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "multiline": { "alias": "multiline"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "allowDecimals": { "alias": "allowDecimals"; "required": false; "isSignal": true; }; "prefixIcon": { "alias": "prefixIcon"; "required": false; "isSignal": true; }; "prefixIconLibrary": { "alias": "prefixIconLibrary"; "required": false; "isSignal": true; }; "suffixIcon": { "alias": "suffixIcon"; "required": false; "isSignal": true; }; "suffixIconLibrary": { "alias": "suffixIconLibrary"; "required": false; "isSignal": true; }; "suffixIconAriaLabel": { "alias": "suffixIconAriaLabel"; "required": false; "isSignal": true; }; }, { "onSuffixAction": "onSuffixAction"; }, never, never, true, never>;
 }
 
 /**
@@ -1222,6 +1257,34 @@ declare class TnInputHarness extends ComponentHarness {
      * @param value The value to set.
      */
     setValue(value: string): Promise<void>;
+    /**
+     * Gets the current value parsed as a number, mirroring what the control emits in number mode.
+     * Empty or non-numeric input resolves to null (never 0).
+     *
+     * @returns Promise resolving to the numeric value, or null.
+     */
+    getNumericValue(): Promise<number | null>;
+    /**
+     * Gets the `inputmode` attribute (e.g. 'numeric' or 'decimal' in number mode).
+     *
+     * @returns Promise resolving to the inputmode string, or null if unset.
+     */
+    getInputMode(): Promise<string | null>;
+    /**
+     * Whether the field is in integer-only mode (i.e. `allowDecimals` is false).
+     *
+     * Derived from `inputmode`: number mode renders `numeric` for integers and
+     * `decimal` otherwise. A convenience wrapper so tests need not know that mapping.
+     *
+     * @returns Promise resolving to true when only whole numbers are accepted.
+     */
+    isIntegerOnly(): Promise<boolean>;
+    /**
+     * Gets the `aria-label` (accessible name set via the `ariaLabel` input).
+     *
+     * @returns Promise resolving to the aria-label string, or null if unset.
+     */
+    getAriaLabel(): Promise<string | null>;
     /**
      * Gets the placeholder text.
      *
@@ -2863,6 +2926,10 @@ declare class TnFormFieldComponent implements AfterContentInit {
     required: _angular_core.InputSignal<boolean>;
     testId: _angular_core.InputSignal<string>;
     subscriptSizing: _angular_core.InputSignal<SubscriptSizing>;
+    /** Optional tooltip shown via a help icon next to the label. */
+    tooltip: _angular_core.InputSignal<string>;
+    /** Placement of the tooltip relative to its help icon. */
+    tooltipPosition: _angular_core.InputSignal<TooltipPosition>;
     control: _angular_core.Signal<NgControl | undefined>;
     protected hasError: _angular_core.WritableSignal<boolean>;
     protected errorMessage: _angular_core.WritableSignal<string>;
@@ -2873,7 +2940,7 @@ declare class TnFormFieldComponent implements AfterContentInit {
     showHint: _angular_core.Signal<boolean>;
     protected showSubscript: _angular_core.Signal<boolean>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TnFormFieldComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnFormFieldComponent, "tn-form-field", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "testId": { "alias": "testId"; "required": false; "isSignal": true; }; "subscriptSizing": { "alias": "subscriptSizing"; "required": false; "isSignal": true; }; }, {}, ["control"], ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnFormFieldComponent, "tn-form-field", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "testId": { "alias": "testId"; "required": false; "isSignal": true; }; "subscriptSizing": { "alias": "subscriptSizing"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "tooltipPosition": { "alias": "tooltipPosition"; "required": false; "isSignal": true; }; }, {}, ["control"], ["*"], true, never>;
 }
 
 /**
@@ -2907,6 +2974,7 @@ declare class TnFormFieldHarness extends ComponentHarness {
     private _label;
     private _error;
     private _hint;
+    private _tooltip;
     /**
      * Gets a `HarnessPredicate` that can be used to search for a form field
      * with specific attributes.
@@ -2975,6 +3043,30 @@ declare class TnFormFieldHarness extends ComponentHarness {
      * ```
      */
     getHint(): Promise<string | null>;
+    /**
+     * Checks whether the form field has a tooltip help icon.
+     *
+     * @returns Promise resolving to true if the tooltip trigger is present.
+     *
+     * @example
+     * ```typescript
+     * const field = await loader.getHarness(TnFormFieldHarness.with({ label: 'Purpose' }));
+     * expect(await field.hasTooltip()).toBe(true);
+     * ```
+     */
+    hasTooltip(): Promise<boolean>;
+    /**
+     * Gets the tooltip message (read from the trigger's accessible label).
+     *
+     * @returns Promise resolving to the tooltip text, or null if no tooltip.
+     *
+     * @example
+     * ```typescript
+     * const field = await loader.getHarness(TnFormFieldHarness.with({ label: 'Purpose' }));
+     * expect(await field.getTooltip()).toBe('What this share is used for');
+     * ```
+     */
+    getTooltip(): Promise<string | null>;
     /**
      * Checks whether the form field is marked as required.
      *