@aurodesignsystem-dev/auro-formkit 0.0.0-pr1605.0 → 0.0.0-pr1608.1

package/components/checkbox/demo/accessibility.md

@@ -8,12 +8,13 @@ For keyboard interaction details, see the <auro-hyperlink href="keyboard-behavio
 
 <auro-header level="2" id="ariaRolesAndAttributes">ARIA Roles and Attributes</auro-header>
 <auro-header level="3" id="checkboxGroup">Checkbox Group</auro-header>
-The `<auro-checkbox-group>` element uses a `<fieldset>` with a `<legend>` internally, providing native grouping semantics:
+The `<auro-checkbox-group>` element uses a `<fieldset>` with a `<legend>` internally, providing native grouping semantics. These attributes are applied to that shadow-DOM `<fieldset>`, **not** to the `<auro-checkbox-group>` host element:
 
 | Attribute | Value | Description |
 |---|---|---|
-| `role` | `group` (implicit via `fieldset`) | Groups related checkboxes together. |
-| `aria-invalid` | `true` / `false` | Reflects whether the group is currently in an invalid state. |
+| `role` | `group` (implicit via `fieldset`) | Groups related checkboxes together. There is no ARIA `checkboxgroup` role, so the `<fieldset>`'s implicit `group` role is used as-is. |
+| `aria-invalid` | `true` | Present only while the group is in an invalid state. The attribute is **omitted entirely** when the group is valid — it is never set to `false`. |
+| `aria-describedby` | id reference | Points at the `id` of the group's help-text/error element, so assistive technology can associate the message with the group on demand rather than relying only on the one-time live-region announcement. |
 
 <auro-header level="3" id="checkboxElement">Checkbox</auro-header>
 Each `<auro-checkbox>` renders a native `<input type="checkbox">` inside its shadow DOM:
@@ -23,12 +24,22 @@ Each `<auro-checkbox>` renders a native `<input type="checkbox">` inside its sha
 | `type` | `checkbox` | Native checkbox input type. |
 | `aria-checked` | `true` / `false` | Reflects the checked state of the checkbox. |
 | `aria-disabled` | `true` / `false` | Indicates whether the checkbox is disabled. |
+| `aria-invalid` | `true` | Mirrored onto each checkbox from the group while the group is invalid, and removed when it becomes valid. Omitted rather than set to `false`. |
+
+<auro-header level="4" id="invalidStatePlacement">Why the invalid state appears twice</auro-header>
+While the group is invalid, `aria-invalid` is set on both the `<fieldset>` and every individual `<auro-checkbox>`. This is intentional: some assistive-technology and browser combinations announce a container's invalid state only when focus first enters the group, so mirroring the state onto each checkbox keeps it conveyed as focus moves through the options.
+
+The `checkbox` role is in `aria-invalid`'s supported-role list in every ARIA version, so the per-checkbox placement is unambiguous. The group-level placement is worth one note: `aria-invalid` is a global attribute in ARIA 1.1, applicable to any role including `group`, but ARIA 1.2 deprecates that global use in favor of a supported-role list that does not include `group`. Keeping it on the `<fieldset>` is a deliberate choice — it is not a *prohibited* attribute for `group`, current axe-core resolves it as global and reports no violation, and it gives the group a real invalid signal that would otherwise be lost. This is covered by an automated axe assertion in the component's test suite so that a future change in tooling surfaces here rather than in a consumer's audit.
+
+<auro-header level="4" id="attributePlacementNote">Attribute placement</auro-header>
+`aria-invalid` is applied to the internal `<fieldset>`, not to the `<auro-checkbox-group>` host element. Do not write CSS selectors or test assertions against `auro-checkbox-group[aria-invalid]`; query the internal fieldset or read the `validity` property instead.
 
 <auro-header level="2" id="screenReaderAnnouncements">Screen Reader Announcements</auro-header>
 - **Focus** — When focus moves to a checkbox, the screen reader announces the checkbox label, its checked/unchecked state, and role ("checkbox").
 - **State change** — Toggling the checkbox announces the new state ("checked" or "unchecked").
 - **Group context** — The legend text provides group context when navigating between groups.
