@ng-forge/dynamic-forms 0.9.0-next.12 → 0.9.0-next.13

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

@@ -1,7 +1,7 @@
-import { FormEvent, FieldDef, FormEventConstructor, StateLogicConfig, BaseCheckedField, BaseValueField, FieldMeta, FieldOption, ArrayAllowedChildren, NonFieldLogicConfig, NextPageEvent, PreviousPageEvent, FieldWithValidation, ValidationMessages, DynamicText, ArrayItemContext, EventBus } from '@ng-forge/dynamic-forms';
+import { FormEvent, FieldDef, FormEventConstructor, StateLogicConfig, BaseCheckedField, BaseValueField, FieldMeta, FieldOption, ArrayAllowedChildren, NonFieldLogicConfig, NextPageEvent, PreviousPageEvent, FieldWithValidation, ValidationMessages, DynamicText, ArrayItemContext, AnyAddon, BaseAddon, AddonActionHandler, DynamicValue, WrapperFieldInputs, AddonActionContext, EventBus } from '@ng-forge/dynamic-forms';
 export { FieldWrapper, InferWrapperRegistry, NonFieldLogicConfig, NonFieldLogicContext, NonFieldLogicType, WrapperFieldInputs, WrapperRegistration, WrapperTypeDefinition, WrappersBundle, createWrappers, isEqual, isWrappersBundle, resolveNonFieldDisabled, resolveNonFieldHidden, wrapperProps } from '@ng-forge/dynamic-forms';
-import * as _angular_core from '@angular/core';
-import { Signal, Injector, ElementRef, Provider, WritableSignal, Type } from '@angular/core';
+import * as i0 from '@angular/core';
+import { Signal, Injector, ElementRef, InjectionToken, Provider, WritableSignal, Type } from '@angular/core';
 import { FieldTree, SchemaPath } from '@angular/forms/signals';
 import { ComponentFixture } from '@angular/core/testing';
 
