@ng-forge/dynamic-forms-ionic 1.2.0-next.1 → 1.2.0-next.10

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

@@ -1,9 +1,11 @@
 import * as _ng_forge_dynamic_forms from '@ng-forge/dynamic-forms';
-import { FormEvent, FormSubmitEvent, NextPageEvent, PreviousPageEvent, AppendArrayItemEvent, ArrayAllowedChildren, PrependArrayItemEvent, InsertArrayItemEvent, RemoveAtIndexEvent, PopArrayItemEvent, ShiftArrayItemEvent, DynamicText, BaseAddon, DynamicValue, AddonActionPreset, RegisteredActionRef, TextAddon, TemplateAddon, ValueType, FieldOption, NarrowFields, RegisteredFieldTypes, InferFormValue, FormConfig } from '@ng-forge/dynamic-forms';
+import { FormEvent, FormSubmitEvent, NextPageEvent, PreviousPageEvent, AppendArrayItemEvent, ArrayAllowedChildren, PrependArrayItemEvent, InsertArrayItemEvent, RemoveAtIndexEvent, PopArrayItemEvent, ShiftArrayItemEvent, DynamicText, TextAddon, TemplateAddon, ValueType, FieldOption, NarrowFields, RegisteredFieldTypes, InferFormValue, FormConfig } from '@ng-forge/dynamic-forms';
 import * as i1 from '@ng-forge/dynamic-forms/integration';
-import { ButtonField, CheckboxField, DatepickerField, DatepickerProps, AddonActionHandler, InputField, InputProps, WrapperFieldInputs, MultiCheckboxField, RadioField, SelectField, SelectProps, SliderField, TextareaField, TextareaProps, ToggleField, FieldTypeDefinition } from '@ng-forge/dynamic-forms/integration';
+import { ButtonField, CheckboxField, DatepickerField, DatepickerProps, InputField, InputProps, WrapperFieldInputs, MultiCheckboxField, RadioField, SelectField, SelectProps, SliderField, TextareaField, TextareaProps, ToggleField, FieldTypeDefinition, WrapperTypeDefinition } from '@ng-forge/dynamic-forms/integration';
 import * as _angular_core from '@angular/core';
