@progress/kendo-vue-intl 3.5.0 → 3.5.1-dev.202208150613

package/dist/esm/Intl/IntlService.d.ts

@@ -0,0 +1,98 @@
+import { DateFormatOptions, NumberFormatOptions, DateFieldNameOptions, DateFormatNameOptions, DateFormatPart } from './../coreExports';
+/**
+ * A service which provides internationalization methods
+ * and is bound to a specific locale.
+ */
+export declare class IntlService {
+    private locale;
+    /**
+     * Creates a new instance of the internationalization service.
+     *
+     * @param locale - The locale that will be used by the internationalization methods.
+     */
+    constructor(locale: string);
+    /**
+     * Formats a string with placeholders such as
+     * `Total amount {0:c}`.
+     *
+     * @param format - The format string.
+     * @param values - One or more values to output in the format string placeholders.
+     * @return - The formatted string.
+     */
+    format(format: string, ...values: any[]): string;
+    /**
+     * Converts a `Date` object to a string based on the specified format.
+     * If no format is provided, the default short date format is used.
+     *
+     * @param value - The date which will be formatted.
+     * @param format - The format string or options.
+     * @return - The formatted date.
+     */
+    formatDate(value: Date, format?: string | DateFormatOptions): string;
+    /**
+     * Converts an object to a string based on the specified format.
+     *
+     * @param value - The value which will be formatted.
+     * @param format - The format to use.
+     * @return - The formatted object.
+     */
+    toString(value: any, format: string | any): string;
+    /**
+     * Converts a string to a `Number`.
+     *
+     * @param value - The string which will be parsed.
+     * @param format - The format string or options.
+     * @return - The parsed number.
+     */
+    parseNumber(value: string, format?: string | NumberFormatOptions): number;
+    /**
+     * Converts a string to a `Date` object based on the specified format.
+     *
+     * @param value - The string which will be converted.
+     * @param format - The format strings or options.
+     * @return - The parsed date.
+     */
+    parseDate(value: string, format?: string | DateFormatOptions | string[] | DateFormatOptions[]): Date;
+    /**
+     * Converts a `Number` to a string based on the specified format.
+     *
+     * @param value - The number which will be formatted.
+     * @param format - The format string or options.
+     * @return - The formatted number.
+     */
+    formatNumber(value: number, format: string | NumberFormatOptions): string;
+    /**
+     * Returns a localized date field name based on specific `dateFieldName` options.
+     *
+     * @param options - The detailed configuration for the desired date field name.
+     * @returns - The localized date field name from the current locale based on the option.
+     */
+    dateFieldName(options: DateFieldNameOptions): string;
+    /**
+     * Returns the day names from the current locale based on the option.
+     *
+     * @param options - The detailed configuration for the desired date format.
+     * @return - The day names from the current locale based on the option.
+     */
+    dateFormatNames(options: DateFormatNameOptions): any;
+    /**
+     * Splits the date format into objects which contain
+     * information about each part of the pattern.
+     *
+     * @param format - The format string or options.
+     * @returns - The date format parts.
+     */
+    splitDateFormat(format: string | DateFormatOptions): DateFormatPart[];
+    /**
+     * Returns the number symbols from the current locale.
+     *
+     * @return - The number symbols from the current locale.
+     */
+    numberSymbols(): any;
+    /**
+     * Returns the first day index, starting from Sunday.
+     *
+     * @return - The index of the first day of the week (0 == Sunday).
+     */
+    firstDay(): number;
+}

package/dist/esm/Intl/IntlService.js

