[PM-252] fix inconsistent generator configuration behavior (#6755)

* decompose password generator policy enforcement
* integrate new logic with UI
* improve UX of minimum password length
* improve password generator policy options documentation
* initialize min length to default minimum length boundary
* reset form value on input to prevent UI desync from model

---------

Co-authored-by: Thomas Rittson <31796059+eliykat@users.noreply.github.com>

libs/common/src/admin-console/models/domain/password-generator-policy-options.ts

@@ -1,18 +1,73 @@
 import Domain from "../../../platform/models/domain/domain-base";
 
+/** Enterprise policy for the password generator.
+ * @see PolicyType.PasswordGenerator
+ */
 export class PasswordGeneratorPolicyOptions extends Domain {
-  defaultType = "";
+  /** The default kind of credential to generate */
+  defaultType: "password" | "passphrase" | "" = "";
+
+  /** The minimum length of generated passwords.
+   *  When this is less than or equal to zero, it is ignored.
+   *  If this is less than the total number of characters required by
+   *  the policy's other settings, then it is ignored.
+   *  This field is not used for passphrases.
+   */
   minLength = 0;
+
+  /** When this is true, an uppercase character must be part of
+   *  the generated password.
+   *  This field is not used for passphrases.
+   */
   useUppercase = false;
+
+  /** When this is true, a lowercase character must be part of
+   *  the generated password. This field is not used for passphrases.
+   */
   useLowercase = false;
+
+  /** When this is true, at least one digit must be part of the generated
+   *  password. This field is not used for passphrases.
+   */
   useNumbers = false;
+
+  /** The quantity of digits to include in the generated password.
+   *  When this is less than or equal to zero, it is ignored.
+   *  This field is not used for passphrases.
+   */
   numberCount = 0;
+
+  /** When this is true, at least one digit must be part of the generated
+   *  password. This field is not used for passphrases.
+   */
   useSpecial = false;
+
+  /** The quantity of special characters to include in the generated
+   *  password. When this is less than or equal to zero, it is ignored.
+   *  This field is not used for passphrases.
+   */
   specialCount = 0;
+
+  /** The minimum number of words required by generated passphrases.
+   *  This field is not used for passwords.
+   */
   minNumberWords = 0;
+
+  /** When this is true, the first letter of each word in the passphrase
+   *  is capitalized. This field is not used for passwords.
+   */
   capitalize = false;
+
+  /** When this is true, a number is included within the passphrase.
+   *  This field is not used for passwords.
+   */
   includeNumber = false;
 
+  /** Checks whether the policy affects the password generator.
+   * @returns True if at least one password or passphrase requirement has been set.
+   * If it returns False, then no requirements have been set and the policy should
+   * not be enforced.
+   */
   inEffect() {
     return (
       this.defaultType !== "" ||
@@ -28,4 +83,12 @@ export class PasswordGeneratorPolicyOptions extends Domain {
       this.includeNumber
     );
   }
+
+  /** Creates a copy of the policy.
+   */
+  clone() {
+    const policy = new PasswordGeneratorPolicyOptions();
+    Object.assign(policy, this);
+    return policy;
+  }
 }