@progress/kendo-react-intl 13.3.0 → 13.4.0-develop.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/Intl/IntlDataProvider.d.ts +19 -0
- package/Intl/IntlProvider.d.ts +30 -0
- package/Intl/IntlProviderProps.d.ts +20 -0
- package/Intl/IntlService.d.ts +109 -0
- package/Intl/load.d.ts +19 -0
- package/Intl/main.d.ts +12 -0
- package/Localization/LocalizationDataProvider.d.ts +19 -0
- package/Localization/LocalizationProvider.d.ts +30 -0
- package/Localization/LocalizationProviderProps.d.ts +20 -0
- package/Localization/LocalizationService.d.ts +31 -0
- package/Localization/loadMessages.d.ts +18 -0
- package/Localization/main.d.ts +12 -0
- package/Localization/messages.d.ts +11 -0
- package/coreExports.d.ts +8 -0
- package/dist/cdn/js/kendo-react-intl.js +1 -1
- package/globalization/GlobalizationContext.d.ts +17 -0
- package/hooks/index.d.ts +9 -0
- package/hooks/useInternationalization.d.ts +12 -0
- package/hooks/useLocalization.d.ts +12 -0
- package/index.d.mts +8 -301
- package/index.d.ts +8 -301
- package/intlUtils.d.ts +34 -0
- package/package-metadata.d.ts +12 -0
- package/package-metadata.mjs +13 -0
- package/package.json +9 -3
- package/server/ServerGlobalization.d.ts +24 -0
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
*-------------------------------------------------------------------------------------------
|
|
4
|
+
* Copyright © 2026 Progress Software Corporation. All rights reserved.
|
|
5
|
+
* Licensed under commercial license. See LICENSE.md in the package root for more information
|
|
6
|
+
*-------------------------------------------------------------------------------------------
|
|
7
|
+
*/
|
|
8
|
+
/**
|
|
9
|
+
* @hidden Currently used only externally through the ServerGlobalization of the Grid.
|
|
10
|
+
*/
|
|
11
|
+
export type IntlDataProviderProps = {
|
|
12
|
+
data: any[];
|
|
13
|
+
locale: string;
|
|
14
|
+
children: React.ReactNode;
|
|
15
|
+
};
|
|
16
|
+
/**
|
|
17
|
+
* @hidden Currently used only externally through the ServerGlobalization of the Grid.
|
|
18
|
+
*/
|
|
19
|
+
export declare const IntlDataProvider: (props: IntlDataProviderProps) => import('react').ReactNode;
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
*-------------------------------------------------------------------------------------------
|
|
4
|
+
* Copyright © 2026 Progress Software Corporation. All rights reserved.
|
|
5
|
+
* Licensed under commercial license. See LICENSE.md in the package root for more information
|
|
6
|
+
*-------------------------------------------------------------------------------------------
|
|
7
|
+
*/
|
|
8
|
+
import { default as PropTypes } from 'prop-types';
|
|
9
|
+
import { IntlService } from './IntlService.js';
|
|
10
|
+
import { IntlProviderProps } from './IntlProviderProps.js';
|
|
11
|
+
import * as React from 'react';
|
|
12
|
+
/**
|
|
13
|
+
* A React component which provides an internationalization service. Expects a locale string as a property of the component.
|
|
14
|
+
*/
|
|
15
|
+
export declare class IntlProvider extends React.Component<IntlProviderProps, {}> {
|
|
16
|
+
/**
|
|
17
|
+
* @hidden
|
|
18
|
+
*/
|
|
19
|
+
static propTypes: {
|
|
20
|
+
locale: PropTypes.Requireable<string>;
|
|
21
|
+
};
|
|
22
|
+
/**
|
|
23
|
+
* Returns an internationalization service. The method is suitable for overriding when you implement custom internationalization behavior.
|
|
24
|
+
*/
|
|
25
|
+
getIntlService(): IntlService;
|
|
26
|
+
/**
|
|
27
|
+
* @hidden
|
|
28
|
+
*/
|
|
29
|
+
render(): React.JSX.Element;
|
|
30
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
*-------------------------------------------------------------------------------------------
|
|
4
|
+
* Copyright © 2026 Progress Software Corporation. All rights reserved.
|
|
5
|
+
* Licensed under commercial license. See LICENSE.md in the package root for more information
|
|
6
|
+
*-------------------------------------------------------------------------------------------
|
|
7
|
+
*/
|
|
8
|
+
/**
|
|
9
|
+
* Represents the props of the KendoReact IntlProvider component.
|
|
10
|
+
*/
|
|
11
|
+
export interface IntlProviderProps {
|
|
12
|
+
/**
|
|
13
|
+
* The locale that will be used by the child components.
|
|
14
|
+
*/
|
|
15
|
+
locale: string;
|
|
16
|
+
/**
|
|
17
|
+
* @hidden
|
|
18
|
+
*/
|
|
19
|
+
children?: React.ReactNode;
|
|
20
|
+
}
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
*-------------------------------------------------------------------------------------------
|
|
4
|
+
* Copyright © 2026 Progress Software Corporation. All rights reserved.
|
|
5
|
+
* Licensed under commercial license. See LICENSE.md in the package root for more information
|
|
6
|
+
*-------------------------------------------------------------------------------------------
|
|
7
|
+
*/
|
|
8
|
+
import { DateFormatOptions, NumberFormatOptions, DateFieldNameOptions, DateFormatNameOptions, DateFormatPart } from './../coreExports.js';
|
|
9
|
+
/**
|
|
10
|
+
* A service which provides internationalization methods and is bound to a specific locale.
|
|
11
|
+
*/
|
|
12
|
+
export declare class IntlService {
|
|
13
|
+
locale: string;
|
|
14
|
+
/**
|
|
15
|
+
* Creates a new instance of the internationalization service.
|
|
16
|
+
*
|
|
17
|
+
* @param locale - The locale that will be used by the internationalization methods.
|
|
18
|
+
*/
|
|
19
|
+
constructor(locale: string);
|
|
20
|
+
/**
|
|
21
|
+
* Formats a string with placeholders such as `Total amount {0:c}`.
|
|
22
|
+
*
|
|
23
|
+
* @param format - The format string.
|
|
24
|
+
* @param values - One or more values to output in the format string placeholders.
|
|
25
|
+
* @return - The formatted string.
|
|
26
|
+
*/
|
|
27
|
+
format(format: string, ...values: any[]): string;
|
|
28
|
+
/**
|
|
29
|
+
* Converts a `Date` object to a string based on the specified format. If no format is provided, the default short date format is used.
|
|
30
|
+
*
|
|
31
|
+
* @param value - The date which will be formatted.
|
|
32
|
+
* @param format - The format string or options.
|
|
33
|
+
* @return - The formatted date.
|
|
34
|
+
*/
|
|
35
|
+
formatDate(value: Date, format?: string | DateFormatOptions): string;
|
|
36
|
+
/**
|
|
37
|
+
* Converts an object to a string based on the specified format.
|
|
38
|
+
*
|
|
39
|
+
* @param value - The value which will be formatted.
|
|
40
|
+
* @param format - The format to use.
|
|
41
|
+
* @return - The formatted object.
|
|
42
|
+
*/
|
|
43
|
+
toString(value: any, format: string | any): string;
|
|
44
|
+
/**
|
|
45
|
+
* Converts a string to a `Number`.
|
|
46
|
+
*
|
|
47
|
+
* @param value - The string which will be parsed.
|
|
48
|
+
* @param format - The format string or options.
|
|
49
|
+
* @return - The parsed number.
|
|
50
|
+
*/
|
|
51
|
+
parseNumber(value: string, format?: string | NumberFormatOptions): number;
|
|
52
|
+
/**
|
|
53
|
+
* Converts a string to a `Date` object based on the specified format.
|
|
54
|
+
*
|
|
55
|
+
* @param value - The string which will be converted.
|
|
56
|
+
* @param format - The format strings or options.
|
|
57
|
+
* @return - The parsed date.
|
|
58
|
+
*/
|
|
59
|
+
parseDate(value: string, format?: string | DateFormatOptions | string[] | DateFormatOptions[]): Date;
|
|
60
|
+
/**
|
|
61
|
+
* Converts a `Number` to a string based on the specified format.
|
|
62
|
+
*
|
|
63
|
+
* @param value - The number which will be formatted.
|
|
64
|
+
* @param format - The format string or options.
|
|
65
|
+
* @return - The formatted number.
|
|
66
|
+
*/
|
|
67
|
+
formatNumber(value: number, format: string | NumberFormatOptions): string;
|
|
68
|
+
/**
|
|
69
|
+
* Returns a localized date field name based on specific `dateFieldName` options.
|
|
70
|
+
*
|
|
71
|
+
* @param options - The detailed configuration for the desired date field name.
|
|
72
|
+
* @returns - The localized date field name from the current locale based on the option.
|
|
73
|
+
*/
|
|
74
|
+
dateFieldName(options: DateFieldNameOptions): string;
|
|
75
|
+
/**
|
|
76
|
+
* Returns the day names from the current locale based on the option.
|
|
77
|
+
*
|
|
78
|
+
* @param options - The detailed configuration for the desired date format.
|
|
79
|
+
* @return - The day names from the current locale based on the option.
|
|
80
|
+
*/
|
|
81
|
+
dateFormatNames(options: DateFormatNameOptions): any;
|
|
82
|
+
/**
|
|
83
|
+
* Splits the date format into objects which contain information about each part of the pattern.
|
|
84
|
+
*
|
|
85
|
+
* @param format - The format string or options.
|
|
86
|
+
* @returns - The date format parts.
|
|
87
|
+
*/
|
|
88
|
+
splitDateFormat(format: string | DateFormatOptions): DateFormatPart[];
|
|
89
|
+
/**
|
|
90
|
+
* Returns the number symbols from the current locale.
|
|
91
|
+
*
|
|
92
|
+
* @return - The number symbols from the current locale.
|
|
93
|
+
*/
|
|
94
|
+
numberSymbols(): any;
|
|
95
|
+
/**
|
|
96
|
+
* Returns the first day index, starting from Sunday.
|
|
97
|
+
*
|
|
98
|
+
* @return - The index of the first day of the week (0 == Sunday).
|
|
99
|
+
*/
|
|
100
|
+
firstDay(): number;
|
|
101
|
+
/**
|
|
102
|
+
* @hidden
|
|
103
|
+
*/
|
|
104
|
+
localeInfo(): any;
|
|
105
|
+
/**
|
|
106
|
+
* @hidden
|
|
107
|
+
*/
|
|
108
|
+
localeCurrency(): any;
|
|
109
|
+
}
|
package/Intl/load.d.ts
ADDED
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
*-------------------------------------------------------------------------------------------
|
|
4
|
+
* Copyright © 2026 Progress Software Corporation. All rights reserved.
|
|
5
|
+
* Licensed under commercial license. See LICENSE.md in the package root for more information
|
|
6
|
+
*-------------------------------------------------------------------------------------------
|
|
7
|
+
*/
|
|
8
|
+
/**
|
|
9
|
+
* @hidden Currently used only externally through the ServerGlobalization of the Grid.
|
|
10
|
+
*/
|
|
11
|
+
export declare const locales: {
|
|
12
|
+
[key: string]: Array<any>;
|
|
13
|
+
};
|
|
14
|
+
/**
|
|
15
|
+
* Loads CLDR data.
|
|
16
|
+
*
|
|
17
|
+
* @param data - The CLDR data to be loaded. Accepts multiple parameters.
|
|
18
|
+
*/
|
|
19
|
+
export declare const load: (...data: any[]) => void;
|
package/Intl/main.d.ts
ADDED
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
*-------------------------------------------------------------------------------------------
|
|
4
|
+
* Copyright © 2026 Progress Software Corporation. All rights reserved.
|
|
5
|
+
* Licensed under commercial license. See LICENSE.md in the package root for more information
|
|
6
|
+
*-------------------------------------------------------------------------------------------
|
|
7
|
+
*/
|
|
8
|
+
import { IntlProvider } from './IntlProvider.js';
|
|
9
|
+
import { IntlProviderProps } from './IntlProviderProps.js';
|
|
10
|
+
import { IntlService } from './IntlService.js';
|
|
11
|
+
import { load } from './load.js';
|
|
12
|
+
export { IntlProvider, IntlProviderProps, IntlService, load };
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
*-------------------------------------------------------------------------------------------
|
|
4
|
+
* Copyright © 2026 Progress Software Corporation. All rights reserved.
|
|
5
|
+
* Licensed under commercial license. See LICENSE.md in the package root for more information
|
|
6
|
+
*-------------------------------------------------------------------------------------------
|
|
7
|
+
*/
|
|
8
|
+
/**
|
|
9
|
+
* @hidden Currently used only externally through the ServerGlobalization of the Grid.
|
|
10
|
+
*/
|
|
11
|
+
export type LocalizationDataProviderProps = {
|
|
12
|
+
data: any[];
|
|
13
|
+
language: string;
|
|
14
|
+
children: React.ReactNode;
|
|
15
|
+
};
|
|
16
|
+
/**
|
|
17
|
+
* @hidden Currently used only externally through the ServerGlobalization of the Grid.
|
|
18
|
+
*/
|
|
19
|
+
export declare const LocalizationDataProvider: (props: LocalizationDataProviderProps) => import('react').ReactNode;
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
*-------------------------------------------------------------------------------------------
|
|
4
|
+
* Copyright © 2026 Progress Software Corporation. All rights reserved.
|
|
5
|
+
* Licensed under commercial license. See LICENSE.md in the package root for more information
|
|
6
|
+
*-------------------------------------------------------------------------------------------
|
|
7
|
+
*/
|
|
8
|
+
import { default as PropTypes } from 'prop-types';
|
|
9
|
+
import { LocalizationProviderProps } from './LocalizationProviderProps.js';
|
|
10
|
+
import { LocalizationService } from './LocalizationService.js';
|
|
11
|
+
import * as React from 'react';
|
|
12
|
+
/**
|
|
13
|
+
* A React component which provides a localization service. Expects a language string as a property of the component.
|
|
14
|
+
*/
|
|
15
|
+
export declare class LocalizationProvider extends React.Component<LocalizationProviderProps, {}> {
|
|
16
|
+
/**
|
|
17
|
+
* @hidden
|
|
18
|
+
*/
|
|
19
|
+
static propTypes: {
|
|
20
|
+
language: PropTypes.Requireable<string>;
|
|
21
|
+
};
|
|
22
|
+
/**
|
|
23
|
+
* Returns a localization service. The method is suitable for overriding when you implement custom localization behavior.
|
|
24
|
+
*/
|
|
25
|
+
getLocalizationService(): LocalizationService;
|
|
26
|
+
/**
|
|
27
|
+
* @hidden
|
|
28
|
+
*/
|
|
29
|
+
render(): React.JSX.Element;
|
|
30
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
*-------------------------------------------------------------------------------------------
|
|
4
|
+
* Copyright © 2026 Progress Software Corporation. All rights reserved.
|
|
5
|
+
* Licensed under commercial license. See LICENSE.md in the package root for more information
|
|
6
|
+
*-------------------------------------------------------------------------------------------
|
|
7
|
+
*/
|
|
8
|
+
/**
|
|
9
|
+
* Represents the props of the KendoReact LocalizationProvider component.
|
|
10
|
+
*/
|
|
11
|
+
export interface LocalizationProviderProps {
|
|
12
|
+
/**
|
|
13
|
+
* The language that will be used by the child components.
|
|
14
|
+
*/
|
|
15
|
+
language: string;
|
|
16
|
+
/**
|
|
17
|
+
* @hidden
|
|
18
|
+
*/
|
|
19
|
+
children?: React.ReactNode;
|
|
20
|
+
}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
*-------------------------------------------------------------------------------------------
|
|
4
|
+
* Copyright © 2026 Progress Software Corporation. All rights reserved.
|
|
5
|
+
* Licensed under commercial license. See LICENSE.md in the package root for more information
|
|
6
|
+
*-------------------------------------------------------------------------------------------
|
|
7
|
+
*/
|
|
8
|
+
/**
|
|
9
|
+
* A service which provides localization methods.
|
|
10
|
+
*/
|
|
11
|
+
export declare class LocalizationService {
|
|
12
|
+
/**
|
|
13
|
+
* The language code used for localization. When no string is available for this language, the default value is returned.
|
|
14
|
+
*/
|
|
15
|
+
language?: string;
|
|
16
|
+
/**
|
|
17
|
+
* Creates a new LocalizationService instance.
|
|
18
|
+
*
|
|
19
|
+
* @param language The language code for localization.
|
|
20
|
+
*/
|
|
21
|
+
constructor(language?: string);
|
|
22
|
+
/**
|
|
23
|
+
* 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.
|
|
24
|
+
*
|
|
25
|
+
* @param key - The key which identifies the string for the current language.
|
|
26
|
+
* @param defaultValue - The default value which will be returned when no string
|
|
27
|
+
* for the current language is available under the key.
|
|
28
|
+
* @return - The string for the current language.
|
|
29
|
+
*/
|
|
30
|
+
toLanguageString(key: string, defaultValue: string): string;
|
|
31
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
*-------------------------------------------------------------------------------------------
|
|
4
|
+
* Copyright © 2026 Progress Software Corporation. All rights reserved.
|
|
5
|
+
* Licensed under commercial license. See LICENSE.md in the package root for more information
|
|
6
|
+
*-------------------------------------------------------------------------------------------
|
|
7
|
+
*/
|
|
8
|
+
/**
|
|
9
|
+
* @hidden Currently used only externally through the ServerGlobalization of the Grid.
|
|
10
|
+
*/
|
|
11
|
+
export declare const languages: any;
|
|
12
|
+
/**
|
|
13
|
+
* Provides mechanism to load language-specific messages for the KendoReact components.
|
|
14
|
+
*
|
|
15
|
+
* @param messages - An iterable object which contains key-value pairs.
|
|
16
|
+
* @param languages - The language to which the messages are associated.
|
|
17
|
+
*/
|
|
18
|
+
export declare function loadMessages(messages: any, language: string): void;
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
*-------------------------------------------------------------------------------------------
|
|
4
|
+
* Copyright © 2026 Progress Software Corporation. All rights reserved.
|
|
5
|
+
* Licensed under commercial license. See LICENSE.md in the package root for more information
|
|
6
|
+
*-------------------------------------------------------------------------------------------
|
|
7
|
+
*/
|
|
8
|
+
import { loadMessages } from './loadMessages.js';
|
|
9
|
+
import { LocalizationProvider } from './LocalizationProvider.js';
|
|
10
|
+
import { LocalizationProviderProps } from './LocalizationProviderProps.js';
|
|
11
|
+
import { LocalizationService } from './LocalizationService.js';
|
|
12
|
+
export { loadMessages, LocalizationProvider, LocalizationProviderProps, LocalizationService };
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
*-------------------------------------------------------------------------------------------
|
|
4
|
+
* Copyright © 2026 Progress Software Corporation. All rights reserved.
|
|
5
|
+
* Licensed under commercial license. See LICENSE.md in the package root for more information
|
|
6
|
+
*-------------------------------------------------------------------------------------------
|
|
7
|
+
*/
|
|
8
|
+
/**
|
|
9
|
+
* @hidden
|
|
10
|
+
*/
|
|
11
|
+
export declare const messages: any;
|
package/coreExports.d.ts
ADDED
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
*-------------------------------------------------------------------------------------------
|
|
4
|
+
* Copyright © 2026 Progress Software Corporation. All rights reserved.
|
|
5
|
+
* Licensed under commercial license. See LICENSE.md in the package root for more information
|
|
6
|
+
*-------------------------------------------------------------------------------------------
|
|
7
|
+
*/
|
|
8
|
+
export type { DateFormatOptions, NumberFormatOptions, DateFieldNameOptions, DateFormatNameOptions, DateFormatPart } from '@progress/kendo-intl';
|
|
@@ -12,4 +12,4 @@
|
|
|
12
12
|
* Licensed under commercial license. See LICENSE.md in the package root for more information
|
|
13
13
|
*-------------------------------------------------------------------------------------------
|
|
14
14
|
*/
|
|
15
|
-
!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports,require("react"),require("@progress/kendo-intl"),require("prop-types"),require("@progress/kendo-react-common")):"function"==typeof define&&define.amd?define(["exports","react","@progress/kendo-intl","prop-types","@progress/kendo-react-common"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).KendoReactIntl={},e.React,e.KendoIntl,e.PropTypes,e.KendoReactCommon)}(this,
|
|
15
|
+
!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports,require("react"),require("@progress/kendo-intl"),require("prop-types"),require("@progress/kendo-react-common")):"function"==typeof define&&define.amd?define(["exports","react","@progress/kendo-intl","prop-types","@progress/kendo-react-common"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).KendoReactIntl={},e.React,e.KendoIntl,e.PropTypes,e.KendoReactCommon)}(this,function(e,t,n,o,r){"use strict";function a(e){var t=Object.create(null);return e&&Object.keys(e).forEach(function(n){if("default"!==n){var o=Object.getOwnPropertyDescriptor(e,n);Object.defineProperty(t,n,o.get?o:{enumerable:!0,get:function(){return e[n]}})}}),t.default=e,Object.freeze(t)}var l=a(t),i=a(n);let c=class{constructor(e){if(this.locale=e,""===e&&"production"!==process.env.NODE_ENV)throw"Locale should not be empty string"}format(e,...t){return 1===t.length&&Array.isArray(t[0])?i.format(e,t[0],this.locale):i.format(e,t,this.locale)}formatDate(e,t){return i.formatDate(e,t,this.locale)}toString(e,t){return i.toString(e,t,this.locale)}parseNumber(e,t){return i.parseNumber(e,this.locale,t)}parseDate(e,t){return i.parseDate(e,t,this.locale)}formatNumber(e,t){return i.formatNumber(e,t,this.locale)}dateFieldName(e){return i.dateFieldName(e,this.locale)}dateFormatNames(e){return i.dateFormatNames(this.locale,e)}splitDateFormat(e){return i.splitDateFormat(e,this.locale)}numberSymbols(){return i.numberSymbols(this.locale)}firstDay(){return i.firstDay(this.locale)}localeInfo(){return i.localeInfo(this.locale)}localeCurrency(){return i.localeCurrency(this.locale)}};const s=Object.create({});let u=class{constructor(e){if(this.language=e,""===e&&"production"!==process.env.NODE_ENV)throw"Language should not be an empty string"}toLanguageString(e,t){return this.language&&s[this.language]&&s[this.language].hasOwnProperty(e)?s[this.language][e]:t}};const p=l.createContext({intl:new c("en"),localization:new u});const d=class extends l.Component{getIntlService(){return new c(this.props.locale)}render(){return l.createElement(p.Consumer,null,e=>l.createElement(p.Provider,{value:{...e,intl:this.getIntlService()}},this.props.children))}};d.propTypes={locale:o.string};let m=d;const g={},f=(...e)=>{e.forEach(e=>{const t=Object.keys(e)[0];if(["main","supplemental"].includes(t)){const n=Object.keys(e[t])[0];n in g?g[n].includes(e)||(g[n]=[...g[n],e]):g[n]=[e]}}),n.load(...e)},h=e=>{const{locale:t,data:n,children:o}=e;return t&&f(n),o},y=class extends l.Component{getLocalizationService(){return new u(this.props.language)}render(){return l.createElement(p.Consumer,null,e=>l.createElement(p.Provider,{value:{...e,localization:this.getLocalizationService()}},this.props.children))}};y.propTypes={language:o.string};let v=y;const b=Object.create({}),E=(e,t,n)=>{for(const o in e)if(e.hasOwnProperty(o)){const r=[...n];if(r.push(o),"string"!=typeof e[o])E(e[o],t,r);else{const n=e[o];Object.defineProperty(t,r.join("."),{value:n,enumerable:!0})}}};function z(e,t){const n=s[t]=s[t]||{};b.lang=t,E(e,n,[])}const O=e=>{const{data:t,language:n,children:o}=e;return n&&z(t,n),o};e.GlobalizationContext=p,e.IntlProvider=m,e.IntlService=c,e.LocalizationProvider=v,e.LocalizationService=u,e.ServerGlobalization=e=>{var o,a,l;const{language:i="",locale:c="en",children:u}=e,p=n.localeInfo(c),d=null!=(o=s[i])?o:[],f=(null!=(a=g.version)?a:[]).concat(null!=(l=g[p.name])?l:[]),[y]=r.useCustomComponent(c?m:t.Fragment),[b]=r.useCustomComponent(i?v:t.Fragment);return t.createElement(O,{data:d,language:i},t.createElement(h,{data:f,locale:c},t.createElement(b,{language:i},t.createElement(y,{locale:c},u))))},e.load=f,e.loadMessages=z,e.localizationMessages=s,e.provideIntlService=function(e){if(!e&&"production"!==process.env.NODE_ENV)throw`Passed component - ${e} is invalid.`;const t=e.context;return t&&t.intl?t.intl:new c("en")},e.provideLocalizationService=function(e){if(!e&&"production"!==process.env.NODE_ENV)throw`Passed component - ${e} is invalid.`;const t=e.context;return t&&t.localization?t.localization:new u},e.registerForIntl=function(e){e.contextType=p},e.registerForLocalization=function(e){e.contextType=p},e.useInternationalization=()=>l.useContext(p).intl,e.useLocalization=()=>l.useContext(p).localization});
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
*-------------------------------------------------------------------------------------------
|
|
4
|
+
* Copyright © 2026 Progress Software Corporation. All rights reserved.
|
|
5
|
+
* Licensed under commercial license. See LICENSE.md in the package root for more information
|
|
6
|
+
*-------------------------------------------------------------------------------------------
|
|
7
|
+
*/
|
|
8
|
+
import { IntlService } from '../Intl/IntlService.js';
|
|
9
|
+
import { LocalizationService } from '../Localization/LocalizationService.js';
|
|
10
|
+
import * as React from 'react';
|
|
11
|
+
/** @hidden */
|
|
12
|
+
export type GlobalizationContextType = {
|
|
13
|
+
intl: IntlService;
|
|
14
|
+
localization: LocalizationService;
|
|
15
|
+
};
|
|
16
|
+
/** @hidden */
|
|
17
|
+
export declare const GlobalizationContext: React.Context<GlobalizationContextType>;
|
package/hooks/index.d.ts
ADDED
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
*-------------------------------------------------------------------------------------------
|
|
4
|
+
* Copyright © 2026 Progress Software Corporation. All rights reserved.
|
|
5
|
+
* Licensed under commercial license. See LICENSE.md in the package root for more information
|
|
6
|
+
*-------------------------------------------------------------------------------------------
|
|
7
|
+
*/
|
|
8
|
+
export * from './useInternationalization.js';
|
|
9
|
+
export * from './useLocalization.js';
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
*-------------------------------------------------------------------------------------------
|
|
4
|
+
* Copyright © 2026 Progress Software Corporation. All rights reserved.
|
|
5
|
+
* Licensed under commercial license. See LICENSE.md in the package root for more information
|
|
6
|
+
*-------------------------------------------------------------------------------------------
|
|
7
|
+
*/
|
|
8
|
+
import { IntlService } from '../Intl/main.js';
|
|
9
|
+
/**
|
|
10
|
+
* A custom [React Hook](https://react.dev/reference/react/hooks) providing access to an [IntlService](https://www.telerik.com/kendo-react-ui/components/intl/api/intlservice).
|
|
11
|
+
*/
|
|
12
|
+
export declare const useInternationalization: () => IntlService;
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
*-------------------------------------------------------------------------------------------
|
|
4
|
+
* Copyright © 2026 Progress Software Corporation. All rights reserved.
|
|
5
|
+
* Licensed under commercial license. See LICENSE.md in the package root for more information
|
|
6
|
+
*-------------------------------------------------------------------------------------------
|
|
7
|
+
*/
|
|
8
|
+
import { LocalizationService } from '../Localization/main.js';
|
|
9
|
+
/**
|
|
10
|
+
* A custom [React Hook](https://react.dev/reference/react/hooks) providing access to an [LocalizationService](https://www.telerik.com/kendo-react-ui/components/intl/api/localizationservice).
|
|
11
|
+
*/
|
|
12
|
+
export declare const useLocalization: () => LocalizationService;
|
package/index.d.mts
CHANGED
|
@@ -5,304 +5,11 @@
|
|
|
5
5
|
* Licensed under commercial license. See LICENSE.md in the package root for more information
|
|
6
6
|
*-------------------------------------------------------------------------------------------
|
|
7
7
|
*/
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
import * as React_2 from 'react';
|
|
17
|
-
|
|
18
|
-
export { DateFieldNameOptions }
|
|
19
|
-
|
|
20
|
-
export { DateFormatNameOptions }
|
|
21
|
-
|
|
22
|
-
export { DateFormatOptions }
|
|
23
|
-
|
|
24
|
-
export { DateFormatPart }
|
|
25
|
-
|
|
26
|
-
/** @hidden */
|
|
27
|
-
export declare const GlobalizationContext: React_2.Context<GlobalizationContextType>;
|
|
28
|
-
|
|
29
|
-
/** @hidden */
|
|
30
|
-
declare type GlobalizationContextType = {
|
|
31
|
-
intl: IntlService;
|
|
32
|
-
localization: LocalizationService;
|
|
33
|
-
};
|
|
34
|
-
|
|
35
|
-
/**
|
|
36
|
-
* A React component which provides an internationalization service. Expects a locale string as a property of the component.
|
|
37
|
-
*/
|
|
38
|
-
export declare class IntlProvider extends React_2.Component<IntlProviderProps, {}> {
|
|
39
|
-
/**
|
|
40
|
-
* @hidden
|
|
41
|
-
*/
|
|
42
|
-
static propTypes: {
|
|
43
|
-
locale: default_2.Requireable<string>;
|
|
44
|
-
};
|
|
45
|
-
/**
|
|
46
|
-
* Returns an internationalization service. The method is suitable for overriding when you implement custom internationalization behavior.
|
|
47
|
-
*/
|
|
48
|
-
getIntlService(): IntlService;
|
|
49
|
-
/**
|
|
50
|
-
* @hidden
|
|
51
|
-
*/
|
|
52
|
-
render(): JSX.Element;
|
|
53
|
-
}
|
|
54
|
-
|
|
55
|
-
/**
|
|
56
|
-
* Represents the props of the KendoReact IntlProvider component.
|
|
57
|
-
*/
|
|
58
|
-
export declare interface IntlProviderProps {
|
|
59
|
-
/**
|
|
60
|
-
* The locale that will be used by the child components.
|
|
61
|
-
*/
|
|
62
|
-
locale: string;
|
|
63
|
-
/**
|
|
64
|
-
* @hidden
|
|
65
|
-
*/
|
|
66
|
-
children?: React.ReactNode;
|
|
67
|
-
}
|
|
68
|
-
|
|
69
|
-
/**
|
|
70
|
-
* A service which provides internationalization methods and is bound to a specific locale.
|
|
71
|
-
*/
|
|
72
|
-
export declare class IntlService {
|
|
73
|
-
locale: string;
|
|
74
|
-
/**
|
|
75
|
-
* Creates a new instance of the internationalization service.
|
|
76
|
-
*
|
|
77
|
-
* @param locale - The locale that will be used by the internationalization methods.
|
|
78
|
-
*/
|
|
79
|
-
constructor(locale: string);
|
|
80
|
-
/**
|
|
81
|
-
* Formats a string with placeholders such as `Total amount {0:c}`.
|
|
82
|
-
*
|
|
83
|
-
* @param format - The format string.
|
|
84
|
-
* @param values - One or more values to output in the format string placeholders.
|
|
85
|
-
* @return - The formatted string.
|
|
86
|
-
*/
|
|
87
|
-
format(format: string, ...values: any[]): string;
|
|
88
|
-
/**
|
|
89
|
-
* Converts a `Date` object to a string based on the specified format. If no format is provided, the default short date format is used.
|
|
90
|
-
*
|
|
91
|
-
* @param value - The date which will be formatted.
|
|
92
|
-
* @param format - The format string or options.
|
|
93
|
-
* @return - The formatted date.
|
|
94
|
-
*/
|
|
95
|
-
formatDate(value: Date, format?: string | DateFormatOptions): string;
|
|
96
|
-
/**
|
|
97
|
-
* Converts an object to a string based on the specified format.
|
|
98
|
-
*
|
|
99
|
-
* @param value - The value which will be formatted.
|
|
100
|
-
* @param format - The format to use.
|
|
101
|
-
* @return - The formatted object.
|
|
102
|
-
*/
|
|
103
|
-
toString(value: any, format: string | any): string;
|
|
104
|
-
/**
|
|
105
|
-
* Converts a string to a `Number`.
|
|
106
|
-
*
|
|
107
|
-
* @param value - The string which will be parsed.
|
|
108
|
-
* @param format - The format string or options.
|
|
109
|
-
* @return - The parsed number.
|
|
110
|
-
*/
|
|
111
|
-
parseNumber(value: string, format?: string | NumberFormatOptions): number;
|
|
112
|
-
/**
|
|
113
|
-
* Converts a string to a `Date` object based on the specified format.
|
|
114
|
-
*
|
|
115
|
-
* @param value - The string which will be converted.
|
|
116
|
-
* @param format - The format strings or options.
|
|
117
|
-
* @return - The parsed date.
|
|
118
|
-
*/
|
|
119
|
-
parseDate(value: string, format?: string | DateFormatOptions | string[] | DateFormatOptions[]): Date;
|
|
120
|
-
/**
|
|
121
|
-
* Converts a `Number` to a string based on the specified format.
|
|
122
|
-
*
|
|
123
|
-
* @param value - The number which will be formatted.
|
|
124
|
-
* @param format - The format string or options.
|
|
125
|
-
* @return - The formatted number.
|
|
126
|
-
*/
|
|
127
|
-
formatNumber(value: number, format: string | NumberFormatOptions): string;
|
|
128
|
-
/**
|
|
129
|
-
* Returns a localized date field name based on specific `dateFieldName` options.
|
|
130
|
-
*
|
|
131
|
-
* @param options - The detailed configuration for the desired date field name.
|
|
132
|
-
* @returns - The localized date field name from the current locale based on the option.
|
|
133
|
-
*/
|
|
134
|
-
dateFieldName(options: DateFieldNameOptions): string;
|
|
135
|
-
/**
|
|
136
|
-
* Returns the day names from the current locale based on the option.
|
|
137
|
-
*
|
|
138
|
-
* @param options - The detailed configuration for the desired date format.
|
|
139
|
-
* @return - The day names from the current locale based on the option.
|
|
140
|
-
*/
|
|
141
|
-
dateFormatNames(options: DateFormatNameOptions): any;
|
|
142
|
-
/**
|
|
143
|
-
* Splits the date format into objects which contain information about each part of the pattern.
|
|
144
|
-
*
|
|
145
|
-
* @param format - The format string or options.
|
|
146
|
-
* @returns - The date format parts.
|
|
147
|
-
*/
|
|
148
|
-
splitDateFormat(format: string | DateFormatOptions): DateFormatPart[];
|
|
149
|
-
/**
|
|
150
|
-
* Returns the number symbols from the current locale.
|
|
151
|
-
*
|
|
152
|
-
* @return - The number symbols from the current locale.
|
|
153
|
-
*/
|
|
154
|
-
numberSymbols(): any;
|
|
155
|
-
/**
|
|
156
|
-
* Returns the first day index, starting from Sunday.
|
|
157
|
-
*
|
|
158
|
-
* @return - The index of the first day of the week (0 == Sunday).
|
|
159
|
-
*/
|
|
160
|
-
firstDay(): number;
|
|
161
|
-
/**
|
|
162
|
-
* @hidden
|
|
163
|
-
*/
|
|
164
|
-
localeInfo(): any;
|
|
165
|
-
/**
|
|
166
|
-
* @hidden
|
|
167
|
-
*/
|
|
168
|
-
localeCurrency(): any;
|
|
169
|
-
}
|
|
170
|
-
|
|
171
|
-
/**
|
|
172
|
-
* Loads CLDR data.
|
|
173
|
-
*
|
|
174
|
-
* @param data - The CLDR data to be loaded. Accepts multiple parameters.
|
|
175
|
-
*/
|
|
176
|
-
export declare const load: (...data: any[]) => void;
|
|
177
|
-
|
|
178
|
-
/**
|
|
179
|
-
* Provides mechanism to load language-specific messages for the KendoReact components.
|
|
180
|
-
*
|
|
181
|
-
* @param messages - An iterable object which contains key-value pairs.
|
|
182
|
-
* @param languages - The language to which the messages are associated.
|
|
183
|
-
*/
|
|
184
|
-
export declare function loadMessages(messages: any, language: string): void;
|
|
185
|
-
|
|
186
|
-
/**
|
|
187
|
-
* @hidden
|
|
188
|
-
*/
|
|
189
|
-
export declare const localizationMessages: any;
|
|
190
|
-
|
|
191
|
-
/**
|
|
192
|
-
* A React component which provides a localization service. Expects a language string as a property of the component.
|
|
193
|
-
*/
|
|
194
|
-
export declare class LocalizationProvider extends React_2.Component<LocalizationProviderProps, {}> {
|
|
195
|
-
/**
|
|
196
|
-
* @hidden
|
|
197
|
-
*/
|
|
198
|
-
static propTypes: {
|
|
199
|
-
language: default_2.Requireable<string>;
|
|
200
|
-
};
|
|
201
|
-
/**
|
|
202
|
-
* Returns a localization service. The method is suitable for overriding when you implement custom localization behavior.
|
|
203
|
-
*/
|
|
204
|
-
getLocalizationService(): LocalizationService;
|
|
205
|
-
/**
|
|
206
|
-
* @hidden
|
|
207
|
-
*/
|
|
208
|
-
render(): JSX.Element;
|
|
209
|
-
}
|
|
210
|
-
|
|
211
|
-
/**
|
|
212
|
-
* Represents the props of the KendoReact LocalizationProvider component.
|
|
213
|
-
*/
|
|
214
|
-
export declare interface LocalizationProviderProps {
|
|
215
|
-
/**
|
|
216
|
-
* The language that will be used by the child components.
|
|
217
|
-
*/
|
|
218
|
-
language: string;
|
|
219
|
-
/**
|
|
220
|
-
* @hidden
|
|
221
|
-
*/
|
|
222
|
-
children?: React.ReactNode;
|
|
223
|
-
}
|
|
224
|
-
|
|
225
|
-
/**
|
|
226
|
-
* A service which provides localization methods.
|
|
227
|
-
*/
|
|
228
|
-
export declare class LocalizationService {
|
|
229
|
-
/**
|
|
230
|
-
* The language code used for localization. When no string is available for this language, the default value is returned.
|
|
231
|
-
*/
|
|
232
|
-
language?: string;
|
|
233
|
-
/**
|
|
234
|
-
* Creates a new LocalizationService instance.
|
|
235
|
-
*
|
|
236
|
-
* @param language The language code for localization.
|
|
237
|
-
*/
|
|
238
|
-
constructor(language?: string);
|
|
239
|
-
/**
|
|
240
|
-
* 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.
|
|
241
|
-
*
|
|
242
|
-
* @param key - The key which identifies the string for the current language.
|
|
243
|
-
* @param defaultValue - The default value which will be returned when no string
|
|
244
|
-
* for the current language is available under the key.
|
|
245
|
-
* @return - The string for the current language.
|
|
246
|
-
*/
|
|
247
|
-
toLanguageString(key: string, defaultValue: string): string;
|
|
248
|
-
}
|
|
249
|
-
|
|
250
|
-
export { NumberFormatOptions }
|
|
251
|
-
|
|
252
|
-
/**
|
|
253
|
-
* 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`.
|
|
254
|
-
*
|
|
255
|
-
* @param componentClass - The React component class that will use the internationalization service.
|
|
256
|
-
*/
|
|
257
|
-
export declare function provideIntlService(component: React_2.Component): IntlService;
|
|
258
|
-
|
|
259
|
-
/**
|
|
260
|
-
* 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`.
|
|
261
|
-
*
|
|
262
|
-
* @param componentClass - The React component class that will use the internationalization service.
|
|
263
|
-
*/
|
|
264
|
-
export declare function provideLocalizationService(component: React_2.Component): LocalizationService;
|
|
265
|
-
|
|
266
|
-
/**
|
|
267
|
-
* A method which registers a component class or a functional stateless component for internationalization. When a component of that type is a direct or indirect child of `IntlProvider`, the locale of the provider is used. Otherwise, uses `en` as a default locale.
|
|
268
|
-
*
|
|
269
|
-
* @param component - The React component class that will use the internationalization methods.
|
|
270
|
-
*/
|
|
271
|
-
export declare function registerForIntl(component: React_2.ComponentClass<any, any>): void;
|
|
272
|
-
|
|
273
|
-
/**
|
|
274
|
-
* A method which registers a component class or a stateless functional component for localization. When a component of that type is a direct or indirect child of `LocalizationProvider`, the language of the provider is used.
|
|
275
|
-
*
|
|
276
|
-
* @param component - The React component class that will use the internationalization methods.
|
|
277
|
-
*/
|
|
278
|
-
export declare function registerForLocalization(component: React_2.ComponentClass<any, any>): void;
|
|
279
|
-
|
|
280
|
-
/**
|
|
281
|
-
* @hidden
|
|
282
|
-
* Assembles all necessary parts for both localization and internationalization to work in a server/client environments.
|
|
283
|
-
* Combined in a single `ServerGlobalization` component for convenience.
|
|
284
|
-
* From everything that has been loaded on the server, only pass what's necessary to the client, which is loaded on the client by the `DataProvider`s.
|
|
285
|
-
* This would result in minimal amount of data being transferred to the client.
|
|
286
|
-
*/
|
|
287
|
-
export declare const ServerGlobalization: (props: ServerGlobalizationProps) => JSX.Element;
|
|
288
|
-
|
|
289
|
-
/**
|
|
290
|
-
* @hidden Currently used only externally through the ServerGlobalization of the Grid.
|
|
291
|
-
*/
|
|
292
|
-
export declare type ServerGlobalizationProps = {
|
|
293
|
-
locale?: string;
|
|
294
|
-
language?: string;
|
|
295
|
-
children?: default_3.ReactNode;
|
|
296
|
-
};
|
|
297
|
-
|
|
298
|
-
/**
|
|
299
|
-
* A custom [React Hook](https://react.dev/reference/react/hooks) providing access to an [IntlService](https://www.telerik.com/kendo-react-ui/components/intl/api/intlservice).
|
|
300
|
-
*/
|
|
301
|
-
export declare const useInternationalization: () => IntlService;
|
|
302
|
-
|
|
303
|
-
/**
|
|
304
|
-
* A custom [React Hook](https://react.dev/reference/react/hooks) providing access to an [LocalizationService](https://www.telerik.com/kendo-react-ui/components/intl/api/localizationservice).
|
|
305
|
-
*/
|
|
306
|
-
export declare const useLocalization: () => LocalizationService;
|
|
307
|
-
|
|
308
|
-
export { }
|
|
8
|
+
export { GlobalizationContext } from './globalization/GlobalizationContext.js';
|
|
9
|
+
export { messages as localizationMessages } from './Localization/messages.js';
|
|
10
|
+
export * from './Intl/main.js';
|
|
11
|
+
export * from './Localization/main.js';
|
|
12
|
+
export * from './coreExports.js';
|
|
13
|
+
export * from './intlUtils.js';
|
|
14
|
+
export * from './hooks/index.js';
|
|
15
|
+
export * from './server/ServerGlobalization.js';
|
package/index.d.ts
CHANGED
|
@@ -5,304 +5,11 @@
|
|
|
5
5
|
* Licensed under commercial license. See LICENSE.md in the package root for more information
|
|
6
6
|
*-------------------------------------------------------------------------------------------
|
|
7
7
|
*/
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
import * as React_2 from 'react';
|
|
17
|
-
|
|
18
|
-
export { DateFieldNameOptions }
|
|
19
|
-
|
|
20
|
-
export { DateFormatNameOptions }
|
|
21
|
-
|
|
22
|
-
export { DateFormatOptions }
|
|
23
|
-
|
|
24
|
-
export { DateFormatPart }
|
|
25
|
-
|
|
26
|
-
/** @hidden */
|
|
27
|
-
export declare const GlobalizationContext: React_2.Context<GlobalizationContextType>;
|
|
28
|
-
|
|
29
|
-
/** @hidden */
|
|
30
|
-
declare type GlobalizationContextType = {
|
|
31
|
-
intl: IntlService;
|
|
32
|
-
localization: LocalizationService;
|
|
33
|
-
};
|
|
34
|
-
|
|
35
|
-
/**
|
|
36
|
-
* A React component which provides an internationalization service. Expects a locale string as a property of the component.
|
|
37
|
-
*/
|
|
38
|
-
export declare class IntlProvider extends React_2.Component<IntlProviderProps, {}> {
|
|
39
|
-
/**
|
|
40
|
-
* @hidden
|
|
41
|
-
*/
|
|
42
|
-
static propTypes: {
|
|
43
|
-
locale: default_2.Requireable<string>;
|
|
44
|
-
};
|
|
45
|
-
/**
|
|
46
|
-
* Returns an internationalization service. The method is suitable for overriding when you implement custom internationalization behavior.
|
|
47
|
-
*/
|
|
48
|
-
getIntlService(): IntlService;
|
|
49
|
-
/**
|
|
50
|
-
* @hidden
|
|
51
|
-
*/
|
|
52
|
-
render(): JSX.Element;
|
|
53
|
-
}
|
|
54
|
-
|
|
55
|
-
/**
|
|
56
|
-
* Represents the props of the KendoReact IntlProvider component.
|
|
57
|
-
*/
|
|
58
|
-
export declare interface IntlProviderProps {
|
|
59
|
-
/**
|
|
60
|
-
* The locale that will be used by the child components.
|
|
61
|
-
*/
|
|
62
|
-
locale: string;
|
|
63
|
-
/**
|
|
64
|
-
* @hidden
|
|
65
|
-
*/
|
|
66
|
-
children?: React.ReactNode;
|
|
67
|
-
}
|
|
68
|
-
|
|
69
|
-
/**
|
|
70
|
-
* A service which provides internationalization methods and is bound to a specific locale.
|
|
71
|
-
*/
|
|
72
|
-
export declare class IntlService {
|
|
73
|
-
locale: string;
|
|
74
|
-
/**
|
|
75
|
-
* Creates a new instance of the internationalization service.
|
|
76
|
-
*
|
|
77
|
-
* @param locale - The locale that will be used by the internationalization methods.
|
|
78
|
-
*/
|
|
79
|
-
constructor(locale: string);
|
|
80
|
-
/**
|
|
81
|
-
* Formats a string with placeholders such as `Total amount {0:c}`.
|
|
82
|
-
*
|
|
83
|
-
* @param format - The format string.
|
|
84
|
-
* @param values - One or more values to output in the format string placeholders.
|
|
85
|
-
* @return - The formatted string.
|
|
86
|
-
*/
|
|
87
|
-
format(format: string, ...values: any[]): string;
|
|
88
|
-
/**
|
|
89
|
-
* Converts a `Date` object to a string based on the specified format. If no format is provided, the default short date format is used.
|
|
90
|
-
*
|
|
91
|
-
* @param value - The date which will be formatted.
|
|
92
|
-
* @param format - The format string or options.
|
|
93
|
-
* @return - The formatted date.
|
|
94
|
-
*/
|
|
95
|
-
formatDate(value: Date, format?: string | DateFormatOptions): string;
|
|
96
|
-
/**
|
|
97
|
-
* Converts an object to a string based on the specified format.
|
|
98
|
-
*
|
|
99
|
-
* @param value - The value which will be formatted.
|
|
100
|
-
* @param format - The format to use.
|
|
101
|
-
* @return - The formatted object.
|
|
102
|
-
*/
|
|
103
|
-
toString(value: any, format: string | any): string;
|
|
104
|
-
/**
|
|
105
|
-
* Converts a string to a `Number`.
|
|
106
|
-
*
|
|
107
|
-
* @param value - The string which will be parsed.
|
|
108
|
-
* @param format - The format string or options.
|
|
109
|
-
* @return - The parsed number.
|
|
110
|
-
*/
|
|
111
|
-
parseNumber(value: string, format?: string | NumberFormatOptions): number;
|
|
112
|
-
/**
|
|
113
|
-
* Converts a string to a `Date` object based on the specified format.
|
|
114
|
-
*
|
|
115
|
-
* @param value - The string which will be converted.
|
|
116
|
-
* @param format - The format strings or options.
|
|
117
|
-
* @return - The parsed date.
|
|
118
|
-
*/
|
|
119
|
-
parseDate(value: string, format?: string | DateFormatOptions | string[] | DateFormatOptions[]): Date;
|
|
120
|
-
/**
|
|
121
|
-
* Converts a `Number` to a string based on the specified format.
|
|
122
|
-
*
|
|
123
|
-
* @param value - The number which will be formatted.
|
|
124
|
-
* @param format - The format string or options.
|
|
125
|
-
* @return - The formatted number.
|
|
126
|
-
*/
|
|
127
|
-
formatNumber(value: number, format: string | NumberFormatOptions): string;
|
|
128
|
-
/**
|
|
129
|
-
* Returns a localized date field name based on specific `dateFieldName` options.
|
|
130
|
-
*
|
|
131
|
-
* @param options - The detailed configuration for the desired date field name.
|
|
132
|
-
* @returns - The localized date field name from the current locale based on the option.
|
|
133
|
-
*/
|
|
134
|
-
dateFieldName(options: DateFieldNameOptions): string;
|
|
135
|
-
/**
|
|
136
|
-
* Returns the day names from the current locale based on the option.
|
|
137
|
-
*
|
|
138
|
-
* @param options - The detailed configuration for the desired date format.
|
|
139
|
-
* @return - The day names from the current locale based on the option.
|
|
140
|
-
*/
|
|
141
|
-
dateFormatNames(options: DateFormatNameOptions): any;
|
|
142
|
-
/**
|
|
143
|
-
* Splits the date format into objects which contain information about each part of the pattern.
|
|
144
|
-
*
|
|
145
|
-
* @param format - The format string or options.
|
|
146
|
-
* @returns - The date format parts.
|
|
147
|
-
*/
|
|
148
|
-
splitDateFormat(format: string | DateFormatOptions): DateFormatPart[];
|
|
149
|
-
/**
|
|
150
|
-
* Returns the number symbols from the current locale.
|
|
151
|
-
*
|
|
152
|
-
* @return - The number symbols from the current locale.
|
|
153
|
-
*/
|
|
154
|
-
numberSymbols(): any;
|
|
155
|
-
/**
|
|
156
|
-
* Returns the first day index, starting from Sunday.
|
|
157
|
-
*
|
|
158
|
-
* @return - The index of the first day of the week (0 == Sunday).
|
|
159
|
-
*/
|
|
160
|
-
firstDay(): number;
|
|
161
|
-
/**
|
|
162
|
-
* @hidden
|
|
163
|
-
*/
|
|
164
|
-
localeInfo(): any;
|
|
165
|
-
/**
|
|
166
|
-
* @hidden
|
|
167
|
-
*/
|
|
168
|
-
localeCurrency(): any;
|
|
169
|
-
}
|
|
170
|
-
|
|
171
|
-
/**
|
|
172
|
-
* Loads CLDR data.
|
|
173
|
-
*
|
|
174
|
-
* @param data - The CLDR data to be loaded. Accepts multiple parameters.
|
|
175
|
-
*/
|
|
176
|
-
export declare const load: (...data: any[]) => void;
|
|
177
|
-
|
|
178
|
-
/**
|
|
179
|
-
* Provides mechanism to load language-specific messages for the KendoReact components.
|
|
180
|
-
*
|
|
181
|
-
* @param messages - An iterable object which contains key-value pairs.
|
|
182
|
-
* @param languages - The language to which the messages are associated.
|
|
183
|
-
*/
|
|
184
|
-
export declare function loadMessages(messages: any, language: string): void;
|
|
185
|
-
|
|
186
|
-
/**
|
|
187
|
-
* @hidden
|
|
188
|
-
*/
|
|
189
|
-
export declare const localizationMessages: any;
|
|
190
|
-
|
|
191
|
-
/**
|
|
192
|
-
* A React component which provides a localization service. Expects a language string as a property of the component.
|
|
193
|
-
*/
|
|
194
|
-
export declare class LocalizationProvider extends React_2.Component<LocalizationProviderProps, {}> {
|
|
195
|
-
/**
|
|
196
|
-
* @hidden
|
|
197
|
-
*/
|
|
198
|
-
static propTypes: {
|
|
199
|
-
language: default_2.Requireable<string>;
|
|
200
|
-
};
|
|
201
|
-
/**
|
|
202
|
-
* Returns a localization service. The method is suitable for overriding when you implement custom localization behavior.
|
|
203
|
-
*/
|
|
204
|
-
getLocalizationService(): LocalizationService;
|
|
205
|
-
/**
|
|
206
|
-
* @hidden
|
|
207
|
-
*/
|
|
208
|
-
render(): JSX.Element;
|
|
209
|
-
}
|
|
210
|
-
|
|
211
|
-
/**
|
|
212
|
-
* Represents the props of the KendoReact LocalizationProvider component.
|
|
213
|
-
*/
|
|
214
|
-
export declare interface LocalizationProviderProps {
|
|
215
|
-
/**
|
|
216
|
-
* The language that will be used by the child components.
|
|
217
|
-
*/
|
|
218
|
-
language: string;
|
|
219
|
-
/**
|
|
220
|
-
* @hidden
|
|
221
|
-
*/
|
|
222
|
-
children?: React.ReactNode;
|
|
223
|
-
}
|
|
224
|
-
|
|
225
|
-
/**
|
|
226
|
-
* A service which provides localization methods.
|
|
227
|
-
*/
|
|
228
|
-
export declare class LocalizationService {
|
|
229
|
-
/**
|
|
230
|
-
* The language code used for localization. When no string is available for this language, the default value is returned.
|
|
231
|
-
*/
|
|
232
|
-
language?: string;
|
|
233
|
-
/**
|
|
234
|
-
* Creates a new LocalizationService instance.
|
|
235
|
-
*
|
|
236
|
-
* @param language The language code for localization.
|
|
237
|
-
*/
|
|
238
|
-
constructor(language?: string);
|
|
239
|
-
/**
|
|
240
|
-
* 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.
|
|
241
|
-
*
|
|
242
|
-
* @param key - The key which identifies the string for the current language.
|
|
243
|
-
* @param defaultValue - The default value which will be returned when no string
|
|
244
|
-
* for the current language is available under the key.
|
|
245
|
-
* @return - The string for the current language.
|
|
246
|
-
*/
|
|
247
|
-
toLanguageString(key: string, defaultValue: string): string;
|
|
248
|
-
}
|
|
249
|
-
|
|
250
|
-
export { NumberFormatOptions }
|
|
251
|
-
|
|
252
|
-
/**
|
|
253
|
-
* 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`.
|
|
254
|
-
*
|
|
255
|
-
* @param componentClass - The React component class that will use the internationalization service.
|
|
256
|
-
*/
|
|
257
|
-
export declare function provideIntlService(component: React_2.Component): IntlService;
|
|
258
|
-
|
|
259
|
-
/**
|
|
260
|
-
* 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`.
|
|
261
|
-
*
|
|
262
|
-
* @param componentClass - The React component class that will use the internationalization service.
|
|
263
|
-
*/
|
|
264
|
-
export declare function provideLocalizationService(component: React_2.Component): LocalizationService;
|
|
265
|
-
|
|
266
|
-
/**
|
|
267
|
-
* A method which registers a component class or a functional stateless component for internationalization. When a component of that type is a direct or indirect child of `IntlProvider`, the locale of the provider is used. Otherwise, uses `en` as a default locale.
|
|
268
|
-
*
|
|
269
|
-
* @param component - The React component class that will use the internationalization methods.
|
|
270
|
-
*/
|
|
271
|
-
export declare function registerForIntl(component: React_2.ComponentClass<any, any>): void;
|
|
272
|
-
|
|
273
|
-
/**
|
|
274
|
-
* A method which registers a component class or a stateless functional component for localization. When a component of that type is a direct or indirect child of `LocalizationProvider`, the language of the provider is used.
|
|
275
|
-
*
|
|
276
|
-
* @param component - The React component class that will use the internationalization methods.
|
|
277
|
-
*/
|
|
278
|
-
export declare function registerForLocalization(component: React_2.ComponentClass<any, any>): void;
|
|
279
|
-
|
|
280
|
-
/**
|
|
281
|
-
* @hidden
|
|
282
|
-
* Assembles all necessary parts for both localization and internationalization to work in a server/client environments.
|
|
283
|
-
* Combined in a single `ServerGlobalization` component for convenience.
|
|
284
|
-
* From everything that has been loaded on the server, only pass what's necessary to the client, which is loaded on the client by the `DataProvider`s.
|
|
285
|
-
* This would result in minimal amount of data being transferred to the client.
|
|
286
|
-
*/
|
|
287
|
-
export declare const ServerGlobalization: (props: ServerGlobalizationProps) => JSX.Element;
|
|
288
|
-
|
|
289
|
-
/**
|
|
290
|
-
* @hidden Currently used only externally through the ServerGlobalization of the Grid.
|
|
291
|
-
*/
|
|
292
|
-
export declare type ServerGlobalizationProps = {
|
|
293
|
-
locale?: string;
|
|
294
|
-
language?: string;
|
|
295
|
-
children?: default_3.ReactNode;
|
|
296
|
-
};
|
|
297
|
-
|
|
298
|
-
/**
|
|
299
|
-
* A custom [React Hook](https://react.dev/reference/react/hooks) providing access to an [IntlService](https://www.telerik.com/kendo-react-ui/components/intl/api/intlservice).
|
|
300
|
-
*/
|
|
301
|
-
export declare const useInternationalization: () => IntlService;
|
|
302
|
-
|
|
303
|
-
/**
|
|
304
|
-
* A custom [React Hook](https://react.dev/reference/react/hooks) providing access to an [LocalizationService](https://www.telerik.com/kendo-react-ui/components/intl/api/localizationservice).
|
|
305
|
-
*/
|
|
306
|
-
export declare const useLocalization: () => LocalizationService;
|
|
307
|
-
|
|
308
|
-
export { }
|
|
8
|
+
export { GlobalizationContext } from './globalization/GlobalizationContext.js';
|
|
9
|
+
export { messages as localizationMessages } from './Localization/messages.js';
|
|
10
|
+
export * from './Intl/main.js';
|
|
11
|
+
export * from './Localization/main.js';
|
|
12
|
+
export * from './coreExports.js';
|
|
13
|
+
export * from './intlUtils.js';
|
|
14
|
+
export * from './hooks/index.js';
|
|
15
|
+
export * from './server/ServerGlobalization.js';
|
package/intlUtils.d.ts
ADDED
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
*-------------------------------------------------------------------------------------------
|
|
4
|
+
* Copyright © 2026 Progress Software Corporation. All rights reserved.
|
|
5
|
+
* Licensed under commercial license. See LICENSE.md in the package root for more information
|
|
6
|
+
*-------------------------------------------------------------------------------------------
|
|
7
|
+
*/
|
|
8
|
+
import { IntlService } from './Intl/IntlService.js';
|
|
9
|
+
import { LocalizationService } from './Localization/LocalizationService.js';
|
|
10
|
+
import * as React from 'react';
|
|
11
|
+
/**
|
|
12
|
+
* 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`.
|
|
13
|
+
*
|
|
14
|
+
* @param componentClass - The React component class that will use the internationalization service.
|
|
15
|
+
*/
|
|
16
|
+
export declare function provideIntlService(component: React.Component): IntlService;
|
|
17
|
+
/**
|
|
18
|
+
* 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`.
|
|
19
|
+
*
|
|
20
|
+
* @param componentClass - The React component class that will use the internationalization service.
|
|
21
|
+
*/
|
|
22
|
+
export declare function provideLocalizationService(component: React.Component): LocalizationService;
|
|
23
|
+
/**
|
|
24
|
+
* A method which registers a component class or a functional stateless component for internationalization. When a component of that type is a direct or indirect child of `IntlProvider`, the locale of the provider is used. Otherwise, uses `en` as a default locale.
|
|
25
|
+
*
|
|
26
|
+
* @param component - The React component class that will use the internationalization methods.
|
|
27
|
+
*/
|
|
28
|
+
export declare function registerForIntl(component: React.ComponentClass<any, any>): void;
|
|
29
|
+
/**
|
|
30
|
+
* A method which registers a component class or a stateless functional component for localization. When a component of that type is a direct or indirect child of `LocalizationProvider`, the language of the provider is used.
|
|
31
|
+
*
|
|
32
|
+
* @param component - The React component class that will use the internationalization methods.
|
|
33
|
+
*/
|
|
34
|
+
export declare function registerForLocalization(component: React.ComponentClass<any, any>): void;
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
*-------------------------------------------------------------------------------------------
|
|
4
|
+
* Copyright © 2026 Progress Software Corporation. All rights reserved.
|
|
5
|
+
* Licensed under commercial license. See LICENSE.md in the package root for more information
|
|
6
|
+
*-------------------------------------------------------------------------------------------
|
|
7
|
+
*/
|
|
8
|
+
import { PackageMetadata } from '@progress/kendo-licensing';
|
|
9
|
+
/**
|
|
10
|
+
* @hidden
|
|
11
|
+
*/
|
|
12
|
+
export declare const packageMetadata: PackageMetadata;
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
// Generated file. DO NOT EDIT.
|
|
2
|
+
/**
|
|
3
|
+
* @hidden
|
|
4
|
+
*/
|
|
5
|
+
export const packageMetadata = Object.freeze({
|
|
6
|
+
name: '@progress/kendo-react-intl',
|
|
7
|
+
productName: 'KendoReact',
|
|
8
|
+
productCode: 'KENDOUIREACT',
|
|
9
|
+
productCodes: ['KENDOUIREACT'],
|
|
10
|
+
publishDate: 0,
|
|
11
|
+
version: '13.4.0-develop.2',
|
|
12
|
+
licensingDocsUrl: 'https://www.telerik.com/kendo-react-ui/components/my-license/'
|
|
13
|
+
});
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@progress/kendo-react-intl",
|
|
3
|
-
"version": "13.
|
|
3
|
+
"version": "13.4.0-develop.2",
|
|
4
4
|
"description": "React Internationalization package provides services for parsing and formatting of dates and numbers. KendoReact Internationalization package",
|
|
5
5
|
"author": "Progress",
|
|
6
6
|
"license": "SEE LICENSE IN LICENSE.md",
|
|
@@ -27,7 +27,7 @@
|
|
|
27
27
|
"peerDependencies": {
|
|
28
28
|
"@progress/kendo-intl": "^3.2.1",
|
|
29
29
|
"@progress/kendo-licensing": "^1.7.2",
|
|
30
|
-
"@progress/kendo-react-common": "13.
|
|
30
|
+
"@progress/kendo-react-common": "13.4.0-develop.2",
|
|
31
31
|
"react": "^16.8.2 || ^17.0.0 || ^18.0.0 || ^19.0.0 || ^19.0.0-rc",
|
|
32
32
|
"react-dom": "^16.8.2 || ^17.0.0 || ^18.0.0 || ^19.0.0 || ^19.0.0-rc"
|
|
33
33
|
},
|
|
@@ -50,7 +50,13 @@
|
|
|
50
50
|
],
|
|
51
51
|
"@progress": {
|
|
52
52
|
"friendlyName": "Internationalization",
|
|
53
|
-
"framework": "KendoReact"
|
|
53
|
+
"framework": "KendoReact",
|
|
54
|
+
"package": {
|
|
55
|
+
"productName": "KendoReact",
|
|
56
|
+
"productCode": "KENDOUIREACT",
|
|
57
|
+
"publishDate": 1770287765,
|
|
58
|
+
"licensingDocsUrl": "https://www.telerik.com/kendo-react-ui/components/my-license/"
|
|
59
|
+
}
|
|
54
60
|
},
|
|
55
61
|
"repository": {
|
|
56
62
|
"type": "git",
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
*-------------------------------------------------------------------------------------------
|
|
4
|
+
* Copyright © 2026 Progress Software Corporation. All rights reserved.
|
|
5
|
+
* Licensed under commercial license. See LICENSE.md in the package root for more information
|
|
6
|
+
*-------------------------------------------------------------------------------------------
|
|
7
|
+
*/
|
|
8
|
+
import { default as React } from 'react';
|
|
9
|
+
/**
|
|
10
|
+
* @hidden Currently used only externally through the ServerGlobalization of the Grid.
|
|
11
|
+
*/
|
|
12
|
+
export type ServerGlobalizationProps = {
|
|
13
|
+
locale?: string;
|
|
14
|
+
language?: string;
|
|
15
|
+
children?: React.ReactNode;
|
|
16
|
+
};
|
|
17
|
+
/**
|
|
18
|
+
* @hidden
|
|
19
|
+
* Assembles all necessary parts for both localization and internationalization to work in a server/client environments.
|
|
20
|
+
* Combined in a single `ServerGlobalization` component for convenience.
|
|
21
|
+
* From everything that has been loaded on the server, only pass what's necessary to the client, which is loaded on the client by the `DataProvider`s.
|
|
22
|
+
* This would result in minimal amount of data being transferred to the client.
|
|
23
|
+
*/
|
|
24
|
+
export declare const ServerGlobalization: (props: ServerGlobalizationProps) => React.JSX.Element;
|