@radix-ng/primitives 1.0.1 → 1.0.2

package/types/radix-ng-primitives-checkbox.d.ts

@@ -1,17 +1,17 @@
+import * as _radix_ng_primitives_types_radix_ng_primitives_core from '@radix-ng/primitives/types/radix-ng-primitives-core';
 import * as _angular_core from '@angular/core';
 import { Signal } from '@angular/core';
-import * as i1 from '@radix-ng/primitives/presence';
-import * as _radix_ng_primitives_types_radix_ng_primitives_core from '@radix-ng/primitives/types/radix-ng-primitives-core';
 import * as _radix_ng_primitives_core from '@radix-ng/primitives/core';
 import { BooleanInput, RdxCancelableChangeEventDetails, RdxFormCheckboxControl } from '@radix-ng/primitives/core';
 import { ControlValueAccessor } from '@angular/forms';
 
-declare class RdxCheckboxIndicatorPresenceDirective {
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxCheckboxIndicatorPresenceDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxCheckboxIndicatorPresenceDirective, "ng-template[rdxCheckboxIndicatorPresence]", never, {}, {}, never, never, true, [{ directive: typeof i1.RdxPresenceDirective; inputs: {}; outputs: {}; }]>;
-}
-
-declare class RdxCheckboxInputDirective {
+/**
+ * Directive: rdxCheckboxButton
+ * Purpose: Turns a native <button> into an accessible checkbox control bound to the Radix Checkbox context.
+ * It mirrors the checkbox state via ARIA/data attributes, toggles on click, and prevents Enter activation per WAI-ARIA.
+ * In forms, it stops the button's click from bubbling so only the hidden input emits the native event used for form/validator integration.
+ */
+declare class RdxCheckboxButtonDirective {
     protected readonly rootContext: {
         checked: _angular_core.Signal<boolean>;
         indeterminate: _angular_core.Signal<boolean>;
@@ -21,26 +21,31 @@ declare class RdxCheckboxInputDirective {
         name: _angular_core.InputSignal<string | undefined>;
         parent: _angular_core.InputSignalWithTransform<boolean, _radix_ng_primitives_types_radix_ng_primitives_core.BooleanInput>;
         form: _angular_core.InputSignal<string | undefined>;
-        readonly: _angular_core.InputSignalWithTransform<boolean, _radix_ng_primitives_types_radix_ng_primitives_core.BooleanInput>;
+        readonly: _angular_core.Signal<boolean>;
         state: _angular_core.Signal<"indeterminate" | "checked" | "unchecked">;
+        uncheckedValue: _angular_core.InputSignal<string | undefined>;
         toggle(event?: Event): void;
     };
-    private readonly input;
+    private readonly group;
+    private readonly elementRef;
+    /** A `parent` checkbox lists the ids of the children it controls. */
+    protected readonly ariaControls: _angular_core.Signal<string | undefined>;
     constructor();
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxCheckboxInputDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxCheckboxInputDirective, "input[rdxCheckboxInput]", never, {}, {}, never, never, true, never>;
+    protected clicked(event: MouseEvent): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxCheckboxButtonDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxCheckboxButtonDirective, "button[rdxCheckboxButton]", never, {}, {}, never, never, true, never>;
 }
 
 /**
  * Internal tri-state used only for the derived `parent` (select-all) state in
- * `rdxCheckboxGroup` and the `data-state` string. The public `checked` member is
+ * `rdxCheckboxGroup` and compatibility helpers. The public `checked` member is
  * a plain `boolean`; mixed state is exposed via the separate `indeterminate`
  * member (Base UI shape).
  */
 type CheckedState = boolean | 'indeterminate';
 declare function isIndeterminate(checked?: CheckedState): checked is 'indeterminate';
 declare function getState(checked: CheckedState): "indeterminate" | "checked" | "unchecked";
-type RdxCheckboxCheckedChangeReason = 'trigger-press' | 'none';
+type RdxCheckboxCheckedChangeReason = 'none';
 type RdxCheckboxCheckedChangeEventDetails = RdxCancelableChangeEventDetails<RdxCheckboxCheckedChangeReason>;
 interface RdxCheckboxCheckedChangeEvent {
     checked: boolean;
@@ -55,8 +60,9 @@ declare const rootContext: () => {
     name: _angular_core.InputSignal<string | undefined>;
     parent: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
     form: _angular_core.InputSignal<string | undefined>;
-    readonly: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
+    readonly: _angular_core.Signal<boolean>;
     state: _angular_core.Signal<"indeterminate" | "checked" | "unchecked">;
+    uncheckedValue: _angular_core.InputSignal<string | undefined>;
     toggle(event?: Event): void;
 };
 type CheckboxRootContext = ReturnType<typeof rootContext>;
@@ -69,8 +75,9 @@ declare const injectCheckboxRootContext: _radix_ng_primitives_core.InjectContext
     name: _angular_core.InputSignal<string | undefined>;
     parent: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
     form: _angular_core.InputSignal<string | undefined>;
-    readonly: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
+    readonly: _angular_core.Signal<boolean>;
     state: _angular_core.Signal<"indeterminate" | "checked" | "unchecked">;
+    uncheckedValue: _angular_core.InputSignal<string | undefined>;
     toggle(event?: Event): void;
 }>;
 declare const provideCheckboxRootContext: (useFactory: () => {
@@ -82,8 +89,9 @@ declare const provideCheckboxRootContext: (useFactory: () => {
     name: _angular_core.InputSignal<string | undefined>;
     parent: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
     form: _angular_core.InputSignal<string | undefined>;
-    readonly: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
+    readonly: _angular_core.Signal<boolean>;
     state: _angular_core.Signal<"indeterminate" | "checked" | "unchecked">;
+    uncheckedValue: _angular_core.InputSignal<string | undefined>;
     toggle(event?: Event): void;
 }) => _angular_core.Provider;
 /**
@@ -91,6 +99,9 @@ declare const provideCheckboxRootContext: (useFactory: () => {
  */
 declare class RdxCheckboxRootDirective implements RdxFormCheckboxControl {
     private readonly controlValueAccessor;
+    private readonly elementRef;
+    private readonly renderer;
+    private uncheckedInputElement;
     /** The group this checkbox belongs to, if it is rendered inside a `rdxCheckboxGroup`. */
     private readonly group;
     /**
@@ -108,6 +119,13 @@ declare class RdxCheckboxRootDirective implements RdxFormCheckboxControl {
      * @group Props
      */
     readonly checked: _angular_core.ModelSignal<boolean>;
+    /**
+     * The state of the checkbox when it is initially rendered.
+     *
+     * @default false
+     * @group Props
+     */
+    readonly defaultChecked: _angular_core.InputSignalWithTransform<boolean | undefined, BooleanInput>;
     /**
      * Whether the checkbox is in a mixed state: neither ticked nor unticked.
      * Orthogonal to `checked` and not part of the submitted form value. A user
@@ -126,6 +144,13 @@ declare class RdxCheckboxRootDirective implements RdxFormCheckboxControl {
      * @group Props
      */
     readonly submitValue: _angular_core.InputSignal<string>;
+    /**
+     * The value submitted with the form when the checkbox is unchecked.
+     * By default, unchecked checkboxes do not submit any value, matching native checkbox behavior.
+     *
+     * @group Props
+     */
+    readonly uncheckedValue: _angular_core.InputSignal<string | undefined>;
     /**
      * Whether or not the checkbox button is disabled. This prevents the user from interacting with it.
      * @group Props
@@ -136,6 +161,8 @@ declare class RdxCheckboxRootDirective implements RdxFormCheckboxControl {
      * @group Props
      */
     readonly readonly: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
+    /** Alias matching Base UI's `readOnly` prop spelling. */
+    readonly readOnly: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
     /**
      * Whether or not the checkbox is required.
      * @group Props
@@ -178,62 +205,20 @@ declare class RdxCheckboxRootDirective implements RdxFormCheckboxControl {
     readonly indeterminateState: _angular_core.Signal<boolean>;
     /** @ignore The effective disabled state, including the group. */
     readonly disabledState: _angular_core.Signal<boolean>;
+    readonly readOnlyState: _angular_core.Signal<boolean>;
     readonly state: _angular_core.Signal<"indeterminate" | "checked" | "unchecked">;
     constructor();
     toggle(event?: Event): void;
+    private syncUncheckedInput;
+    private ensureUncheckedInput;
+    private removeUncheckedInput;
+    private setOptionalAttribute;
+    private setBooleanAttribute;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxCheckboxRootDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxCheckboxRootDirective, "[rdxCheckboxRoot]", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "submitValue": { "alias": "value"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "parent": { "alias": "parent"; "required": false; "isSignal": true; }; "form": { "alias": "form"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; "indeterminate": "indeterminateChange"; "onCheckedChange": "onCheckedChange"; }, never, never, true, [{ directive: typeof _radix_ng_primitives_core.RdxControlValueAccessor; inputs: { "value": "checked"; "disabled": "disabled"; }; outputs: {}; }]>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxCheckboxRootDirective, "[rdxCheckboxRoot]", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "defaultChecked": { "alias": "defaultChecked"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "submitValue": { "alias": "value"; "required": false; "isSignal": true; }; "uncheckedValue": { "alias": "uncheckedValue"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "parent": { "alias": "parent"; "required": false; "isSignal": true; }; "form": { "alias": "form"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; "indeterminate": "indeterminateChange"; "onCheckedChange": "onCheckedChange"; }, never, never, true, [{ directive: typeof _radix_ng_primitives_core.RdxControlValueAccessor; inputs: { "value": "checked"; "disabled": "disabled"; }; outputs: {}; }]>;
 }
 
-/**
- * Directive: rdxCheckboxButton
- * Purpose: Turns a native <button> into an accessible checkbox control bound to the Radix Checkbox context.
- * It mirrors the checkbox state via ARIA/data attributes, toggles on click, and prevents Enter activation per WAI-ARIA.
- * In forms, it stops the button's click from bubbling so only the hidden input emits the native event used for form/validator integration.
- */
-declare class RdxCheckboxButtonDirective {
-    protected readonly rootContext: {
-        checked: _angular_core.Signal<boolean>;
-        indeterminate: _angular_core.Signal<boolean>;
-        disabled: _angular_core.Signal<boolean>;
-        required: _angular_core.InputSignalWithTransform<boolean, _radix_ng_primitives_types_radix_ng_primitives_core.BooleanInput>;
-        value: _angular_core.InputSignal<string>;
-        name: _angular_core.InputSignal<string | undefined>;
-        parent: _angular_core.InputSignalWithTransform<boolean, _radix_ng_primitives_types_radix_ng_primitives_core.BooleanInput>;
-        form: _angular_core.InputSignal<string | undefined>;
-        readonly: _angular_core.InputSignalWithTransform<boolean, _radix_ng_primitives_types_radix_ng_primitives_core.BooleanInput>;
-        state: _angular_core.Signal<"indeterminate" | "checked" | "unchecked">;
-        toggle(event?: Event): void;
-    };
-    private readonly group;
-    private readonly elementRef;
-    /** A `parent` checkbox lists the ids of the children it controls. */
-    protected readonly ariaControls: _angular_core.Signal<string | undefined>;
-    constructor();
-    protected clicked(event: MouseEvent): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxCheckboxButtonDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxCheckboxButtonDirective, "button[rdxCheckboxButton]", never, {}, {}, never, never, true, never>;
-}
-
-declare class RdxCheckboxIndicatorDirective {
-    protected readonly rootContext: {
-        checked: _angular_core.Signal<boolean>;
-        indeterminate: _angular_core.Signal<boolean>;
-        disabled: _angular_core.Signal<boolean>;
-        required: _angular_core.InputSignalWithTransform<boolean, _radix_ng_primitives_types_radix_ng_primitives_core.BooleanInput>;
-        value: _angular_core.InputSignal<string>;
-        name: _angular_core.InputSignal<string | undefined>;
-        parent: _angular_core.InputSignalWithTransform<boolean, _radix_ng_primitives_types_radix_ng_primitives_core.BooleanInput>;
-        form: _angular_core.InputSignal<string | undefined>;
-        readonly: _angular_core.InputSignalWithTransform<boolean, _radix_ng_primitives_types_radix_ng_primitives_core.BooleanInput>;
-        state: _angular_core.Signal<"indeterminate" | "checked" | "unchecked">;
-        toggle(event?: Event): void;
-    };
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxCheckboxIndicatorDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxCheckboxIndicatorDirective, "[rdxCheckboxIndicator]", never, {}, {}, never, never, true, never>;
-}
-
-type RdxCheckboxGroupValueChangeReason = 'child-press' | 'parent-press' | 'none';
+type RdxCheckboxGroupValueChangeReason = 'none';
 type RdxCheckboxGroupValueChangeEventDetails = RdxCancelableChangeEventDetails<RdxCheckboxGroupValueChangeReason>;
 interface RdxCheckboxGroupValueChangeEvent {
     value: string[];
@@ -338,12 +323,55 @@ declare class RdxCheckboxGroupDirective implements ControlValueAccessor {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxCheckboxGroupDirective, "[rdxCheckboxGroup]", ["rdxCheckboxGroup"], { "value": { "alias": "value"; "required": false; "isSignal": true; }; "defaultValue": { "alias": "defaultValue"; "required": false; "isSignal": true; }; "allValues": { "alias": "allValues"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "onValueChange": "onValueChange"; }, never, never, true, never>;
 }
 
-declare const checkboxImports: (typeof RdxCheckboxIndicatorPresenceDirective)[];
+declare class RdxCheckboxIndicatorDirective {
+    protected readonly rootContext: {
+        checked: _angular_core.Signal<boolean>;
+        indeterminate: _angular_core.Signal<boolean>;
+        disabled: _angular_core.Signal<boolean>;
+        required: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
+        value: _angular_core.InputSignal<string>;
+        name: _angular_core.InputSignal<string | undefined>;
+        parent: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
+        form: _angular_core.InputSignal<string | undefined>;
+        readonly: _angular_core.Signal<boolean>;
+        state: _angular_core.Signal<"indeterminate" | "checked" | "unchecked">;
+        uncheckedValue: _angular_core.InputSignal<string | undefined>;
+        toggle(event?: Event): void;
+    };
+    /** Keep the indicator in the DOM when unchecked so CSS exit animations can play. */
+    readonly keepMounted: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
+    protected readonly isVisible: _angular_core.Signal<boolean>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxCheckboxIndicatorDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxCheckboxIndicatorDirective, "[rdxCheckboxIndicator]", never, { "keepMounted": { "alias": "keepMounted"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+declare class RdxCheckboxInputDirective {
+    protected readonly rootContext: {
+        checked: _angular_core.Signal<boolean>;
+        indeterminate: _angular_core.Signal<boolean>;
+        disabled: _angular_core.Signal<boolean>;
+        required: _angular_core.InputSignalWithTransform<boolean, _radix_ng_primitives_types_radix_ng_primitives_core.BooleanInput>;
+        value: _angular_core.InputSignal<string>;
+        name: _angular_core.InputSignal<string | undefined>;
+        parent: _angular_core.InputSignalWithTransform<boolean, _radix_ng_primitives_types_radix_ng_primitives_core.BooleanInput>;
+        form: _angular_core.InputSignal<string | undefined>;
+        readonly: _angular_core.Signal<boolean>;
+        state: _angular_core.Signal<"indeterminate" | "checked" | "unchecked">;
+        uncheckedValue: _angular_core.InputSignal<string | undefined>;
+        toggle(event?: Event): void;
+    };
+    private readonly input;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxCheckboxInputDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxCheckboxInputDirective, "input[rdxCheckboxInput]", never, {}, {}, never, never, true, never>;
+}
+
+declare const checkboxImports: (typeof RdxCheckboxRootDirective | typeof RdxCheckboxGroupDirective | typeof RdxCheckboxButtonDirective | typeof RdxCheckboxIndicatorDirective | typeof RdxCheckboxInputDirective)[];
 declare class RdxCheckboxModule {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxCheckboxModule, never>;
-    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<RdxCheckboxModule, never, [typeof RdxCheckboxInputDirective, typeof RdxCheckboxRootDirective, typeof RdxCheckboxButtonDirective, typeof RdxCheckboxIndicatorDirective, typeof RdxCheckboxIndicatorPresenceDirective, typeof RdxCheckboxGroupDirective], [typeof RdxCheckboxInputDirective, typeof RdxCheckboxRootDirective, typeof RdxCheckboxButtonDirective, typeof RdxCheckboxIndicatorDirective, typeof RdxCheckboxIndicatorPresenceDirective, typeof RdxCheckboxGroupDirective]>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<RdxCheckboxModule, never, [typeof RdxCheckboxInputDirective, typeof RdxCheckboxRootDirective, typeof RdxCheckboxButtonDirective, typeof RdxCheckboxIndicatorDirective, typeof RdxCheckboxGroupDirective], [typeof RdxCheckboxInputDirective, typeof RdxCheckboxRootDirective, typeof RdxCheckboxButtonDirective, typeof RdxCheckboxIndicatorDirective, typeof RdxCheckboxGroupDirective]>;
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<RdxCheckboxModule>;
 }
 
-export { RdxCheckboxButtonDirective, RdxCheckboxGroupDirective, RdxCheckboxIndicatorDirective, RdxCheckboxIndicatorPresenceDirective, RdxCheckboxInputDirective, RdxCheckboxModule, RdxCheckboxRootDirective, checkboxImports, getState, injectCheckboxGroupContext, injectCheckboxRootContext, isIndeterminate, provideCheckboxGroupContext, provideCheckboxRootContext };
+export { RdxCheckboxButtonDirective, RdxCheckboxGroupDirective, RdxCheckboxIndicatorDirective, RdxCheckboxInputDirective, RdxCheckboxModule, RdxCheckboxRootDirective, checkboxImports, getState, injectCheckboxGroupContext, injectCheckboxRootContext, isIndeterminate, provideCheckboxGroupContext, provideCheckboxRootContext };
 export type { CheckboxRootContext, CheckedState, RdxCheckboxCheckedChangeEvent, RdxCheckboxCheckedChangeEventDetails, RdxCheckboxCheckedChangeReason, RdxCheckboxGroupContext, RdxCheckboxGroupValueChangeEvent, RdxCheckboxGroupValueChangeEventDetails, RdxCheckboxGroupValueChangeReason };

package/types/radix-ng-primitives-composite.d.ts

@@ -2,6 +2,7 @@ import * as _angular_core from '@angular/core';
 import { Signal, ElementRef } from '@angular/core';
 import * as _radix_ng_primitives_core from '@radix-ng/primitives/core';
 import { Direction, BooleanInput } from '@radix-ng/primitives/core';
+import * as _radix_ng_primitives_composite from '@radix-ng/primitives/composite';
 
 type RdxCompositeOrientation = 'horizontal' | 'vertical' | 'both';
 type RdxCompositeModifierKey = 'Shift' | 'Control' | 'Alt' | 'Meta';
@@ -13,39 +14,82 @@ interface RdxCompositeItemRegistration<Metadata extends RdxCompositeItemMetadata
 type RdxCompositeMetadata<Metadata extends RdxCompositeItemMetadata = RdxCompositeItemMetadata> = {
     index: number;
 } & Metadata;
+interface RdxCompositeListContext {
+    listElement: HTMLElement;
+    items: Signal<RdxCompositeItemRegistration[]>;
+    itemMap: Signal<Map<HTMLElement, RdxCompositeMetadata>>;
+    registerItem: <Metadata extends RdxCompositeItemMetadata>(item: RdxCompositeItemRegistration<Metadata>) => () => void;
+    indexOf: (element: HTMLElement) => number;
+}
 interface RdxCompositeRootContext {
     rootElement: HTMLElement;
     highlightedIndex: Signal<number>;
     highlightItemOnHover: Signal<boolean>;
     orientation: Signal<RdxCompositeOrientation>;
     dir: Signal<Direction>;
-    registerItem: <Metadata extends RdxCompositeItemMetadata>(item: RdxCompositeItemRegistration<Metadata>) => () => void;
-    indexOf: (element: HTMLElement) => number;
     isIndexDisabled: (index: number) => boolean;
     setHighlightedIndex: (index: number, shouldScrollIntoView?: boolean) => void;
     relayKeyboardEvent: (event: KeyboardEvent) => void;
 }
 
+/**
+ * Registers the host with the nearest composite list without changing focus behavior.
+ */
+declare class RdxCompositeListItem {
+    private readonly listContext;
+    private readonly elementRef;
+    private readonly hasRendered;
+    /** Arbitrary metadata included in the list's ordered item map. */
+    readonly metadataInput: _angular_core.InputSignal<RdxCompositeItemMetadata | null | undefined>;
+    private readonly _metadata;
+    readonly index: _angular_core.Signal<number>;
+    readonly inListElement: _angular_core.Signal<boolean>;
+    constructor();
+    setMetadata(value: RdxCompositeItemMetadata | null | undefined): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxCompositeListItem, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxCompositeListItem, "[rdxCompositeListItem]", ["rdxCompositeListItem"], { "metadataInput": { "alias": "metadata"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 /**
  * Internal Base UI-style composite item. Registers itself with the nearest composite root and
  * receives the roving `tabindex` from the root's highlighted index.
  */
 declare class RdxCompositeItem {
     private readonly rootContext;
+    private readonly listItem;
     private readonly elementRef;
-    /** Arbitrary metadata included in the root's ordered item map. */
-    readonly metadataInput: _angular_core.InputSignal<RdxCompositeItemMetadata | null | undefined>;
-    private readonly _metadata;
     readonly index: _angular_core.Signal<number>;
     private readonly inRootElement;
     protected readonly highlighted: _angular_core.Signal<boolean>;
     protected readonly tabIndex: _angular_core.Signal<-1 | 0 | null>;
-    constructor();
     setMetadata(value: RdxCompositeItemMetadata | null | undefined): void;
     protected handleFocus(): void;
     protected handleMouseMove(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxCompositeItem, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxCompositeItem, "[rdxCompositeItem]", ["rdxCompositeItem"], { "metadataInput": { "alias": "metadata"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxCompositeItem, "[rdxCompositeItem]", ["rdxCompositeItem"], {}, {}, never, never, true, [{ directive: typeof RdxCompositeListItem; inputs: { "metadata": "metadata"; }; outputs: {}; }]>;
+}
+
+declare const injectRdxCompositeListContext: _radix_ng_primitives_core.InjectContext<RdxCompositeListContext>;
+declare const provideRdxCompositeListContext: (useFactory: () => RdxCompositeListContext) => _angular_core.Provider;
+/**
+ * Base UI-style composite list. Owns item registration and DOM-order metadata without applying
+ * roving tabindex or keyboard navigation.
+ */
+declare class RdxCompositeList {
+    readonly elementRef: ElementRef<HTMLElement>;
+    private readonly registeredItems;
+    /** Emits when the ordered item map changes. */
+    readonly onMapChange: _angular_core.OutputEmitterRef<Map<HTMLElement, RdxCompositeMetadata>>;
+    /** Items registered with this list, sorted in DOM order. */
+    readonly items: _angular_core.Signal<RdxCompositeItemRegistration<RdxCompositeItemMetadata>[]>;
+    /** Ordered metadata keyed by item element. */
+    readonly itemMap: _angular_core.Signal<Map<HTMLElement, RdxCompositeMetadata>>;
+    constructor();
+    registerItem<Metadata extends RdxCompositeItemMetadata>(item: RdxCompositeItemRegistration<Metadata>): () => void;
+    indexOf(element: HTMLElement): number;
+    elements(): HTMLElement[];
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxCompositeList, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxCompositeList, "[rdxCompositeList]", ["rdxCompositeList"], {}, { "onMapChange": "onMapChange"; }, never, never, true, never>;
 }
 
 declare const injectRdxCompositeRootContext: _radix_ng_primitives_core.InjectContext<RdxCompositeRootContext>;
@@ -55,7 +99,7 @@ declare const provideRdxCompositeRootContext: (useFactory: () => RdxCompositeRoo
  */
 declare class RdxCompositeRoot {
     readonly elementRef: ElementRef<HTMLElement>;
-    private readonly registeredItems;
+    private readonly compositeList;
     private hasSetInitialIndex;
     /** The composite orientation. */
     readonly orientationInput: _angular_core.InputSignal<RdxCompositeOrientation>;
@@ -92,10 +136,9 @@ declare class RdxCompositeRoot {
     readonly onHighlightedIndexChange: _angular_core.OutputEmitterRef<number>;
     /** Emits when the ordered item map changes. */
     readonly onMapChange: _angular_core.OutputEmitterRef<Map<HTMLElement, RdxCompositeMetadata>>;
-    readonly items: _angular_core.Signal<RdxCompositeItemRegistration<RdxCompositeItemMetadata>[]>;
+    readonly items: _angular_core.Signal<_radix_ng_primitives_composite.RdxCompositeItemRegistration<_radix_ng_primitives_composite.RdxCompositeItemMetadata>[]>;
     readonly itemMap: _angular_core.Signal<Map<HTMLElement, RdxCompositeMetadata>>;
     constructor();
-    registerItem<Metadata extends RdxCompositeItemMetadata>(item: RdxCompositeItemRegistration<Metadata>): () => void;
     indexOf(element: HTMLElement): number;
     setOrientation(value: RdxCompositeOrientation): void;
     setLoopFocus(value: boolean): void;
@@ -111,7 +154,7 @@ declare class RdxCompositeRoot {
     private getNextIndex;
     private elements;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxCompositeRoot, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxCompositeRoot, "[rdxCompositeRoot]", ["rdxCompositeRoot"], { "orientationInput": { "alias": "orientation"; "required": false; "isSignal": true; }; "dirInput": { "alias": "dir"; "required": false; "isSignal": true; }; "loopFocusInput": { "alias": "loopFocus"; "required": false; "isSignal": true; }; "enableHomeAndEndKeysInput": { "alias": "enableHomeAndEndKeys"; "required": false; "isSignal": true; }; "disabledIndicesInput": { "alias": "disabledIndices"; "required": false; "isSignal": true; }; "modifierKeysInput": { "alias": "modifierKeys"; "required": false; "isSignal": true; }; "highlightItemOnHover": { "alias": "highlightItemOnHover"; "required": false; "isSignal": true; }; "stopEventPropagation": { "alias": "stopEventPropagation"; "required": false; "isSignal": true; }; "highlightedIndex": { "alias": "highlightedIndex"; "required": false; "isSignal": true; }; }, { "highlightedIndex": "highlightedIndexChange"; "onHighlightedIndexChange": "onHighlightedIndexChange"; "onMapChange": "onMapChange"; }, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxCompositeRoot, "[rdxCompositeRoot]", ["rdxCompositeRoot"], { "orientationInput": { "alias": "orientation"; "required": false; "isSignal": true; }; "dirInput": { "alias": "dir"; "required": false; "isSignal": true; }; "loopFocusInput": { "alias": "loopFocus"; "required": false; "isSignal": true; }; "enableHomeAndEndKeysInput": { "alias": "enableHomeAndEndKeys"; "required": false; "isSignal": true; }; "disabledIndicesInput": { "alias": "disabledIndices"; "required": false; "isSignal": true; }; "modifierKeysInput": { "alias": "modifierKeys"; "required": false; "isSignal": true; }; "highlightItemOnHover": { "alias": "highlightItemOnHover"; "required": false; "isSignal": true; }; "stopEventPropagation": { "alias": "stopEventPropagation"; "required": false; "isSignal": true; }; "highlightedIndex": { "alias": "highlightedIndex"; "required": false; "isSignal": true; }; }, { "highlightedIndex": "highlightedIndexChange"; "onHighlightedIndexChange": "onHighlightedIndexChange"; "onMapChange": "onMapChange"; }, never, never, true, [{ directive: typeof RdxCompositeList; inputs: {}; outputs: {}; }]>;
 }
 
 declare const ACTIVE_COMPOSITE_ITEM = "data-composite-item-active";
@@ -141,12 +184,12 @@ declare function isElementDisabled(element: HTMLElement | null): boolean;
 declare function isElementVisible(element: HTMLElement | null): boolean;
 declare function scrollIntoViewIfNeeded(scrollContainer: HTMLElement | null, element: HTMLElement | null, direction: Direction, orientation: RdxCompositeOrientation): void;
 
-declare const compositeImports: (typeof RdxCompositeRoot | typeof RdxCompositeItem)[];
+declare const compositeImports: (typeof RdxCompositeList | typeof RdxCompositeListItem | typeof RdxCompositeRoot | typeof RdxCompositeItem)[];
 declare class RdxCompositeModule {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxCompositeModule, never>;
-    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<RdxCompositeModule, never, [typeof RdxCompositeRoot, typeof RdxCompositeItem], [typeof RdxCompositeRoot, typeof RdxCompositeItem]>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<RdxCompositeModule, never, [typeof RdxCompositeList, typeof RdxCompositeListItem, typeof RdxCompositeRoot, typeof RdxCompositeItem], [typeof RdxCompositeList, typeof RdxCompositeListItem, typeof RdxCompositeRoot, typeof RdxCompositeItem]>;
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<RdxCompositeModule>;
 }
 
-export { ACTIVE_COMPOSITE_ITEM, ARROW_KEYS, COMPOSITE_KEYS, MODIFIER_KEYS, RdxCompositeItem, RdxCompositeModule, RdxCompositeRoot, compositeImports, findNonDisabledListIndex, getCompositeNavigationKeys, getMaxListIndex, getMinListIndex, injectRdxCompositeRootContext, isElementDisabled, isElementVisible, isIndexOutOfListBounds, isListIndexDisabled, isModifierKeySet, isNativeTextInput, provideRdxCompositeRootContext, scrollIntoViewIfNeeded, shouldKeepNativeTextInputBehavior, sortByDocumentPosition };
-export type { RdxCompositeItemMetadata, RdxCompositeItemRegistration, RdxCompositeMetadata, RdxCompositeModifierKey, RdxCompositeOrientation, RdxCompositeRootContext };
+export { ACTIVE_COMPOSITE_ITEM, ARROW_KEYS, COMPOSITE_KEYS, MODIFIER_KEYS, RdxCompositeItem, RdxCompositeList, RdxCompositeListItem, RdxCompositeModule, RdxCompositeRoot, compositeImports, findNonDisabledListIndex, getCompositeNavigationKeys, getMaxListIndex, getMinListIndex, injectRdxCompositeListContext, injectRdxCompositeRootContext, isElementDisabled, isElementVisible, isIndexOutOfListBounds, isListIndexDisabled, isModifierKeySet, isNativeTextInput, provideRdxCompositeListContext, provideRdxCompositeRootContext, scrollIntoViewIfNeeded, shouldKeepNativeTextInputBehavior, sortByDocumentPosition };
+export type { RdxCompositeItemMetadata, RdxCompositeItemRegistration, RdxCompositeListContext, RdxCompositeMetadata, RdxCompositeModifierKey, RdxCompositeOrientation, RdxCompositeRootContext };