@ng-forge/dynamic-forms-ionic 0.5.0 → 0.5.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ng-forge/dynamic-forms-ionic",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Ionic integration for @ng-forge/dynamic-forms. Pre-built Ionic form components for mobile and desktop.",
   "type": "module",
   "license": "MIT",

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

@@ -1,4 +1,4 @@
-import { FormEvent, FieldDef, LogicConfig, FieldComponent, DynamicText, FormEventConstructor, ArrayItemContext, CheckedFieldComponent, FieldMeta, ValidationMessages, ValueFieldComponent, ValueType, FieldOption, FieldTypeDefinition, NarrowFields, RegisteredFieldTypes, InferFormValue, FormConfig } from '@ng-forge/dynamic-forms';
+import { FormEvent, NextPageEvent, PreviousPageEvent, AppendArrayItemEvent, ArrayAllowedChildren, PrependArrayItemEvent, InsertArrayItemEvent, RemoveAtIndexEvent, PopArrayItemEvent, ShiftArrayItemEvent, FieldComponent, DynamicText, FormEventConstructor, ArrayItemContext, CheckedFieldComponent, FieldMeta, ValidationMessages, ValueFieldComponent, ValueType, FieldOption, FieldTypeDefinition, NarrowFields, RegisteredFieldTypes, InferFormValue, FormConfig } from '@ng-forge/dynamic-forms';
 import * as _ng_forge_dynamic_forms_integration from '@ng-forge/dynamic-forms/integration';
 import { ButtonField, EventArgs, CheckboxField, DatepickerField, DatepickerProps, InputMeta, InputField, InputProps, MultiCheckboxField, RadioField, SelectField, SelectProps, SliderField, TextareaField, TextareaProps, TextareaMeta, ToggleField } from '@ng-forge/dynamic-forms/integration';
 import * as _angular_core from '@angular/core';
@@ -20,66 +20,97 @@ type IonicButtonComponent<TEvent extends FormEvent> = FieldComponent<IonicButton
  * Specific button field types with preconfigured events
  */
 /** Submit button field - automatically disabled when form is invalid */
-interface IonicSubmitButtonField extends Omit<FieldDef<IonicButtonProps>, 'event'> {
+type IonicSubmitButtonField = Omit<IonicButtonField<SubmitEvent>, 'event' | 'type' | 'eventArgs'> & {
     type: 'submit';
-    key: string;
-    label: string;
-    disabled?: boolean;
-    className?: string;
-    props?: IonicButtonProps;
-    /** Logic rules for dynamic disabled state (overrides form-level defaults) */
-    logic?: LogicConfig[];
-}
+};
 /** Next page button field - with preconfigured NextPageEvent */
-interface IonicNextButtonField extends Omit<FieldDef<IonicButtonProps>, 'event'> {
+type IonicNextButtonField = Omit<IonicButtonField<NextPageEvent>, 'event' | 'type' | 'eventArgs'> & {
     type: 'next';
-    key: string;
-    label: string;
-    disabled?: boolean;
-    className?: string;
-    props?: IonicButtonProps;
-    /** Logic rules for dynamic disabled state (overrides form-level defaults) */
-    logic?: LogicConfig[];
-}
+};
 /** Previous page button field - with preconfigured PreviousPageEvent */