-- **Error** — When validation fails, the error message is announced to screen reader users.
+- **Error** — When validation fails, the error message is announced immediately via the help text's `role="alert"` live region, and stays discoverable afterward through the group's `aria-describedby` association.
+- **Invalid state** — While the group is invalid, entering it or moving between its checkboxes conveys the invalid state.
 
 <auro-header level="2" id="accessibleLabels">Accessible Labels</auro-header>
 - The `legend` slot content provides the accessible group label via the native `<legend>` element.

package/components/checkbox/demo/customize.min.js

@@ -1046,6 +1046,22 @@ class AuroDependencyVersioning {
   }
 }
 
+/**
+ * Class for generating unique hashes based on the current timestamp.
+ * This can be used to create unique identifiers for elements or data within an application,
+ * ensuring that each identifier is distinct and can be easily generated without the need
+ * for external libraries or complex algorithms.
+ */
+class UniqueId {
+  /**
+   * Creates a unique hash based on the current timestamp.
+   * @returns {Function} Timestamp as a base-36 string
+   */
+  create() {
+    return Date.now().toString(36);
+  }
+}
+
 var styleCss$1 = i$5`:host{display:block;padding-bottom:var(--ds-size-150, 0.75rem)}.displayFlex legend+slot{display:flex;white-space:nowrap}fieldset{all:unset}legend{margin-bottom:var(--ds-size-150, 0.75rem)}[auro-helptext]{margin-top:var(--ds-size-150, 0.75rem)}`;
 
 var colorCss$1 = i$5`:host{color:var(--ds-auro-checkbox-group-text-color)}:host([disabled]){--ds-auro-checkbox-group-text-color: var(--ds-basic-color-texticon-disabled, #d0d0d0)}:host([onDark]),:host([appearance=inverse]){--ds-auro-checkbox-group-text-color: var(--ds-basic-color-texticon-inverse, #ffffff)}:host([onDark][disabled]),:host([appearance=inverse][disabled]){--ds-auro-checkbox-group-text-color: var(--ds-basic-color-texticon-inverse-disabled, #7e8894)}`;
@@ -1284,7 +1300,7 @@ class AuroHelpText extends i$2 {
   }
 }
 
-var formkitVersion = '202609022200';
+var formkitVersion = '202609022217';
 
 // Copyright (c) 2026 Alaska Airlines. All rights reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.