@@ -820,10 +820,10 @@ declare function createAriaDescribedBySignal(errorsToDisplay: Signal<ResolvedErr
  * directly.
  */
 declare class NgForgeFieldShell {
-    readonly key: _angular_core.InputSignal<string>;
-    readonly className: _angular_core.InputSignal<string>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgForgeFieldShell, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NgForgeFieldShell, never, never, { "key": { "alias": "key"; "required": true; "isSignal": true; }; "className": { "alias": "className"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    readonly key: i0.InputSignal<string>;
+    readonly className: i0.InputSignal<string>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NgForgeFieldShell, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NgForgeFieldShell, never, never, { "key": { "alias": "key"; "required": true; "isSignal": true; }; "className": { "alias": "className"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 /** Input names forwarded onto `NgForgeFieldShell` via `hostDirectives`. */
 declare const NG_FORGE_FIELD_SHELL_INPUTS: readonly ["key", "className"];
@@ -867,13 +867,13 @@ declare class NgForgeField {
     readonly key: Signal<string>;
     /** Shell-owned className, re-exported as plain `Signal<string>` for the same reason. */
     readonly className: Signal<string>;
-    readonly field: _angular_core.InputSignal<FieldTree<unknown>>;
-    readonly label: _angular_core.InputSignal<DynamicText | undefined>;
-    readonly placeholder: _angular_core.InputSignal<DynamicText | undefined>;
-    readonly tabIndex: _angular_core.InputSignal<number | undefined>;
-    readonly props: _angular_core.InputSignal<unknown>;
-    readonly meta: _angular_core.InputSignal<FieldMeta | undefined>;
-    readonly validationMessages: _angular_core.InputSignal<ValidationMessages | undefined>;
+    readonly field: i0.InputSignal<FieldTree<unknown>>;
+    readonly label: i0.InputSignal<DynamicText | undefined>;
+    readonly placeholder: i0.InputSignal<DynamicText | undefined>;
+    readonly tabIndex: i0.InputSignal<number | undefined>;
+    readonly props: i0.InputSignal<unknown>;
+    readonly meta: i0.InputSignal<FieldMeta | undefined>;
+    readonly validationMessages: i0.InputSignal<ValidationMessages | undefined>;
     private readonly defaultValidationMessages;
     readonly errors: Signal<ResolvedError[]>;
     readonly showErrors: Signal<boolean>;
@@ -888,8 +888,8 @@ declare class NgForgeField {
     markClaimed(): void;
     private readonly logger;
     constructor();
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgForgeField, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NgForgeField, never, never, { "field": { "alias": "field"; "required": true; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "tabIndex": { "alias": "tabIndex"; "required": false; "isSignal": true; }; "props": { "alias": "props"; "required": false; "isSignal": true; }; "meta": { "alias": "meta"; "required": false; "isSignal": true; }; "validationMessages": { "alias": "validationMessages"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NgForgeField, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NgForgeField, never, never, { "field": { "alias": "field"; "required": true; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "tabIndex": { "alias": "tabIndex"; "required": false; "isSignal": true; }; "props": { "alias": "props"; "required": false; "isSignal": true; }; "meta": { "alias": "meta"; "required": false; "isSignal": true; }; "validationMessages": { "alias": "validationMessages"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 /**
  * Inputs forwarded onto `NgForgeField` via `hostDirectives`. Excludes
@@ -950,14 +950,14 @@ declare class NgForgeAction<TEvent extends FormEvent = FormEvent> {
     private readonly shell;
     readonly key: Signal<string>;
     readonly className: Signal<string>;
-    readonly label: _angular_core.InputSignal<DynamicText>;
-    readonly disabled: _angular_core.InputSignal<boolean>;
-    readonly hidden: _angular_core.InputSignal<boolean>;
-    readonly tabIndex: _angular_core.InputSignal<number | undefined>;
-    readonly event: _angular_core.InputSignal<FormEventConstructor<TEvent> | undefined>;
-    readonly eventArgs: _angular_core.InputSignal<EventArgs | undefined>;
-    readonly eventContext: _angular_core.InputSignal<ArrayItemContext | undefined>;
-    readonly props: _angular_core.InputSignal<unknown>;
+    readonly label: i0.InputSignal<DynamicText>;
+    readonly disabled: i0.InputSignal<boolean>;
+    readonly hidden: i0.InputSignal<boolean>;
+    readonly tabIndex: i0.InputSignal<number | undefined>;
+    readonly event: i0.InputSignal<FormEventConstructor<TEvent> | undefined>;
+    readonly eventArgs: i0.InputSignal<EventArgs | undefined>;
+    readonly eventContext: i0.InputSignal<ArrayItemContext | undefined>;
+    readonly props: i0.InputSignal<unknown>;
     private readonly eventBus;
     private readonly arrayContext;
     /**
@@ -968,8 +968,8 @@ declare class NgForgeAction<TEvent extends FormEvent = FormEvent> {
      * (e.g. submit buttons handled by the native form lifecycle).
      */
     dispatch(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgForgeAction<any>, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NgForgeAction<any>, never, never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "hidden": { "alias": "hidden"; "required": false; "isSignal": true; }; "tabIndex": { "alias": "tabIndex"; "required": false; "isSignal": true; }; "event": { "alias": "event"; "required": false; "isSignal": true; }; "eventArgs": { "alias": "eventArgs"; "required": false; "isSignal": true; }; "eventContext": { "alias": "eventContext"; "required": false; "isSignal": true; }; "props": { "alias": "props"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NgForgeAction<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NgForgeAction<any>, never, never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "hidden": { "alias": "hidden"; "required": false; "isSignal": true; }; "tabIndex": { "alias": "tabIndex"; "required": false; "isSignal": true; }; "event": { "alias": "event"; "required": false; "isSignal": true; }; "eventArgs": { "alias": "eventArgs"; "required": false; "isSignal": true; }; "eventContext": { "alias": "eventContext"; "required": false; "isSignal": true; }; "props": { "alias": "props"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 /**
  * Inputs forwarded onto `NgForgeAction` via `hostDirectives`. Excludes
@@ -989,6 +989,210 @@ declare const NG_FORGE_ACTION_INPUTS: readonly ["label", "disabled", "hidden", "
  */
 declare function injectNgForgeAction<TEvent extends FormEvent = FormEvent>(): NgForgeAction<TEvent>;
 
+/**
+ * Universal addon-array plumbing: signal-cached `hidden` resolution and
+ * slot bucketing. Used internally by the `NgForgeAddons` host wrapper —
+ * consumers should compose `NgForgeAddons` directly and inject the
+ * directive instance via `injectNgForgeAddons<TAddon>()`.
+ */
+declare class NgForgeAddonsBase {
+    /** Capture the host's injector so `toSignal` (inside `resolveDynamicValue`) ties to the host's `DestroyRef`. */
+    private readonly hostInjector;
+    /** Addon array mapped from `FieldDef.addons` by `buildBaseInputs`. */
+    readonly addons: i0.InputSignal<readonly AnyAddon[] | undefined>;
+    /**
+     * Per-addon `hidden` signal cache. Built via `explicitEffect` rather
+     * than `computed` because `toSignal` (inside `resolveDynamicValue` for
+     * Observable inputs) is disallowed in reactive contexts (NG0602).
+     */
+    private readonly _hiddenSignalCache;
+    readonly hiddenSignalCache: Signal<ReadonlyMap<AnyAddon, Signal<boolean>>>;
+    readonly visibleAddons: Signal<ReadonlyArray<AnyAddon>>;
+    readonly hasAddons: Signal<boolean>;
+    readonly prefixAddons: Signal<ReadonlyArray<AnyAddon>>;
+    readonly suffixAddons: Signal<ReadonlyArray<AnyAddon>>;
+    /**
+     * Visible addons grouped by their `slot` string. Convenience view for
+     * adapters with non-universal slots (e.g., Ionic `start` / `end`).
+     */
+    readonly addonsBySlot: Signal<ReadonlyMap<string, ReadonlyArray<AnyAddon>>>;
+    /** Secondary index keyed by `hidden` value identity. Catches the common case
+     *  where a FormConfig re-emit produces structurally-different-but-content-
+     *  identical addon objects — without this, every re-emit would spawn a new
+     *  `toSignal` subscription for each addon's hidden axis. */
+    private readonly _hiddenByValue;
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<NgForgeAddonsBase, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NgForgeAddonsBase, never, never, { "addons": { "alias": "addons"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+/** Forwarded onto `NgForgeAddonsBase` via the `NgForgeAddons` wrapper. */
+declare const NG_FORGE_ADDONS_INPUTS: readonly ["addons"];
+/**
+ * Host wrapper for `NgForgeAddonsBase`. Consumers compose this directly:
+ *
+ * ```ts
+ * \@Component({
+ *   hostDirectives: [NgForgeFieldHost, NgForgeAddons],
+ *   template: `
+ *     @if (ngfa.hasAddons()) {
+ *       <p-inputgroup>
+ *         @for (a of ngfa.prefixAddons(); track $index) {
+ *           <df-addon-slot [addon]="a" [hidden]="ngfa.hiddenSignalCache().get(a)" />
+ *         }
+ *         <input ngForgeControl ... />
+ *       </p-inputgroup>
+ *     }
+ *   `,
+ * })
+ * export class MyInputField {
+ *   protected readonly ngfa = injectNgForgeAddons<MyInputAddon>();
+ * }
+ * ```
+ *
+ * The wrapper exists so `hostDirectives: [NgForgeAddons]` resolves
+ * cross-package — same constraint that drives `NgForgeFieldHost`.
+ */
+declare class NgForgeAddons {
+    static ɵfac: i0.ɵɵFactoryDeclaration<NgForgeAddons, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NgForgeAddons, never, never, {}, {}, never, never, true, [{ directive: typeof NgForgeAddonsBase; inputs: { "addons": "addons"; }; outputs: {}; }]>;
+}
+/** Narrowed view of `NgForgeAddonsBase` returned by `injectNgForgeAddons<TAddon>()`. */
+type TypedNgForgeAddons<TAddon extends AnyAddon = AnyAddon> = Omit<NgForgeAddonsBase, 'addons' | 'visibleAddons' | 'prefixAddons' | 'suffixAddons'> & {
+    readonly addons: Signal<ReadonlyArray<TAddon> | undefined>;
+    readonly visibleAddons: Signal<ReadonlyArray<TAddon>>;
+    readonly prefixAddons: Signal<ReadonlyArray<TAddon>>;
+    readonly suffixAddons: Signal<ReadonlyArray<TAddon>>;
+};
+/**
+ * Typed inject helper. Always resolves to the underlying
+ * `NgForgeAddonsBase` instance — the wrapper class has no instance
+ * fields of its own.
+ */
+declare function injectNgForgeAddons<TAddon extends AnyAddon = AnyAddon>(): TypedNgForgeAddons<TAddon>;
+
+/**
+ * Permissive shape the directive reads from `addon()`. Adapter-specific
+ * addon types (e.g., `PrimeButtonAddon`) narrow this at the inject site via
+ * `injectNgForgeAddonAction<T>()`.
+ */
+interface ActionAddonShape extends BaseAddon {
+    readonly preset?: string;
+    readonly actionRef?: string;
+    readonly action?: AddonActionHandler;
+    readonly disabled?: DynamicValue<boolean>;
+    readonly loading?: DynamicValue<boolean>;
+}
+/**
+ * Universal click-dispatch plumbing for action-style addons (icon buttons,
+ * labelled buttons, etc.): `disabled` / `loading` resolution from
+ * `DynamicValue<boolean>`, action context construction, and the
+ * `preset / actionRef / action` precedence dispatcher.
+ *
+ * Adapter button kinds (e.g., `prime-button`) compose `NgForgeAddonAction`
+ * and read state via `injectNgForgeAddonAction<TAddon>()`. Preset semantics
+ * are adapter-specific — register an `ADDON_PRESET_HANDLER` at the host
+ * field scope to receive preset dispatches.
+ */
+declare class NgForgeAddonActionBase {
+    private readonly actionRegistry;
+    private readonly presetHandler;
+    private readonly logger;
+    private readonly hostInjector;
+    readonly addon: i0.InputSignal<ActionAddonShape>;
+    readonly fieldInputs: i0.InputSignal<WrapperFieldInputs | undefined>;
+    /**
+     * Per-value caches for `disabled` / `loading` signal resolution. Keyed by
+     * the `DynamicValue` identity so a single `toSignal` subscription is
+     * shared across addon-reference swaps that pass the same Observable.
+     * Mirrors `NgForgeAddonsBase._hiddenByValue` — `resolveDynamicValue`
+     * cannot run inside `computed`/`linkedSignal.computation` because
+     * `toSignal` throws in reactive contexts (NG0602), and re-running it on
+     * every recomputation would leak subscriptions on each cycle.
+     */
+    private readonly _disabledByValue;
+    private readonly _loadingByValue;
+    private readonly _resolvedDisabled;
+    private readonly _resolvedLoading;
+    readonly disabled: Signal<boolean>;
+    readonly loading: Signal<boolean>;
+    constructor();
+    private _resolveAxis;
+    /**
+     * Resolve the click handler from the addon's three-axis click variant and
+     * invoke it. Precedence on multi-set: `preset > actionRef > action`. The
+     * validator drops multi-set configs at config-init time; this is
+     * defence-in-depth + a logged warning so the misconfiguration is loud.
+     */
+    dispatch(): void;
+    /**
+     * Build an `AddonActionContext` for handlers from the wrapper-style
+     * `fieldInputs` bag. Returns the field-bound variant when a host field
+     * is reachable, or the orphan variant otherwise.
+     *
+     * Resolution order for `setValue`:
+     * 1. `inputs.setValue` from the forwarded bag (preferred — populated by
+     *    `buildFieldInputs` in `DfFieldOutlet`).
+     * 2. Fallback reconstructed from `inputs.field` itself: although
+     *    `ReadonlyFieldTree.value` is type-narrowed to `Signal<T>`, the
+     *    underlying runtime object is the same `WritableSignal<T>` created
+     *    by Signal Forms (the read-only wrapping is type-level only, see
+     *    `toReadonlyFieldTree`). Casting back at the writer boundary
+     *    produces a working setValue for ANY field depth — top-level OR
+     *    nested under groups. This avoids the previous FSC-key navigation
+     *    that broke for grouped fields, where `inputs.key` is DOM-mangled
+     *    (`'user_address_street'`) and `fsc.form[key]` returns undefined.
+     *
+     * The orphan variant fires only when the bag carries no field tree at
+     * all — genuine "rendered outside a field" scenario.
+     */
+    buildActionContext(): AddonActionContext;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NgForgeAddonActionBase, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NgForgeAddonActionBase, never, never, { "addon": { "alias": "addon"; "required": true; "isSignal": true; }; "fieldInputs": { "alias": "fieldInputs"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+/** Forwarded onto `NgForgeAddonActionBase` via the `NgForgeAddonAction` wrapper. */
+declare const NG_FORGE_ADDON_ACTION_INPUTS: readonly ["addon", "fieldInputs"];
+/**
+ * Host wrapper for `NgForgeAddonActionBase`. Consumers compose this directly:
+ *
+ * ```ts
+ * \@Component({
+ *   hostDirectives: [NgForgeAddonAction],
+ *   template: `
+ *     <p-button [loading]="action.loading()" [disabled]="action.disabled()"
+ *               (onClick)="action.dispatch()" />
+ *   `,
+ * })
+ * export class MyButtonAddon {
+ *   protected readonly action = injectNgForgeAddonAction<MyButtonAddon>();
+ * }
+ * ```
+ */
+declare class NgForgeAddonAction {
+    static ɵfac: i0.ɵɵFactoryDeclaration<NgForgeAddonAction, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NgForgeAddonAction, never, never, {}, {}, never, never, true, [{ directive: typeof NgForgeAddonActionBase; inputs: { "addon": "addon"; "fieldInputs": "fieldInputs"; }; outputs: {}; }]>;
+}
+/** Narrowed view of `NgForgeAddonActionBase` returned by `injectNgForgeAddonAction<T>()`. */
+type TypedNgForgeAddonAction<TAddon extends ActionAddonShape = ActionAddonShape> = Omit<NgForgeAddonActionBase, 'addon'> & {
+    readonly addon: Signal<TAddon>;
+};
+declare function injectNgForgeAddonAction<TAddon extends ActionAddonShape = ActionAddonShape>(): TypedNgForgeAddonAction<TAddon>;
+
+/**
+ * Adapter-supplied resolver for `preset` addon actions (e.g., `'clear'`,
+ * `'toggle-password-visibility'`). The universal click-dispatch directive
+ * (`NgForgeAddonAction`) delegates to this when an addon configures a
+ * `preset`; the adapter wires concrete preset semantics in its own
+ * provider scope.
+ *
+ * `NgForgeAddonAction` injects this with `{ optional: true }`. Addons that
+ * configure a preset on an adapter that hasn't registered a handler get a
+ * lenient warning at click time.
+ */
+interface AddonPresetHandler {
+    run(preset: string, ctx: AddonActionContext): void | Promise<void>;
+}
+declare const ADDON_PRESET_HANDLER: InjectionToken<AddonPresetHandler>;
+
 /**
  * Marker directive applied to the canonical control element of an
  * `NgForgeField`-using component. Forwards the field's `meta` AND
@@ -1024,10 +1228,10 @@ declare function injectNgForgeAction<TEvent extends FormEvent = FormEvent>(): Ng
  * structural lifecycle handles add/remove naturally.
  */
 declare class NgForgeControl {
-    readonly target: _angular_core.InputSignal<string | undefined>;
+    readonly target: i0.InputSignal<string | undefined>;
     constructor();
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgForgeControl, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NgForgeControl, "[ngForgeControl]", never, { "target": { "alias": "ngForgeControl"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NgForgeControl, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NgForgeControl, "[ngForgeControl]", never, { "target": { "alias": "ngForgeControl"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 /**
  * Selectorless companion directive for shadow-DOM-encapsulated components
@@ -1055,8 +1259,8 @@ declare class NgForgeControl {
  */
 declare class NgForgeHostControl {
     constructor();
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgForgeHostControl, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NgForgeHostControl, never, never, {}, {}, never, never, true, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NgForgeHostControl, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NgForgeHostControl, never, never, {}, {}, never, never, true, never>;
 }
 
 /**
@@ -1086,8 +1290,8 @@ declare class NgForgeHostControl {
  * for the same reason. See https://www.angularspace.com/host-directives-decomposition-unleashed/
  */
 declare class NgForgeFieldHost {
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgForgeFieldHost, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NgForgeFieldHost, never, never, {}, {}, never, never, true, [{ directive: typeof NgForgeFieldShell; inputs: { "key": "key"; "className": "className"; }; outputs: {}; }, { directive: typeof NgForgeField; inputs: { "field": "field"; "label": "label"; "placeholder": "placeholder"; "tabIndex": "tabIndex"; "props": "props"; "meta": "meta"; "validationMessages": "validationMessages"; }; outputs: {}; }]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NgForgeFieldHost, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NgForgeFieldHost, never, never, {}, {}, never, never, true, [{ directive: typeof NgForgeFieldShell; inputs: { "key": "key"; "className": "className"; }; outputs: {}; }, { directive: typeof NgForgeField; inputs: { "field": "field"; "label": "label"; "placeholder": "placeholder"; "tabIndex": "tabIndex"; "props": "props"; "meta": "meta"; "validationMessages": "validationMessages"; }; outputs: {}; }]>;
 }
 /**
  * Action / button host wrapper. Composes `NgForgeFieldShell` with
@@ -1106,8 +1310,8 @@ declare class NgForgeFieldHost {
  * ```
  */
 declare class NgForgeActionHost {
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgForgeActionHost, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NgForgeActionHost, never, never, {}, {}, never, never, true, [{ directive: typeof NgForgeFieldShell; inputs: { "key": "key"; "className": "className"; }; outputs: {}; }, { directive: typeof NgForgeAction; inputs: { "label": "label"; "disabled": "disabled"; "hidden": "hidden"; "tabIndex": "tabIndex"; "event": "event"; "eventArgs": "eventArgs"; "eventContext": "eventContext"; "props": "props"; }; outputs: {}; }]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NgForgeActionHost, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NgForgeActionHost, never, never, {}, {}, never, never, true, [{ directive: typeof NgForgeFieldShell; inputs: { "key": "key"; "className": "className"; }; outputs: {}; }, { directive: typeof NgForgeAction; inputs: { "label": "label"; "disabled": "disabled"; "hidden": "hidden"; "tabIndex": "tabIndex"; "event": "event"; "eventArgs": "eventArgs"; "eventContext": "eventContext"; "props": "props"; }; outputs: {}; }]>;
 }
 
 interface CreateNgForgeFieldFixtureOptions<TValue = unknown> {
@@ -1161,5 +1365,5 @@ declare function createNgForgeActionFixture<C, TEvent extends FormEvent = FormEv
 /** Provider for `DEFAULT_VALIDATION_MESSAGES` in field tests — supply the default-messages map and the directive resolves it from DI. */
 declare function provideTestValidationMessages(messages: ValidationMessages): Provider;
 
-export { NG_FORGE_ACTION_INPUTS, NG_FORGE_FIELD_SHELL_INPUTS, NG_FORGE_VALUE_FIELD_INPUTS, NgForgeAction, NgForgeActionHost, NgForgeControl, NgForgeField, NgForgeFieldHost, NgForgeFieldShell, NgForgeHostControl, addArrayItemButtonMapper, buildArrayButtonEventContext, buildValueFieldInputs, buttonFieldMapper, checkboxFieldMapper, createAriaDescribedBySignal, createNgForgeActionFixture, createNgForgeFieldFixture, createResolvedErrorsSignal, datepickerFieldMapper, injectNgForgeAction, injectNgForgeField, insertArrayItemButtonMapper, nextButtonFieldMapper, optionsFieldMapper, popArrayItemButtonMapper, prependArrayItemButtonMapper, previousButtonFieldMapper, provideTestValidationMessages, removeArrayItemButtonMapper, resolveArrayButtonContext, resolveArrayButtonEventArgs, resolveValueFieldContext, setupMetaTracking, shiftArrayItemButtonMapper, shouldShowErrors, submitButtonFieldMapper, valueFieldMapper };
-export type { ArrayButtonContext, ArrayButtonEventContext, Autocapitalize, AutocompleteValue, BaseArrayAddButtonField, BaseArrayRemoveButtonField, BaseInsertArrayItemButtonField, BaseNavigationButtonField, ButtonField, CheckboxField, CreateNgForgeActionFixtureOptions, CreateNgForgeFieldFixtureOptions, DatepickerField, DatepickerProps, EnterKeyHint, EventArg, EventArgs, FieldWithOptions, HtmlInputType, InferInputValue, InputField, InputMeta, InputMode, InputProps, InputType, InputTypeToValueType, MetaTrackingOptions, MultiCheckboxField, NgForgeActionFixture, NgForgeFieldFixture, NumericInputType, RadioField, ResolvedError, SelectField, SelectProps, SliderField, StringInputType, TextareaField, TextareaMeta, TextareaProps, TextareaWrap, ToggleField, TypedNgForgeField, ValueFieldContext };
+export { ADDON_PRESET_HANDLER, NG_FORGE_ACTION_INPUTS, NG_FORGE_ADDONS_INPUTS, NG_FORGE_ADDON_ACTION_INPUTS, NG_FORGE_FIELD_SHELL_INPUTS, NG_FORGE_VALUE_FIELD_INPUTS, NgForgeAction, NgForgeActionHost, NgForgeAddonAction, NgForgeAddonActionBase, NgForgeAddons, NgForgeAddonsBase, NgForgeControl, NgForgeField, NgForgeFieldHost, NgForgeFieldShell, NgForgeHostControl, addArrayItemButtonMapper, buildArrayButtonEventContext, buildValueFieldInputs, buttonFieldMapper, checkboxFieldMapper, createAriaDescribedBySignal, createNgForgeActionFixture, createNgForgeFieldFixture, createResolvedErrorsSignal, datepickerFieldMapper, injectNgForgeAction, injectNgForgeAddonAction, injectNgForgeAddons, injectNgForgeField, insertArrayItemButtonMapper, nextButtonFieldMapper, optionsFieldMapper, popArrayItemButtonMapper, prependArrayItemButtonMapper, previousButtonFieldMapper, provideTestValidationMessages, removeArrayItemButtonMapper, resolveArrayButtonContext, resolveArrayButtonEventArgs, resolveValueFieldContext, setupMetaTracking, shiftArrayItemButtonMapper, shouldShowErrors, submitButtonFieldMapper, valueFieldMapper };
+export type { AddonPresetHandler, ArrayButtonContext, ArrayButtonEventContext, Autocapitalize, AutocompleteValue, BaseArrayAddButtonField, BaseArrayRemoveButtonField, BaseInsertArrayItemButtonField, BaseNavigationButtonField, ButtonField, CheckboxField, CreateNgForgeActionFixtureOptions, CreateNgForgeFieldFixtureOptions, DatepickerField, DatepickerProps, EnterKeyHint, EventArg, EventArgs, FieldWithOptions, HtmlInputType, InferInputValue, InputField, InputMeta, InputMode, InputProps, InputType, InputTypeToValueType, MetaTrackingOptions, MultiCheckboxField, NgForgeActionFixture, NgForgeFieldFixture, NumericInputType, RadioField, ResolvedError, SelectField, SelectProps, SliderField, StringInputType, TextareaField, TextareaMeta, TextareaProps, TextareaWrap, ToggleField, TypedNgForgeAddonAction, TypedNgForgeAddons, TypedNgForgeField, ValueFieldContext };