@ng-forge/dynamic-forms-ionic 0.10.0-next.1 → 0.10.0-next.3

package/fesm2022/ng-forge-dynamic-forms-ionic.mjs

@@ -70,7 +70,6 @@ var ionicButton_component = /*#__PURE__*/Object.freeze({
   default: IonicButtonFieldComponent
 });
 
-// Public API - component
 
 class IonicCheckboxFieldComponent {
     ngf = injectNgForgeField();
@@ -147,9 +146,7 @@ class IonicDatepickerFieldComponent {
     }
     onDateChange(event) {
         const value = event.detail.value;
-        // ion-datetime emits ISO 8601 strings internally; convert to Date | null
-        // to match the field tree's value type.
-        if (value && typeof value === 'string' && value.length > 0) {
+                        if (value && typeof value === 'string' && value.length > 0) {
             const date = new Date(value);
             this.ngf.field()().value.set(date);
         }
@@ -318,18 +315,10 @@ var ionicDatepicker_component = /*#__PURE__*/Object.freeze({
   default: IonicDatepickerFieldComponent
 });
 
-/** Ionic adapter binding for the shared preset runner. */
 function runIonicPresetAction(preset, ctx, collaborators) {
     return runPresetAction(preset, ctx, collaborators, 'Ionic', 'ion-input');
 }
 
-/**
- * Inline `ion-button` addon — the host element IS `<ion-button>` so Ionic's
- * `::slotted(ion-button[slot=start|end])` shadow CSS matches and applies its
- * native icon-only sizing. `IonButtonAddonComponent` (tag selector) stays
- * for the universal `<df-addon-slot>` dispatcher when the addon is rendered
- * outside an `<ion-input>` host.
- */
 class IonInlineButtonAddonComponent {
     injector = inject(Injector);
     action = injectNgForgeAddonAction();
@@ -340,9 +329,7 @@ class IonInlineButtonAddonComponent {
     color = computed(() => this.addon().color, ...(ngDevMode ? [{ debugName: "color" }] : /* istanbul ignore next */ []));
     fill = computed(() => this.addon().fill ?? 'clear', ...(ngDevMode ? [{ debugName: "fill" }] : /* istanbul ignore next */ []));
     iconOnly = computed(() => !!this.icon() && !this.label(), ...(ngDevMode ? [{ debugName: "iconOnly" }] : /* istanbul ignore next */ []));
-    // Host bindings can't use pipes (NG5001), so `DynamicText` is materialised
-    // via an effect (resolveDynamicValue's toSignal can't run inside computed).
-    _ariaLabelSignal = signal(undefined, ...(ngDevMode ? [{ debugName: "_ariaLabelSignal" }] : /* istanbul ignore next */ []));
+            _ariaLabelSignal = signal(undefined, ...(ngDevMode ? [{ debugName: "_ariaLabelSignal" }] : /* istanbul ignore next */ []));
     resolvedAriaLabel = computed(() => this._ariaLabelSignal()?.() ?? undefined, ...(ngDevMode ? [{ debugName: "resolvedAriaLabel" }] : /* istanbul ignore next */ []));
     constructor() {
         explicitEffect([this.ariaLabel], ([raw]) => {
@@ -379,8 +366,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
       {{ lbl | dynamicText | async }}
     }
   `, host: {
-                        // Stencil reflects [attr.*] to the underlying ion-button properties.
-                        '[attr.color]': 'color() ?? null',
+                                                '[attr.color]': 'color() ?? null',
                         '[attr.fill]': 'fill()',
                         '[attr.disabled]': 'action.disabled() || action.loading() ? "true" : null',
                         '[attr.aria-label]': 'resolvedAriaLabel() ?? null',
@@ -389,86 +375,31 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
                     }, changeDetection: ChangeDetectionStrategy.OnPush, styles: [".df-ion-sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0}\n"] }]
         }], ctorParameters: () => [] });
 
-/**
- * Injection token for Ionic form configuration.
- * Use this to provide global configuration for Ionic form fields.
- *
- * @example
- * ```typescript
- * import { provideDynamicForm } from '@ng-forge/dynamic-forms';
- * import { withIonicFields } from '@ng-forge/dynamic-forms-ionic';
- *
- * export const appConfig: ApplicationConfig = {
- *   providers: [
- *     provideDynamicForm(
- *       ...withIonicFields({
- *         fill: 'outline',
- *         labelPlacement: 'floating'
- *       })
- *     )
- *   ]
- * };
- * ```
- */
 const IONIC_CONFIG = new InjectionToken('IONIC_CONFIG');
 
-/**
- * Per-field writable signal that overrides the input's `type` attribute.
- *
- * Provided at the `ion-input` field component level. The button addon's
- * `'toggle-password-visibility'` preset writes to it; the field component
- * reads it to compute its effective `type`.
- *
- * Optional from a button's perspective — when the button is hosted inside a
- * field that doesn't provide this token (e.g., textarea or a future
- * non-input field), the toggle preset is a no-op.
- */
 const IONIC_INPUT_TYPE_OVERRIDE = new InjectionToken('IONIC_INPUT_TYPE_OVERRIDE');
 
-// minlength/maxlength bindings: Signal Forms auto-syncs these on NATIVE
-// inputs; <ion-input> is a Stencil web component so we bind directly from
-// FieldState (`f().maxLength?.()` — the signal itself is missing when no
-// validator is configured).
 class IonicInputFieldComponent {
     elementRef = inject((ElementRef));
     ionicConfig = inject(IONIC_CONFIG, { optional: true });
     ngf = injectNgForgeField();
     ngfa = injectNgForgeAddons();
     props = input(...(ngDevMode ? [undefined, { debugName: "props" }] : /* istanbul ignore next */ []));
-    /**
-     * Wrapper-style host bag pushed by `DfFieldOutlet`. Declared at the
-     * component level so `setInputIfDeclared` (which uses
-     * `reflectComponentType`) can write it.
-     */
-    fieldInputs = input(...(ngDevMode ? [undefined, { debugName: "fieldInputs" }] : /* istanbul ignore next */ []));
-    /** Per-instance type override populated by `toggle-password-visibility` preset. */
-    typeOverride = inject(IONIC_INPUT_TYPE_OVERRIDE);
+        fieldInputs = input(...(ngDevMode ? [undefined, { debugName: "fieldInputs" }] : /* istanbul ignore next */ []));
+        typeOverride = inject(IONIC_INPUT_TYPE_OVERRIDE);
     fill = computed(() => this.props()?.fill ?? this.ionicConfig?.fill ?? 'solid', ...(ngDevMode ? [{ debugName: "fill" }] : /* istanbul ignore next */ []));
     shape = computed(() => this.props()?.shape ?? this.ionicConfig?.shape, ...(ngDevMode ? [{ debugName: "shape" }] : /* istanbul ignore next */ []));
-    /** Default 'stacked' (label above the input) for adapter parity with Material /
-     *  Bootstrap / PrimeNG. Consumers can opt into Ionic's native inline 'start'
-     *  or 'fixed' via props.labelPlacement or the IONIC_CONFIG token. */
-    labelPlacement = computed(() => this.props()?.labelPlacement ?? this.ionicConfig?.labelPlacement ?? 'stacked', ...(ngDevMode ? [{ debugName: "labelPlacement" }] : /* istanbul ignore next */ []));
+        labelPlacement = computed(() => this.props()?.labelPlacement ?? this.ionicConfig?.labelPlacement ?? 'stacked', ...(ngDevMode ? [{ debugName: "labelPlacement" }] : /* istanbul ignore next */ []));
     color = computed(() => this.props()?.color ?? this.ionicConfig?.color, ...(ngDevMode ? [{ debugName: "color" }] : /* istanbul ignore next */ []));
-    /** Override (set by `toggle-password-visibility` preset) wins over `props().type`. */
-    type = computed(() => this.typeOverride() ?? this.props()?.type ?? 'text', ...(ngDevMode ? [{ debugName: "type" }] : /* istanbul ignore next */ []));
-    /** Per-kind split: ion-button addons render inline via the attribute-
-     *  selector inline component (so the slotted element is a native
-     *  <ion-button> Ionic can style); everything else (icon/text/template/
-     *  component kinds) goes through the universal <df-addon-slot> dispatcher
-     *  wrapped in <span slot="start|end"> for safe shadow-DOM projection. */
-    buttonPrefixAddons = computed(() => this.ngfa.prefixAddons().filter((a) => a.kind === 'ion-button'), ...(ngDevMode ? [{ debugName: "buttonPrefixAddons" }] : /* istanbul ignore next */ []));
+        type = computed(() => this.typeOverride() ?? this.props()?.type ?? 'text', ...(ngDevMode ? [{ debugName: "type" }] : /* istanbul ignore next */ []));
+        buttonPrefixAddons = computed(() => this.ngfa.prefixAddons().filter((a) => a.kind === 'ion-button'), ...(ngDevMode ? [{ debugName: "buttonPrefixAddons" }] : /* istanbul ignore next */ []));
     buttonSuffixAddons = computed(() => this.ngfa.suffixAddons().filter((a) => a.kind === 'ion-button'), ...(ngDevMode ? [{ debugName: "buttonSuffixAddons" }] : /* istanbul ignore next */ []));
     decorativePrefixAddons = computed(() => this.ngfa.prefixAddons().filter((a) => a.kind !== 'ion-button'), ...(ngDevMode ? [{ debugName: "decorativePrefixAddons" }] : /* istanbul ignore next */ []));
     decorativeSuffixAddons = computed(() => this.ngfa.suffixAddons().filter((a) => a.kind !== 'ion-button'), ...(ngDevMode ? [{ debugName: "decorativeSuffixAddons" }] : /* istanbul ignore next */ []));
-    /** Set when the component is destroyed — guards async aria-describedby sync against teardown. */
-    destroyed = false;
+        destroyed = false;
     constructor() {
         inject(DestroyRef).onDestroy(() => (this.destroyed = true));
-        // ion-input encapsulates a native <input> in shadow DOM and does not automatically
-        // propagate aria-describedby to it. This effect imperatively syncs the attribute
-        // after a microtask to ensure Ionic has resolved the internal element.
-        explicitEffect([this.ngf.ariaDescribedBy], ([describedBy]) => {
+                                explicitEffect([this.ngf.ariaDescribedBy], ([describedBy]) => {
             queueMicrotask(() => {
                 if (this.destroyed)
                     return;
@@ -495,18 +426,12 @@ class IonicInputFieldComponent {
                 useFactory: () => signal(undefined),
             },
             {
-                // Adapter-specific preset semantics for `ion-button` addons (clear /
-                // reset / paste / copy / toggle-password-visibility). The directive
-                // (`NgForgeAddonAction`) delegates here when an addon configures a
-                // `preset`. Per-ion-input-instance so the `typeOverride` signal is
-                // scoped to one field.
-                provide: ADDON_PRESET_HANDLER,
+                                                                                                provide: ADDON_PRESET_HANDLER,
                 useFactory: () => {
                     const typeOverride = inject(IONIC_INPUT_TYPE_OVERRIDE);
                     const fsc = inject(FIELD_SIGNAL_CONTEXT, { optional: true });
                     const logger = inject(DynamicFormLogger);
-                    // forwardRef for baselineType only — host.props()?.type gates toggle-password-visibility.
-                    const host = inject(forwardRef(() => IonicInputFieldComponent));
+                                        const host = inject(forwardRef(() => IonicInputFieldComponent));
                     return {
                         run: (preset, ctx) => {
                             const fieldKey = ctx.field.key;
@@ -617,18 +542,12 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
                             useFactory: () => signal(undefined),
                         },
                         {
-                            // Adapter-specific preset semantics for `ion-button` addons (clear /
-                            // reset / paste / copy / toggle-password-visibility). The directive
-                            // (`NgForgeAddonAction`) delegates here when an addon configures a
-                            // `preset`. Per-ion-input-instance so the `typeOverride` signal is
-                            // scoped to one field.
-                            provide: ADDON_PRESET_HANDLER,
+                                                                                                                                                                        provide: ADDON_PRESET_HANDLER,
                             useFactory: () => {
                                 const typeOverride = inject(IONIC_INPUT_TYPE_OVERRIDE);
                                 const fsc = inject(FIELD_SIGNAL_CONTEXT, { optional: true });
                                 const logger = inject(DynamicFormLogger);
-                                // forwardRef for baselineType only — host.props()?.type gates toggle-password-visibility.
-                                const host = inject(forwardRef(() => IonicInputFieldComponent));
+                                                                const host = inject(forwardRef(() => IonicInputFieldComponent));
                                 return {
                                     run: (preset, ctx) => {
                                         const fieldKey = ctx.field.key;
@@ -659,8 +578,7 @@ class IonicMultiCheckboxFieldComponent {
         const currentValues = this.ngf.field()().value();
         return this.options().filter((option) => currentValues.includes(option.value));
     }, { ...(ngDevMode ? { debugName: "valueViewModel" } : /* istanbul ignore next */ {}), equal: isEqual });
-    /** Computed map of checked option values for O(1) lookup in template */
-    checkedValuesMap = computed(() => {
+        checkedValuesMap = computed(() => {
         const map = {};
         for (const opt of this.valueViewModel()) {
             map[String(opt.value)] = true;
@@ -1029,10 +947,7 @@ class IonicTextareaFieldComponent {
     ngf = injectNgForgeField();
     props = input(...(ngDevMode ? [undefined, { debugName: "props" }] : /* istanbul ignore next */ []));
     constructor() {
-        // ion-textarea encapsulates a native <textarea> in shadow DOM and does not automatically
-        // propagate aria-describedby to it. This effect imperatively syncs the attribute
-        // after a microtask to ensure Ionic has resolved the internal element.
-        explicitEffect([this.ngf.ariaDescribedBy], ([describedBy]) => {
+                                explicitEffect([this.ngf.ariaDescribedBy], ([describedBy]) => {
             queueMicrotask(() => {
                 const ionTextarea = this.elementRef.nativeElement.querySelector('ion-textarea');
                 if (ionTextarea?.getInputElement) {
@@ -1115,58 +1030,29 @@ var ionicTextarea_component = /*#__PURE__*/Object.freeze({
   default: IonicTextareaFieldComponent
 });
 
-/**
- * ion-toggle wrapper implementing FormCheckboxControl. Rendered inside
- * `df-ion-toggle`. `NgForgeControl` on `<ion-toggle>` claims the ambient
- * parent NgForgeField and routes meta + aria onto that element.
- */
 class IonicToggleControlComponent {
-    // ─────────────────────────────────────────────────────────────────────────────
-    // FormCheckboxControl implementation
-    // ─────────────────────────────────────────────────────────────────────────────
-    /** The checked state - required by FormCheckboxControl */
-    checked = model(false, ...(ngDevMode ? [{ debugName: "checked" }] : /* istanbul ignore next */ []));
-    /** Tracks whether the field has been touched - used by Field directive */
-    touched = model(false, ...(ngDevMode ? [{ debugName: "touched" }] : /* istanbul ignore next */ []));
-    /** Whether the field is disabled */
-    disabled = input(false, ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
-    /** Whether the field is readonly */
-    readonly = input(false, ...(ngDevMode ? [{ debugName: "readonly" }] : /* istanbul ignore next */ []));
-    /** Whether the field is invalid (from Field directive) */
-    invalid = input(false, ...(ngDevMode ? [{ debugName: "invalid" }] : /* istanbul ignore next */ []));
-    /** Whether the field is required (from Field directive) */
-    required = input(false, ...(ngDevMode ? [{ debugName: "required" }] : /* istanbul ignore next */ []));
-    // ─────────────────────────────────────────────────────────────────────────────
-    // Ionic-specific props
-    // ─────────────────────────────────────────────────────────────────────────────
-    labelPlacement = input('end', ...(ngDevMode ? [{ debugName: "labelPlacement" }] : /* istanbul ignore next */ []));
+                    checked = model(false, ...(ngDevMode ? [{ debugName: "checked" }] : /* istanbul ignore next */ []));
+        touched = model(false, ...(ngDevMode ? [{ debugName: "touched" }] : /* istanbul ignore next */ []));
+        disabled = input(false, ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
+        readonly = input(false, ...(ngDevMode ? [{ debugName: "readonly" }] : /* istanbul ignore next */ []));
+        invalid = input(false, ...(ngDevMode ? [{ debugName: "invalid" }] : /* istanbul ignore next */ []));
+        required = input(false, ...(ngDevMode ? [{ debugName: "required" }] : /* istanbul ignore next */ []));
+                labelPlacement = input('end', ...(ngDevMode ? [{ debugName: "labelPlacement" }] : /* istanbul ignore next */ []));
     justify = input(undefined, ...(ngDevMode ? [{ debugName: "justify" }] : /* istanbul ignore next */ []));
     color = input('primary', ...(ngDevMode ? [{ debugName: "color" }] : /* istanbul ignore next */ []));
     enableOnOffLabels = input(false, ...(ngDevMode ? [{ debugName: "enableOnOffLabels" }] : /* istanbul ignore next */ []));
     tabIndex = input(undefined, ...(ngDevMode ? [{ debugName: "tabIndex" }] : /* istanbul ignore next */ []));
-    // aria-invalid / aria-required / aria-describedby are written to <ion-toggle>
-    // by NgForgeControl. aria-readonly is Ionic-specific and stays template-side.
-    ariaReadonly = computed(() => (this.readonly() ? true : null), ...(ngDevMode ? [{ debugName: "ariaReadonly" }] : /* istanbul ignore next */ []));
-    /** Computed checked state - ensures proper boolean conversion for ion-toggle */
-    isChecked = computed(() => {
+            ariaReadonly = computed(() => (this.readonly() ? true : null), ...(ngDevMode ? [{ debugName: "ariaReadonly" }] : /* istanbul ignore next */ []));
+        isChecked = computed(() => {
         return this.checked() === true;
     }, ...(ngDevMode ? [{ debugName: "isChecked" }] : /* istanbul ignore next */ []));
-    /**
-     * ion-toggle doesn't have a native readonly attribute.
-     * When readonly, we disable the toggle to prevent changes while maintaining the visual state.
-     */
-    isEffectivelyDisabled = computed(() => {
+        isEffectivelyDisabled = computed(() => {
         return this.disabled() || this.readonly();
     }, ...(ngDevMode ? [{ debugName: "isEffectivelyDisabled" }] : /* istanbul ignore next */ []));
-    // ─────────────────────────────────────────────────────────────────────────────
-    // Event Handlers
-    // ─────────────────────────────────────────────────────────────────────────────
-    /** Handle toggle change - sync ion-toggle's checked state to our checked model */
-    onToggleChange(event) {
+                    onToggleChange(event) {
         this.checked.set(event.detail.checked);
     }
-    /** Marks the field as touched when toggle loses focus */
-    onBlur() {
+        onBlur() {
         this.touched.set(true);
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: IonicToggleControlComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
@@ -1269,13 +1155,7 @@ var ionicToggle_component = /*#__PURE__*/Object.freeze({
   default: IonicToggleFieldComponent
 });
 
-// Public exports for ionic field fields and types
-// Button
 
-/**
- * Ionic field type constants
- * Based on available field components in the /fields folder
- */
 const IonicField = {
     Input: 'input',
     Select: 'select',
@@ -1298,17 +1178,6 @@ const IonicField = {
     Toggle: 'toggle',
 };
 
-/**
- * Generic button mapper for custom events or basic buttons.
- * For specific button types (submit, next, prev, add/remove array items),
- * use the dedicated field types and their specific mappers.
- *
- * Supports template property for array events (AppendArrayItemEvent, PrependArrayItemEvent, InsertArrayItemEvent)
- * which enables the $template token in eventArgs.
- *
- * @param fieldDef The button field definition
- * @returns Signal containing Record of input names to values for ngComponentOutlet
- */
 function buttonFieldMapper(fieldDef) {
     const defaultProps = inject(DEFAULT_PROPS);
     const arrayContext = inject(ARRAY_CONTEXT, { optional: true });
@@ -1323,19 +1192,15 @@ function buttonFieldMapper(fieldDef) {
         if (fieldDef.hidden !== undefined) {
             inputs['hidden'] = fieldDef.hidden;
         }
-        // Add event binding for button events
-        if ('event' in fieldDef && fieldDef.event !== undefined) {
+                if ('event' in fieldDef && fieldDef.event !== undefined) {
             inputs['event'] = fieldDef.event;
         }
-        // Add eventArgs binding if provided
-        if ('eventArgs' in fieldDef && fieldDef.eventArgs !== undefined) {
+                if ('eventArgs' in fieldDef && fieldDef.eventArgs !== undefined) {
             inputs['eventArgs'] = fieldDef.eventArgs;
         }
-        // Add eventContext for token resolution (supports $template, $arrayKey, $index, etc.)
-        const template = 'template' in fieldDef ? fieldDef.template : undefined;
+                const template = 'template' in fieldDef ? fieldDef.template : undefined;
         if (template || arrayContext) {
-            // Read signal value if index is a signal (supports differential updates)
-            const getIndex = () => {
+                        const getIndex = () => {
                 if (!arrayContext)
                     return -1;
                 return isSignal(arrayContext.index) ? arrayContext.index() : arrayContext.index;
@@ -1352,12 +1217,6 @@ function buttonFieldMapper(fieldDef) {
     });
 }
 
-/**
- * Navigation button mappers for Ionic - re-exported from integration package.
- *
- * These mappers handle submit, next, and previous buttons with proper
- * disabled state resolution based on form validity and options.
- */
 
 const VALUE_FIELD_TYPES_BASE = {
     renderReadyWhen: ['field'],
@@ -1366,10 +1225,6 @@ const BUTTON_FIELD_TYPES_BASE = {
     renderReadyWhen: [],
     valueHandling: 'exclude',
 };
-/**
- * Ionic field type definitions
- * Follows the FieldTypeDefinition interface for proper registry integration
- */
 const IONIC_FIELD_TYPES = [
     {
         name: IonicField.Input,
@@ -1501,16 +1356,9 @@ const IONIC_FIELD_TYPES = [
     },
 ];
 
-/**
- * Module augmentation for @ng-forge/dynamic-form
- * This file augments the FieldRegistryLeaves interface to include
- * all Ionic field types provided by this library.
- */
 
 function withIonicFields(config) {
-    // Always include the addons feature — ion-icon / ion-button are part of
-    // the canonical Ionic surface.
-    const base = [...IONIC_FIELD_TYPES, withIonicAddons()];
+            const base = [...IONIC_FIELD_TYPES, withIonicAddons()];
     if (config) {
         base.push({
             ɵkind: 'ionic-config',
@@ -1534,39 +1382,15 @@ const ION_BUTTON_KIND = {
     kind: 'ion-button',
     loadComponent: () => Promise.resolve().then(function () { return ionButtonAddon_component; }).then((m) => m.IonButtonAddonComponent),
     validate: (addon, fieldKey) => {
-        // Exactly one of preset / actionRef / action — validator drops the addon
-        // (with warning) if the rule is violated.
-        const set = [addon.preset, addon.actionRef, addon.action].filter((v) => v !== undefined);
+                        const set = [addon.preset, addon.actionRef, addon.action].filter((v) => v !== undefined);
         if (set.length > 1) {
             throw new DynamicFormError(`Addon kind 'ion-button' on field '${fieldKey}' has more than one of preset/actionRef/action — exactly one allowed.`);
         }
-        // Icon-only buttons require ariaLabel for screen readers.
-        if (addon.icon && !addon.label && !addon.ariaLabel) {
+                if (addon.icon && !addon.label && !addon.ariaLabel) {
             throw new DynamicFormError(`Addon kind 'ion-button' on field '${fieldKey}' is icon-only — provide 'ariaLabel' for accessibility.`);
         }
     },
 };
-/**
- * Register Ionic-shipped addon kinds (`ion-icon`, `ion-button`) standalone.
- *
- * **Most users don't need this** — `withIonicFields()` auto-includes
- * these kinds. Call `withIonicAddons()` directly only when you want
- * Ionic addon kinds without the Ionic field types (e.g., a custom
- * field set that wants to render `ion-icon` prefixes), or when you're
- * stitching addons through a different DI scope.
- *
- * @example
- * ```typescript
- * // Custom field types + Ionic addon kinds.
- * provideDynamicForm(
- *   ...myCustomFields(),
- *   withIonicAddons(),
- * );
- * ```
- *
- * Adapter authors who need to override a kind with a customised renderer
- * should call `withCustomAddon(...)` directly instead.
- */
 function withIonicAddons() {
     return {
         ɵkind: 'addons',
@@ -1577,33 +1401,15 @@ function withIonicAddons() {
     };
 }
 
-/**
- * Renderer for the `ion-button` addon kind.
- *
- * Wraps Ionic's `<ion-button>`. Click dispatch (preset / actionRef /
- * action precedence, multi-set warning, `disabled` / `loading`
- * resolution) lives on `NgForgeAddonAction`; this component focuses on
- * the visual layer. While `action.loading()`, an `<ion-spinner>` is
- * rendered in place of the icon and the button is disabled.
- */
 class IonButtonAddonComponent {
     action = injectNgForgeAddonAction();
-    /** Re-exposed for template binding — same signal stored on the directive. */
-    addon = this.action.addon;
+        addon = this.action.addon;
     label = computed(() => this.addon().label, ...(ngDevMode ? [{ debugName: "label" }] : /* istanbul ignore next */ []));
     ariaLabel = computed(() => this.addon().ariaLabel, ...(ngDevMode ? [{ debugName: "ariaLabel" }] : /* istanbul ignore next */ []));
     icon = computed(() => this.addon().icon, ...(ngDevMode ? [{ debugName: "icon" }] : /* istanbul ignore next */ []));
-    /** Default color is undefined so the button inherits the theme's text color
-     *  (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. */
-    color = computed(() => this.addon().color, ...(ngDevMode ? [{ debugName: "color" }] : /* istanbul ignore next */ []));
+        color = computed(() => this.addon().color, ...(ngDevMode ? [{ debugName: "color" }] : /* istanbul ignore next */ []));
     fill = computed(() => this.addon().fill ?? 'clear', ...(ngDevMode ? [{ debugName: "fill" }] : /* istanbul ignore next */ []));
-    /** 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
-     *  is treated as "no label" so the button doesn't render an invisible text
-     *  slot beside the icon. */
-    iconOnly = computed(() => !!this.icon() && !this.label(), ...(ngDevMode ? [{ debugName: "iconOnly" }] : /* istanbul ignore next */ []));
+        iconOnly = computed(() => !!this.icon() && !this.label(), ...(ngDevMode ? [{ debugName: "iconOnly" }] : /* istanbul ignore next */ []));
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: IonButtonAddonComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
     static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.14", type: IonButtonAddonComponent, isStandalone: true, selector: "df-ion-button-addon", hostDirectives: [{ directive: i1.NgForgeAddonAction }], ngImport: i0, template: `
     <ion-button
@@ -1659,17 +1465,9 @@ var ionButtonAddon_component = /*#__PURE__*/Object.freeze({
   IonButtonAddonComponent: IonButtonAddonComponent
 });
 
-/**
- * Renderer for the `ion-icon` addon kind.
- *
- * Outputs `<ion-icon [name]="icon">`. The host is set `aria-hidden="true"`
- * by default; if the addon supplies an `ariaLabel`, it is applied so the
- * icon is announced by screen readers.
- */
 class IonIconAddonComponent {
     addon = input.required(...(ngDevMode ? [{ debugName: "addon" }] : /* istanbul ignore next */ []));
-    /** Accepted for contract uniformity — `NgComponentOutlet` setInput is strict; every kind must declare it. */
-    fieldInputs = input(...(ngDevMode ? [undefined, { debugName: "fieldInputs" }] : /* istanbul ignore next */ []));
+        fieldInputs = input(...(ngDevMode ? [undefined, { debugName: "fieldInputs" }] : /* istanbul ignore next */ []));
     iconName = computed(() => this.addon().icon, ...(ngDevMode ? [{ debugName: "iconName" }] : /* istanbul ignore next */ []));
     ariaLabel = computed(() => this.addon().ariaLabel, ...(ngDevMode ? [{ debugName: "ariaLabel" }] : /* istanbul ignore next */ []));
     hasAriaLabel = computed(() => this.addon().ariaLabel !== undefined, ...(ngDevMode ? [{ debugName: "hasAriaLabel" }] : /* istanbul ignore next */ []));
@@ -1694,11 +1492,7 @@ var ionIconAddon_component = /*#__PURE__*/Object.freeze({
   IonIconAddonComponent: IonIconAddonComponent
 });
 
-// Field fields
 
-/**
- * Generated bundle index. Do not edit.
- */
 
 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 };
 //# sourceMappingURL=ng-forge-dynamic-forms-ionic.mjs.map