@ng-forge/dynamic-forms-bootstrap 0.5.1 → 0.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ng-forge/dynamic-forms-bootstrap",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "Bootstrap 5 integration for @ng-forge/dynamic-forms. Pre-built Bootstrap form components.",
   "type": "module",
   "license": "MIT",
@@ -31,7 +31,7 @@
     "@angular/common": "~21.1.0",
     "@angular/core": "~21.1.0",
     "@angular/forms": "~21.1.0",
-    "@ng-forge/dynamic-forms": "~0.5.0",
+    "@ng-forge/dynamic-forms": "~0.6.0",
     "rxjs": ">=7.0.0"
   },
   "module": "fesm2022/ng-forge-dynamic-forms-bootstrap.mjs",

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

@@ -1,4 +1,4 @@
-import { FormEvent, FieldDef, LogicConfig, FieldComponent, DynamicText, FormEventConstructor, ArrayItemContext, CheckedFieldComponent, ValidationMessages, FieldMeta, 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, ValidationMessages, FieldMeta, 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';
@@ -19,66 +19,97 @@ type BsButtonComponent<TEvent extends FormEvent> = FieldComponent<BsButtonField<
  * Specific button field types with preconfigured events
  */
 /** Submit button field - automatically disabled when form is invalid */
-interface BsSubmitButtonField extends Omit<FieldDef<BsButtonProps>, 'event'> {
+type BsSubmitButtonField = Omit<BsButtonField<SubmitEvent>, 'event' | 'type' | 'eventArgs'> & {
     type: 'submit';
-    key: string;
-    label: string;
-    disabled?: boolean;
-    className?: string;
-    props?: BsButtonProps;
-    /** Logic rules for dynamic disabled state (overrides form-level defaults) */
-    logic?: LogicConfig[];
-}
+};
 /** Next page button field - with preconfigured NextPageEvent */
-interface BsNextButtonField extends Omit<FieldDef<BsButtonProps>, 'event'> {
+type BsNextButtonField = Omit<BsButtonField<NextPageEvent>, 'event' | 'type' | 'eventArgs'> & {
     type: 'next';
-    key: string;
-    label: string;
-    disabled?: boolean;
-    className?: string;
-    props?: BsButtonProps;
-    /** Logic rules for dynamic disabled state (overrides form-level defaults) */
-    logic?: LogicConfig[];
-}
+};
 /** Previous page button field - with preconfigured PreviousPageEvent */
-interface BsPreviousButtonField extends Omit<FieldDef<BsButtonProps>, 'event'> {
+type BsPreviousButtonField = Omit<BsButtonField<PreviousPageEvent>, 'event' | 'type' | 'eventArgs'> & {
     type: 'previous';
-    key: string;
-    label: string;
-    disabled?: boolean;
-    className?: string;
-    props?: BsButtonProps;
-}
-/** Add array item button field - with preconfigured AddArrayItemEvent */
-interface AddArrayItemButtonField extends Omit<FieldDef<BsButtonProps>, 'event'> {
+};
+/** Add array item button field - dispatches AppendArrayItemEvent */
+type AddArrayItemButtonField = Omit<BsButtonField<AppendArrayItemEvent>, 'event' | 'type' | 'eventArgs'> & {
     type: 'addArrayItem';
-    key: string;
-    label: string;
-    disabled?: boolean;
-    className?: string;
-    props?: BsButtonProps;
     /**
      * 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<BsButtonProps>, '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<BsButtonField<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<BsButtonField<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<BsButtonField<RemoveAtIndexEvent>, 'event' | 'type' | 'eventArgs'> & {
     type: 'removeArrayItem';
-    key: string;
-    label: string;
-    disabled?: boolean;
-    className?: string;
-    props?: BsButtonProps;
     /**
      * 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<BsButtonField<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<BsButtonField<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 BsButtonFieldComponent<TEvent extends FormEvent> implements BsButtonComponent<TEvent> {
     private readonly eventBus;
@@ -572,7 +603,11 @@ declare const BsField: {
     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";
@@ -643,7 +678,11 @@ declare module '@ng-forge/dynamic-forms' {
         next: BsNextButtonField;
         previous: BsPreviousButtonField;
         addArrayItem: AddArrayItemButtonField;
+        prependArrayItem: PrependArrayItemButtonField;
+        insertArrayItem: InsertArrayItemButtonField;
         removeArrayItem: RemoveArrayItemButtonField;
+        popArrayItem: PopArrayItemButtonField;
+        shiftArrayItem: ShiftArrayItemButtonField;
         textarea: BsTextareaField;
         radio: BsRadioField<unknown>;
         'multi-checkbox': BsMultiCheckboxField<unknown>;
@@ -699,4 +738,4 @@ type FieldTypeDefinitionsWithConfig = FieldTypeDefinition[] & {
 declare function withBootstrapFields(config?: BootstrapConfig): FieldTypeDefinitionsWithConfig;
 
 export { BOOTSTRAP_CONFIG, BOOTSTRAP_FIELD_TYPES, BsButtonFieldComponent, BsCheckboxFieldComponent, BsDatepickerFieldComponent, BsField, BsInputFieldComponent, BsMultiCheckboxFieldComponent, BsRadioFieldComponent, BsSelectFieldComponent, BsSliderFieldComponent, BsTextareaFieldComponent, BsToggleFieldComponent, withBootstrapFields };
-export type { AddArrayItemButtonField, BootstrapConfig, BsButtonField, BsButtonProps, BsCheckboxComponent, BsCheckboxField, BsCheckboxProps, BsDatepickerComponent, BsDatepickerField, BsDatepickerProps, BsFieldType, BsFormConfig, BsFormProps, BsInputComponent, BsInputField, BsInputProps, BsMultiCheckboxComponent, BsMultiCheckboxField, BsMultiCheckboxProps, BsNextButtonField, BsPreviousButtonField, BsRadioComponent, BsRadioField, BsRadioProps, BsSelectComponent, BsSelectField, BsSelectProps, BsSliderComponent, BsSliderField, BsSliderProps, BsSubmitButtonField, BsTextareaComponent, BsTextareaField, BsTextareaProps, BsToggleComponent, BsToggleField, BsToggleProps, RemoveArrayItemButtonField };
+export type { AddArrayItemButtonField, BootstrapConfig, BsButtonField, BsButtonProps, BsCheckboxComponent, BsCheckboxField, BsCheckboxProps, BsDatepickerComponent, BsDatepickerField, BsDatepickerProps, BsFieldType, BsFormConfig, BsFormProps, BsInputComponent, BsInputField, BsInputProps, BsMultiCheckboxComponent, BsMultiCheckboxField, BsMultiCheckboxProps, BsNextButtonField, BsPreviousButtonField, BsRadioComponent, BsRadioField, BsRadioProps, BsSelectComponent, BsSelectField, BsSelectProps, BsSliderComponent, BsSliderField, BsSliderProps, BsSubmitButtonField, BsTextareaComponent, BsTextareaField, BsTextareaProps, BsToggleComponent, BsToggleField, BsToggleProps, InsertArrayItemButtonField, PopArrayItemButtonField, PrependArrayItemButtonField, RemoveArrayItemButtonField, ShiftArrayItemButtonField };