@compa11y/core 0.1.0

package/dist/focus/index.d.ts

@@ -0,0 +1,139 @@
+import { F as FocusTrapOptions } from '../types-DDSPmE8m.js';
+
+/**
+ * Focus Trap - Constrains focus within a container
+ *
+ * Essential for modals, dialogs, and other overlay components
+ */
+
+interface FocusTrap {
+    activate: () => void;
+    deactivate: () => void;
+    /** Cleanup without calling onDeactivate - for use in effect cleanup */
+    destroy: () => void;
+    pause: () => void;
+    unpause: () => void;
+    isActive: () => boolean;
+    isPaused: () => boolean;
+}
+/**
+ * Create a focus trap for a container element
+ */
+declare function createFocusTrap(container: HTMLElement, options?: FocusTrapOptions): FocusTrap;
+/**
+ * Get the currently active focus trap
+ */
+declare function getActiveFocusTrap(): FocusTrap | null;
+/**
+ * Check if there's an active focus trap
+ */
+declare function hasFocusTrap(): boolean;
+
+/**
+ * Focus Visible Management
+ *
+ * Provides :focus-visible polyfill behavior and utilities
+ * for distinguishing keyboard focus from mouse/touch focus
+ */
+type FocusSource = 'keyboard' | 'mouse' | 'touch' | 'unknown';
+/**
+ * Initialize focus-visible tracking
+ * Call this once at app startup
+ */
+declare function initFocusVisible(): () => void;
+/**
+ * Check if current focus should be visible (keyboard-initiated)
+ */
+declare function isFocusVisible(): boolean;
+/**
+ * Check if an element has visible focus
+ */
+declare function hasVisibleFocus(element: HTMLElement): boolean;
+/**
+ * Get the source of the last focus event
+ */
+declare function getLastFocusSource(): FocusSource;
+/**
+ * Manually set focus as visible (useful for programmatic focus)
+ */
+declare function setFocusVisible(element: HTMLElement, visible: boolean): void;
+/**
+ * Focus an element with visible focus ring (keyboard-style)
+ */
+declare function focusWithVisibleRing(element: HTMLElement, options?: FocusOptions): void;
+
+/**
+ * Focus Scope Management
+ *
+ * Manages focus within a scope, supporting roving tabindex
+ * and programmatic focus control
+ */
+interface FocusScopeOptions {
+    /** Whether to contain focus within the scope */
+    contain?: boolean;
+    /** Whether to restore focus when scope is destroyed */
+    restoreFocus?: boolean;
+    /** Whether to auto-focus the first element */
+    autoFocus?: boolean;
+}
+interface FocusScope {
+    /** Focus the first focusable element */
+    focusFirst: () => void;
+    /** Focus the last focusable element */
+    focusLast: () => void;
+    /** Focus the next focusable element */
+    focusNext: (options?: {
+        wrap?: boolean;
+    }) => void;
+    /** Focus the previous focusable element */
+    focusPrevious: (options?: {
+        wrap?: boolean;
+    }) => void;
+    /** Focus a specific element by index */
+    focusAt: (index: number) => void;
+    /** Get the currently focused element within scope */
+    getFocused: () => HTMLElement | null;
+    /** Get all focusable elements in the scope */
+    getElements: () => HTMLElement[];
+    /** Destroy the scope and cleanup */
+    destroy: () => void;
+}
+/**
+ * Create a focus scope for a container
+ */
+declare function createFocusScope(container: HTMLElement, options?: FocusScopeOptions): FocusScope;
+/**
+ * Roving Tabindex - Only one element is tabbable at a time
+ * Standard pattern for composite widgets like toolbars, menus, listboxes
+ */
+interface RovingTabindexOptions {
+    /** Current active index */
+    initialIndex?: number;
+    /** Orientation for arrow key navigation */
+    orientation?: 'horizontal' | 'vertical' | 'both';
+    /** Whether to wrap around */
+    wrap?: boolean;
+    /** Called when selection changes */
+    onSelectionChange?: (index: number, element: HTMLElement) => void;
+}
+interface RovingTabindex {
+    /** Move to the next item */
+    next: () => void;
+    /** Move to the previous item */
+    previous: () => void;
+    /** Move to the first item */
+    first: () => void;
+    /** Move to the last item */
+    last: () => void;
+    /** Move to a specific index */
+    goto: (index: number) => void;
+    /** Get current index */
+    getIndex: () => number;
+    /** Update elements (call when DOM changes) */
+    update: () => void;
+    /** Cleanup */
+    destroy: () => void;
+}
+declare function createRovingTabindex(container: HTMLElement, selector: string, options?: RovingTabindexOptions): RovingTabindex;
+
+export { type FocusScope, type FocusScopeOptions, type RovingTabindex, type RovingTabindexOptions, createFocusScope, createFocusTrap, createRovingTabindex, focusWithVisibleRing, getActiveFocusTrap, getLastFocusSource, hasFocusTrap, hasVisibleFocus, initFocusVisible, isFocusVisible, setFocusVisible };

package/dist/focus/index.js

@@ -0,0 +1,4 @@
+export { createFocusScope, createFocusTrap, createRovingTabindex, focusWithVisibleRing, getActiveFocusTrap, getLastFocusSource, hasFocusTrap, hasVisibleFocus, initFocusVisible, isFocusVisible, setFocusVisible } from '../chunk-2PUYKF2E.js';
+import '../chunk-Z7K2G6FX.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/focus/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}