@angular/cdk-experimental 20.2.0-next.3 → 20.2.0

package/radio-group.d.d.ts

@@ -1,45 +1,7 @@
 import * as _angular_core from '@angular/core';
 import { SignalLike, KeyboardEventManager, PointerEventManager } from './pointer-event-manager.d.js';
-import { ListItem, List, ListInputs } from './list.d.js';
-
-/**
- * Represents the properties exposed by a radio group that need to be accessed by a radio button.
- * This exists to avoid circular dependency errors between the radio group and radio button.
- */
-interface RadioGroupLike<V> {
-    /** The list behavior for the radio group. */
-    listBehavior: List<RadioButtonPattern<V>, V>;
-}
-/** Represents the required inputs for a radio button in a radio group. */
-interface RadioButtonInputs<V> extends Omit<ListItem<V>, 'searchTerm' | 'index'> {
-    /** A reference to the parent radio group. */
-    group: SignalLike<RadioGroupLike<V> | undefined>;
-}
-/** Represents a radio button within a radio group. */
-declare class RadioButtonPattern<V> {
-    readonly inputs: RadioButtonInputs<V>;
-    /** A unique identifier for the radio button. */
-    id: SignalLike<string>;
-    /** The value associated with the radio button. */
-    value: SignalLike<V>;
-    /** The position of the radio button within the group. */
-    index: _angular_core.Signal<number>;
-    /** Whether the radio button is currently the active one (focused). */
-    active: _angular_core.Signal<boolean>;
-    /** Whether the radio button is selected. */
-    selected: SignalLike<boolean>;
-    /** Whether the radio button is disabled. */
-    disabled: SignalLike<boolean>;
-    /** A reference to the parent radio group. */
-    group: SignalLike<RadioGroupLike<V> | undefined>;
-    /** The tabindex of the radio button. */
-    tabindex: _angular_core.Signal<0 | -1 | undefined>;
-    /** The HTML element associated with the radio button. */
-    element: SignalLike<HTMLElement>;
-    /** The search term for typeahead. */
-    readonly searchTerm: () => string;
-    constructor(inputs: RadioButtonInputs<V>);
-}
+import { ListInputs, List } from './list.d.js';
+import { RadioButtonPattern } from './toolbar.d.js';
 
 /** Represents the required inputs for a radio group. */
 type RadioGroupInputs<V> = Omit<ListInputs<RadioButtonPattern<V>, V>, 'multi' | 'selectionMode' | 'wrap' | 'typeaheadDelay'> & {
@@ -47,21 +9,44 @@ type RadioGroupInputs<V> = Omit<ListInputs<RadioButtonPattern<V>, V>, 'multi' |
     disabled: SignalLike<boolean>;
     /** Whether the radio group is readonly. */
     readonly: SignalLike<boolean>;
+    /** Parent toolbar of radio group */
+    toolbar: SignalLike<ToolbarLike<V> | undefined>;
 };
