shared-lib-web 0.0.2 → 0.0.4

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.
Files changed (206) hide show
  1. package/README.md +192 -528
  2. package/dist/components/app-brand.d.ts.map +1 -1
  3. package/dist/components/app-brand.js +9 -5
  4. package/dist/components/app-brand.js.map +1 -1
  5. package/dist/components/coming-soon.d.ts.map +1 -1
  6. package/dist/components/coming-soon.js +3 -2
  7. package/dist/components/coming-soon.js.map +1 -1
  8. package/dist/components/language-switcher.d.ts +5 -1
  9. package/dist/components/language-switcher.d.ts.map +1 -1
  10. package/dist/components/language-switcher.js +20 -7
  11. package/dist/components/language-switcher.js.map +1 -1
  12. package/dist/components/otp-modal.d.ts +5 -0
  13. package/dist/components/otp-modal.d.ts.map +1 -0
  14. package/dist/components/otp-modal.js +77 -0
  15. package/dist/components/otp-modal.js.map +1 -0
  16. package/dist/components/settings-menu.d.ts +4 -0
  17. package/dist/components/settings-menu.d.ts.map +1 -1
  18. package/dist/components/settings-menu.js +15 -2
  19. package/dist/components/settings-menu.js.map +1 -1
  20. package/dist/context/use-ui.d.ts.map +1 -1
  21. package/dist/context/use-ui.js +4 -3
  22. package/dist/context/use-ui.js.map +1 -1
  23. package/dist/i18n/browser-language.d.ts +9 -0
  24. package/dist/i18n/browser-language.d.ts.map +1 -0
  25. package/dist/i18n/browser-language.js +89 -0
  26. package/dist/i18n/browser-language.js.map +1 -0
  27. package/dist/i18n/default-messages.d.ts.map +1 -1
  28. package/dist/i18n/default-messages.js +15 -0
  29. package/dist/i18n/default-messages.js.map +1 -1
  30. package/dist/i18n/locale-groups.d.ts +18 -0
  31. package/dist/i18n/locale-groups.d.ts.map +1 -0
  32. package/dist/i18n/locale-groups.js +74 -0
  33. package/dist/i18n/locale-groups.js.map +1 -0
  34. package/dist/i18n/locale-service.d.ts +22 -4
  35. package/dist/i18n/locale-service.d.ts.map +1 -1
  36. package/dist/i18n/locale-service.js +95 -27
  37. package/dist/i18n/locale-service.js.map +1 -1
  38. package/dist/i18n/locale-signal.d.ts +18 -0
  39. package/dist/i18n/locale-signal.d.ts.map +1 -0
  40. package/dist/i18n/locale-signal.js +142 -0
  41. package/dist/i18n/locale-signal.js.map +1 -0
  42. package/dist/i18n/translator.d.ts +8 -1
  43. package/dist/i18n/translator.d.ts.map +1 -1
  44. package/dist/i18n/translator.js +36 -12
  45. package/dist/i18n/translator.js.map +1 -1
  46. package/dist/index.d.ts +24 -11
  47. package/dist/index.d.ts.map +1 -1
  48. package/dist/index.js +21 -8
  49. package/dist/index.js.map +1 -1
  50. package/dist/interfaces/app-types.d.ts +6 -0
  51. package/dist/interfaces/app-types.d.ts.map +1 -1
  52. package/dist/interfaces/ui-config.d.ts +184 -15
  53. package/dist/interfaces/ui-config.d.ts.map +1 -1
  54. package/dist/interfaces/ui-context.d.ts +1 -1
  55. package/dist/interfaces/ui-context.d.ts.map +1 -1
  56. package/dist/layouts/auth-layout.js +1 -1
  57. package/dist/layouts/auth-layout.js.map +1 -1
  58. package/dist/providers/provider-effects.d.ts +2 -2
  59. package/dist/providers/provider-effects.d.ts.map +1 -1
  60. package/dist/providers/provider-effects.js +4 -1
  61. package/dist/providers/provider-effects.js.map +1 -1
  62. package/dist/providers/register-config.d.ts.map +1 -1
  63. package/dist/providers/register-config.js +2 -0
  64. package/dist/providers/register-config.js.map +1 -1
  65. package/dist/providers/shared-web-ui-provider.d.ts +7 -19
  66. package/dist/providers/shared-web-ui-provider.d.ts.map +1 -1
  67. package/dist/providers/shared-web-ui-provider.js +21 -22
  68. package/dist/providers/shared-web-ui-provider.js.map +1 -1
  69. package/dist/query/query-param.d.ts +4 -1
  70. package/dist/query/query-param.d.ts.map +1 -1
  71. package/dist/query/query-param.js +6 -3
  72. package/dist/query/query-param.js.map +1 -1
  73. package/dist/state/api-loader.d.ts +19 -0
  74. package/dist/state/api-loader.d.ts.map +1 -0
  75. package/dist/state/api-loader.js +187 -0
  76. package/dist/state/api-loader.js.map +1 -0
  77. package/dist/state/auth-service.d.ts +9 -0
  78. package/dist/state/auth-service.d.ts.map +1 -1
  79. package/dist/state/auth-service.js +70 -3
  80. package/dist/state/auth-service.js.map +1 -1
  81. package/dist/state/branch-service.d.ts +1 -1
  82. package/dist/state/branch-service.js +3 -3
  83. package/dist/state/branch-service.js.map +1 -1
  84. package/dist/state/company-service.d.ts +16 -0
  85. package/dist/state/company-service.d.ts.map +1 -0
  86. package/dist/state/company-service.js +97 -0
  87. package/dist/state/company-service.js.map +1 -0
  88. package/dist/state/language-service.d.ts +5 -2
  89. package/dist/state/language-service.d.ts.map +1 -1
  90. package/dist/state/language-service.js +12 -7
  91. package/dist/state/language-service.js.map +1 -1
  92. package/dist/state/layout-choice-service.d.ts +10 -0
  93. package/dist/state/layout-choice-service.d.ts.map +1 -0
  94. package/dist/state/layout-choice-service.js +34 -0
  95. package/dist/state/layout-choice-service.js.map +1 -0
  96. package/dist/state/menu-service.d.ts +1 -1
  97. package/dist/state/menu-service.js +2 -2
  98. package/dist/state/menu-service.js.map +1 -1
  99. package/dist/state/otp-service.d.ts +69 -0
  100. package/dist/state/otp-service.d.ts.map +1 -0
  101. package/dist/state/otp-service.js +212 -0
  102. package/dist/state/otp-service.js.map +1 -0
  103. package/dist/state/preference-sync.d.ts +1 -1
  104. package/dist/state/preference-sync.d.ts.map +1 -1
  105. package/dist/state/preference-sync.js +11 -3
  106. package/dist/state/preference-sync.js.map +1 -1
  107. package/dist/state/signals.d.ts +9 -1
  108. package/dist/state/signals.d.ts.map +1 -1
  109. package/dist/state/signals.js +28 -4
  110. package/dist/state/signals.js.map +1 -1
  111. package/dist/theme/custom-themes.d.ts +28 -0
  112. package/dist/theme/custom-themes.d.ts.map +1 -0
  113. package/dist/theme/custom-themes.js +218 -0
  114. package/dist/theme/custom-themes.js.map +1 -0
  115. package/dist/theme/dark-themes.d.ts +9 -1
  116. package/dist/theme/dark-themes.d.ts.map +1 -1
  117. package/dist/theme/dark-themes.js +74 -2
  118. package/dist/theme/dark-themes.js.map +1 -1
  119. package/dist/theme/logo.d.ts +6 -3
  120. package/dist/theme/logo.d.ts.map +1 -1
  121. package/dist/theme/logo.js +17 -3
  122. package/dist/theme/logo.js.map +1 -1
  123. package/dist/theme/theme-service.d.ts +14 -3
  124. package/dist/theme/theme-service.d.ts.map +1 -1
  125. package/dist/theme/theme-service.js +64 -10
  126. package/dist/theme/theme-service.js.map +1 -1
  127. package/dist/types/field-wrapper.d.ts +2 -0
  128. package/dist/types/field-wrapper.d.ts.map +1 -1
  129. package/dist/types/field-wrapper.js +3 -2
  130. package/dist/types/field-wrapper.js.map +1 -1
  131. package/dist/types/type.otp.d.ts +2 -0
  132. package/dist/types/type.otp.d.ts.map +1 -1
  133. package/dist/types/type.otp.js +2 -2
  134. package/dist/types/type.otp.js.map +1 -1
  135. package/dist/utils/app-http.d.ts +41 -1
  136. package/dist/utils/app-http.d.ts.map +1 -1
  137. package/dist/utils/app-http.js +188 -12
  138. package/dist/utils/app-http.js.map +1 -1
  139. package/dist/utils/content-util.d.ts +6 -0
  140. package/dist/utils/content-util.d.ts.map +1 -0
  141. package/dist/utils/content-util.js +45 -0
  142. package/dist/utils/content-util.js.map +1 -0
  143. package/dist/utils/error-util.d.ts +3 -0
  144. package/dist/utils/error-util.d.ts.map +1 -0
  145. package/dist/utils/error-util.js +58 -0
  146. package/dist/utils/error-util.js.map +1 -0
  147. package/dist/utils/language-util.d.ts +3 -3
  148. package/dist/utils/language-util.d.ts.map +1 -1
  149. package/dist/utils/language-util.js +7 -7
  150. package/dist/utils/language-util.js.map +1 -1
  151. package/dist/utils/menu-util.js +1 -1
  152. package/dist/utils/menu-util.js.map +1 -1
  153. package/dist/utils/signal-source.d.ts +4 -0
  154. package/dist/utils/signal-source.d.ts.map +1 -0
  155. package/dist/utils/signal-source.js +13 -0
  156. package/dist/utils/signal-source.js.map +1 -0
  157. package/dist/utils/storage-keys.d.ts +5 -0
  158. package/dist/utils/storage-keys.d.ts.map +1 -1
  159. package/dist/utils/storage-keys.js +5 -0
  160. package/dist/utils/storage-keys.js.map +1 -1
  161. package/package.json +3 -3
  162. package/src/components/app-brand.tsx +9 -5
  163. package/src/components/coming-soon.tsx +3 -2
  164. package/src/components/language-switcher.tsx +26 -7
  165. package/src/components/otp-modal.tsx +154 -0
  166. package/src/components/settings-menu.tsx +28 -2
  167. package/src/context/use-ui.ts +4 -3
  168. package/src/i18n/browser-language.ts +98 -0
  169. package/src/i18n/default-messages.ts +15 -0
  170. package/src/i18n/locale-groups.ts +87 -0
  171. package/src/i18n/locale-service.ts +99 -27
  172. package/src/i18n/locale-signal.ts +173 -0
  173. package/src/i18n/translator.ts +38 -12
  174. package/src/index.ts +102 -4
  175. package/src/interfaces/app-types.ts +6 -0
  176. package/src/interfaces/ui-config.ts +191 -15
  177. package/src/interfaces/ui-context.ts +1 -1
  178. package/src/layouts/auth-layout.tsx +1 -1
  179. package/src/providers/provider-effects.ts +5 -2
  180. package/src/providers/register-config.ts +2 -0
  181. package/src/providers/shared-web-ui-provider.tsx +26 -43
  182. package/src/query/query-param.ts +6 -2
  183. package/src/state/api-loader.ts +205 -0
  184. package/src/state/auth-service.ts +84 -3
  185. package/src/state/branch-service.ts +3 -3
  186. package/src/state/company-service.ts +107 -0
  187. package/src/state/language-service.ts +12 -7
  188. package/src/state/layout-choice-service.ts +40 -0
  189. package/src/state/menu-service.ts +2 -2
  190. package/src/state/otp-service.ts +283 -0
  191. package/src/state/preference-sync.ts +11 -3
  192. package/src/state/signals.ts +36 -4
  193. package/src/theme/custom-themes.ts +236 -0
  194. package/src/theme/dark-themes.ts +80 -3
  195. package/src/theme/logo.ts +19 -4
  196. package/src/theme/org-themes.json +70 -0
  197. package/src/theme/theme-service.ts +70 -10
  198. package/src/types/field-wrapper.tsx +5 -2
  199. package/src/types/type.otp.tsx +11 -2
  200. package/src/utils/app-http.ts +205 -12
  201. package/src/utils/content-util.ts +49 -0
  202. package/src/utils/error-util.ts +64 -0
  203. package/src/utils/language-util.ts +7 -7
  204. package/src/utils/menu-util.ts +1 -1
  205. package/src/utils/signal-source.ts +15 -0
  206. package/src/utils/storage-keys.ts +6 -0
