@heartlandone/vega 2.64.0 → 2.65.0

package/dist/types/components/vega-calendar/slimmers/common/controllers/vega-calendar-current-period-controller.d.ts

@@ -8,6 +8,7 @@ export declare class VegaCalendarCurrentPeriodController extends VegaSlimmer {
   protected changeEventEmitter: VegaCalendar['changeEventEmitter'];
   protected viewMode: VegaCalendar['viewMode'];
   protected showWeekends: VegaCalendar['showWeekends'];
+  protected timezone: VegaCalendar['timezone'];
   /**
    * set new current period
    *

package/dist/types/components/vega-calendar/slimmers/common/controllers/vega-calendar-event-controller.d.ts

@@ -9,6 +9,7 @@ export declare class VegaCalendarEventController extends VegaSlimmer {
   protected calendarEvents: VegaCalendar['calendarEvents'];
   protected currentPeriod: VegaCalendar['currentPeriod'];
   protected events: VegaCalendar['events'];
+  protected timezone: VegaCalendar['timezone'];
   private repeatEventMap;
   /**
    * The function `getCurrentDateEvent` returns an array of calendar events for the current date, including both normal events and group events.
@@ -30,6 +31,11 @@ export declare class VegaCalendarEventController extends VegaSlimmer {
    * initial calendar events in first time
    */
   protected updateWhenComponentWillLoad(): void;
+  /**
+   * Handle timezone changes by updating all calendar events
+   *
+   */
+  protected updateAfterTimezoneChange(): void;
   /**
    * initial calendar events
    *

package/dist/types/components/vega-calendar/slimmers/common/controllers/vega-calendar-event-preivew-popover-controller.d.ts

@@ -30,6 +30,11 @@ export declare class VegaCalendarEventPreviewPopoverController extends VegaSlimm
    * @returns {Nullable<HTMLElement>} - The HTML element used as the preview container, or null if not found
    */
   getEventPreviewContainer(event: CalendarEvent, viewDate: CalendarDate, isGroup: boolean): Nullable<HTMLElement>;
+  /**
+   *  clear all preview container maps when timezone changes
+   *
+   */
+  protected clearAllPreviewContainers(): void;
   /**
    * Generate a unique key for the given events
    *

package/dist/types/components/vega-calendar/slimmers/common/controllers/vega-calendar-post-operation-date-controller.d.ts

@@ -7,6 +7,7 @@ import { Nullable } from '../../../../../types/general';
  */
 export declare class VegaCalendarPostOperationDateController extends VegaSlimmer {
   protected postOperationDate: VegaCalendar['postOperationDate'];
+  protected timezone: VegaCalendar['timezone'];
   /**
    * Set new current date
    *
@@ -20,6 +21,11 @@ export declare class VegaCalendarPostOperationDateController extends VegaSlimmer
    * @param {CalendarPeriod} oldValue the prev calendar period
    */
   protected setDate(newValue: CalendarPeriod, oldValue: Nullable<CalendarPeriod>): void;
+  /**
+   * Handle timezone changes by updating postOperationDate
+   *
+   */
+  protected updateAfterTimezoneChange(): void;
   /**
    * Check if the first date should be set
    * Both the new and old values are of the month type.

package/dist/types/components/vega-calendar/slimmers/common/helpers/repeat-pattern/calendar-event-repeat-pattern-factory.d.ts

@@ -7,13 +7,15 @@ declare class CalendarEventRepeatPatternFactory {
    *
    * @param {Date} startDate repeat start date
    * @param {VegaCalendarEventRepeatOptions|undefined} repeatOptions repeat options
+   * @param {string} timezone The timezone identifier (e.g., America/New_York).
    * @returns {CalendarEventBaseRepeatPattern} the match repeat pattern
    */
-  getPattern(startDate: Date, repeatOptions: VegaCalendarEventRepeatOptions): CalendarEventBaseRepeatPattern;
+  getPattern(startDate: Date, repeatOptions: VegaCalendarEventRepeatOptions, timezone?: string): CalendarEventBaseRepeatPattern;
   /**
    * The `initDate` function initializes a `CalendarDate` object based on the input date string or Date object provided.
    *
    * @param {Nullable<string | Date>} date - The `date` parameter can be either a string or a Date object.
+   * @param {string} timezone The timezone identifier (e.g., 'America/New_York').
    * @returns {Nullable<CalendarDate>} The function `initDate` returns a `Nullable<CalendarDate>`, which means it can return either a `CalendarDate` object or `null`.
    */
   private initDate;

package/dist/types/components/vega-calendar/slimmers/day-view/renderers/vega-calendar-time-marker-renderer.d.ts

@@ -8,6 +8,7 @@ import { VegaCalendar } from '../../../vega-calendar';
 export declare class VegaCalendarTimeMarkerRenderer extends VegaSlimmer {
   protected viewMode: VegaCalendar['viewMode'];
   protected viewRenderer: VegaCalendar['viewRenderer'];
+  protected timezone: VegaCalendar['timezone'];
   private timeMarkerRef;
   private timeMarkerPositionTimer;
   /**

package/dist/types/components/vega-calendar/slimmers/day-view/renderers/vega-calendar-view-with-time-renderer.d.ts

@@ -12,6 +12,7 @@ export declare class VegaCalendarViewWithTimeRenderer extends VegaCalendarDateBl
   protected translationSlimmer: VegaCalendar['translationSlimmer'];
   protected isDateDisabled: VegaCalendar['isDateDisabled'];
   protected enableDateClick: VegaCalendar['enableDateClick'];
+  protected timezone: VegaCalendar['timezone'];
   /**
    * The render function in TypeScript React returns an array of HTMLElements containing the week calendar view for a specific day.
    *

package/dist/types/components/vega-calendar/slimmers/month-view/renderers/vega-calendar-month-view-renderer.d.ts

@@ -11,6 +11,7 @@ export declare class VegaCalendarMonthViewRenderer extends VegaCalendarDateBlock
   protected translationSlimmer: VegaCalendar['translationSlimmer'];
   protected isDateDisabled: VegaCalendar['isDateDisabled'];
   protected showSwitchView: VegaCalendar['showSwitchView'];
+  protected timezone: VegaCalendar['timezone'];
   /**
    * the HTML elements that represent the month view of a calendar component.
    *

package/dist/types/components/vega-calendar/types.d.ts

@@ -93,3 +93,8 @@ export type VegaMouseEventInfo = {
 };
 
 export type DisabledDate = (date: Date) => boolean;
+
+export type CalendarTimeHourMinutes = {
+	timeHours: number;
+	timeMinutes: number;
+};

package/dist/types/components/vega-calendar/vega-calendar.d.ts

@@ -179,6 +179,19 @@ export declare class VegaCalendar {
    * Monitors changes in the visibility of the weekend columns in the calendar.
    */
   watchShowWeekendsChange(): void;
+  /**
+   * Specifies the IANA time zone or Etc/GMT±n format.
+   *  It accepts values such as "America/New_York" or "Etc/GMT+12".
+   *  If not set, the component defaults to the system's time zone.
+   *  For a complete list of IANA time zones, see Time Zone DB(https://timezonedb.com/time-zones).
+   *
+   * @vegaVersion 2.65.0
+   */
+  timezone: string;
+  /**
+   * Monitors changes in the timezone prop for the calendar.
+   */
+  watchTimezoneChange(): void;
   /**
    * An event emitter notifying the component view content change after a switch panel click.
    *
@@ -245,4 +258,8 @@ export declare class VegaCalendar {
    */
   moreActionClick: EventEmitter<string>;
   render(): VegaCalendar;
+  /**
+   * Get initial post operation date considering timezone
+   */
+  private getInitialPostOperationDate;
 }

package/dist/types/components/vega-date-picker/slimmers/renderers/vega-date-picker-calendar-renderer.d.ts

@@ -47,6 +47,7 @@ export declare class VegaDatePickerCalendarRenderer extends VegaSlimmer {
   componentDidLoad(): void;
   /** Refresh date picker when it is updated */
   componentDidRender(): void;
+  watchIsDateDisabled(): void;
   /**
    * The callback to handle [doOpen]{@link VegaDatePicker.doOpen}
    */
@@ -118,5 +119,17 @@ export declare class VegaDatePickerCalendarRenderer extends VegaSlimmer {
    * attaches event listeners.
    */
   private initDatePicker;
+  /**
+   * Applies styles to disable a specific day in the calendar.
+   *
+   * @param {HTMLElement} dayRef - The reference to the day element to be disabled.
+   */
+  private setDisabledDayStyles;
+  /**
+   * Clears the styles applied to a day element that mark it as disabled.
+   *
+   * @param {HTMLElement} dayRef - The reference to the day element to be cleared of disabled styles.
+   */
+  private clearDisabledDayStyles;
 }
 export {};

package/dist/types/components/vega-date-picker/vega-date-picker.d.ts

@@ -221,6 +221,7 @@ export declare class VegaDatePicker {
    * @vegaVersion 2.60.0
    */
   isDateDisabled: DisabledDate;
+  watchIsDateDisabled(): void;
   /**
    * An event emitter notifying the change of the value in the date picker,
    *    whether triggered programmatically or through user interaction.

package/dist/types/components/vega-dropdown/vega-dropdown.d.ts

@@ -183,6 +183,7 @@ export declare class VegaDropdown {
   /**
    * Specifies the display rule for items in the dropdown.
    *
+   * @VegaWarning Specifies the display rule for items in the dropdown, only be active if matchTargetWidth is true or maxWidth has value.
    * @vegaVersion 1.13.0
    */
   itemDisplayRule: 'ellipsis' | 'newline';

package/dist/types/components/vega-form/slimmers/controllers/vega-form-field-controller.d.ts

@@ -0,0 +1,158 @@
+import { VegaSlimmer } from '../../../../vega-slimmer/vega-slimmer-core';
+import { ImmutableMap } from '../../../../helpers/immutable/immutable-map';
+import { VegaForm } from '../../vega-form';
+import { FormControlOption, FormValidateResult } from '../../types';
+import { ChildNodesNotifyObserverSlimmer } from '../../../../helpers/event-manager/slimmers/child-nodes-notify-observer-slimmer';
+/**
+ * The form field controller for vega form to manage the form field states.
+ */
+export declare class VegaFormFieldController extends VegaSlimmer {
+  host: VegaForm['host'];
+  isValid: VegaForm['isValid'];
+  isTouched: VegaForm['isTouched'];
+  protected childNotifyObserver: ChildNodesNotifyObserverSlimmer<unknown>;
+  protected childNodeValueChangeObserver: ChildNodesNotifyObserverSlimmer<unknown>;
+  private formFieldPendingValidObserver;
+  private formFieldDisconnectedObserver;
+  private _invalidFieldPathMap;
+  /**
+   * The form field element pending async valid map
+   */
+  private _pendingValidFieldPathMap;
+  /**
+   * Component lifecycle - [connectedCallback]
+   */
+  connectedCallback(): void;
+  /**
+   * When the vegaForm is deleted, it is necessary to notify the parent's vegaForm to update its isValid status.
+   */
+  disconnectedCallback(): void;
+  /**
+   * @inheritDoc
+   */
+  getValue<T>(option?: FormControlOption): Promise<T>;
+  /**
+   * @inheritDoc
+   */
+  setValue<T>(value: T, option?: FormControlOption): Promise<void>;
+  /**
+   * @inheritDoc
+   */
+  valid(showError?: boolean | 'rule'): Promise<FormValidateResult>;
+  /**
+   * The getter for the {@link _invalidFieldPathMap}
+   *
+   * @returns {ImmutableMap<HTMLElement, string>} The map of invalid field elements and their paths
+   */
+  get invalidFieldPathMap(): ImmutableMap<HTMLElement, string>;
+  /**
+   * The getter for the {@link _pendingValidFieldPathMap}
+   *
+   * @returns {ImmutableMap<HTMLElement, string>} The map of pending valid field elements and their paths
+   */
+  get pendingValidFieldPathMap(): ImmutableMap<HTMLElement, string>;
+  /**
+   * Set the isTouched property of the form.
+   *
+   * @param {boolean} isTouched - The new value for isTouched.
+   */
+  setIsTouched(isTouched: boolean): void;
+  /**
+   * It returns the value of data-vega-form that the given element is associated with.
+   *
+   * @param {HTMLElement} element - The element that is being validated.
+   * @returns {string} The name of the field.
+   */
+  getFormFieldName(element: HTMLElement): string;
+  /**
+   * Check if the given element is part of the current form.
+   *
+   * @param {HTMLElement} element - The element to check.
+   * @returns {boolean} True if the element is part of the current form, false otherwise.
+   */
+  isElementInCurrentForm(element: HTMLElement): boolean;
+  /**
+   * Navigate the immediate child node under current vega form element with the following strategy
+   *  - if a matched vega field element found, will pass it to the visitor method passed in
+   *  - if a non-matched node found, it will call itself recursively and pass the node as the second parameter
+   * Once the navigation is finished, it will wait for all the pending visitor/self-invocation promise finished before return
+   *
+   * @param  {(element: HTMLElement, isForm: boolean) => Promise<void>} visitor async callback method that will be invoked if a matched vega field element found
+   * @param {FormControlOption} [option] form control option to skip disabled/invisible components
+   * @param {HTMLElement} [startElementNode=this.host] the element to start the navigation, default to current vega form host
+   * @returns {Promise<void>} return void wrapped with promise to notify the navigation is done
+   */
+  navigateVegaFormChildren(visitor: (element: HTMLElement, isForm: boolean) => Promise<void>, option?: FormControlOption, startElementNode?: HTMLElement): Promise<void>;
+  /**
+   * Update the {@link isValid} property value based on the size of {@link invalidFieldPathMap}
+   * If the number of invalid elements is zero, then the form is valid.
+   */
+  private updateIsValidFlag;
+  /**
+   * Registers an observer with the ChangeManager that will be notified when a form field's pending validation state changes.
+   */
+  private registerFormFieldPendingValid;
+  /**
+   * Can accept handler for FORM_FIELD_PENDING_VALID_CHANGE.
+   *
+   * @param {PendingValidPayload} payload - The payload containing the host element that triggered the pending valid change event.
+   * @returns {boolean} True if the host element is part of the current form, false otherwise.
+   */
+  private canAcceptFormFieldPendingValid;
+  /**
+   * Handles the pending valid state change for a form field.
+   *
+   * @param {PendingValidPayload} payload - The payload containing the host element and its pending valid state.
+   */
+  private handleFieldPendingValid;
+  /**
+   * This function registers an observer with the ChangeManager that will be notified when an element
+   * delete operation is triggered
+   */
+  private initFormFieldDisconnectedObserver;
+  /**
+   * If the deleted element is a child or grandchild of current vegaForm, the isValid of all these vegaForms will be updated.
+   *
+   * @param {DisconnectedElementOperationPayload} payload -  the delete element and vegaForm array.
+   * @returns {boolean} A boolean value.
+   */
+  private canAcceptFormFieldDisconnectedOperation;
+  /**
+   * Get the fieldName of the deleted element in the current vegaForm, delete it from the invalidFieldPathSet array, and update isValid at the same time.
+   *
+   * @param {DisconnectedElementOperationPayload} payload - the delete element and vegaForm array.
+   */
+  private updateInvalidFieldPath;
+  /**
+   * Return true if the HTMLElement has data-vega-form property, and it's not disabled and not invisible if these two properties have to be checked.
+   *
+   * @param {HTMLElement} element - The HTMLElement to check.
+   * @param {boolean} skipDisabled - If true, then disabled form fields will be skipped.
+   * @param {boolean} skipInvisible - If true, only visible elements will be visited.
+   * @returns {boolean} a boolean value.
+   */
+  private shouldVisitElement;
+  /**
+   * If the element is valid, remove it from the set of
+   *    invalid elements. If the element is invalid,
+   *    add it to the set of invalid elements.
+   *
+   * @param {NotifyObserverPayload<boolean>} payload - CustomEvent<boolean> the vegaValidate subject notify from child elements
+   */
+  private updateInternalValidStatus;
+  /**
+   * It retrieves the value of a form field element.
+   *
+   * @param {HTMLElement} element - The form field element.
+   * @returns {unknown} The value of the form field element.
+   */
+  private getFormFieldValue;
+  /**
+   * It handles the validation of a child form field element.
+   *
+   * @param {HTMLElement} element - The form field element to validate.
+   * @param {boolean | 'rule'} showError - Whether to show error messages.
+   * @returns {Promise<EvaluateResultBase>} The validation result.
+   */
+  private handleChildFormFieldElementValid;
+}

package/dist/types/components/vega-form/slimmers/controllers/vega-form-reset-controller.d.ts

@@ -0,0 +1,43 @@
+import { VegaSlimmer } from '../../../../vega-slimmer/vega-slimmer-core';
+import { FormControlOption } from '../../types';
+import { VegaForm } from '../../vega-form';
+/**
+ * Reset controller for handling form reset events in the VegaForm component.
+ */
+export declare class VegaFormResetController extends VegaSlimmer {
+  host: VegaForm['host'];
+  vegaFormFieldController: VegaForm['vegaFormFieldController'];
+  resetEventEmitter: VegaForm['resetEventEmitter'];
+  private formResetEventObserver;
+  /**
+   * Component lifecycle - [connectedCallback]
+   */
+  connectedCallback(): void;
+  /**
+   * Component lifecycle - [disconnectedCallback]
+   */
+  disconnectedCallback(): void;
+  /**
+   * @inheritDoc
+   */
+  protected reset(defaultValueMap?: unknown, option?: FormControlOption): Promise<void>;
+  /**
+   * Registers the form reset event observer with the ChangeManager.
+   */
+  private registerFormResetChangeManager;
+  /**
+   * Unregister the form reset event observer from the ChangeManager.
+   */
+  private unregisterFormResetChangeManager;
+  /**
+   * Can accept form reset event.
+   *
+   * @param {FormEventsPayload} payload - The form events payload.
+   * @returns {boolean} True if the event can be accepted, false otherwise.
+   */
+  private canAcceptFormResetEvent;
+  /**
+   * Handles reset events by resetting the form and emitting a reset event.
+   */
+  private handleResetEvents;
+}

package/dist/types/components/vega-form/slimmers/controllers/vega-form-submit-controller.d.ts

@@ -0,0 +1,55 @@
+import { VegaSlimmer } from '../../../../vega-slimmer/vega-slimmer-core';
+import { VegaForm } from '../../vega-form';
+/**
+ * Controller responsible for handling form submission in the VegaForm component.
+ */
+export declare class VegaFormSubmitController extends VegaSlimmer {
+  host: VegaForm['host'];
+  useNativeForm: VegaForm['useNativeForm'];
+  nativeFormRenderer: VegaForm['nativeFormRenderer'];
+  submitEventEmitter: VegaForm['submitEventEmitter'];
+  vegaFormFieldController: VegaForm['vegaFormFieldController'];
+  private formSubmitEventObserver;
+  /**
+   * Component lifecycle - [connectedCallback]
+   */
+  connectedCallback(): void;
+  /**
+   * Component lifecycle - [disconnectedCallback]
+   */
+  disconnectedCallback(): void;
+  /**
+   * Submits the form using native HTML form submission with all current field values.
+   *
+   * This method collects all form field values, creates hidden input elements for each field,
+   * appends them to a container inside the native form, and then triggers the native
+   * `requestSubmit()` method to submit the form.
+   *
+   * The method ensures that the form data is available in the native form for submission,
+   * which is useful when `useNativeForm` is enabled.
+   *
+   * @returns {Promise<void>} Resolves when the form submission process is complete.
+   */
+  private submitWithFormData;
+  /**
+   * Registers the form submit event observer with the ChangeManager.
+   */
+  private registerFormSubmitChangeManager;
+  /**
+   * Unregister the form submit event observer from the ChangeManager.
+   */
+  private unregisterFormSubmitChangeManager;
+  /**
+   * Can accept handler for FORM_SUBMIT.
+   *
+   * @param {FormEventsPayload} payload - The payload containing the host element that triggered the submit event.
+   * @returns {boolean} True if the host element is part of the current form, false otherwise.
+   */
+  private canAcceptFormSubmitEvent;
+  /**
+   * Handles the form submission process.
+   *
+   * @returns {Promise<void>} Resolves when the submission process is complete.
+   */
+  private handleSubmitEvents;
+}

package/dist/types/components/vega-form/types.d.ts

@@ -26,3 +26,16 @@ export type VegaFormFieldValidationState = {
 	 */
 	errorMessage?: Nullable<string>;
 };
+
+export type FormEventsPayload = {
+	host: HTMLElement;
+};
+
+export type PendingValidPayload = {
+	host: HTMLElement;
+	detail: boolean | null;
+};
+
+export type DisconnectedElementOperationPayload = {
+	host: HTMLElement;
+};

package/dist/types/components/vega-form/vega-form.d.ts

@@ -3,12 +3,14 @@ import { FormControlOption, FormValidateResult, VegaFormFieldValidationState } f
 import { GlobalSlimmers } from '../../vega-slimmer/vega-slimmer-core';
 import { EventEmitSlimmerBase } from '../../helpers/event-manager/slimmers/event-emit-slimmer';
 import { ChildNodesEventPreventSlimmer } from '../../helpers/event-manager/slimmers/child-nodes-event-prevent-slimmer';
-import { ChildNodesNotifyObserverSlimmer } from '../../helpers/event-manager/slimmers/child-nodes-notify-observer-slimmer';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
 import { SubStateNotifySlimmerBase } from '../../helpers/slimmers/sub-state/sub-state-notify-slimmer-base';
 import { VegaFormNestStateController } from './slimmers/controllers/vega-form-nest-state-controller';
 import { VegaFormFieldValidationStateController } from './slimmers/controllers/vega-form-field-validation-state-controller';
 import { NativeFormRenderer } from './slimmers/renderers/native-form-renderer';
+import { VegaFormSubmitController } from './slimmers/controllers/vega-form-submit-controller';
+import { VegaFormFieldController } from './slimmers/controllers/vega-form-field-controller';
+import { VegaFormResetController } from './slimmers/controllers/vega-form-reset-controller';
 /**
  * @vegaVersion 1.3.0
  */
@@ -21,17 +23,12 @@ export declare class VegaForm {
   protected stateController: VegaFormNestStateController;
   protected childEventPrevent: ChildNodesEventPreventSlimmer;
   protected childFormValidateEventPrevent: ChildNodesEventPreventSlimmer;
-  protected childNotifyObserver: ChildNodesNotifyObserverSlimmer<unknown>;
-  protected childNodeValueChangeObserver: ChildNodesNotifyObserverSlimmer<unknown>;
   protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaFormElement>;
   protected vegaFormFieldValidationStateController: VegaFormFieldValidationStateController;
   protected nativeFormRenderer: NativeFormRenderer;
-  private invalidFieldPathMap;
-  private pendingValidFieldPathMap;
-  private controlledFieldPathSet;
-  private formFieldDisconnectedObserver;
-  private formEventsObserver;
-  private formFieldPendingValidObserver;
+  protected vegaFormSubmitController: VegaFormSubmitController;
+  protected vegaFormResetController: VegaFormResetController;
+  protected vegaFormFieldController: VegaFormFieldController;
   host: HTMLVegaFormElement;
   /**
    * Indicates whether the current form-controlled elements are valid.
@@ -141,12 +138,6 @@ export declare class VegaForm {
    * @vegaVersion 2.0.0
    */
   formReset: EventEmitter;
-  /**
-   * When the vegaForm is deleted, it is necessary to notify
-   *    the parent's vegaForm to update its isValid status.
-   */
-  disconnectedCallback(): Promise<void>;
-  componentDidLoad(): Promise<void>;
   /**
    * Invoke this method asynchronously to retrieve the validation result for
    *    all the vega field elements nested within the `vega-form`.
@@ -197,100 +188,5 @@ export declare class VegaForm {
    * @vegaVersion 2.59.0
    */
   setValidationStates(states: VegaFormFieldValidationState[]): Promise<void>;
-  private static getFormFieldValue;
   render(): VegaForm;
-  /**
-   * If the element is valid, remove it from the set of
-   *    invalid elements. If the element is invalid,
-   *    add it to the set of invalid elements.
-   *
-   * @param {NotifyObserverPayload<boolean>} payload - CustomEvent<boolean> the vegaValidate subject notify from child elements
-   */
-  private updateInternalValidStatus;
-  /**
-   * If the value of any child elements have changed,
-   *    make 'isTouched' prop as false.
-   */
-  private updateInternalTouchedStatus;
-  /**
-   * Navigate the immediate child node under current vega form element with the following strategy
-   *  - if a matched vega field element found, will pass it to the visitor method passed in
-   *  - if a non-matched node found, it will call itself recursively and pass the node as the second parameter
-   * Once the navigation is finished, it will wait for all the pending visitor/self-invocation promise finished before return
-   *
-   * @param visitor async callback method that will be invoked if a matched vega field element found
-   * @param {FormControlOption} [option] form control option to skip disabled/invisible components
-   * @param [startElementNode] element node that the navigation will be started from, default is the current host element
-   * @return {Promise<void>} return void wrapped with promise to notify the navigation is done
-   */
-  private navigateVegaFormChildren;
-  /**
-   * Update the {@link isValid} property value based on the size of {@link invalidFieldPathSet}
-   * If the number of invalid elements is zero, then the form is valid.
-   */
-  private updateIsValidFlag;
-  /**
-   * It returns the value of data-vega-form that the given element is associated with, if child HTMLElements share the same data-vega-form property name
-   * in the same vega-form, then includePath has to be set to be true to get a complete path to avoid the confusion of isValid checking.
-   *
-   * @param {HTMLElement} element - The element that is being validated.
-   * @param {boolean} [includePath] - If true, the field name will include the path to the field. For
-   * example, if the field is in a vega-form with the name "address", the field name will be "address ->
-   * street".
-   * @returns The name of the field.
-   */
-  private getFormFieldName;
-  /**
-   * Return true if the HTMLElement has data-vega-form property and it's not disabled and not invisible if these two properties have to be checked.
-   *
-   * @param {HTMLElement} element - The HTMLElement to check.
-   * @param {boolean} skipDisabled - If true, then disabled form fields will be skipped.
-   * @param {boolean} skipInvisible - If true, only visible elements will be visited.
-   * @returns a boolean value.
-   */
-  private shouldVisitElement;
-  /**
-   * This function registers an observer with the ChangeManager that will be notified when a element
-   * delete operation is triggered
-   */
-  private initFormFieldDisconnectedObserver;
-  /**
-   * If the deleted element is a child or grandchild of current vegaForm, the isValid of all these vegaForms will be updated.
-   *
-   * @param {DisconnectedElementOperationPayload} payload -  the delete element and vegaForm array.
-   * @returns {boolean} A boolean value.
-   */
-  private canAcceptFormFieldDisconnectedOperation;
-  /**
-   * Get the fieldName of the deleted element in the current vegaForm, delete it from the invalidFieldPathSet array, and update isValid at the same time.
-   */
-  private updateInvalidFieldPath;
-  private registerFormSubmitChangeManager;
-  /**
-   * The below method is e2e-test covered in
-   * @see{module:vega-form-field-enter-to-submit-e2e}
-   */
-  private canAcceptFormSubmitEvent;
-  private handleSubmitEvents;
-  /**
-   * Submits the form using native HTML form submission with all current field values.
-   *
-   * This method collects all form field values, creates hidden input elements for each field,
-   * appends them to a container inside the native form, and then triggers the native
-   * `requestSubmit()` method to submit the form.
-   *
-   * The method ensures that the form data is available in the native form for submission,
-   * which is useful when `useNativeForm` is enabled.
-   *
-   * @returns {Promise<void>} Resolves when the form submission process is complete.
-   */
-  private submitWithFormData;
-  private registerFormResetChangeManager;
-  private canAcceptFormResetEvent;
-  private handleResetEvents;
-  private registerFormFieldPendingValidChangeManager;
-  private canAcceptFormFieldPendingValid;
-  private handleFieldPendingValid;
-  private isElementInCurrentForm;
-  private handleChildFormFieldElementValid;
 }

package/dist/types/components/vega-nav/slimmers/vega-nav-observer-slimmer.d.ts

@@ -1,4 +1,6 @@
 import { VegaSlimmer } from '../../../vega-slimmer/vega-slimmer-core';
+import { DomNodeSubject } from '../../../helpers/change-manager/subject/dom-node-subject/dom-node-subject';
+import { Nullable } from '../../../types/general';
 /**
  * The code is defining an abstract class called `VegaNavObserverSlimmer` that extends the `VegaSlimmer` class.
  */
@@ -21,4 +23,5 @@ export declare abstract class VegaNavObserverSlimmer extends VegaSlimmer {
    */
   protected isAcceptableNavListObserver<T>(input: unknown): input is T;
   protected abstract observerListener(castInput: HTMLVegaLeftNavLinkElement): void;
+  protected abstract getObserverSubject(): Nullable<DomNodeSubject>;
 }

package/dist/types/components/vega-nav/vega-left-nav-link/slimmers/controllers/vega-left-nav-link-controller.d.ts

@@ -1,8 +1,11 @@
 import { VegaLeftNavLink } from '../../vega-left-nav-link';
 import { VegaNavObserverSlimmer } from '../../../slimmers/vega-nav-observer-slimmer';
+import { Nullable } from '../../../../../types/general';
+import { DomNodeSubject } from '../../../../../helpers/change-manager/subject/dom-node-subject/dom-node-subject';
 export declare class VegaLeftNavLinkController extends VegaNavObserverSlimmer {
   host: VegaLeftNavLink['host'];
   selected: VegaLeftNavLink['selected'];
+  customSelectionEnabled: VegaLeftNavLink['customSelectionEnabled'];
   vegaLeftNavHierarchyController: VegaLeftNavLink['vegaLeftNavHierarchyController'];
   /**
    * When selected is true during initialization, the VegaInternalInitializeLeftNavLinkSelected observer needs to be notified
@@ -19,4 +22,9 @@ export declare class VegaLeftNavLinkController extends VegaNavObserverSlimmer {
    * @see{module:vega-left-nav-link-observer-with-click}
    */
   protected observerListener(castInput: HTMLVegaLeftNavLinkElement): void;
+  /**
+   * Returns the dom node subject for selection observer registration.
+   * The subject is scoped to the top parent nav container for this link.
+   */
+  protected getObserverSubject(): Nullable<DomNodeSubject>;
 }