@vsn-ux/ngx-gaia 0.9.3 → 0.9.5

package/index.d.ts

@@ -1,13 +1,13 @@
 import * as lucide_angular from 'lucide-angular';
 import { X, LucideIconData } from 'lucide-angular';
 import * as _angular_core from '@angular/core';
-import { Provider, Type, OnInit, InjectionToken, TemplateRef, WritableSignal, AfterViewInit, Renderer2, ElementRef, OnDestroy, AfterContentInit, Signal } from '@angular/core';
+import { Provider, Type, OnInit, InjectionToken, TemplateRef, OnDestroy, EnvironmentProviders, WritableSignal, AfterViewInit, Renderer2, ElementRef, AfterContentInit, Signal } from '@angular/core';
 import * as _angular_forms from '@angular/forms';
 import { ControlValueAccessor, CheckboxRequiredValidator, Validator, AbstractControl, ValidationErrors, NgControl, RequiredValidator, FormGroupDirective, NgForm } from '@angular/forms';
 import * as _angular_cdk_overlay from '@angular/cdk/overlay';
 import { CdkOverlayOrigin, ConnectedPosition, CdkConnectedOverlay } from '@angular/cdk/overlay';
-import * as i1 from '@angular/cdk/menu';
 import * as _vsn_ux_ngx_gaia from '@vsn-ux/ngx-gaia';
+import * as i1 from '@angular/cdk/menu';
 import * as rxjs from 'rxjs';
 import { Observable, Subject } from 'rxjs';
 import * as i1$1 from '@angular/cdk/a11y';
@@ -576,18 +576,6 @@ declare class GaInputModule {
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<GaInputModule>;
 }
 
