@ng-forge/dynamic-forms-material 1.1.0 → 1.2.0-next.10

package/types/ng-forge-dynamic-forms-material-lazy-input.d.ts

@@ -0,0 +1,55 @@
+import * as _angular_material_form_field from '@angular/material/form-field';
+import { MatFormFieldAppearance, SubscriptSizing, FloatLabelType } from '@angular/material/form-field';
+import * as _angular_core from '@angular/core';
+import * as _ng_forge_dynamic_forms_integration from '@ng-forge/dynamic-forms/integration';
+import { InputField, InputProps, WrapperFieldInputs } from '@ng-forge/dynamic-forms/integration';
+import { DynamicText, TextAddon, TemplateAddon } from '@ng-forge/dynamic-forms';
+import { MatIconAddon, MatButtonAddon } from '@ng-forge/dynamic-forms-material/shared';
+
+interface MatInputProps extends InputProps {
+    appearance?: MatFormFieldAppearance;
+    disableRipple?: boolean;
+    subscriptSizing?: SubscriptSizing;
+    floatLabel?: FloatLabelType;
+    hideRequiredMarker?: boolean;
+    type?: 'text' | 'email' | 'password' | 'number' | 'tel' | 'url';
+    hint?: DynamicText;
+}
+/**
+ * Module-augmentable seam for adding custom addon types to `mat-input` at
+ * the type level. Pair with `withCustomAddon(...)` for the runtime side:
+ */
+interface MatAddonExtensions {
+}
+type MatAddonExtension = MatAddonExtensions[keyof MatAddonExtensions];
+/** Addon types accepted by `mat-input`. */
+type MatInputAddon = MatIconAddon | MatButtonAddon | TextAddon | TemplateAddon | MatAddonExtension;
+type MatInputField = InputField<MatInputProps> & {
+    addons?: ReadonlyArray<MatInputAddon>;
+};
+
+declare class MatInputFieldComponent {
+    private materialConfig;
+    protected readonly ngf: _ng_forge_dynamic_forms_integration.TypedNgForgeField<string>;
+    protected readonly ngfa: _ng_forge_dynamic_forms_integration.TypedNgForgeAddons<MatInputAddon>;
+    readonly props: _angular_core.InputSignal<MatInputProps | undefined>;
+    /**
+     * Wrapper-style host bag pushed by `DfFieldOutlet`. Declared at the
+     * component level so `setInputIfDeclared` (which uses
+     * `reflectComponentType`) can write it.
+     */
+    readonly fieldInputs: _angular_core.InputSignal<WrapperFieldInputs | undefined>;
+    /** Per-instance type override populated by `toggle-password-visibility` preset. */
+    private readonly typeOverride;
+    readonly appearance: _angular_core.Signal<_angular_material_form_field.MatFormFieldAppearance>;
+    readonly subscriptSizing: _angular_core.Signal<_angular_material_form_field.SubscriptSizing>;
+    readonly floatLabel: _angular_core.Signal<_angular_material_form_field.FloatLabelType>;
+    readonly hideRequiredMarker: _angular_core.Signal<boolean>;
+    /** Override (set by `toggle-password-visibility` preset) wins over `props().type`. */
+    protected readonly type: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MatInputFieldComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MatInputFieldComponent, "df-mat-input", never, { "props": { "alias": "props"; "required": false; "isSignal": true; }; "fieldInputs": { "alias": "fieldInputs"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof _ng_forge_dynamic_forms_integration.NgForgeFieldHost; inputs: {}; outputs: {}; }, { directive: typeof _ng_forge_dynamic_forms_integration.NgForgeAddons; inputs: {}; outputs: {}; }]>;
+}
+
+export { MatInputFieldComponent };
+export type { MatInputField, MatInputProps };

package/types/ng-forge-dynamic-forms-material-lazy-multi-checkbox.d.ts

@@ -0,0 +1,29 @@
+import * as _angular_core from '@angular/core';
+import * as _ng_forge_dynamic_forms_integration from '@ng-forge/dynamic-forms/integration';
+import { MultiCheckboxField } from '@ng-forge/dynamic-forms/integration';
+import { DynamicText, ValueType, FieldOption } from '@ng-forge/dynamic-forms';
+import { ThemePalette } from '@angular/material/core';
+
+interface MatMultiCheckboxProps {
+    disableRipple?: boolean;
+    hint?: DynamicText;
+    labelPosition?: 'before' | 'after';
+    color?: ThemePalette;
+}
+type MatMultiCheckboxField<T> = MultiCheckboxField<T, MatMultiCheckboxProps>;
+
+declare class MatMultiCheckboxFieldComponent {
+    protected readonly ngf: _ng_forge_dynamic_forms_integration.TypedNgForgeField<ValueType[]>;
+    readonly options: _angular_core.InputSignal<FieldOption<ValueType>[]>;
+    readonly props: _angular_core.InputSignal<MatMultiCheckboxProps | undefined>;
+    valueViewModel: _angular_core.WritableSignal<FieldOption<ValueType>[]>;
+    /** Computed map of checked option values for O(1) lookup in template */
+    readonly checkedValuesMap: _angular_core.Signal<Record<string, boolean>>;
+    constructor();
+    onCheckboxChange(option: FieldOption<ValueType>, checked: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MatMultiCheckboxFieldComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MatMultiCheckboxFieldComponent, "df-mat-multi-checkbox", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "props": { "alias": "props"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof _ng_forge_dynamic_forms_integration.NgForgeFieldHost; inputs: {}; outputs: {}; }]>;
+}
+
+export { MatMultiCheckboxFieldComponent };
+export type { MatMultiCheckboxField, MatMultiCheckboxProps };

