@globalpayments/vega 2.26.0 → 2.28.0

package/dist/types/constants/runtime-metrics-payload-definition/public-api/VegaTranslation/runtime-metrics-payload-definition.d.ts

@@ -0,0 +1,2 @@
+import { PublicAPIRuntimeMetricsDefinition } from '../../../../helpers/slimmers/runtime-metrics/public-api-runtime-metrics-slimmer-base';
+export declare const VegaTranslationRuntimeMetricsPayloadDefinition: PublicAPIRuntimeMetricsDefinition[];

package/dist/types/constants/ui.d.ts

@@ -9,7 +9,7 @@ export declare const FlexDirections: readonly ["row", "col", "row-reverse", "col
 export declare const FlexAlignItem: readonly ["start", "center", "end", "baseline", "stretch"];
 export declare const FlexJustifyContent: readonly ["start", "center", "end", "space-around", "space-between", "space-evenly"];
 export declare const FlexWrap: readonly ["nowrap", "wrap", "wrap-reverse"];
-export declare const BoxDisplay: readonly ["block", "none"];
+export declare const BoxDisplay: readonly ["block", "inline-block", "none"];
 export declare const BorderStyle: readonly ["solid", "dashed", "dotted", "double", "none"];
 export declare const TextAlign: readonly ["start", "end", "left", "right", "center", "justify"];
 export declare const VegaNativeEventName: readonly ["change", "click", "focus", "blur", "close", "modalOpen", "validate", "formSubmit", "formReset", "rowClick", "rowExpand", "selectChange", "selectAllChange", "pageSizeChange", "dropdownClick", "create", "search", "hide", "show", "popoverShow", "popoverHide", "cancel", "remove", "pageUpdate", "currentStepUpdate", "toggleStatus", "stateUpdate", "groupClick", "menuClick", "accordionExpand", "dropdownShow", "dropdownHide", "dropdownSearch", "actionClick", "eventClick", "dateDblClick", "countryChange", "actionButtonClick", "moreActionClick", "expand", "rowSelect", "rowSelectAll", "retry", "selectedFileChange", "preview", "labelButtonClick"];

package/dist/types/global/icons/arrow-up-arrow-down.d.ts

@@ -0,0 +1,3 @@
+import { IconPayload } from '../../helpers/icon/interface';
+declare const _default: IconPayload;
+export default _default;

package/dist/types/global/icons/circle-arrow-down.d.ts

@@ -0,0 +1,3 @@
+import { IconPayload } from '../../helpers/icon/interface';
+declare const _default: IconPayload;
+export default _default;

package/dist/types/global/icons/circle-arrow-up.d.ts

@@ -0,0 +1,3 @@
+import { IconPayload } from '../../helpers/icon/interface';
+declare const _default: IconPayload;
+export default _default;

package/dist/types/helpers/calendar/calendar-period/calendar-period.abstract.d.ts

@@ -9,6 +9,7 @@ export declare abstract class CalendarPeriod {
   private _endDate;
   private readonly _count;
   protected abstract readonly _type: string;
+  protected abstract _showWeekends: boolean;
   protected constructor(count: number, current: Nullable<CalendarDate>);
   /**
    * The current date of the period.
@@ -40,6 +41,12 @@ export declare abstract class CalendarPeriod {
    * @type {string}
    */
   get type(): string;
+  /**
+   * This function returns the showWeekends of the object.
+   *
+   * @type {boolean}
+   */
+  get showWeekends(): boolean;
   /**
    * Go to a specific date.
    *

package/dist/types/helpers/calendar/calendar-period/day-period.d.ts

@@ -6,7 +6,8 @@ import { CalendarDate } from '../calendar-date';
 export declare class DayPeriod extends CalendarPeriod {
   private static readonly DISPLAY_DATE_COUNT;
   protected readonly _type: string;
-  constructor(current?: CalendarDate);
+  protected _showWeekends: boolean;
+  constructor(current?: CalendarDate, showWeekends?: boolean);
   /**
    * @inheritDoc
    */
@@ -15,6 +16,12 @@ export declare class DayPeriod extends CalendarPeriod {
    * @inheritDoc
    */
   previous(): this;
+  /**
+   * Go to now.
+   *
+   * @returns {this} - The current period.
+   */
+  now(): this;
   /**
    * @inheritDoc
    */

package/dist/types/helpers/calendar/calendar-period/month-period.d.ts

@@ -6,7 +6,8 @@ import { CalendarDate } from '../calendar-date';
 export declare class MonthPeriod extends CalendarPeriod {
   private static readonly DISPLAY_DATE_COUNT;
   protected readonly _type: string;
-  constructor(current?: CalendarDate);
+  protected _showWeekends: boolean;
+  constructor(current?: CalendarDate, showWeekends?: boolean);
   /**
    * The function `getMonthFirstDay` returns the first day of a given month in a calendar.
    *

package/dist/types/helpers/calendar/calendar-period/week-period.d.ts

@@ -6,7 +6,8 @@ import { CalendarDate } from '../calendar-date';
 export declare class WeekPeriod extends CalendarPeriod {
   private static readonly DISPLAY_DATE_COUNT;
   protected readonly _type: string;
-  constructor(current?: CalendarDate);
+  protected _showWeekends: boolean;
+  constructor(current?: CalendarDate, showWeekends?: boolean);
   /**
    * @inheritDoc
    */

package/dist/types/helpers/change-manager/subject/static-subject/static-subject-title.d.ts

@@ -1,5 +1,5 @@
 import { Subject } from '../subject-interface';
-export declare type SubjectTitle = 'SIDENAV_LINK_SELECTED_TOPIC' | 'LEFT_NAV_LINK_SELECTED_TOPIC' | 'ACCORDION_EXPAND_TOPIC' | 'FORM_RESET_OPERATION_TRIGGERED' | 'FORM_FIELD_ELEMENT_DISCONNECTED' | 'FORM_SUBMIT' | 'FORM_RESET' | 'RADIO_GROUP_DISABLED_CHANGE' | 'CHECKBOX_GROUP_DISABLED_CHANGE' | 'FORM_FIELD_PENDING_VALID_CHANGE' | 'TAB_PANEL_ADD_OR_DEL_TO_GROUP' | 'TABLE_EXPAND_ROW' | 'TABLE_ROW_SELECTION' | 'TABLE_ROW_SELECTION_ALL' | 'TABLE_SELECTION' | 'TABLE_ROW_CLICK' | 'TABLE_ROW_SELECT' | 'TABLE_ROW_SELECT_ALL' | 'FIELD_ERROR_MESSAGE_CHANGE' | 'DROPDOWN_ITEM_CLICK' | 'CHECKBOX_VALUE_CHANGE' | 'RADIO_VALUE_CHANGE' | 'FORM_ELEMENT_VALUE_CHANGE' | 'FORM_EMEMENT_VALIDATE' | 'FIELD_ERROR_STATE_CHANGE' | 'VEGA_VIRTUAL_SCROLL_TO_BOTTOM' | 'SELECTION_TILE_VALUE_CHANGE' | 'DROPDOWN_RENDER_ITEM_INTERNAL_OVERRIDEN' | 'DROPDOWN_SEARCH_INTERNAL_OVERRIDEN';
+export declare type SubjectTitle = 'SIDENAV_LINK_SELECTED_TOPIC' | 'LEFT_NAV_LINK_SELECTED_TOPIC' | 'ACCORDION_EXPAND_TOPIC' | 'FORM_RESET_OPERATION_TRIGGERED' | 'FORM_FIELD_ELEMENT_DISCONNECTED' | 'FORM_SUBMIT' | 'FORM_RESET' | 'RADIO_GROUP_DISABLED_CHANGE' | 'CHECKBOX_GROUP_DISABLED_CHANGE' | 'FORM_FIELD_PENDING_VALID_CHANGE' | 'TAB_PANEL_ADD_OR_DEL_TO_GROUP' | 'TABLE_EXPAND_ROW' | 'TABLE_ROW_SELECTION' | 'TABLE_ROW_SELECTION_ALL' | 'TABLE_SELECTION' | 'TABLE_ROW_CLICK' | 'TABLE_ROW_SELECT' | 'TABLE_ROW_SELECT_ALL' | 'FIELD_ERROR_MESSAGE_CHANGE' | 'DROPDOWN_ITEM_CLICK' | 'CHECKBOX_VALUE_CHANGE' | 'RADIO_VALUE_CHANGE' | 'FORM_ELEMENT_VALUE_CHANGE' | 'FORM_EMEMENT_VALIDATE' | 'FIELD_ERROR_STATE_CHANGE' | 'VEGA_VIRTUAL_SCROLL_TO_BOTTOM' | 'SELECTION_TILE_VALUE_CHANGE' | 'DROPDOWN_RENDER_ITEM_INTERNAL_OVERRIDEN' | 'DROPDOWN_SEARCH_INTERNAL_OVERRIDEN' | 'UPDATE_TRANSLATION';
 export declare const SIDENAV_LINK_SELECTED_TOPIC: Subject;
 export declare const LEFT_NAV_LINK_SELECTED_TOPIC: Subject;
 export declare const ACCORDION_EXPAND_TOPIC: Subject;
@@ -24,3 +24,4 @@ export declare const FORM_ELEMENT_VALIDATE: Subject;
 export declare const FIELD_ERROR_STATE_CHANGE: Subject;
 export declare const VEGA_VIRTUAL_SCROLL_TO_BOTTOM: Subject;
 export declare const SELECTION_TILE_VALUE_CHANGE: Subject;
+export declare const UPDATE_TRANSLATION: Subject;

package/dist/types/helpers/common/wait-for-vega-handler.d.ts

@@ -10,6 +10,8 @@ declare class WaitForVegaHandler {
    * Wait for all vega elements to be ready.
    *
    * The below method is e2e-test covered in @see{module:wait-for-vega-should-work-as-expected}
+   *
+   * @vegaVersion 2.8.0
    */
   handle(): Promise<Awaited<HTMLVegaElementType>[]>;
 }

package/dist/types/helpers/dialog/vega-dialog-controller.d.ts

@@ -22,6 +22,7 @@ declare class VegaDialogController {
    *
    * @param {VegaDialogOption} options - VegaDialogOption
    * @returns {HTMLElement} The dialog reference.
+   * @vegaVersion 1.24.0
    */
   open(options: VegaDialogOption): HTMLVegaDialogElement;
 }

package/dist/types/helpers/event-manager/vega-event-manager.d.ts

@@ -16,6 +16,7 @@ declare class VegaEventManager {
    * configuration settings for the event semantics. It may include properties such as the event type,
    * event source, event target, event data, and any other relevant information for setting up the
    * semantics of the event.
+   * @vegaVersion 2.0.0
    */
   setSemantics(config: EventSemanticsConfig): void;
   /**
@@ -25,6 +26,7 @@ declare class VegaEventManager {
    * in the DOM (Document Object Model). It can be any valid HTML element such as a div, span, button,
    * etc.
    * @returns {EventSemantics} an object of type EventSemantics.
+   * @vegaVersion 2.0.0
    */
   getSemantics(host: HTMLElement): EventSemantics;
   /**
@@ -33,6 +35,7 @@ declare class VegaEventManager {
    * @param {VegaComponentName} componentName - The component name,
    * etc.
    * @returns {Nullable<VegaEventID[]>} All eventIds.
+   * @vegaVersion 2.0.0
    */
   getEnabledEventIdsByComponent(componentName: VegaComponentName): Nullable<VegaEventID[]>;
 }

package/dist/types/helpers/feature-control/feature-flag-controller.d.ts

@@ -15,12 +15,14 @@ declare class FeatureFlagController {
    * This function enables the feature flags with the given keys.
    *
    * @param {FeatureFlagKey[]} featureFlagKeys - The feature flags to enable.
+   * @vegaVersion 1.3.0
    */
   enable(...featureFlagKeys: FeatureFlagKey[]): void;
   /**
    * Disable the feature flags with the given keys.
    *
    * @param {FeatureFlagKey[]} featureFlagKeys - The feature flags to disable.
+   * @vegaVersion 1.3.0
    */
   disable(...featureFlagKeys: FeatureFlagKey[]): void;
   /**
@@ -28,6 +30,7 @@ declare class FeatureFlagController {
    *
    * @param {FeatureFlagKey} featureFlagKey - The feature flag key to check.
    * @returns {boolean} - True if the feature flag key is in the set of enabled feature flag keys, otherwise false.
+   * @vegaVersion 1.3.0
    */
   isEnabled(featureFlagKey: FeatureFlagKey): boolean;
   /**

package/dist/types/helpers/formatter/string-formatter/number-mask-strategy.d.ts

@@ -1,3 +1,4 @@
+import { Nullable } from '../../../types/general';
 import { StringFormatStrategy } from './string-format-strategy';
 export declare type NumberMaskConfig = {
   /**
@@ -32,6 +33,14 @@ export declare class NumberMaskStrategy implements StringFormatStrategy {
    * @returns {string} The formatted number string.
    */
   format(input: string): string;
+  /**
+   * Get the position of caret
+   *
+   * @param {string} input - input number
+   * @param {number} caretPosition - The current caret position
+   * @returns {number} The new position of caret
+   */
+  calculateCaretPosition(input: string, caretPosition: Nullable<number>): Nullable<number>;
   /**
    * if allow negative, will skip '-', e.g. when input '-' -> '-1.2'
    * if precision is not null, then user can fill input with decimal places, e.g. when input '1.' -> '1.2'
@@ -47,6 +56,17 @@ export declare class NumberMaskStrategy implements StringFormatStrategy {
    * @returns {boolean} return true if the value need mask format. otherwise false
    */
   protected inputNeedFormat(value: string): boolean;
+  /**
+   * Remove zero of beginning, example:
+   *    00012 -> 12
+   *    000.12 -> 0.12
+   *    00123,456 -> 123,456
+   *    .12 -> 0.12
+   *
+   * @param {string} input - the input value
+   * @returns {string} - redressed Number
+   */
+  protected redressAbnormalNumber(input: string): string;
   /**
    * Get the number RegExp
    *

package/dist/types/helpers/icon/icon-manager.d.ts

@@ -11,6 +11,7 @@ declare class IconManager {
    * Registers the icons into the map.
    *
    * @param {Record<string, string>} icons - icon records
+   * @vegaVersion 2.13.0
    */
   register(icons: Record<string, IconPayload>): void;
   /**
@@ -18,6 +19,7 @@ declare class IconManager {
    *
    * @param {string} name - The name of the icon
    * @returns {Nullable<string>} returns the icon svg or null if not found
+   * @vegaVersion 2.13.0
    */
   getIcon(name: string): Nullable<IconPayload>;
   /**
@@ -25,6 +27,7 @@ declare class IconManager {
    *
    * @param {string} name - The name of the icon
    * @returns {boolean} returns true if the icon exists
+   * @vegaVersion 2.13.0
    */
   hasIcon(name: string): boolean;
 }

package/dist/types/helpers/loading-indicator/vega-loader-controller.d.ts

@@ -11,12 +11,14 @@ declare class VegaLoaderController {
    *
    * @param {VegaLoaderIndicatorOptions} options - VegaLoaderOptions = {} options of the method
    * @returns {string} The uuid of the loader.
+   * @vegaVersion 1.16.0
    */
   load(options?: VegaLoaderOptions): Nullable<string>;
   /**
    * Close the loader by id
    *
    * @param {string} id - The id of the loader.
+   * @vegaVersion 1.16.0
    */
   close(id: string): void;
   /**

package/dist/types/helpers/notify/vega-notify-controller.d.ts

@@ -13,20 +13,26 @@ declare class VegaNotifyController {
    *
    * @param {VegaNotifyOption} options - VegaNotifyProps
    * @returns {string} The ID of the notification.
+   * @vegaVersion 1.17.0
    */
   open(options: VegaNotifyOption): Promise<string>;
   /**
    * It closes all notifications
+   *
+   * @vegaVersion 1.17.0
    */
   closeAll(): Promise<void>;
   /**
    * It closes the notification with the given id
    *
    * @param {string} id - The id of the notification to close.
+   * @vegaVersion 1.17.0
    */
   close(id: string): Promise<void>;
   /**
    * The function "connectResizeObserver" is used to connect a resize observer.
+   *
+   * @vegaVersion 1.17.0
    */
   connectResizeObserver(): void;
   /**

package/dist/types/helpers/public-api.d.ts

@@ -14,3 +14,4 @@ export { ValidCreditCardNumberRule } from './validator/rules/valid-credit-card-n
 export { waitForVega } from './common';
 export { IconPayload } from './icon/interface';
 export { VegaSkeletonLoader } from './skeleton-loader/vega-skeleton-loader-controller';
+export { VegaTranslation, en as VegaTranslationResourceEN } from './translation';

package/dist/types/helpers/skeleton-loader/vega-skeleton-loader-controller.d.ts

@@ -18,16 +18,20 @@ declare class VegaSkeletonLoaderController {
    * @param {VegaSkeletonLoaderConfig.items} config.items - Configuration for multiple skeleton items.
    * @param {VegaSkeletonLoaderConfig.layout} config.layout - Layout of the skeleton items.
    * @returns { string } - Key of the loaded skeleton items.
+   * @vegaVersion 2.16.0
    */
   load({ target, type, width, height, items, layout }: VegaSkeletonLoaderConfig): string;
   /**
    * Remove the skeletons from the dom.
    *
    * @param {string} key - The key returned from {@link VegaSkeletonLoaderController.load}.
+   * @vegaVersion 2.16.0
    */
   unLoad(key: string): void;
   /**
    * Remove all the skeletons from the dom.
+   *
+   * @vegaVersion 2.16.0
    */
   unLoadAll(): void;
   /**

package/dist/types/helpers/slimmers/field-error-ui-controller-slimmer.d.ts

@@ -1,17 +1,20 @@
 import { VegaSlimmer } from '../../vega-slimmer/vega-slimmer-core';
+import { EvaluateResult } from '../validator/rules/validation-rule';
 /** The `FieldErrorUIControllerSlimmer` class is responsible for displaying error messages and managing the invalid UI state of a form field. */
 export declare class FieldErrorUIControllerSlimmer extends VegaSlimmer {
   private host;
   private options;
   private fieldErrorUiControllerStrategies;
+  private errorMessage;
+  constructor();
   /**
    * It takes an error message and displays it in the error container.
    * TODO: Each component displays the error message and puts it in the code of the respective component.
    * The ticket is https://gethired.atlassian.net/browse/VD-2508
    *
-   * @param {string} errorMessage - The error message to display.
+   * @param {EvaluateResult['message']} errorMessage - The error message to display.
    */
-  applyInputInvalidUI(errorMessage: string): void;
+  applyInputInvalidUI(errorMessage: EvaluateResult['message']): void;
   /**
    * Reset the input element's invalid UI
    * TODO: Each component hides the error message and puts it in the code of the respective component.
@@ -31,4 +34,21 @@ export declare class FieldErrorUIControllerSlimmer extends VegaSlimmer {
    * @returns {HTMLElement} The error container.
    */
   private getErrorContainer;
+  /**
+   * Translates a given message based on its type.
+   *
+   * @param {EvaluateResult['message'] | EvaluateResultTranslation['message']} message - The message to be translated, which can be a string or a TranslationMessage.
+   * @returns {string} The translated message.
+   */
+  private getTranslatedMessage;
+  /**
+   * Init translation observer of translation language changes
+   */
+  private initTranslationObserver;
+  /**
+   * Determines whether the observer should accept changes.
+   *
+   * @returns {boolean} Always returns true in the current implementation.
+   */
+  private isAcceptableTranslationObserver;
 }

package/dist/types/helpers/slimmers/global/vega-translate-observer-slimmer.d.ts

@@ -0,0 +1,19 @@
+import { GlobalSlimmerConfig, VegaSlimmer } from '../../../vega-slimmer/vega-slimmer-core';
+/**
+ * Class responsible for observing translation updates and triggering re-renders.
+ */
+export declare class VegaTranslateObserverSlimmer extends VegaSlimmer {
+  private readonly component;
+  /**
+   * Component lifecycle - [connectedCallback]
+   * Registers an observer to watch for translation updates, which triggers a forced update on the component.
+   */
+  connectedCallback(): void;
+  constructor(option: GlobalSlimmerConfig);
+  /**
+   * Determines whether the observer should accept changes.
+   *
+   * @returns {boolean} Always returns true in the current implementation.
+   */
+  private isAcceptable;
+}

package/dist/types/helpers/slimmers/sub-state/sub-state-observer-slimmer.d.ts

@@ -55,7 +55,7 @@ export declare class SubStateObserverSlimmer<T extends HTMLStencilElement> exten
    * The function `getParent` returns the parent element of a given host element, based on the observer
    * entry and appender element.
    *
-   * @returns {HTMLElement} the parent HTMLElement.
+   * @returns {Nullable<HTMLElement>} the parent HTMLElement.
    */
   private getParent;
   /**

package/dist/types/helpers/slimmers/test/translation-slimmer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/helpers/slimmers/translation/index.d.ts

@@ -0,0 +1 @@
+export { TranslationSlimmer } from './translation-slimmer';

package/dist/types/helpers/slimmers/translation/translation-slimmer.d.ts

@@ -0,0 +1,22 @@
+import { VegaSlimmer } from '../../../vega-slimmer/vega-slimmer-core';
+import { HTMLStencilElement } from '../../../stencil-public-runtime';
+import { TranslationKeyMap, TranslationKeyType } from '../../translation/interface';
+/**
+ * Translation slimmer for components to use.
+ * Automatically triggers re-render in components that rely on this utility when the language changes.
+ */
+export declare class TranslationSlimmer<T extends HTMLStencilElement> extends VegaSlimmer {
+  host: T;
+  /**
+   * Component lifecycle - [disconnectedCallback]
+   */
+  disconnectedCallback(): void;
+  /**
+   * Retrieves the translated string for the given key based on the current language.
+   *
+   * @param {string} key - The key for the translation.
+   * @param {unknown[]} args - A list of values to replace in the translation string.
+   * @returns {string} The translated string or the key itself if not found.
+   */
+  t<T extends TranslationKeyType = 'static'>(key: TranslationKeyMap[T], ...args: unknown[]): string;
+}

package/dist/types/helpers/theme/theme-manager.d.ts

@@ -9,10 +9,13 @@ declare class ThemeManager {
    * It takes the colors you passed in, parses them into the correct format, and then applies them to the theme
    *
    * @param {VegaThemeOverrideColors} overrideColors - OverrideColors - This is the object that you pass to the function.
+   * @vegaVersion 1.20.0
    */
   overrideColors(overrideColors: VegaThemeOverrideColors): Promise<void>;
   /**
    * It removes all the custom override theme styles from the DOM
+   *
+   * @vegaVersion 1.20.0
    */
   reset(): Promise<void>;
   /**
@@ -21,6 +24,7 @@ declare class ThemeManager {
    * @param {boolean | undefined} darkMode - A boolean or undefined value that determines whether to enable or disable dark mode.
    * If it is true, dark mode is enabled.
    * If it is false, dark mode is disabled.
+   * @vegaVersion 1.32.0
    */
   toggleDarkMode(darkMode: boolean): void;
   /**
@@ -28,6 +32,7 @@ declare class ThemeManager {
    *
    * @returns {boolean} A boolean value indicating whether the HTML element has a class of "dark", which is
    * typically used to indicate that the website is in dark mode.
+   * @vegaVersion 1.32.0
    */
   isDarkMode(): boolean;
 }

package/dist/types/helpers/translation/index.d.ts

@@ -0,0 +1,4 @@
+export * from './interface';
+export { default as en } from './locales/en';
+export { VegaTranslation } from './translation';
+export { VegaInternalTranslation } from './internal-translation-controller';

package/dist/types/helpers/translation/interface.d.ts

@@ -0,0 +1,90 @@
+export type VegaTranslationConfig = {
+	resources?: VegaTranslationResources;
+	language?: string;
+};
+
+export interface VegaTranslationResources {
+	[language: string]: Record<string, string>;
+}
+
+export type TranslationKeyType = 'static' | 'dynamic';
+
+export interface TranslationKeyMap {
+	static: StaticTranslationKey;
+	dynamic: string;
+}
+
+/* eslint-disable @typescript-eslint/naming-convention */
+export type StaticTranslationKey =
+	// Form validation rule
+	| 'This field is required'
+	| 'The minimum input value is {0}'
+	| 'The maximum input value is {0}'
+	| 'The end value should be greater than the start value'
+	| 'The end date should be later than start date'
+	| 'Credit card number is invalid'
+	| 'Please enter the correct email format.'
+	| 'The maximum input length is {0}'
+	| 'The start date should be later than {0}'
+	| 'The start date should be earlier than {0}'
+	| 'The end date should be earlier than {0}'
+	| 'The date should be later than {0}'
+	| 'The date should be earlier than {0}'
+	| 'The minimum input length is {0}'
+	| 'The end time should be later than start time'
+	| 'Phone number is not valid'
+	| 'Phone number is valid but it belongs to country {0}, not country {1}'
+	// Component internal text
+	// Common start
+	| 'January'
+	| 'February'
+	| 'March'
+	| 'April'
+	| 'May'
+	| 'June'
+	| 'July'
+	| 'August'
+	| 'September'
+	| 'October'
+	| 'November'
+	| 'December'
+	| 'Sun'
+	| 'Mon'
+	| 'Tue'
+	| 'Wed'
+	| 'Thu'
+	| 'Fri'
+	| 'Sat'
+	| 'Sun-short'
+	| 'Mon-short'
+	| 'Tue-short'
+	| 'Wed-short'
+	| 'Thu-short'
+	| 'Fri-short'
+	| 'Sat-short'
+	| 'Day'
+	| 'Week'
+	| 'Month'
+	| 'Today'
+	| 'Clear'
+	// Common end
+	| 'Viewing'
+	| 'Show'
+	| 'Go To'
+	| 'Viewing {0}-{1} of {2}'
+	| 'Upload'
+	| 'All Day'
+	| 'Select or drop your file here'
+	| 'Please sign here'
+	| 'Clear Signature'
+	| 'Start Date'
+	| 'End Date'
+	| 'Please select'
+	| 'No options'
+	| 'No results found'
+	| 'Minimum'
+	| 'Maximum'
+	| 'Select Time'
+	| 'Start Time'
+	| 'End Time'
+	| 'There is no data to display';

package/dist/types/helpers/translation/internal-translation-controller.d.ts

@@ -0,0 +1,58 @@
+import { TranslationKeyMap, TranslationKeyType, VegaTranslationConfig } from './interface';
+import { HTMLStencilElement } from '../../stencil-public-runtime';
+/**
+ * Vega translation controller to control the internal text translation
+ */
+declare class InternalTranslationController {
+  private static connectedComponents;
+  private resources;
+  private _currentLanguage;
+  constructor();
+  /**
+   * Get current language
+   *
+   * @returns {string} current language
+   */
+  get currentLanguage(): string;
+  /**
+   * Initializes the translation controller with provided resources and language.
+   *
+   * @param {VegaTranslationConfig} config - The configuration object containing resources and initial language.
+   */
+  init({ resources, language }: VegaTranslationConfig): void;
+  /**
+   * Changes the current language if it exists in the resources.
+   *
+   * @param {string} language - The language code to change to.
+   */
+  changeLanguage(language: string): void;
+  /**
+   * Retrieves the translated string for the given key based on the current language.
+   *
+   * @param {string} key - The key for the translation.
+   * @param {unknown[]} args - A list of values to replace in the translation string.
+   * @returns {string} The translated string or the key itself if not found.
+   */
+  t<T extends TranslationKeyType = 'static'>(key: TranslationKeyMap[T], ...args: unknown[]): string;
+  /**
+   * Registers a component to the `connectedComponents` map, associating it with the component's tag name.
+   * If the tag already exists, it adds the component to the existing set of components.
+   *
+   * @param {HTMLStencilElement} host - The component instance to register.
+   */
+  registerComponent<T extends HTMLStencilElement>(host: T): void;
+  /**
+   * Unregister a component from the `connectedComponents` map.
+   *
+   * @param {HTMLStencilElement} host - The component instance to unregister.
+   */
+  unRegisterComponent<T extends HTMLStencilElement>(host: T): void;
+  /**
+   * Retrieves the map of connected components, where each entry associates a tag name with a set of components.
+   *
+   * @returns {Map<string, Set<HTMLElement>>} A map of connected components.
+   */
+  getConnectedComponents(): Map<string, Set<HTMLElement>>;
+}
+export declare const VegaInternalTranslation: InternalTranslationController;
+export {};

package/dist/types/helpers/translation/locales/en.d.ts

@@ -0,0 +1,5 @@
+import { StaticTranslationKey } from '../interface';
+export declare const staticTranslations: {
+  [key in StaticTranslationKey]: string;
+};
+export default staticTranslations;

package/dist/types/helpers/translation/tests/internal-translation-controller.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/helpers/translation/tests/translation.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/helpers/translation/translation.d.ts

@@ -0,0 +1,33 @@
+import { VegaTranslationConfig } from './interface';
+import { VegaPublicAPIRuntimeMetricsSlimmerBase } from '../slimmers/runtime-metrics/public-api-runtime-metrics-slimmer-base';
+/**
+ * Vega Translation Public API
+ *
+ * @vegaVersion 2.27.0
+ */
+declare class TranslationController {
+  protected vegaPublicAPIRuntimeMetricsSlimmer: VegaPublicAPIRuntimeMetricsSlimmerBase;
+  /**
+   * Get current language
+   *
+   * @returns {string} current language
+   * @vegaVersion 2.27.0
+   */
+  get currentLanguage(): string;
+  /**
+   * Initializes the translation controller with provided resources and language.
+   *
+   * @param {VegaTranslationConfig} config - Configuration object containing resources and initial language.
+   * @vegaVersion 2.27.0
+   */
+  init(config: VegaTranslationConfig): void;
+  /**
+   * Changes the current language if it exists in the resources.
+   *
+   * @param {string} language - The language code to change to.
+   * @vegaVersion 2.27.0
+   */
+  changeLanguage(language: string): void;
+}
+export declare const VegaTranslation: TranslationController;
+export {};