angular · alxhub · May 6, 2026 · May 5, 2026
diff --git a/packages/forms/signals/compat/src/api/compat_form.ts b/packages/forms/signals/compat/src/api/compat_form.ts
@@ -16,7 +16,7 @@ import {CompatFieldAdapter} from '../compat_field_adapter';
  * Options that may be specified when creating a compat form.
  *
  * @category interop
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export type CompatFormOptions<TModel> = Omit<FormOptions<TModel>, 'adapter'>;
 
@@ -47,7 +47,7 @@ export type CompatFormOptions<TModel> = Omit<FormOptions<TModel>, 'adapter'>;
  * the model.
  *
  * @category interop
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export function compatForm<TModel>(model: WritableSignal<TModel>): FieldTree<TModel>;
 
@@ -81,7 +81,7 @@ export function compatForm<TModel>(model: WritableSignal<TModel>): FieldTree<TMo
  *   2. The form options (excluding adapter, since it's provided).
  *
  * @category interop
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export function compatForm<TModel>(
   model: WritableSignal<TModel>,
@@ -117,7 +117,7 @@ export function compatForm<TModel>(
  * @param options The form options (excluding adapter, since it's provided).
  *
  * @category interop
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export function compatForm<TModel>(
   model: WritableSignal<TModel>,

diff --git a/packages/forms/signals/compat/src/api/di.ts b/packages/forms/signals/compat/src/api/di.ts
@@ -12,7 +12,7 @@ import type {SignalFormsConfig} from '../../../src/api/di';
  * A value that can be used for `SignalFormsConfig.classes` to automatically add
  * the `ng-*` status classes from reactive forms.
  *
- * @experimental 21.0.1
+ * @publicApi 22.0
  */
 export const NG_STATUS_CLASSES: SignalFormsConfig['classes'] = {
   'ng-touched': ({state}) => state().touched(),

diff --git a/packages/forms/signals/compat/src/api/extract.ts b/packages/forms/signals/compat/src/api/extract.ts
@@ -29,7 +29,7 @@ export type RawValue<T> =
 /**
  * A type that recursively makes all properties of T optional.
  * Used for the result of `extractValue` when filtering is applied.
- * @experimental 21.2.0
+ * @publicApi 22.0
  */
 export type DeepPartial<T> =
   | (T extends (infer U)[]
@@ -45,7 +45,7 @@ export type DeepPartial<T> =
  * Each property is optional; when provided, the field must match the specified state.
  *
  * @category interop
- * @experimental 21.2.0
+ * @publicApi 22.0
  */
 export interface ExtractFilter {
   readonly dirty?: boolean;
@@ -63,7 +63,7 @@ export interface ExtractFilter {
  * @returns The raw value of the field tree.
  *
  * @category interop
- * @experimental 21.2.0
+ * @publicApi 22.0
  */
 export function extractValue<T>(field: FieldTree<T>): RawValue<T>;
 /**
@@ -77,7 +77,7 @@ export function extractValue<T>(field: FieldTree<T>): RawValue<T>;
  * @returns A partial value containing only the fields matching the filter, or `undefined` if none match.
  *
  * @category interop
- * @experimental 21.2.0
+ * @publicApi 22.0
  */
 export function extractValue<T>(
   field: FieldTree<T>,

diff --git a/packages/forms/signals/compat/src/signal_form_control/signal_form_control.ts b/packages/forms/signals/compat/src/signal_form_control/signal_form_control.ts
@@ -77,7 +77,7 @@ export type ValueUpdateOptions = {
  *  </form>
  * ```
  *
- * @experimental
+ * @publicApi 22.0
  */
 export class SignalFormControl<T> extends AbstractControl {
   /** Source FieldTree. */

diff --git a/packages/forms/signals/src/api/control.ts b/packages/forms/signals/src/api/control.ts
@@ -15,7 +15,7 @@ import type {DisabledReason} from './types';
  * The base set of properties shared by all form control contracts.
  *
  * @category control
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export interface FormUiControl {
   /**
@@ -144,7 +144,7 @@ type FormUiControlImplementsFormFieldBindingOptions = Check<
  * @template TValue The type of `FieldTree` that the implementing component can edit.
  *
  * @category control
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export interface FormValueControl<TValue> extends FormUiControl {
   /**
@@ -173,7 +173,7 @@ export interface FormValueControl<TValue> extends FormUiControl {
  * `Field` directive.
  *
  * @category control
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 // TODO: should we make this generic extends `boolean | null` so people can use `null` for parse error?
 export interface FormCheckboxControl extends FormUiControl {

diff --git a/packages/forms/signals/src/api/di.ts b/packages/forms/signals/src/api/di.ts
@@ -13,7 +13,7 @@ import {SIGNAL_FORMS_CONFIG} from '../field/di';
 /**
  * Configuration options for signal forms.
  *
- * @experimental 21.0.1
+ * @publicApi 22.0
  */
 export interface SignalFormsConfig {
   /** A map of CSS class names to predicate functions that determine when to apply them. */
@@ -25,7 +25,7 @@ export interface SignalFormsConfig {
 /**
  * Provides configuration options for signal forms.
  *
- * @experimental 21.0.1
+ * @publicApi 22.0
  */
 export function provideSignalFormsConfig(config: SignalFormsConfig): Provider[] {
   return [{provide: SIGNAL_FORMS_CONFIG, useValue: config}];

diff --git a/packages/forms/signals/src/api/rules/debounce.ts b/packages/forms/signals/src/api/rules/debounce.ts
@@ -21,7 +21,7 @@ import type {Debouncer, PathKind, SchemaPath, SchemaPathRules} from '../types';
  * @param config A debounce configuration, which can be either a debounce duration in milliseconds,
  *     `'blur'` to debounce until the field is blurred, or a custom {@link Debouncer} function.
  *
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export function debounce<TValue, TPathKind extends PathKind = PathKind.Root>(
   path: SchemaPath<TValue, SchemaPathRules.Supported, TPathKind>,

diff --git a/packages/forms/signals/src/api/rules/disabled.ts b/packages/forms/signals/src/api/rules/disabled.ts
@@ -21,7 +21,7 @@ import type {FieldContext, LogicFn, PathKind, SchemaPath, SchemaPathRules} from
  * @template TPathKind The kind of path the logic is bound to (a root path, child path, or item of an array)
  *
  * @category logic
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export function disabled<TValue, TPathKind extends PathKind = PathKind.Root>(
   path: SchemaPath<TValue, SchemaPathRules.Supported, TPathKind>,

diff --git a/packages/forms/signals/src/api/rules/hidden.ts b/packages/forms/signals/src/api/rules/hidden.ts
@@ -28,7 +28,7 @@ import type {LogicFn, PathKind, SchemaPath, SchemaPathRules} from '../types';
  * @template TPathKind The kind of path the logic is bound to (a root path, child path, or item of an array)
  *
  * @category logic
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export function hidden<TValue, TPathKind extends PathKind = PathKind.Root>(
   path: SchemaPath<TValue, SchemaPathRules.Supported, TPathKind>,

diff --git a/packages/forms/signals/src/api/rules/metadata.ts b/packages/forms/signals/src/api/rules/metadata.ts
@@ -25,7 +25,7 @@ import type {FieldState, LogicFn, PathKind, SchemaPath, SchemaPathRules} from '.
  * @template TPathKind The kind of path the logic is bound to (a root path, child path, or item of an array)
  *
  * @category logic
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export function metadata<
   TValue,
@@ -49,7 +49,7 @@ export function metadata<
  *
  * @template TAcc The accumulated type of the reduce operation.
  * @template TItem The type of the individual items that are reduced over.
- * @experimental 21.0.2
+ * @publicApi 22.0
  */
 export interface MetadataReducer<TAcc, TItem> {
   /** The reduce function. */
@@ -125,7 +125,7 @@ function override<T>(getInitial?: () => T): MetadataReducer<T | undefined, T> {
  * A symbol used to tag a `MetadataKey` as representing an asynchronous validation resource.
  *
  * @category validation
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export const IS_ASYNC_VALIDATION_RESOURCE: unique symbol = Symbol('IS_ASYNC_VALIDATION_RESOURCE');
 
@@ -139,7 +139,7 @@ export const IS_ASYNC_VALIDATION_RESOURCE: unique symbol = Symbol('IS_ASYNC_VALI
  * @template TWrite The type written to this key using the `metadata()` rule
  * @template TAcc The type of the reducer's accumulated value.
  *
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export class MetadataKey<TRead, TWrite, TAcc> {
   private brand!: [TRead, TWrite, TAcc];
@@ -159,7 +159,7 @@ export class MetadataKey<TRead, TWrite, TAcc> {
  *
  * @template TKey The `MetadataKey` type
  *
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export type MetadataSetterType<TKey> =
   TKey extends MetadataKey<any, infer TWrite, any> ? TWrite : never;
@@ -170,7 +170,7 @@ export type MetadataSetterType<TKey> =
  *
  * @template TWrite The type written to this key using the `metadata()` rule
  *
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export function createMetadataKey<TWrite>(): MetadataKey<
   Signal<TWrite | undefined>,
@@ -184,7 +184,7 @@ export function createMetadataKey<TWrite>(): MetadataKey<
  * @template TWrite The type written to this key using the `metadata()` rule
  * @template TAcc The type of the reducer's accumulated value.
  *
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export function createMetadataKey<TWrite, TAcc>(
   reducer: MetadataReducer<TAcc, TWrite>,
@@ -208,7 +208,7 @@ export function createMetadataKey<TWrite, TAcc>(
  * @template TRead The type read from the `FieldState` for this key
  * @template TWrite The type written to this key using the `metadata()` rule
  *
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export function createManagedMetadataKey<TRead, TWrite>(
   create: (state: FieldState<unknown>, data: Signal<TWrite | undefined>) => TRead,
@@ -226,7 +226,7 @@ export function createManagedMetadataKey<TRead, TWrite>(
  * @template TWrite The type written to this key using the `metadata()` rule
  * @template TAcc The type of the reducer's accumulated value.
  *
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export function createManagedMetadataKey<TRead, TWrite, TAcc>(
   create: (state: FieldState<unknown>, data: Signal<TAcc>) => TRead,
@@ -246,7 +246,7 @@ export function createManagedMetadataKey<TRead, TWrite, TAcc>(
  * A {@link MetadataKey} representing whether the field is required.
  *
  * @category validation
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export const REQUIRED: MetadataKey<Signal<boolean>, boolean, boolean> = createMetadataKey(
   MetadataReducer.or(),
@@ -256,7 +256,7 @@ export const REQUIRED: MetadataKey<Signal<boolean>, boolean, boolean> = createMe
  * A {@link MetadataKey} representing the min value of the field.
  *
  * @category validation
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export const MIN: MetadataKey<
   Signal<number | undefined>,
@@ -268,7 +268,7 @@ export const MIN: MetadataKey<
  * A {@link MetadataKey} representing the max value of the field.
  *
  * @category validation
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export const MAX: MetadataKey<
   Signal<number | undefined>,
@@ -280,7 +280,7 @@ export const MAX: MetadataKey<
  * A {@link MetadataKey} representing the min length of the field.
  *
  * @category validation
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export const MIN_LENGTH: MetadataKey<
   Signal<number | undefined>,
@@ -292,7 +292,7 @@ export const MIN_LENGTH: MetadataKey<
  * A {@link MetadataKey} representing the max length of the field.
  *
  * @category validation
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export const MAX_LENGTH: MetadataKey<
   Signal<number | undefined>,
@@ -304,7 +304,7 @@ export const MAX_LENGTH: MetadataKey<
  * A {@link MetadataKey} representing the patterns the field must match.
  *
  * @category validation
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export const PATTERN: MetadataKey<
   Signal<RegExp[]>,

diff --git a/packages/forms/signals/src/api/rules/readonly.ts b/packages/forms/signals/src/api/rules/readonly.ts
@@ -20,7 +20,7 @@ import type {LogicFn, PathKind, SchemaPath, SchemaPathRules} from '../types';
  * @template TPathKind The kind of path the logic is bound to (a root path, child path, or item of an array)
  *
  * @category logic
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export function readonly<TValue, TPathKind extends PathKind = PathKind.Root>(
   path: SchemaPath<TValue, SchemaPathRules.Supported, TPathKind>,

diff --git a/packages/forms/signals/src/api/rules/validation/email.ts b/packages/forms/signals/src/api/rules/validation/email.ts
@@ -56,7 +56,7 @@ const EMAIL_REGEXP =
  *
  * @see [Signal Form Email Validation](guide/forms/signals/validation#email)
  * @category validation
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export function email<TPathKind extends PathKind = PathKind.Root>(
   path: SchemaPath<string, SchemaPathRules.Supported, TPathKind>,

diff --git a/packages/forms/signals/src/api/rules/validation/max.ts b/packages/forms/signals/src/api/rules/validation/max.ts
@@ -27,7 +27,7 @@ import {maxError} from './validation_errors';
  *
  * @see [Signal Form Max Validation](guide/forms/signals/validation#min-and-max)
  * @category validation
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export function max<TPathKind extends PathKind = PathKind.Root>(
   path: SchemaPath<number | string | null, SchemaPathRules.Supported, TPathKind>,

diff --git a/packages/forms/signals/src/api/rules/validation/max_length.ts b/packages/forms/signals/src/api/rules/validation/max_length.ts
@@ -34,7 +34,7 @@ import {maxLengthError} from './validation_errors';
  *
  * @see [Signal Form Max Length Validation](guide/forms/signals/validation#minlength-and-maxlength)
  * @category validation
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export function maxLength<
   TValue extends ValueWithLengthOrSize,

diff --git a/packages/forms/signals/src/api/rules/validation/min.ts b/packages/forms/signals/src/api/rules/validation/min.ts
@@ -27,7 +27,7 @@ import {minError} from './validation_errors';
  *
  * @see [Signal Form Min Validation](guide/forms/signals/validation#min-and-max)
  * @category validation
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export function min<
   TValue extends number | string | null,

diff --git a/packages/forms/signals/src/api/rules/validation/min_length.ts b/packages/forms/signals/src/api/rules/validation/min_length.ts
@@ -34,7 +34,7 @@ import {minLengthError} from './validation_errors';
  *
  * @see [Signal Form Min Length Validation](guide/forms/signals/validation#minlength-and-maxlength)
  * @category validation
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export function minLength<
   TValue extends ValueWithLengthOrSize,

diff --git a/packages/forms/signals/src/api/rules/validation/pattern.ts b/packages/forms/signals/src/api/rules/validation/pattern.ts
@@ -26,7 +26,7 @@ import {patternError} from './validation_errors';
  *
  * @see [Signal Form Pattern Validation](guide/forms/signals/validation#pattern)
  * @category validation
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export function pattern<TPathKind extends PathKind = PathKind.Root>(
   path: SchemaPath<string, SchemaPathRules.Supported, TPathKind>,

diff --git a/packages/forms/signals/src/api/rules/validation/required.ts b/packages/forms/signals/src/api/rules/validation/required.ts
@@ -28,7 +28,7 @@ import {requiredError} from './validation_errors';
  *
  * @see [Signal Form Required Validation](guide/forms/signals/validation#required)
  * @category validation
- * @experimental 21.0.0
+ * @publicApi 22.0
  */
 export function required<TValue, TPathKind extends PathKind = PathKind.Root>(
   path: SchemaPath<TValue, SchemaPathRules.Supported, TPathKind>,