@@ -0,0 +1,134 @@
+import * as coreIntl from '@progress/kendo-intl';
+/**
+ * A service which provides internationalization methods
+ * and is bound to a specific locale.
+ */
+var IntlService = /** @class */ (function () {
+    /**
+     * Creates a new instance of the internationalization service.
+     *
+     * @param locale - The locale that will be used by the internationalization methods.
+     */
+    function IntlService(locale) {
+        this.locale = locale;
+        if (locale === '' && process.env.NODE_ENV !== 'production') {
+            throw 'Locale should not be empty string';
+        }
+    }
+    /**
+     * Formats a string with placeholders such as
+     * `Total amount {0:c}`.
+     *
+     * @param format - The format string.
+     * @param values - One or more values to output in the format string placeholders.
+     * @return - The formatted string.
+     */
+    IntlService.prototype.format = function (format) {
+        var values = [];
+        for (var _i = 1; _i < arguments.length; _i++) {
+            values[_i - 1] = arguments[_i];
+        }
+        /* The following code retains backward compatibility with the old API */
+        if (values.length === 1 && Array.isArray(values[0])) {
+            return coreIntl.format(format, values[0], this.locale);
+        }
+        return coreIntl.format(format, values, this.locale);
+    };
+    /**
+     * Converts a `Date` object to a string based on the specified format.
+     * If no format is provided, the default short date format is used.
+     *
+     * @param value - The date which will be formatted.
+     * @param format - The format string or options.
+     * @return - The formatted date.
+     */
+    IntlService.prototype.formatDate = function (value, format) {
+        return coreIntl.formatDate(value, format, this.locale);
+    };
+    /**
+     * Converts an object to a string based on the specified format.
+     *
+     * @param value - The value which will be formatted.
+     * @param format - The format to use.
+     * @return - The formatted object.
+     */
+    IntlService.prototype.toString = function (value, format) {
+        return coreIntl.toString(value, format, this.locale);
+    };
+    /**
+     * Converts a string to a `Number`.
+     *
+     * @param value - The string which will be parsed.
+     * @param format - The format string or options.
+     * @return - The parsed number.
+     */
+    IntlService.prototype.parseNumber = function (value, format) {
+        return coreIntl.parseNumber(value, this.locale, format);
+    };
+    /**
+     * Converts a string to a `Date` object based on the specified format.
+     *
+     * @param value - The string which will be converted.
+     * @param format - The format strings or options.
+     * @return - The parsed date.
+     */
+    IntlService.prototype.parseDate = function (value, format) {
+        return coreIntl.parseDate(value, format, this.locale);
+    };
+    /**
+     * Converts a `Number` to a string based on the specified format.
+     *
+     * @param value - The number which will be formatted.
+     * @param format - The format string or options.
+     * @return - The formatted number.
+     */
+    IntlService.prototype.formatNumber = function (value, format) {
+        return coreIntl.formatNumber(value, format, this.locale);
+    };
+    /**
+     * Returns a localized date field name based on specific `dateFieldName` options.
+     *
+     * @param options - The detailed configuration for the desired date field name.
+     * @returns - The localized date field name from the current locale based on the option.
+     */
+    IntlService.prototype.dateFieldName = function (options) {
+        return coreIntl.dateFieldName(options, this.locale);
+    };
+    /**
+     * Returns the day names from the current locale based on the option.
+     *
+     * @param options - The detailed configuration for the desired date format.
+     * @return - The day names from the current locale based on the option.
+     */
+    IntlService.prototype.dateFormatNames = function (options) {
+        return coreIntl.dateFormatNames(this.locale, options);
+    };
+    /**
+     * Splits the date format into objects which contain
+     * information about each part of the pattern.
+     *
+     * @param format - The format string or options.
+     * @returns - The date format parts.
+     */
+    IntlService.prototype.splitDateFormat = function (format) {
+        return coreIntl.splitDateFormat(format, this.locale);
+    };
+    /**
+     * Returns the number symbols from the current locale.
+     *
+     * @return - The number symbols from the current locale.
+     */
+    IntlService.prototype.numberSymbols = function () {
+        return coreIntl.numberSymbols(this.locale);
+    };
+    /**
+     * Returns the first day index, starting from Sunday.
+     *
+     * @return - The index of the first day of the week (0 == Sunday).
+     */
+    IntlService.prototype.firstDay = function () {
+        return coreIntl.firstDay(this.locale);
+    };
+    return IntlService;
+}());
+export { IntlService };