@@ -1361,6 +1377,11 @@ class AuroCheckboxGroup extends i$2 {
      * @private
      */
     this.helpTextTag = versioning.generateTag('auro-formkit-checkbox-helptext', formkitVersion, AuroHelpText);
+
+    /**
+     * @private
+     */
+    this.uniqueId = new UniqueId().create();
   }
 
   static get styles() {
@@ -1612,6 +1633,29 @@ class AuroCheckboxGroup extends i$2 {
     this.handlePreselectedItems();
 
     this.validate();
+    this.syncCheckboxValidity();
+  }
+
+  /**
+   * Method for mirroring the group's invalid state onto each checkbox.
+   * `validity` is the authoritative invalid state, and it has to be re-applied from
+   * `handleItems()` as well, because a slot change can happen without `validity` itself
+   * changing — a checkbox slotted into an already-invalid group would otherwise be missed.
+   * @private
+   * @returns {void}
+   */
+  syncCheckboxValidity() {
+    const invalid = Boolean(this.validity && this.validity !== 'valid');
+
+    this.checkboxes.forEach((el) => {
+      if (invalid) {
+        el.setAttribute('error', true);
+        el.setAttribute('aria-invalid', 'true');
+      } else {
+        el.removeAttribute('error');
+        el.removeAttribute('aria-invalid');
+      }
+    });
   }
 
   /**
@@ -1643,13 +1687,7 @@ class AuroCheckboxGroup extends i$2 {
     }
 
     if (changedProperties.has('validity')) {
-      this.checkboxes.forEach((el) => {
-        if (this.validity && this.validity !== 'valid') {
-          el.setAttribute('error', true);
-        } else {
-          el.removeAttribute('error');
-        }
-      });
+      this.syncCheckboxValidity();
     }
 
     if (changedProperties.has('required')) {
@@ -1673,12 +1711,6 @@ class AuroCheckboxGroup extends i$2 {
     }
 
     if (changedProperties.has('error')) {
-      if (this.error) {
-        this.setAttribute('aria-invalid', true);
-      } else {
-        this.removeAttribute('aria-invalid');
-      }
-
       this.validate(true);
     }
   }
@@ -1697,7 +1729,11 @@ class AuroCheckboxGroup extends i$2 {
     };
 
     return u`
-      <fieldset class="${e(groupClasses)}">
+      <fieldset
+        class="${e(groupClasses)}"
+        aria-invalid="${o$1(this.validity && this.validity !== 'valid' ? 'true' : undefined)}"
+        aria-describedby="${this.uniqueId}"
+      >
         <legend>
           <slot name="legend"></slot>
           ${this.required ? undefined : u`<slot name="optionalLabel"> (optional)</slot>`}
@@ -1707,11 +1743,11 @@ class AuroCheckboxGroup extends i$2 {
 
       ${!this.validity || this.validity === undefined || this.validity === 'valid'
         ? u`
-          <${this.helpTextTag} part="helpText" appearance="${this.onDark ? 'inverse' : this.appearance}">
+          <${this.helpTextTag} id="${this.uniqueId}" part="helpText" appearance="${this.onDark ? 'inverse' : this.appearance}">
             <slot name="helpText"></slot>
           </${this.helpTextTag}>`
         : u`
-          <${this.helpTextTag} error appearance="${this.onDark ? 'inverse' : this.appearance}"" role="alert" aria-live="assertive" part="helpText">
+          <${this.helpTextTag} id="${this.uniqueId}" error appearance="${this.onDark ? 'inverse' : this.appearance}" role="alert" aria-live="assertive" part="helpText">
             ${this.errorMessage}
           </${this.helpTextTag}>`
       }

package/components/checkbox/demo/getting-started.min.js

@@ -1046,6 +1046,22 @@ class AuroDependencyVersioning {
   }
 }
 
+/**
+ * Class for generating unique hashes based on the current timestamp.
+ * This can be used to create unique identifiers for elements or data within an application,
+ * ensuring that each identifier is distinct and can be easily generated without the need
+ * for external libraries or complex algorithms.
+ */
+class UniqueId {
+  /**
+   * Creates a unique hash based on the current timestamp.
+   * @returns {Function} Timestamp as a base-36 string
+   */
+  create() {
+    return Date.now().toString(36);
+  }
+}
+
 var styleCss$1 = i$5`:host{display:block;padding-bottom:var(--ds-size-150, 0.75rem)}.displayFlex legend+slot{display:flex;white-space:nowrap}fieldset{all:unset}legend{margin-bottom:var(--ds-size-150, 0.75rem)}[auro-helptext]{margin-top:var(--ds-size-150, 0.75rem)}`;
 
 var colorCss$1 = i$5`:host{color:var(--ds-auro-checkbox-group-text-color)}:host([disabled]){--ds-auro-checkbox-group-text-color: var(--ds-basic-color-texticon-disabled, #d0d0d0)}:host([onDark]),:host([appearance=inverse]){--ds-auro-checkbox-group-text-color: var(--ds-basic-color-texticon-inverse, #ffffff)}:host([onDark][disabled]),:host([appearance=inverse][disabled]){--ds-auro-checkbox-group-text-color: var(--ds-basic-color-texticon-inverse-disabled, #7e8894)}`;
@@ -1284,7 +1300,7 @@ class AuroHelpText extends i$2 {
   }
 }
 
