@ng-forge/dynamic-forms 1.0.0-rc.1 → 1.0.0-rc.3

package/types/ng-forge-dynamic-forms.d.ts

@@ -1,14 +1,13 @@
 import * as rxjs from 'rxjs';
 import * as _angular_core from '@angular/core';
-import { Type, Injector, Signal, EnvironmentInjector, WritableSignal, Provider, EnvironmentProviders, TemplateRef, InjectionToken } from '@angular/core';
+import { Type, Injector, Signal, EnvironmentInjector, WritableSignal, Provider, EnvironmentProviders, TemplateRef } from '@angular/core';
 import * as _ng_forge_dynamic_forms_internal from '@ng-forge/dynamic-forms/internal';
-import { FieldDef, FormEvent, RegisteredFieldTypes, InferFormValue as InferFormValue$1, FormConfig, FormOptions, EventBus, LazyComponentLoader, WrapperTypeDefinition, FieldTypeDefinition, DerivationLogLevel, Logger, ValueExclusionConfig, ValidationExecutionConfig, AnyAddon, WrapperFieldInputs, TextAddon, TemplateAddon, ComponentAddon, AddonActionPreset, AddonActionContext, AddonKindDefinition, FieldAddonSupport, BaseAddon, ArrayItemDefinition, NarrowFields, AvailableFieldTypes, ExtractField } from '@ng-forge/dynamic-forms/internal';
-export { ADDON_KIND_REGISTRY, AddonActionContext, AddonActionPreset, AddonKindDefinition, AddonKindSchema, AddonShapeValidator, AddonSlot, AnyAddon, ArrayAllowedChildren, ArrayButtonConfig, ArrayField, ArrayItemTemplate, AsyncCondition, AsyncConditionFunction, AsyncCustomValidator, AsyncDerivationFunction, AsyncValidatorConfig, AvailableFieldTypes, BaseAddon, BaseCheckedField, BaseValidatorConfig, BaseValueField, BuiltInValidatorConfig, ButtonLogicContext, CheckedFieldComponent, CommonAddonActionPreset, CommonAddonSlot, ComponentAddon, ConditionalExpression, ContainerAllowedChildren, ContainerField, ContainerFieldTypes, CssWrapper, CustomFnConfig, CustomFunction, CustomValidator, CustomValidatorConfig, DF_FIELD_TEMPLATES, DeclarativeHttpValidatorConfig, DynamicFormActionRegistry, DynamicFormAddonActionPresetRegistry, DynamicFormAddonRegistry, DynamicFormAddonSlotRegistry, DynamicFormError, DynamicFormFieldRegistry, DynamicFormLogger, DynamicText, DynamicValue, EvaluationContext, ExtractField, FieldAddonSupport, FieldBoundAddonActionContext, FieldComponent, FieldDef, FieldMeta, FieldOption, FieldPathAccess, FieldRegistryContainers, FieldRegistryLeaves, FieldRegistryWrappers, FieldWithValidation, FieldWrapper, FormConfig, FormEvent, FormEventConstructor, FormMode, FormModeDetectionResult, FormOptions, FormStateCondition, GroupAllowedChildren, GroupField, HttpCondition, HttpCustomValidator, HttpRequestConfig, HttpValidationResponseMapping, InferFormValue, LeafFieldTypes, Logger, LogicConfig, NarrowField, NarrowFields, NextButtonOptions, NonFieldLogicConfig, NonFieldLogicContext, NonFieldLogicType, NoopLogger, OrphanAddonActionContext, PageAllowedChildren, PageField, Prettify, RegisteredActionRef, RegisteredFieldTypes, ResolvedValidationExecutionConfig, ResolvedValueExclusionConfig, RowAllowedChildren, RowField, SchemaApplicationConfig, SchemaDefinition, SimplifiedArrayField, StateLogicConfig, SubmissionActionResult, SubmissionConfig, SubmitButtonOptions, TemplateAddon, TextAddon, TextElementType, TextField, TextProps, TokenContext, ValidationError, ValidationExecutionConfig, ValidationMessages, ValidatorConfig, ValueExclusionConfig, ValueFieldComponent, ValueType, WRAPPER_REGISTRY, WithInputSignals, WrapperConfig, WrapperTypeDefinition, evaluateNonFieldDisabled, evaluateNonFieldHidden, hasFormValue, isArrayField, isCheckedField, isContainerField, isContainerTypedField, isDisplayOnlyField, isFieldBoundContext, isFormStateCondition, isGroupField, isLeafField, isPageField, isRowField, isSimplifiedArrayField, isValueBearingField, isValueField, isWrapperTypeDefinition, resolveDynamicValue, resolveNextButtonDisabled, resolveNonFieldDisabled, resolveNonFieldHidden, resolveSubmitButtonDisabled } from '@ng-forge/dynamic-forms/internal';
+import { FieldDef, FormEvent, RegisteredFieldTypes, InferFormModel, FormConfig, FormOptions, EventBus, LazyComponentLoader, WrapperTypeDefinition, FieldTypeDefinition, InferFormValue as InferFormValue$1, DerivationLogLevel, Logger, ValueExclusionConfig, ValidationExecutionConfig, TextAddon, WrapperFieldInputs, TemplateAddon, ComponentAddon, BaseAddon, AddonTypeDefinition, AddonActionHandler, ArrayItemDefinition } from '@ng-forge/dynamic-forms/internal';
+export { AddonActionContext, AddonActionPreset, AddonSlot, AddonTypeDefinition, AnyAddon, ArrayAllowedChildren, ArrayButtonConfig, ArrayField, ArrayItemTemplate, AsyncCondition, AsyncConditionFunction, AsyncCustomValidator, AsyncDerivationFunction, AsyncValidatorConfig, AvailableFieldTypes, BaseAddon, BaseCheckedField, BaseValidatorConfig, BaseValueField, BuiltInValidatorConfig, CheckedFieldComponent, CommonAddonActionPreset, CommonAddonSlot, ComponentAddon, ConditionalExpression, ContainerAllowedChildren, ContainerField, ContainerFieldTypes, CssWrapper, CustomFnConfig, CustomFunction, CustomValidator, CustomValidatorConfig, DF_FIELD_TEMPLATES, DeclarativeHttpValidatorConfig, DynamicFormActionRegistry, DynamicFormAddonActionPresetRegistry, DynamicFormAddonRegistry, DynamicFormAddonSlotRegistry, DynamicFormError, DynamicFormFieldRegistry, DynamicFormLogger, DynamicText, DynamicValue, EvaluationContext, ExtractField, FieldBoundAddonActionContext, FieldComponent, FieldDef, FieldMeta, FieldOption, FieldPathAccess, FieldRegistryContainers, FieldRegistryLeaves, FieldRegistryWrappers, FieldWithValidation, FieldWrapper, FormConfig, FormEvent, FormEventConstructor, FormMode, FormModeDetectionResult, FormOptions, FormStateCondition, GroupAllowedChildren, GroupField, HiddenField, HiddenScalar, HiddenValue, HttpCondition, HttpCustomValidator, HttpRequestConfig, HttpValidationResponseMapping, InferFormValue, LeafFieldTypes, Logger, LogicConfig, NarrowField, NarrowFields, NextButtonOptions, NoopLogger, OrphanAddonActionContext, PageAllowedChildren, PageField, RegisteredActionRef, RegisteredFieldTypes, ResolvedValidationExecutionConfig, ResolvedValueExclusionConfig, RowAllowedChildren, RowField, SchemaApplicationConfig, SchemaDefinition, SimplifiedArrayField, StateLogicConfig, SubmissionActionResult, SubmissionConfig, SubmitButtonOptions, TemplateAddon, TextAddon, TextElementType, TextField, TextProps, TokenContext, ValidationError, ValidationExecutionConfig, ValidationMessages, ValidatorConfig, ValueExclusionConfig, ValueFieldComponent, ValueType, WithInputSignals, WrapperConfig, WrapperTypeDefinition, hasFormValue, isArrayField, isContainerField, isDisplayOnlyField, isFieldBoundContext, isFormStateCondition, isGroupField, isHiddenField, isLeafField, isPageField, isRowField, isSimplifiedArrayField, isValueBearingField, isWrapperTypeDefinition, resolveDynamicValue } from '@ng-forge/dynamic-forms/internal';
 import * as _angular_forms_signals from '@angular/forms/signals';
 import { FieldTree } from '@angular/forms/signals';
 import * as _angular_forms from '@angular/forms';
 import * as _ng_forge_dynamic_forms from '@ng-forge/dynamic-forms';