package/dist/esm/Intl/main.d.ts

@@ -0,0 +1,4 @@
+import { IntlProvider, IntlProviderVue2 } from './IntlProvider';
+import { IntlProviderProps } from './IntlProviderProps';
+import { IntlService } from './IntlService';
+export { IntlProvider, IntlProviderVue2, IntlProviderProps, IntlService };

package/dist/esm/Intl/main.js

@@ -0,0 +1,8 @@
+import { IntlProvider, IntlProviderVue2 } from './IntlProvider.js';
+import { IntlService } from './IntlService.js';
+export { IntlProvider, IntlProviderVue2, IntlService };
+// Automatic installation if Vue has been added to the global scope.
+var vue = 'Vue';
+if (typeof window !== 'undefined' && window[vue] && window[vue].component) {
+    window[vue].component('kendo-intl-provider', IntlProvider);
+}

package/dist/esm/Localization/LocalizationProvider.d.ts

@@ -0,0 +1,49 @@
+import { DefineComponent, RecordPropsDefinition, ComponentOptions, Vue2type } from '../additionalTypes';
+declare type DefaultMethods<V> = {
+    [key: string]: (this: V, ...args: any[]) => any;
+};
+declare type DefaultData<V> = object | ((this: V) => LocalizationProviderData);
+import { LocalizationProviderProps } from './LocalizationProviderProps';
+/**
+ * @hidden
+ */
+export interface LocalizationProviderMethods {
+    [key: string]: any;
+    getLocalizationService: () => void;
+    getChildContext: () => void;
+}
+/**
+ * @hidden
+ */
+export interface LocalizationProviderData {
+}
+/**
+ * @hidden
+ */
+export interface LocalizationProviderAllMethods extends Vue2type, LocalizationProviderMethods {
+}
+/**
+ * @hidden
+ */
+declare let LocalizationProviderVue2: ComponentOptions<LocalizationProviderAllMethods, DefaultData<LocalizationProviderData>, DefaultMethods<LocalizationProviderAllMethods>, {}, RecordPropsDefinition<LocalizationProviderProps>>;
+/**
+ *
+ *
+ * A Vue component which provides a localization service. Expects a language string as a property of the component.
+ *
+ *
+ * ### props
+ * The props of the LocalizationProvider component.
+ *
+ *
+ *
+ * ## Methods
+ *
+ * ### getLocalizationService
+ * Returns a localization service. The method is suitable for overriding when you implement custom localization behavior.
+ *
+ * #### Returns
+ * <span class='code'>[LocalizationService]({% slug api_intl_localizationservice %})</span>
+ */
+declare const LocalizationProvider: DefineComponent<LocalizationProviderProps, any, LocalizationProviderData, {}, LocalizationProviderMethods, {}, {}, {}, string, LocalizationProviderProps, LocalizationProviderProps, {}>;
+export { LocalizationProvider, LocalizationProviderVue2 };

package/dist/esm/Localization/LocalizationProvider.js