package/types/ng-forge-dynamic-forms-material-lazy-radio.d.ts

@@ -0,0 +1,24 @@
+import * as _angular_core from '@angular/core';
+import * as _ng_forge_dynamic_forms_integration from '@ng-forge/dynamic-forms/integration';
+import { RadioField } from '@ng-forge/dynamic-forms/integration';
+import { DynamicText, ValueType, FieldOption } from '@ng-forge/dynamic-forms';
+import { ThemePalette } from '@angular/material/core';
+
+interface MatRadioProps {
+    disableRipple?: boolean;
+    color?: ThemePalette;
+    labelPosition?: 'before' | 'after';
+    hint?: DynamicText;
+}
+type MatRadioField<T> = RadioField<T, MatRadioProps>;
+
+declare class MatRadioFieldComponent {
+    protected readonly ngf: _ng_forge_dynamic_forms_integration.TypedNgForgeField<ValueType>;
+    readonly options: _angular_core.InputSignal<FieldOption<ValueType>[]>;
+    readonly props: _angular_core.InputSignal<MatRadioProps | undefined>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MatRadioFieldComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MatRadioFieldComponent, "df-mat-radio", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "props": { "alias": "props"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof _ng_forge_dynamic_forms_integration.NgForgeFieldHost; inputs: {}; outputs: {}; }]>;
+}
+
+export { MatRadioFieldComponent };
+export type { MatRadioField, MatRadioProps };

package/types/ng-forge-dynamic-forms-material-lazy-select.d.ts

@@ -0,0 +1,43 @@
+import * as _angular_material_form_field from '@angular/material/form-field';
+import { MatFormFieldAppearance, SubscriptSizing, FloatLabelType } from '@angular/material/form-field';
+import * as _angular_core from '@angular/core';
+import * as _ng_forge_dynamic_forms from '@ng-forge/dynamic-forms';
+import { ValueType, DynamicText, FieldOption } from '@ng-forge/dynamic-forms';
+import * as _ng_forge_dynamic_forms_integration from '@ng-forge/dynamic-forms/integration';
+import { SelectField, SelectProps, WrapperFieldInputs } from '@ng-forge/dynamic-forms/integration';
+
+interface MatSelectProps extends SelectProps {
+    appearance?: MatFormFieldAppearance;
+    multiple?: boolean;
+    panelMaxHeight?: string;
+    subscriptSizing?: SubscriptSizing;
+    floatLabel?: FloatLabelType;
+    hideRequiredMarker?: boolean;
+    compareWith?: (o1: ValueType, o2: ValueType) => boolean;
+    hint?: DynamicText;
+}
+type MatSelectField<T> = SelectField<T, MatSelectProps>;
+
+declare class MatSelectFieldComponent {
+    private materialConfig;
+    protected readonly ngf: _ng_forge_dynamic_forms_integration.TypedNgForgeField<ValueType>;
+    protected readonly ngfa: _ng_forge_dynamic_forms_integration.TypedNgForgeAddons<_ng_forge_dynamic_forms.AnyAddon>;
+    readonly options: _angular_core.InputSignal<FieldOption<ValueType>[]>;
+    /**
+     * Wrapper-style host bag pushed by `DfFieldOutlet`. Declared at the
+     * component level so `setInputIfDeclared` (which uses
+     * `reflectComponentType`) can write it.
+     */
+    readonly fieldInputs: _angular_core.InputSignal<WrapperFieldInputs | undefined>;
+    readonly props: _angular_core.InputSignal<MatSelectProps | undefined>;
+    readonly appearance: _angular_core.Signal<_angular_material_form_field.MatFormFieldAppearance>;
+    readonly subscriptSizing: _angular_core.Signal<_angular_material_form_field.SubscriptSizing>;
+    readonly floatLabel: _angular_core.Signal<_angular_material_form_field.FloatLabelType>;
+    readonly hideRequiredMarker: _angular_core.Signal<boolean>;
+    defaultCompare: (value1: any, value2: any) => boolean;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MatSelectFieldComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MatSelectFieldComponent, "df-mat-select", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "fieldInputs": { "alias": "fieldInputs"; "required": false; "isSignal": true; }; "props": { "alias": "props"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof _ng_forge_dynamic_forms_integration.NgForgeFieldHost; inputs: {}; outputs: {}; }, { directive: typeof _ng_forge_dynamic_forms_integration.NgForgeAddons; inputs: {}; outputs: {}; }]>;
+}
+
+export { MatSelectFieldComponent };
+export type { MatSelectField, MatSelectProps };