-var formkitVersion = '202609022200';
+var formkitVersion = '202609022217';
 
 // Copyright (c) 2026 Alaska Airlines. All rights reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.
@@ -1361,6 +1377,11 @@ class AuroCheckboxGroup extends i$2 {
      * @private
      */
     this.helpTextTag = versioning.generateTag('auro-formkit-checkbox-helptext', formkitVersion, AuroHelpText);
+
+    /**
+     * @private
+     */
+    this.uniqueId = new UniqueId().create();
   }
 
   static get styles() {
@@ -1612,6 +1633,29 @@ class AuroCheckboxGroup extends i$2 {
     this.handlePreselectedItems();
 
     this.validate();
+    this.syncCheckboxValidity();
+  }
+
+  /**
+   * Method for mirroring the group's invalid state onto each checkbox.
+   * `validity` is the authoritative invalid state, and it has to be re-applied from
+   * `handleItems()` as well, because a slot change can happen without `validity` itself
+   * changing — a checkbox slotted into an already-invalid group would otherwise be missed.
+   * @private
+   * @returns {void}
+   */
+  syncCheckboxValidity() {
+    const invalid = Boolean(this.validity && this.validity !== 'valid');
+
+    this.checkboxes.forEach((el) => {
+      if (invalid) {
+        el.setAttribute('error', true);
+        el.setAttribute('aria-invalid', 'true');
+      } else {
+        el.removeAttribute('error');
+        el.removeAttribute('aria-invalid');
+      }
+    });
   }
 
   /**
@@ -1643,13 +1687,7 @@ class AuroCheckboxGroup extends i$2 {
     }
 
     if (changedProperties.has('validity')) {
-      this.checkboxes.forEach((el) => {
-        if (this.validity && this.validity !== 'valid') {
-          el.setAttribute('error', true);
-        } else {
-          el.removeAttribute('error');
-        }
-      });
+      this.syncCheckboxValidity();
     }
 
     if (changedProperties.has('required')) {
@@ -1673,12 +1711,6 @@ class AuroCheckboxGroup extends i$2 {
     }
 
     if (changedProperties.has('error')) {
-      if (this.error) {
-        this.setAttribute('aria-invalid', true);
-      } else {
-        this.removeAttribute('aria-invalid');
-      }
-
       this.validate(true);
     }
   }
@@ -1697,7 +1729,11 @@ class AuroCheckboxGroup extends i$2 {
     };
 
     return u`
-      <fieldset class="${e(groupClasses)}">
+      <fieldset
+        class="${e(groupClasses)}"
+        aria-invalid="${o$1(this.validity && this.validity !== 'valid' ? 'true' : undefined)}"
+        aria-describedby="${this.uniqueId}"
+      >
         <legend>
           <slot name="legend"></slot>
           ${this.required ? undefined : u`<slot name="optionalLabel"> (optional)</slot>`}
@@ -1707,11 +1743,11 @@ class AuroCheckboxGroup extends i$2 {
 
       ${!this.validity || this.validity === undefined || this.validity === 'valid'
         ? u`
-          <${this.helpTextTag} part="helpText" appearance="${this.onDark ? 'inverse' : this.appearance}">
+          <${this.helpTextTag} id="${this.uniqueId}" part="helpText" appearance="${this.onDark ? 'inverse' : this.appearance}">
             <slot name="helpText"></slot>
           </${this.helpTextTag}>`
         : u`
-          <${this.helpTextTag} error appearance="${this.onDark ? 'inverse' : this.appearance}"" role="alert" aria-live="assertive" part="helpText">
+          <${this.helpTextTag} id="${this.uniqueId}" error appearance="${this.onDark ? 'inverse' : this.appearance}" role="alert" aria-live="assertive" part="helpText">
             ${this.errorMessage}
           </${this.helpTextTag}>`
       }

package/components/checkbox/demo/index.min.js

@@ -1046,6 +1046,22 @@ class AuroDependencyVersioning {
   }
 }
 
+/**
+ * Class for generating unique hashes based on the current timestamp.
+ * This can be used to create unique identifiers for elements or data within an application,
+ * ensuring that each identifier is distinct and can be easily generated without the need
+ * for external libraries or complex algorithms.
+ */
+class UniqueId {
+  /**
+   * Creates a unique hash based on the current timestamp.
+   * @returns {Function} Timestamp as a base-36 string
+   */
+  create() {
+    return Date.now().toString(36);
+  }
+}
+
 var styleCss$1 = i$5`:host{display:block;padding-bottom:var(--ds-size-150, 0.75rem)}.displayFlex legend+slot{display:flex;white-space:nowrap}fieldset{all:unset}legend{margin-bottom:var(--ds-size-150, 0.75rem)}[auro-helptext]{margin-top:var(--ds-size-150, 0.75rem)}`;
 
 var colorCss$1 = i$5`:host{color:var(--ds-auro-checkbox-group-text-color)}:host([disabled]){--ds-auro-checkbox-group-text-color: var(--ds-basic-color-texticon-disabled, #d0d0d0)}:host([onDark]),:host([appearance=inverse]){--ds-auro-checkbox-group-text-color: var(--ds-basic-color-texticon-inverse, #ffffff)}:host([onDark][disabled]),:host([appearance=inverse][disabled]){--ds-auro-checkbox-group-text-color: var(--ds-basic-color-texticon-inverse-disabled, #7e8894)}`;
@@ -1284,7 +1300,7 @@ class AuroHelpText extends i$2 {
   }
 }
 