@@ -0,0 +1,92 @@
+// @ts-ignore
+import * as Vue from 'vue';
+var allVue = Vue;
+var gh = allVue.h;
+var isV3 = allVue.version && allVue.version[0] === '3';
+var ref = allVue.ref;
+var provide = allVue.provide;
+import { LocalizationService } from './LocalizationService.js';
+import { getDefaultSlots } from '@progress/kendo-vue-common';
+/**
+ * @hidden
+ */
+
+var LocalizationProviderVue2 = {
+  props: {
+    language: String
+  },
+  data: function data() {
+    return this.getChildContext();
+  },
+  watch: {
+    language: function language(newLanguage) {
+      this.$data.kendoLocalizationService.language = newLanguage;
+    }
+  },
+  // @ts-ignore
+  setup: !isV3 ? undefined : function (props) {
+    var v3 = !!isV3;
+    var localizationService = ref(new LocalizationService(props.language));
+    provide('kendoLocalizationService', localizationService);
+    return {
+      v3: v3
+    };
+  },
+  provide: function provide() {
+    return {
+      kendoLocalizationService: this.$data.kendoLocalizationService
+    };
+  },
+  methods: {
+    /**
+     * Returns a localization service.
+     * The method is suitable for overriding when you
+     * implement custom localization behavior.
+     */
+    getLocalizationService: function getLocalizationService() {
+      return new LocalizationService(this.$props.language);
+    },
+
+    /**
+     * @hidden
+     */
+    getChildContext: function getChildContext() {
+      return {
+        kendoLocalizationService: this.getLocalizationService()
+      };
+    }
+  },
+
+  /**
+   * @hidden
+   */
+  // @ts-ignore
+  render: function render(createElement) {
+    // @ts-ignore
+    var h = gh || createElement;
+    var defaultSlot = getDefaultSlots(this);
+    return h("div", [defaultSlot]);
+  }
+};
+/**
+ *
+ *
+ * A Vue component which provides a localization service. Expects a language string as a property of the component.
+ *
+ *
+ * ### props
+ * The props of the LocalizationProvider component.
+ *
+ *
+ *
+ * ## Methods
+ *
+ * ### getLocalizationService
+ * Returns a localization service. The method is suitable for overriding when you implement custom localization behavior.
+ *
+ * #### Returns
+ * <span class='code'>[LocalizationService]({% slug api_intl_localizationservice %})</span>
+ */
+
+var LocalizationProvider = LocalizationProviderVue2;
+export { LocalizationProvider, LocalizationProviderVue2 };

package/dist/esm/Localization/LocalizationProviderProps.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Represents the props of the KendoVue LocalizationProvider component.
+ */
+export interface LocalizationProviderProps {
+    /**
+     * The language that will be used by the child components.
+     */
+    language: string;
+}

package/dist/esm/Localization/LocalizationProviderProps.js

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

package/dist/esm/Localization/LocalizationService.d.ts

@@ -0,0 +1,18 @@
+/**
+ * A service which provides localization methods.
+ */
+export declare class LocalizationService {
+    private language?;
+    constructor(language?: string);
+    /**
+     * Provides a string based on a key for the current language.
+     * When no string for the current language is available under this key,
+     * the `defaultValue` is returned.
+     *
+     * @param key - The key which identifies the string for the current language.
+     * @param defaultValue - The default value which will be returned when no string
+     * for the current language is available under the key.
+     * @return - The string for the current language.
+     */
+    toLanguageString(key: string, defaultValue: string): string;
+}

package/dist/esm/Localization/LocalizationService.js

@@ -0,0 +1,39 @@
+import { messages } from './messages.js';
+/**
+ * A service which provides localization methods.
+ */
+var LocalizationService = /** @class */ (function () {
+    function LocalizationService(language) {
+        this.language = language;
+        if (language === '' && process.env.NODE_ENV !== 'production') {
+            throw 'Language should not be an empty string';
+        }
+    }
+    /**
+     * Provides a string based on a key for the current language.
+     * When no string for the current language is available under this key,
+     * the `defaultValue` is returned.
+     *
+     * @param key - The key which identifies the string for the current language.
+     * @param defaultValue - The default value which will be returned when no string
+     * for the current language is available under the key.
+     * @return - The string for the current language.
+     */
+    LocalizationService.prototype.toLanguageString = function (key, defaultValue) {
+        if (this.language &&
+            messages[this.language] &&
+            messages[this.language].hasOwnProperty(key)) {
+            return messages[this.language][key];
+        }
+        else if (Object.keys(this)[0] &&
+            messages[Object.values(this)[0]] &&
+            messages[Object.values(this)[0]].hasOwnProperty(key)) {
+            return messages[Object.values(this)[0]][key];
+        }
+        else {
+            return defaultValue;
+        }
+    };
+    return LocalizationService;
+}());
+export { LocalizationService };