package/types/ng-forge-dynamic-forms-material-lazy-slider.d.ts

@@ -0,0 +1,27 @@
+import * as _angular_core from '@angular/core';
+import * as _ng_forge_dynamic_forms_integration from '@ng-forge/dynamic-forms/integration';
+import { SliderField } from '@ng-forge/dynamic-forms/integration';
+import { DynamicText } from '@ng-forge/dynamic-forms';
+import { MatFormFieldAppearance } from '@angular/material/form-field';
+
+interface MatSliderProps {
+    hint?: DynamicText;
+    color?: 'primary' | 'accent' | 'warn';
+    appearance?: MatFormFieldAppearance;
+    thumbLabel?: boolean;
+    showThumbLabel?: boolean;
+    tickInterval?: number | 'auto';
+    step?: number;
+}
+type MatSliderField = SliderField<MatSliderProps>;
+
+declare class MatSliderFieldComponent {
+    protected readonly ngf: _ng_forge_dynamic_forms_integration.TypedNgForgeField<number>;
+    readonly step: _angular_core.InputSignal<number | undefined>;
+    readonly props: _angular_core.InputSignal<MatSliderProps | undefined>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MatSliderFieldComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MatSliderFieldComponent, "df-mat-slider", never, { "step": { "alias": "step"; "required": false; "isSignal": true; }; "props": { "alias": "props"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof _ng_forge_dynamic_forms_integration.NgForgeFieldHost; inputs: {}; outputs: {}; }]>;
+}
+
+export { MatSliderFieldComponent };
+export type { MatSliderField, MatSliderProps };

package/types/ng-forge-dynamic-forms-material-lazy-textarea.d.ts

@@ -0,0 +1,39 @@
+import * as _angular_material_form_field from '@angular/material/form-field';
+import { MatFormFieldAppearance, SubscriptSizing, FloatLabelType } from '@angular/material/form-field';
+import * as _angular_core from '@angular/core';
+import * as _ng_forge_dynamic_forms from '@ng-forge/dynamic-forms';
+import { DynamicText } from '@ng-forge/dynamic-forms';
+import * as _ng_forge_dynamic_forms_integration from '@ng-forge/dynamic-forms/integration';
+import { TextareaField, TextareaProps, WrapperFieldInputs } from '@ng-forge/dynamic-forms/integration';
+
+interface MatTextareaProps extends TextareaProps {
+    hint?: DynamicText;
+    appearance?: MatFormFieldAppearance;
+    subscriptSizing?: SubscriptSizing;
+    floatLabel?: FloatLabelType;
+    hideRequiredMarker?: boolean;
+    resize?: 'none' | 'both' | 'horizontal' | 'vertical';
+}
+type MatTextareaField = TextareaField<MatTextareaProps>;
+
+declare class MatTextareaFieldComponent {
+    private materialConfig;
+    protected readonly ngf: _ng_forge_dynamic_forms_integration.TypedNgForgeField<string>;
+    protected readonly ngfa: _ng_forge_dynamic_forms_integration.TypedNgForgeAddons<_ng_forge_dynamic_forms.AnyAddon>;
+    readonly props: _angular_core.InputSignal<MatTextareaProps | undefined>;
+    /**
+     * Wrapper-style host bag pushed by `DfFieldOutlet`. Declared at the
+     * component level so `setInputIfDeclared` (which uses
+     * `reflectComponentType`) can write it.
+     */
+    readonly fieldInputs: _angular_core.InputSignal<WrapperFieldInputs | undefined>;
+    readonly appearance: _angular_core.Signal<_angular_material_form_field.MatFormFieldAppearance>;
+    readonly subscriptSizing: _angular_core.Signal<_angular_material_form_field.SubscriptSizing>;
+    readonly floatLabel: _angular_core.Signal<_angular_material_form_field.FloatLabelType>;
+    readonly hideRequiredMarker: _angular_core.Signal<boolean>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MatTextareaFieldComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MatTextareaFieldComponent, "df-mat-textarea", never, { "props": { "alias": "props"; "required": false; "isSignal": true; }; "fieldInputs": { "alias": "fieldInputs"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof _ng_forge_dynamic_forms_integration.NgForgeFieldHost; inputs: {}; outputs: {}; }, { directive: typeof _ng_forge_dynamic_forms_integration.NgForgeAddons; inputs: {}; outputs: {}; }]>;
+}
+
+export { MatTextareaFieldComponent };
+export type { MatTextareaField, MatTextareaProps };

package/types/ng-forge-dynamic-forms-material-lazy-toggle.d.ts