+/**
+ * Represents the properties exposed by a toolbar widget that need to be accessed by a radio group.
+ * This exists to avoid circular dependency errors between the toolbar and radio button.
+ */
+type ToolbarWidgetLike = {
+    id: SignalLike<string>;
+    index: SignalLike<number>;
+    element: SignalLike<HTMLElement>;
+    disabled: SignalLike<boolean>;
+    searchTerm: SignalLike<any>;
+    value: SignalLike<any>;
+};
+/**
+ * Represents the properties exposed by a toolbar that need to be accessed by a radio group.
+ * This exists to avoid circular dependency errors between the toolbar and radio button.
+ */
+interface ToolbarLike<V> {
+    listBehavior: List<RadioButtonPattern<V> | ToolbarWidgetLike, V>;
+    orientation: SignalLike<'vertical' | 'horizontal'>;
+    disabled: SignalLike<boolean>;
+}
 /** Controls the state of a radio group. */
 declare class RadioGroupPattern<V> {
     readonly inputs: RadioGroupInputs<V>;
     /** The list behavior for the radio group. */
-    readonly listBehavior: List<RadioButtonPattern<V>, V>;
+    readonly listBehavior: List<RadioButtonPattern<V> | ToolbarWidgetLike, V>;
     /** Whether the radio group is vertically or horizontally oriented. */
     orientation: SignalLike<'vertical' | 'horizontal'>;
     /** Whether the radio group is disabled. */
     disabled: _angular_core.Signal<boolean>;
     /** The currently selected radio button. */
-    selectedItem: _angular_core.Signal<RadioButtonPattern<V>>;
+    selectedItem: _angular_core.Signal<ToolbarWidgetLike | RadioButtonPattern<V>>;
     /** Whether the radio group is readonly. */
     readonly: _angular_core.Signal<boolean>;
-    /** The tabindex of the radio group (if using activedescendant). */
+    /** The tabindex of the radio group. */
     tabindex: _angular_core.Signal<0 | -1>;
     /** The id of the current active radio button (if using activedescendant). */
     activedescendant: _angular_core.Signal<string | undefined>;
@@ -91,5 +76,5 @@ declare class RadioGroupPattern<V> {
     private _getItem;
 }
 
-export { RadioButtonPattern, RadioGroupPattern };
-export type { RadioButtonInputs, RadioGroupInputs };
+export { RadioGroupPattern };
+export type { RadioGroupInputs, ToolbarLike };

package/toolbar/index.d.ts

@@ -0,0 +1,89 @@
+import * as _angular_core from '@angular/core';
+import { Signal, OnInit, OnDestroy } from '@angular/core';
+import * as _angular_cdk_bidi from '@angular/cdk/bidi';
+import { RadioButtonPattern, ToolbarWidgetPattern, ToolbarPattern } from '../toolbar.d.js';
+import '../pointer-event-manager.d.js';
+import '../list.d.js';
+
+/** Interface for a radio button that can be used with a toolbar. Based on radio-button in ui-patterns */
+interface CdkRadioButtonInterface<V> {
+    /** The HTML element associated with the radio button. */
+    element: Signal<HTMLElement>;
+    /** Whether the radio button is disabled. */
+    disabled: Signal<boolean>;
+    pattern: RadioButtonPattern<V>;
+}
+/**
+ * A toolbar widget container.
+ *
+ * Widgets such as radio groups or buttons are nested within a toolbar to allow for a single
+ * place of reference for focus and navigation. The CdkToolbar is meant to be used in conjunction
+ * with CdkToolbarWidget and CdkRadioGroup as follows:
+ *
+ * ```html
+ * <div cdkToolbar>
+ *  <button cdkToolbarWidget>Button</button>
+ *  <div cdkRadioGroup>
+ *    <label cdkRadioButton value="1">Option 1</label>
+ *    <label cdkRadioButton value="2">Option 2</label>
+ *    <label cdkRadioButton value="3">Option 3</label>
+ *  </div>
+ * </div>
+ * ```
+ */
+declare class CdkToolbar<V> {
+    /** The CdkTabList nested inside of the container. */
+    private readonly _cdkWidgets;
+    /** A signal wrapper for directionality. */
+    textDirection: _angular_core.WritableSignal<_angular_cdk_bidi.Direction>;
+    /** Sorted UIPatterns of the child widgets */
+    items: Signal<(RadioButtonPattern<V> | ToolbarWidgetPattern)[]>;
+    /** Whether the toolbar is vertically or horizontally oriented. */
+    orientation: _angular_core.InputSignal<"vertical" | "horizontal">;
+    /** Whether disabled items in the group should be skipped when navigating. */
+    skipDisabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Whether the toolbar is disabled. */
+    disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Whether focus should wrap when navigating. */
+    readonly wrap: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** The toolbar UIPattern. */
+    pattern: ToolbarPattern<V>;
+    /** Whether the toolbar has received focus yet. */
+    private _hasFocused;
+    onFocus(): void;
+    constructor();
+    register(widget: CdkRadioButtonInterface<V> | CdkToolbarWidget): void;
+    unregister(widget: CdkRadioButtonInterface<V> | CdkToolbarWidget): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CdkToolbar<any>, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CdkToolbar<any>, "[cdkToolbar]", ["cdkToolbar"], { "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "skipDisabled": { "alias": "skipDisabled"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+/**
+ * A widget within a toolbar.
+ *
+ * A widget is anything that is within a toolbar. It should be applied to any native HTML element
+ * that has the purpose of acting as a widget navigatable within a toolbar.
+ */
+declare class CdkToolbarWidget implements OnInit, OnDestroy {
+    /** A reference to the widget element. */
+    private readonly _elementRef;
+    /** The parent CdkToolbar. */
+    private readonly _cdkToolbar;
+    /** A unique identifier for the widget. */
+    private readonly _generatedId;
+    /** A unique identifier for the widget. */
+    protected id: Signal<string>;
+    /** The parent Toolbar UIPattern. */
+    protected parentToolbar: Signal<ToolbarPattern<any>>;
+    /** A reference to the widget element to be focused on navigation. */
+    element: Signal<any>;
+    /** Whether the widget is disabled. */
+    disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly hardDisabled: Signal<boolean>;
+    pattern: ToolbarWidgetPattern;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CdkToolbarWidget, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CdkToolbarWidget, "[cdkToolbarWidget]", ["cdkToolbarWidget"], { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { CdkToolbar, CdkToolbarWidget };

package/toolbar.d.d.ts

@@ -0,0 +1,136 @@
+import * as _angular_core from '@angular/core';
+import { SignalLike, KeyboardEventManager, PointerEventManager } from './pointer-event-manager.d.js';
+import { ListItem, List, ListInputs } from './list.d.js';
+
+/**
+ * Represents the properties exposed by a toolbar widget that need to be accessed by a radio group.
+ * This exists to avoid circular dependency errors between the toolbar and radio button.
+ */
+type ToolbarWidgetLike = {
+    id: SignalLike<string>;
+    index: SignalLike<number>;
+    element: SignalLike<HTMLElement>;
+    disabled: SignalLike<boolean>;
+    searchTerm: SignalLike<any>;
+    value: SignalLike<any>;
+};
+/**
+ * Represents the properties exposed by a radio group that need to be accessed by a radio button.
+ * This exists to avoid circular dependency errors between the radio group and radio button.
+ */
+interface RadioGroupLike<V> {
+    /** The list behavior for the radio group. */
+    listBehavior: List<RadioButtonPattern<V> | ToolbarWidgetLike, V>;
+    /** Whether the list is readonly */
+    readonly: SignalLike<boolean>;
+    /** Whether the radio group is disabled. */
+    disabled: SignalLike<boolean>;
+}
+/** Represents the required inputs for a radio button in a radio group. */
+interface RadioButtonInputs<V> extends Omit<ListItem<V>, 'searchTerm' | 'index'> {
+    /** A reference to the parent radio group. */
+    group: SignalLike<RadioGroupLike<V> | undefined>;
+}
+/** Represents a radio button within a radio group. */
+declare class RadioButtonPattern<V> {
+    readonly inputs: RadioButtonInputs<V>;
+    /** A unique identifier for the radio button. */
+    id: SignalLike<string>;
+    /** The value associated with the radio button. */
+    value: SignalLike<V>;
+    /** The position of the radio button within the group. */
+    index: SignalLike<number>;
+    /** Whether the radio button is currently the active one (focused). */
+    active: _angular_core.Signal<boolean>;
+    /** Whether the radio button is selected. */
+    selected: SignalLike<boolean>;
+    /** Whether the radio button is disabled. */
+    disabled: SignalLike<boolean>;
+    /** A reference to the parent radio group. */
+    group: SignalLike<RadioGroupLike<V> | undefined>;
+    /** The tabindex of the radio button. */
+    tabindex: _angular_core.Signal<0 | -1 | undefined>;
+    /** The HTML element associated with the radio button. */
+    element: SignalLike<HTMLElement>;
+    /** The search term for typeahead. */
+    readonly searchTerm: () => string;
+    constructor(inputs: RadioButtonInputs<V>);
+}
+
+/** Represents the required inputs for a toolbar. */
+type ToolbarInputs<V> = Omit<ListInputs<ToolbarWidgetPattern | RadioButtonPattern<V>, V>, 'multi' | 'typeaheadDelay' | 'value' | 'selectionMode'>;
+/** Controls the state of a toolbar. */
+declare class ToolbarPattern<V> {
+    readonly inputs: ToolbarInputs<V>;
+    /** The list behavior for the toolbar. */
+    listBehavior: List<ToolbarWidgetPattern | RadioButtonPattern<V>, V>;
+    /** Whether the tablist is vertically or horizontally oriented. */
+    readonly orientation: SignalLike<'vertical' | 'horizontal'>;
+    /** Whether the toolbar is disabled. */
+    disabled: _angular_core.Signal<boolean>;
+    /** The tabindex of the toolbar (if using activedescendant). */
+    tabindex: _angular_core.Signal<0 | -1>;
+    /** The id of the current active widget (if using activedescendant). */
+    activedescendant: _angular_core.Signal<string | undefined>;
+    /** The key used to navigate to the previous widget. */
+    prevKey: _angular_core.Signal<"ArrowUp" | "ArrowRight" | "ArrowLeft">;
+    /** The key used to navigate to the next widget. */
+    nextKey: _angular_core.Signal<"ArrowRight" | "ArrowLeft" | "ArrowDown">;
+    /** The alternate key used to navigate to the previous widget */
+    altPrevKey: _angular_core.Signal<"ArrowUp" | "ArrowRight" | "ArrowLeft">;
+    /** The alternate key used to navigate to the next widget. */
+    altNextKey: _angular_core.Signal<"ArrowRight" | "ArrowLeft" | "ArrowDown">;
+    /** The keydown event manager for the toolbar. */
+    keydown: _angular_core.Signal<KeyboardEventManager<KeyboardEvent>>;
+    selectRadioButton(): void;
+    /** The pointerdown event manager for the toolbar. */
+    pointerdown: _angular_core.Signal<PointerEventManager<PointerEvent>>;
+    /** Navigates to the widget associated with the given pointer event. */
+    goto(event: PointerEvent): void;
+    /** Handles keydown events for the toolbar. */
+    onKeydown(event: KeyboardEvent): void;
+    /** Handles pointerdown events for the toolbar. */
+    onPointerdown(event: PointerEvent): void;
+    /** Finds the Toolbar Widget associated with a pointer event target. */
+    private _getItem;
+    constructor(inputs: ToolbarInputs<V>);
+    /**
+     * Sets the toolbar to its default initial state.
+     *
+     * Sets the active index to the selected widget if one exists and is focusable.
+     * Otherwise, sets the active index to the first focusable widget.
+     */
+    setDefaultState(): void;
+    /** Validates the state of the toolbar and returns a list of accessibility violations. */
+    validate(): string[];
+}
+/** Represents the required inputs for a toolbar widget in a toolbar. */
+interface ToolbarWidgetInputs extends Omit<ListItem<any>, 'searchTerm' | 'value' | 'index'> {
+    /** A reference to the parent toolbar. */
+    parentToolbar: SignalLike<ToolbarPattern<null>>;
+}
+declare class ToolbarWidgetPattern {
+    readonly inputs: ToolbarWidgetInputs;
+    /** A unique identifier for the widget. */
+    id: SignalLike<string>;
+    /** The html element that should receive focus. */
+    readonly element: SignalLike<HTMLElement>;
+    /** Whether the widget is disabled. */
+    disabled: SignalLike<boolean>;
+    /** A reference to the parent toolbar. */
+    parentToolbar: SignalLike<ToolbarPattern<null> | undefined>;
+    /** The tabindex of the widgdet. */
+    tabindex: _angular_core.Signal<0 | -1>;
+    /** The text used by the typeahead search. */
+    readonly searchTerm: () => string;
+    /** The value associated with the widget. */
+    readonly value: () => any;
+    /** The position of the widget within the toolbar. */
+    index: _angular_core.Signal<number>;
+    /** Whether the widget is currently the active one (focused). */
+    active: _angular_core.Signal<boolean>;
+    constructor(inputs: ToolbarWidgetInputs);
+}
+
+export { RadioButtonPattern, ToolbarPattern, ToolbarWidgetPattern };
+export type { RadioButtonInputs, ToolbarInputs, ToolbarWidgetInputs };

package/tree/index.d.ts

@@ -162,8 +162,6 @@ interface HasElement {
 declare class CdkTree<V> {
     /** All CdkTreeItem instances within this tree. */
     private readonly _unorderedItems;
-    /** All CdkGroup instances within this tree. */
-    readonly unorderedGroups: _angular_core.WritableSignal<Set<CdkTreeItemGroup<V>>>;
     /** Orientation of the tree. */
     readonly orientation: _angular_core.InputSignal<"vertical" | "horizontal">;
     /** Whether multi-selection is allowed. */
@@ -194,8 +192,8 @@ declare class CdkTree<V> {
     private _hasFocused;
     constructor();
     onFocus(): void;
-    register(child: CdkTreeItemGroup<V> | CdkTreeItem<V>): void;
-    deregister(child: CdkTreeItemGroup<V> | CdkTreeItem<V>): void;
+    register(child: CdkTreeItem<V>): void;
+    unregister(child: CdkTreeItem<V>): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CdkTree<any>, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CdkTree<any>, "[cdkTree]", ["cdkTree"], { "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "multi": { "alias": "multi"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "focusMode": { "alias": "focusMode"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; "skipDisabled": { "alias": "skipDisabled"; "required": false; "isSignal": true; }; "typeaheadDelay": { "alias": "typeaheadDelay"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "nav": { "alias": "nav"; "required": false; "isSignal": true; }; "currentType": { "alias": "currentType"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
 }
@@ -207,35 +205,33 @@ declare class CdkTreeItem<V> implements OnInit, OnDestroy, HasElement {
     private readonly _elementRef;
     /** A unique identifier for the tree item. */
     private readonly _id;
-    /** The top level CdkTree. */
-    private readonly _tree;
-    /** The parent CdkTreeItem. */
-    private readonly _treeItem;
-    /** The parent CdkGroup, if any. */
-    private readonly _parentGroup;
-    /** The top level TreePattern. */
-    private readonly _treePattern;
-    /** The parent TreeItemPattern. */
-    private readonly _parentPattern;
+    /** The owned tree item group. */
+    private readonly _group;
+    /** The id of the owned group. */
+    readonly ownsId: Signal<string | undefined>;
     /** The host native element. */
     readonly element: Signal<any>;
     /** The value of the tree item. */
     readonly value: _angular_core.InputSignal<V>;
+    /** The parent tree root or tree item group. */
+    readonly parent: _angular_core.InputSignal<CdkTreeItemGroup<V> | CdkTree<V>>;
     /** Whether the tree item is disabled. */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Optional label for typeahead. Defaults to the element's textContent. */
     readonly label: _angular_core.InputSignal<string | undefined>;
     /** Search term for typeahead. */
     readonly searchTerm: Signal<any>;
-    /** Manual group assignment. */
-    readonly group: _angular_core.WritableSignal<CdkTreeItemGroup<V> | undefined>;
+    /** The tree root. */
+    readonly tree: Signal<CdkTree<V>>;
     /** The UI pattern for this item. */
-    readonly pattern: TreeItemPattern<V>;
+    pattern: TreeItemPattern<V>;
     constructor();
     ngOnInit(): void;
     ngOnDestroy(): void;
+    register(group: CdkTreeItemGroup<V>): void;
+    unregister(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CdkTreeItem<any>, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CdkTreeItem<any>, "[cdkTreeItem]", ["cdkTreeItem"], { "value": { "alias": "value"; "required": true; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CdkTreeItem<any>, "[cdkTreeItem]", ["cdkTreeItem"], { "value": { "alias": "value"; "required": true; "isSignal": true; }; "parent": { "alias": "parent"; "required": true; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 /**
  * Container that designates content as a group.
@@ -245,8 +241,6 @@ declare class CdkTreeItemGroup<V> implements OnInit, OnDestroy, HasElement {
     private readonly _elementRef;
     /** The DeferredContentAware host directive. */
     private readonly _deferredContentAware;
-    /** The top level CdkTree. */
-    private readonly _tree;
     /** All groupable items that are descendants of the group. */
     private readonly _unorderedItems;
     /** The host native element. */
@@ -257,15 +251,15 @@ declare class CdkTreeItemGroup<V> implements OnInit, OnDestroy, HasElement {
     readonly visible: _angular_core.WritableSignal<boolean>;
     /** Child items within this group. */
     readonly children: Signal<CdkTreeItem<V>[]>;
-    /** Identifier for matching the group owner. */
-    readonly value: _angular_core.InputSignal<V>;
+    /** Tree item that owns the group. */
+    readonly ownedBy: _angular_core.InputSignal<CdkTreeItem<V>>;
     constructor();
     ngOnInit(): void;
     ngOnDestroy(): void;
     register(child: CdkTreeItem<V>): void;
-    deregister(child: CdkTreeItem<V>): void;
+    unregister(child: CdkTreeItem<V>): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CdkTreeItemGroup<any>, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CdkTreeItemGroup<any>, "[cdkTreeItemGroup]", ["cdkTreeItemGroup"], { "value": { "alias": "value"; "required": true; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof i1.DeferredContentAware; inputs: { "preserveContent": "preserveContent"; }; outputs: {}; }]>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CdkTreeItemGroup<any>, "[cdkTreeItemGroup]", ["cdkTreeItemGroup"], { "ownedBy": { "alias": "ownedBy"; "required": true; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof i1.DeferredContentAware; inputs: { "preserveContent": "preserveContent"; }; outputs: {}; }]>;
 }
 /**
  * A structural directive that marks the `ng-template` to be used as the content

package/ui-patterns/index.d.ts

@@ -1,5 +1,6 @@
 export { ListboxInputs, ListboxPattern, OptionInputs, OptionPattern } from '../listbox.d.js';
-export { RadioButtonInputs, RadioButtonPattern, RadioGroupInputs, RadioGroupPattern } from '../radio-group.d.js';
+export { RadioGroupInputs, RadioGroupPattern, ToolbarLike } from '../radio-group.d.js';
+export { RadioButtonInputs, RadioButtonPattern, ToolbarInputs, ToolbarPattern, ToolbarWidgetInputs, ToolbarWidgetPattern } from '../toolbar.d.js';
 export { SignalLike, WritableSignalLike, convertGetterSetterToWritableSignalLike } from '../pointer-event-manager.d.js';
 export { TabInputs, TabListInputs, TabListPattern, TabPanelInputs, TabPanelPattern, TabPattern } from '../tabs.d.js';
 export { AccordionGroupInputs, AccordionGroupPattern, AccordionPanelInputs, AccordionPanelPattern, AccordionTriggerInputs, AccordionTriggerPattern } from '../accordion.d.js';

package/fesm2022/radio-button.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"radio-button.mjs","sources":["../../../../../darwin_arm64-fastbuild-ST-46c76129e412/bin/src/cdk-experimental/ui-patterns/radio-group/radio-group.ts","../../../../../darwin_arm64-fastbuild-ST-46c76129e412/bin/src/cdk-experimental/ui-patterns/radio-group/radio-button.ts"],"sourcesContent":["/**\n * @license\n * Copyright Google LLC All Rights Reserved.\n *\n * Use of this source code is governed by an MIT-style license that can be\n * found in the LICENSE file at https://angular.dev/license\n */\n\nimport {computed} from '@angular/core';\nimport {KeyboardEventManager, PointerEventManager} from '../behaviors/event-manager';\nimport {List, ListInputs} from '../behaviors/list/list';\nimport {SignalLike} from '../behaviors/signal-like/signal-like';\nimport {RadioButtonPattern} from './radio-button';\n\n/** Represents the required inputs for a radio group. */\nexport type RadioGroupInputs<V> = Omit<\n  ListInputs<RadioButtonPattern<V>, V>,\n  'multi' | 'selectionMode' | 'wrap' | 'typeaheadDelay'\n> & {\n  /** Whether the radio group is disabled. */\n  disabled: SignalLike<boolean>;\n\n  /** Whether the radio group is readonly. */\n  readonly: SignalLike<boolean>;\n};\n\n/** Controls the state of a radio group. */\nexport class RadioGroupPattern<V> {\n  /** The list behavior for the radio group. */\n  readonly listBehavior: List<RadioButtonPattern<V>, V>;\n\n  /** Whether the radio group is vertically or horizontally oriented. */\n  orientation: SignalLike<'vertical' | 'horizontal'>;\n\n  /** Whether the radio group is disabled. */\n  disabled = computed(() => this.inputs.disabled() || this.listBehavior.disabled());\n\n  /** The currently selected radio button. */\n  selectedItem = computed(() => this.listBehavior.selectionBehavior.selectedItems()[0]);\n\n  /** Whether the radio group is readonly. */\n  readonly = computed(() => this.selectedItem()?.disabled() || this.inputs.readonly());\n\n  /** The tabindex of the radio group (if using activedescendant). */\n  tabindex = computed(() => this.listBehavior.tabindex());\n\n  /** The id of the current active radio button (if using activedescendant). */\n  activedescendant = computed(() => this.listBehavior.activedescendant());\n\n  /** The key used to navigate to the previous radio button. */\n  prevKey = computed(() => {\n    if (this.inputs.orientation() === 'vertical') {\n      return 'ArrowUp';\n    }\n    return this.inputs.textDirection() === 'rtl' ? 'ArrowRight' : 'ArrowLeft';\n  });\n\n  /** The key used to navigate to the next radio button. */\n  nextKey = computed(() => {\n    if (this.inputs.orientation() === 'vertical') {\n      return 'ArrowDown';\n    }\n    return this.inputs.textDirection() === 'rtl' ? 'ArrowLeft' : 'ArrowRight';\n  });\n\n  /** The keydown event manager for the radio group. */\n  keydown = computed(() => {\n    const manager = new KeyboardEventManager();\n\n    // Readonly mode allows navigation but not selection changes.\n    if (this.readonly()) {\n      return manager\n        .on(this.prevKey, () => this.listBehavior.prev())\n        .on(this.nextKey, () => this.listBehavior.next())\n        .on('Home', () => this.listBehavior.first())\n        .on('End', () => this.listBehavior.last());\n    }\n\n    // Default behavior: navigate and select on arrow keys, home, end.\n    // Space/Enter also select the focused item.\n    return manager\n      .on(this.prevKey, () => this.listBehavior.prev({selectOne: true}))\n      .on(this.nextKey, () => this.listBehavior.next({selectOne: true}))\n      .on('Home', () => this.listBehavior.first({selectOne: true}))\n      .on('End', () => this.listBehavior.last({selectOne: true}))\n      .on(' ', () => this.listBehavior.selectOne())\n      .on('Enter', () => this.listBehavior.selectOne());\n  });\n\n  /** The pointerdown event manager for the radio group. */\n  pointerdown = computed(() => {\n    const manager = new PointerEventManager();\n\n    if (this.readonly()) {\n      // Navigate focus only in readonly mode.\n      return manager.on(e => this.listBehavior.goto(this._getItem(e)!));\n    }\n\n    // Default behavior: navigate and select on click.\n    return manager.on(e => this.listBehavior.goto(this._getItem(e)!, {selectOne: true}));\n  });\n\n  constructor(readonly inputs: RadioGroupInputs<V>) {\n    this.orientation = inputs.orientation;\n\n    this.listBehavior = new List({\n      ...inputs,\n      wrap: () => false,\n      multi: () => false,\n      selectionMode: () => 'follow',\n      typeaheadDelay: () => 0, // Radio groups do not support typeahead.\n    });\n  }\n\n  /** Handles keydown events for the radio group. */\n  onKeydown(event: KeyboardEvent) {\n    if (!this.disabled()) {\n      this.keydown().handle(event);\n    }\n  }\n\n  /** Handles pointerdown events for the radio group. */\n  onPointerdown(event: PointerEvent) {\n    if (!this.disabled()) {\n      this.pointerdown().handle(event);\n    }\n  }\n\n  /**\n   * Sets the radio group to its default initial state.\n   *\n   * Sets the active index to the selected radio button if one exists and is focusable.\n   * Otherwise, sets the active index to the first focusable radio button.\n   */\n  setDefaultState() {\n    let firstItem: RadioButtonPattern<V> | null = null;\n\n    for (const item of this.inputs.items()) {\n      if (this.listBehavior.isFocusable(item)) {\n        if (!firstItem) {\n          firstItem = item;\n        }\n        if (item.selected()) {\n          this.inputs.activeItem.set(item);\n          return;\n        }\n      }\n    }\n\n    if (firstItem) {\n      this.inputs.activeItem.set(firstItem);\n    }\n  }\n\n  /** Validates the state of the radio group and returns a list of accessibility violations. */\n  validate(): string[] {\n    const violations: string[] = [];\n\n    if (this.selectedItem()?.disabled() && this.inputs.skipDisabled()) {\n      violations.push(\n        \"Accessibility Violation: The selected radio button is disabled while 'skipDisabled' is true, making the selection unreachable via keyboard.\",\n      );\n    }\n\n    return violations;\n  }\n\n  /** Finds the RadioButtonPattern associated with a pointer event target. */\n  private _getItem(e: PointerEvent): RadioButtonPattern<V> | undefined {\n    if (!(e.target instanceof HTMLElement)) {\n      return undefined;\n    }\n\n    // Assumes the target or its ancestor has role=\"radio\"\n    const element = e.target.closest('[role=\"radio\"]');\n    return this.inputs.items().find(i => i.element() === element);\n  }\n}\n","/**\n * @license\n * Copyright Google LLC All Rights Reserved.\n *\n * Use of this source code is governed by an MIT-style license that can be\n * found in the LICENSE file at https://angular.dev/license\n */\n\nimport {computed} from '@angular/core';\nimport {SignalLike} from '../behaviors/signal-like/signal-like';\nimport {List, ListItem} from '../behaviors/list/list';\n\n/**\n * Represents the properties exposed by a radio group that need to be accessed by a radio button.\n * This exists to avoid circular dependency errors between the radio group and radio button.\n */\ninterface RadioGroupLike<V> {\n  /** The list behavior for the radio group. */\n  listBehavior: List<RadioButtonPattern<V>, V>;\n}\n\n/** Represents the required inputs for a radio button in a radio group. */\nexport interface RadioButtonInputs<V> extends Omit<ListItem<V>, 'searchTerm' | 'index'> {\n  /** A reference to the parent radio group. */\n  group: SignalLike<RadioGroupLike<V> | undefined>;\n}\n\n/** Represents a radio button within a radio group. */\nexport class RadioButtonPattern<V> {\n  /** A unique identifier for the radio button. */\n  id: SignalLike<string>;\n\n  /** The value associated with the radio button. */\n  value: SignalLike<V>;\n\n  /** The position of the radio button within the group. */\n  index = computed(() => this.group()?.listBehavior.inputs.items().indexOf(this) ?? -1);\n\n  /** Whether the radio button is currently the active one (focused). */\n  active = computed(() => this.group()?.listBehavior.inputs.activeItem() === this);\n\n  /** Whether the radio button is selected. */\n  selected: SignalLike<boolean> = computed(\n    () => !!this.group()?.listBehavior.inputs.value().includes(this.value()),\n  );\n\n  /** Whether the radio button is disabled. */\n  disabled: SignalLike<boolean>;\n\n  /** A reference to the parent radio group. */\n  group: SignalLike<RadioGroupLike<V> | undefined>;\n\n  /** The tabindex of the radio button. */\n  tabindex = computed(() => this.group()?.listBehavior.getItemTabindex(this));\n\n  /** The HTML element associated with the radio button. */\n  element: SignalLike<HTMLElement>;\n\n  /** The search term for typeahead. */\n  readonly searchTerm = () => ''; // Radio groups do not support typeahead.\n\n  constructor(readonly inputs: RadioButtonInputs<V>) {\n    this.id = inputs.id;\n    this.value = inputs.value;\n    this.group = inputs.group;\n    this.element = inputs.element;\n    this.disabled = inputs.disabled;\n  }\n}\n"],"names":[],"mappings":"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"}