feat(forms): allow focusing bound control from field state

Allows focusing the assocated bound control from the `FieldState`.

Author: mmalerba

goldens/public-api/forms/signals/index.api.md

@@ -130,6 +130,7 @@ export interface FieldState<TValue, TKey extends string | number = string | numb
     // (undocumented)
     readonly errors: Signal<ValidationError.WithField[]>;
     readonly errorSummary: Signal<ValidationError.WithField[]>;
+    focusBoundControl(): void;
     readonly formFieldBindings: Signal<readonly FormField<unknown>[]>;
     readonly hidden: Signal<boolean>;
     readonly invalid: Signal<boolean>;
@@ -174,6 +175,7 @@ export class FormField<T> {
     };
     // (undocumented)
     readonly element: HTMLElement;
+    focus?(): void;
     // (undocumented)
     readonly formField: i0.InputSignal<FieldTree<T>>;
     protected getOrCreateNgControl(): InteropNgControl;

packages/core/src/core_render3_private_export.ts

@@ -10,26 +10,33 @@
 // performed by rollup while it's creating fesm files.
 //
 // no code actually imports these symbols from the @angular/core entry point
-export {isBoundToModule as ɵisBoundToModule} from './application/application_ref';
+export {
+  Framework as ɵFramework,
+  Profiler as ɵProfiler,
+  ProfilerEvent as ɵProfilerEvent,
+} from '../primitives/devtools';
 export {compileNgModuleFactory as ɵcompileNgModuleFactory} from './application/application_ngmodule_factory_compiler';
+export {isBoundToModule as ɵisBoundToModule} from './application/application_ref';
 export {injectChangeDetectorRef as ɵinjectChangeDetectorRef} from './change_detection/change_detector_ref';
 export {getDebugNode as ɵgetDebugNode} from './debug/debug_node';
+export {createInjector as ɵcreateInjector} from './di/create_injector';
 export {
+  isInjectable as ɵisInjectable,
   NG_INJ_DEF as ɵNG_INJ_DEF,
   NG_PROV_DEF as ɵNG_PROV_DEF,
-  isInjectable as ɵisInjectable,
 } from './di/interface/defs';
-export {createInjector as ɵcreateInjector} from './di/create_injector';
 export {
-  registerNgModuleType as ɵɵregisterNgModuleType,
   setAllowDuplicateNgModuleIdsForTest as ɵsetAllowDuplicateNgModuleIdsForTest,
+  registerNgModuleType as ɵɵregisterNgModuleType,
 } from './linker/ng_module_registration';
 export {
   NgModuleDef as ɵNgModuleDef,
   NgModuleTransitiveScopes as ɵNgModuleTransitiveScopes,
 } from './metadata/ng_module_def';
-export {getLContext as ɵgetLContext} from './render3/context_discovery';
+export {AfterRenderManager as ɵAfterRenderManager} from './render3/after_render/manager';
 export {inferTagNameFromDefinition as ɵinferTagNameFromDefinition} from './render3/component_ref';