@@ -0,0 +1,28 @@
+import * as _angular_core from '@angular/core';
+import * as _ng_forge_dynamic_forms_integration from '@ng-forge/dynamic-forms/integration';
+import { ToggleField } from '@ng-forge/dynamic-forms/integration';
+import { DynamicText } from '@ng-forge/dynamic-forms';
+import { MatFormFieldAppearance } from '@angular/material/form-field';
+import { ThemePalette } from '@angular/material/core';
+
+interface MatToggleProps {
+    hint?: DynamicText;
+    appearance?: MatFormFieldAppearance;
+    color?: ThemePalette;
+    labelPosition?: 'before' | 'after';
+    disableRipple?: boolean;
+    hideIcon?: boolean;
+}
+type MatToggleField = ToggleField<MatToggleProps>;
+
+declare class MatToggleFieldComponent {
+    private materialConfig;
+    protected readonly ngf: _ng_forge_dynamic_forms_integration.TypedNgForgeField<boolean>;
+    readonly props: _angular_core.InputSignal<MatToggleProps | undefined>;
+    readonly disableRipple: _angular_core.Signal<boolean>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MatToggleFieldComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MatToggleFieldComponent, "df-mat-toggle", never, { "props": { "alias": "props"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof _ng_forge_dynamic_forms_integration.NgForgeFieldHost; inputs: {}; outputs: {}; }]>;
+}
+
+export { MatToggleFieldComponent };
+export type { MatToggleField, MatToggleProps };

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

@@ -0,0 +1,91 @@
+import { ThemePalette } from '@angular/material/core';
+import { MatFormFieldAppearance, SubscriptSizing, FloatLabelType } from '@angular/material/form-field';
+import { InjectionToken, WritableSignal } from '@angular/core';
+import { AddonActionPreset, AddonActionContext, BaseAddon, DynamicText, DynamicValue, RegisteredActionRef } from '@ng-forge/dynamic-forms';
+import { PresetCollaborators, AddonActionHandler } from '@ng-forge/dynamic-forms/integration';
+export { PresetCollaborators } from '@ng-forge/dynamic-forms/integration';
+
+/** Configuration options for Material Design form fields. */
+interface MaterialConfig {
+    /** Default appearance for Material form fields. @default 'outline' */
+    appearance?: MatFormFieldAppearance;
+    /** Default subscript sizing for Material form fields. @default 'dynamic' */
+    subscriptSizing?: SubscriptSizing;
+    /** Whether to disable ripple effects by default. @default false */
+    disableRipple?: boolean;
+    /** Default color theme for form controls. @default 'primary' */
+    color?: ThemePalette;
+    /** Default label position for checkboxes and radios. @default 'after' */
+    labelPosition?: 'before' | 'after';
+    /** Default float label behavior for form fields. @default 'auto' */
+    floatLabel?: FloatLabelType;
+    /** Whether to hide the required marker by default. @default false */
+    hideRequiredMarker?: boolean;
+}
+
+/** Global configuration for Material Design form fields. */
+declare const MATERIAL_CONFIG: InjectionToken<MaterialConfig>;
+
+/** Per-field writable signal that overrides the input's `type` attribute. */
+declare const MAT_INPUT_TYPE_OVERRIDE: InjectionToken<WritableSignal<string | undefined>>;
+
+/** Material adapter binding for the shared preset runner. */
+declare function runMatPresetAction(preset: AddonActionPreset, context: AddonActionContext, collaborators: PresetCollaborators): Promise<void>;
+
+/** Decorative icon addon for Material fields. */
+interface MatIconAddon extends BaseAddon {
+    readonly type: 'mat-icon';
+    /** Material Icons name (ligature, e.g., `'search'`, `'close'`). */
+    readonly icon: string;
+    /** Accessible label for icons that convey meaning. */
+    readonly ariaLabel?: DynamicText;
+}
+interface MatButtonBase extends BaseAddon {
+    readonly type: 'mat-button';
+    readonly color?: 'primary' | 'accent' | 'warn';
+    readonly loading?: DynamicValue<boolean>;
+}
+type MatButtonActionRef = [RegisteredActionRef] extends [never] ? string : RegisteredActionRef;
+type MatButtonClick = {
+    readonly preset: AddonActionPreset;
+    readonly actionRef?: never;
+    readonly action?: never;
+} | {
+    readonly preset?: never;
+    readonly actionRef: MatButtonActionRef;
+    readonly action?: never;
+} | {
+    readonly preset?: never;
+    readonly actionRef?: never;
+    readonly action: AddonActionHandler;
+} | {
+    readonly preset?: never;
+    readonly actionRef?: never;
+    readonly action?: never;
+};
+type MatButtonContent = {
+    readonly icon: string;
+    readonly label?: never;
+    readonly ariaLabel: DynamicText;
+} | {
+    readonly icon?: string;
+    readonly label: DynamicText;
+    readonly ariaLabel?: DynamicText;
+} | {
+    readonly icon?: never;
+    readonly label?: never;
+    readonly ariaLabel?: DynamicText;
+};
+/** Interactive button addon for Material fields. */
+type MatButtonAddon = MatButtonBase & MatButtonContent & MatButtonClick;
+/** Union of all Material-shipped addon types. */
+type MatAddon = MatIconAddon | MatButtonAddon;
+declare module '@ng-forge/dynamic-forms' {
+    interface DynamicFormAddonRegistry {
+        'mat-icon': MatIconAddon;
+        'mat-button': MatButtonAddon;
+    }
+}
+
+export { MATERIAL_CONFIG, MAT_INPUT_TYPE_OVERRIDE, runMatPresetAction };
+export type { MatAddon, MatButtonAddon, MatIconAddon, MaterialConfig };

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