package/dist/esm/Localization/loadMessages.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Provides mechanism to load language-specific messages for the KendoVue components.
+ *
+ * @param messages - An iterable object which contains key-value pairs.
+ * @param languages - The language to which the messages are associated.
+ */
+export declare function loadMessages(messages: any, language: string): void;

package/dist/esm/Localization/loadMessages.js

@@ -0,0 +1,35 @@
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+import { messages as msg } from './messages.js';
+var traverse = function (iterable, langInfo, acc) {
+    for (var key in iterable) {
+        if (iterable.hasOwnProperty(key)) {
+            var accumulator = __spreadArray([], acc, true);
+            accumulator.push(key);
+            if (typeof iterable[key] !== 'string') {
+                traverse(iterable[key], langInfo, accumulator);
+            }
+            else {
+                var value = iterable[key];
+                Object.defineProperty(langInfo, accumulator.join('.'), { value: value });
+            }
+        }
+    }
+};
+/**
+ * Provides mechanism to load language-specific messages for the KendoVue components.
+ *
+ * @param messages - An iterable object which contains key-value pairs.
+ * @param languages - The language to which the messages are associated.
+ */
+export function loadMessages(messages, language) {
+    var langInfo = msg[language] = msg[language] || {};
+    traverse(messages, langInfo, []);
+}

package/dist/esm/Localization/main.d.ts

@@ -0,0 +1,5 @@
+import { loadMessages } from './loadMessages';
+import { LocalizationProvider, LocalizationProviderVue2 } from './LocalizationProvider';
+import { LocalizationProviderProps } from './LocalizationProviderProps';
+import { LocalizationService } from './LocalizationService';
+export { loadMessages, LocalizationProvider, LocalizationProviderVue2, LocalizationProviderProps, LocalizationService };

package/dist/esm/Localization/main.js

@@ -0,0 +1,9 @@
+import { loadMessages } from './loadMessages.js';
+import { LocalizationProvider, LocalizationProviderVue2 } from './LocalizationProvider.js';
+import { LocalizationService } from './LocalizationService.js';
+export { loadMessages, LocalizationProvider, LocalizationProviderVue2, LocalizationService };
+// Automatic installation if Vue has been added to the global scope.
+var vue = 'Vue';
+if (typeof window !== 'undefined' && window[vue] && window[vue].component) {
+    window[vue].component('kendo-localization-provider', LocalizationProvider);
+}

package/dist/esm/Localization/messages.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @hidden
+ */
+export declare const messages: any;

package/dist/esm/Localization/messages.js

@@ -0,0 +1,4 @@
+/**
+ * @hidden
+ */
+export var messages = Object.create({});

package/dist/esm/additionalTypes.ts

@@ -0,0 +1,21 @@
+// @ts-ignore
+import { DefineComponent } from 'vue';
+// @ts-ignore
+import * as Vue from 'vue';
+
+/**
+ * @hidden
+ */
+// @ts-ignore
+type Vue2type = Vue.default;
+
+/**
+ * @hidden
+ */
+// @ts-ignore
+import { RecordPropsDefinition, ComponentOptions } from 'vue/types/options';
+/**
+ * @hidden
+ */
+// @ts-ignore
+export { DefineComponent, RecordPropsDefinition, ComponentOptions, Vue2type };

package/dist/esm/coreExports.d.ts

@@ -0,0 +1 @@
+export { DateFormatOptions, NumberFormatOptions, DateFieldNameOptions, DateFormatNameOptions, DateFormatPart, load } from '@progress/kendo-intl';

package/dist/esm/coreExports.js

@@ -0,0 +1 @@
+export { load } from '@progress/kendo-intl';

package/dist/esm/intlUtils.d.ts