-declare class GaFormControlDirective {
-    private readonly formFieldId;
-    readonly ngControlInput: _angular_core.InputSignal<string | NgControl | undefined>;
-    private readonly explicitNgControl;
-    private readonly ngControlState;
-    readonly inError: _angular_core.Signal<boolean>;
-    readonly errors: _angular_core.Signal<_angular_forms.ValidationErrors>;
-    readonly ariaErrorMessageId: _angular_core.Signal<string | null>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<GaFormControlDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GaFormControlDirective, "[gaFormControl]", ["gaFormControl"], { "ngControlInput": { "alias": "gaFormControl"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
 declare class GaFieldInfoComponent {
     readonly templateRef: _angular_core.Signal<TemplateRef<any>>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<GaFieldInfoComponent, never>;
@@ -601,10 +589,29 @@ declare class GaFieldErrorDirective {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GaFieldErrorDirective, "[gaError]", never, { "key": { "alias": "gaError"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+declare class GaFormControlDirective implements OnInit, OnDestroy {
+    private readonly formFieldId;
+    private readonly formFieldConnector;
+    readonly ngControlInput: _angular_core.InputSignal<string | NgControl | undefined>;
+    private readonly explicitNgControl;
+    private readonly ngControlState;
+    readonly inError: _angular_core.Signal<boolean>;
+    readonly errors: _angular_core.Signal<_angular_forms.ValidationErrors>;
+    readonly ariaErrorMessageId: _angular_core.Signal<string | null>;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<GaFormControlDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GaFormControlDirective, "[gaFormControl]", ["gaFormControl"], { "ngControlInput": { "alias": "gaFormControl"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * @internal - Internal service for form field coordination
+ */
 declare class GaFormFieldConnector {
     readonly controlDisabled: _angular_core.WritableSignal<boolean>;
     readonly controlId: _angular_core.WritableSignal<string | null>;
     readonly labelId: _angular_core.WritableSignal<string | null>;
+    readonly control: _angular_core.WritableSignal<GaFormControlDirective | null>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<GaFormFieldConnector, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<GaFormFieldConnector>;
 }
@@ -614,11 +621,11 @@ declare class GaFormFieldComponent {
     readonly formFieldConnector: GaFormFieldConnector;
     readonly disabledInput: _angular_core.InputSignalWithTransform<boolean | undefined, unknown>;
     readonly disabled: _angular_core.Signal<boolean>;
-    readonly formControl: _angular_core.Signal<GaFormControlDirective | undefined>;
+    readonly formControl: _angular_core.Signal<_vsn_ux_ngx_gaia.GaFormControlDirective | null>;
     readonly fieldInfo: _angular_core.Signal<GaFieldInfoComponent | undefined>;
     readonly fieldErrors: _angular_core.Signal<readonly GaFieldErrorDirective[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<GaFormFieldComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<GaFormFieldComponent, "ga-form-field", ["gaFormField"], { "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, ["formControl", "fieldInfo", "fieldErrors"], ["ga-label", "*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<GaFormFieldComponent, "ga-form-field", ["gaFormField"], { "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, ["fieldInfo", "fieldErrors"], ["ga-label", "*"], true, never>;
 }
 
 declare class GaFieldLabelComponent {
@@ -660,6 +667,43 @@ declare class GaFormFieldModule {
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<GaFormFieldModule>;
 }
 
+type GaFormErrorMessage = string | ((error: any) => string);
+type GaFormErrorsMap = Record<string, GaFormErrorMessage>;
+type GaFormErrorsConfig = GaFormErrorsMap | (() => GaFormErrorsMap);
+declare const GA_FORM_ERRORS: InjectionToken<GaFormErrorsMap>;
+/**
+ * Provides global form error messages that can be used across the application.
+ * These errors will be displayed when a form control has validation errors
+ * but no specific gaError directive template is provided.
+ *
+ * @param config - Either a static record of error messages or a factory function
+ * @returns EnvironmentProviders for configuring global form errors
+ *
+ * @example
+ * ```ts
+ * // Static configuration
+ * provideGaFormErrors({
+ *   required: 'This field is required',
+ *   email: 'Please enter a valid email address',
+ *   minlength: 'Input is too short'
+ * })
+ *
+ * // Dynamic configuration with functions that access error data
+ * provideGaFormErrors({
+ *   required: 'This field is required',
+ *   minlength: (error) => `Minimum ${error.requiredLength} characters required`,
+ *   pattern: (error) => `Input format is invalid. Expected pattern: ${error.requiredPattern}`
+ * })
+ *
+ * // Factory function for lazy evaluation
+ * provideGaFormErrors(() => ({
+ *   required: translateService.get('errors.required'),
+ *   email: translateService.get('errors.email')
+ * }))
+ * ```
+ */
+declare function provideGaFormErrors(config: GaFormErrorsConfig): EnvironmentProviders;
+
 declare class GaMenuComponent {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<GaMenuComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<GaMenuComponent, "ga-menu", never, {}, {}, never, ["*"], true, [{ directive: typeof i1.CdkMenu; inputs: {}; outputs: {}; }]>;
@@ -917,6 +961,12 @@ type GaTooltipPosition = 'top' | 'bottom' | 'left' | 'right';
 type GaTooltipDirection = 'start' | 'end' | 'center';
 type GaTooltipPlacement = `${GaTooltipPosition}-${GaTooltipDirection}`;
 type GaTooltipControlMode = 'hover' | 'click' | 'none';
+/**
+ * Internal tooltip component used by the gaTooltip directive.
+ * This component is not intended for direct use in templates.
+ * Use the [gaTooltip] directive instead.
+ * @internal
+ */
 declare class GaTooltipComponent {
     readonly uniqueId: string;
     private mouseLeaveSubject;
@@ -1127,7 +1177,13 @@ declare class GaSelectDropdownSpinnerComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<GaSelectDropdownSpinnerComponent, "ga-select-dropdown-spinner", never, {}, {}, never, never, true, never>;
 }
 
+/**
+ * @internal - Internal validator provider for ga-select required validation
+ */
 declare const GA_SELECT_REQUIRED_VALIDATOR: Provider;
+/**
+ * @internal - Internal directive for ga-select required validation
+ */
 declare class GaSelectRequiredValidator extends RequiredValidator {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<GaSelectRequiredValidator, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GaSelectRequiredValidator, "ga-select[required][formControlName], ga-select[required][formControl], ga-select[required][ngModel]", never, {}, {}, never, never, true, never>;
@@ -1302,6 +1358,9 @@ interface GaFormControlAdapter {
     readonly ngFormSubmitted: Signal<boolean>;
 }
 declare const GA_FORM_CONTROL_ADAPTER: InjectionToken<GaFormControlAdapter>;
+/**
+ * @internal - This function is for internal library use only
+ */
 declare function injectNgControlState({ implicitChildNgControl, explicitNgControl, explicitNgForm, }?: {
     implicitChildNgControl?: Signal<NgControl | undefined | null>;
     explicitNgControl?: NgControl | Signal<NgControl | undefined | null> | null;
@@ -1357,5 +1416,5 @@ declare class GaTextAreaModule {
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<GaTextAreaModule>;
 }
 
-export { CHECKBOX_CONTROL_VALUE_ACCESSOR, DEFAULT_MODAL_OPTIONS, GA_ALERT_I18N_FACTORY, GA_BASE_FONT_SIZE, GA_BUTTON_I18N_FACTORY, GA_CHECKBOX_REQUIRED_VALIDATOR, GA_DATEPICKER_I18N_FACTORY, GA_DATEPICKER_PARSER_FORMATTER_FACTORY, GA_DATEPICKER_VALUE_ADAPTER_FACTORY, GA_DATE_PARSER_FORMATTER_CONFIG, GA_DEFAULT_DATEPICKER_FORMATS, GA_FORM_CONTROL_ADAPTER, GA_ICON_DEFAULT_SIZE, GA_MODAL_DATA, GA_MODAL_I18N_FACTORY, GA_SELECT_I18N_FACTORY, GA_SELECT_REQUIRED_VALIDATOR, GA_TOOLTIP_DEFAULT_OFFSET, GaAlertComponent, GaAlertI18n, GaAlertI18nDefault, GaAlertModule, GaAlertTitleActionsComponent, GaAlertTitleComponent, GaBadgeComponent, GaBadgeModule, GaButtonDirective, GaButtonI18n, GaButtonI18nDefault, GaButtonModule, GaCardComponent, GaCardModule, GaCheckboxComponent, GaCheckboxModule, GaCheckboxRequiredValidator, GaDatepickerComponent, GaDatepickerI18n, GaDatepickerI18nDefault, GaDatepickerInputDirective, GaDatepickerModule, GaDatepickerNativeUtcIsoValueAdapter, GaDatepickerNativeUtcValueAdapter, GaDatepickerParserFormatter, GaDatepickerParserFormatterDefault, GaDatepickerStructValueAdapter, GaDatepickerToggleComponent, GaDatepickerValueAdapter, GaFieldErrorDirective, GaFieldInfoComponent, GaFieldLabelComponent, GaFormControlDirective, GaFormControlErrorsDirective, GaFormFieldComponent, GaFormFieldConnector, GaFormFieldModule, GaIconButtonDirective, GaIconComponent, GaIconModule, GaInputComponent, GaInputDirective, GaInputModule, GaLabelledByFormFieldDirective, GaLinkDirective, GaLinkModule, GaMenuComponent, GaMenuItemComponent, GaMenuModule, GaMenuSeparatorComponent, GaMenuTitleComponent, GaMenuTriggerDirective, GaMenuTriggerIconComponent, GaModalActionsComponent, GaModalCloseDirective, GaModalComponent, GaModalContentComponent, GaModalDescriptionComponent, GaModalDescriptionDirective, GaModalHeaderComponent, GaModalI18n, GaModalI18nDefault, GaModalLabelDirective, GaModalModule, GaModalOptions, GaModalRef, GaModalService, GaModalTitleDirective, GaOptgroupComponent, GaOptionComponent, GaRadioButtonComponent, GaRadioGroupComponent, GaRadioModule, GaSegmentedControlButtonDirective, GaSegmentedControlComponent, GaSegmentedControlIconButtonComponent, GaSegmentedControlModule, GaSegmentedControlTextButtonComponent, GaSelectComponent, GaSelectDropdownComponent, GaSelectDropdownSpinnerComponent, GaSelectI18n, GaSelectI18nDefault, GaSelectModule, GaSelectRequiredValidator, GaSelectValueComponent, GaSpinnerComponent, GaSpinnerModule, GaSwitchComponent, GaSwitchModule, GaTextAreaDirective, GaTextAreaModule, GaTooltipComponent, GaTooltipDirective, GaTooltipModule, RADIO_CONTROL_VALUE_ACCESSOR, SWITCH_CONTROL_VALUE_ACCESSOR, compareStructs, extendGaDateParserFormatter, injectNgControlState, provideGaAlertI18n, provideGaBaseFontSize, provideGaButtonI18n, provideGaDatepickerI18n, provideGaDatepickerParserFormatter, provideGaDatepickerValueAdapter, provideGaModalI18n, provideGaModalOptions, provideGaSelectI18n };
-export type { GaAlertVariant, GaBadgeType, GaBadgeVariant, GaButtonType, GaDatepickerFormats, GaDatepickerStruct, GaFormControlAdapter, GaIconButtonVariant, GaIconData, GaLinkSize, GaLinkVariant, GaModalRole, GaModalSize, GaModalType, GaTooltipControlMode, GaTooltipDirection, GaTooltipPlacement, GaTooltipPosition, IGaDatepickerI18n };
+export { CHECKBOX_CONTROL_VALUE_ACCESSOR, DEFAULT_MODAL_OPTIONS, GA_ALERT_I18N_FACTORY, GA_BASE_FONT_SIZE, GA_BUTTON_I18N_FACTORY, GA_CHECKBOX_REQUIRED_VALIDATOR, GA_DATEPICKER_I18N_FACTORY, GA_DATEPICKER_PARSER_FORMATTER_FACTORY, GA_DATEPICKER_VALUE_ADAPTER_FACTORY, GA_DATE_PARSER_FORMATTER_CONFIG, GA_DEFAULT_DATEPICKER_FORMATS, GA_FORM_CONTROL_ADAPTER, GA_FORM_ERRORS, GA_ICON_DEFAULT_SIZE, GA_MODAL_DATA, GA_MODAL_I18N_FACTORY, GA_SELECT_I18N_FACTORY, GA_SELECT_REQUIRED_VALIDATOR, GA_TOOLTIP_DEFAULT_OFFSET, GaAlertComponent, GaAlertI18n, GaAlertI18nDefault, GaAlertModule, GaAlertTitleActionsComponent, GaAlertTitleComponent, GaBadgeComponent, GaBadgeModule, GaButtonDirective, GaButtonI18n, GaButtonI18nDefault, GaButtonModule, GaCardComponent, GaCardModule, GaCheckboxComponent, GaCheckboxModule, GaCheckboxRequiredValidator, GaDatepickerComponent, GaDatepickerI18n, GaDatepickerI18nDefault, GaDatepickerInputDirective, GaDatepickerModule, GaDatepickerNativeUtcIsoValueAdapter, GaDatepickerNativeUtcValueAdapter, GaDatepickerParserFormatter, GaDatepickerParserFormatterDefault, GaDatepickerStructValueAdapter, GaDatepickerToggleComponent, GaDatepickerValueAdapter, GaFieldErrorDirective, GaFieldInfoComponent, GaFieldLabelComponent, GaFormControlDirective, GaFormControlErrorsDirective, GaFormFieldComponent, GaFormFieldConnector, GaFormFieldModule, GaIconButtonDirective, GaIconComponent, GaIconModule, GaInputComponent, GaInputDirective, GaInputModule, GaLabelledByFormFieldDirective, GaLinkDirective, GaLinkModule, GaMenuComponent, GaMenuItemComponent, GaMenuModule, GaMenuSeparatorComponent, GaMenuTitleComponent, GaMenuTriggerDirective, GaMenuTriggerIconComponent, GaModalActionsComponent, GaModalCloseDirective, GaModalComponent, GaModalContentComponent, GaModalDescriptionComponent, GaModalDescriptionDirective, GaModalHeaderComponent, GaModalI18n, GaModalI18nDefault, GaModalLabelDirective, GaModalModule, GaModalOptions, GaModalRef, GaModalService, GaModalTitleDirective, GaOptgroupComponent, GaOptionComponent, GaRadioButtonComponent, GaRadioGroupComponent, GaRadioModule, GaSegmentedControlButtonDirective, GaSegmentedControlComponent, GaSegmentedControlIconButtonComponent, GaSegmentedControlModule, GaSegmentedControlTextButtonComponent, GaSelectComponent, GaSelectDropdownComponent, GaSelectDropdownSpinnerComponent, GaSelectI18n, GaSelectI18nDefault, GaSelectModule, GaSelectRequiredValidator, GaSelectValueComponent, GaSpinnerComponent, GaSpinnerModule, GaSwitchComponent, GaSwitchModule, GaTextAreaDirective, GaTextAreaModule, GaTooltipComponent, GaTooltipDirective, GaTooltipModule, RADIO_CONTROL_VALUE_ACCESSOR, SWITCH_CONTROL_VALUE_ACCESSOR, compareStructs, extendGaDateParserFormatter, injectNgControlState, provideGaAlertI18n, provideGaBaseFontSize, provideGaButtonI18n, provideGaDatepickerI18n, provideGaDatepickerParserFormatter, provideGaDatepickerValueAdapter, provideGaFormErrors, provideGaModalI18n, provideGaModalOptions, provideGaSelectI18n };
+export type { GaAlertVariant, GaBadgeType, GaBadgeVariant, GaButtonType, GaDatepickerFormats, GaDatepickerStruct, GaFormControlAdapter, GaFormErrorMessage, GaFormErrorsConfig, GaFormErrorsMap, GaIconButtonVariant, GaIconData, GaLinkSize, GaLinkVariant, GaModalRole, GaModalSize, GaModalType, GaTooltipControlMode, GaTooltipDirection, GaTooltipPlacement, GaTooltipPosition, IGaDatepickerI18n };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vsn-ux/ngx-gaia",
-  "version": "0.9.3",
+  "version": "0.9.5",
   "peerDependencies": {
     "@angular/cdk": "^20.0.0",
     "@angular/common": "^20.0.0",