@@ -1,12 +1,14 @@
 import * as _angular_core from '@angular/core';
-import { InjectionToken, Provider, WritableSignal } from '@angular/core';
+import { Provider } from '@angular/core';
 import * as _ng_forge_dynamic_forms_integration from '@ng-forge/dynamic-forms/integration';
-import { CheckboxField, DatepickerField, DatepickerProps, AddonActionHandler, InputField, InputProps, WrapperFieldInputs, MultiCheckboxField, RadioField, SelectField, SelectProps, SliderField, ButtonField, TextareaField, TextareaProps, ToggleField, FieldTypeDefinition } from '@ng-forge/dynamic-forms/integration';
+import { CheckboxField, DatepickerField, DatepickerProps, WrapperFieldInputs, InputField, InputProps, MultiCheckboxField, RadioField, SelectField, SelectProps, SliderField, ButtonField, TextareaField, TextareaProps, ToggleField, FieldTypeDefinition, WrapperTypeDefinition } from '@ng-forge/dynamic-forms/integration';
 import * as _ng_forge_dynamic_forms from '@ng-forge/dynamic-forms';
-import { DynamicText, BaseAddon, DynamicValue, AddonActionPreset, RegisteredActionRef, TextAddon, TemplateAddon, ValueType, FieldOption, FormEvent, FormSubmitEvent, NextPageEvent, PreviousPageEvent, AppendArrayItemEvent, ArrayAllowedChildren, PrependArrayItemEvent, InsertArrayItemEvent, RemoveAtIndexEvent, PopArrayItemEvent, ShiftArrayItemEvent, NarrowFields, RegisteredFieldTypes, InferFormValue, FormConfig } from '@ng-forge/dynamic-forms';
+import { DynamicText, TextAddon, TemplateAddon, ValueType, FieldOption, FormEvent, FormSubmitEvent, NextPageEvent, PreviousPageEvent, AppendArrayItemEvent, ArrayAllowedChildren, PrependArrayItemEvent, InsertArrayItemEvent, RemoveAtIndexEvent, PopArrayItemEvent, ShiftArrayItemEvent, NarrowFields, RegisteredFieldTypes, InferFormValue, FormConfig } from '@ng-forge/dynamic-forms';
 import { ThemePalette } from '@angular/material/core';
 import * as _angular_material_form_field from '@angular/material/form-field';
 import { MatFormFieldAppearance, SubscriptSizing, FloatLabelType } from '@angular/material/form-field';
