@nova-design-system/nova-webcomponents 3.31.1-beta.1 → 3.31.2-beta.3

package/dist/cjs/accessibility.utils-CeSsswXF.js

@@ -0,0 +1,78 @@
+'use strict';
+
+const TOGGLE_ARIA_ROLES = new Set([
+    'button',
+    'checkbox',
+    'radio',
+]);
+/**
+ * Checks whether a keyboard key should toggle a control.
+ * @param {string} key - KeyboardEvent key value.
+ * @returns {boolean} True when key should trigger toggle behavior.
+ */
+function isToggleKey(key) {
+    return key === 'Enter' || key === ' ';
+}
+/**
+ * Checks whether a role is a supported toggle ARIA role.
+ * @param {string} role - Role value to validate.
+ * @returns {boolean} True when role is supported.
+ */
+function isToggleAriaRole(role) {
+    return TOGGLE_ARIA_ROLES.has(role);
+}
+/**
+ * Normalizes runtime role values to supported toggle roles.
+ * Falls back to button semantics for invalid values.
+ * @param {string} role - Role value to normalize.
+ * @returns {ToggleAriaRole} Supported role value.
+ */
+function normalizeToggleAriaRole(role) {
+    return isToggleAriaRole(role) ? role : 'button';
+}
+/**
+ * Calculates the next selected state for a toggle interaction.
+ * @param {boolean} selected - Current selected state.
+ * @param {boolean} disabled - Disabled state.
+ * @returns {boolean} Updated selected state.
+ */
+function getNextSelectedState(selected, disabled) {
+    if (disabled)
+        return selected;
+    return !selected;
+}
+/**
+ * Calculates the next selected state based on role semantics.
+ * Radio-like controls cannot toggle off directly once selected.
+ * Group-level coordination (for example deselecting sibling radios) is handled
+ * by the consuming component in radiogroup context.
+ * @param {ToggleAriaRole} role - Interactive role of the control.
+ * @param {boolean} selected - Current selected state.
+ * @param {boolean} disabled - Disabled state.
+ * @returns {boolean} Updated selected state for the role.
+ */
+function getRoleAwareNextSelectedState(role, selected, disabled) {
+    if (disabled)
+        return selected;
+    if (role === 'radio') {
+        return true;
+    }
+    return getNextSelectedState(selected, disabled);
+}
+/**
+ * Maps role + state to ARIA attributes.
+ * @param {ToggleAriaRole} role - Interactive role of the control.
+ * @param {boolean} selected - Selected state.
+ * @returns {AriaStateAttributes} ARIA state attributes for the role.
+ */
+function getAriaStateAttributes(role, selected) {
+    if (role === 'button') {
+        return { ariaPressed: String(selected) };
+    }
+    return { ariaChecked: String(selected) };
+}
+
+exports.getAriaStateAttributes = getAriaStateAttributes;
+exports.getRoleAwareNextSelectedState = getRoleAwareNextSelectedState;
+exports.isToggleKey = isToggleKey;
+exports.normalizeToggleAriaRole = normalizeToggleAriaRole;