-var formkitVersion = '202609022200';
+var formkitVersion = '202609022217';
 
 // Copyright (c) 2026 Alaska Airlines. All rights reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.
@@ -1361,6 +1377,11 @@ class AuroCheckboxGroup extends i$2 {
      * @private
      */
     this.helpTextTag = versioning.generateTag('auro-formkit-checkbox-helptext', formkitVersion, AuroHelpText);
+
+    /**
+     * @private
+     */
+    this.uniqueId = new UniqueId().create();
   }
 
   static get styles() {
@@ -1612,6 +1633,29 @@ class AuroCheckboxGroup extends i$2 {
     this.handlePreselectedItems();
 
     this.validate();
+    this.syncCheckboxValidity();
+  }
+
+  /**
+   * Method for mirroring the group's invalid state onto each checkbox.
+   * `validity` is the authoritative invalid state, and it has to be re-applied from
+   * `handleItems()` as well, because a slot change can happen without `validity` itself
+   * changing — a checkbox slotted into an already-invalid group would otherwise be missed.
+   * @private
+   * @returns {void}
+   */
+  syncCheckboxValidity() {
+    const invalid = Boolean(this.validity && this.validity !== 'valid');
+
+    this.checkboxes.forEach((el) => {
+      if (invalid) {
+        el.setAttribute('error', true);
+        el.setAttribute('aria-invalid', 'true');
+      } else {
+        el.removeAttribute('error');
+        el.removeAttribute('aria-invalid');
+      }
+    });
   }
 
   /**
@@ -1643,13 +1687,7 @@ class AuroCheckboxGroup extends i$2 {
     }
 
     if (changedProperties.has('validity')) {
-      this.checkboxes.forEach((el) => {
-        if (this.validity && this.validity !== 'valid') {
-          el.setAttribute('error', true);
-        } else {
-          el.removeAttribute('error');
-        }
-      });
+      this.syncCheckboxValidity();
     }
 
     if (changedProperties.has('required')) {
@@ -1673,12 +1711,6 @@ class AuroCheckboxGroup extends i$2 {
     }
 
     if (changedProperties.has('error')) {
-      if (this.error) {
-        this.setAttribute('aria-invalid', true);
-      } else {
-        this.removeAttribute('aria-invalid');
-      }
-
       this.validate(true);
     }
   }
@@ -1697,7 +1729,11 @@ class AuroCheckboxGroup extends i$2 {
     };
 
     return u`
-      <fieldset class="${e(groupClasses)}">
+      <fieldset
+        class="${e(groupClasses)}"
+        aria-invalid="${o$1(this.validity && this.validity !== 'valid' ? 'true' : undefined)}"
+        aria-describedby="${this.uniqueId}"
+      >
         <legend>
           <slot name="legend"></slot>
           ${this.required ? undefined : u`<slot name="optionalLabel"> (optional)</slot>`}
@@ -1707,11 +1743,11 @@ class AuroCheckboxGroup extends i$2 {
 
       ${!this.validity || this.validity === undefined || this.validity === 'valid'
         ? u`
-          <${this.helpTextTag} part="helpText" appearance="${this.onDark ? 'inverse' : this.appearance}">
+          <${this.helpTextTag} id="${this.uniqueId}" part="helpText" appearance="${this.onDark ? 'inverse' : this.appearance}">
             <slot name="helpText"></slot>
           </${this.helpTextTag}>`
         : u`
-          <${this.helpTextTag} error appearance="${this.onDark ? 'inverse' : this.appearance}"" role="alert" aria-live="assertive" part="helpText">
+          <${this.helpTextTag} id="${this.uniqueId}" error appearance="${this.onDark ? 'inverse' : this.appearance}" role="alert" aria-live="assertive" part="helpText">
             ${this.errorMessage}
           </${this.helpTextTag}>`
       }

package/components/checkbox/dist/auro-checkbox-group.d.ts

@@ -141,6 +141,10 @@ export class AuroCheckboxGroup extends LitElement {
      * @private
      */
     private helpTextTag;
+    /**
+     * @private
+     */
+    private uniqueId;
     /**
      * Helper method to handle checkbox value changing.
      * @private
@@ -164,6 +168,15 @@ export class AuroCheckboxGroup extends LitElement {
      */
     private handleItems;
     checkboxes: Element[] | undefined;
+    /**
+     * Method for mirroring the group's invalid state onto each checkbox.
+     * `validity` is the authoritative invalid state, and it has to be re-applied from
+     * `handleItems()` as well, because a slot change can happen without `validity` itself
+     * changing — a checkbox slotted into an already-invalid group would otherwise be missed.
+     * @private
+     * @returns {void}
+     */
+    private syncCheckboxValidity;
     /**
      * Resets component to initial state.
      * @returns {void}

package/components/checkbox/dist/index.js

@@ -999,6 +999,22 @@ class AuroDependencyVersioning {
   }
 }
 
+/**
+ * Class for generating unique hashes based on the current timestamp.
+ * This can be used to create unique identifiers for elements or data within an application,
+ * ensuring that each identifier is distinct and can be easily generated without the need
+ * for external libraries or complex algorithms.
+ */
+class UniqueId {
+  /**
+   * Creates a unique hash based on the current timestamp.
+   * @returns {Function} Timestamp as a base-36 string
+   */
+  create() {
+    return Date.now().toString(36);
+  }
+}
+
 var styleCss$1 = css`:host{display:block;padding-bottom:var(--ds-size-150, 0.75rem)}.displayFlex legend+slot{display:flex;white-space:nowrap}fieldset{all:unset}legend{margin-bottom:var(--ds-size-150, 0.75rem)}[auro-helptext]{margin-top:var(--ds-size-150, 0.75rem)}`;
 
 var colorCss$1 = css`:host{color:var(--ds-auro-checkbox-group-text-color)}:host([disabled]){--ds-auro-checkbox-group-text-color: var(--ds-basic-color-texticon-disabled, #d0d0d0)}:host([onDark]),:host([appearance=inverse]){--ds-auro-checkbox-group-text-color: var(--ds-basic-color-texticon-inverse, #ffffff)}:host([onDark][disabled]),:host([appearance=inverse][disabled]){--ds-auro-checkbox-group-text-color: var(--ds-basic-color-texticon-inverse-disabled, #7e8894)}`;
@@ -1237,7 +1253,7 @@ class AuroHelpText extends LitElement {
   }
 }
 
