@muraldevkit/ui-toolkit 4.60.1-dev-W3pi.1 → 4.61.0

package/dist/components/rovingTabindex/MrlRovingTabindex/MrlRovingTabindex.d.ts

@@ -1,15 +1,20 @@
 import * as React from 'react';
 type RefType = HTMLElement | HTMLDivElement | null;
 /**
- * Gets tabbable elements in a given bit of the DOM
+ * Gets tabbable elements in a given bit of the DOM, excluding disabled elements
  * @param {RefType} ref - the ref of the container
- * @param {string} selector - the selector to query
+ * @param {string} selector - the selector to query (should already exclude disabled elements)
  * @returns {HTMLElement[]} - an array of tabbable HTML elements
  */
 export declare const getTabbableElements: (ref: RefType, selector: string) => HTMLElement[];
 export type FocusOnInitPosition = 'first' | 'last';
 export interface RovingPropTypes {
     activeSelector?: string;
+    /**
+     * If true, disabled elements (with disabled attribute or aria-disabled="true")
+     * will be included in the roving tabindex. Defaults to true (disabled elements are included).
+     */
+    allowDisabled?: boolean;
     children: React.ReactNode;
     /**
      * delayMount is used to apply a delay to the mounting
@@ -72,8 +77,19 @@ declare class MrlRovingTabindex extends React.Component<RovingPropTypes> {
      */
     setElements: () => void;
     /**
-     * Gets the components active element based on priority order.
-     * @returns {HTMLElement | undefined} - the active HTML element
+     * Queries for a single element matching the selector within the container.
+     * @param selector - CSS selector to query
+     * @returns The matching element or null
+     */
+    queryElement: (selector: string) => HTMLElement | null;
+    /**
+     * Gets the active element based on priority order:
+     * 1. Element matching the custom `activeSelector` prop (e.g., custom radio elements)
+     * 2. Element with `data-roving-active` attribute (programmatically set active)
+     * 3. First element with `data-roving` attribute (default fallback)
+     *
+     * Disabled elements are excluded unless `allowDisabled` is true.
+     * @returns The active HTML element, or undefined if none found
      */
     getActiveElement: () => HTMLElement | undefined;
     /**
@@ -90,12 +106,14 @@ declare class MrlRovingTabindex extends React.Component<RovingPropTypes> {
     setElementFocus: (el: HTMLElement | undefined) => void;
     /**
      * Sets focus to an element based on a direction (`forward` or `back`)
+     * Disabled elements are already excluded from this.elements via CSS selector
      * @param {NavigationDirection} direction 'forward' | 'back'
      * @returns {void}
      */
     setFocusByDirection: (direction: NavigationDirection) => void;
     /**
      * Sets all tabindex for elements of this component to -1
+     * Also ensures disabled elements (excluded from roving tabindex) have tabindex=-1
      * @returns {void}
      */
     unsetTabbableElements: () => void;