@@ -0,0 +1,74 @@
1
+ // locale-groups.ts
2
+ // Locale files split by group: one folder per language, one file per group (the file name is the group).
3
+ //
4
+ // locales/en-US/app.json { "name": "My App" } -> t("app.name")
5
+ // locales/en-US/nav.json { "users": "Users" } -> t("nav.users")
6
+ // locales/en-US/root.json { "REQUIRED": "This field is required" } -> t("REQUIRED") (top-level keys)
7
+ //
8
+ // // config.ts (Vite: import.meta.glob is lazy, only the files of the language in use are downloaded)
9
+ // const localeFiles = import.meta.glob("./locales/*/*.json");
10
+ // loadLocale: loadLocaleGroups.bind(null, localeFiles)
11
+ //
12
+ // Several folders can be merged ({ ...sharedFiles, ...ownFiles }): the same group in two folders is merged,
13
+ // the later file wins per key. Each file is flat, so the "group.key" rule (one sublevel) holds by itself.
14
+ import { unwrapLocaleModule } from "./locale-service.js";
15
+ /** The file whose keys stay at the top level (dff-util messages like REQUIRED, or "greeting"). */
16
+ export const ROOT_LOCALE_GROUP = "root";
17
+ const JSON_EXTENSION = ".json";
18
+ /** Language code and group of a file path: "./locales/en-US/nav.json" -> { languageCode: "en-US", group: "nav" }. */
19
+ export function readLocaleFilePath(path) {
20
+ const parts = path.split("/");
21
+ const fileName = parts[parts.length - 1] ?? "";
22
+ const languageCode = parts[parts.length - 2] ?? "";
23
+ const isJsonFile = fileName.endsWith(JSON_EXTENSION);
24
+ if (!isJsonFile || languageCode.length === 0) {
25
+ return undefined;
26
+ }
27
+ const groupLength = fileName.length - JSON_EXTENSION.length;
28
+ const group = fileName.slice(0, groupLength);
29
+ return { languageCode: languageCode, group: group };
30
+ }
31
+ /** Loads one group file and takes the messages out of the JSON module. */
32
+ async function loadGroupFile(loadFile) {
33
+ const fileModule = await loadFile();
34
+ return unwrapLocaleModule(fileModule);
35
+ }
36
+ /** Adds one group file to the messages (the root file goes to the top level). */
37
+ function addGroupMessages(messages, group, groupMessages) {
38
+ if (group === ROOT_LOCALE_GROUP) {
39
+ Object.assign(messages, groupMessages);
40
+ return;
41
+ }
42
+ const existingGroup = messages[group];
43
+ const isExistingGroup = typeof existingGroup === "object" && existingGroup !== null;
44
+ messages[group] = isExistingGroup ? { ...existingGroup, ...groupMessages } : groupMessages;
45
+ }
46
+ /**
47
+ * Loads all group files of one language (in parallel) and returns one messages object, ready for loadLocale.
48
+ * Throws when the language has no files, so the next language is tried (browser language -> en-US).
49
+ */
50
+ export async function loadLocaleGroups(files, languageCode) {
51
+ const groups = [];
52
+ const loadings = [];
53
+ const entries = Object.entries(files);
54
+ for (const [path, loadFile] of entries) {
55
+ const fileInfo = readLocaleFilePath(path);
56
+ if (fileInfo?.languageCode !== languageCode) {
57
+ continue;
58
+ }
59
+ groups.push(fileInfo.group);
60
+ const loading = loadGroupFile(loadFile);
61
+ loadings.push(loading);
62
+ }
63
+ if (groups.length === 0) {
64
+ throw new Error(`shared-lib-web: no locale files for ${languageCode}`);
65
+ }
66
+ const groupContents = await Promise.all(loadings);
67
+ const messages = {};
68
+ for (const [index, group] of groups.entries()) {
69
+ const groupMessages = groupContents[index] ?? {};
70
+ addGroupMessages(messages, group, groupMessages);
71
+ }
72
+ return messages;
73
+ }
74
+ //# sourceMappingURL=locale-groups.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"locale-groups.js","sourceRoot":"","sources":["../../src/i18n/locale-groups.ts"],"names":[],"mappings":"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"}
@@ -13,11 +13,26 @@ export declare function loadLocaleMessages(languageCode: string): Promise<Locale
13
13
  export declare function clearLocaleCache(): void;