+import { MatIconAddon, MatButtonAddon, MaterialConfig } from '@ng-forge/dynamic-forms-material/shared';
+export { MATERIAL_CONFIG, MAT_INPUT_TYPE_OVERRIDE, MatAddon, MatButtonAddon, MatIconAddon, MaterialConfig } from '@ng-forge/dynamic-forms-material/shared';
 
 interface MatCheckboxProps {
     color?: ThemePalette;
@@ -42,106 +44,23 @@ type MatDatepickerField = DatepickerField<MatDatepickerProps>;
 declare class MatDatepickerFieldComponent {
     private materialConfig;
     protected readonly ngf: _ng_forge_dynamic_forms_integration.TypedNgForgeField<string>;
+    protected readonly ngfa: _ng_forge_dynamic_forms_integration.TypedNgForgeAddons<_ng_forge_dynamic_forms.AnyAddon>;
     readonly minDate: _angular_core.InputSignal<Date | null>;
     readonly maxDate: _angular_core.InputSignal<Date | null>;
     readonly startAt: _angular_core.InputSignal<Date | null>;
     readonly props: _angular_core.InputSignal<MatDatepickerProps | undefined>;
+    /**
+     * Wrapper-style host bag pushed by `DfFieldOutlet`. Declared at the
+     * component level so `setInputIfDeclared` (which uses
+     * `reflectComponentType`) can write it.
+     */
+    readonly fieldInputs: _angular_core.InputSignal<WrapperFieldInputs | undefined>;
     readonly appearance: _angular_core.Signal<_angular_material_form_field.MatFormFieldAppearance>;
     readonly subscriptSizing: _angular_core.Signal<_angular_material_form_field.SubscriptSizing>;
     readonly floatLabel: _angular_core.Signal<_angular_material_form_field.FloatLabelType>;
     readonly hideRequiredMarker: _angular_core.Signal<boolean>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MatDatepickerFieldComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MatDatepickerFieldComponent, "df-mat-datepicker", never, { "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "startAt": { "alias": "startAt"; "required": false; "isSignal": true; }; "props": { "alias": "props"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof _ng_forge_dynamic_forms_integration.NgForgeFieldHost; inputs: {}; outputs: {}; }]>;
-}
-
-/** Decorative icon addon for Material fields. */
-interface MatIconAddon extends BaseAddon {
-    readonly type: 'mat-icon';
-    /** Material Icons name (ligature, e.g., `'search'`, `'close'`). */
-    readonly icon: string;
-    /** Accessible label for icons that convey meaning. */
-    readonly ariaLabel?: DynamicText;
-}
-/**
- * Common shape of every `mat-button` addon — properties that don't
- * participate in either XOR axis.
- */
-interface MatButtonBase extends BaseAddon {
-    readonly type: 'mat-button';
-    /** Material button colour variant. */
-    readonly color?: 'primary' | 'accent' | 'warn';
-    /** Reactive loading state — when truthy the button is disabled. */
-    readonly loading?: DynamicValue<boolean>;
-}
-/**
- * Click axis — XOR enforced at type level so configurations that combine
- * two click handlers (e.g., `preset` AND `actionRef`) are rejected by
- * TypeScript. Runtime XOR validation stays as defence-in-depth for
- * JSON-source configs that bypass the type checker.
- */
-type MatButtonClickPreset = {
-    /** Built-in preset action (e.g., `'clear'`, `'toggle-password-visibility'`). JSON-safe. */
-    readonly preset: AddonActionPreset;
-    readonly actionRef?: never;
-    readonly action?: never;
-};
-/**
- * Value type for the `actionRef` slot. When no actions have been registered
- * via `withAddonActions(...)`, `RegisteredActionRef` resolves to `never` —
- * which would make this variant uninhabitable and break `addon.actionRef`
- * narrowing in the renderer. Fall back to `string` so the variant stays
- * usable; once the user augments `DynamicFormActionRegistry`, autocomplete
- * tightens to the registered keys.
- */
-type MatButtonActionRef = [RegisteredActionRef] extends [never] ? string : RegisteredActionRef;
-type MatButtonClickActionRef = {
-    readonly preset?: never;
-    /** Reference to a handler registered via `withAddonActions(...)`. JSON-safe. */
-    readonly actionRef: MatButtonActionRef;
-    readonly action?: never;
-};
-type MatButtonClickAction = {
-    readonly preset?: never;
-    readonly actionRef?: never;
-    /** Inline handler — code-only; dropped from JSON-derived configs. */
-    readonly action: AddonActionHandler;
-};
-type MatButtonClickNone = {
-    readonly preset?: never;
-    readonly actionRef?: never;
-    readonly action?: never;
-};
-type MatButtonClick = MatButtonClickPreset | MatButtonClickActionRef | MatButtonClickAction | MatButtonClickNone;
-/**
- * Content axis — XOR enforced at type level so an icon-only button is
- * forced to declare `ariaLabel`. The three shapes:
- */
-type MatButtonContentIconOnly = {
-    readonly icon: string;
-    readonly label?: never;
-    /** REQUIRED: icon-only buttons must carry an accessible label. */
-    readonly ariaLabel: DynamicText;
-};
-type MatButtonContentLabeled = {
-    readonly icon?: string;
-    readonly label: DynamicText;
-    readonly ariaLabel?: DynamicText;
-};
-type MatButtonContentDecorative = {
-    readonly icon?: never;
-    readonly label?: never;
-    readonly ariaLabel?: DynamicText;
-};
-type MatButtonContent = MatButtonContentIconOnly | MatButtonContentLabeled | MatButtonContentDecorative;
-/** Interactive button addon for Material fields. */
-type MatButtonAddon = MatButtonBase & MatButtonContent & MatButtonClick;
-/** Union of all Material-shipped addon types. */
-type MatAddon = MatIconAddon | MatButtonAddon;
-declare module '@ng-forge/dynamic-forms' {
-    interface DynamicFormAddonRegistry {
-        'mat-icon': MatIconAddon;
-        'mat-button': MatButtonAddon;
-    }
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MatDatepickerFieldComponent, "df-mat-datepicker", never, { "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "startAt": { "alias": "startAt"; "required": false; "isSignal": true; }; "props": { "alias": "props"; "required": false; "isSignal": true; }; "fieldInputs": { "alias": "fieldInputs"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof _ng_forge_dynamic_forms_integration.NgForgeFieldHost; inputs: {}; outputs: {}; }, { directive: typeof _ng_forge_dynamic_forms_integration.NgForgeAddons; inputs: {}; outputs: {}; }]>;
 }
 
 interface MatInputProps extends InputProps {
@@ -241,7 +160,14 @@ type MatSelectField<T> = SelectField<T, MatSelectProps>;
 declare class MatSelectFieldComponent {
     private materialConfig;
     protected readonly ngf: _ng_forge_dynamic_forms_integration.TypedNgForgeField<ValueType>;
+    protected readonly ngfa: _ng_forge_dynamic_forms_integration.TypedNgForgeAddons<_ng_forge_dynamic_forms.AnyAddon>;
     readonly options: _angular_core.InputSignal<FieldOption<ValueType>[]>;
+    /**
+     * Wrapper-style host bag pushed by `DfFieldOutlet`. Declared at the
+     * component level so `setInputIfDeclared` (which uses
+     * `reflectComponentType`) can write it.
+     */
+    readonly fieldInputs: _angular_core.InputSignal<WrapperFieldInputs | undefined>;
     readonly props: _angular_core.InputSignal<MatSelectProps | undefined>;
     readonly appearance: _angular_core.Signal<_angular_material_form_field.MatFormFieldAppearance>;
     readonly subscriptSizing: _angular_core.Signal<_angular_material_form_field.SubscriptSizing>;
@@ -249,7 +175,7 @@ declare class MatSelectFieldComponent {
     readonly hideRequiredMarker: _angular_core.Signal<boolean>;
     defaultCompare: (value1: any, value2: any) => boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MatSelectFieldComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MatSelectFieldComponent, "df-mat-select", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "props": { "alias": "props"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof _ng_forge_dynamic_forms_integration.NgForgeFieldHost; inputs: {}; outputs: {}; }]>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MatSelectFieldComponent, "df-mat-select", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "fieldInputs": { "alias": "fieldInputs"; "required": false; "isSignal": true; }; "props": { "alias": "props"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof _ng_forge_dynamic_forms_integration.NgForgeFieldHost; inputs: {}; outputs: {}; }, { directive: typeof _ng_forge_dynamic_forms_integration.NgForgeAddons; inputs: {}; outputs: {}; }]>;
 }
 
 interface MatSliderProps {
@@ -371,7 +297,7 @@ type MatShiftArrayItemButtonField = Omit<MatButtonField<ShiftArrayItemEvent>, 'e
 declare class MatButtonFieldComponent<TEvent extends FormEvent> {
     protected readonly action: _ng_forge_dynamic_forms_integration.NgForgeAction<TEvent>;
     readonly props: _angular_core.InputSignal<MatButtonProps | undefined>;
-    readonly buttonType: _angular_core.Signal<"reset" | "button" | "submit">;
+    readonly buttonType: _angular_core.Signal<"button" | "submit" | "reset">;
     readonly buttonTestId: _angular_core.Signal<string>;
     onClick(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MatButtonFieldComponent<any>, never>;
@@ -391,13 +317,20 @@ type MatTextareaField = TextareaField<MatTextareaProps>;
 declare class MatTextareaFieldComponent {
     private materialConfig;
     protected readonly ngf: _ng_forge_dynamic_forms_integration.TypedNgForgeField<string>;
+    protected readonly ngfa: _ng_forge_dynamic_forms_integration.TypedNgForgeAddons<_ng_forge_dynamic_forms.AnyAddon>;
     readonly props: _angular_core.InputSignal<MatTextareaProps | undefined>;
+    /**
+     * Wrapper-style host bag pushed by `DfFieldOutlet`. Declared at the
+     * component level so `setInputIfDeclared` (which uses
+     * `reflectComponentType`) can write it.
+     */
+    readonly fieldInputs: _angular_core.InputSignal<WrapperFieldInputs | undefined>;
     readonly appearance: _angular_core.Signal<_angular_material_form_field.MatFormFieldAppearance>;
     readonly subscriptSizing: _angular_core.Signal<_angular_material_form_field.SubscriptSizing>;
     readonly floatLabel: _angular_core.Signal<_angular_material_form_field.FloatLabelType>;
     readonly hideRequiredMarker: _angular_core.Signal<boolean>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MatTextareaFieldComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MatTextareaFieldComponent, "df-mat-textarea", never, { "props": { "alias": "props"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof _ng_forge_dynamic_forms_integration.NgForgeFieldHost; inputs: {}; outputs: {}; }]>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MatTextareaFieldComponent, "df-mat-textarea", never, { "props": { "alias": "props"; "required": false; "isSignal": true; }; "fieldInputs": { "alias": "fieldInputs"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof _ng_forge_dynamic_forms_integration.NgForgeFieldHost; inputs: {}; outputs: {}; }, { directive: typeof _ng_forge_dynamic_forms_integration.NgForgeAddons; inputs: {}; outputs: {}; }]>;
 }
 
 interface MatToggleProps {
@@ -425,58 +358,6 @@ declare class MatToggleFieldComponent {
  */
 declare const MATERIAL_FIELD_TYPES: FieldTypeDefinition[];
 
-/** Configuration options for Material Design form fields. */
-interface MaterialConfig {
-    /**
-     * Default appearance for Material form fields
-     *
-     * @default 'outline'
-     */
-    appearance?: MatFormFieldAppearance;
-    /**
-     * Default subscript sizing for Material form fields
-     *
-     * @default 'dynamic'
-     */
-    subscriptSizing?: SubscriptSizing;
-    /**
-     * Whether to disable ripple effects by default
-     *
-     * @default false
-     */
-    disableRipple?: boolean;
-    /**
-     * Default color theme for form controls (checkboxes, radios, sliders, toggles)
-     *
-     * @default 'primary'
-     */
-    color?: ThemePalette;
-    /**
-     * Default label position for checkboxes and radios
-     *
-     * @default 'after'
-     */
-    labelPosition?: 'before' | 'after';
-    /**
-     * Default float label behavior for form fields
-     *
-     * @default 'auto'
-     */
-    floatLabel?: FloatLabelType;
-    /**
-     * Whether to hide the required marker by default
-     *
-     * @default false
-     */
-    hideRequiredMarker?: boolean;
-}
-
-/**
- * Injection token for Material Design form configuration.
- * Use this to provide global configuration for Material form fields.
- */
-declare const MATERIAL_CONFIG: InjectionToken<MaterialConfig>;
-
 /**
  * Material Design field type constants
  * Based on available field components in the /fields folder
@@ -555,8 +436,8 @@ type MaterialConfigFeature = {
  * Default `withMaterialFields()` shape — field defs + the auto-included
  * addons feature so `mat-icon` / `mat-button` work out of the box.
  */
-type MaterialFieldsWithAddons = [...MaterialFieldTypes, MaterialAddonsFeature];
-type MaterialFieldsWithConfig = [...MaterialFieldTypes, MaterialAddonsFeature, MaterialConfigFeature];
+type MaterialFieldsWithAddons = [...MaterialFieldTypes, MaterialAddonsFeature, WrapperTypeDefinition];
+type MaterialFieldsWithConfig = [...MaterialFieldTypes, MaterialAddonsFeature, WrapperTypeDefinition, MaterialConfigFeature];
 /**
  * Configure dynamic forms with Material Design field types, with
  * Material-shipped addon types (`mat-icon`, `mat-button`) auto-included so
@@ -604,16 +485,5 @@ declare class MatButtonAddonComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<MatButtonAddonComponent, "df-mat-button-addon", never, {}, {}, never, never, true, [{ directive: typeof _ng_forge_dynamic_forms_integration.NgForgeAddonAction; inputs: {}; outputs: {}; }]>;
 }
 
-/**
- * Per-field writable signal that overrides the input's `type` attribute.
- *
- * @Component({
- *   providers: [{ provide: MAT_INPUT_TYPE_OVERRIDE, useValue: signal(undefined) }],
- * })
- * class MatInputFieldComponent { ... }
- * ```
- */
-declare const MAT_INPUT_TYPE_OVERRIDE: InjectionToken<WritableSignal<string | undefined>>;
-
-export { MATERIAL_CONFIG, MATERIAL_FIELD_TYPES, MAT_INPUT_TYPE_OVERRIDE, MatButtonAddonComponent, MatButtonFieldComponent, MatCheckboxFieldComponent, MatDatepickerFieldComponent, MatField, MatIconAddonComponent, MatInputFieldComponent, MatMultiCheckboxFieldComponent, MatRadioFieldComponent, MatSelectFieldComponent, MatSliderFieldComponent, MatTextareaFieldComponent, MatToggleFieldComponent, withMaterialAddons, withMaterialFields };
-export type { MatAddArrayItemButtonField, MatAddon, MatAddonExtensions, MatButtonAddon, MatButtonField, MatButtonProps, MatCheckboxField, MatCheckboxProps, MatDatepickerField, MatDatepickerProps, MatFieldType, MatFormConfig, MatFormProps, MatIconAddon, MatInputAddon, MatInputField, MatInputProps, MatInsertArrayItemButtonField, MatMultiCheckboxField, MatMultiCheckboxProps, MatNextButtonField, MatPopArrayItemButtonField, MatPrependArrayItemButtonField, MatPreviousButtonField, MatRadioField, MatRadioProps, MatRemoveArrayItemButtonField, MatSelectField, MatSelectProps, MatShiftArrayItemButtonField, MatSliderField, MatSliderProps, MatSubmitButtonField, MatTextareaField, MatTextareaProps, MatToggleField, MatToggleProps, MaterialConfig };
+export { MATERIAL_FIELD_TYPES, MatButtonAddonComponent, MatButtonFieldComponent, MatCheckboxFieldComponent, MatDatepickerFieldComponent, MatField, MatIconAddonComponent, MatInputFieldComponent, MatMultiCheckboxFieldComponent, MatRadioFieldComponent, MatSelectFieldComponent, MatSliderFieldComponent, MatTextareaFieldComponent, MatToggleFieldComponent, withMaterialAddons, withMaterialFields };
+export type { MatAddArrayItemButtonField, MatAddonExtensions, MatButtonField, MatButtonProps, MatCheckboxField, MatCheckboxProps, MatDatepickerField, MatDatepickerProps, MatFieldType, MatFormConfig, MatFormProps, MatInputAddon, MatInputField, MatInputProps, MatInsertArrayItemButtonField, MatMultiCheckboxField, MatMultiCheckboxProps, MatNextButtonField, MatPopArrayItemButtonField, MatPrependArrayItemButtonField, MatPreviousButtonField, MatRadioField, MatRadioProps, MatRemoveArrayItemButtonField, MatSelectField, MatSelectProps, MatShiftArrayItemButtonField, MatSliderField, MatSliderProps, MatSubmitButtonField, MatTextareaField, MatTextareaProps, MatToggleField, MatToggleProps };