-var formkitVersion = '202609022200';
+var formkitVersion = '202609022217';
 
 // Copyright (c) 2026 Alaska Airlines. All rights reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.
@@ -1314,6 +1330,11 @@ class AuroCheckboxGroup extends LitElement {
      * @private
      */
     this.helpTextTag = versioning.generateTag('auro-formkit-checkbox-helptext', formkitVersion, AuroHelpText);
+
+    /**
+     * @private
+     */
+    this.uniqueId = new UniqueId().create();
   }
 
   static get styles() {
@@ -1565,6 +1586,29 @@ class AuroCheckboxGroup extends LitElement {
     this.handlePreselectedItems();
 
     this.validate();
+    this.syncCheckboxValidity();
+  }
+
+  /**
+   * Method for mirroring the group's invalid state onto each checkbox.
+   * `validity` is the authoritative invalid state, and it has to be re-applied from
+   * `handleItems()` as well, because a slot change can happen without `validity` itself
+   * changing — a checkbox slotted into an already-invalid group would otherwise be missed.
+   * @private
+   * @returns {void}
+   */
+  syncCheckboxValidity() {
+    const invalid = Boolean(this.validity && this.validity !== 'valid');
+
+    this.checkboxes.forEach((el) => {
+      if (invalid) {
+        el.setAttribute('error', true);
+        el.setAttribute('aria-invalid', 'true');
+      } else {
+        el.removeAttribute('error');
+        el.removeAttribute('aria-invalid');
+      }
+    });
   }
 
   /**
@@ -1596,13 +1640,7 @@ class AuroCheckboxGroup extends LitElement {
     }
 
     if (changedProperties.has('validity')) {
-      this.checkboxes.forEach((el) => {
-        if (this.validity && this.validity !== 'valid') {
-          el.setAttribute('error', true);
-        } else {
-          el.removeAttribute('error');
-        }
-      });
+      this.syncCheckboxValidity();
     }
 
     if (changedProperties.has('required')) {
@@ -1626,12 +1664,6 @@ class AuroCheckboxGroup extends LitElement {
     }
 
     if (changedProperties.has('error')) {
-      if (this.error) {
-        this.setAttribute('aria-invalid', true);
-      } else {
-        this.removeAttribute('aria-invalid');
-      }
-
       this.validate(true);
     }
   }
@@ -1650,7 +1682,11 @@ class AuroCheckboxGroup extends LitElement {
     };
 
     return html$1`
-      <fieldset class="${classMap(groupClasses)}">
+      <fieldset
+        class="${classMap(groupClasses)}"
+        aria-invalid="${ifDefined(this.validity && this.validity !== 'valid' ? 'true' : undefined)}"
+        aria-describedby="${this.uniqueId}"
+      >
         <legend>
           <slot name="legend"></slot>
           ${this.required ? undefined : html$1`<slot name="optionalLabel"> (optional)</slot>`}
@@ -1660,11 +1696,11 @@ class AuroCheckboxGroup extends LitElement {
 
       ${!this.validity || this.validity === undefined || this.validity === 'valid'
         ? html$1`
-          <${this.helpTextTag} part="helpText" appearance="${this.onDark ? 'inverse' : this.appearance}">
+          <${this.helpTextTag} id="${this.uniqueId}" part="helpText" appearance="${this.onDark ? 'inverse' : this.appearance}">
             <slot name="helpText"></slot>
           </${this.helpTextTag}>`
         : html$1`
-          <${this.helpTextTag} error appearance="${this.onDark ? 'inverse' : this.appearance}"" role="alert" aria-live="assertive" part="helpText">
+          <${this.helpTextTag} id="${this.uniqueId}" error appearance="${this.onDark ? 'inverse' : this.appearance}" role="alert" aria-live="assertive" part="helpText">
             ${this.errorMessage}
           </${this.helpTextTag}>`
       }