14
14
  /** true when the user picked a language (it is not changed to the backend default then). */
15
15
  export declare function readIsLanguageChosen(): boolean;
16
- /** Language used when the app sets none (config.defaultLanguage missing). */
16
+ /** Language used when nothing else is set (no defaultLanguage, no browser match). */
17
17
  export declare const DEFAULT_LANGUAGE = "en-US";
18
- /** config.defaultLanguage, or "en-US" when it is not set. */
18
+ /**
19
+ * The language for keys missing in the current language, and the last default:
20
+ * config.defaultLanguage, else "en-US".
21
+ */
22
+ export declare function readFallbackLanguage(config: UiConfig | null | undefined): string;
23
+ /** The browser / system language that is in the language list (undefined without a list or a match). */
24
+ export declare function readBrowserLanguage(): string | undefined;
25
+ /**
26
+ * The default language: config.defaultLanguage, else the browser / system language (when it is in the list),
27
+ * else "en-US".
28
+ */
19
29
  export declare function readDefaultLanguage(config: UiConfig | null | undefined): string;
20
- /** Picks the language to start with: the saved one if it may be used, else the default. */
30
+ /**
31
+ * The languages to try on start, in order: the saved one, config.defaultLanguage, the browser / system languages
32
+ * (matched to the list; without a list all of them, a missing locale file is skipped), the fallback, the first listed.
33
+ */
34
+ export declare function readStartLanguageCandidates(config: UiConfig): string[];
35
+ /** Picks the language to start with: the first start candidate that may be used. */
21
36
  export declare function readInitialLanguageCode(config: UiConfig): string;
