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

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

@@ -30,8 +30,8 @@ type IonicPreviousButtonField = Omit<IonicButtonField<PreviousPageEvent>, 'event
     type: 'previous';
 };
 /** Add array item button field - dispatches AppendArrayItemEvent */
-type AddArrayItemButtonField = Omit<IonicButtonField<AppendArrayItemEvent>, 'event' | 'type' | 'eventArgs'> & {
-    type: 'addArrayItem';
+type IonicAddArrayItemButtonField = Omit<IonicButtonField<AppendArrayItemEvent>, 'event' | 'type' | 'eventArgs'> & {
+    type: 'add-array-item' | 'addArrayItem';
     /**
      * The key of the array field to add items to.
      * Required when the button is placed outside the array.
@@ -46,8 +46,8 @@ type AddArrayItemButtonField = Omit<IonicButtonField<AppendArrayItemEvent>, 'eve
     template: ArrayAllowedChildren | readonly ArrayAllowedChildren[];
 };
 /** Prepend array item button field - dispatches PrependArrayItemEvent (adds at beginning) */
-type PrependArrayItemButtonField = Omit<IonicButtonField<PrependArrayItemEvent>, 'event' | 'type' | 'eventArgs'> & {
-    type: 'prependArrayItem';
+type IonicPrependArrayItemButtonField = Omit<IonicButtonField<PrependArrayItemEvent>, 'event' | 'type' | 'eventArgs'> & {
+    type: 'prepend-array-item' | 'prependArrayItem';
     /**
      * The key of the array field to prepend items to.
      * Required when the button is placed outside the array.
@@ -62,8 +62,8 @@ type PrependArrayItemButtonField = Omit<IonicButtonField<PrependArrayItemEvent>,
     template: ArrayAllowedChildren | readonly ArrayAllowedChildren[];
 };
 /** Insert array item button field - dispatches InsertArrayItemEvent (adds at specific index) */
-type InsertArrayItemButtonField = Omit<IonicButtonField<InsertArrayItemEvent>, 'event' | 'type' | 'eventArgs'> & {
-    type: 'insertArrayItem';
+type IonicInsertArrayItemButtonField = Omit<IonicButtonField<InsertArrayItemEvent>, 'event' | 'type' | 'eventArgs'> & {
+    type: 'insert-array-item' | 'insertArrayItem';
     /**
      * The key of the array field to insert items into.
      * Required when the button is placed outside the array.
@@ -80,8 +80,8 @@ type InsertArrayItemButtonField = Omit<IonicButtonField<InsertArrayItemEvent>, '
     template: ArrayAllowedChildren | readonly ArrayAllowedChildren[];
 };
 /** Remove array item button field - dispatches RemoveAtIndexEvent or PopArrayItemEvent */
-type RemoveArrayItemButtonField = Omit<IonicButtonField<RemoveAtIndexEvent>, 'event' | 'type' | 'eventArgs'> & {
-    type: 'removeArrayItem';
+type IonicRemoveArrayItemButtonField = Omit<IonicButtonField<RemoveAtIndexEvent>, 'event' | 'type' | 'eventArgs'> & {
+    type: 'remove-array-item' | 'removeArrayItem';
     /**
      * The key of the array field to remove items from.
      * Required when the button is placed outside the array.
@@ -90,8 +90,8 @@ type RemoveArrayItemButtonField = Omit<IonicButtonField<RemoveAtIndexEvent>, 'ev
     arrayKey?: string;
 };
 /** Pop array item button field - dispatches PopArrayItemEvent (removes last item) */
-type PopArrayItemButtonField = Omit<IonicButtonField<PopArrayItemEvent>, 'event' | 'type' | 'eventArgs'> & {
-    type: 'popArrayItem';
+type IonicPopArrayItemButtonField = Omit<IonicButtonField<PopArrayItemEvent>, 'event' | 'type' | 'eventArgs'> & {
+    type: 'pop-array-item' | 'popArrayItem';
     /**
      * The key of the array field to remove the last item from.
      * REQUIRED - must specify which array to pop from.
@@ -99,8 +99,8 @@ type PopArrayItemButtonField = Omit<IonicButtonField<PopArrayItemEvent>, 'event'
     arrayKey: string;
 };
 /** Shift array item button field - dispatches ShiftArrayItemEvent (removes first item) */
-type ShiftArrayItemButtonField = Omit<IonicButtonField<ShiftArrayItemEvent>, 'event' | 'type' | 'eventArgs'> & {
-    type: 'shiftArrayItem';
+type IonicShiftArrayItemButtonField = Omit<IonicButtonField<ShiftArrayItemEvent>, 'event' | 'type' | 'eventArgs'> & {
+    type: 'shift-array-item' | 'shiftArrayItem';
     /**
      * The key of the array field to remove the first item from.
      * REQUIRED - must specify which array to shift from.
@@ -166,8 +166,8 @@ declare class IonicDatepickerFieldComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<IonicDatepickerFieldComponent, "df-ion-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 i1.NgForgeFieldHost; inputs: {}; outputs: {}; }]>;
 }
 
-/** Decorative icon addon for Ion fields. */
-interface IonIconAddon extends BaseAddon {
+/** Decorative icon addon for Ionic fields. */
+interface IonicIconAddon extends BaseAddon {
     readonly type: 'ion-icon';
     /** Ionons name (e.g., `'search-outline'`, `'close-outline'`). */
     readonly icon: string;
@@ -175,19 +175,19 @@ interface IonIconAddon extends BaseAddon {
     readonly ariaLabel?: DynamicText;
 }
 /** Ionic-supported button colour palette. */
-type IonButtonColor = 'primary' | 'secondary' | 'tertiary' | 'success' | 'warning' | 'danger' | 'light' | 'medium' | 'dark';
+type IonicButtonColor = 'primary' | 'secondary' | 'tertiary' | 'success' | 'warning' | 'danger' | 'light' | 'medium' | 'dark';
 /** Ionic-supported button fill variants. */
-type IonButtonFill = 'clear' | 'outline' | 'solid' | 'default';
+type IonicButtonFill = 'clear' | 'outline' | 'solid' | 'default';
 /**
  * Common shape of every `ion-button` addon — properties that don't
  * participate in either XOR axis.
  */
-interface IonButtonBase extends BaseAddon {
+interface IonicButtonBase extends BaseAddon {
     readonly type: 'ion-button';
     /** Ion button colour. */
-    readonly color?: IonButtonColor;
+    readonly color?: IonicButtonColor;
     /** Ion button fill style. */
-    readonly fill?: IonButtonFill;
+    readonly fill?: IonicButtonFill;
     /** Reactive loading state — renders an `<ion-spinner>` when truthy. */
     readonly loading?: DynamicValue<boolean>;
 }
@@ -196,7 +196,7 @@ interface IonButtonBase extends BaseAddon {
  * two click handlers (e.g., `preset` AND `actionRef`) are rejected by
  * TypeScript. The four shapes:
  */
-type IonButtonClickPreset = {
+type IonicButtonClickPreset = {
     /** Built-in preset action (e.g., `'clear'`, `'toggle-password-visibility'`). JSON-safe. */
     readonly preset: AddonActionPreset;
     readonly actionRef?: never;
@@ -210,54 +210,54 @@ type IonButtonClickPreset = {
  * usable; once the user augments `DynamicFormActionRegistry`, autocomplete
  * tightens to the registered keys.
  */
-type IonButtonActionRef = [RegisteredActionRef] extends [never] ? string : RegisteredActionRef;
-type IonButtonClickActionRef = {
+type IonicButtonActionRef = [RegisteredActionRef] extends [never] ? string : RegisteredActionRef;
+type IonicButtonClickActionRef = {
     readonly preset?: never;
     /** Reference to a handler registered via `withAddonActions(...)`. JSON-safe. */
-    readonly actionRef: IonButtonActionRef;
+    readonly actionRef: IonicButtonActionRef;
     readonly action?: never;
 };
-type IonButtonClickAction = {
+type IonicButtonClickAction = {
     readonly preset?: never;
     readonly actionRef?: never;
     /** Inline handler — code-only; dropped from JSON-derived configs. Matches the generic `AddonActionHandler` shape used by `withAddonActions(...)`. */
     readonly action: AddonActionHandler;
 };
-type IonButtonClickNone = {
+type IonicButtonClickNone = {
     readonly preset?: never;
     readonly actionRef?: never;
     readonly action?: never;
 };
-type IonButtonClick = IonButtonClickPreset | IonButtonClickActionRef | IonButtonClickAction | IonButtonClickNone;
+type IonicButtonClick = IonicButtonClickPreset | IonicButtonClickActionRef | IonicButtonClickAction | IonicButtonClickNone;
 /**
  * Content axis — XOR enforced at type level so an icon-only button is
  * forced to declare `ariaLabel`. The three shapes:
  */
-type IonButtonContentIconOnly = {
+type IonicButtonContentIconOnly = {
     readonly icon: string;
     readonly label?: never;
     /** REQUIRED: icon-only buttons must carry an accessible label. */
     readonly ariaLabel: DynamicText;
 };
-type IonButtonContentLabeled = {
+type IonicButtonContentLabeled = {
     readonly icon?: string;
     readonly label: DynamicText;
     readonly ariaLabel?: DynamicText;
 };
-type IonButtonContentDecorative = {
+type IonicButtonContentDecorative = {
     readonly icon?: never;
     readonly label?: never;
     readonly ariaLabel?: DynamicText;
 };
-type IonButtonContent = IonButtonContentIconOnly | IonButtonContentLabeled | IonButtonContentDecorative;
-/** Interactive button addon for Ion fields. */
-type IonButtonAddon = IonButtonBase & IonButtonContent & IonButtonClick;
+type IonicButtonContent = IonicButtonContentIconOnly | IonicButtonContentLabeled | IonicButtonContentDecorative;
+/** Interactive button addon for Ionic fields. */
+type IonicButtonAddon = IonicButtonBase & IonicButtonContent & IonicButtonClick;
 /** Union of all Ion-shipped addon types. */
-type IonAddon = IonIconAddon | IonButtonAddon;
+type IonicAddon = IonicIconAddon | IonicButtonAddon;
 declare module '@ng-forge/dynamic-forms' {
     interface DynamicFormAddonRegistry {
-        'ion-icon': IonIconAddon;
-        'ion-button': IonButtonAddon;
+        'ion-icon': IonicIconAddon;
+        'ion-button': IonicButtonAddon;
     }
 }
 
@@ -275,20 +275,20 @@ interface IonicInputProps extends InputProps {
  * Module-augmentable seam for adding custom addon types to `ion-input` at
  * the type level. Pair with `withCustomAddon(...)` for the runtime side:
  */
-interface IonAddonExtensions {
+interface IonicAddonExtensions {
 }
-type IonAddonExtension = IonAddonExtensions[keyof IonAddonExtensions];
+type IonicAddonExtension = IonicAddonExtensions[keyof IonicAddonExtensions];
 /** Addon types accepted by `ion-input`. */
-type IonInputAddon = IonIconAddon | IonButtonAddon | TextAddon | TemplateAddon | IonAddonExtension;
+type IonicInputAddon = IonicIconAddon | IonicButtonAddon | TextAddon | TemplateAddon | IonicAddonExtension;
 type IonicInputField = InputField<IonicInputProps> & {
-    addons?: ReadonlyArray<IonInputAddon>;
+    addons?: ReadonlyArray<IonicInputAddon>;
 };
 
 declare class IonicInputFieldComponent {
     private readonly elementRef;
     private ionicConfig;
     protected readonly ngf: i1.TypedNgForgeField<string>;
-    protected readonly ngfa: i1.TypedNgForgeAddons<IonInputAddon>;
+    protected readonly ngfa: i1.TypedNgForgeAddons<IonicInputAddon>;
     readonly props: _angular_core.InputSignal<IonicInputProps | undefined>;
     /**
      * Wrapper-style host bag pushed by `DfFieldOutlet`. Declared at the
@@ -310,10 +310,10 @@ declare class IonicInputFieldComponent {
      *  <ion-button> Ionic can style); everything else (icon/text/template/
      *  component types) goes through the universal <df-addon-slot> dispatcher
      *  wrapped in <span slot="start|end"> for safe shadow-DOM projection. */
-    protected readonly buttonPrefixAddons: _angular_core.Signal<_ng_forge_dynamic_forms_ionic.IonButtonAddon[]>;
-    protected readonly buttonSuffixAddons: _angular_core.Signal<_ng_forge_dynamic_forms_ionic.IonButtonAddon[]>;
-    protected readonly decorativePrefixAddons: _angular_core.Signal<(_ng_forge_dynamic_forms.TextAddon | _ng_forge_dynamic_forms.TemplateAddon | _ng_forge_dynamic_forms_ionic.IonIconAddon)[]>;
-    protected readonly decorativeSuffixAddons: _angular_core.Signal<(_ng_forge_dynamic_forms.TextAddon | _ng_forge_dynamic_forms.TemplateAddon | _ng_forge_dynamic_forms_ionic.IonIconAddon)[]>;
+    protected readonly buttonPrefixAddons: _angular_core.Signal<_ng_forge_dynamic_forms_ionic.IonicButtonAddon[]>;
+    protected readonly buttonSuffixAddons: _angular_core.Signal<_ng_forge_dynamic_forms_ionic.IonicButtonAddon[]>;
+    protected readonly decorativePrefixAddons: _angular_core.Signal<(_ng_forge_dynamic_forms.TextAddon | _ng_forge_dynamic_forms.TemplateAddon | _ng_forge_dynamic_forms_ionic.IonicIconAddon)[]>;
+    protected readonly decorativeSuffixAddons: _angular_core.Signal<(_ng_forge_dynamic_forms.TextAddon | _ng_forge_dynamic_forms.TemplateAddon | _ng_forge_dynamic_forms_ionic.IonicIconAddon)[]>;
     /** Set when the component is destroyed — guards async aria-describedby sync against teardown. */
     private destroyed;
     constructor();
@@ -533,12 +533,12 @@ declare const IonicField: {
     readonly Submit: "submit";
     readonly Next: "next";
     readonly Previous: "previous";
-    readonly AddArrayItem: "addArrayItem";
-    readonly PrependArrayItem: "prependArrayItem";
-    readonly InsertArrayItem: "insertArrayItem";
-    readonly RemoveArrayItem: "removeArrayItem";
-    readonly PopArrayItem: "popArrayItem";
-    readonly ShiftArrayItem: "shiftArrayItem";
+    readonly AddArrayItem: "add-array-item";
+    readonly PrependArrayItem: "prepend-array-item";
+    readonly InsertArrayItem: "insert-array-item";
+    readonly RemoveArrayItem: "remove-array-item";
+    readonly PopArrayItem: "pop-array-item";
+    readonly ShiftArrayItem: "shift-array-item";
     readonly Textarea: "textarea";
     readonly Radio: "radio";
     readonly MultiCheckbox: "multi-checkbox";
@@ -574,12 +574,18 @@ declare module '@ng-forge/dynamic-forms' {
         datepicker: IonicDatepickerField;
         slider: IonicSliderField;
         toggle: IonicToggleField;
-        addArrayItem: AddArrayItemButtonField;
-        prependArrayItem: PrependArrayItemButtonField;
-        insertArrayItem: InsertArrayItemButtonField;
-        removeArrayItem: RemoveArrayItemButtonField;
-        popArrayItem: PopArrayItemButtonField;
-        shiftArrayItem: ShiftArrayItemButtonField;
+        addArrayItem: IonicAddArrayItemButtonField;
+        'add-array-item': IonicAddArrayItemButtonField;
+        prependArrayItem: IonicPrependArrayItemButtonField;
+        'prepend-array-item': IonicPrependArrayItemButtonField;
+        insertArrayItem: IonicInsertArrayItemButtonField;
+        'insert-array-item': IonicInsertArrayItemButtonField;
+        removeArrayItem: IonicRemoveArrayItemButtonField;
+        'remove-array-item': IonicRemoveArrayItemButtonField;
+        popArrayItem: IonicPopArrayItemButtonField;
+        'pop-array-item': IonicPopArrayItemButtonField;
+        shiftArrayItem: IonicShiftArrayItemButtonField;
+        'shift-array-item': IonicShiftArrayItemButtonField;
     }
 }
 
@@ -620,10 +626,10 @@ type IonicAddonsFeature = {
 declare function withIonicAddons(): IonicAddonsFeature;
 
 /** Renderer for the `ion-button` addon type. */
-declare class IonButtonAddonComponent {
-    protected readonly action: i1.TypedNgForgeAddonAction<IonButtonAddon>;
+declare class IonicButtonAddonComponent {
+    protected readonly action: i1.TypedNgForgeAddonAction<IonicButtonAddon>;
     /** Re-exposed for template binding — same signal stored on the directive. */
-    protected readonly addon: _angular_core.Signal<IonButtonAddon>;
+    protected readonly addon: _angular_core.Signal<IonicButtonAddon>;
     protected readonly label: _angular_core.Signal<_ng_forge_dynamic_forms.DynamicText | undefined>;
     protected readonly ariaLabel: _angular_core.Signal<_ng_forge_dynamic_forms.DynamicText | undefined>;
     protected readonly icon: _angular_core.Signal<string | undefined>;
@@ -638,24 +644,24 @@ declare class IonButtonAddonComponent {
      *  is treated as "no label" so the button doesn't render an invisible text
      *  slot beside the icon. */
     protected readonly iconOnly: _angular_core.Signal<boolean>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<IonButtonAddonComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<IonButtonAddonComponent, "df-ion-button-addon", never, {}, {}, never, never, true, [{ directive: typeof i1.NgForgeAddonAction; inputs: {}; outputs: {}; }]>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<IonicButtonAddonComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<IonicButtonAddonComponent, "df-ion-button-addon", never, {}, {}, never, never, true, [{ directive: typeof i1.NgForgeAddonAction; inputs: {}; outputs: {}; }]>;
 }
 
 /** Renderer for the `ion-icon` addon type. */
-declare class IonIconAddonComponent {
-    readonly addon: _angular_core.InputSignal<IonIconAddon>;
+declare class IonicIconAddonComponent {
+    readonly addon: _angular_core.InputSignal<IonicIconAddon>;
     /** Accepted for contract uniformity — `NgComponentOutlet` setInput is strict; every type must declare it. */
     readonly fieldInputs: _angular_core.InputSignal<WrapperFieldInputs | undefined>;
     protected readonly iconName: _angular_core.Signal<string>;
     protected readonly ariaLabel: _angular_core.Signal<_ng_forge_dynamic_forms.DynamicText | undefined>;
     protected readonly hasAriaLabel: _angular_core.Signal<boolean>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<IonIconAddonComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<IonIconAddonComponent, "df-ion-icon-addon", never, { "addon": { "alias": "addon"; "required": true; "isSignal": true; }; "fieldInputs": { "alias": "fieldInputs"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<IonicIconAddonComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<IonicIconAddonComponent, "df-ion-icon-addon", never, { "addon": { "alias": "addon"; "required": true; "isSignal": true; }; "fieldInputs": { "alias": "fieldInputs"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /** Per-field writable signal that overrides the input's `type` attribute. */
 declare const IONIC_INPUT_TYPE_OVERRIDE: InjectionToken<WritableSignal<string | undefined>>;
 
-export { IONIC_CONFIG, IONIC_FIELD_TYPES, IONIC_INPUT_TYPE_OVERRIDE, IonButtonAddonComponent, IonIconAddonComponent, IonicButtonFieldComponent, IonicCheckboxFieldComponent, IonicDatepickerFieldComponent, IonicField, IonicInputFieldComponent, IonicMultiCheckboxFieldComponent, IonicRadioFieldComponent, IonicSelectFieldComponent, IonicSliderFieldComponent, IonicTextareaFieldComponent, IonicToggleFieldComponent, withIonicAddons, withIonicFields };
-export type { AddArrayItemButtonField, InsertArrayItemButtonField, IonAddon, IonAddonExtensions, IonButtonAddon, IonIconAddon, IonInputAddon, IonicButtonField, IonicButtonProps, IonicCheckboxField, IonicCheckboxProps, IonicConfig, IonicDatepickerField, IonicDatepickerProps, IonicFieldType, IonicFormConfig, IonicFormProps, IonicInputField, IonicInputProps, IonicMultiCheckboxField, IonicMultiCheckboxProps, IonicNextButtonField, IonicPreviousButtonField, IonicRadioField, IonicRadioProps, IonicSelectField, IonicSelectProps, IonicSliderField, IonicSliderProps, IonicSubmitButtonField, IonicTextareaField, IonicTextareaProps, IonicToggleField, IonicToggleProps, PopArrayItemButtonField, PrependArrayItemButtonField, RemoveArrayItemButtonField, ShiftArrayItemButtonField };
+export { IONIC_CONFIG, IONIC_FIELD_TYPES, IONIC_INPUT_TYPE_OVERRIDE, IonicButtonAddonComponent, IonicButtonFieldComponent, IonicCheckboxFieldComponent, IonicDatepickerFieldComponent, IonicField, IonicIconAddonComponent, IonicInputFieldComponent, IonicMultiCheckboxFieldComponent, IonicRadioFieldComponent, IonicSelectFieldComponent, IonicSliderFieldComponent, IonicTextareaFieldComponent, IonicToggleFieldComponent, withIonicAddons, withIonicFields };
+export type { IonicAddArrayItemButtonField, IonicAddon, IonicAddonExtensions, IonicButtonAddon, IonicButtonField, IonicButtonProps, IonicCheckboxField, IonicCheckboxProps, IonicConfig, IonicDatepickerField, IonicDatepickerProps, IonicFieldType, IonicFormConfig, IonicFormProps, IonicIconAddon, IonicInputAddon, IonicInputField, IonicInputProps, IonicInsertArrayItemButtonField, IonicMultiCheckboxField, IonicMultiCheckboxProps, IonicNextButtonField, IonicPopArrayItemButtonField, IonicPrependArrayItemButtonField, IonicPreviousButtonField, IonicRadioField, IonicRadioProps, IonicRemoveArrayItemButtonField, IonicSelectField, IonicSelectProps, IonicShiftArrayItemButtonField, IonicSliderField, IonicSliderProps, IonicSubmitButtonField, IonicTextareaField, IonicTextareaProps, IonicToggleField, IonicToggleProps };