-import { InjectionToken, Provider, WritableSignal } from '@angular/core';
+import { Provider } from '@angular/core';
+import { IonicIconAddon, IonicButtonAddon, IonicConfig } from '@ng-forge/dynamic-forms-ionic/shared';
+export { IONIC_CONFIG, IONIC_INPUT_TYPE_OVERRIDE, IonicAddon, IonicButtonAddon, IonicConfig, IonicIconAddon } from '@ng-forge/dynamic-forms-ionic/shared';
 import * as _ng_forge_dynamic_forms_ionic from '@ng-forge/dynamic-forms-ionic';
 
 interface IonicButtonProps {
@@ -166,101 +168,6 @@ 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 Ionic fields. */
-interface IonicIconAddon extends BaseAddon {
-    readonly type: 'ion-icon';
-    /** Ionons name (e.g., `'search-outline'`, `'close-outline'`). */
-    readonly icon: string;
-    /** Accessible label for icons that convey meaning. */
-    readonly ariaLabel?: DynamicText;
-}
-/** Ionic-supported button colour palette. */
-type IonicButtonColor = 'primary' | 'secondary' | 'tertiary' | 'success' | 'warning' | 'danger' | 'light' | 'medium' | 'dark';
-/** Ionic-supported button fill variants. */
-type IonicButtonFill = 'clear' | 'outline' | 'solid' | 'default';
-/**
- * Common shape of every `ion-button` addon — properties that don't
- * participate in either XOR axis.
- */
-interface IonicButtonBase extends BaseAddon {
-    readonly type: 'ion-button';
-    /** Ion button colour. */
-    readonly color?: IonicButtonColor;
-    /** Ion button fill style. */
-    readonly fill?: IonicButtonFill;
-    /** Reactive loading state — renders an `<ion-spinner>` when truthy. */
-    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. The four shapes:
- */
-type IonicButtonClickPreset = {
-    /** 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 IonicButtonActionRef = [RegisteredActionRef] extends [never] ? string : RegisteredActionRef;
-type IonicButtonClickActionRef = {
-    readonly preset?: never;
-    /** Reference to a handler registered via `withAddonActions(...)`. JSON-safe. */
-    readonly actionRef: IonicButtonActionRef;
-    readonly action?: never;
-};
-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 IonicButtonClickNone = {
-    readonly preset?: never;
-    readonly actionRef?: never;
-    readonly action?: never;
-};
-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 IonicButtonContentIconOnly = {
-    readonly icon: string;
-    readonly label?: never;
-    /** REQUIRED: icon-only buttons must carry an accessible label. */
-    readonly ariaLabel: DynamicText;
-};
-type IonicButtonContentLabeled = {
-    readonly icon?: string;
-    readonly label: DynamicText;
-    readonly ariaLabel?: DynamicText;
-};
-type IonicButtonContentDecorative = {
-    readonly icon?: never;
-    readonly label?: never;
-    readonly ariaLabel?: DynamicText;
-};
-type IonicButtonContent = IonicButtonContentIconOnly | IonicButtonContentLabeled | IonicButtonContentDecorative;
-/** Interactive button addon for Ionic fields. */
-type IonicButtonAddon = IonicButtonBase & IonicButtonContent & IonicButtonClick;
-/** Union of all Ion-shipped addon types. */
-type IonicAddon = IonicIconAddon | IonicButtonAddon;
-declare module '@ng-forge/dynamic-forms' {
-    interface DynamicFormAddonRegistry {
-        'ion-icon': IonicIconAddon;
-        'ion-button': IonicButtonAddon;
-    }
-}
-
 interface IonicInputProps extends InputProps {
     fill?: 'solid' | 'outline';
     shape?: 'round';
@@ -463,64 +370,6 @@ declare class IonicToggleFieldComponent {
  */
 declare const IONIC_FIELD_TYPES: FieldTypeDefinition[];
 
-/** Configuration options for Ionic form fields. */
-interface IonicConfig {
-    /**
-     * Default fill style for form inputs
-     *
-     * @default 'solid'
-     */
-    fill?: 'solid' | 'outline';
-    /**
-     * Default shape for form controls
-     *
-     * @default undefined
-     */
-    shape?: 'round';
-    /**
-     * Default label placement for form inputs
-     *
-     * @default 'start'
-     */
-    labelPlacement?: 'start' | 'end' | 'fixed' | 'stacked' | 'floating';
-    /**
-     * Default color theme for form controls
-     *
-     * @default 'primary'
-     */
-    color?: 'primary' | 'secondary' | 'tertiary' | 'success' | 'warning' | 'danger' | 'light' | 'medium' | 'dark';
-    /**
-     * Default size for buttons
-     *
-     * @default 'default'
-     */
-    size?: 'small' | 'default' | 'large';
-    /**
-     * Default expand behavior for buttons
-     *
-     * @default undefined
-     */
-    expand?: 'full' | 'block';
-    /**
-     * Default fill style for buttons (overrides general fill if set)
-     *
-     * @default 'solid'
-     */
-    buttonFill?: 'clear' | 'outline' | 'solid' | 'default';
-    /**
-     * Whether buttons should be strong (bold) by default
-     *
-     * @default false
-     */
-    strong?: boolean;
-}
-
-/**
- * Injection token for Ionic form configuration.
- * Use this to provide global configuration for Ionic form fields.
- */
-declare const IONIC_CONFIG: InjectionToken<IonicConfig>;
-
 /**
  * Ionic field type constants
  * Based on available field components in the /fields folder
@@ -599,8 +448,8 @@ type IonicConfigFeature = {
  * Default `withIonicFields()` shape — field defs + the auto-included
  * addons feature so `ion-icon` / `ion-button` work out of the box.
  */
-type IonicFieldsWithAddons = [...IonicFieldTypes, IonicAddonsFeature];
-type IonicFieldsWithConfig = [...IonicFieldTypes, IonicAddonsFeature, IonicConfigFeature];
+type IonicFieldsWithAddons = [...IonicFieldTypes, IonicAddonsFeature, WrapperTypeDefinition];
+type IonicFieldsWithConfig = [...IonicFieldTypes, IonicAddonsFeature, WrapperTypeDefinition, IonicConfigFeature];
 /**
  * Provides Ionic field type definitions for the dynamic form system,
  * with Ionic-shipped addon types (`ion-icon`, `ion-button`) auto-included
@@ -637,7 +486,7 @@ declare class IonicButtonAddonComponent {
      *  (Ionic's `medium` would force low-contrast grey, which fails WCAG on dark
      *  surfaces). Consumers can still set `color: 'primary' | 'success' | ...`
      *  explicitly when they want adapter-styled coloring. */
-    protected readonly color: _angular_core.Signal<("primary" | "secondary" | "tertiary" | "success" | "warning" | "danger" | "light" | "medium" | "dark") | undefined>;
+    protected readonly color: _angular_core.Signal<"primary" | "secondary" | "tertiary" | "success" | "warning" | "danger" | "light" | "medium" | "dark" | undefined>;
     protected readonly fill: _angular_core.Signal<"clear" | "outline" | "solid" | "default">;
     /** Icon-only when there is an icon but no label — drives the `slot` choice.
      *  Truthy check on `label` mirrors Material's heuristic; empty-string label
@@ -660,8 +509,5 @@ declare class IonicIconAddonComponent {
     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, 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 };
+export { IONIC_FIELD_TYPES, IonicButtonAddonComponent, IonicButtonFieldComponent, IonicCheckboxFieldComponent, IonicDatepickerFieldComponent, IonicField, IonicIconAddonComponent, IonicInputFieldComponent, IonicMultiCheckboxFieldComponent, IonicRadioFieldComponent, IonicSelectFieldComponent, IonicSliderFieldComponent, IonicTextareaFieldComponent, IonicToggleFieldComponent, withIonicAddons, withIonicFields };
+export type { IonicAddArrayItemButtonField, IonicAddonExtensions, IonicButtonField, IonicButtonProps, IonicCheckboxField, IonicCheckboxProps, IonicDatepickerField, IonicDatepickerProps, IonicFieldType, IonicFormConfig, IonicFormProps, IonicInputAddon, IonicInputField, IonicInputProps, IonicInsertArrayItemButtonField, IonicMultiCheckboxField, IonicMultiCheckboxProps, IonicNextButtonField, IonicPopArrayItemButtonField, IonicPrependArrayItemButtonField, IonicPreviousButtonField, IonicRadioField, IonicRadioProps, IonicRemoveArrayItemButtonField, IonicSelectField, IonicSelectProps, IonicShiftArrayItemButtonField, IonicSliderField, IonicSliderProps, IonicSubmitButtonField, IonicTextareaField, IonicTextareaProps, IonicToggleField, IonicToggleProps };