22
37
  /** Loads the fallback language messages into fallbackTranslationSignal. */
23
38
  export declare function loadFallbackMessages(config: UiConfig): Promise<void>;
@@ -31,6 +46,9 @@ export declare function applyLanguage(languageCode: string, shouldSave: boolean)
31
46
  * Unknown codes are ignored. The choice is saved to localStorage.
32
47
  */
33
48
  export declare function changeLanguage(languageCode: string): Promise<void>;
34
- /** Loads the saved (or default) language and the fallback language. Called once by TranslationProvider. */
49
+ /**
50
+ * Loads the start language and the fallback language. Called once by TranslationProvider.
51
+ * Tries readStartLanguageCandidates in order; a language whose file cannot be loaded is skipped.
52
+ */
35
53
  export declare function initializeLanguage(): Promise<void>;
36
54
  //# sourceMappingURL=locale-service.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"locale-service.d.ts","sourceRoot":"","sources":["../../src/i18n/locale-service.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAkB,cAAc,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAoBzG,6FAA6F;AAC7F,wBAAgB,gBAAgB,IAAI,QAAQ,CAM3C;AAED,gGAAgG;AAChG,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,YAAY,GAAG,cAAc,CAO7E;AAED,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAOjE;AAED,qHAAqH;AACrH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,CAYvF;AAED,oGAAoG;AACpG,wBAAsB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAiBlG;AAED,wCAAwC;AACxC,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED,4FAA4F;AAC5F,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,UAAU,CAAC;AAExC,6DAA6D;AAC7D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAE/E;AAED,2FAA2F;AAC3F,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAgBhE;AAED,2EAA2E;AAC3E,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAM1E;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAiB/F;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGxE;AAED,2GAA2G;AAC3G,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAexD"}