-import { FormSchema } from '@ng-forge/dynamic-forms/schema';
 
 /** Resolved field ready for rendering with ngComponentOutlet / DfFieldOutlet. */
 interface ResolvedField {
@@ -47,6 +46,7 @@ declare class FormResetEvent implements FormEvent {
     readonly type: "form-reset";
 }
 
+/** Event emitted when the active page of a paged form changes. */
 declare class PageChangeEvent implements FormEvent {
     /** The current page index (0-based) */
     readonly currentPageIndex: number;
@@ -85,19 +85,45 @@ declare class PageNavigationStateChangeEvent implements FormEvent {
 }
 
 /**
- * Dynamic form component — renders a form based on configuration.
- * Delegates state management to `FormStateManager`.
+ * Renders a form from a {@link FormConfig}. Attribute component on a native
+ * `<form>` element (selector `form[dynamic-form]`); state management is
+ * delegated to `FormStateManager`.
+ *
+ * Provide a UI adapter once via {@link provideDynamicForm} (for example
+ * `provideDynamicForm(...withMaterialFields())`), then bind a config and
+ * listen for `submitted`. Field-value types are inferred from the config when
+ * it is authored with `as const satisfies FormConfig`.
+ *
+ * @example
+ * ```ts
+ * @Component({
+ *   imports: [DynamicForm],
+ *   template: `<form [dynamic-form]="config" (submitted)="onSubmit($event)"></form>`,
+ * })
+ * export class SignInComponent {
+ *   config = {
+ *     fields: [
+ *       { key: 'email', type: 'input', value: '', label: 'Email', required: true, email: true },
+ *       { type: 'submit', key: 'submit', label: 'Sign in' },
+ *     ],
+ *   } as const satisfies FormConfig;
+ *
+ *   onSubmit(value: InferFormValue<typeof this.config.fields>) {
+ *     console.log(value); // inferred: { email: string }
+ *   }
+ * }
+ * ```
  */
-declare class DynamicForm<TFields extends RegisteredFieldTypes[] = RegisteredFieldTypes[], TModel extends Record<string, unknown> = InferFormValue$1<TFields> & Record<string, unknown>> {
+declare class DynamicForm<TFields extends RegisteredFieldTypes[] = RegisteredFieldTypes[], TModel extends Record<string, unknown> = InferFormModel<TFields>> {
     /** Form configuration defining the structure, validation, and behavior. */
-    config: _angular_core.InputSignal<FormConfig<TFields, InferFormValue$1<TFields extends readonly RegisteredFieldTypes[] ? TFields : RegisteredFieldTypes[]>, Record<string, unknown>, unknown>>;
+    config: _angular_core.InputSignal<FormConfig<TFields, _ng_forge_dynamic_forms.InferFormValue<TFields extends readonly RegisteredFieldTypes[] ? TFields : RegisteredFieldTypes[]>, Record<string, unknown>, unknown>>;
     /** Runtime form options that override config options when provided. */
     formOptions: _angular_core.InputSignal<FormOptions | undefined>;
     /** Form values for two-way data binding. */
     value: _angular_core.ModelSignal<Partial<TModel> | undefined>;
     /**
      * How lenient the addon validator is on `config.fields[...].addons`.
-     * `'inline'` (default) keeps everything; `'json'` drops code-only kinds
+     * `'inline'` (default) keeps everything; `'json'` drops code-only types
      * with a warning. Read at form init and on every config swap — change
      * `source` AND the config to force re-validation mid-flight.
      */
@@ -122,7 +148,7 @@ declare class DynamicForm<TFields extends RegisteredFieldTypes[] = RegisteredFie
     protected readonly idPrefix: Signal<string>;
     private componentId;
     /** The currently active config used for form rendering */
-    activeConfig: Signal<FormConfig<TFields, InferFormValue$1<TFields extends readonly RegisteredFieldTypes[] ? TFields : RegisteredFieldTypes[]>, Record<string, unknown>, unknown> | undefined>;
+    activeConfig: Signal<FormConfig<TFields, _ng_forge_dynamic_forms.InferFormValue<TFields extends readonly RegisteredFieldTypes[] ? TFields : RegisteredFieldTypes[]>, Record<string, unknown>, unknown> | undefined>;
     /** Current render phase: 'render' = showing form, 'teardown' = hiding old components */
     renderPhase: Signal<"teardown" | "render">;
     /** Computed form mode detection with validation */
@@ -181,8 +207,8 @@ declare class DynamicForm<TFields extends RegisteredFieldTypes[] = RegisteredFie
     validityChange: _angular_core.OutputRef<boolean>;
     /** Emits when form dirty state changes. */
     dirtyChange: _angular_core.OutputRef<boolean>;
-    /** Emits form values when submitted (via SubmitEvent) and form is valid. */
-    submitted: _angular_core.OutputRef<Partial<TModel>>;
+    /** Emits form values when submitted (via FormSubmitEvent) and form is valid. */
+    submitted: _angular_core.OutputRef<TModel>;
     /** Emits when form is reset to default values. */
     reset: _angular_core.OutputRef<FormResetEvent>;
     /** Emits when form is cleared to empty state. */
@@ -452,77 +478,6 @@ declare function withLegacyStatusClasses(): DynamicFormFeature<'legacy-status-cl
 /** Zero-cost type carrier used in wrapper registrations. */
 declare function wrapperProps<T>(): T;
 
-/**
- * Dispatcher component that renders an addon by looking up its `kind` in
- * `ADDON_KIND_REGISTRY` and instantiating the registered component.
- */
-declare class DfAddonSlot {
-    private readonly registry;
-    private readonly logger;
-    private readonly hostInjector;
-    readonly addon: _angular_core.InputSignal<AnyAddon>;
-    /**
-     * Optional read-only view of the host field's mapped inputs — same shape
-     * wrappers receive (`field?: ReadonlyFieldTree`, `key`, `props`, etc.).
-     * Forwarded to kind components so they can read field state without
-     * re-injecting `FIELD_SIGNAL_CONTEXT` and rebuilding context themselves.
-     */
-    readonly fieldInputs: _angular_core.InputSignal<WrapperFieldInputs | undefined>;
-    /**
-     * Pre-resolved `hidden` signal supplied by the host field. When provided,
-     * the dispatcher reads this instead of re-resolving `addon.hidden` —
-     * lets the host (e.g., `prime-input`) share a single subscription per
-     * Observable-typed `hidden` between its own visibility filter and the
-     * slot's `[style.display]` binding.
-     */
-    readonly hidden: _angular_core.InputSignal<Signal<boolean> | undefined>;
-    /** `slot` HTML attribute forwarded to host — needed for Ionic shadow projection. */
-    protected readonly slotAttr: Signal<_ng_forge_dynamic_forms.AddonSlot>;
-    protected readonly className: Signal<string | null>;
-    /**
-     * Locally-resolved `hidden` signal — always reflects `addon.hidden`
-     * regardless of whether the host supplied a pre-resolved signal.
-     * Populated via `explicitEffect` so `resolveDynamicValue` (which may call
-     * `toSignal` for Observable-typed values) does NOT run inside a reactive
-     * context (NG0602). The WeakMap caches per `hidden`-value identity, so
-     * swapping `addon` inputs that share the same Observable reuses the
-     * subscription instead of leaking a fresh one per swap.
-     */
-    private readonly _hiddenByValue;
-    private readonly _resolvedHidden;
-    /**
-     * `hidden` resolved from `DynamicValue<boolean>` to a flat `Signal<boolean>`.
-     * Prefers the host-supplied signal when present (avoids duplicate `toSignal`
-     * subscriptions for Observable-typed `hidden`); falls back to the locally-
-     * resolved signal, which is always populated by the addon-tracking effect.
-     */
-    protected readonly isHidden: Signal<boolean>;
-    /**
-     * Latest async-loaded `{ kind, component }` pair. Tagging the result with
-     * its kind lets `resolvedComponent` filter stale loads structurally — no
-     * monotonic token needed. When `addon.kind` changes mid-load, the prior
-     * load still completes and writes here, but the computed ignores it
-     * because the recorded kind no longer matches the current one.
-     */
-    private readonly asyncLoaded;
-    /**
-     * Resolved kind component — composed declaratively from two sources of
-     * truth: the registry's synchronous cache (warm hits, e.g., a second
-     * `<df-addon-slot>` for an already-loaded kind) and the kind-tagged async
-     * loader result. Reading `addon().kind` first makes the computed react to
-     * addon swaps and naturally invalidate stale async-load results.
-     */
-    protected readonly resolvedComponent: Signal<Type<unknown> | undefined>;
-    /** Inputs passed to the kind component — addon plus the wrapper-style host bag. */
-    protected readonly kindInputs: Signal<{
-        addon: AnyAddon;
-        fieldInputs: WrapperFieldInputs | undefined;
-    }>;
-    constructor();
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DfAddonSlot, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DfAddonSlot, "df-addon-slot", never, { "addon": { "alias": "addon"; "required": true; "isSignal": true; }; "fieldInputs": { "alias": "fieldInputs"; "required": false; "isSignal": true; }; "hidden": { "alias": "hidden"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
 /**
  * Marks an `<ng-template>` projected into `<df-dynamic-form>` content as
  * available to template addons by name.
@@ -536,7 +491,7 @@ declare class DfTemplate {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DfTemplate, "ng-template[dfTemplate]", ["dfTemplate"], { "dfTemplate": { "alias": "dfTemplate"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-/** Renderer for the universal `text` addon kind. */
+/** Renderer for the universal `text` addon type. */
 declare class TextAddonComponent {
     readonly addon: _angular_core.InputSignal<TextAddon>;
     /** Accepted for contract uniformity — `NgComponentOutlet` setInput is strict; every kind must declare it. */
@@ -545,7 +500,7 @@ declare class TextAddonComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<TextAddonComponent, "df-text-addon", never, { "addon": { "alias": "addon"; "required": true; "isSignal": true; }; "fieldInputs": { "alias": "fieldInputs"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-/** Renderer for the universal `template` addon kind. */
+/** Renderer for the universal `template` addon type. */
 declare class TemplateAddonComponent {
     private readonly templates;
     private readonly logger;
@@ -563,7 +518,7 @@ declare class TemplateAddonComponent {
 }
 
 /**
- * Renderer for the universal `component` addon kind.
+ * Renderer for the universal `component` addon type.
  *
  * @codeOnly The `component` loader is a function; this kind is dropped in
  * lenient validation when the config originated from JSON.
@@ -589,107 +544,11 @@ declare class ComponentAddonComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ComponentAddonComponent, "df-component-addon", never, { "addon": { "alias": "addon"; "required": true; "isSignal": true; }; "fieldInputs": { "alias": "fieldInputs"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-/**
- * Optional collaborators a preset may need beyond the base context. Passed
- * by the button kind component which has access to its own DI scope.
- */
-interface PresetCollaborators {
-    /** Per-field input-type override signal — populated only inside an input field. */
-    readonly typeOverride?: WritableSignal<string | undefined>;
-    /** Writer that pushes a value into the host field's tree. */
-    readonly fieldValueSetter?: (next: unknown) => void;
-    /**
-     * Read the host field's configured default value (from the form's
-     * `defaultValues` map keyed by `field.key`). Used by the `'reset'`
-     * preset; absent when the addon is rendered outside an active field
-     * context, in which case `'reset'` falls back to clearing.
-     */
-    readonly fieldDefaultValueGetter?: () => unknown;
-    /**
-     * Baseline configured input type (from `props().type`), read at preset-run
-     * time. Used by `toggle-password-visibility` to refuse to corrupt
-     * `'email'`/`'number'`/etc. inputs into `'password'` when no override is
-     * yet set.
-     */
-    readonly baselineType?: () => string | undefined;
-    /** Logger for warnings about presets that can't be fulfilled in this context. */
-    readonly logger: Logger;
-}
-/**
- * Apply a built-in preset action against the addon's host field. Shared
- * across all adapters — each adapter's `ADDON_PRESET_HANDLER` provider
- * delegates here.
- *
- * @param adapterLabel Used in warnings — `'Material'` / `'Bootstrap'` / etc.
- * @param fieldLabel   Used in warnings — `'mat-input'` / `'bs-input'` / etc.
- */
-declare function runPresetAction(preset: AddonActionPreset, ctx: AddonActionContext, collaborators: PresetCollaborators, adapterLabel: string, fieldLabel: string): Promise<void>;
-
-/**
- * Cache for resolved addon-kind components.
- *
- * @internal
- */
-declare const ADDON_KIND_COMPONENT_CACHE: InjectionToken<Map<string, Type<unknown>>>;
-/**
- * Public shape returned by {@link injectAddonKindRegistry}. Pinned explicitly
- * so the API extractor doesn't churn between versions when the inner factory
- * gets refactored.
- */
-interface AddonKindRegistryRef {
-    getKind(kind: string): AddonKindDefinition | undefined;
-    hasKind(kind: string): boolean;
-    getKindNames(): string[];
-    loadKindComponent(kind: string): Promise<Type<unknown>>;
-    getLoadedKindComponent(kind: string): Type<unknown> | undefined;
-    readonly raw: ReadonlyMap<string, AddonKindDefinition>;
-}
-/** Injection function for accessing the addon kind registry. */
-declare function injectAddonKindRegistry(): AddonKindRegistryRef;
-
-/** One entry per field type that declares addon support. */
-interface FieldAddonSupportEntry {
-    readonly name: string;
-    readonly slots: FieldAddonSupport['slots'];
-    readonly allowedKinds: FieldAddonSupport['allowedKinds'];
-}
-/**
- * Walk `FIELD_REGISTRY` and return every field type that opted into addons
- * (i.e., declared `addons` on its `FieldTypeDefinition`).
- *
- * @Component({ ... })
- * class FormBuilder {
- *   protected readonly addonable = injectFieldsSupportingAddons();
- *
- *   constructor() {
- *     // -> [{ name: 'prime-input', slots: ['prefix', 'suffix'], allowedKinds: [...] }, ...]
- *   }
- * }
- * ```
- */
-declare function injectFieldsSupportingAddons(): FieldAddonSupportEntry[];
-
-/** Register a custom addon kind with the form. */
-declare function withCustomAddon<T extends BaseAddon>(definition: AddonKindDefinition<T>): DynamicFormFeature<'addons'>;
+/** Register a custom addon type with the form. */
+declare function withCustomAddon<T extends BaseAddon>(definition: AddonTypeDefinition<T>): DynamicFormFeature<'addons'>;
 
-/** Handler signature for user-registered addon actions. */
-type AddonActionHandler<TValue = unknown> = (ctx: AddonActionContext<TValue>) => void;
-/**
- * Multi-provider token populated by `provideAddonActions({...})` calls.
- * `ADDON_ACTION_REGISTRY` aggregates these into a single name → handler map.
- *
- * @internal
- */
-declare const ADDON_ACTION_HANDLERS: InjectionToken<readonly Record<string, AddonActionHandler<unknown>>[]>;
 /**
- * Form-scoped name → handler map. Read by adapter button kinds at click
- * time for `actionRef: 'name'` lookups. Provided at form scope (not root)
- * because `ADDON_ACTION_HANDLERS` is form-scoped via `provideAddonActions`.
- */
-declare const ADDON_ACTION_REGISTRY: InjectionToken<ReadonlyMap<string, AddonActionHandler<unknown>>>;
-
-/**
- * Typed feature returned by {@link provideAddonActions}. Carries the
+ * Typed feature returned by {@link withAddonActions}. Carries the
  * registered handler keys as a phantom type so consumers can derive the
  * `DynamicFormActionRegistry` augmentation in one line instead of hand-typing
  * every key.
@@ -699,16 +558,7 @@ type AddonActionsFeature<K extends string = string> = DynamicFormFeature<'addon-
     readonly __handlerKeys?: K;
 };
 /** Register named action handlers reachable via JSON-driven addon configs. */
-declare function provideAddonActions<const H extends Record<string, AddonActionHandler>>(handlers: H): AddonActionsFeature<keyof H & string>;
-
-/**
- * Multi-provider token used by `withCustomAddon(...)` features to contribute
- * addon kind definitions. `provideDynamicForm` aggregates all values into
- * the form-scoped `ADDON_KIND_REGISTRY` map.
- *
- * @internal
- */
-declare const ADDON_KIND_DEFINITIONS: InjectionToken<readonly AddonKindDefinition<_ng_forge_dynamic_forms.BaseAddon<_ng_forge_dynamic_forms.AddonSlot>>[]>;
+declare function withAddonActions<const H extends Record<string, AddonActionHandler>>(handlers: H): AddonActionsFeature<keyof H & string>;
 
 /** Reason an addon was dropped during validation. */
 type AddonWarning = {
@@ -726,55 +576,30 @@ type AddonWarning = {
     slot: string;
     allowedSlots: readonly string[];
 } | {
-    type: 'unknown-kind';
+    type: 'unknown-type';
     fieldKey: string;
-    kind: string;
-    registeredKinds: readonly string[];
+    addonType: string;
+    registeredTypes: readonly string[];
 } | {
-    type: 'kind-not-allowed';
+    type: 'type-not-allowed';
     fieldKey: string;
     fieldType: string;
-    kind: string;
-    allowedKinds: readonly string[];
+    addonType: string;
+    allowedTypes: readonly string[];
 } | {
     type: 'shape-violation';
     fieldKey: string;
-    kind: string;
+    addonType: string;
     reason: string;
 } | {
-    type: 'code-only-kind-in-json';
+    type: 'code-only-type-in-json';
     fieldKey: string;
-    kind: string;
+    addonType: string;
 } | {
     type: 'code-only-action-in-json';
     fieldKey: string;
     reason: string;
 };
-/** Render an `AddonWarning` to a developer-friendly message. */
-declare function formatAddonWarning(w: AddonWarning): string;
-
-/**
- * Walk a field's addons; return the survivors plus a list of warnings for
- * anything dropped.
- *
- * @param field        The field to validate.
- * @param fieldRegistry Snapshot of `FIELD_REGISTRY` map.
- * @param kindRegistry  Snapshot of `ADDON_KIND_REGISTRY` map.
- * @param source       Whether the config originated from JSON (lenient drop
- *                      of code-only kinds) or inline TypeScript.
- */
-declare function validateFieldAddons(field: FieldDef<unknown>, fieldRegistry: ReadonlyMap<string, FieldTypeDefinition>, kindRegistry: ReadonlyMap<string, AddonKindDefinition>, source: 'json' | 'inline'): {
-    addons: AnyAddon[];
-    warnings: AddonWarning[];
-};
-/**
- * Recursively walk a field tree, validating each field's addons. Returns a
- * sanitized copy of the input field array plus accumulated warnings.
- */
-declare function walkAndValidateAddons(fields: readonly FieldDef<unknown>[], fieldRegistry: ReadonlyMap<string, FieldTypeDefinition>, kindRegistry: ReadonlyMap<string, AddonKindDefinition>, source: 'json' | 'inline'): {
-    fields: FieldDef<unknown>[];
-    warnings: AddonWarning[];
-};
 
 /** Options accepted by {@link sanitizeFormConfig}. */
 interface SanitizeFormConfigOptions {
@@ -793,7 +618,7 @@ interface SanitizedFormConfig {
 }
 /**
  * Walk a `FormConfig`, validate every field's addons against the active
- * `FIELD_REGISTRY` and `ADDON_KIND_REGISTRY`, and return a sanitized copy
+ * `FIELD_REGISTRY` and `ADDON_TYPE_REGISTRY`, and return a sanitized copy
  * plus a list of dropped-addon warnings.
  *
  * @Component({ ... })
@@ -809,28 +634,18 @@ interface SanitizedFormConfig {
  * ```
  */
 declare function sanitizeFormConfig(config: FormConfig, options?: SanitizeFormConfigOptions): SanitizedFormConfig;
-/**
- * Default warning sink. Pass a `DynamicFormLogger` to route through the
- * form's configured logger (respects `NoopLogger` opt-out); omit it to
- * fall back to `console.warn` for build-time / admin-UI use cases that
- * run outside an Angular injection context.
- */
-declare function logAddonWarnings(warnings: readonly AddonWarning[], logger?: Logger): void;
-/**
- * DI-free variant of {@link sanitizeFormConfig} for tooling that lives
- * outside Angular's injector — build-time linters, MCP-side checks, CLI
- * scripts.
- */
-declare function sanitizeFormConfigPure(config: FormConfig, fieldRegistry: ReadonlyMap<string, _ng_forge_dynamic_forms_internal.FieldTypeDefinition>, kindRegistry: ReadonlyMap<string, _ng_forge_dynamic_forms_internal.AddonKindDefinition>, options?: SanitizeFormConfigOptions): SanitizedFormConfig;
 
-declare class SubmitEvent implements FormEvent {
+/** Event dispatched to submit the form (the action behind a `submit` button). */
+declare class FormSubmitEvent implements FormEvent {
     readonly type: "submit";
 }
 
+/** Event dispatched to advance a paged form to the next page. */
 declare class NextPageEvent implements FormEvent {
     readonly type: "next-page";
 }
 
+/** Event dispatched to return a paged form to the previous page. */
 declare class PreviousPageEvent implements FormEvent {
     readonly type: "previous-page";
 }
@@ -1063,29 +878,5 @@ interface ArrayItemContext {
     formValue?: unknown;
 }
 
-/**
- * Type-safe form config builder that ensures schema matches field structure.
- *
- * @typeParam TFields - The field definitions array (narrowed via `as const`)
- * @typeParam TProps - Optional form-level default props type
- * @param config - The form configuration object
- * @returns The same configuration with proper type inference
- */
-declare function formConfig<const TFields extends NarrowFields, TProps extends object = Record<string, unknown>>(config: Omit<FormConfig<TFields, InferFormValue$1<TFields>, TProps>, 'schema'> & {
-    schema?: FormSchema<InferFormValue$1<TFields>>;
-}): FormConfig<TFields, InferFormValue$1<TFields>, TProps>;
-
-/**
- * Creates a typed field configuration with helpful error messages for common mistakes.
- *
- * @param type - The field type (e.g., 'input', 'select', 'group')
- * @param config - The field configuration (excluding the 'type' property)
- * @returns A properly typed field configuration
- * @throws DynamicFormError if the configuration contains common mistakes
- */
-declare function createField<T extends AvailableFieldTypes>(type: T, config: Omit<ExtractField<T>, 'type'>): ExtractField<T>;
-/** Shorthand alias for createField */
-declare const field: typeof createField;
-
-export { ADDON_ACTION_HANDLERS, ADDON_ACTION_REGISTRY, ADDON_KIND_COMPONENT_CACHE, ADDON_KIND_DEFINITIONS, AppendArrayItemEvent, BUILT_IN_FIELDS, ComponentAddonComponent, ConsoleLogger, DfAddonSlot, DfTemplate, DynamicForm, EventDispatcher, FormClearEvent, FormResetEvent, InsertArrayItemEvent, MoveArrayItemEvent, NextPageEvent, PageChangeEvent, PopArrayItemEvent, PrependArrayItemEvent, PreviousPageEvent, RemoveAtIndexEvent, ShiftArrayItemEvent, SubmitEvent, TemplateAddonComponent, TextAddonComponent, arrayEvent, createField, createWrappers, field, formConfig, formatAddonWarning, injectAddonKindRegistry, injectFieldsSupportingAddons, isWrappersBundle, logAddonWarnings, provideAddonActions, provideDynamicForm, runPresetAction, sanitizeFormConfig, sanitizeFormConfigPure, validateFieldAddons, walkAndValidateAddons, withCustomAddon, withEventFormValue, withLegacyStatusClasses, withLoggerConfig, withValidationExecutionDefaults, withValueExclusionDefaults, wrapperProps };
-export type { AddonActionHandler, AddonActionsFeature, AddonWarning, ArrayItemContext, ArrayItemDefinitionTemplate, ExtractFieldDefs, ExtractFormValue, FieldAddonSupportEntry, InferWrapperRegistry, PresetCollaborators, SanitizeFormConfigOptions, SanitizedFormConfig, WrapperRegistration, WrappersBundle };
+export { AppendArrayItemEvent, BUILT_IN_FIELDS, ComponentAddonComponent, ConsoleLogger, DfTemplate, DynamicForm, EventDispatcher, FormClearEvent, FormResetEvent, FormSubmitEvent, InsertArrayItemEvent, MoveArrayItemEvent, NextPageEvent, PageChangeEvent, PopArrayItemEvent, PrependArrayItemEvent, PreviousPageEvent, RemoveAtIndexEvent, ShiftArrayItemEvent, TemplateAddonComponent, TextAddonComponent, arrayEvent, createWrappers, isWrappersBundle, provideDynamicForm, sanitizeFormConfig, withAddonActions, withCustomAddon, withEventFormValue, withLegacyStatusClasses, withLoggerConfig, withValidationExecutionDefaults, withValueExclusionDefaults, wrapperProps };
+export type { AddonActionsFeature, AddonWarning, ArrayItemContext, ArrayItemDefinitionTemplate, ExtractFieldDefs, ExtractFormValue, InferWrapperRegistry, SanitizeFormConfigOptions, SanitizedFormConfig, WrapperRegistration, WrappersBundle };

package/fesm2022/ng-forge-dynamic-forms-group-field.component-Bz4GD8Hy.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"ng-forge-dynamic-forms-group-field.component-Bz4GD8Hy.mjs","mappings":";;;;;;;;;AA0Dc;YAKK;;;;AAIA;AACE;AACF;AACA;YAMA;;;;;AAQjB;;;;YAOS;;;;AAIQ;AACf;AACA;AAEA;AACE;AACA;;AAEA;;AAGE;AACA;;;;;;;AAQF;AACA;AACA;AACA;;;;;;;AAOJ,IAKiB;;;AAIb;;AAEA;AACF;AAEE;AACA;AACD;AAGc;AACf;AACE;;AAGE;AACA;;AAGF;AACF;;;;;AAQO;;AACA;;AACA;;AACA;;AACA;;AACA;;AAEQ;AACf;;AAEA;;;;AAIA;;;AAGE;;AAEA;AACE;;;;AAKN,IAMiB;AACf;;;AAGE;AACF;;AAGe;;AAEf;;;AAGC;AACF;;;AAQQ;;;AAQU;AAGf;AACA;;;AAGA;AACE;;;;AAOH;YAQH;;;;;AAWE;;AAIM;;AAIJ;;;AA/Me;;;;;;AAhBlB;;;;AARS;;;;;;;AAWR;AACA;AACA;AACA;AACA;wEAIA;AACA","names":[],"ignoreList":[],"sources":["../../../../packages/dynamic-forms/src/lib/fields/group/group-field.component.ts"],"sourcesContent":["import {\n  ChangeDetectionStrategy,\n  Component,\n  computed,\n  DestroyRef,\n  EnvironmentInjector,\n  inject,\n  Injector,\n  input,\n  linkedSignal,\n  runInInjectionContext,\n  untracked,\n} from '@angular/core';\nimport { DfFieldOutlet } from '../../directives/df-field-outlet/df-field-outlet.directive';\nimport { outputFromObservable, toObservable } from '@angular/core/rxjs-interop';\nimport { explicitEffect } from 'ngxtension/explicit-effect';\nimport { derivedFromDeferred } from '@ng-forge/dynamic-forms/internal';\nimport { createFieldResolutionPipe, ResolvedField } from '../../utils/resolve-field/resolve-field';\nimport { computeContainerHostClasses, setupContainerInitEffect } from '../../utils/container-utils/container-utils';\nimport { CONTAINER_FIELD_PROCESSORS } from '../../utils/container-utils/container-field-processors';\nimport { isEqual } from '@ng-forge/dynamic-forms/internal';\nimport { DynamicFormLogger } from '@ng-forge/dynamic-forms/internal';\nimport { GroupField } from '@ng-forge/dynamic-forms/internal';\nimport { injectFieldRegistry } from '../../utils/inject-field-registry/inject-field-registry';\nimport { FieldTree, form } from '@angular/forms/signals';\nimport { FieldDef } from '@ng-forge/dynamic-forms/internal';\nimport { FieldSignalContext, GroupContext } from '@ng-forge/dynamic-forms/internal';\nimport { FIELD_SIGNAL_CONTEXT, GROUP_CONTEXT, injectFieldSignalContext } from '@ng-forge/dynamic-forms/internal';\nimport { createSchemaFromFields } from '../../core/schema-builder';\nimport { EventBus } from '@ng-forge/dynamic-forms/internal';\nimport { SubmitEvent } from '../../events/constants/submit.event';\n\n/** Container component for rendering nested form groups. */\n@Component({\n  selector: 'fieldset[group-field]',\n  imports: [DfFieldOutlet],\n  template: `\n    @for (field of resolvedFields(); track field.key) {\n      @if (!field.hidden()) {\n        <ng-container *dfFieldOutlet=\"field; environmentInjector: environmentInjector\" />\n      }\n    }\n  `,\n  styleUrl: './group-field.component.scss',\n  host: {\n    '[class]': 'hostClasses()',\n    role: 'group',\n    '[class.disabled]': 'disabled()',\n    '[class.df-container-hidden]': 'hidden()',\n    '[attr.aria-hidden]': 'hidden() || null',\n    // The group element's own id is the plain `key()` — only its DESCENDANTS\n    // compose scoped ids via GROUP_CONTEXT (e.g. children of an `address`\n    // group render as `address_street`). The group selector is `#address`.\n    '[id]': '`${key()}`',\n    '[attr.data-testid]': 'key()',\n  },\n  changeDetection: ChangeDetectionStrategy.OnPush,\n})\nexport default class GroupFieldComponent<TModel extends Record<string, unknown> = Record<string, unknown>> {\n  // ─────────────────────────────────────────────────────────────────────────────\n  // Dependencies\n  // ─────────────────────────────────────────────────────────────────────────────\n\n  private readonly destroyRef = inject(DestroyRef);\n  private readonly fieldRegistry = injectFieldRegistry();\n  private readonly parentFieldSignalContext = injectFieldSignalContext<TModel>();\n  private readonly parentGroupContext = inject(GROUP_CONTEXT, { optional: true });\n  private readonly injector = inject(Injector);\n  protected readonly environmentInjector = inject(EnvironmentInjector);\n  private readonly eventBus = inject(EventBus);\n  private readonly logger = inject(DynamicFormLogger);\n\n  // ─────────────────────────────────────────────────────────────────────────────\n  // Memoized Functions\n  // ─────────────────────────────────────────────────────────────────────────────\n\n  private readonly fieldProcessors = inject(CONTAINER_FIELD_PROCESSORS);\n\n  // ─────────────────────────────────────────────────────────────────────────────\n  // Inputs\n  // ─────────────────────────────────────────────────────────────────────────────\n\n  field = input.required<GroupField>();\n  key = input.required<string>();\n  className = input<string>();\n  hidden = input(false);\n\n  // ─────────────────────────────────────────────────────────────────────────────\n  // Computed Signals\n  // ─────────────────────────────────────────────────────────────────────────────\n\n  readonly hostClasses = computed(() => computeContainerHostClasses('group', this.className()));\n\n  private readonly rawFieldRegistry = computed(() => this.fieldRegistry.raw);\n\n  private readonly formSetup = computed(() => {\n    const groupField = this.field();\n    const registry = this.rawFieldRegistry();\n\n    if (groupField.fields && groupField.fields.length > 0) {\n      const flattenedFields = this.fieldProcessors.memoizedFlattenFields(groupField.fields, registry);\n      const flattenedFieldsForRendering = this.fieldProcessors.memoizedFlattenFieldsForRendering(groupField.fields, registry);\n      const fieldsById = this.fieldProcessors.memoizedKeyBy(flattenedFields);\n      const defaultValues = this.fieldProcessors.memoizedDefaultValues(fieldsById, registry);\n\n      return {\n        fields: flattenedFieldsForRendering,\n        schemaFields: flattenedFields,\n        originalFields: groupField.fields,\n        defaultValues,\n        registry,\n      };\n    }\n\n    return {\n      fields: [],\n      schemaFields: [],\n      originalFields: [],\n      defaultValues: {},\n      registry,\n    };\n  });\n\n  readonly defaultValues = linkedSignal(() => this.formSetup().defaultValues);\n\n  /**\n   * Entity computed from parent value, group key, and defaults.\n   * Uses deep equality check to prevent unnecessary updates when\n   * object spread creates new references with identical values.\n   */\n  private readonly entity = linkedSignal(\n    () => {\n      const parentValue = this.parentFieldSignalContext.value();\n      const groupKey = this.field().key;\n      const defaults = this.defaultValues();\n      const groupValue = (parentValue as Record<string, unknown>)?.[groupKey] || {};\n      return { ...defaults, ...groupValue };\n    },\n    {\n      debugName: 'GroupFieldComponent.entity',\n      equal: isEqual,\n    },\n  );\n\n  private readonly form = computed(() => {\n    return runInInjectionContext(this.injector, () => {\n      const setup = this.formSetup();\n\n      if (setup.schemaFields.length > 0) {\n        const schema = createSchemaFromFields(setup.schemaFields, setup.registry);\n        return untracked(() => form(this.entity, schema));\n      }\n\n      return untracked(() => form(this.entity));\n    });\n  });\n\n  // ─────────────────────────────────────────────────────────────────────────────\n  // Public State Signals\n  // ─────────────────────────────────────────────────────────────────────────────\n\n  readonly formValue = computed(() => this.entity());\n  readonly valid = computed(() => this.form()().valid());\n  readonly invalid = computed(() => this.form()().invalid());\n  readonly dirty = computed(() => this.form()().dirty());\n  readonly touched = computed(() => this.form()().touched());\n  readonly errors = computed(() => this.form()().errors());\n  readonly disabled = computed(() => this.form()().disabled());\n\n  private readonly nestedFieldTree = computed((): FieldTree<Record<string, unknown>> | undefined => {\n    const parentForm = this.parentFieldSignalContext.form as Record<string, FieldTree<Record<string, unknown>>>;\n    const groupKey = this.field().key;\n    return parentForm[groupKey];\n  });\n\n  private readonly groupFieldSignalContext: FieldSignalContext<Record<string, unknown>> = (() => {\n    const nestedFieldTree = this.nestedFieldTree;\n    return {\n      injector: this.injector,\n      value: this.parentFieldSignalContext.value,\n      defaultValues: this.defaultValues,\n      get form() {\n        return nestedFieldTree() ?? ({} as FieldTree<Record<string, unknown>>);\n      },\n    };\n  })();\n\n  /**\n   * Group context propagated to descendants — carries the dot-separated path of\n   * group ancestors so child fields can scope their DOM IDs (issue #401).\n   * Reactive via `computed()`: a nested group composes its path from the parent\n   * context signal + its own key, so the chain stays consistent if either changes.\n   */\n  private readonly groupContext: GroupContext = {\n    groupPath: computed(() => {\n      const ownKey = this.field().key;\n      const parentPath = this.parentGroupContext?.groupPath();\n      return parentPath ? `${parentPath}.${ownKey}` : ownKey;\n    }),\n  };\n\n  private readonly groupInjector = Injector.create({\n    parent: this.injector,\n    providers: [\n      { provide: FIELD_SIGNAL_CONTEXT, useValue: this.groupFieldSignalContext },\n      { provide: GROUP_CONTEXT, useValue: this.groupContext },\n    ],\n  });\n\n  // ─────────────────────────────────────────────────────────────────────────────\n  // Outputs\n  // ─────────────────────────────────────────────────────────────────────────────\n\n  readonly validityChange = outputFromObservable(toObservable(this.valid));\n  readonly dirtyChange = outputFromObservable(toObservable(this.dirty));\n  readonly submitted = outputFromObservable(this.eventBus.on<SubmitEvent>('submit'));\n\n  // ─────────────────────────────────────────────────────────────────────────────\n  // Field Resolution\n  // ─────────────────────────────────────────────────────────────────────────────\n\n  private readonly fieldsSource = computed(() => this.formSetup().fields);\n\n  protected readonly resolvedFields = derivedFromDeferred(\n    this.fieldsSource,\n    createFieldResolutionPipe(() => ({\n      loadTypeComponent: (type: string) => this.fieldRegistry.loadTypeComponent(type),\n      registry: this.rawFieldRegistry(),\n      injector: this.groupInjector,\n      destroyRef: this.destroyRef,\n      onError: (fieldDef: FieldDef<unknown>, error: unknown) => {\n        const fieldKey = fieldDef.key || '<no key>';\n        this.logger.error(\n          `Failed to load component for field type '${fieldDef.type}' (key: ${fieldKey}) ` +\n            `within group '${this.field().key}'. Ensure the field type is registered in your field registry.`,\n          error,\n        );\n      },\n    })),\n    { initialValue: [] as ResolvedField[], injector: this.injector },\n  );\n\n  // ─────────────────────────────────────────────────────────────────────────────\n  // Constructor\n  // ─────────────────────────────────────────────────────────────────────────────\n\n  constructor() {\n    this.setupEffects();\n  }\n\n  // ─────────────────────────────────────────────────────────────────────────────\n  // Private Methods\n  // ─────────────────────────────────────────────────────────────────────────────\n\n  private setupEffects(): void {\n    setupContainerInitEffect(this.resolvedFields, this.eventBus, 'group', () => this.field().key, this.injector);\n\n    explicitEffect(\n      [this.nestedFieldTree, this.field],\n      ([tree, field]) => {\n        if (!tree) {\n          this.logger.warn(\n            `Group field \"${field.key}\" not found in parent form. ` + `Ensure the parent form schema includes this group field.`,\n          );\n        }\n      },\n      { defer: true },\n    );\n  }\n}\n\nexport { GroupFieldComponent };\n"]}