i18n-json-react 0.0.0-stage → 0.1.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/LICENSE +21 -0
- package/README.md +401 -2
- package/bundlers/shared.cjs +92 -0
- package/dist/cjs/api-types.d.ts +17 -0
- package/dist/cjs/api-types.d.ts.map +1 -0
- package/dist/cjs/api-types.js +3 -0
- package/dist/cjs/api-types.js.map +1 -0
- package/dist/cjs/core.d.ts +10 -0
- package/dist/cjs/core.d.ts.map +1 -0
- package/dist/cjs/core.js +31 -0
- package/dist/cjs/core.js.map +1 -0
- package/dist/cjs/default-store.d.ts +7 -0
- package/dist/cjs/default-store.d.ts.map +1 -0
- package/dist/cjs/default-store.js +96 -0
- package/dist/cjs/default-store.js.map +1 -0
- package/dist/cjs/dictionaries.d.ts +7 -0
- package/dist/cjs/dictionaries.d.ts.map +1 -0
- package/dist/cjs/dictionaries.js +31 -0
- package/dist/cjs/dictionaries.js.map +1 -0
- package/dist/cjs/index.d.ts +24 -0
- package/dist/cjs/index.d.ts.map +1 -0
- package/dist/cjs/index.js +38 -0
- package/dist/cjs/index.js.map +1 -0
- package/dist/cjs/interpolation.d.ts +6 -0
- package/dist/cjs/interpolation.d.ts.map +1 -0
- package/dist/cjs/interpolation.js +26 -0
- package/dist/cjs/interpolation.js.map +1 -0
- package/dist/cjs/languages.d.ts +4 -0
- package/dist/cjs/languages.d.ts.map +1 -0
- package/dist/cjs/languages.js +61 -0
- package/dist/cjs/languages.js.map +1 -0
- package/dist/cjs/package.json +1 -0
- package/dist/cjs/react.d.ts +15 -0
- package/dist/cjs/react.d.ts.map +1 -0
- package/dist/cjs/react.js +54 -0
- package/dist/cjs/react.js.map +1 -0
- package/dist/cjs/resource.d.ts +8 -0
- package/dist/cjs/resource.d.ts.map +1 -0
- package/dist/cjs/resource.js +34 -0
- package/dist/cjs/resource.js.map +1 -0
- package/dist/cjs/store-types.d.ts +10 -0
- package/dist/cjs/store-types.d.ts.map +1 -0
- package/dist/cjs/store-types.js +17 -0
- package/dist/cjs/store-types.js.map +1 -0
- package/dist/cjs/store.d.ts +24 -0
- package/dist/cjs/store.d.ts.map +1 -0
- package/dist/cjs/store.js +139 -0
- package/dist/cjs/store.js.map +1 -0
- package/dist/cjs/typed-react.d.ts +5 -0
- package/dist/cjs/typed-react.d.ts.map +1 -0
- package/dist/cjs/typed-react.js +23 -0
- package/dist/cjs/typed-react.js.map +1 -0
- package/dist/cjs/types.d.ts +91 -0
- package/dist/cjs/types.d.ts.map +1 -0
- package/dist/cjs/types.js +3 -0
- package/dist/cjs/types.js.map +1 -0
- package/dist/esm/api-types.d.ts +17 -0
- package/dist/esm/api-types.d.ts.map +1 -0
- package/dist/esm/api-types.js +2 -0
- package/dist/esm/api-types.js.map +1 -0
- package/dist/esm/core.d.ts +10 -0
- package/dist/esm/core.d.ts.map +1 -0
- package/dist/esm/core.js +25 -0
- package/dist/esm/core.js.map +1 -0
- package/dist/esm/default-store.d.ts +7 -0
- package/dist/esm/default-store.d.ts.map +1 -0
- package/dist/esm/default-store.js +93 -0
- package/dist/esm/default-store.js.map +1 -0
- package/dist/esm/dictionaries.d.ts +7 -0
- package/dist/esm/dictionaries.d.ts.map +1 -0
- package/dist/esm/dictionaries.js +26 -0
- package/dist/esm/dictionaries.js.map +1 -0
- package/dist/esm/index.d.ts +24 -0
- package/dist/esm/index.d.ts.map +1 -0
- package/dist/esm/index.js +31 -0
- package/dist/esm/index.js.map +1 -0
- package/dist/esm/interpolation.d.ts +6 -0
- package/dist/esm/interpolation.d.ts.map +1 -0
- package/dist/esm/interpolation.js +22 -0
- package/dist/esm/interpolation.js.map +1 -0
- package/dist/esm/languages.d.ts +4 -0
- package/dist/esm/languages.d.ts.map +1 -0
- package/dist/esm/languages.js +57 -0
- package/dist/esm/languages.js.map +1 -0
- package/dist/esm/package.json +1 -0
- package/dist/esm/react.d.ts +15 -0
- package/dist/esm/react.d.ts.map +1 -0
- package/dist/esm/react.js +51 -0
- package/dist/esm/react.js.map +1 -0
- package/dist/esm/resource.d.ts +8 -0
- package/dist/esm/resource.d.ts.map +1 -0
- package/dist/esm/resource.js +31 -0
- package/dist/esm/resource.js.map +1 -0
- package/dist/esm/store-types.d.ts +10 -0
- package/dist/esm/store-types.d.ts.map +1 -0
- package/dist/esm/store-types.js +14 -0
- package/dist/esm/store-types.js.map +1 -0
- package/dist/esm/store.d.ts +24 -0
- package/dist/esm/store.d.ts.map +1 -0
- package/dist/esm/store.js +136 -0
- package/dist/esm/store.js.map +1 -0
- package/dist/esm/typed-react.d.ts +5 -0
- package/dist/esm/typed-react.d.ts.map +1 -0
- package/dist/esm/typed-react.js +20 -0
- package/dist/esm/typed-react.js.map +1 -0
- package/dist/esm/types.d.ts +91 -0
- package/dist/esm/types.d.ts.map +1 -0
- package/dist/esm/types.js +2 -0
- package/dist/esm/types.js.map +1 -0
- package/dist/types/registry.d.cts +10 -0
- package/native/README.md +179 -0
- package/native/android/README.md +14 -0
- package/native/android/cli.cjs +2 -0
- package/native/android/expo.cjs +1 -0
- package/native/android/expo.d.cts +1 -0
- package/native/android/index.cjs +3 -0
- package/native/android/index.d.cts +5 -0
- package/native/android/metro.cjs +3 -0
- package/native/android/metro.d.cts +7 -0
- package/native/android/prepare.cjs +3 -0
- package/native/cli.cjs +43 -0
- package/native/expo.cjs +17 -0
- package/native/expo.d.cts +7 -0
- package/native/index.cjs +18 -0
- package/native/index.d.cts +14 -0
- package/native/ios/README.md +58 -0
- package/native/ios/cli.cjs +2 -0
- package/native/ios/expo.cjs +1 -0
- package/native/ios/expo.d.cts +1 -0
- package/native/ios/index.cjs +3 -0
- package/native/ios/index.d.cts +5 -0
- package/native/ios/metro.cjs +3 -0
- package/native/ios/metro.d.cts +7 -0
- package/native/ios/prepare.cjs +3 -0
- package/native/metro.cjs +45 -0
- package/native/metro.d.cts +34 -0
- package/native/prepare.cjs +120 -0
- package/package.json +165 -4
- package/src/api-types.ts +42 -0
- package/src/core.ts +29 -0
- package/src/default-store.ts +106 -0
- package/src/dictionaries.ts +31 -0
- package/src/index.ts +46 -0
- package/src/interpolation.ts +31 -0
- package/src/languages.ts +62 -0
- package/src/react.ts +83 -0
- package/src/resource.ts +40 -0
- package/src/store-types.ts +36 -0
- package/src/store.ts +150 -0
- package/src/typed-react.ts +33 -0
- package/src/types.ts +113 -0
- package/types/registry.d.cts +10 -0
- package/vite/index.cjs +145 -0
- package/vite/index.d.cts +15 -0
- package/webpack/index.cjs +46 -0
- package/webpack/index.d.cts +22 -0
- package/webpack/loader.cjs +21 -0
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
const DEFAULT_DELIMITERS = { prefix: '{', suffix: '}' };
|
|
2
|
+
const interpolateDefault = createInterpolator();
|
|
3
|
+
/** Replaces interpolation parameters using literal delimiters; defaults to {name}. */
|
|
4
|
+
export function interpolateTypo(template, values, delimiters) {
|
|
5
|
+
const interpolate = delimiters === undefined ? interpolateDefault : createInterpolator(delimiters);
|
|
6
|
+
return interpolate(template, values);
|
|
7
|
+
}
|
|
8
|
+
/** Compiles once per instance so translators do not create regular expressions on each call. */
|
|
9
|
+
export function createInterpolator({ prefix, suffix } = DEFAULT_DELIMITERS) {
|
|
10
|
+
if (typeof prefix !== 'string' || !prefix || typeof suffix !== 'string' || !suffix) {
|
|
11
|
+
throw new TypeError('Interpolation prefix and suffix must be nonempty strings');
|
|
12
|
+
}
|
|
13
|
+
const pattern = new RegExp(`${escapeRegExp(prefix)}([\\w.-]+?)${escapeRegExp(suffix)}`, 'g');
|
|
14
|
+
return (template, values) => template.replace(pattern, (_, key) => {
|
|
15
|
+
const value = Object.hasOwn(values, key) ? values[key] : undefined;
|
|
16
|
+
return value == null ? '' : String(value);
|
|
17
|
+
});
|
|
18
|
+
}
|
|
19
|
+
function escapeRegExp(value) {
|
|
20
|
+
return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
|
|
21
|
+
}
|
|
22
|
+
//# sourceMappingURL=interpolation.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"interpolation.js","sourceRoot":"","sources":["../../src/interpolation.ts"],"names":[],"mappings":"AAEA,MAAM,kBAAkB,GAA4B,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;AACjF,MAAM,kBAAkB,GAAG,kBAAkB,EAAE,CAAC;AAEhD,sFAAsF;AACtF,MAAM,UAAU,eAAe,CAC7B,QAAgB,EAChB,MAA2B,EAC3B,UAAoC;IAEpC,MAAM,WAAW,GAAG,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACnG,OAAO,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,kBAAkB,CAAC,EAAE,MAAM,EAAE,MAAM,KAA8B,kBAAkB;IACjG,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QACnF,MAAM,IAAI,SAAS,CAAC,0DAA0D,CAAC,CAAC;IAClF,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,cAAc,YAAY,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAC7F,OAAO,CAAC,QAAgB,EAAE,MAA2B,EAAU,EAAE,CAC/D,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,GAAW,EAAE,EAAE;QAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACnE,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { I18nOptions, StorageAdapter } from './types.js';
|
|
2
|
+
export declare function createLanguageResolver<L extends string>(languages: readonly L[]): (tag: string) => L | undefined;
|
|
3
|
+
export declare function detectLanguage<L extends string>(options: I18nOptions<L>, resolve: (tag: string) => L | undefined, getStorage: () => StorageAdapter | undefined, onError: (error: unknown) => void): L;
|
|
4
|
+
//# sourceMappingURL=languages.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"languages.d.ts","sourceRoot":"","sources":["../../src/languages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE9D,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,IAWtE,KAAK,MAAM,KAAG,CAAC,GAAG,SAAS,CAYpC;AAED,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAC7C,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EACvB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,GAAG,SAAS,EACvC,UAAU,EAAE,MAAM,cAAc,GAAG,SAAS,EAC5C,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAChC,CAAC,CAyBH"}
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
export function createLanguageResolver(languages) {
|
|
2
|
+
const normalized = new Map();
|
|
3
|
+
for (const language of languages) {
|
|
4
|
+
if (!/^[a-zA-Z]{2,8}(?:[-_][a-zA-Z0-9]{1,8})*$/.test(language)) {
|
|
5
|
+
throw new Error(`Invalid language identifier: ${language}`);
|
|
6
|
+
}
|
|
7
|
+
const tag = normalize(language);
|
|
8
|
+
if (normalized.has(tag))
|
|
9
|
+
throw new Error(`Duplicate language identifier: ${language}`);
|
|
10
|
+
normalized.set(tag, language);
|
|
11
|
+
}
|
|
12
|
+
return (tag) => {
|
|
13
|
+
let candidate = normalize(tag);
|
|
14
|
+
// Prefer an exact regional/script match, then progressively less specific tags.
|
|
15
|
+
while (candidate) {
|
|
16
|
+
const match = normalized.get(candidate);
|
|
17
|
+
if (match !== undefined)
|
|
18
|
+
return match;
|
|
19
|
+
const separator = candidate.lastIndexOf('-');
|
|
20
|
+
if (separator === -1)
|
|
21
|
+
break;
|
|
22
|
+
candidate = candidate.slice(0, separator);
|
|
23
|
+
}
|
|
24
|
+
return undefined;
|
|
25
|
+
};
|
|
26
|
+
}
|
|
27
|
+
export function detectLanguage(options, resolve, getStorage, onError) {
|
|
28
|
+
if (options.initialLanguage !== undefined)
|
|
29
|
+
return options.initialLanguage;
|
|
30
|
+
try {
|
|
31
|
+
const stored = getStorage()?.getItem(options.storageKey ?? 'i18n-language');
|
|
32
|
+
const language = stored ? resolve(stored) : undefined;
|
|
33
|
+
if (language !== undefined)
|
|
34
|
+
return language;
|
|
35
|
+
}
|
|
36
|
+
catch (error) {
|
|
37
|
+
onError(error);
|
|
38
|
+
}
|
|
39
|
+
const browserLanguages = options.getBrowserLanguages?.() ??
|
|
40
|
+
(typeof navigator === 'undefined'
|
|
41
|
+
? []
|
|
42
|
+
: navigator.languages?.length
|
|
43
|
+
? navigator.languages
|
|
44
|
+
: navigator.language
|
|
45
|
+
? [navigator.language]
|
|
46
|
+
: []);
|
|
47
|
+
for (const tag of browserLanguages) {
|
|
48
|
+
const language = resolve(tag);
|
|
49
|
+
if (language !== undefined)
|
|
50
|
+
return language;
|
|
51
|
+
}
|
|
52
|
+
return options.fallbackLanguage;
|
|
53
|
+
}
|
|
54
|
+
function normalize(tag) {
|
|
55
|
+
return tag.trim().replaceAll('_', '-').toLowerCase();
|
|
56
|
+
}
|
|
57
|
+
//# sourceMappingURL=languages.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"languages.js","sourceRoot":"","sources":["../../src/languages.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,sBAAsB,CAAmB,SAAuB;IAC9E,MAAM,UAAU,GAAG,IAAI,GAAG,EAAa,CAAC;IACxC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,0CAA0C,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/D,MAAM,IAAI,KAAK,CAAC,gCAAgC,QAAQ,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;QAChC,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,QAAQ,EAAE,CAAC,CAAC;QACvF,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,CAAC,GAAW,EAAiB,EAAE;QACpC,IAAI,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC/B,gFAAgF;QAChF,OAAO,SAAS,EAAE,CAAC;YACjB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACxC,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAC;YACtC,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YAC7C,IAAI,SAAS,KAAK,CAAC,CAAC;gBAAE,MAAM;YAC5B,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,OAAuB,EACvB,OAAuC,EACvC,UAA4C,EAC5C,OAAiC;IAEjC,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,eAAe,CAAC;IAE1E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,UAAU,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,UAAU,IAAI,eAAe,CAAC,CAAC;QAC5E,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACtD,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IAED,MAAM,gBAAgB,GACpB,OAAO,CAAC,mBAAmB,EAAE,EAAE;QAC/B,CAAC,OAAO,SAAS,KAAK,WAAW;YAC/B,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM;gBAC3B,CAAC,CAAC,SAAS,CAAC,SAAS;gBACrB,CAAC,CAAC,SAAS,CAAC,QAAQ;oBAClB,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC;oBACtB,CAAC,CAAC,EAAE,CAAC,CAAC;IACd,KAAK,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC;IAC9C,CAAC;IACD,OAAO,OAAO,CAAC,gBAAgB,CAAC;AAClC,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;AACvD,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"type":"module"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import type { NamedExoticComponent } from 'react';
|
|
2
|
+
import type { I18nStore } from './store.js';
|
|
3
|
+
import type { DictionaryInput, DictionaryKeys, RemovePrefix, TypoHook, TypoProps } from './types.js';
|
|
4
|
+
/** Shared bindings for isolated instances and the configurable default instance. */
|
|
5
|
+
export declare function createReactBindings<L extends string>(store: I18nStore<L>): {
|
|
6
|
+
useI18nLanguage: () => L;
|
|
7
|
+
createUseTypo: <const D extends DictionaryInput>(info: D) => TypoHook<DictionaryKeys<D>>;
|
|
8
|
+
createTypo: {
|
|
9
|
+
<const D extends DictionaryInput>(info: D): NamedExoticComponent<TypoProps<DictionaryKeys<D>>>;
|
|
10
|
+
<const D extends DictionaryInput, P extends string>(info: D, prefix: P): NamedExoticComponent<TypoProps<RemovePrefix<DictionaryKeys<D>, P>>>;
|
|
11
|
+
};
|
|
12
|
+
useTypoAsObject: <const D extends DictionaryInput>(info: D) => Record<DictionaryKeys<D>, string | undefined>;
|
|
13
|
+
LoaderForI18N: import("react").MemoExoticComponent<() => null>;
|
|
14
|
+
};
|
|
15
|
+
//# sourceMappingURL=react.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../src/react.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EAEd,YAAY,EAEZ,QAAQ,EAER,SAAS,EACV,MAAM,YAAY,CAAC;AAEpB,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;;0BAkB1C,CAAC,SAAS,eAAe,QAAQ,CAAC,KAAG,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;;eAmBnE,CAAC,SAAS,eAAe,QAAQ,CAAC,GAAG,oBAAoB,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;eACvF,CAAC,SAAS,eAAe,EAAE,CAAC,SAAS,MAAM,QAC7D,CAAC,UACC,CAAC,GACR,oBAAoB,CAAC,SAAS,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;;4BAUvC,CAAC,SAAS,eAAe,QAAQ,CAAC,KAAG,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;;EAalH"}
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
'use client';
|
|
2
|
+
import { memo, useCallback, useMemo, useSyncExternalStore } from 'react';
|
|
3
|
+
import { isReference } from './dictionaries.js';
|
|
4
|
+
/** Shared bindings for isolated instances and the configurable default instance. */
|
|
5
|
+
export function createReactBindings(store) {
|
|
6
|
+
function useI18nLanguage() {
|
|
7
|
+
return useSyncExternalStore(store.subscribe, store.getCurrentLang, store.getServerLanguage);
|
|
8
|
+
}
|
|
9
|
+
function useDictionaryLanguage(info) {
|
|
10
|
+
const language = useI18nLanguage();
|
|
11
|
+
// A language file can finish loading without the language itself changing.
|
|
12
|
+
const revision = useSyncExternalStore(store.subscribe, store.getSnapshot, store.getServerSnapshot);
|
|
13
|
+
if (isReference(info))
|
|
14
|
+
store.readLanguage(language);
|
|
15
|
+
return { language, revision };
|
|
16
|
+
}
|
|
17
|
+
function useGetText(info, placehold = true) {
|
|
18
|
+
const { language, revision } = useDictionaryLanguage(info);
|
|
19
|
+
return useMemo(() => store.createTypoGetter(info, { language, placehold }), [info, language, placehold, revision]);
|
|
20
|
+
}
|
|
21
|
+
function createUseTypo(info) {
|
|
22
|
+
function useTypo(hookOptions) {
|
|
23
|
+
const getText = useGetText(info, hookOptions?.placehold ?? true);
|
|
24
|
+
const prefix = hookOptions?.keyPrefix ?? '';
|
|
25
|
+
const translate = useCallback((key, values) => {
|
|
26
|
+
return getText(`${prefix}${key}`, values);
|
|
27
|
+
}, [getText, prefix]);
|
|
28
|
+
return useMemo(() => Object.assign(translate, { t: translate }), [translate]);
|
|
29
|
+
}
|
|
30
|
+
return useTypo;
|
|
31
|
+
}
|
|
32
|
+
function createTypo(info, prefix) {
|
|
33
|
+
const Component = memo(({ id, values }) => {
|
|
34
|
+
const getText = useGetText(info);
|
|
35
|
+
return getText(`${prefix ?? ''}${id}`, values);
|
|
36
|
+
});
|
|
37
|
+
Component.displayName = 'Typo';
|
|
38
|
+
return Component;
|
|
39
|
+
}
|
|
40
|
+
function useTypoAsObject(info) {
|
|
41
|
+
const { language, revision } = useDictionaryLanguage(info);
|
|
42
|
+
return useMemo(() => store.getTypoAsObject(info, language), [info, language, revision]);
|
|
43
|
+
}
|
|
44
|
+
const LoaderForI18N = memo(function LoaderForI18N() {
|
|
45
|
+
useSyncExternalStore(store.subscribe, store.getSnapshot, store.getServerSnapshot);
|
|
46
|
+
store.readLanguage(useI18nLanguage());
|
|
47
|
+
return null;
|
|
48
|
+
});
|
|
49
|
+
return { useI18nLanguage, createUseTypo, createTypo, useTypoAsObject, LoaderForI18N };
|
|
50
|
+
}
|
|
51
|
+
//# sourceMappingURL=react.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"react.js","sourceRoot":"","sources":["../../src/react.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
/** A small Suspense resource: deduplicates a request and retains its result or error. */
|
|
2
|
+
export interface AsyncResource<T> {
|
|
3
|
+
promise: Promise<T>;
|
|
4
|
+
read(): T;
|
|
5
|
+
isRejected(): boolean;
|
|
6
|
+
}
|
|
7
|
+
export declare function createAsyncResource<T>(load: () => Promise<T>): AsyncResource<T>;
|
|
8
|
+
//# sourceMappingURL=resource.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../src/resource.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,IAAI,CAAC,CAAC;IACV,UAAU,IAAI,OAAO,CAAC;CACvB;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAgC/E"}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
export function createAsyncResource(load) {
|
|
2
|
+
let status = 'pending';
|
|
3
|
+
let result;
|
|
4
|
+
let failure;
|
|
5
|
+
const promise = Promise.resolve()
|
|
6
|
+
.then(load)
|
|
7
|
+
.then(value => {
|
|
8
|
+
result = value;
|
|
9
|
+
status = 'fulfilled';
|
|
10
|
+
return value;
|
|
11
|
+
}, error => {
|
|
12
|
+
failure = error;
|
|
13
|
+
status = 'rejected';
|
|
14
|
+
throw error;
|
|
15
|
+
});
|
|
16
|
+
// React owns suspended promises, but an imperative prefetch may have no reader yet.
|
|
17
|
+
// Handle the rejection on a separate branch; the public promise still rejects.
|
|
18
|
+
void promise.catch(error => error);
|
|
19
|
+
return {
|
|
20
|
+
promise,
|
|
21
|
+
read() {
|
|
22
|
+
if (status === 'pending')
|
|
23
|
+
throw promise;
|
|
24
|
+
if (status === 'rejected')
|
|
25
|
+
throw failure;
|
|
26
|
+
return result;
|
|
27
|
+
},
|
|
28
|
+
isRejected: () => status === 'rejected',
|
|
29
|
+
};
|
|
30
|
+
}
|
|
31
|
+
//# sourceMappingURL=resource.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../src/resource.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,mBAAmB,CAAI,IAAsB;IAC3D,IAAI,MAAM,GAAyC,SAAS,CAAC;IAC7D,IAAI,MAAS,CAAC;IACd,IAAI,OAAgB,CAAC;IACrB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE;SAC9B,IAAI,CAAC,IAAI,CAAC;SACV,IAAI,CACH,KAAK,CAAC,EAAE;QACN,MAAM,GAAG,KAAK,CAAC;QACf,MAAM,GAAG,WAAW,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC,EACD,KAAK,CAAC,EAAE;QACN,OAAO,GAAG,KAAK,CAAC;QAChB,MAAM,GAAG,UAAU,CAAC;QACpB,MAAM,KAAK,CAAC;IACd,CAAC,CACF,CAAC;IAEJ,oFAAoF;IACpF,+EAA+E;IAC/E,KAAK,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IAEnC,OAAO;QACL,OAAO;QACP,IAAI;YACF,IAAI,MAAM,KAAK,SAAS;gBAAE,MAAM,OAAO,CAAC;YACxC,IAAI,MAAM,KAAK,UAAU;gBAAE,MAAM,OAAO,CAAC;YACzC,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM,KAAK,UAAU;KACxC,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { I18nStore as Store } from './store.js';
|
|
2
|
+
import type { CheckedDictionary, DictionaryInput, DictionaryKeys, GetterOptions, InterpolationValues } from './types.js';
|
|
3
|
+
export interface DictionaryGetters<L extends string, F extends string = never> {
|
|
4
|
+
createTypoGetter<const D extends DictionaryInput>(info: CheckedDictionary<D, L, F>, options?: GetterOptions<L>): (key: DictionaryKeys<D>, values?: InterpolationValues) => string;
|
|
5
|
+
getTypoAsObject<const D extends DictionaryInput>(info: CheckedDictionary<D, L, F>, language?: L): Record<DictionaryKeys<D>, string | undefined>;
|
|
6
|
+
}
|
|
7
|
+
export type I18nStore<L extends string, F extends string = never> = Omit<Store<L>, keyof DictionaryGetters<L, F>> & DictionaryGetters<L, F>;
|
|
8
|
+
/** Keep the original inferred dictionary when forwarding a checked argument to the store. */
|
|
9
|
+
export declare function withDictionaryTypes<L extends string, F extends string = never>(store: Store<L>): I18nStore<L, F>;
|
|
10
|
+
//# sourceMappingURL=store-types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"store-types.d.ts","sourceRoot":"","sources":["../../src/store-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,IAAI,KAAK,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,aAAa,EACb,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,KAAK;IAC3E,gBAAgB,CAAC,KAAK,CAAC,CAAC,SAAS,eAAe,EAC9C,IAAI,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAChC,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GACzB,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,mBAAmB,KAAK,MAAM,CAAC;IACpE,eAAe,CAAC,KAAK,CAAC,CAAC,SAAS,eAAe,EAC7C,IAAI,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAChC,QAAQ,CAAC,EAAE,CAAC,GACX,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAClD;AAED,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAC/G,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAE1B,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAWhH"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
/** Keep the original inferred dictionary when forwarding a checked argument to the store. */
|
|
2
|
+
export function withDictionaryTypes(store) {
|
|
3
|
+
const { createTypoGetter, getTypoAsObject } = store;
|
|
4
|
+
const methods = {
|
|
5
|
+
createTypoGetter(info, options) {
|
|
6
|
+
return createTypoGetter(info, options);
|
|
7
|
+
},
|
|
8
|
+
getTypoAsObject(info, language) {
|
|
9
|
+
return getTypoAsObject(info, language);
|
|
10
|
+
},
|
|
11
|
+
};
|
|
12
|
+
return Object.assign(store, methods);
|
|
13
|
+
}
|
|
14
|
+
//# sourceMappingURL=store-types.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"store-types.js","sourceRoot":"","sources":["../../src/store-types.ts"],"names":[],"mappings":"AAuBA,6FAA6F;AAC7F,MAAM,UAAU,mBAAmB,CAA6C,KAAe;IAC7F,MAAM,EAAE,gBAAgB,EAAE,eAAe,EAAE,GAAG,KAAK,CAAC;IACpD,MAAM,OAAO,GAA4B;QACvC,gBAAgB,CAAkC,IAAgC,EAAE,OAA0B;YAC5G,OAAO,gBAAgB,CAAI,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;QACD,eAAe,CAAkC,IAAgC,EAAE,QAAY;YAC7F,OAAO,eAAe,CAAI,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC5C,CAAC;KACF,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import type { DictionaryInput, DictionaryKeys, GetterOptions, I18nOptions, InterpolationValues, LoadOptions } from './types.js';
|
|
2
|
+
/** A React-independent store. Share one instance between roots, or create one per SSR request. */
|
|
3
|
+
export declare function createI18nStore<const L extends string>(options: I18nOptions<L>): {
|
|
4
|
+
supportedLanguages: readonly L[];
|
|
5
|
+
fallbackLanguage: L;
|
|
6
|
+
/** Interpolates with this instance's configured delimiters. */
|
|
7
|
+
interpolateTypo: (template: string, values: InterpolationValues) => string;
|
|
8
|
+
resolveLanguage: (tag: string) => L | undefined;
|
|
9
|
+
getCurrentLang: () => L;
|
|
10
|
+
/** A stable SSR snapshot; match initialLanguage between server and client for hydration. */
|
|
11
|
+
getServerLanguage: () => L;
|
|
12
|
+
setCurrentLang(language: L): void;
|
|
13
|
+
subscribe(listener: () => void): () => void;
|
|
14
|
+
getSnapshot: () => number;
|
|
15
|
+
getServerSnapshot: () => number;
|
|
16
|
+
/** Loads the selected language and fallback concurrently, deduplicating each request. */
|
|
17
|
+
loadLanguage(language?: L, loadOptions?: LoadOptions): Promise<void>;
|
|
18
|
+
/** Throws a cached promise/error for React Suspense and error boundaries. */
|
|
19
|
+
readLanguage(language?: L): void;
|
|
20
|
+
createTypoGetter<const D extends DictionaryInput>(info: D, getterOptions?: GetterOptions<L>): (key: DictionaryKeys<D>, values?: InterpolationValues) => string;
|
|
21
|
+
getTypoAsObject: <const D extends DictionaryInput>(info: D, language?: L) => Record<DictionaryKeys<D>, string | undefined>;
|
|
22
|
+
};
|
|
23
|
+
export type I18nStore<L extends string> = ReturnType<typeof createI18nStore<L>>;
|
|
24
|
+
//# sourceMappingURL=store.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/store.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACb,WAAW,EACX,mBAAmB,EAEnB,WAAW,EAEZ,MAAM,YAAY,CAAC;AAEpB,kGAAkG;AAClG,wBAAgB,eAAe,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;;;IA6E3E,+DAA+D;;;0BA7CtC,CAAC;IAiD1B,4FAA4F;;6BAEnE,CAAC;wBAYN,MAAM,IAAI;;;IAQ9B,yFAAyF;4BAC5D,CAAC,gBAAkC,WAAW;IAG3E,6EAA6E;4BACtD,CAAC;2BAGD,CAAC,SAAS,eAAe,QAAQ,CAAC,kBAAiB,aAAa,CAAC,CAAC,CAAC,IAEhF,KAAK,cAAc,CAAC,CAAC,CAAC,EAAE,SAAS,mBAAmB,KAAG,MAAM;4BApD1C,CAAC,SAAS,eAAe,QAChD,CAAC,aACI,CAAC,KACX,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;EA8DjD;AAED,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,MAAM,IAAI,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC"}
|
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
import { getMessages, validateLanguageDictionary } from './dictionaries.js';
|
|
2
|
+
import { createInterpolator } from './interpolation.js';
|
|
3
|
+
import { createLanguageResolver, detectLanguage } from './languages.js';
|
|
4
|
+
import { createAsyncResource } from './resource.js';
|
|
5
|
+
/** A React-independent store. Share one instance between roots, or create one per SSR request. */
|
|
6
|
+
export function createI18nStore(options) {
|
|
7
|
+
const interpolate = createInterpolator(options.interpolation);
|
|
8
|
+
const languages = Object.freeze([...options.supportedLanguages]);
|
|
9
|
+
const supported = new Set(languages);
|
|
10
|
+
if (!supported.has(options.fallbackLanguage))
|
|
11
|
+
throw new Error('fallbackLanguage must be supported');
|
|
12
|
+
if (options.initialLanguage !== undefined && !supported.has(options.initialLanguage)) {
|
|
13
|
+
throw new Error('initialLanguage must be supported');
|
|
14
|
+
}
|
|
15
|
+
const resolveLanguage = createLanguageResolver(languages);
|
|
16
|
+
const listeners = new Set();
|
|
17
|
+
const dictionaries = new Map();
|
|
18
|
+
const resources = new Map();
|
|
19
|
+
const onError = options.onError ?? console.error;
|
|
20
|
+
let currentLanguage;
|
|
21
|
+
let revision = 0;
|
|
22
|
+
for (const language of languages) {
|
|
23
|
+
const dictionary = options.dictionaries?.[language];
|
|
24
|
+
if (dictionary !== undefined) {
|
|
25
|
+
validateLanguageDictionary(dictionary);
|
|
26
|
+
dictionaries.set(language, dictionary);
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
const getStorage = () => options.storage === false
|
|
30
|
+
? undefined
|
|
31
|
+
: (options.storage ?? (typeof window === 'undefined' ? undefined : window.localStorage));
|
|
32
|
+
const emit = () => {
|
|
33
|
+
revision += 1;
|
|
34
|
+
for (const listener of listeners)
|
|
35
|
+
listener();
|
|
36
|
+
};
|
|
37
|
+
const getCurrentLang = () => {
|
|
38
|
+
currentLanguage ??= detectLanguage(options, resolveLanguage, getStorage, onError);
|
|
39
|
+
return currentLanguage;
|
|
40
|
+
};
|
|
41
|
+
const assertSupported = (language) => {
|
|
42
|
+
if (!supported.has(language))
|
|
43
|
+
throw new Error(`Unsupported language: ${language}`);
|
|
44
|
+
};
|
|
45
|
+
const getResource = (language, retry = false) => {
|
|
46
|
+
assertSupported(language);
|
|
47
|
+
if (dictionaries.has(language))
|
|
48
|
+
return undefined;
|
|
49
|
+
const cached = resources.get(language);
|
|
50
|
+
if (cached && !(retry && cached.isRejected()))
|
|
51
|
+
return cached;
|
|
52
|
+
const resource = createAsyncResource(async () => {
|
|
53
|
+
if (!options.loadDictionary) {
|
|
54
|
+
throw new Error('Configure loadDictionary or provide preloaded dictionaries for extracted JSON');
|
|
55
|
+
}
|
|
56
|
+
const dictionary = await options.loadDictionary(language);
|
|
57
|
+
validateLanguageDictionary(dictionary);
|
|
58
|
+
dictionaries.set(language, dictionary);
|
|
59
|
+
emit();
|
|
60
|
+
});
|
|
61
|
+
resources.set(language, resource);
|
|
62
|
+
return resource;
|
|
63
|
+
};
|
|
64
|
+
const requiredResources = (language, retry = false) => {
|
|
65
|
+
assertSupported(language);
|
|
66
|
+
return [...new Set([options.fallbackLanguage, language])].map(lang => getResource(lang, retry));
|
|
67
|
+
};
|
|
68
|
+
function getTypoAsObject(info, language = getCurrentLang()) {
|
|
69
|
+
assertSupported(language);
|
|
70
|
+
const merged = new Map(Object.entries(getMessages(info, options.fallbackLanguage, dictionaries) ?? {}));
|
|
71
|
+
for (const [key, value] of Object.entries(getMessages(info, language, dictionaries) ?? {})) {
|
|
72
|
+
if (value !== undefined)
|
|
73
|
+
merged.set(key, value);
|
|
74
|
+
}
|
|
75
|
+
return Object.fromEntries(merged);
|
|
76
|
+
}
|
|
77
|
+
return {
|
|
78
|
+
supportedLanguages: languages,
|
|
79
|
+
fallbackLanguage: options.fallbackLanguage,
|
|
80
|
+
/** Interpolates with this instance's configured delimiters. */
|
|
81
|
+
interpolateTypo: interpolate,
|
|
82
|
+
resolveLanguage,
|
|
83
|
+
getCurrentLang,
|
|
84
|
+
/** A stable SSR snapshot; match initialLanguage between server and client for hydration. */
|
|
85
|
+
getServerLanguage: () => options.initialLanguage ?? options.fallbackLanguage,
|
|
86
|
+
setCurrentLang(language) {
|
|
87
|
+
assertSupported(language);
|
|
88
|
+
const previous = getCurrentLang();
|
|
89
|
+
try {
|
|
90
|
+
getStorage()?.setItem(options.storageKey ?? 'i18n-language', language);
|
|
91
|
+
}
|
|
92
|
+
catch (error) {
|
|
93
|
+
onError(error);
|
|
94
|
+
}
|
|
95
|
+
if (previous === language)
|
|
96
|
+
return;
|
|
97
|
+
currentLanguage = language;
|
|
98
|
+
emit();
|
|
99
|
+
},
|
|
100
|
+
subscribe(listener) {
|
|
101
|
+
listeners.add(listener);
|
|
102
|
+
return () => {
|
|
103
|
+
listeners.delete(listener);
|
|
104
|
+
};
|
|
105
|
+
},
|
|
106
|
+
getSnapshot: () => revision,
|
|
107
|
+
getServerSnapshot: () => 0,
|
|
108
|
+
/** Loads the selected language and fallback concurrently, deduplicating each request. */
|
|
109
|
+
async loadLanguage(language = getCurrentLang(), loadOptions = {}) {
|
|
110
|
+
await Promise.all(requiredResources(language, loadOptions.retry).map(resource => resource?.promise));
|
|
111
|
+
},
|
|
112
|
+
/** Throws a cached promise/error for React Suspense and error boundaries. */
|
|
113
|
+
readLanguage(language = getCurrentLang()) {
|
|
114
|
+
for (const resource of requiredResources(language))
|
|
115
|
+
resource?.read();
|
|
116
|
+
},
|
|
117
|
+
createTypoGetter(info, getterOptions = {}) {
|
|
118
|
+
if (getterOptions.language !== undefined)
|
|
119
|
+
assertSupported(getterOptions.language);
|
|
120
|
+
return (key, values) => {
|
|
121
|
+
const language = getterOptions.language ?? getCurrentLang();
|
|
122
|
+
const selected = getMessages(info, language, dictionaries);
|
|
123
|
+
const fallback = getMessages(info, options.fallbackLanguage, dictionaries);
|
|
124
|
+
const template = ownMessage(selected, key) ??
|
|
125
|
+
ownMessage(fallback, key) ??
|
|
126
|
+
(getterOptions.placehold === false ? '' : `i18n(${key})`);
|
|
127
|
+
return values ? interpolate(template, values) : template;
|
|
128
|
+
};
|
|
129
|
+
},
|
|
130
|
+
getTypoAsObject,
|
|
131
|
+
};
|
|
132
|
+
}
|
|
133
|
+
function ownMessage(messages, key) {
|
|
134
|
+
return messages && Object.hasOwn(messages, key) ? messages[key] : undefined;
|
|
135
|
+
}
|
|
136
|
+
//# sourceMappingURL=store.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/store.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import type { ReactBindings } from './api-types.js';
|
|
2
|
+
import type { I18nStore } from './store.js';
|
|
3
|
+
/** Validates locale keys at the public boundary while keeping the existing React implementation. */
|
|
4
|
+
export declare function bindReact<L extends string, F extends string = never>(store: I18nStore<L>): ReactBindings<L, F>;
|
|
5
|
+
//# sourceMappingURL=typed-react.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"typed-react.d.ts","sourceRoot":"","sources":["../../src/typed-react.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAA2B,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,oGAAoG;AACpG,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAyB9G"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { createReactBindings } from './react.js';
|
|
2
|
+
/** Validates locale keys at the public boundary while keeping the existing React implementation. */
|
|
3
|
+
export function bindReact(store) {
|
|
4
|
+
const bindings = createReactBindings(store);
|
|
5
|
+
const { createTypo: createRawTypo, createUseTypo: createRawUseTypo, useTypoAsObject: useRawTypoAsObject } = bindings;
|
|
6
|
+
function createTypo(info, prefix) {
|
|
7
|
+
return prefix === undefined ? createRawTypo(info) : createRawTypo(info, prefix);
|
|
8
|
+
}
|
|
9
|
+
const methods = {
|
|
10
|
+
createTypo,
|
|
11
|
+
createUseTypo(info) {
|
|
12
|
+
return createRawUseTypo(info);
|
|
13
|
+
},
|
|
14
|
+
useTypoAsObject(info) {
|
|
15
|
+
return useRawTypoAsObject(info);
|
|
16
|
+
},
|
|
17
|
+
};
|
|
18
|
+
return Object.assign(bindings, methods);
|
|
19
|
+
}
|
|
20
|
+
//# sourceMappingURL=typed-react.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"typed-react.js","sourceRoot":"","sources":["../../src/typed-react.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAMjD,oGAAoG;AACpG,MAAM,UAAU,SAAS,CAA6C,KAAmB;IACvF,MAAM,QAAQ,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,kBAAkB,EAAE,GAAG,QAAQ,CAAC;IASrH,SAAS,UAAU,CAAoD,IAAO,EAAE,MAAU;QACxF,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAI,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAO,IAAI,EAAE,MAAM,CAAC,CAAC;IAC3F,CAAC;IAED,MAAM,OAAO,GAAkC;QAC7C,UAAU;QACV,aAAa,CAAkC,IAAgC;YAC7E,OAAO,gBAAgB,CAAI,IAAI,CAAC,CAAC;QACnC,CAAC;QACD,eAAe,CAAkC,IAAgC;YAC/E,OAAO,kBAAkB,CAAI,IAAI,CAAC,CAAC;QACrC,CAAC;KACF,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC"}
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
import type { RegisteredFallbackLanguage, SupportedLanguage } from '../types/registry.cjs';
|
|
2
|
+
export type { CustomTypeOptions, RegisteredFallbackLanguage, SupportedLanguage } from '../types/registry.cjs';
|
|
3
|
+
export type Messages = Readonly<Record<string, string | undefined>>;
|
|
4
|
+
/** A feature's original JSON: language -> flat translation keys. */
|
|
5
|
+
export type FeatureDictionary<L extends string = string> = Readonly<Partial<Record<L, Messages>>>;
|
|
6
|
+
/** Emitted by the Webpack loader. The optional phantom field preserves keys for custom loaders. */
|
|
7
|
+
export interface DictionaryReference<K extends string = string> {
|
|
8
|
+
readonly __id: string;
|
|
9
|
+
readonly __keys?: K;
|
|
10
|
+
}
|
|
11
|
+
export type DictionaryInput = FeatureDictionary | DictionaryReference;
|
|
12
|
+
/** Imported variables need an exact key check: structural object typing alone permits extra locales. */
|
|
13
|
+
export type CheckedDictionary<D extends DictionaryInput, L extends string, F extends string = never> = D & (NoInfer<D> extends DictionaryReference ? unknown : Record<Exclude<keyof NoInfer<D>, L>, never> & Record<F, Messages>);
|
|
14
|
+
export type DictionaryKeys<D extends DictionaryInput> = D extends DictionaryReference<infer K> ? K : {
|
|
15
|
+
[L in keyof D]: keyof NonNullable<D[L]>;
|
|
16
|
+
}[keyof D] & string;
|
|
17
|
+
/** Contents of one emitted language file: feature ID -> translations. */
|
|
18
|
+
export type LanguageDictionary = Readonly<Record<string, Messages | undefined>>;
|
|
19
|
+
export type InterpolationValues = Readonly<Record<string, string | number | null | undefined>>;
|
|
20
|
+
export interface InterpolationDelimiters {
|
|
21
|
+
/** Literal opening delimiter, e.g. '{', '{{', '${', or a quote. Must not be empty. */
|
|
22
|
+
readonly prefix: string;
|
|
23
|
+
/** Literal closing delimiter, e.g. '}', '}}', or the same quote. Must not be empty. */
|
|
24
|
+
readonly suffix: string;
|
|
25
|
+
}
|
|
26
|
+
export type RemovePrefix<K extends string, P extends string> = K extends `${P}${infer Suffix}` ? Suffix : never;
|
|
27
|
+
export interface Typo<K extends string> {
|
|
28
|
+
(key: K, values?: InterpolationValues): string;
|
|
29
|
+
/** Allows `const { t } = useFeatureTypo()`. */
|
|
30
|
+
readonly t: (key: K, values?: InterpolationValues) => string;
|
|
31
|
+
}
|
|
32
|
+
export interface TypoOptions<P extends string = string> {
|
|
33
|
+
keyPrefix?: P;
|
|
34
|
+
/** Show `i18n(key)` for a missing message. Defaults to true; false returns an empty string. */
|
|
35
|
+
placehold?: boolean;
|
|
36
|
+
}
|
|
37
|
+
export interface TypoHook<K extends string> {
|
|
38
|
+
<P extends string>(options: TypoOptions<P> & {
|
|
39
|
+
keyPrefix: P;
|
|
40
|
+
}): Typo<RemovePrefix<K, P>>;
|
|
41
|
+
(options?: TypoOptions<never>): Typo<K>;
|
|
42
|
+
}
|
|
43
|
+
export interface TypoProps<K extends string> {
|
|
44
|
+
id: K;
|
|
45
|
+
values?: InterpolationValues;
|
|
46
|
+
}
|
|
47
|
+
export interface StorageAdapter {
|
|
48
|
+
getItem(key: string): string | null;
|
|
49
|
+
setItem(key: string, value: string): void;
|
|
50
|
+
}
|
|
51
|
+
export interface I18nOptions<L extends string> {
|
|
52
|
+
supportedLanguages: readonly L[];
|
|
53
|
+
fallbackLanguage: NoInfer<L>;
|
|
54
|
+
/** Overrides storage/browser detection. Use the same value on the server and during hydration. */
|
|
55
|
+
initialLanguage?: NoInfer<L>;
|
|
56
|
+
/** Defaults to browser localStorage. false disables persistence. Values are plain language strings. */
|
|
57
|
+
storage?: StorageAdapter | false;
|
|
58
|
+
storageKey?: string;
|
|
59
|
+
/** Interpolation placeholder delimiters. Defaults to { prefix: '{', suffix: '}' }. */
|
|
60
|
+
interpolation?: InterpolationDelimiters;
|
|
61
|
+
/** Defaults to navigator.languages, with navigator.language as a fallback. */
|
|
62
|
+
getBrowserLanguages?: () => readonly string[];
|
|
63
|
+
/** Optional preloaded emitted dictionaries, useful for SSR. */
|
|
64
|
+
dictionaries?: Readonly<Partial<Record<L, LanguageDictionary>>>;
|
|
65
|
+
/** Without a loader only inline JSON dictionaries can be used. */
|
|
66
|
+
loadDictionary?: (language: L) => Promise<LanguageDictionary>;
|
|
67
|
+
/** Receives storage errors. Defaults to console.error. Loading errors reject/throw instead. */
|
|
68
|
+
onError?: (error: unknown) => void;
|
|
69
|
+
}
|
|
70
|
+
export interface GetterOptions<L extends string> {
|
|
71
|
+
/** Omit to follow the instance's current language on every call. */
|
|
72
|
+
language?: L;
|
|
73
|
+
placehold?: boolean;
|
|
74
|
+
}
|
|
75
|
+
/** Runtime configuration must agree with any application-wide language/fallback declaration. */
|
|
76
|
+
export type DefaultI18nOptions<L extends SupportedLanguage = SupportedLanguage> = I18nOptions<L> & ([RegisteredFallbackLanguage] extends [never] ? unknown : {
|
|
77
|
+
fallbackLanguage: RegisteredFallbackLanguage;
|
|
78
|
+
}) & (string extends SupportedLanguage ? unknown : [SupportedLanguage] extends [NoInfer<L>] ? unknown : {
|
|
79
|
+
supportedLanguages: never;
|
|
80
|
+
});
|
|
81
|
+
export interface LoadOptions {
|
|
82
|
+
/** Retry a failed language request. Successful requests stay cached. */
|
|
83
|
+
retry?: boolean;
|
|
84
|
+
}
|
|
85
|
+
export interface FetchDictionaryOptions {
|
|
86
|
+
/** Defaults to "i18n". Include any bundler public path, e.g. "/app/assets/i18n". */
|
|
87
|
+
baseUrl?: string;
|
|
88
|
+
fetch?: typeof globalThis.fetch;
|
|
89
|
+
requestInit?: RequestInit;
|
|
90
|
+
}
|
|
91
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
/** Augment this interface through 'i18n-json-react' to type the application's shared instance. */
|
|
2
|
+
export interface CustomTypeOptions {}
|
|
3
|
+
|
|
4
|
+
/** Registered language identifiers, or string when no application registration is supplied. */
|
|
5
|
+
export type SupportedLanguage = CustomTypeOptions extends { supportedLanguages: infer L extends string } ? L : string;
|
|
6
|
+
|
|
7
|
+
/** Registering a fallback also requires that locale's entry in feature dictionaries. */
|
|
8
|
+
export type RegisteredFallbackLanguage = CustomTypeOptions extends { fallbackLanguage: infer F extends string }
|
|
9
|
+
? F
|
|
10
|
+
: never;
|