1
+ {"version":3,"file":"locale-service.d.ts","sourceRoot":"","sources":["../../src/i18n/locale-service.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAkB,cAAc,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAwBzG,6FAA6F;AAC7F,wBAAgB,gBAAgB,IAAI,QAAQ,CAM3C;AAED,gGAAgG;AAChG,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,YAAY,GAAG,cAAc,CAO7E;AAED,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAOjE;AAED,qHAAqH;AACrH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,CAevF;AAWD,oGAAoG;AACpG,wBAAsB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAkBlG;AAED,wCAAwC;AACxC,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED,4FAA4F;AAC5F,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,qFAAqF;AACrF,eAAO,MAAM,gBAAgB,UAAU,CAAC;AAExC;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAEhF;AAED,wGAAwG;AACxG,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAOxD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAM/E;AASD;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,EAAE,CAoBtE;AAED,oFAAoF;AACpF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAShE;AAED,2EAA2E;AAC3E,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAM1E;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAiB/F;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGxE;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAaxD"}
@@ -5,10 +5,17 @@
5
5
  //
6
6
  // The loader is the language's own load() or config.loadLocale(code) (locales/{code}.json).
7
7
  // The languages are config.languages or the backend list (languagesSignal). Loaded files are cached.
8
+ //
9
+ // First visit (nothing saved): config.defaultLanguage, else the browser / system language (navigator.languages,
10
+ // matched to the list: "fr-CA" -> "fr-FR"), else "en-US".
8
11
  import { fallbackTranslationSignal, isTranslationReadySignal, languagesSignal, localeSignal, translationSignal, uiConfigSignal, } from "../state/signals.js";
9
12
  import { AppStorage } from "../utils/app-storage.js";
10
13
  import { LANG } from "../utils/storage-keys.js";
14
+ import { matchLanguageCode, readBrowserLanguageCodes } from "./browser-language.js";
15
+ import { isSignalSource } from "../utils/signal-source.js";
11
16
  import { findLanguageOption } from "./direction.js";
17
+ import { waitForSignalLocale } from "./locale-signal.js";
18
+ import { findDeepLocaleKeys } from "./translator.js";
12
19
  const UI_CONFIG_MISSING = "shared-lib-web: config is missing. Wrap your app in <SharedWebUiProvider config={config}>.";
13
20
  const loadedMessagesCache = new Map();
14
21
  /** true when the user picked a language (now or on an earlier visit). Then a backend default does not override it. */
@@ -51,8 +58,19 @@ export function runLocaleLoader(languageCode) {
51
58
  if (!loadLocale) {
52
59
  return undefined;
53
60
  }
61
+ if (isSignalSource(loadLocale)) {
62
+ return waitForSignalLocale(loadLocale, languageCode);
63
+ }
54
64
  return loadLocale(languageCode);
55
65
  }
66
+ /** Locale files allow one sublevel ("group.key"); deeper groups are never shown, so say so once per file. */
67
+ function warnAboutDeepKeys(languageCode, messages) {
68
+ const deepKeys = findDeepLocaleKeys(messages);
69
+ if (deepKeys.length > 0) {
70
+ const keyList = deepKeys.join(", ");
71
+ console.warn(`shared-lib-web: ${languageCode}.json is deeper than "group.key" (one sublevel); not used: ${keyList}`);
72
+ }
73
+ }
56
74
  /** Loads (or reads from cache) the messages of one language. undefined when it cannot be loaded. */
57
75
  export async function loadLocaleMessages(languageCode) {
58
76
  const cachedMessages = loadedMessagesCache.get(languageCode);
@@ -66,6 +84,7 @@ export async function loadLocaleMessages(languageCode) {
66
84
  try {
67
85
  const localeModule = await loading;
68
86
  const messages = unwrapLocaleModule(localeModule);
87
+ warnAboutDeepKeys(languageCode, messages);
69
88
  loadedMessagesCache.set(languageCode, messages);
70
89
  return messages;
71
90
  }
@@ -81,33 +100,81 @@ export function clearLocaleCache() {
81
100
  export function readIsLanguageChosen() {
82
101
  return isLanguageChosen;
83
102
  }
84
- /** Language used when the app sets none (config.defaultLanguage missing). */
103
+ /** Language used when nothing else is set (no defaultLanguage, no browser match). */
85
104
  export const DEFAULT_LANGUAGE = "en-US";
86
- /** config.defaultLanguage, or "en-US" when it is not set. */
87
- export function readDefaultLanguage(config) {
105
+ /**
106
+ * The language for keys missing in the current language, and the last default:
107
+ * config.defaultLanguage, else "en-US".
108
+ */
109
+ export function readFallbackLanguage(config) {
88
110
  return config?.defaultLanguage || DEFAULT_LANGUAGE;
89
111
  }
90
- /** Picks the language to start with: the saved one if it may be used, else the default. */
91
- export function readInitialLanguageCode(config) {
92
- const storedCode = AppStorage.getText(LANG);
93
- if (storedCode) {
94
- const isStoredAvailable = isLanguageAvailable(storedCode);
95
- if (isStoredAvailable) {
96
- return storedCode;
97
- }
112
+ /** The browser / system language that is in the language list (undefined without a list or a match). */
113
+ export function readBrowserLanguage() {
114
+ const languages = languagesSignal.peek();
115
+ if (languages.length === 0) {
116
+ return undefined;
117
+ }
118
+ const browserCodes = readBrowserLanguageCodes();
119
+ return matchLanguageCode(browserCodes, languages);
120
+ }
121
+ /**
122
+ * The default language: config.defaultLanguage, else the browser / system language (when it is in the list),
123
+ * else "en-US".
124
+ */
125
+ export function readDefaultLanguage(config) {
126
+ if (config?.defaultLanguage) {
127
+ return config.defaultLanguage;
98
128
  }
99
- const defaultLanguage = readDefaultLanguage(config);
100
- const isDefaultAvailable = isLanguageAvailable(defaultLanguage);
101
- if (isDefaultAvailable) {
102
- return defaultLanguage;
129
+ const browserLanguage = readBrowserLanguage();
130
+ return browserLanguage ?? readFallbackLanguage(config);
131
+ }
132
+ /** Adds a code once. */
133
+ function addCandidate(candidates, code) {
134
+ if (code && !candidates.includes(code)) {
135
+ candidates.push(code);
103
136
  }
137
+ }
138
+ /**
139
+ * The languages to try on start, in order: the saved one, config.defaultLanguage, the browser / system languages
140
+ * (matched to the list; without a list all of them, a missing locale file is skipped), the fallback, the first listed.
141
+ */
142
+ export function readStartLanguageCandidates(config) {
143
+ const candidates = [];
144
+ const storedCode = AppStorage.getText(LANG);
145
+ addCandidate(candidates, storedCode);
146
+ addCandidate(candidates, config.defaultLanguage);
104
147
  const languages = languagesSignal.peek();
148
+ const browserCodes = readBrowserLanguageCodes();
149
+ if (languages.length > 0) {
150
+ const browserLanguage = matchLanguageCode(browserCodes, languages);
151
+ addCandidate(candidates, browserLanguage);
152
+ }
153
+ else {
154
+ for (const browserCode of browserCodes) {
155
+ addCandidate(candidates, browserCode);
156
+ }
157
+ }
158
+ const fallbackLanguage = readFallbackLanguage(config);
159
+ addCandidate(candidates, fallbackLanguage);
105
160
  const firstLanguage = languages[0];
106
- return firstLanguage ? firstLanguage.code : defaultLanguage;
161
+ addCandidate(candidates, firstLanguage?.code);
162
+ return candidates;
163
+ }
164
+ /** Picks the language to start with: the first start candidate that may be used. */
165
+ export function readInitialLanguageCode(config) {
166
+ const candidates = readStartLanguageCandidates(config);
167
+ for (const candidate of candidates) {
168
+ const isAvailable = isLanguageAvailable(candidate);
169
+ if (isAvailable) {
170
+ return candidate;
171
+ }
172
+ }
173
+ return readFallbackLanguage(config);
107
174
  }
108
175
  /** Loads the fallback language messages into fallbackTranslationSignal. */
109
176
  export async function loadFallbackMessages(config) {
110
- const fallbackCode = config.fallbackLanguage ?? readDefaultLanguage(config);
177
+ const fallbackCode = readFallbackLanguage(config);
111
178
  const fallbackMessages = await loadLocaleMessages(fallbackCode);
112
179
  if (fallbackMessages) {
113
180
  fallbackTranslationSignal.value = fallbackMessages;
@@ -143,21 +210,22 @@ export async function changeLanguage(languageCode) {
143
210
  readActiveConfig();
144
211
  await applyLanguage(languageCode, true);
145
212
  }
146
- /** Loads the saved (or default) language and the fallback language. Called once by TranslationProvider. */
213
+ /**
214
+ * Loads the start language and the fallback language. Called once by TranslationProvider.
215
+ * Tries readStartLanguageCandidates in order; a language whose file cannot be loaded is skipped.
216
+ */
147
217
  export async function initializeLanguage() {
148
218
  const config = readActiveConfig();
149
219
  const storedCode = AppStorage.getText(LANG);
150
220
  isLanguageChosen = Boolean(storedCode);
151
221
  await loadFallbackMessages(config);
152
- const languageCode = readInitialLanguageCode(config);
153
- const isApplied = await applyLanguage(languageCode, false);
154
- if (isApplied) {
155
- return;
156
- }
157
- const defaultLanguage = readDefaultLanguage(config);
158
- const isDefaultApplied = await applyLanguage(defaultLanguage, false);
159
- if (!isDefaultApplied) {
160
- isTranslationReadySignal.value = true;
222
+ const candidates = readStartLanguageCandidates(config);
223
+ for (const candidate of candidates) {
224
+ const isApplied = await applyLanguage(candidate, false);
225
+ if (isApplied) {
226
+ return;
227
+ }
161
228
  }
229
+ isTranslationReadySignal.value = true;
162
230
  }
163
231
  //# sourceMappingURL=locale-service.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"locale-service.js","sourceRoot":"","sources":["../../src/i18n/locale-service.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"locale-service.js","sourceRoot":"","sources":["../../src/i18n/locale-service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ import type { LocaleBundle, LocaleCodeLoader, LocaleModule, ValueSignal } from "../interfaces/ui-config.js";
2
+ /** How long the library waits for a requested language before it tries the next one. */
3
+ export declare const LOCALE_WAIT_MS = 15000;
4
+ /** The language codes the library needs texts for (in the order it asked). */
5
+ export declare const requestedLocalesSignal: import("@preact/signals-core").Signal<string[]>;
6
+ /** A bundle signal the app writes. */
7
+ export interface WritableLocaleBundleSignal {
8
+ value: LocaleBundle | null;
9
+ peek(): LocaleBundle | null;
10
+ }
11
+ /** The texts of one language from a loadLocale signal: now when the bundle has them, else after the app adds them. */
12
+ export declare function waitForSignalLocale(source: ValueSignal<LocaleBundle | null>, code: string): Promise<LocaleModule>;
13
+ /**
14
+ * Fills a loadLocale signal: every language the library asks for is loaded with your loader (for example
15
+ * loadLocaleGroups.bind(null, localeFiles)) and added to the bundle. Returns the stop function (for useEffect).
16
+ */
17
+ export declare function fillLocaleBundle(target: WritableLocaleBundleSignal, loader: LocaleCodeLoader): () => void;
18
+ //# sourceMappingURL=locale-signal.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"locale-signal.d.ts","sourceRoot":"","sources":["../../src/i18n/locale-signal.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAkB,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE5H,wFAAwF;AACxF,eAAO,MAAM,cAAc,QAAQ,CAAC;AAEpC,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB,iDAAuB,CAAC;AAS3D,sCAAsC;AACtC,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,IAAI,IAAI,YAAY,GAAG,IAAI,CAAC;CAC7B;AA6ED,sHAAsH;AACtH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,CAAC,YAAY,GAAG,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAoBjH;AAmCD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,0BAA0B,EAAE,MAAM,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAGzG"}
@@ -0,0 +1,142 @@
1
+ // locale-signal.ts
2
+ // config.loadLocale as a SIGNAL: a bundle of texts per language code, filled by the app.
3
+ //
4
+ // const localeSignal = signal<LocaleBundle | null>(null); // { "en-US": {...}, "fr-FR": {...} }
5
+ // (the app's own signal — not the library's localeSignal, which holds the current language code)
6
+ // loadLocale: localeSignal,
7
+ //
8
+ // The library asks for a language by adding its code to requestedLocalesSignal and waits until the bundle has it
9
+ // (null for a code = that language has no texts: the next language is tried). The app fills the bundle:
10
+ // fillLocaleBundle(localeSignal, loadLocaleGroups.bind(null, localeFiles)); // loads every requested code
11
+ // Without an answer within LOCALE_WAIT_MS the language counts as missing.
12
+ import { effect, signal } from "@preact/signals-react";
13
+ /** How long the library waits for a requested language before it tries the next one. */
14
+ export const LOCALE_WAIT_MS = 15000;
15
+ /** The language codes the library needs texts for (in the order it asked). */
16
+ export const requestedLocalesSignal = signal([]);
17
+ const pendingLocales = new Map();
18
+ let followedSource = undefined;
19
+ let stopFollowingSource = undefined;
20
+ /** Codes being loaded per bundle signal (fillLocaleBundle), so a code is loaded once. */
21
+ const loadingCodes = new WeakMap();
22
+ /** Stores resolve / reject of a new promise on the pending entry. */
23
+ function captureResolvers(pending, resolve, reject) {
24
+ pending.resolve = resolve;
25
+ pending.reject = reject;
26
+ }
27
+ /** A new pending entry with its promise. */
28
+ function createPendingLocale() {
29
+ const pending = {};
30
+ const capture = captureResolvers.bind(null, pending);
31
+ pending.promise = new Promise(capture);
32
+ return pending;
33
+ }
34
+ /** Settles every waiting language that the bundle now answers (texts, or null = missing). */
35
+ function settlePendingLocales(bundle) {
36
+ if (!bundle) {
37
+ return;
38
+ }
39
+ for (const [code, pending] of pendingLocales) {
40
+ if (!(code in bundle)) {
41
+ continue;
42
+ }
43
+ pendingLocales.delete(code);
44
+ const messages = bundle[code];
45
+ if (messages) {
46
+ pending.resolve(messages);
47
+ }
48
+ else {
49
+ const missingError = new Error(`shared-lib-web: no texts for ${code} in the loadLocale signal`);
50
+ pending.reject(missingError);
51
+ }
52
+ }
53
+ }
54
+ /** Follows the bundle signal (once per signal). */
55
+ function followBundleSource(source) {
56
+ if (followedSource === source) {
57
+ return;
58
+ }
59
+ stopFollowingSource?.();
60
+ followedSource = source;
61
+ stopFollowingSource = source.subscribe(settlePendingLocales);
62
+ }
63
+ /** No answer in time: the language counts as missing. */
64
+ function rejectLateLocale(code) {
65
+ const pending = pendingLocales.get(code);
66
+ if (!pending) {
67
+ return;
68
+ }
69
+ pendingLocales.delete(code);
70
+ const timeoutError = new Error(`shared-lib-web: the loadLocale signal did not answer ${code} in time`);
71
+ pending.reject(timeoutError);
72
+ }
73
+ /** Adds the code to requestedLocalesSignal (once). */
74
+ function requestLocale(code) {
75
+ const requestedCodes = requestedLocalesSignal.peek();
76
+ if (!requestedCodes.includes(code)) {
77
+ requestedLocalesSignal.value = [...requestedCodes, code];
78
+ }
79
+ }
80
+ /** The texts of one language from a loadLocale signal: now when the bundle has them, else after the app adds them. */
81
+ export function waitForSignalLocale(source, code) {
82
+ const bundle = source.peek();
83
+ const readyMessages = bundle?.[code];
84
+ if (readyMessages) {
85
+ return Promise.resolve(readyMessages);
86
+ }
87
+ if (bundle && code in bundle) {
88
+ const missingError = new Error(`shared-lib-web: no texts for ${code} in the loadLocale signal`);
89
+ return Promise.reject(missingError);
90
+ }
91
+ followBundleSource(source);
92
+ let pending = pendingLocales.get(code);
93
+ if (!pending) {
94
+ pending = createPendingLocale();
95
+ pendingLocales.set(code, pending);
96
+ const rejectLater = rejectLateLocale.bind(null, code);
97
+ setTimeout(rejectLater, LOCALE_WAIT_MS);
98
+ }
99
+ requestLocale(code);
100
+ return pending.promise;
101
+ }
102
+ /** Loads one requested code into the bundle (null when it fails: that language is missing). */
103
+ async function loadIntoBundle(target, loader, code) {
104
+ let messages = null;
105
+ try {
106
+ const localeModule = await loader(code);
107
+ const hasDefault = typeof localeModule === "object" && localeModule !== null && "default" in localeModule;
108
+ messages = (hasDefault ? localeModule.default : localeModule);
109
+ }
110
+ catch {
111
+ messages = null;
112
+ }
113
+ const currentBundle = target.peek() ?? {};
114
+ target.value = { ...currentBundle, [code]: messages };
115
+ }
116
+ /** Loads every requested code that the bundle does not have yet (a signals effect). */
117
+ function followRequestedLocales(target, loader) {
118
+ const requestedCodes = requestedLocalesSignal.value;
119
+ const bundle = target.peek() ?? {};
120
+ let codesInProgress = loadingCodes.get(target);
121
+ if (!codesInProgress) {
122
+ codesInProgress = new Set();
123
+ loadingCodes.set(target, codesInProgress);
124
+ }
125
+ for (const code of requestedCodes) {
126
+ const isKnown = code in bundle || codesInProgress.has(code);
127
+ if (isKnown) {
128
+ continue;
129
+ }
130
+ codesInProgress.add(code);
131
+ void loadIntoBundle(target, loader, code);
132
+ }
133
+ }
134
+ /**
135
+ * Fills a loadLocale signal: every language the library asks for is loaded with your loader (for example
136
+ * loadLocaleGroups.bind(null, localeFiles)) and added to the bundle. Returns the stop function (for useEffect).
137
+ */
138
+ export function fillLocaleBundle(target, loader) {
139
+ const followRequests = followRequestedLocales.bind(null, target, loader);
140
+ return effect(followRequests);
141
+ }
142
+ //# sourceMappingURL=locale-signal.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"locale-signal.js","sourceRoot":"","sources":["../../src/i18n/locale-signal.ts"],"names":[],"mappings":"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"}
@@ -1,7 +1,14 @@
1
1
  import type { TranslateParams } from "../interfaces/ui-context.js";
2
2
  import type { LocaleMessages } from "../interfaces/ui-config.js";
3
- /** Finds a text in a messages object by a dotted key. Returns undefined when not found. */
3
+ /** The deepest key: "group.key" (one sublevel). */
4
+ export declare const MAX_KEY_PARTS = 2;
5
+ /**
6
+ * Finds a text in a messages object by a key: "key" or "group.key" (one sublevel only).
7
+ * Returns undefined when not found or when the key is deeper ("a.b.c").
8
+ */
4
9
  export declare function lookupMessage(messages: LocaleMessages, key: string): string | undefined;
10
+ /** The keys of a locale file that are deeper than "group.key" (they are never shown). [] when the file is fine. */
11
+ export declare function findDeepLocaleKeys(messages: LocaleMessages): string[];
5
12
  /** Replaces {{name}} placeholders with values from params. Unknown placeholders stay as they are. */
6
13
  export declare function interpolate(text: string, params: TranslateParams | undefined): string;
7
14
  /** Finds the text for a key in all sources, in order. */
@@ -1 +1 @@
1
- {"version":3,"file":"translator.d.ts","sourceRoot":"","sources":["../../src/i18n/translator.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAMjE,2FAA2F;AAC3F,wBAAgB,aAAa,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAmBvF;AAED,qGAAqG;AACrG,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,SAAS,GAAG,MAAM,CAiBrF;AAED,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiB3D;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,MAAM,CAKvE"}
1
+ {"version":3,"file":"translator.d.ts","sourceRoot":"","sources":["../../src/i18n/translator.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAMjE,mDAAmD;AACnD,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAkBvF;AAED,mHAAmH;AACnH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,EAAE,CAerE;AAED,qGAAqG;AACrG,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,SAAS,GAAG,MAAM,CAiBrF;AAED,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiB3D;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,MAAM,CAKvE"}
@@ -4,31 +4,55 @@
4
4
  // t("nav.users") -> looks up { "nav": { "users": "..." } }
5
5
  // t("greeting", { name: "Asha" }) -> "Hello {{name}}" becomes "Hello Asha"
6
6
  //
7
+ // Locale files have at most ONE sublevel: "key" or "group.key" ({ "user": { "title": "..." } }).
8
+ // Deeper keys ("user.role.admin") are not looked up; use "role.admin" or "user.roleAdmin" instead.
9
+ //
7
10
  // Search order: current language -> fallback language -> package defaults -> the key itself.
8
11
  import { ConstValue } from "dff-util";
9
12
  import { fallbackTranslationSignal, translationSignal } from "../state/signals.js";
10
13
  import { DEFAULT_CONST_MESSAGES, DEFAULT_UI_MESSAGES } from "./default-messages.js";
11
14
  const PLACEHOLDER_PATTERN = /\{\{\s*(\w+)\s*\}\}/g;
12
- /** Finds a text in a messages object by a dotted key. Returns undefined when not found. */
15
+ /** The deepest key: "group.key" (one sublevel). */
16
+ export const MAX_KEY_PARTS = 2;
17
+ /**
18
+ * Finds a text in a messages object by a key: "key" or "group.key" (one sublevel only).
19
+ * Returns undefined when not found or when the key is deeper ("a.b.c").
20
+ */
13
21
  export function lookupMessage(messages, key) {
14
22
  const directValue = messages[key];
15
23
  if (typeof directValue === "string") {
16
24
  return directValue;
17
25
  }
18
26
  const keyParts = key.split(ConstValue.PERIOD);
19
- let currentValue = messages;
20
- for (const keyPart of keyParts) {
21
- const isGroup = typeof currentValue === "object" && currentValue !== null;
22
- if (!isGroup) {
23
- return undefined;
24
- }
25
- const group = currentValue;
26
- currentValue = group[keyPart];
27
+ if (keyParts.length !== MAX_KEY_PARTS) {
28
+ return undefined;
29
+ }
30
+ const groupName = keyParts[0] ?? ConstValue.EMPTY;
31
+ const itemName = keyParts[1] ?? ConstValue.EMPTY;
32
+ const group = messages[groupName];
33
+ const isGroup = typeof group === "object" && group !== null;
34
+ if (!isGroup) {
35
+ return undefined;
27
36
  }
28
- if (typeof currentValue === "string") {
29
- return currentValue;
37
+ const value = group[itemName];
38
+ return typeof value === "string" ? value : undefined;
39
+ }
40
+ /** The keys of a locale file that are deeper than "group.key" (they are never shown). [] when the file is fine. */
41
+ export function findDeepLocaleKeys(messages) {
42
+ const deepKeys = [];
43
+ const groupEntries = Object.entries(messages);
44
+ for (const [groupName, group] of groupEntries) {
45
+ if (typeof group !== "object" || group === null) {
46
+ continue;
47
+ }
48
+ const itemEntries = Object.entries(group);
49
+ for (const [itemName, value] of itemEntries) {
50
+ if (typeof value === "object" && value !== null) {
51
+ deepKeys.push(`${groupName}.${itemName}.*`);
52
+ }
53
+ }
30
54
  }
31
- return undefined;
55
+ return deepKeys;
32
56
  }
33
57
  /** Replaces {{name}} placeholders with values from params. Unknown placeholders stay as they are. */
34
58
  export function interpolate(text, params) {
@@ -1 +1 @@
1
- {"version":3,"file":"translator.js","sourceRoot":"","sources":["../../src/i18n/translator.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"translator.js","sourceRoot":"","sources":["../../src/i18n/translator.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAChB,iDAAiD;AACjD,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,EAAE;AACF,iGAAiG;AACjG,mGAAmG;AACnG,EAAE;AACF,6FAA6F;AAE7F,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGtC,OAAO,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEpF,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AAEnD,mDAAmD;AACnD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAE/B;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAwB,EAAE,GAAW;IACjE,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,QAAQ,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;QACtC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC;IAClD,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC;IACjD,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;IAC5D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,mHAAmH;AACnH,MAAM,UAAU,kBAAkB,CAAC,QAAwB;IACzD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9C,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,YAAY,EAAE,CAAC;QAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAChD,SAAS;QACX,CAAC;QACD,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC1C,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC;YAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAChD,QAAQ,CAAC,IAAI,CAAC,GAAG,SAAS,IAAI,QAAQ,IAAI,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,MAAmC;IAC3E,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;IACnD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC;QAC/C,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,SAAS;QACX,CAAC;QACD,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;QACvC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,eAAe,GAAG,iBAAiB,CAAC,KAAK,CAAC;IAChD,MAAM,WAAW,GAAG,aAAa,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;IACxD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,KAAK,CAAC;IACzD,MAAM,YAAY,GAAG,aAAa,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAC1D,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,MAAM,MAAM,GAAG,aAAa,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;IACvD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,SAAS,GAAG,aAAa,CAAC,sBAAsB,EAAE,GAAG,CAAC,CAAC;IAC7D,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,MAAwB;IAC7D,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,OAAO,IAAI,GAAG,CAAC;IAC5B,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5C,OAAO,SAAS,CAAC;AACnB,CAAC"}