-interface IonicPreviousButtonField extends Omit<FieldDef<IonicButtonProps>, 'event'> {
+type IonicPreviousButtonField = Omit<IonicButtonField<PreviousPageEvent>, 'event' | 'type' | 'eventArgs'> & {
     type: 'previous';
-    key: string;
-    label: string;
-    disabled?: boolean;
-    className?: string;
-    props?: IonicButtonProps;
-}
-/** Add array item button field - with preconfigured AddArrayItemEvent */
-interface AddArrayItemButtonField extends Omit<FieldDef<IonicButtonProps>, 'event'> {
+};
+/** Add array item button field - dispatches AppendArrayItemEvent */
+type AddArrayItemButtonField = Omit<IonicButtonField<AppendArrayItemEvent>, 'event' | 'type' | 'eventArgs'> & {
     type: 'addArrayItem';
-    key: string;
-    label: string;
-    disabled?: boolean;
-    className?: string;
-    props?: IonicButtonProps;
     /**
      * The key of the array field to add items to.
      * Required when the button is placed outside the array.
      * When inside an array, this is automatically determined from context.
      */
     arrayKey?: string;
-}
-/** Remove array item button field - with preconfigured RemoveArrayItemEvent */
-interface RemoveArrayItemButtonField extends Omit<FieldDef<IonicButtonProps>, 'event'> {
+    /**
+     * Template for the new array item. REQUIRED.
+     * - Single field (ArrayAllowedChildren): Creates a primitive item (field's value is extracted directly)
+     * - Array of fields (ArrayAllowedChildren[]): Creates an object item (fields merged into object)
+     */
+    template: ArrayAllowedChildren | readonly ArrayAllowedChildren[];
+};
+/** Prepend array item button field - dispatches PrependArrayItemEvent (adds at beginning) */
+type PrependArrayItemButtonField = Omit<IonicButtonField<PrependArrayItemEvent>, 'event' | 'type' | 'eventArgs'> & {
+    type: 'prependArrayItem';
+    /**
+     * The key of the array field to prepend items to.
+     * Required when the button is placed outside the array.
+     * When inside an array, this is automatically determined from context.
+     */
+    arrayKey?: string;
+    /**
+     * Template for the new array item. REQUIRED.
+     * - Single field (ArrayAllowedChildren): Creates a primitive item (field's value is extracted directly)
+     * - Array of fields (ArrayAllowedChildren[]): Creates an object item (fields merged into object)
+     */
+    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';
+    /**
+     * The key of the array field to insert items into.
+     * Required when the button is placed outside the array.
+     * When inside an array, this is automatically determined from context.
+     */
+    arrayKey?: string;
+    /**
+     * The index at which to insert the new item.
+     */
+    index: number;
+    /**
+     * Template for the new array item. REQUIRED.
+     * - Single field (ArrayAllowedChildren): Creates a primitive item (field's value is extracted directly)
+     * - Array of fields (ArrayAllowedChildren[]): Creates an object item (fields merged into object)
+     */
+    template: ArrayAllowedChildren | readonly ArrayAllowedChildren[];
+};
+/** Remove array item button field - dispatches RemoveAtIndexEvent or PopArrayItemEvent */
+type RemoveArrayItemButtonField = Omit<IonicButtonField<RemoveAtIndexEvent>, 'event' | 'type' | 'eventArgs'> & {
     type: 'removeArrayItem';
-    key: string;
-    label: string;
-    disabled?: boolean;
-    className?: string;
-    props?: IonicButtonProps;
     /**
      * The key of the array field to remove items from.
      * Required when the button is placed outside the array.
      * When inside an array, this is automatically determined from context.
      */
     arrayKey?: string;
-}
+};
+/** Pop array item button field - dispatches PopArrayItemEvent (removes last item) */
+type PopArrayItemButtonField = Omit<IonicButtonField<PopArrayItemEvent>, 'event' | 'type' | 'eventArgs'> & {
+    type: 'popArrayItem';
+    /**
+     * The key of the array field to remove the last item from.
+     * REQUIRED - must specify which array to pop from.
+     */
+    arrayKey: string;
+};
+/** Shift array item button field - dispatches ShiftArrayItemEvent (removes first item) */
+type ShiftArrayItemButtonField = Omit<IonicButtonField<ShiftArrayItemEvent>, 'event' | 'type' | 'eventArgs'> & {
+    type: 'shiftArrayItem';
+    /**
+     * The key of the array field to remove the first item from.
+     * REQUIRED - must specify which array to shift from.
+     */
+    arrayKey: string;
+};
 
 declare class IonicButtonFieldComponent<TEvent extends FormEvent> implements IonicButtonComponent<TEvent> {
     private readonly eventBus;
@@ -624,7 +655,11 @@ declare const IonicField: {
     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 Textarea: "textarea";
     readonly Radio: "radio";
     readonly MultiCheckbox: "multi-checkbox";
@@ -702,7 +737,11 @@ declare module '@ng-forge/dynamic-forms' {
         slider: IonicSliderField;
         toggle: IonicToggleField;
         addArrayItem: AddArrayItemButtonField;
+        prependArrayItem: PrependArrayItemButtonField;
+        insertArrayItem: InsertArrayItemButtonField;
         removeArrayItem: RemoveArrayItemButtonField;
+        popArrayItem: PopArrayItemButtonField;
+        shiftArrayItem: ShiftArrayItemButtonField;
     }
 }
 
@@ -773,4 +812,4 @@ declare module '@ng-forge/dynamic-forms' {
 }
 
 export { IONIC_CONFIG, IONIC_FIELD_TYPES, IonicButtonFieldComponent, IonicCheckboxFieldComponent, IonicDatepickerFieldComponent, IonicField, IonicInputFieldComponent, IonicMultiCheckboxFieldComponent, IonicRadioFieldComponent, IonicSelectFieldComponent, IonicSliderFieldComponent, IonicTextareaFieldComponent, IonicToggleFieldComponent, withIonicFields };
-export type { AddArrayItemButtonField, IonicButtonField, IonicButtonProps, IonicCheckboxComponent, IonicCheckboxField, IonicCheckboxProps, IonicConfig, IonicDatepickerComponent, IonicDatepickerField, IonicDatepickerProps, IonicFieldType, IonicFormConfig, IonicFormProps, IonicInputComponent, IonicInputField, IonicInputProps, IonicMultiCheckboxComponent, IonicMultiCheckboxField, IonicMultiCheckboxProps, IonicNextButtonField, IonicPreviousButtonField, IonicRadioComponent, IonicRadioField, IonicRadioProps, IonicSelectComponent, IonicSelectField, IonicSelectProps, IonicSliderComponent, IonicSliderField, IonicSliderProps, IonicSubmitButtonField, IonicTextareaComponent, IonicTextareaField, IonicTextareaProps, IonicToggleComponent, IonicToggleField, IonicToggleProps, RemoveArrayItemButtonField };
+export type { AddArrayItemButtonField, InsertArrayItemButtonField, IonicButtonField, IonicButtonProps, IonicCheckboxComponent, IonicCheckboxField, IonicCheckboxProps, IonicConfig, IonicDatepickerComponent, IonicDatepickerField, IonicDatepickerProps, IonicFieldType, IonicFormConfig, IonicFormProps, IonicInputComponent, IonicInputField, IonicInputProps, IonicMultiCheckboxComponent, IonicMultiCheckboxField, IonicMultiCheckboxProps, IonicNextButtonField, IonicPreviousButtonField, IonicRadioComponent, IonicRadioField, IonicRadioProps, IonicSelectComponent, IonicSelectField, IonicSelectProps, IonicSliderComponent, IonicSliderField, IonicSliderProps, IonicSubmitButtonField, IonicTextareaComponent, IonicTextareaField, IonicTextareaProps, IonicToggleComponent, IonicToggleField, IonicToggleProps, PopArrayItemButtonField, PrependArrayItemButtonField, RemoveArrayItemButtonField, ShiftArrayItemButtonField };