+export {getLContext as ɵgetLContext} from './render3/context_discovery';
+export {depsTracker as ɵdepsTracker} from './render3/deps_tracker/deps_tracker';
 export {
   NG_COMP_DEF as ɵNG_COMP_DEF,
   NG_DIR_DEF as ɵNG_DIR_DEF,
@@ -38,90 +45,119 @@ export {
   NG_PIPE_DEF as ɵNG_PIPE_DEF,
 } from './render3/fields';
 export {
+  AcxChangeDetectionStrategy as ɵAcxChangeDetectionStrategy,
+  AcxComponentDebugMetadata as ɵAcxComponentDebugMetadata,
+  AcxDirectiveDebugMetadata as ɵAcxDirectiveDebugMetadata,
+  AcxViewEncapsulation as ɵAcxViewEncapsulation,
+  AngularComponentDebugMetadata as ɵAngularComponentDebugMetadata,
+  AngularDirectiveDebugMetadata as ɵAngularDirectiveDebugMetadata,
   AttributeMarker as ɵAttributeMarker,
+  BaseDirectiveDebugMetadata as ɵBaseDirectiveDebugMetadata,
   ComponentDef as ɵComponentDef,
-  ComponentFactory as ɵRender3ComponentFactory,
-  ComponentRef as ɵRender3ComponentRef,
   ComponentType as ɵComponentType,
+  ɵcontrolUpdate,
   CssSelectorList as ɵCssSelectorList,
+  ɵDEFER_BLOCK_CONFIG,
+  ɵDEFER_BLOCK_DEPENDENCY_INTERCEPTOR,
+  ɵDeferBlockDependencyInterceptor,
+  DirectiveDebugMetadata as ɵDirectiveDebugMetadata,
   DirectiveDef as ɵDirectiveDef,
   DirectiveType as ɵDirectiveType,
   getDirectives as ɵgetDirectives,
   getHostElement as ɵgetHostElement,
+  ɵgetUnknownElementStrictMode,
+  ɵgetUnknownPropertyStrictMode,
   NgModuleFactory as ɵNgModuleFactory,
-  NgModuleRef as ɵRender3NgModuleRef,
   NgModuleType as ɵNgModuleType,
   NO_CHANGE as ɵNO_CHANGE,
   PipeDef as ɵPipeDef,
+  ComponentFactory as ɵRender3ComponentFactory,
+  ComponentRef as ɵRender3ComponentRef,
+  NgModuleRef as ɵRender3NgModuleRef,
   RenderFlags as ɵRenderFlags,
+  ɵsetClassDebugInfo,
   setClassMetadata as ɵsetClassMetadata,
   setClassMetadataAsync as ɵsetClassMetadataAsync,
-  ɵsetClassDebugInfo,
   setLocaleId as ɵsetLocaleId,
+  ɵsetUnknownElementStrictMode,
+  ɵsetUnknownPropertyStrictMode,
   store as ɵstore,
-  ɵDeferBlockDependencyInterceptor,
-  ɵDEFER_BLOCK_DEPENDENCY_INTERCEPTOR,
-  ɵDEFER_BLOCK_CONFIG,
-  BaseDirectiveDebugMetadata as ɵBaseDirectiveDebugMetadata,
-  AngularDirectiveDebugMetadata as ɵAngularDirectiveDebugMetadata,
-  AngularComponentDebugMetadata as ɵAngularComponentDebugMetadata,
-  AcxChangeDetectionStrategy as ɵAcxChangeDetectionStrategy,
-  AcxViewEncapsulation as ɵAcxViewEncapsulation,
-  AcxDirectiveDebugMetadata as ɵAcxDirectiveDebugMetadata,
-  AcxComponentDebugMetadata as ɵAcxComponentDebugMetadata,
   WizComponentDebugMetadata as ɵWizComponentDebugMetadata,
-  DirectiveDebugMetadata as ɵDirectiveDebugMetadata,
   ɵɵadvance,
+  ɵɵanimateEnter,
+  ɵɵanimateEnterListener,
+  ɵɵanimateLeave,
+  ɵɵanimateLeaveListener,
   ɵɵariaProperty,
+  ɵɵarrowFunction,
+  ɵɵattachSourceLocations,
   ɵɵattribute,
-  ɵɵinterpolate,
-  ɵɵinterpolate1,
-  ɵɵinterpolate2,
-  ɵɵinterpolate3,
-  ɵɵinterpolate4,
-  ɵɵinterpolate5,
-  ɵɵinterpolate6,
-  ɵɵinterpolate7,
-  ɵɵinterpolate8,
-  ɵɵinterpolateV,
   ɵɵclassMap,
   ɵɵclassProp,
   ɵɵComponentDeclaration,
+  ɵɵcomponentInstance,
   ɵɵconditional,
-  ɵɵconditionalCreate,
   ɵɵconditionalBranchCreate,
+  ɵɵconditionalCreate,
   ɵɵcontentQuery,
   ɵɵcontentQuerySignal,
   ɵɵcontrol,
   ɵɵcontrolCreate,
-  ɵcontrolUpdate,
-  ɵɵcomponentInstance,
+  ɵɵdeclareLet,
+  ɵɵdefer,
+  ɵɵdeferEnableTimerScheduling,
+  ɵɵdeferHydrateNever,
+  ɵɵdeferHydrateOnHover,
+  ɵɵdeferHydrateOnIdle,
+  ɵɵdeferHydrateOnImmediate,
+  ɵɵdeferHydrateOnInteraction,
+  ɵɵdeferHydrateOnTimer,
+  ɵɵdeferHydrateOnViewport,
+  ɵɵdeferHydrateWhen,
+  ɵɵdeferOnHover,
+  ɵɵdeferOnIdle,
+  ɵɵdeferOnImmediate,
+  ɵɵdeferOnInteraction,
+  ɵɵdeferOnTimer,
+  ɵɵdeferOnViewport,
+  ɵɵdeferPrefetchOnHover,
+  ɵɵdeferPrefetchOnIdle,
+  ɵɵdeferPrefetchOnImmediate,
+  ɵɵdeferPrefetchOnInteraction,
+  ɵɵdeferPrefetchOnTimer,
+  ɵɵdeferPrefetchOnViewport,
+  ɵɵdeferPrefetchWhen,
+  ɵɵdeferWhen,
   ɵɵdefineComponent,
   ɵɵdefineDirective,
   ɵɵdefineNgModule,
   ɵɵdefinePipe,
   ɵɵDirectiveDeclaration,
   ɵɵdirectiveInject,
   ɵɵdisableBindings,
+  ɵɵdomElement,
+  ɵɵdomElementContainer,
+  ɵɵdomElementContainerEnd,
+  ɵɵdomElementContainerStart,
+  ɵɵdomElementEnd,
+  ɵɵdomElementStart,
+  ɵɵdomListener,
+  ɵɵdomProperty,
+  ɵɵdomTemplate,
   ɵɵelement,
   ɵɵelementContainer,
   ɵɵelementContainerEnd,
   ɵɵelementContainerStart,
   ɵɵelementEnd,
   ɵɵelementStart,
-  ɵɵdomElement,
-  ɵɵdomElementStart,
-  ɵɵdomElementEnd,
-  ɵɵdomElementContainer,
-  ɵɵdomElementContainerStart,
-  ɵɵdomElementContainerEnd,
-  ɵɵdomTemplate,
-  ɵɵdomListener,
   ɵɵenableBindings,
+  ɵɵExternalStylesFeature,
   ɵɵFactoryDeclaration,
+  ɵɵgetComponentDepsFactory,
   ɵɵgetCurrentView,
   ɵɵgetInheritedFactory,
-  ɵɵdomProperty,
+  ɵɵgetReplaceMetadataURL,
+  ɵɵHostDirectivesFeature,
   ɵɵi18n,
   ɵɵi18nApply,
   ɵɵi18nAttributes,
@@ -132,6 +168,16 @@ export {
   ɵɵInheritDefinitionFeature,
   ɵɵinjectAttribute,
   ɵɵInjectorDeclaration,
+  ɵɵinterpolate,
+  ɵɵinterpolate1,
+  ɵɵinterpolate2,
+  ɵɵinterpolate3,
+  ɵɵinterpolate4,
+  ɵɵinterpolate5,
+  ɵɵinterpolate6,
+  ɵɵinterpolate7,
+  ɵɵinterpolate8,
+  ɵɵinterpolateV,
   ɵɵinvalidFactory,
   ɵɵlistener,
   ɵɵloadQuery,
@@ -152,7 +198,6 @@ export {
   ɵɵprojectionDef,
   ɵɵproperty,
   ɵɵProvidersFeature,
-  ɵɵHostDirectivesFeature,
   ɵɵpureFunction0,
   ɵɵpureFunction1,
   ɵɵpureFunction2,
@@ -165,50 +210,27 @@ export {
   ɵɵpureFunctionV,
   ɵɵqueryAdvance,
   ɵɵqueryRefresh,
+  ɵɵreadContextLet,
   ɵɵreference,
+  ɵɵrepeater,
+  ɵɵrepeaterCreate,
+  ɵɵrepeaterTrackByIdentity,
+  ɵɵrepeaterTrackByIndex,
+  ɵɵreplaceMetadata,
   ɵɵresetView,
   ɵɵresolveBody,
   ɵɵresolveDocument,
   ɵɵresolveWindow,
   ɵɵrestoreView,
-  ɵɵrepeater,
-  ɵɵrepeaterCreate,
-  ɵɵrepeaterTrackByIdentity,
-  ɵɵrepeaterTrackByIndex,
   ɵɵsetComponentScope,
   ɵɵsetNgModuleScope,
-  ɵɵgetComponentDepsFactory,
-  ɵɵExternalStylesFeature,
+  ɵɵstoreLet,
   ɵɵstyleMap,
   ɵɵstyleProp,
   ɵɵsyntheticHostListener,
   ɵɵsyntheticHostProperty,
   ɵɵtemplate,
   ɵɵtemplateRefExtractor,
-  ɵɵdefer,
-  ɵɵdeferWhen,
-  ɵɵdeferOnIdle,
-  ɵɵdeferOnImmediate,
-  ɵɵdeferOnTimer,
-  ɵɵdeferOnHover,
-  ɵɵdeferOnInteraction,
-  ɵɵdeferOnViewport,
-  ɵɵdeferPrefetchWhen,
-  ɵɵdeferPrefetchOnIdle,
-  ɵɵdeferPrefetchOnImmediate,
-  ɵɵdeferPrefetchOnTimer,
-  ɵɵdeferPrefetchOnHover,
-  ɵɵdeferPrefetchOnInteraction,
-  ɵɵdeferPrefetchOnViewport,
-  ɵɵdeferEnableTimerScheduling,
-  ɵɵdeferHydrateWhen,
-  ɵɵdeferHydrateNever,
-  ɵɵdeferHydrateOnIdle,
-  ɵɵdeferHydrateOnImmediate,
-  ɵɵdeferHydrateOnTimer,
-  ɵɵdeferHydrateOnHover,
-  ɵɵdeferHydrateOnInteraction,
-  ɵɵdeferHydrateOnViewport,
   ɵɵtext,
   ɵɵtextInterpolate,
   ɵɵtextInterpolate1,
@@ -220,30 +242,20 @@ export {
   ɵɵtextInterpolate7,
   ɵɵtextInterpolate8,
   ɵɵtextInterpolateV,
-  ɵɵviewQuery,
-  ɵɵviewQuerySignal,
-  ɵɵtwoWayProperty,
   ɵɵtwoWayBindingSet,
   ɵɵtwoWayListener,
-  ɵgetUnknownElementStrictMode,
-  ɵsetUnknownElementStrictMode,
-  ɵgetUnknownPropertyStrictMode,
-  ɵsetUnknownPropertyStrictMode,
-  ɵɵdeclareLet,
-  ɵɵstoreLet,
-  ɵɵreadContextLet,
-  ɵɵreplaceMetadata,
-  ɵɵgetReplaceMetadataURL,
-  ɵɵattachSourceLocations,
-  ɵɵanimateEnter,
-  ɵɵanimateEnterListener,
-  ɵɵanimateLeave,
-  ɵɵanimateLeaveListener,
-  ɵɵarrowFunction,
+  ɵɵtwoWayProperty,
+  ɵɵviewQuery,
+  ɵɵviewQuerySignal,
 } from './render3/index';
 export {CONTAINER_HEADER_OFFSET as ɵCONTAINER_HEADER_OFFSET} from './render3/interfaces/container';
 export {LContext as ɵLContext} from './render3/interfaces/context';
-export {ɵCONTROL, ɵControl, ɵFieldState, ɵInteropControl} from './render3/interfaces/control';
+export {
+  ɵCONTROL,
+  ɵFieldState,
+  ɵFormFieldDirective,
+  ɵInteropControl,
+} from './render3/interfaces/control';
 export {setDocument as ɵsetDocument} from './render3/interfaces/document';
 export {
   compileComponent as ɵcompileComponent,
@@ -254,6 +266,7 @@ export {
   compileNgModule as ɵcompileNgModule,
   compileNgModuleDefs as ɵcompileNgModuleDefs,
   flushModuleScopingQueueAsMuchAsPossible as ɵflushModuleScopingQueueAsMuchAsPossible,
+  generateStandaloneInDeclarationsError as ɵgenerateStandaloneInDeclarationsError,
   patchComponentDefWithScope as ɵpatchComponentDefWithScope,
   resetCompiledComponents as ɵresetCompiledComponents,
   transitiveScopesFor as ɵtransitiveScopesFor,
@@ -272,20 +285,17 @@ export {
 } from './render3/jit/partial';
 export {compilePipe as ɵcompilePipe} from './render3/jit/pipe';
 export {isNgModule as ɵisNgModule} from './render3/jit/util';
-export {
-  Profiler as ɵProfiler,
-  ProfilerEvent as ɵProfilerEvent,
-  Framework as ɵFramework,
-} from '../primitives/devtools';
+export {getAsyncClassMetadataFn as ɵgetAsyncClassMetadataFn} from './render3/metadata';
+export {DeferBlockData as ɵDeferBlockData} from './render3/util/defer';
 export {
   FrameworkAgnosticGlobalUtils as ɵFrameworkAgnosticGlobalUtils,
   GlobalDevModeUtils as ɵGlobalDevModeUtils,
 } from './render3/util/global_utils';
 export {getTransferState as ɵgetTransferState} from './render3/util/transfer_state_utils';
 export {
-  ViewRef as ɵViewRef,
   isViewDirty as ɵisViewDirty,
   markForRefresh as ɵmarkForRefresh,
+  ViewRef as ɵViewRef,
 } from './render3/view_ref';
 export {
   bypassSanitizationTrustHtml as ɵbypassSanitizationTrustHtml,
@@ -306,8 +316,3 @@ export {
   ɵɵvalidateAttribute,
 } from './sanitization/sanitization';
 export {noSideEffects as ɵnoSideEffects} from './util/closure';
-export {AfterRenderManager as ɵAfterRenderManager} from './render3/after_render/manager';
-export {depsTracker as ɵdepsTracker} from './render3/deps_tracker/deps_tracker';
-export {generateStandaloneInDeclarationsError as ɵgenerateStandaloneInDeclarationsError} from './render3/jit/module';
-export {getAsyncClassMetadataFn as ɵgetAsyncClassMetadataFn} from './render3/metadata';
-export {DeferBlockData as ɵDeferBlockData} from './render3/util/defer';