@radix-ng/primitives 1.0.6 → 1.0.8

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

@@ -1,7 +1,8 @@
-import * as _radix_ng_primitives_field from '@radix-ng/primitives/field';
 import * as _angular_core from '@angular/core';
+import { Signal } from '@angular/core';
+import * as _radix_ng_primitives_field from '@radix-ng/primitives/field';
 import * as _radix_ng_primitives_core from '@radix-ng/primitives/core';
-import { BooleanInput, RdxValidationError } from '@radix-ng/primitives/core';
+import { BooleanInput, RdxValidationMode, RdxValidationError } from '@radix-ng/primitives/core';
 
 /**
  * Connects a form control to the field label, description, error, and state.
@@ -9,32 +10,7 @@ import { BooleanInput, RdxValidationError } from '@radix-ng/primitives/core';
  * @group Components
  */
 declare class RdxFieldControl {
-    protected readonly rootContext: {
-        controlId: _angular_core.WritableSignal<string>;
-        name: _angular_core.InputSignal<string | undefined>;
-        descriptionIds: _angular_core.WritableSignal<string[]>;
-        errorIds: _angular_core.WritableSignal<string[]>;
-        messages: _angular_core.Signal<string[]>;
-        notifyEdited: () => void;
-        invalidState: _angular_core.Signal<boolean>;
-        disabledState: _angular_core.Signal<boolean>;
-        requiredState: _angular_core.Signal<boolean>;
-        dirtyState: _angular_core.Signal<boolean>;
-        touchedState: _angular_core.Signal<boolean>;
-        filledState: _angular_core.Signal<boolean>;
-        focusedState: _angular_core.Signal<boolean>;
-        setControlId: (id: string) => void;
-        addDescriptionId: (id: string) => void;
-        removeDescriptionId: (id: string) => void;
-        addErrorId: (id: string) => void;
-        removeErrorId: (id: string) => void;
-        setFocused: (value: boolean) => void;
-        setFilled: (value: boolean) => void;
-        setDirty: (value: boolean) => void;
-        setTouched: (value: boolean) => void;
-        setStateProvider: (provider: _radix_ng_primitives_field.RdxFieldState | null) => _radix_ng_primitives_field.RdxFieldState | null;
-        hasStateProvider: _angular_core.Signal<boolean>;
-    };
+    protected readonly rootContext: _radix_ng_primitives_field.RdxFieldRootContext;
     private readonly elementRef;
     private initialValue;
     /**
@@ -61,32 +37,7 @@ declare class RdxFieldControl {
  * @group Components
  */
 declare class RdxFieldDescription {
-    protected readonly rootContext: {
-        controlId: _angular_core.WritableSignal<string>;
-        name: _angular_core.InputSignal<string | undefined>;
-        descriptionIds: _angular_core.WritableSignal<string[]>;
-        errorIds: _angular_core.WritableSignal<string[]>;
-        messages: _angular_core.Signal<string[]>;
-        notifyEdited: () => void;
-        invalidState: _angular_core.Signal<boolean>;
-        disabledState: _angular_core.Signal<boolean>;
-        requiredState: _angular_core.Signal<boolean>;
-        dirtyState: _angular_core.Signal<boolean>;
-        touchedState: _angular_core.Signal<boolean>;
-        filledState: _angular_core.Signal<boolean>;
-        focusedState: _angular_core.Signal<boolean>;
-        setControlId: (id: string) => void;
-        addDescriptionId: (id: string) => void;
-        removeDescriptionId: (id: string) => void;
-        addErrorId: (id: string) => void;
-        removeErrorId: (id: string) => void;
-        setFocused: (value: boolean) => void;
-        setFilled: (value: boolean) => void;
-        setDirty: (value: boolean) => void;
-        setTouched: (value: boolean) => void;
-        setStateProvider: (provider: _radix_ng_primitives_field.RdxFieldState | null) => _radix_ng_primitives_field.RdxFieldState | null;
-        hasStateProvider: _angular_core.Signal<boolean>;
-    };
+    protected readonly rootContext: _radix_ng_primitives_field.RdxFieldRootContext;
     /**
      * Description id.
      *
@@ -105,32 +56,7 @@ declare class RdxFieldDescription {
  * @group Components
  */
 declare class RdxFieldError {
-    protected readonly rootContext: {
-        controlId: _angular_core.WritableSignal<string>;
-        name: _angular_core.InputSignal<string | undefined>;
-        descriptionIds: _angular_core.WritableSignal<string[]>;
-        errorIds: _angular_core.WritableSignal<string[]>;
-        messages: _angular_core.Signal<string[]>;
-        notifyEdited: () => void;
-        invalidState: _angular_core.Signal<boolean>;
-        disabledState: _angular_core.Signal<boolean>;
-        requiredState: _angular_core.Signal<boolean>;
-        dirtyState: _angular_core.Signal<boolean>;
-        touchedState: _angular_core.Signal<boolean>;
-        filledState: _angular_core.Signal<boolean>;
-        focusedState: _angular_core.Signal<boolean>;
-        setControlId: (id: string) => void;
-        addDescriptionId: (id: string) => void;
-        removeDescriptionId: (id: string) => void;
-        addErrorId: (id: string) => void;
-        removeErrorId: (id: string) => void;
-        setFocused: (value: boolean) => void;
-        setFilled: (value: boolean) => void;
-        setDirty: (value: boolean) => void;
-        setTouched: (value: boolean) => void;
-        setStateProvider: (provider: _radix_ng_primitives_field.RdxFieldState | null) => _radix_ng_primitives_field.RdxFieldState | null;
-        hasStateProvider: _angular_core.Signal<boolean>;
-    };
+    protected readonly rootContext: _radix_ng_primitives_field.RdxFieldRootContext;
     /**
      * Error message id.
      *
@@ -138,8 +64,9 @@ declare class RdxFieldError {
      */
     readonly id: _angular_core.InputSignal<string>;
     /**
-     * The field's external messages (state provider's, then enclosing Form's), `[]` when none. Render
-     * them explicitly via the `exportAs` reference — the directive never injects text content itself:
+     * The field's validation messages — client (provider / form name-routing, once `validationMode`
+     * reveals them) then server (the Form's `errors` input, always); `[]` when none. Render them
+     * explicitly via the `exportAs` reference — the directive never injects text content itself:
      * `<p rdxFieldError #err="rdxFieldError">{{ err.messages().join(' ') }}</p>`.
      */
     readonly messages: _angular_core.Signal<string[]>;
@@ -149,51 +76,6 @@ declare class RdxFieldError {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxFieldError, "[rdxFieldError]", ["rdxFieldError"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-/**
- * Labels the field control.
- *
- * @group Components
- */
-declare class RdxFieldLabel {
-    protected readonly rootContext: {
-        controlId: _angular_core.WritableSignal<string>;
-        name: _angular_core.InputSignal<string | undefined>;
-        descriptionIds: _angular_core.WritableSignal<string[]>;
-        errorIds: _angular_core.WritableSignal<string[]>;
-        messages: _angular_core.Signal<string[]>;
-        notifyEdited: () => void;
-        invalidState: _angular_core.Signal<boolean>;
-        disabledState: _angular_core.Signal<boolean>;
-        requiredState: _angular_core.Signal<boolean>;
-        dirtyState: _angular_core.Signal<boolean>;
-        touchedState: _angular_core.Signal<boolean>;
-        filledState: _angular_core.Signal<boolean>;
-        focusedState: _angular_core.Signal<boolean>;
-        setControlId: (id: string) => void;
-        addDescriptionId: (id: string) => void;
-        removeDescriptionId: (id: string) => void;
-        addErrorId: (id: string) => void;
-        removeErrorId: (id: string) => void;
-        setFocused: (value: boolean) => void;
-        setFilled: (value: boolean) => void;
-        setDirty: (value: boolean) => void;
-        setTouched: (value: boolean) => void;
-        setStateProvider: (provider: _radix_ng_primitives_field.RdxFieldState | null) => _radix_ng_primitives_field.RdxFieldState | null;
-        hasStateProvider: _angular_core.Signal<boolean>;
-    };
-    /**
-     * Label id.
-     *
-     * @group Props
-     */
-    readonly id: _angular_core.InputSignal<string>;
-    readonly htmlFor: () => string;
-    constructor();
-    protected readonly dataAttr: (value: boolean) => "" | undefined;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxFieldLabel, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxFieldLabel, "[rdxFieldLabel]", ["rdxFieldLabel"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
 /**
  * External owner of field state. An adapter (e.g. a future Signal Forms
  * `[rdxSignalField]` directive, or a Reactive Forms bridge) registers one via
@@ -207,6 +89,11 @@ declare class RdxFieldLabel {
  * See ADR 0004 and `signal-forms-readiness.md` (prep #4).
  */
 interface RdxFieldState {
+    /**
+     * The control's **actual** invalidity (ungated). The Field decides *when* to display it from its
+     * `validationMode` (e.g. only after blur) — the adapter just reports the real state. A non-empty
+     * `errors()` also counts as invalid.
+     */
     invalid?: () => boolean;
     disabled?: () => boolean;
     required?: () => boolean;
@@ -215,64 +102,33 @@ interface RdxFieldState {
     filled?: () => boolean;
     focused?: () => boolean;
     /**
-     * Optional source of error *content* (not just the invalid boolean). When provided and non-empty
-     * it forces `invalidState` true, and its messages (`message ?? kind` per error) surface through
-     * `RdxFieldError.messages()` ahead of any enclosing Form's external messages. Uses `core`'s
-     * framework-free shim type so the seam stays free of `@angular/forms/signals` (ADR 0004 amendment).
+     * Optional source of error *content* (not just the invalid boolean). A non-empty list marks the field
+     * **actually** invalid (client validation) and its messages (`message ?? kind` per error) surface
+     * through `RdxFieldError.messages()` once the field's `validationMode` reveals client validity, ahead of
+     * any enclosing Form's server messages. Uses `core`'s framework-free shim type so the seam stays free of
+     * `@angular/forms/signals` (ADR 0004 amendment).
      */
     errors?: () => RdxValidationError[];
 }
-declare const fieldRootContext: () => {
-    controlId: _angular_core.WritableSignal<string>;
-    name: _angular_core.InputSignal<string | undefined>;
-    descriptionIds: _angular_core.WritableSignal<string[]>;
-    errorIds: _angular_core.WritableSignal<string[]>;
-    /** Combined external messages (state provider's, then enclosing Form's), for `RdxFieldError`. */
-    messages: _angular_core.Signal<string[]>;
-    /** Notify an enclosing Form that this field's control was edited (composite-control opt-in). */
-    notifyEdited: () => void;
-    invalidState: _angular_core.Signal<boolean>;
-    disabledState: _angular_core.Signal<boolean>;
-    requiredState: _angular_core.Signal<boolean>;
-    dirtyState: _angular_core.Signal<boolean>;
-    touchedState: _angular_core.Signal<boolean>;
-    filledState: _angular_core.Signal<boolean>;
-    focusedState: _angular_core.Signal<boolean>;
-    setControlId: (id: string) => void;
-    addDescriptionId: (id: string) => void;
-    removeDescriptionId: (id: string) => void;
-    addErrorId: (id: string) => void;
-    removeErrorId: (id: string) => void;
-    setFocused: (value: boolean) => void;
-    setFilled: (value: boolean) => void;
-    setDirty: (value: boolean) => void;
-    setTouched: (value: boolean) => void;
-    /**
-     * Register (or clear with `null`) an external owner of field state.
-     * While a provider is registered, any state it exposes takes precedence
-     * over the root inputs and the DOM-derived values. Returns the previous
-     * provider so adapters can restore it on teardown.
-     */
-    setStateProvider: (provider: RdxFieldState | null) => RdxFieldState | null;
-    hasStateProvider: _angular_core.Signal<boolean>;
-};
-type RdxFieldRootContext = ReturnType<typeof fieldRootContext>;
-declare const injectFieldRootContext: _radix_ng_primitives_core.InjectContext<{
-    controlId: _angular_core.WritableSignal<string>;
-    name: _angular_core.InputSignal<string | undefined>;
-    descriptionIds: _angular_core.WritableSignal<string[]>;
-    errorIds: _angular_core.WritableSignal<string[]>;
-    /** Combined external messages (state provider's, then enclosing Form's), for `RdxFieldError`. */
-    messages: _angular_core.Signal<string[]>;
-    /** Notify an enclosing Form that this field's control was edited (composite-control opt-in). */
+interface RdxFieldRootContext {
+    controlId: Signal<string>;
+    name: Signal<string | undefined>;
+    descriptionIds: Signal<string[]>;
+    errorIds: Signal<string[]>;
+    messages: Signal<string[]>;
     notifyEdited: () => void;
-    invalidState: _angular_core.Signal<boolean>;
-    disabledState: _angular_core.Signal<boolean>;
-    requiredState: _angular_core.Signal<boolean>;
-    dirtyState: _angular_core.Signal<boolean>;
-    touchedState: _angular_core.Signal<boolean>;
-    filledState: _angular_core.Signal<boolean>;
-    focusedState: _angular_core.Signal<boolean>;
+    /** Tri-state *displayed* validity (`true` valid / `false` invalid / `null` neutral), gated by the
+     * field's `validationMode`. The source for `data-valid` / `data-invalid` on the field and its controls. */
+    validState: Signal<boolean | null>;
+    /** Whether the enclosing Form has had a submit attempted (always `false` with no Form). */
+    formSubmitAttempted: Signal<boolean>;
+    invalidState: Signal<boolean>;
+    disabledState: Signal<boolean>;
+    requiredState: Signal<boolean>;
+    dirtyState: Signal<boolean>;
+    touchedState: Signal<boolean>;
+    filledState: Signal<boolean>;
+    focusedState: Signal<boolean>;
     setControlId: (id: string) => void;
     addDescriptionId: (id: string) => void;
     removeDescriptionId: (id: string) => void;
@@ -282,49 +138,17 @@ declare const injectFieldRootContext: _radix_ng_primitives_core.InjectContext<{
     setFilled: (value: boolean) => void;
     setDirty: (value: boolean) => void;
     setTouched: (value: boolean) => void;
-    /**
-     * Register (or clear with `null`) an external owner of field state.
-     * While a provider is registered, any state it exposes takes precedence
-     * over the root inputs and the DOM-derived values. Returns the previous
-     * provider so adapters can restore it on teardown.
-     */
     setStateProvider: (provider: RdxFieldState | null) => RdxFieldState | null;
-    hasStateProvider: _angular_core.Signal<boolean>;
-}>;
-declare const provideFieldRootContext: (useFactory: () => {
-    controlId: _angular_core.WritableSignal<string>;
-    name: _angular_core.InputSignal<string | undefined>;
-    descriptionIds: _angular_core.WritableSignal<string[]>;
-    errorIds: _angular_core.WritableSignal<string[]>;
-    /** Combined external messages (state provider's, then enclosing Form's), for `RdxFieldError`. */
-    messages: _angular_core.Signal<string[]>;
-    /** Notify an enclosing Form that this field's control was edited (composite-control opt-in). */
-    notifyEdited: () => void;
-    invalidState: _angular_core.Signal<boolean>;
-    disabledState: _angular_core.Signal<boolean>;
-    requiredState: _angular_core.Signal<boolean>;
-    dirtyState: _angular_core.Signal<boolean>;
-    touchedState: _angular_core.Signal<boolean>;
-    filledState: _angular_core.Signal<boolean>;
-    focusedState: _angular_core.Signal<boolean>;
-    setControlId: (id: string) => void;
-    addDescriptionId: (id: string) => void;
-    removeDescriptionId: (id: string) => void;
-    addErrorId: (id: string) => void;
-    removeErrorId: (id: string) => void;
-    setFocused: (value: boolean) => void;
-    setFilled: (value: boolean) => void;
-    setDirty: (value: boolean) => void;
-    setTouched: (value: boolean) => void;
     /**
-     * Register (or clear with `null`) an external owner of field state.
-     * While a provider is registered, any state it exposes takes precedence
-     * over the root inputs and the DOM-derived values. Returns the previous
-     * provider so adapters can restore it on teardown.
+     * Identity-checked teardown: roll the slot back to `previous` only if `provider` is still the
+     * active one. A newer adapter that registered after `provider` (create-before-destroy during a
+     * view swap) owns the slot and must not be clobbered by the old adapter's destroy.
      */
-    setStateProvider: (provider: RdxFieldState | null) => RdxFieldState | null;
-    hasStateProvider: _angular_core.Signal<boolean>;
-}) => _angular_core.Provider;
+    clearStateProvider: (provider: RdxFieldState | null, previous: RdxFieldState | null) => void;
+    hasStateProvider: Signal<boolean>;
+}
+declare const injectFieldRootContext: _radix_ng_primitives_core.InjectContext<RdxFieldRootContext>;
+declare const provideFieldRootContext: (useFactory: () => RdxFieldRootContext) => _angular_core.Provider;
 /**
  * Groups a form control with its label, description, error message, and field state.
  *
@@ -385,6 +209,13 @@ declare class RdxFieldRoot {
      * @group Props
      */
     readonly name: _angular_core.InputSignal<string | undefined>;
+    /**
+     * Overrides when this field reveals its validity (error styling + message). Falls back to the
+     * enclosing `rdxFormRoot`'s `validationMode`, then `'onBlur'`. Server errors always show regardless.
+     *
+     * @group Props
+     */
+    readonly validationMode: _angular_core.InputSignal<RdxValidationMode | undefined>;
     /** The enclosing Form, if any. All Form-related behavior is a no-op when this is `null`. */
     private readonly formContext;
     readonly controlId: _angular_core.WritableSignal<string>;
@@ -397,20 +228,60 @@ declare class RdxFieldRoot {
     /** External state owner registered through the context; `null` when Field self-computes. */
     private readonly stateProvider;
     /** Whether an external adapter currently owns field state. */
-    readonly hasStateProvider: _angular_core.Signal<boolean>;
+    readonly hasStateProvider: Signal<boolean>;
     /** Error content from a registered state provider (e.g. a Signal Forms adapter). */
     private readonly providerErrors;
-    /** External messages from the enclosing Form matched by this field's `name`. */
-    readonly externalErrors: _angular_core.Signal<string[]>;
-    /** Provider messages first (`message ?? kind`), then the Form's external messages. */
-    readonly messages: _angular_core.Signal<string[]>;
-    readonly invalidState: _angular_core.Signal<boolean>;
-    readonly disabledState: _angular_core.Signal<boolean>;
-    readonly requiredState: _angular_core.Signal<boolean>;
-    readonly dirtyState: _angular_core.Signal<boolean>;
-    readonly touchedState: _angular_core.Signal<boolean>;
-    readonly filledState: _angular_core.Signal<boolean>;
-    readonly focusedState: _angular_core.Signal<boolean>;
+    /** **Client** validation errors routed by a form-level provider (`rdxSignalForm`) — gated by `validationMode`. */
+    private readonly clientErrors;
+    /** **Server/external** errors from the Form's `errors` input — shown eagerly (never gated). */
+    private readonly serverErrors;
+    /** Whether the enclosing Form has had a submit attempted; `false` when standalone. A presentation
+     * seam an adapter can read to reveal errors after a submit attempt (Base UI's submit-attempt state). */
+    readonly formSubmitAttempted: Signal<boolean>;
+    /**
+     * Client messages first (per-field `rdxSignalField` provider, then form-level `rdxSignalForm`
+     * name-routing) — only once `validationMode` reveals client validity — then the Form's **server**
+     * messages (the `errors` input), which always show. **Deduped by text**: a field can receive the same
+     * Signal Forms error from both a per-field provider and the form-level routing (they read the same
+     * field state), so deduping renders it once while still surfacing distinct messages from each source.
+     */
+    readonly messages: Signal<string[]>;
+    /** Effective validation-display mode: this field's override → the enclosing Form's → the default. */
+    readonly effectiveValidationMode: Signal<RdxValidationMode>;
+    /** Whether client-side validity is revealed yet, per {@link effectiveValidationMode} + interaction. */
+    private readonly validationRevealed;
+    /**
+     * Client-side invalidity (gated by `validationMode`): the per-field provider's error content / `invalid`
+     * (`rdxSignalField`), a form-level provider's name-routed errors (`rdxSignalForm`), or the `[invalid]`
+     * input. Excludes server errors (which are eager).
+     */
+    private readonly clientInvalidState;
+    /**
+     * Tri-state *displayed* validity (`boolean | null`) — the source for `data-valid` / `data-invalid`.
+     * Server errors show immediately; client-side validity (including `rdxSignalForm` name-routing) stays
+     * **neutral** (`null`) until the field's {@link effectiveValidationMode} reveals it, then `false`/`true`.
+     */
+    readonly validState: Signal<boolean | null>;
+    /**
+     * Boolean **displayed** invalidity (= `validState() === false`), used by `rdxFieldError` (hidden) and
+     * `rdxFieldControl`'s `aria-describedby` error linking. A neutral (`null`) `validState` reads as not
+     * invalid here, so the error region stays hidden until the field's mode reveals it.
+     */
+    readonly invalidState: Signal<boolean>;
+    /**
+     * Boolean **actual** invalidity — ungated by the display mode. The enclosing Form aggregates this into
+     * `anyInvalid` (→ submit-block / focus-first-invalid), so a field that is really invalid but displayed
+     * neutral still blocks submit. The form's presentation `data-invalid` comes from the *displayed*
+     * aggregate (`anyDisplayedInvalid`) instead — not from this. Server errors + provider error content +
+     * the provider/input `invalid`.
+     */
+    readonly actualInvalidState: Signal<boolean>;
+    readonly disabledState: Signal<boolean>;
+    readonly requiredState: Signal<boolean>;
+    readonly dirtyState: Signal<boolean>;
+    readonly touchedState: Signal<boolean>;
+    readonly filledState: Signal<boolean>;
+    readonly focusedState: Signal<boolean>;
     protected readonly dataAttr: (value: boolean) => "" | undefined;
     constructor();
     /** Notify the enclosing Form (if any) that this field's control was edited (clear-on-edit). */
@@ -431,14 +302,72 @@ declare class RdxFieldRoot {
      * @ignore
      */
     setStateProvider(provider: RdxFieldState | null): RdxFieldState | null;
+    /**
+     * Identity-checked teardown — roll back to `previous` only if `provider` is still active. Prevents
+     * an old adapter's destroy from clobbering a newer adapter that registered after it (create-before-
+     * destroy during a structural view swap).
+     */
+    clearStateProvider(provider: RdxFieldState | null, previous: RdxFieldState | null): void;
     /**
      * Prefer the registered provider's value for `key` when it exposes one,
-     * otherwise fall back to the root inputs / DOM-derived signals.
+     * otherwise fall back to the root inputs / DOM-derived signals. `errors` (content) and `valid`
+     * (tri-state `boolean | null`) are resolved separately, so they're excluded from this boolean key.
      */
     private resolve;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxFieldRoot, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxFieldRoot, "[rdxFieldRoot]", ["rdxFieldRoot"], { "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "dirty": { "alias": "dirty"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "filled": { "alias": "filled"; "required": false; "isSignal": true; }; "focused": { "alias": "focused"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxFieldRoot, "[rdxFieldRoot]", ["rdxFieldRoot"], { "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "dirty": { "alias": "dirty"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "filled": { "alias": "filled"; "required": false; "isSignal": true; }; "focused": { "alias": "focused"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "validationMode": { "alias": "validationMode"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Groups an individual item in a checkbox group or radio group with its own label and description.
+ *
+ * Use inside a `rdxFieldRoot` (typically wrapping a group) when each control needs its own label /
+ * description: the item scopes those associations to its control while reflecting the field's validation
+ * state. Mirrors Base UI's `Field.Item`.
+ *
+ * @group Components
+ */
+declare class RdxFieldItem {
+    /** The enclosing field root (items are leaves under the root, so `skipSelf` reaches it). */
+    readonly root: RdxFieldRoot;
+    /**
+     * Whether the wrapped control should ignore user interaction. The `disabled` on `rdxFieldRoot` takes
+     * precedence (it is OR'd in).
+     *
+     * @group Props
+     * @defaultValue false
+     */
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
+    /** This item's control id — label / description / control inside the item associate with it. */
+    readonly controlId: _angular_core.WritableSignal<string>;
+    /** Description ids for this item's control `aria-describedby`. */
+    readonly descriptionIds: _angular_core.WritableSignal<string[]>;
+    /** The item's effective disabled state: the root's disabled OR the item's. */
+    readonly disabledState: _angular_core.Signal<boolean>;
+    protected readonly dataAttr: (value: boolean) => "" | undefined;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxFieldItem, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxFieldItem, "[rdxFieldItem]", ["rdxFieldItem"], { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Labels the field control.
+ *
+ * @group Components
+ */
+declare class RdxFieldLabel {
+    protected readonly rootContext: _radix_ng_primitives_field.RdxFieldRootContext;
+    /**
+     * Label id.
+     *
+     * @group Props
+     */
+    readonly id: _angular_core.InputSignal<string>;
+    readonly htmlFor: () => string;
+    constructor();
+    protected readonly dataAttr: (value: boolean) => "" | undefined;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<RdxFieldLabel, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RdxFieldLabel, "[rdxFieldLabel]", ["rdxFieldLabel"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-export { RdxFieldControl, RdxFieldDescription, RdxFieldError, RdxFieldLabel, RdxFieldRoot, injectFieldRootContext, provideFieldRootContext };
+export { RdxFieldControl, RdxFieldDescription, RdxFieldError, RdxFieldItem, RdxFieldLabel, RdxFieldRoot, injectFieldRootContext, provideFieldRootContext };
 export type { RdxFieldRootContext, RdxFieldState };