@truenas/ui-components 0.2.1 → 0.2.2

package/package.json

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

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

@@ -1288,6 +1288,14 @@ declare class TnInputComponent implements AfterViewInit, OnDestroy, ControlValue
      * (e.g. `1.5 GiB`). Ignored unless `inputType` is `Size`.
      */
     sizeRound: _angular_core.InputSignal<number>;
+    /**
+     * Whether a `Password` field renders the built-in visibility toggle — the eye
+     * button that switches the field between masked and plain-text display.
+     * Defaults to true; set false for secrets that must never be revealed.
+     * Setting `suffixIcon` suppresses the toggle automatically (a custom suffix
+     * control replaces it). Ignored unless `inputType` is `Password`.
+     */
+    showPasswordToggle: _angular_core.InputSignal<boolean>;
     prefixIcon: _angular_core.InputSignal<string | undefined>;
     prefixIconLibrary: _angular_core.InputSignal<IconLibraryType | undefined>;
     suffixIcon: _angular_core.InputSignal<string | undefined>;
@@ -1308,12 +1316,44 @@ declare class TnInputComponent implements AfterViewInit, OnDestroy, ControlValue
     isSize: _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 and size modes use a text input: number avoids the native type="number" footguns, size must accept unit letters. */
+    /** True when the field is a password field. */
+    isPassword: _angular_core.Signal<boolean>;
+    /**
+     * Whether the password is currently revealed. Not exposed as an input so a
+     * reveal is always an explicit user gesture, and linked to the toggle's own
+     * availability so a revealed value never outlives the control that revealed
+     * it: whenever the toggle goes away (the field leaves password mode,
+     * `showPasswordToggle` flips off, a `suffixIcon` replaces it) or the field
+     * is disabled, the field snaps back to masked.
+     */
+    protected passwordVisible: _angular_core.WritableSignal<boolean>;
+    /** The `type` attribute actually rendered. Number and size modes use a text input: number avoids the native type="number" footguns, size must accept unit letters. A revealed password renders as text — flipping the type attribute is the standard reveal mechanism and preserves value and caret. */
     resolvedType: _angular_core.Signal<InputType>;
     /** `inputmode` hint: numeric keypad for integers, decimal keypad otherwise. Null (omitted) outside number mode — size fields accept unit letters, so they keep the full keyboard. */
     numericInputMode: _angular_core.Signal<"numeric" | "decimal" | null>;
     /** Number and size modes are always single-line; they win over `multiline` if both are set. */
     showTextarea: _angular_core.Signal<boolean>;
+    /**
+     * The visibility toggle renders only on single-line password fields (a
+     * password+multiline combo renders a textarea, which has no `type` to flip),
+     * and yields to a consumer-provided `suffixIcon` — a custom suffix control
+     * replaces the built-in toggle rather than stacking a second button.
+     */
+    protected hasPasswordToggle: _angular_core.Signal<boolean>;
+    /**
+     * Icon for the visibility toggle, mirroring the field's current state: a
+     * slashed eye while masked, an open eye while revealed. The literal
+     * `tnIconMarker` calls double as build-time markers that pull both icons
+     * into the sprite.
+     */
+    protected passwordToggleIcon: _angular_core.Signal<string>;
+    /**
+     * Role-first test-id segments for the visibility toggle:
+     * `button-toggle-password[-<testId>]`. The toggle is fixed field chrome, so
+     * the role leads (matching the dialog-shell close/fullscreen convention) and
+     * automation can target every password toggle with one prefix selector.
+     */
+    protected passwordToggleTestId: _angular_core.Signal<(string | number | null | undefined)[]>;
     id: string;
     protected value: string;
     private formDisabled;
@@ -1330,12 +1370,13 @@ declare class TnInputComponent implements AfterViewInit, OnDestroy, ControlValue
     setDisabledState(isDisabled: boolean): void;
     protected onValueChange(event: Event): void;
     protected onBlur(): void;
+    protected togglePasswordVisibility(): 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; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "allowDecimals": { "alias": "allowDecimals"; "required": false; "isSignal": true; }; "sizeStandard": { "alias": "sizeStandard"; "required": false; "isSignal": true; }; "sizeDefaultUnit": { "alias": "sizeDefaultUnit"; "required": false; "isSignal": true; }; "sizeRound": { "alias": "sizeRound"; "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; }; "suffixActionTestId": { "alias": "suffixActionTestId"; "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; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "allowDecimals": { "alias": "allowDecimals"; "required": false; "isSignal": true; }; "sizeStandard": { "alias": "sizeStandard"; "required": false; "isSignal": true; }; "sizeDefaultUnit": { "alias": "sizeDefaultUnit"; "required": false; "isSignal": true; }; "sizeRound": { "alias": "sizeRound"; "required": false; "isSignal": true; }; "showPasswordToggle": { "alias": "showPasswordToggle"; "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; }; "suffixActionTestId": { "alias": "suffixActionTestId"; "required": false; "isSignal": true; }; }, { "onSuffixAction": "onSuffixAction"; }, never, never, true, never>;
 }
 
 /**
@@ -1565,6 +1606,7 @@ declare class TnInputHarness extends ComponentHarness {
     private prefixIconEl;
     private suffixButton;
     private suffixIconEl;
+    private visibilityToggle;
     /**
      * Gets a `HarnessPredicate` that can be used to search for an input
      * with specific attributes.
@@ -1699,6 +1741,27 @@ declare class TnInputHarness extends ComponentHarness {
      * @returns Promise that resolves when the click action is complete.
      */
     clickSuffixAction(): Promise<void>;
+    /**
+     * Checks whether the password visibility toggle is present.
+     *
+     * @returns Promise resolving to true if the toggle button exists.
+     */
+    hasPasswordToggle(): Promise<boolean>;
+    /**
+     * Whether the password is currently revealed (the field renders as plain text).
+     *
+     * Only meaningful on password-type inputs; resolves false while masked.
+     *
+     * @returns Promise resolving to true when the value is shown in plain text.
+     */
+    isPasswordRevealed(): Promise<boolean>;
+    /**
+     * Clicks the password visibility toggle, switching between masked and
+     * plain-text display.
+     *
+     * @returns Promise that resolves when the click action is complete.
+     */
+    togglePasswordVisibility(): Promise<void>;
     /**
      * Focuses the input element.
      *