@@ -0,0 +1,21 @@
+import { IntlService } from './Intl/IntlService';
+import { LocalizationService } from './Localization/LocalizationService';
+/**
+ * Provides an internationalization service.
+ * When the passed component is a direct or indirect child of
+ * `IntlProvider`, the returned service uses the locale of the provider.
+ * Otherwise, uses `en` as a default locale.
+ * To handle locale changes, call the method on each `render`.
+ *
+ * @param componentClass - The Vue component class that will use the internationalization service.
+ */
+export declare function provideIntlService(component: any): IntlService;
+/**
+ * Provides a localization service.
+ * When the passed component is a direct or indirect child of
+ * `LocalizationProvider`, the returned service uses the language of the provider.
+ * To handle locale changes, call the method on each `render`.
+ *
+ * @param componentClass - The Vue component class that will use the internationalization service.
+ */
+export declare function provideLocalizationService(component: any): LocalizationService;

package/dist/esm/intlUtils.js

@@ -0,0 +1,37 @@
+import { IntlService } from './Intl/IntlService.js';
+import { LocalizationService } from './Localization/LocalizationService.js';
+/**
+ * Provides an internationalization service.
+ * When the passed component is a direct or indirect child of
+ * `IntlProvider`, the returned service uses the locale of the provider.
+ * Otherwise, uses `en` as a default locale.
+ * To handle locale changes, call the method on each `render`.
+ *
+ * @param componentClass - The Vue component class that will use the internationalization service.
+ */
+export function provideIntlService(component) {
+    if (!component && process.env.NODE_ENV !== 'production') {
+        throw "Passed component - ".concat(component, " is invalid.");
+    }
+    var intlServiceFromContext = component.kendoIntlService;
+    return (intlServiceFromContext &&
+        Object.keys(intlServiceFromContext).some(function (item) { return item === 'locale'; }))
+        ? intlServiceFromContext : new IntlService('en');
+}
+/**
+ * Provides a localization service.
+ * When the passed component is a direct or indirect child of
+ * `LocalizationProvider`, the returned service uses the language of the provider.
+ * To handle locale changes, call the method on each `render`.
+ *
+ * @param componentClass - The Vue component class that will use the internationalization service.
+ */
+export function provideLocalizationService(component) {
+    if (!component && process.env.NODE_ENV !== 'production') {
+        throw "Passed component - ".concat(component, " is invalid.");
+    }
+    var localizationServiceFromContext = component.kendoLocalizationService;
+    return (localizationServiceFromContext &&
+        Object.keys(localizationServiceFromContext).some(function (item) { return item === 'language'; }))
+        ? localizationServiceFromContext : new LocalizationService();
+}

package/dist/esm/main.d.ts

@@ -0,0 +1,4 @@
+export * from './Intl/main';
+export * from './Localization/main';
+export * from './coreExports';
+export * from './intlUtils';

package/dist/esm/main.js

@@ -0,0 +1,4 @@
+export * from './Intl/main.js';
+export * from './Localization/main.js';
+export * from './coreExports.js';
+export * from './intlUtils.js';

package/dist/esm/package-metadata.d.ts

@@ -0,0 +1,5 @@
+import { PackageMetadata } from '@progress/kendo-licensing';
+/**
+ * @hidden
+ */
+export declare const packageMetadata: PackageMetadata;

package/dist/esm/package-metadata.js

@@ -0,0 +1,11 @@
+/**
+ * @hidden
+ */
+export var packageMetadata = {
+    name: '@progress/kendo-vue-intl',
+    productName: 'Kendo UI for Vue',
+    productCodes: ['KENDOUIVUE', 'KENDOUICOMPLETE'],
+    publishDate: 1660543026,
+    version: '',
+    licensingDocsUrl: 'https://www.telerik.com/kendo-vue-ui/my-license/?utm_medium=product&utm_source=kendovue&utm_campaign=kendo-ui-vue-purchase-license-keys-warning'
+};

package/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+                    "type": "module"
+                 }