mn-angular-lib 1.0.141 → 1.0.142

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mn-angular-lib",
-  "version": "1.0.141",
+  "version": "1.0.142",
   "peerDependencies": {
     "@angular/common": "^21.1.3",
     "@angular/core": "^21.1.3",

package/types/mn-angular-lib.d.ts

@@ -11,6 +11,7 @@ import { ValidationErrors, NgControl, AbstractControl, ValidatorFn, AsyncValidat
 import { LucideIconData } from '@lucide/angular';
 export { LucideIconData } from '@lucide/angular';
 import { SafeHtml } from '@angular/platform-browser';
+import * as tailwind_merge from 'tailwind-merge';
 import { HttpStatusCode, HttpHeaders, HttpErrorResponse, HttpClient, HttpResponse, HttpParams } from '@angular/common/http';
 
 declare const mnAlertVariants: tailwind_variants.TVReturnType<{
@@ -7409,6 +7410,184 @@ declare class MnIconAttributes {
     static ɵdir: i0.ɵɵDirectiveDeclaration<MnIconAttributes, "mn-icon[mnIconPistol]", never, {}, {}, never, never, true, never>;
 }
 
+/**
+ * A single crumb in the breadcrumb trail.
+ *
+ * A crumb becomes a link when it carries an {@link href}; otherwise it renders
+ * as a button that only emits {@link MnBreadcrumbs.crumbClick} / runs
+ * {@link onClick}. The library stays router-agnostic — an app wires SPA
+ * navigation through `onClick`/`crumbClick`, or lets the `href` anchor navigate.
+ */
+type MnBreadcrumbItem = {
+    /** Translation key or literal label for the crumb. */
+    label: string;
+    /** Optional link target; when set the crumb renders as an `<a href>`. */
+    href?: string;
+    /** Optional callback invoked on click (fires alongside `crumbClick`). */
+    onClick?: () => void;
+};
+/**
+ * Data source for {@link MnBreadcrumbs}.
+ *
+ * When {@link items} holds crumbs the component renders a linkable trail whose
+ * **last** item is the current page (never a link). When `items` is empty the
+ * component degrades to a single "Back" control: it navigates to
+ * {@link backHref} when given, otherwise steps back through browser history.
+ */
+type MnBreadcrumbsData = {
+    /** Ordered crumbs root → current. Empty ⇒ the "Back" fallback renders instead. */
+    items: MnBreadcrumbItem[];
+    /** Fallback "Back" target. Set ⇒ renders `<a href>`; unset ⇒ `history.back()`. */
+    backHref?: string;
+    /** Translation key or literal for the "Back" label. Defaults to `'back'`. */
+    backLabel?: string;
+    /** Visual scale. Defaults to `'md'`. */
+    size?: 'sm' | 'md';
+};
+
+/**
+ * A flexible breadcrumb trail.
+ *
+ * Given crumbs it renders a linkable trail (`root › … › current`) where the last
+ * crumb is the current page and is never a link. Given no crumbs it degrades to
+ * a single "Back" control — the two are mutually exclusive. "Flexible" here is
+ * input-driven, not viewport-driven: there is deliberately no responsive
+ * collapse, no scroll machinery — it is a list of links plus a fallback.
+ *
+ * Navigation stays router- and history-agnostic where possible: a crumb (or the
+ * Back control) with an `href` renders a plain `<a>` and navigates natively;
+ * otherwise clicks emit outputs for the app to handle. Only the Back fallback
+ * with no `href` reaches for `history.back()`.
+ */
+declare class MnBreadcrumbs {
+    /** Trail crumbs and Back-fallback configuration. */
+    data: MnBreadcrumbsData;
+    /** Emits the crumb that was clicked (non-current crumbs only). */
+    crumbClick: EventEmitter<MnBreadcrumbItem>;
+    /** Emits when the fallback "Back" control is activated. */
+    back: EventEmitter<void>;
+    /** Default translation key / literal for the Back control's label. */
+    private static readonly DEFAULT_BACK_LABEL;
+    /** Resolved tailwind-variants slot functions for the current size. */
+    get styles(): {
+        root: (slotProps?: ({
+            size?: "sm" | "md" | undefined;
+        } & tailwind_variants.ClassProp<tailwind_merge.ClassNameValue>) | undefined) => string;
+        list: (slotProps?: ({
+            size?: "sm" | "md" | undefined;
+        } & tailwind_variants.ClassProp<tailwind_merge.ClassNameValue>) | undefined) => string;
+        link: (slotProps?: ({
+            size?: "sm" | "md" | undefined;
+        } & tailwind_variants.ClassProp<tailwind_merge.ClassNameValue>) | undefined) => string;
+        current: (slotProps?: ({
+            size?: "sm" | "md" | undefined;
+        } & tailwind_variants.ClassProp<tailwind_merge.ClassNameValue>) | undefined) => string;
+        separator: (slotProps?: ({
+            size?: "sm" | "md" | undefined;
+        } & tailwind_variants.ClassProp<tailwind_merge.ClassNameValue>) | undefined) => string;
+        back: (slotProps?: ({
+            size?: "sm" | "md" | undefined;
+        } & tailwind_variants.ClassProp<tailwind_merge.ClassNameValue>) | undefined) => string;
+    } & {
+        root: (slotProps?: ({
+            size?: "sm" | "md" | undefined;
+        } & tailwind_variants.ClassProp<tailwind_merge.ClassNameValue>) | undefined) => string;
+        list: (slotProps?: ({
+            size?: "sm" | "md" | undefined;
+        } & tailwind_variants.ClassProp<tailwind_merge.ClassNameValue>) | undefined) => string;
+        link: (slotProps?: ({
+            size?: "sm" | "md" | undefined;
+        } & tailwind_variants.ClassProp<tailwind_merge.ClassNameValue>) | undefined) => string;
+        current: (slotProps?: ({
+            size?: "sm" | "md" | undefined;
+        } & tailwind_variants.ClassProp<tailwind_merge.ClassNameValue>) | undefined) => string;
+        separator: (slotProps?: ({
+            size?: "sm" | "md" | undefined;
+        } & tailwind_variants.ClassProp<tailwind_merge.ClassNameValue>) | undefined) => string;
+        back: (slotProps?: ({
+            size?: "sm" | "md" | undefined;
+        } & tailwind_variants.ClassProp<tailwind_merge.ClassNameValue>) | undefined) => string;
+    } & {};
+    /** Whether a linkable trail should render (vs the Back fallback). */
+    get hasTrail(): boolean;
+    /** Label for the Back control — the configured key/literal, or the default. */
+    get backLabel(): string;
+    /** The last crumb is the current page and is rendered as plain text. */
+    isCurrent(index: number): boolean;
+    /** Runs a crumb's own callback and notifies listeners of the click. */
+    onCrumb(item: MnBreadcrumbItem): void;
+    /**
+     * Fallback Back action. Always emits `back` for listeners; when no `backHref`
+     * anchor is carrying the navigation, steps back through browser history.
+     */
+    onBack(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MnBreadcrumbs, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MnBreadcrumbs, "mn-breadcrumbs", never, { "data": { "alias": "data"; "required": false; }; }, { "crumbClick": "crumbClick"; "back": "back"; }, never, never, true, never>;
+}
+
+/**
+ * Styling for {@link MnBreadcrumbs}, expressed as tailwind-variants slots so the
+ * template can pull one class string per role. Theme tokens only, so the trail
+ * reads correctly in both light and dark. Links and the Back control are native
+ * `<button>`/`<a>` elements reset to look like plain text with a hover accent.
+ */
+declare const mnBreadcrumbsVariants: tailwind_variants.TVReturnType<{
+    size: {
+        sm: {
+            root: string;
+            list: string;
+        };
+        md: {
+            root: string;
+            list: string;
+        };
+    };
+}, {
+    root: string;
+    list: string;
+    link: string;
+    current: string;
+    separator: string;
+    back: string;
+}, undefined, {
+    size: {
+        sm: {
+            root: string;
+            list: string;
+        };
+        md: {
+            root: string;
+            list: string;
+        };
+    };
+}, {
+    root: string;
+    list: string;
+    link: string;
+    current: string;
+    separator: string;
+    back: string;
+}, tailwind_variants.TVReturnType<{
+    size: {
+        sm: {
+            root: string;
+            list: string;
+        };
+        md: {
+            root: string;
+            list: string;
+        };
+    };
+}, {
+    root: string;
+    list: string;
+    link: string;
+    current: string;
+    separator: string;
+    back: string;
+}, undefined, unknown, unknown, undefined>>;
+type MnBreadcrumbsVariants = VariantProps<typeof mnBreadcrumbsVariants>;
+
 /**
  * Types for mn-lib configuration.
  */
@@ -7902,5 +8081,5 @@ type MnPreviewMessage = {
  */
 declare function enableMnPreviewMode(configService: MnConfigService, langService: MnLanguageService, allowedOrigins?: string[]): void;
 
-export { API_BASE_URL, ActionStyle, BackdropMode, BaseModalBuilder, CALENDAR_CONFIG, CALENDAR_DATE_FORMATTER, CalendarDayComponent, CalendarEventComponent, CalendarEventDefaultComponent, CalendarEventLayoutService, CalendarMonthComponent, CalendarUtility, CalendarView, CalendarViewComponent, CalendarWeekComponent, CloseMode, ColumnSortType, ConfirmationModalBuilder, ConfirmationTone, CrudService, CustomModalBuilder, DEFAULT_CALENDAR_CONFIG, DEFAULT_MN_ALERT_CONFIG, DefaultCalendarDateFormatter, FieldAppearance, FieldKind, FormLayoutMode, FormModalBuilder, KeyboardMode, MN_ALERT_CONFIG, MN_CALENDAR_COMPONENT_NAME, MN_CALENDAR_CONFIG, MN_CHECKBOX_CONFIG, MN_DATETIME_CONFIG, MN_HAPTICS, MN_ICON_MAP, MN_INPUT_FIELD_CONFIG, MN_INSTANCE_ID, MN_LIB_DUAL_HORIZONTAL_IMAGE, MN_MODAL_ACTION_ICONS, MN_MULTI_SELECT_CONFIG, MN_SECTION_PATH, MN_SELECT_CONFIG, MN_TEXTAREA_CONFIG, MODAL_ACTION_ICON_SIZE, MODAL_ACTION_ICON_SIZE_SM, MnAlertOutletComponent, MnAlertService, MnAlertStore, MnBadge, MnBottomSheet, MnButton, MnCheckbox, MnCollectionBase, MnCollectionPagination, MnCollectionState, MnConfigService, MnConfirmationBodyComponent, MnCustomBodyHostComponent, MnDateSelectorBar, MnDatetime, MnDualHorizontalImage, MnFileInput, MnFormBodyComponent, MnGrid, MnHiddenBelowDirective, MnHttpService, MnIcon, MnIconAttributes, MnInformationCard, MnInputField, MnInstanceDirective, MnLanguageService, MnList, MnModalRef, MnModalService, MnModalShellComponent, MnMultiSelect, MnRichTextEditor, MnSectionDirective, MnSelect, MnSelectableCollectionBase, MnShowAboveDirective, MnShowBelowDirective, MnSkeleton, MnTabComponent, MnTable, MnTextarea, MnTranslatePipe, MnWizardBodyComponent, ModalBuilder, ModalCloseReason, ModalIntent, ModalKind, ModalSize, NavigationDirection, OptionState, SelectionMode, StepBuilder, StepState, SubmitMode, UpcomingEventRowComponent, UpcomingEventsComponent, ValidationCode, ValidationStatus, WizardFlowMode, WizardModalBuilder, dateTimeAdapter, defaultFilterPredicate, defaultIconForStyle, defaultTextAdapter, emptyFilterValue, enableMnPreviewMode, isFilterValueActive, isTranslatable, matchesColumnFilter, mnAlertVariants, mnBadgeVariants, mnButtonVariants, mnCheckboxVariants, mnCheckboxWrapperVariants, mnDatetimeVariants, mnFileInputVariants, mnIconVariants, mnInformationCardVariants, mnInputFieldVariants, mnMultiSelectVariants, mnSelectVariants, mnSkeletonVariants, mnTextareaVariants, numberAdapter, pickAdapter, provideMnAlerts, provideMnCalendarConfig, provideMnComponentConfig, provideMnConfig, provideMnLanguage, resolveCalendarConfig, resolveFilterableValue };
-export type { AnimationOptions, ApiError, BaseModalConfig, CalendarButton, CalendarConfig, CalendarDateFormatter, CalendarEvent, CalendarEventData, CancellationActionConfig, CheckboxFieldConfig, ColorFieldConfig, ColorPreset, ColumnBase, ColumnDay, ColumnDefinition, ColumnFilterOption, ColumnFilterState, ColumnFilterType, ColumnFilterValue, ColumnSkeleton, ConfirmationActionConfig, ConfirmationModalConfig, CrudConfig, CurrentTimeCalendarEvent, CursorPaginationStrategy, CustomFieldConfig, CustomModalConfig, DateFieldConfig, DateSelectorBarLayout, DatetimeFieldConfig, DayTile, FailureResult, FieldDataSource, FieldRequiredCondition, FieldValidator, FieldVisibilityCondition, FileFieldConfig, FormFieldConfig, FormFieldGroup, FormModalConfig, FormRow, FormRowField, FormValidator, GridDataSource, GridLayout, GridSkeleton, HourRow, ListAppearance, ListDataSource, ListLabels, ListSkeleton, MnAlert, MnAlertConfig, MnAlertId, MnAlertKind, MnAlertTemplateContext, MnAlertVariants, MnBadgeTypes, MnBadgeVariants, MnButtonTypes, MnButtonVariants, MnCheckboxErrorMessageData, MnCheckboxErrorMessagesData, MnCheckboxProps, MnCheckboxUIConfig, MnCheckboxVariants, MnCheckboxWrapperVariants, MnCollectionDataSource, MnCollectionLabels, MnColumnFilter, MnConfigFile, MnConfigSettings, MnConfigValue, MnDatetimeErrorMessageData, MnDatetimeErrorMessagesData, MnDatetimeMode, MnDatetimeProps, MnDatetimeUIConfig, MnDatetimeVariants, MnDomAttrs, MnDualHorizontalImageConfig, MnDualHorizontalImageTypes, MnErrorMessageData, MnErrorMessageFn, MnErrorMessagesData, MnFileDisplayItem, MnFileInputDisplayMode, MnFileInputErrorMessageData, MnFileInputErrorMessagesData, MnFileInputProps, MnFileInputUIConfig, MnFileInputVariants, MnHapticStyle, MnHapticsHandler, MnIconTypes, MnIconVariants, MnImageType, MnInformationCardBaseData, MnInformationCardData, MnInformationCardVariants, MnInputAdapter, MnInputBaseProps, MnInputDateTimeProps, MnInputFieldProps, MnInputFieldUIConfig, MnInputProps, MnInputType, MnInputVariants, MnLanguageConfig, MnMultiSelectErrorMessageData, MnMultiSelectErrorMessagesData, MnMultiSelectOption, MnMultiSelectProps, MnMultiSelectUIConfig, MnMultiSelectVariants, MnPageSlot, MnPreviewMessage, MnQueryParams, MnRichTextEditorControl, MnRichTextEditorLabels, MnRichTextEditorToolbar, MnSelectErrorMessageData, MnSelectErrorMessagesData, MnSelectOption, MnSelectProps, MnSelectUIConfig, MnSelectVariants, MnSelectableCollectionDataSource, MnShowInput, MnSkeletonProps, MnSkeletonShape, MnSkeletonVariantProps, MnTabDataSource, MnTabItem, MnTableFilterLabels, MnTextareaErrorMessageData, MnTextareaErrorMessagesData, MnTextareaProps, MnTextareaUIConfig, MnTextareaVariants, MnTranslatable, MnTranslationMap, MnTranslations, MnValidationErrorArgs, ModalCancelHandler, ModalCloseEvent, ModalConfig, ModalFooterAction, ModalI18nLabels, ModalInputMap, ModalPollingConfig, ModalRef, ModalResultHandler, ModalStepId, MonthItem, MultiSelectFieldConfig, MultiSelectTableFieldConfig, NumberFieldConfig, OffsetPaginationStrategy, PaginationMode, PaginationStrategy, PasswordFieldConfig, Primitive, QueryParams, QueryValue, RatingFieldConfig, Result, ResultMeta, SelectFieldConfig, SelectOption, SingleSelectTableFieldConfig, SliderFieldConfig, SortState, StepBodyConfig, StepGuard, StepValidator, SuccessResult, TableAppearance, TableDataSource, TableLabels, TextFieldConfig, TextareaFieldConfig, ValidationResult, WizardBeforeCompleteValidator, WizardModalConfig, WizardResult, WizardStepChangeEvent, WizardStepChangeHandler, WizardStepConfig };
+export { API_BASE_URL, ActionStyle, BackdropMode, BaseModalBuilder, CALENDAR_CONFIG, CALENDAR_DATE_FORMATTER, CalendarDayComponent, CalendarEventComponent, CalendarEventDefaultComponent, CalendarEventLayoutService, CalendarMonthComponent, CalendarUtility, CalendarView, CalendarViewComponent, CalendarWeekComponent, CloseMode, ColumnSortType, ConfirmationModalBuilder, ConfirmationTone, CrudService, CustomModalBuilder, DEFAULT_CALENDAR_CONFIG, DEFAULT_MN_ALERT_CONFIG, DefaultCalendarDateFormatter, FieldAppearance, FieldKind, FormLayoutMode, FormModalBuilder, KeyboardMode, MN_ALERT_CONFIG, MN_CALENDAR_COMPONENT_NAME, MN_CALENDAR_CONFIG, MN_CHECKBOX_CONFIG, MN_DATETIME_CONFIG, MN_HAPTICS, MN_ICON_MAP, MN_INPUT_FIELD_CONFIG, MN_INSTANCE_ID, MN_LIB_DUAL_HORIZONTAL_IMAGE, MN_MODAL_ACTION_ICONS, MN_MULTI_SELECT_CONFIG, MN_SECTION_PATH, MN_SELECT_CONFIG, MN_TEXTAREA_CONFIG, MODAL_ACTION_ICON_SIZE, MODAL_ACTION_ICON_SIZE_SM, MnAlertOutletComponent, MnAlertService, MnAlertStore, MnBadge, MnBottomSheet, MnBreadcrumbs, MnButton, MnCheckbox, MnCollectionBase, MnCollectionPagination, MnCollectionState, MnConfigService, MnConfirmationBodyComponent, MnCustomBodyHostComponent, MnDateSelectorBar, MnDatetime, MnDualHorizontalImage, MnFileInput, MnFormBodyComponent, MnGrid, MnHiddenBelowDirective, MnHttpService, MnIcon, MnIconAttributes, MnInformationCard, MnInputField, MnInstanceDirective, MnLanguageService, MnList, MnModalRef, MnModalService, MnModalShellComponent, MnMultiSelect, MnRichTextEditor, MnSectionDirective, MnSelect, MnSelectableCollectionBase, MnShowAboveDirective, MnShowBelowDirective, MnSkeleton, MnTabComponent, MnTable, MnTextarea, MnTranslatePipe, MnWizardBodyComponent, ModalBuilder, ModalCloseReason, ModalIntent, ModalKind, ModalSize, NavigationDirection, OptionState, SelectionMode, StepBuilder, StepState, SubmitMode, UpcomingEventRowComponent, UpcomingEventsComponent, ValidationCode, ValidationStatus, WizardFlowMode, WizardModalBuilder, dateTimeAdapter, defaultFilterPredicate, defaultIconForStyle, defaultTextAdapter, emptyFilterValue, enableMnPreviewMode, isFilterValueActive, isTranslatable, matchesColumnFilter, mnAlertVariants, mnBadgeVariants, mnBreadcrumbsVariants, mnButtonVariants, mnCheckboxVariants, mnCheckboxWrapperVariants, mnDatetimeVariants, mnFileInputVariants, mnIconVariants, mnInformationCardVariants, mnInputFieldVariants, mnMultiSelectVariants, mnSelectVariants, mnSkeletonVariants, mnTextareaVariants, numberAdapter, pickAdapter, provideMnAlerts, provideMnCalendarConfig, provideMnComponentConfig, provideMnConfig, provideMnLanguage, resolveCalendarConfig, resolveFilterableValue };
+export type { AnimationOptions, ApiError, BaseModalConfig, CalendarButton, CalendarConfig, CalendarDateFormatter, CalendarEvent, CalendarEventData, CancellationActionConfig, CheckboxFieldConfig, ColorFieldConfig, ColorPreset, ColumnBase, ColumnDay, ColumnDefinition, ColumnFilterOption, ColumnFilterState, ColumnFilterType, ColumnFilterValue, ColumnSkeleton, ConfirmationActionConfig, ConfirmationModalConfig, CrudConfig, CurrentTimeCalendarEvent, CursorPaginationStrategy, CustomFieldConfig, CustomModalConfig, DateFieldConfig, DateSelectorBarLayout, DatetimeFieldConfig, DayTile, FailureResult, FieldDataSource, FieldRequiredCondition, FieldValidator, FieldVisibilityCondition, FileFieldConfig, FormFieldConfig, FormFieldGroup, FormModalConfig, FormRow, FormRowField, FormValidator, GridDataSource, GridLayout, GridSkeleton, HourRow, ListAppearance, ListDataSource, ListLabels, ListSkeleton, MnAlert, MnAlertConfig, MnAlertId, MnAlertKind, MnAlertTemplateContext, MnAlertVariants, MnBadgeTypes, MnBadgeVariants, MnBreadcrumbItem, MnBreadcrumbsData, MnBreadcrumbsVariants, MnButtonTypes, MnButtonVariants, MnCheckboxErrorMessageData, MnCheckboxErrorMessagesData, MnCheckboxProps, MnCheckboxUIConfig, MnCheckboxVariants, MnCheckboxWrapperVariants, MnCollectionDataSource, MnCollectionLabels, MnColumnFilter, MnConfigFile, MnConfigSettings, MnConfigValue, MnDatetimeErrorMessageData, MnDatetimeErrorMessagesData, MnDatetimeMode, MnDatetimeProps, MnDatetimeUIConfig, MnDatetimeVariants, MnDomAttrs, MnDualHorizontalImageConfig, MnDualHorizontalImageTypes, MnErrorMessageData, MnErrorMessageFn, MnErrorMessagesData, MnFileDisplayItem, MnFileInputDisplayMode, MnFileInputErrorMessageData, MnFileInputErrorMessagesData, MnFileInputProps, MnFileInputUIConfig, MnFileInputVariants, MnHapticStyle, MnHapticsHandler, MnIconTypes, MnIconVariants, MnImageType, MnInformationCardBaseData, MnInformationCardData, MnInformationCardVariants, MnInputAdapter, MnInputBaseProps, MnInputDateTimeProps, MnInputFieldProps, MnInputFieldUIConfig, MnInputProps, MnInputType, MnInputVariants, MnLanguageConfig, MnMultiSelectErrorMessageData, MnMultiSelectErrorMessagesData, MnMultiSelectOption, MnMultiSelectProps, MnMultiSelectUIConfig, MnMultiSelectVariants, MnPageSlot, MnPreviewMessage, MnQueryParams, MnRichTextEditorControl, MnRichTextEditorLabels, MnRichTextEditorToolbar, MnSelectErrorMessageData, MnSelectErrorMessagesData, MnSelectOption, MnSelectProps, MnSelectUIConfig, MnSelectVariants, MnSelectableCollectionDataSource, MnShowInput, MnSkeletonProps, MnSkeletonShape, MnSkeletonVariantProps, MnTabDataSource, MnTabItem, MnTableFilterLabels, MnTextareaErrorMessageData, MnTextareaErrorMessagesData, MnTextareaProps, MnTextareaUIConfig, MnTextareaVariants, MnTranslatable, MnTranslationMap, MnTranslations, MnValidationErrorArgs, ModalCancelHandler, ModalCloseEvent, ModalConfig, ModalFooterAction, ModalI18nLabels, ModalInputMap, ModalPollingConfig, ModalRef, ModalResultHandler, ModalStepId, MonthItem, MultiSelectFieldConfig, MultiSelectTableFieldConfig, NumberFieldConfig, OffsetPaginationStrategy, PaginationMode, PaginationStrategy, PasswordFieldConfig, Primitive, QueryParams, QueryValue, RatingFieldConfig, Result, ResultMeta, SelectFieldConfig, SelectOption, SingleSelectTableFieldConfig, SliderFieldConfig, SortState, StepBodyConfig, StepGuard, StepValidator, SuccessResult, TableAppearance, TableDataSource, TableLabels, TextFieldConfig, TextareaFieldConfig, ValidationResult, WizardBeforeCompleteValidator, WizardModalConfig, WizardResult, WizardStepChangeEvent, WizardStepChangeHandler, WizardStepConfig };