ng-primitives 0.99.6 → 0.100.0

package/a11y/index.d.ts

@@ -1,50 +1,94 @@
 import * as _angular_core from '@angular/core';
-import { Signal, ElementRef } from '@angular/core';
+import { Signal } from '@angular/core';
 
-interface ActiveDescendantManagerProps<T extends NgpActivatable> {
+interface NgpActiveDescendantManagerProps {
     /**
      * The disabled state of the active descendant group.
      * @default false
      */
     disabled?: Signal<boolean>;
     /**
-     * The items in the active descendant group.
+     * The number of items in the active descendant group.
      */
-    items: Signal<T[]>;
+    count: Signal<number>;
+    /**
+     * Get the id for the item at a given index.
+     */
+    getItemId: (index: number) => string | undefined;
+    /**
+     * Whether the item at a given index is disabled.
+     */
+    isItemDisabled: (index: number) => boolean;
+    /**
+     * Scroll the active descendant item into view.
+     */
+    scrollIntoView: (index: number) => void;
     /**
      * Whether active descendant should wrap around.
      * @default false
      */
     wrap?: Signal<boolean>;
+}
+interface NgpActiveDescendantManagerState {
     /**
-     * A callback invoked when the active descendant changes.
+     * The index of the active descendant item.
      */
-    onActiveDescendantChange?: (activeDescendant: T | undefined) => void;
-}
-interface NgpActivatable {
+    index: Signal<number>;
     /**
-     * The id of the item.
+     * The id of the active descendant item.
      */
-    id: Signal<string>;
+    id: Signal<string | undefined>;
     /**
-     * Whether the item is disabled.
+     * Activate an item in the active descendant group.
      */
-    disabled?: Signal<boolean>;
+    activateByIndex: (index: number, options?: ActivationOptions) => void;
+    /**
+     * Activate an item in the active descendant group by id.
+     */
+    activateById: (id: string, options?: ActivationOptions) => void;
     /**
-     * The element that represents the item.
+     * Activate the first enabled item in the active descendant group.
      */
-    elementRef: ElementRef<HTMLElement>;
+    first: (options?: ActivationOptions) => void;
+    /**
+     * Activate the last enabled item in the active descendant group.
+     */
+    last: (options?: ActivationOptions) => void;
+    /**
+     * Activate the next enabled item in the active descendant group.
+     */
+    next: (options?: ActivationOptions) => void;
+    /**
+     * Activate the previous enabled item in the active descendant group.
+     */
+    previous: (options?: ActivationOptions) => void;
+    /**
+     * Ensure there is an active descendant, this is useful when the items in the group change.
+     */
+    validate: () => void;
+    /**
+     * Reset the active descendant group, clearing the active index.
+     */
+    reset: (options?: ActivationOptions) => void;
 }
-declare function activeDescendantManager<T extends NgpActivatable>({ items, disabled: _disabled, wrap, onActiveDescendantChange, }: ActiveDescendantManagerProps<T>): {
-    activeDescendant: Signal<string | undefined>;
-    activeItem: Signal<T | undefined>;
-    activate: (item: T | undefined) => void;
-    first: () => void;
-    last: () => void;
-    next: () => void;
-    previous: () => void;
-    reset: () => void;
+declare function activeDescendantManager({ disabled: _disabled, wrap, count, getItemId, isItemDisabled, scrollIntoView, }: NgpActiveDescendantManagerProps): {
+    id: Signal<string | undefined>;
+    index: _angular_core.WritableSignal<number>;
+    activateByIndex: (index: number, { scroll, origin }?: ActivationOptions) => void;
+    activateById: (id: string, options?: ActivationOptions) => void;
+    first: (options?: ActivationOptions) => void;
+    last: (options?: ActivationOptions) => void;
+    next: (options?: ActivationOptions) => void;
+    previous: (options?: ActivationOptions) => void;
+    reset: ({ scroll, origin }?: ActivationOptions) => void;
+    validate: () => void;
 };
+interface ActivationOptions {
+    /** Whether to scroll the activated item into view. */
+    scroll?: boolean;
+    /** Define the source of activation. */
+    origin?: 'keyboard' | 'pointer';
+}
 
 /**
  * The state interface for the VisuallyHidden pattern.
@@ -103,4 +147,4 @@ declare class NgpVisuallyHidden {
 }
 
 export { NgpVisuallyHidden, NgpVisuallyHiddenStateToken, activeDescendantManager, injectVisuallyHiddenState, ngpVisuallyHidden, provideVisuallyHiddenState };
-export type { NgpActivatable, NgpVisuallyHiddenProps, NgpVisuallyHiddenState };
+export type { ActivationOptions, NgpActiveDescendantManagerProps, NgpActiveDescendantManagerState, NgpVisuallyHiddenProps, NgpVisuallyHiddenState };

package/combobox/index.d.ts

@@ -4,10 +4,10 @@ import * as ng_primitives_state from 'ng-primitives/state';
 import * as ng_primitives_combobox from 'ng-primitives/combobox';
 import * as ng_primitives_internal from 'ng-primitives/internal';
 import * as ng_primitives_utils from 'ng-primitives/utils';
-import { BooleanInput } from '@angular/cdk/coercion';
-import { NgpActivatable } from 'ng-primitives/a11y';
+import { BooleanInput, NumberInput } from '@angular/cdk/coercion';
 import * as ng_primitives_portal from 'ng-primitives/portal';
 import { NgpOverlay } from 'ng-primitives/portal';
+import * as ng_primitives_a11y from 'ng-primitives/a11y';
 
 declare class NgpComboboxButton {
     /** Access the combobox state. */
@@ -84,7 +84,7 @@ declare class NgpComboboxInput {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NgpComboboxInput, "input[ngpComboboxInput]", ["ngpComboboxInput"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-declare class NgpComboboxOption implements OnInit, OnDestroy, NgpActivatable {
+declare class NgpComboboxOption implements OnInit, OnDestroy {
     /** Access the combobox state. */
     protected readonly state: _angular_core.Signal<ng_primitives_state.State<ng_primitives_combobox.NgpCombobox>>;
     /**
@@ -98,6 +98,11 @@ declare class NgpComboboxOption implements OnInit, OnDestroy, NgpActivatable {
     readonly value: _angular_core.InputSignal<any>;
     /** The disabled state of the option. */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
+    /**
+     * The index of the option in the combobox. This can be used to define the order of options
+     * when virtual scrolling is used or when the order is not determined by DOM order.
+     */
+    readonly index: _angular_core.InputSignalWithTransform<number | undefined, NumberInput>;
     /**
      * Whether this option is the active descendant.
      * @internal
@@ -129,7 +134,7 @@ declare class NgpComboboxOption implements OnInit, OnDestroy, NgpActivatable {
      */
     protected onPointerLeave(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgpComboboxOption, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NgpComboboxOption, "[ngpComboboxOption]", ["ngpComboboxOption"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "ngpComboboxOptionValue"; "required": false; "isSignal": true; }; "disabled": { "alias": "ngpComboboxOptionDisabled"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NgpComboboxOption, "[ngpComboboxOption]", ["ngpComboboxOption"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "ngpComboboxOptionValue"; "required": false; "isSignal": true; }; "disabled": { "alias": "ngpComboboxOptionDisabled"; "required": false; "isSignal": true; }; "index": { "alias": "ngpComboboxOptionIndex"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare class NgpComboboxPortal implements OnDestroy {
@@ -224,6 +229,25 @@ declare class NgpCombobox {
     readonly placement: _angular_core.InputSignal<NgpComboboxPlacement>;
     /** The container for the dropdown. */
     readonly container: _angular_core.InputSignal<string | HTMLElement | null>;
+    /**
+     * A function that will scroll the active option into view. This can be overridden
+     * for cases such as virtual scrolling where we cannot scroll the option directly because
+     * it may not be rendered.
+     */
+    readonly scrollToOption: _angular_core.InputSignal<((index: number) => void) | undefined>;
+    /**
+     * The number of options within the combobox. By default this is calculated based on the
+     * options added to the combobox, but in virtual scrolling scenarios the total number of options
+     * may be different from the number of rendered options.
+     */
+    readonly optionCount: _angular_core.InputSignalWithTransform<number | undefined, NumberInput>;
+    /**
+     * Provide all the option values to the combobox. This is useful for virtual scrolling scenarios
+     * where not all options are rendered in the DOM. This is not an alternative to adding the options
+     * in the DOM, it is only to provide the combobox with the full list of options. This list should match
+     * the order of the options as they would appear in the DOM.
+     */
+    readonly allOptions: _angular_core.InputSignal<any[] | undefined>;
     /**
      * Store the combobox input
      * @internal
@@ -259,19 +283,26 @@ declare class NgpCombobox {
      * @internal
      */
     readonly open: _angular_core.Signal<boolean>;
+    /**
+     * The options sorted by their index or DOM position.
+     * @internal
+     */
+    readonly sortedOptions: _angular_core.Signal<NgpComboboxOption[]>;
     /**
      * The active key descendant manager.
      * @internal
      */
     readonly activeDescendantManager: {
-        activeDescendant: _angular_core.Signal<string | undefined>;
-        activeItem: _angular_core.Signal<NgpComboboxOption | undefined>;
-        activate: (item: NgpComboboxOption | undefined) => void;
-        first: () => void;
-        last: () => void;
-        next: () => void;
-        previous: () => void;
-        reset: () => void;
+        id: _angular_core.Signal<string | undefined>;
+        index: _angular_core.WritableSignal<number>;
+        activateByIndex: (index: number, { scroll, origin }?: ng_primitives_a11y.ActivationOptions) => void;
+        activateById: (id: string, options?: ng_primitives_a11y.ActivationOptions) => void;
+        first: (options?: ng_primitives_a11y.ActivationOptions) => void;
+        last: (options?: ng_primitives_a11y.ActivationOptions) => void;
+        next: (options?: ng_primitives_a11y.ActivationOptions) => void;
+        previous: (options?: ng_primitives_a11y.ActivationOptions) => void;
+        reset: ({ scroll, origin }?: ng_primitives_a11y.ActivationOptions) => void;
+        validate: () => void;
     };
     /** The control status */
     protected readonly controlStatus: _angular_core.Signal<ng_primitives_utils.NgpControlStatus | undefined>;
@@ -307,16 +338,16 @@ declare class NgpCombobox {
     deselectOption(option: NgpComboboxOption): void;
     /**
      * Toggle the selection of an option.
-     * @param option The option to toggle.
+     * @param id The id of the option to toggle.
      * @internal
      */
-    toggleOption(option: NgpComboboxOption): void;
+    toggleOption(id: string): void;
     /**
      * Determine if an option is selected.
      * @param option The option to check.
      * @internal
      */
-    isOptionSelected(option: NgpComboboxOption): boolean;
+    isOptionSelected(option: T): boolean;
     /**
      * Activate the next option in the list if there is one.
      * If there is no option currently active, activate the selected option or the first option.
@@ -396,8 +427,10 @@ declare class NgpCombobox {
      * @internal
      */
     protected onBlur(event: FocusEvent): void;
+    private scrollTo;
+    private getOptionAtIndex;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgpCombobox, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NgpCombobox, "[ngpCombobox]", ["ngpCombobox"], { "value": { "alias": "ngpComboboxValue"; "required": false; "isSignal": true; }; "multiple": { "alias": "ngpComboboxMultiple"; "required": false; "isSignal": true; }; "disabled": { "alias": "ngpComboboxDisabled"; "required": false; "isSignal": true; }; "allowDeselect": { "alias": "ngpComboboxAllowDeselect"; "required": false; "isSignal": true; }; "compareWith": { "alias": "ngpComboboxCompareWith"; "required": false; "isSignal": true; }; "placement": { "alias": "ngpComboboxDropdownPlacement"; "required": false; "isSignal": true; }; "container": { "alias": "ngpComboboxDropdownContainer"; "required": false; "isSignal": true; }; }, { "valueChange": "ngpComboboxValueChange"; "openChange": "ngpComboboxOpenChange"; }, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NgpCombobox, "[ngpCombobox]", ["ngpCombobox"], { "value": { "alias": "ngpComboboxValue"; "required": false; "isSignal": true; }; "multiple": { "alias": "ngpComboboxMultiple"; "required": false; "isSignal": true; }; "disabled": { "alias": "ngpComboboxDisabled"; "required": false; "isSignal": true; }; "allowDeselect": { "alias": "ngpComboboxAllowDeselect"; "required": false; "isSignal": true; }; "compareWith": { "alias": "ngpComboboxCompareWith"; "required": false; "isSignal": true; }; "placement": { "alias": "ngpComboboxDropdownPlacement"; "required": false; "isSignal": true; }; "container": { "alias": "ngpComboboxDropdownContainer"; "required": false; "isSignal": true; }; "scrollToOption": { "alias": "ngpComboboxScrollToOption"; "required": false; "isSignal": true; }; "optionCount": { "alias": "ngpComboboxOptionCount"; "required": false; "isSignal": true; }; "allOptions": { "alias": "ngpComboboxOptions"; "required": false; "isSignal": true; }; }, { "valueChange": "ngpComboboxValueChange"; "openChange": "ngpComboboxOpenChange"; }, never, never, true, never>;
 }
 type NgpComboboxPlacement = 'top' | 'right' | 'bottom' | 'left' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-start' | 'bottom-end' | 'left-start' | 'left-end';
 

package/fesm2022/ng-primitives-a11y.mjs

@@ -1,126 +1,146 @@
 import * as i0 from '@angular/core';
-import { computed, signal, inject, ChangeDetectorRef, Directive } from '@angular/core';
-import { explicitEffect, injectElementRef } from 'ng-primitives/internal';
-import { createPrimitive, controlled, styleBinding } from 'ng-primitives/state';
+import { signal, computed, inject, ChangeDetectorRef, Directive } from '@angular/core';
+import { controlled, createPrimitive, styleBinding } from 'ng-primitives/state';
+import { injectDisposables } from 'ng-primitives/utils';
+import { injectElementRef } from 'ng-primitives/internal';
 
-function activeDescendantManager({ items, disabled: _disabled, wrap, onActiveDescendantChange, }) {
-    const sortedOptions = computed(() => items()
-        .slice()
-        .sort((a, b) => {
-        const aElement = a.elementRef.nativeElement;
-        const bElement = b.elementRef.nativeElement;
-        return aElement.compareDocumentPosition(bElement) & Node.DOCUMENT_POSITION_FOLLOWING
-            ? -1
-            : 1;
-    }), ...(ngDevMode ? [{ debugName: "sortedOptions" }] : []));
+function activeDescendantManager({ disabled: _disabled = signal(false), wrap, count, getItemId, isItemDisabled, scrollIntoView, }) {
+    const disposables = injectDisposables();
     const activeIndex = signal(0, ...(ngDevMode ? [{ debugName: "activeIndex" }] : []));
-    const activeItem = computed(() => sortedOptions()?.[activeIndex()], ...(ngDevMode ? [{ debugName: "activeItem" }] : []));
-    const disabled = computed(() => _disabled?.() || items().every(item => item.disabled?.()), ...(ngDevMode ? [{ debugName: "disabled" }] : []));
-    // any time the item list changes, check if the active index is still valid
-    explicitEffect([sortedOptions], ([items]) => {
-        if (activeIndex() >= items.length || activeIndex() < 0) {
-            activateByIndex(items.findIndex(item => !item.disabled?.()));
-        }
-        if (activeIndex() === -1 && items.length > 0) {
-            activateByIndex(0);
+    const disabled = controlled(_disabled);
+    let isIgnoringPointer = false;
+    let clearPointerIgnoreTimer;
+    // compute the id of the active descendant
+    const id = computed(() => {
+        const index = activeIndex();
+        return index >= 0 && index < count() ? getItemId(index) : undefined;
+    }, ...(ngDevMode ? [{ debugName: "id" }] : []));
+    /**
+     * Start ignoring pointer interactions temporarily.
+     */
+    function startIgnoringPointer() {
+        isIgnoringPointer = true;
+        // Clear any existing timer
+        clearPointerIgnoreTimer?.();
+        // Reset ignore state after a short delay
+        clearPointerIgnoreTimer = disposables.setTimeout(() => {
+            isIgnoringPointer = false;
+            clearPointerIgnoreTimer = undefined;
+        }, 200); // 200ms should be enough for scroll to complete
+    }
+    function activateByIndex(index, { scroll = true, origin } = {}) {
+        if (disabled() || (index >= 0 && isItemDisabled(index))) {
+            return;
         }
-        if (disabled() || items.length === 0) {
-            activateByIndex(-1);
+        // if the origin is the pointer but we are ignoring pointer interactions, do nothing
+        if (origin === 'pointer' && isIgnoringPointer) {
+            return;
         }
-    });
-    const activeDescendant = computed(() => {
-        const item = activeItem();
-        if (disabled() || !item) {
-            return undefined;
+        // ensure any pointer interactions triggered via scrolling due to keyboard navigation are ignored
+        if (origin === 'keyboard') {
+            startIgnoringPointer();
         }
-        return item.id();
-    }, ...(ngDevMode ? [{ debugName: "activeDescendant" }] : []));
-    function activateByIndex(index) {
         activeIndex.set(index);
-        onActiveDescendantChange?.(activeItem());
-    }
-    /**
-     * Activate an item in the active descendant group.
-     * @param item The item to activate.
-     */
-    const activate = (item) => {
-        if (item === undefined) {
-            activateByIndex(-1);
+        if (index < 0 || index >= count()) {
             return;
         }
-        if (disabled() || item.disabled?.()) {
-            return;
+        if (scroll) {
+            scrollIntoView(index);
         }
-        activateByIndex(sortedOptions().indexOf(item));
-    };
-    /**
-     * Activate the first enabled item in the active descendant group.
-     */
-    const first = () => {
-        const item = sortedOptions().findIndex(item => !item.disabled?.());
-        if (item !== -1) {
-            activateByIndex(item);
+    }
+    function activateById(id, options = {}) {
+        for (let i = 0; i < count(); i++) {
+            if (getItemId(i) === id) {
+                activateByIndex(i, options);
+                return;
+            }
         }
-    };
-    /**
-     * Activate the last enabled item in the active descendant group.
-     */
-    const last = () => {
-        const item = [...sortedOptions()].reverse().findIndex(item => !item.disabled?.());
-        if (item !== -1) {
-            activateByIndex(sortedOptions().length - 1 - item);
+    }
+    function first(options = {}) {
+        for (let i = 0; i < count(); i++) {
+            if (!isItemDisabled(i)) {
+                activateByIndex(i, options);
+                return;
+            }
         }
-    };
-    const findNextIndex = (items, currentIndex, direction, wrap) => {
-        let index = (currentIndex + direction + items.length) % items.length;
-        while (index !== currentIndex) {
-            const item = items[index];
-            if (item && !item.disabled?.()) {
-                return index;
+    }
+    function last(options = {}) {
+        for (let i = count() - 1; i >= 0; i--) {
+            if (!isItemDisabled(i)) {
+                activateByIndex(i, options);
+                return;
+            }
+        }
+    }
+    function next(options = {}) {
+        let index = activeIndex() + 1;
+        while (index !== activeIndex()) {
+            if (index >= count()) {
+                if (wrap?.()) {
+                    index = 0;
+                }
+                else {
+                    return;
+                }
             }
-            index = (index + direction + items.length) % items.length;
-            if (!wrap &&
-                ((direction === 1 && index === 0) || (direction === -1 && index === items.length - 1))) {
-                break;
+            if (!isItemDisabled(index)) {
+                activateByIndex(index, options);
+                return;
             }
+            index++;
         }
-        return undefined;
-    };
-    /**
-     * Activate the next enabled item in the active descendant group.
-     */
-    const next = () => {
-        const items = sortedOptions();
-        const nextIndex = findNextIndex(items, activeIndex(), 1, wrap?.() ?? false);
-        if (nextIndex !== undefined) {
-            activateByIndex(nextIndex);
+    }
+    function previous(options = {}) {
+        let index = activeIndex() - 1;
+        while (index !== activeIndex()) {
+            if (index < 0) {
+                if (wrap?.()) {
+                    index = count() - 1;
+                }
+                else {
+                    return;
+                }
+            }
+            if (!isItemDisabled(index)) {
+                activateByIndex(index, options);
+                return;
+            }
+            index--;
         }
-    };
-    /**
-     * Activate the previous enabled item in the active descendant group.
-     */
-    const previous = () => {
-        const items = sortedOptions();
-        const prevIndex = findNextIndex(items, activeIndex(), -1, wrap?.() ?? false);
-        if (prevIndex !== undefined) {
-            activateByIndex(prevIndex);
+    }
+    // any time the item list changes, check if the active index is still valid
+    function validate() {
+        const index = activeIndex();
+        // if the index is out of bounds, reset it
+        if (index >= count() || index < 0 || isItemDisabled(index)) {
+            // find the first enabled item
+            for (let i = 0; i < count(); i++) {
+                if (!isItemDisabled(i)) {
+                    activateByIndex(i);
+                    return;
+                }
+            }
+            // if no enabled items, deactivate
+            activateByIndex(-1);
         }
-    };
+    }
     /**
      * Reset the active descendant group, clearing the active index.
      */
-    const reset = () => {
-        activateByIndex(-1);
+    const reset = ({ scroll = false, origin } = {}) => {
+        activateByIndex(-1, { scroll, origin });
     };
     return {
-        activeDescendant,
-        activeItem,
-        activate,
+        id,
+        index: activeIndex,
+        activateByIndex,
+        activateById,
         first,
         last,
         next,
         previous,
         reset,
+        validate,
     };
 }
 

package/fesm2022/ng-primitives-a11y.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ng-primitives-a11y.mjs","sources":["../../../../packages/ng-primitives/a11y/src/active-descendant/active-descendant.ts","../../../../packages/ng-primitives/a11y/src/visually-hidden/visually-hidden-state.ts","../../../../packages/ng-primitives/a11y/src/visually-hidden/visually-hidden.ts","../../../../packages/ng-primitives/a11y/src/ng-primitives-a11y.ts"],"sourcesContent":["import { computed, ElementRef, Signal, signal } from '@angular/core';\nimport { explicitEffect } from 'ng-primitives/internal';\n\ninterface ActiveDescendantManagerProps<T extends NgpActivatable> {\n  /**\n   * The disabled state of the active descendant group.\n   * @default false\n   */\n  disabled?: Signal<boolean>;\n  /**\n   * The items in the active descendant group.\n   */\n  items: Signal<T[]>;\n  /**\n   * Whether active descendant should wrap around.\n   * @default false\n   */\n  wrap?: Signal<boolean>;\n  /**\n   * A callback invoked when the active descendant changes.\n   */\n  onActiveDescendantChange?: (activeDescendant: T | undefined) => void;\n}\n\nexport interface NgpActivatable {\n  /**\n   * The id of the item.\n   */\n  id: Signal<string>;\n  /**\n   * Whether the item is disabled.\n   */\n  disabled?: Signal<boolean>;\n  /**\n   * The element that represents the item.\n   */\n  elementRef: ElementRef<HTMLElement>;\n}\n\nexport function activeDescendantManager<T extends NgpActivatable>({\n  items,\n  disabled: _disabled,\n  wrap,\n  onActiveDescendantChange,\n}: ActiveDescendantManagerProps<T>) {\n  const sortedOptions = computed(() =>\n    items()\n      .slice()\n      .sort((a, b) => {\n        const aElement = a.elementRef.nativeElement;\n        const bElement = b.elementRef.nativeElement;\n        return aElement.compareDocumentPosition(bElement) & Node.DOCUMENT_POSITION_FOLLOWING\n          ? -1\n          : 1;\n      }),\n  );\n\n  const activeIndex = signal<number>(0);\n  const activeItem = computed<T | undefined>(() => sortedOptions()?.[activeIndex()]);\n  const disabled = computed(() => _disabled?.() || items().every(item => item.disabled?.()));\n\n  // any time the item list changes, check if the active index is still valid\n  explicitEffect([sortedOptions], ([items]) => {\n    if (activeIndex() >= items.length || activeIndex() < 0) {\n      activateByIndex(items.findIndex(item => !item.disabled?.()));\n    }\n    if (activeIndex() === -1 && items.length > 0) {\n      activateByIndex(0);\n    }\n    if (disabled() || items.length === 0) {\n      activateByIndex(-1);\n    }\n  });\n\n  const activeDescendant = computed(() => {\n    const item = activeItem();\n\n    if (disabled() || !item) {\n      return undefined;\n    }\n\n    return item.id();\n  });\n\n  function activateByIndex(index: number) {\n    activeIndex.set(index);\n    onActiveDescendantChange?.(activeItem());\n  }\n\n  /**\n   * Activate an item in the active descendant group.\n   * @param item The item to activate.\n   */\n  const activate = (item: T | undefined) => {\n    if (item === undefined) {\n      activateByIndex(-1);\n      return;\n    }\n\n    if (disabled() || item.disabled?.()) {\n      return;\n    }\n\n    activateByIndex(sortedOptions().indexOf(item));\n  };\n\n  /**\n   * Activate the first enabled item in the active descendant group.\n   */\n  const first = () => {\n    const item = sortedOptions().findIndex(item => !item.disabled?.());\n\n    if (item !== -1) {\n      activateByIndex(item);\n    }\n  };\n\n  /**\n   * Activate the last enabled item in the active descendant group.\n   */\n  const last = () => {\n    const item = [...sortedOptions()].reverse().findIndex(item => !item.disabled?.());\n\n    if (item !== -1) {\n      activateByIndex(sortedOptions().length - 1 - item);\n    }\n  };\n\n  const findNextIndex = (\n    items: NgpActivatable[],\n    currentIndex: number,\n    direction: 1 | -1,\n    wrap: boolean,\n  ): number | undefined => {\n    let index = (currentIndex + direction + items.length) % items.length;\n\n    while (index !== currentIndex) {\n      const item = items[index];\n      if (item && !item.disabled?.()) {\n        return index;\n      }\n      index = (index + direction + items.length) % items.length;\n\n      if (\n        !wrap &&\n        ((direction === 1 && index === 0) || (direction === -1 && index === items.length - 1))\n      ) {\n        break;\n      }\n    }\n\n    return undefined;\n  };\n\n  /**\n   * Activate the next enabled item in the active descendant group.\n   */\n  const next = () => {\n    const items = sortedOptions();\n    const nextIndex = findNextIndex(items, activeIndex(), 1, wrap?.() ?? false);\n\n    if (nextIndex !== undefined) {\n      activateByIndex(nextIndex);\n    }\n  };\n\n  /**\n   * Activate the previous enabled item in the active descendant group.\n   */\n  const previous = () => {\n    const items = sortedOptions();\n    const prevIndex = findNextIndex(items, activeIndex(), -1, wrap?.() ?? false);\n\n    if (prevIndex !== undefined) {\n      activateByIndex(prevIndex);\n    }\n  };\n\n  /**\n   * Reset the active descendant group, clearing the active index.\n   */\n  const reset = () => {\n    activateByIndex(-1);\n  };\n\n  return {\n    activeDescendant,\n    activeItem,\n    activate,\n    first,\n    last,\n    next,\n    previous,\n    reset,\n  };\n}\n","import { ChangeDetectorRef, inject, Signal, signal } from '@angular/core';\nimport { injectElementRef } from 'ng-primitives/internal';\nimport { controlled, createPrimitive, styleBinding } from 'ng-primitives/state';\n\n/**\n * The state interface for the VisuallyHidden pattern.\n */\nexport interface NgpVisuallyHiddenState {\n  /**\n   * Whether the element is hidden.\n   */\n  readonly hidden: Signal<boolean>;\n\n  /**\n   * Set the element visibility.\n   * @param visible\n   */\n  setVisibility(visible: boolean): void;\n}\n\n/**\n * The props interface for the VisuallyHidden pattern.\n */\nexport interface NgpVisuallyHiddenProps {\n  /**\n   * Whether the element is hidden. Default is true.\n   */\n  readonly hidden?: Signal<boolean>;\n}\n\nexport const [\n  NgpVisuallyHiddenStateToken,\n  ngpVisuallyHidden,\n  injectVisuallyHiddenState,\n  provideVisuallyHiddenState,\n] = createPrimitive(\n  'NgpVisuallyHidden',\n  ({ hidden: _hidden = signal(true) }: NgpVisuallyHiddenProps): NgpVisuallyHiddenState => {\n    const element = injectElementRef();\n    const hidden = controlled(_hidden);\n    const changeDetector = inject(ChangeDetectorRef);\n\n    // Apply styles to visually hide the element\n    styleBinding(element, 'position', () => (hidden() ? 'absolute' : null));\n    styleBinding(element, 'width', () => (hidden() ? '1px' : null));\n    styleBinding(element, 'height', () => (hidden() ? '1px' : null));\n    styleBinding(element, 'margin', () => (hidden() ? '-1px' : null));\n    styleBinding(element, 'padding', () => (hidden() ? '0' : null));\n    styleBinding(element, 'overflow', () => (hidden() ? 'hidden' : null));\n    styleBinding(element, 'clip', () => (hidden() ? 'rect(0, 0, 0, 0)' : null));\n    styleBinding(element, 'white-space', () => (hidden() ? 'nowrap' : null));\n    styleBinding(element, 'border', () => (hidden() ? '0' : null));\n    styleBinding(element, 'word-wrap', () => (hidden() ? 'normal' : null));\n    styleBinding(element, 'outline', () => (hidden() ? '0' : null));\n    styleBinding(element, '-webkit-appearance', () => (hidden() ? 'none' : null));\n    styleBinding(element, '-moz-appearance', () => (hidden() ? 'none' : null));\n    styleBinding(element, 'inset-inline-start', () => (hidden() ? '0' : null));\n\n    function setVisibility(visible: boolean): void {\n      hidden.set(!visible);\n      // If a change-detection cycle might be running, schedule detection asynchronously and exit\n      // to avoid re-entrancy. Otherwise fall through to call detectChanges synchronously.\n      Promise.resolve().then(() => changeDetector.detectChanges());\n    }\n\n    return {\n      hidden: hidden.asReadonly(),\n      setVisibility,\n    } satisfies NgpVisuallyHiddenState;\n  },\n);\n","import { Directive } from '@angular/core';\nimport { ngpVisuallyHidden, provideVisuallyHiddenState } from './visually-hidden-state';\n\n/**\n * Hide an element visually while keeping it present in the DOM.\n */\n@Directive({\n  selector: '[ngpVisuallyHidden]',\n  exportAs: 'ngpVisuallyHidden',\n  providers: [provideVisuallyHiddenState()],\n})\nexport class NgpVisuallyHidden {\n  protected readonly state = ngpVisuallyHidden({});\n\n  /**\n   * Set the element visibility.\n   * @param visible\n   */\n  setVisibility(visible: boolean): void {\n    this.state.setVisibility(visible);\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"ng-primitives-a11y.mjs","sources":["../../../../packages/ng-primitives/a11y/src/active-descendant/active-descendant.ts","../../../../packages/ng-primitives/a11y/src/visually-hidden/visually-hidden-state.ts","../../../../packages/ng-primitives/a11y/src/visually-hidden/visually-hidden.ts","../../../../packages/ng-primitives/a11y/src/ng-primitives-a11y.ts"],"sourcesContent":["import { computed, Signal, signal } from '@angular/core';\nimport { controlled } from 'ng-primitives/state';\nimport { injectDisposables } from 'ng-primitives/utils';\n\nexport interface NgpActiveDescendantManagerProps {\n  /**\n   * The disabled state of the active descendant group.\n   * @default false\n   */\n  disabled?: Signal<boolean>;\n\n  /**\n   * The number of items in the active descendant group.\n   */\n  count: Signal<number>;\n\n  /**\n   * Get the id for the item at a given index.\n   */\n  getItemId: (index: number) => string | undefined;\n\n  /**\n   * Whether the item at a given index is disabled.\n   */\n  isItemDisabled: (index: number) => boolean;\n\n  /**\n   * Scroll the active descendant item into view.\n   */\n  scrollIntoView: (index: number) => void;\n\n  /**\n   * Whether active descendant should wrap around.\n   * @default false\n   */\n  wrap?: Signal<boolean>;\n}\n\nexport interface NgpActiveDescendantManagerState {\n  /**\n   * The index of the active descendant item.\n   */\n  index: Signal<number>;\n\n  /**\n   * The id of the active descendant item.\n   */\n  id: Signal<string | undefined>;\n\n  /**\n   * Activate an item in the active descendant group.\n   */\n  activateByIndex: (index: number, options?: ActivationOptions) => void;\n\n  /**\n   * Activate an item in the active descendant group by id.\n   */\n  activateById: (id: string, options?: ActivationOptions) => void;\n\n  /**\n   * Activate the first enabled item in the active descendant group.\n   */\n  first: (options?: ActivationOptions) => void;\n  /**\n   * Activate the last enabled item in the active descendant group.\n   */\n  last: (options?: ActivationOptions) => void;\n  /**\n   * Activate the next enabled item in the active descendant group.\n   */\n  next: (options?: ActivationOptions) => void;\n  /**\n   * Activate the previous enabled item in the active descendant group.\n   */\n  previous: (options?: ActivationOptions) => void;\n  /**\n   * Ensure there is an active descendant, this is useful when the items in the group change.\n   */\n  validate: () => void;\n  /**\n   * Reset the active descendant group, clearing the active index.\n   */\n  reset: (options?: ActivationOptions) => void;\n}\n\nexport function activeDescendantManager({\n  disabled: _disabled = signal(false),\n  wrap,\n  count,\n  getItemId,\n  isItemDisabled,\n  scrollIntoView,\n}: NgpActiveDescendantManagerProps) {\n  const disposables = injectDisposables();\n\n  const activeIndex = signal<number>(0);\n  const disabled = controlled(_disabled);\n  let isIgnoringPointer = false;\n\n  let clearPointerIgnoreTimer: (() => void) | undefined;\n\n  // compute the id of the active descendant\n  const id = computed(() => {\n    const index = activeIndex();\n    return index >= 0 && index < count() ? getItemId(index) : undefined;\n  });\n\n  /**\n   * Start ignoring pointer interactions temporarily.\n   */\n  function startIgnoringPointer(): void {\n    isIgnoringPointer = true;\n\n    // Clear any existing timer\n    clearPointerIgnoreTimer?.();\n\n    // Reset ignore state after a short delay\n    clearPointerIgnoreTimer = disposables.setTimeout(() => {\n      isIgnoringPointer = false;\n      clearPointerIgnoreTimer = undefined;\n    }, 200); // 200ms should be enough for scroll to complete\n  }\n\n  function activateByIndex(index: number, { scroll = true, origin }: ActivationOptions = {}): void {\n    if (disabled() || (index >= 0 && isItemDisabled(index))) {\n      return;\n    }\n\n    // if the origin is the pointer but we are ignoring pointer interactions, do nothing\n    if (origin === 'pointer' && isIgnoringPointer) {\n      return;\n    }\n\n    // ensure any pointer interactions triggered via scrolling due to keyboard navigation are ignored\n    if (origin === 'keyboard') {\n      startIgnoringPointer();\n    }\n\n    activeIndex.set(index);\n\n    if (index < 0 || index >= count()) {\n      return;\n    }\n\n    if (scroll) {\n      scrollIntoView(index);\n    }\n  }\n\n  function activateById(id: string, options: ActivationOptions = {}): void {\n    for (let i = 0; i < count(); i++) {\n      if (getItemId(i) === id) {\n        activateByIndex(i, options);\n        return;\n      }\n    }\n  }\n\n  function first(options: ActivationOptions = {}): void {\n    for (let i = 0; i < count(); i++) {\n      if (!isItemDisabled(i)) {\n        activateByIndex(i, options);\n        return;\n      }\n    }\n  }\n\n  function last(options: ActivationOptions = {}): void {\n    for (let i = count() - 1; i >= 0; i--) {\n      if (!isItemDisabled(i)) {\n        activateByIndex(i, options);\n        return;\n      }\n    }\n  }\n\n  function next(options: ActivationOptions = {}): void {\n    let index = activeIndex() + 1;\n\n    while (index !== activeIndex()) {\n      if (index >= count()) {\n        if (wrap?.()) {\n          index = 0;\n        } else {\n          return;\n        }\n      }\n\n      if (!isItemDisabled(index)) {\n        activateByIndex(index, options);\n        return;\n      }\n\n      index++;\n    }\n  }\n\n  function previous(options: ActivationOptions = {}): void {\n    let index = activeIndex() - 1;\n\n    while (index !== activeIndex()) {\n      if (index < 0) {\n        if (wrap?.()) {\n          index = count() - 1;\n        } else {\n          return;\n        }\n      }\n\n      if (!isItemDisabled(index)) {\n        activateByIndex(index, options);\n        return;\n      }\n\n      index--;\n    }\n  }\n\n  // any time the item list changes, check if the active index is still valid\n  function validate(): void {\n    const index = activeIndex();\n\n    // if the index is out of bounds, reset it\n    if (index >= count() || index < 0 || isItemDisabled(index)) {\n      // find the first enabled item\n      for (let i = 0; i < count(); i++) {\n        if (!isItemDisabled(i)) {\n          activateByIndex(i);\n          return;\n        }\n      }\n      // if no enabled items, deactivate\n      activateByIndex(-1);\n    }\n  }\n\n  /**\n   * Reset the active descendant group, clearing the active index.\n   */\n  const reset = ({ scroll = false, origin }: ActivationOptions = {}) => {\n    activateByIndex(-1, { scroll, origin });\n  };\n\n  return {\n    id,\n    index: activeIndex,\n    activateByIndex,\n    activateById,\n    first,\n    last,\n    next,\n    previous,\n    reset,\n    validate,\n  } satisfies NgpActiveDescendantManagerState;\n}\n\nexport interface ActivationOptions {\n  /** Whether to scroll the activated item into view. */\n  scroll?: boolean;\n  /** Define the source of activation. */\n  origin?: 'keyboard' | 'pointer';\n}\n","import { ChangeDetectorRef, inject, Signal, signal } from '@angular/core';\nimport { injectElementRef } from 'ng-primitives/internal';\nimport { controlled, createPrimitive, styleBinding } from 'ng-primitives/state';\n\n/**\n * The state interface for the VisuallyHidden pattern.\n */\nexport interface NgpVisuallyHiddenState {\n  /**\n   * Whether the element is hidden.\n   */\n  readonly hidden: Signal<boolean>;\n\n  /**\n   * Set the element visibility.\n   * @param visible\n   */\n  setVisibility(visible: boolean): void;\n}\n\n/**\n * The props interface for the VisuallyHidden pattern.\n */\nexport interface NgpVisuallyHiddenProps {\n  /**\n   * Whether the element is hidden. Default is true.\n   */\n  readonly hidden?: Signal<boolean>;\n}\n\nexport const [\n  NgpVisuallyHiddenStateToken,\n  ngpVisuallyHidden,\n  injectVisuallyHiddenState,\n  provideVisuallyHiddenState,\n] = createPrimitive(\n  'NgpVisuallyHidden',\n  ({ hidden: _hidden = signal(true) }: NgpVisuallyHiddenProps): NgpVisuallyHiddenState => {\n    const element = injectElementRef();\n    const hidden = controlled(_hidden);\n    const changeDetector = inject(ChangeDetectorRef);\n\n    // Apply styles to visually hide the element\n    styleBinding(element, 'position', () => (hidden() ? 'absolute' : null));\n    styleBinding(element, 'width', () => (hidden() ? '1px' : null));\n    styleBinding(element, 'height', () => (hidden() ? '1px' : null));\n    styleBinding(element, 'margin', () => (hidden() ? '-1px' : null));\n    styleBinding(element, 'padding', () => (hidden() ? '0' : null));\n    styleBinding(element, 'overflow', () => (hidden() ? 'hidden' : null));\n    styleBinding(element, 'clip', () => (hidden() ? 'rect(0, 0, 0, 0)' : null));\n    styleBinding(element, 'white-space', () => (hidden() ? 'nowrap' : null));\n    styleBinding(element, 'border', () => (hidden() ? '0' : null));\n    styleBinding(element, 'word-wrap', () => (hidden() ? 'normal' : null));\n    styleBinding(element, 'outline', () => (hidden() ? '0' : null));\n    styleBinding(element, '-webkit-appearance', () => (hidden() ? 'none' : null));\n    styleBinding(element, '-moz-appearance', () => (hidden() ? 'none' : null));\n    styleBinding(element, 'inset-inline-start', () => (hidden() ? '0' : null));\n\n    function setVisibility(visible: boolean): void {\n      hidden.set(!visible);\n      // If a change-detection cycle might be running, schedule detection asynchronously and exit\n      // to avoid re-entrancy. Otherwise fall through to call detectChanges synchronously.\n      Promise.resolve().then(() => changeDetector.detectChanges());\n    }\n\n    return {\n      hidden: hidden.asReadonly(),\n      setVisibility,\n    } satisfies NgpVisuallyHiddenState;\n  },\n);\n","import { Directive } from '@angular/core';\nimport { ngpVisuallyHidden, provideVisuallyHiddenState } from './visually-hidden-state';\n\n/**\n * Hide an element visually while keeping it present in the DOM.\n */\n@Directive({\n  selector: '[ngpVisuallyHidden]',\n  exportAs: 'ngpVisuallyHidden',\n  providers: [provideVisuallyHiddenState()],\n})\nexport class NgpVisuallyHidden {\n  protected readonly state = ngpVisuallyHidden({});\n\n  /**\n   * Set the element visibility.\n   * @param visible\n   */\n  setVisibility(visible: boolean): void {\n    this.state.setVisibility(visible);\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}