@digitaldefiance/i18n-lib 1.3.13 → 1.3.14

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 (243) hide show
  1. package/README.md +4 -0
  2. package/package.json +4 -3
  3. package/src/active-context.d.ts +30 -0
  4. package/src/active-context.d.ts.map +1 -0
  5. package/src/active-context.js +3 -0
  6. package/src/active-context.js.map +1 -0
  7. package/src/component-definition.d.ts +12 -0
  8. package/src/component-definition.d.ts.map +1 -0
  9. package/src/component-definition.js +3 -0
  10. package/src/component-definition.js.map +1 -0
  11. package/src/component-registration.d.ts +10 -0
  12. package/src/component-registration.d.ts.map +1 -0
  13. package/src/component-registration.js +3 -0
  14. package/src/component-registration.js.map +1 -0
  15. package/src/component-registry.d.ts +69 -0
  16. package/src/component-registry.d.ts.map +1 -0
  17. package/src/component-registry.js +248 -0
  18. package/src/component-registry.js.map +1 -0
  19. package/src/context-error-type.d.ts +4 -0
  20. package/src/context-error-type.d.ts.map +1 -0
  21. package/src/context-error-type.js +8 -0
  22. package/src/context-error-type.js.map +1 -0
  23. package/src/context-error.d.ts +7 -0
  24. package/src/context-error.d.ts.map +1 -0
  25. package/src/context-error.js +18 -0
  26. package/src/context-error.js.map +1 -0
  27. package/src/context-manager.d.ts +34 -0
  28. package/src/context-manager.d.ts.map +1 -0
  29. package/src/context-manager.js +60 -0
  30. package/src/context-manager.js.map +1 -0
  31. package/src/context.d.ts +45 -0
  32. package/src/context.d.ts.map +1 -0
  33. package/src/context.js +70 -0
  34. package/src/context.js.map +1 -0
  35. package/src/core-i18n.d.ts +63 -0
  36. package/src/core-i18n.d.ts.map +1 -0
  37. package/src/core-i18n.js +478 -0
  38. package/src/core-i18n.js.map +1 -0
  39. package/src/core-string-key.d.ts +43 -0
  40. package/src/core-string-key.d.ts.map +1 -0
  41. package/src/core-string-key.js +51 -0
  42. package/src/core-string-key.js.map +1 -0
  43. package/src/create-translation-adapter.d.ts +21 -0
  44. package/src/create-translation-adapter.d.ts.map +1 -0
  45. package/src/create-translation-adapter.js +37 -0
  46. package/src/create-translation-adapter.js.map +1 -0
  47. package/src/currency-code.d.ts +20 -0
  48. package/src/currency-code.d.ts.map +1 -0
  49. package/src/currency-code.js +37 -0
  50. package/src/currency-code.js.map +1 -0
  51. package/src/{currency-format.ts → currency-format.d.ts} +5 -5
  52. package/src/currency-format.d.ts.map +1 -0
  53. package/src/currency-format.js +3 -0
  54. package/src/currency-format.js.map +1 -0
  55. package/src/currency.d.ts +12 -0
  56. package/src/currency.d.ts.map +1 -0
  57. package/src/currency.js +49 -0
  58. package/src/currency.js.map +1 -0
  59. package/src/default-config.d.ts +33 -0
  60. package/src/default-config.d.ts.map +1 -0
  61. package/src/default-config.js +102 -0
  62. package/src/default-config.js.map +1 -0
  63. package/src/enum-registry.d.ts +45 -0
  64. package/src/enum-registry.d.ts.map +1 -0
  65. package/src/enum-registry.js +103 -0
  66. package/src/enum-registry.js.map +1 -0
  67. package/src/global-active-context.d.ts +51 -0
  68. package/src/global-active-context.d.ts.map +1 -0
  69. package/src/global-active-context.js +179 -0
  70. package/src/global-active-context.js.map +1 -0
  71. package/src/handleable.d.ts +14 -0
  72. package/src/handleable.d.ts.map +1 -0
  73. package/src/handleable.js +66 -0
  74. package/src/handleable.js.map +1 -0
  75. package/src/i-global-active-context.d.ts +23 -0
  76. package/src/i-global-active-context.d.ts.map +1 -0
  77. package/src/i-global-active-context.js +3 -0
  78. package/src/i-global-active-context.js.map +1 -0
  79. package/src/i-handleable-error-options.d.ts +7 -0
  80. package/src/i-handleable-error-options.d.ts.map +1 -0
  81. package/src/i-handleable-error-options.js +3 -0
  82. package/src/i-handleable-error-options.js.map +1 -0
  83. package/src/i-handleable.d.ts +6 -0
  84. package/src/i-handleable.d.ts.map +1 -0
  85. package/src/i-handleable.js +3 -0
  86. package/src/i-handleable.js.map +1 -0
  87. package/src/i18n-config.d.ts +21 -0
  88. package/src/i18n-config.d.ts.map +1 -0
  89. package/src/i18n-config.js +3 -0
  90. package/src/i18n-config.js.map +1 -0
  91. package/src/{i18n-context.ts → i18n-context.d.ts} +7 -7
  92. package/src/i18n-context.d.ts.map +1 -0
  93. package/src/i18n-context.js +3 -0
  94. package/src/i18n-context.js.map +1 -0
  95. package/src/i18n-engine.d.ts +179 -0
  96. package/src/i18n-engine.d.ts.map +1 -0
  97. package/src/i18n-engine.js +355 -0
  98. package/src/i18n-engine.js.map +1 -0
  99. package/src/{index.ts → index.d.ts} +2 -10
  100. package/src/index.d.ts.map +1 -0
  101. package/src/index.js +71 -0
  102. package/src/index.js.map +1 -0
  103. package/src/{language-codes.ts → language-codes.d.ts} +12 -23
  104. package/src/language-codes.d.ts.map +1 -0
  105. package/src/language-codes.js +32 -0
  106. package/src/language-codes.js.map +1 -0
  107. package/src/language-definition.d.ts +14 -0
  108. package/src/language-definition.d.ts.map +1 -0
  109. package/src/language-definition.js +3 -0
  110. package/src/language-definition.js.map +1 -0
  111. package/src/language-registry.d.ts +114 -0
  112. package/src/language-registry.d.ts.map +1 -0
  113. package/src/language-registry.js +217 -0
  114. package/src/language-registry.js.map +1 -0
  115. package/src/plugin-i18n-engine.d.ts +147 -0
  116. package/src/plugin-i18n-engine.d.ts.map +1 -0
  117. package/src/plugin-i18n-engine.js +369 -0
  118. package/src/plugin-i18n-engine.js.map +1 -0
  119. package/src/plugin-translatable-generic-error.d.ts +30 -0
  120. package/src/plugin-translatable-generic-error.d.ts.map +1 -0
  121. package/src/plugin-translatable-generic-error.js +72 -0
  122. package/src/plugin-translatable-generic-error.js.map +1 -0
  123. package/src/plugin-translatable-handleable-generic.d.ts +29 -0
  124. package/src/plugin-translatable-handleable-generic.d.ts.map +1 -0
  125. package/src/plugin-translatable-handleable-generic.js +44 -0
  126. package/src/plugin-translatable-handleable-generic.js.map +1 -0
  127. package/src/plugin-typed-handleable.d.ts +15 -0
  128. package/src/plugin-typed-handleable.d.ts.map +1 -0
  129. package/src/plugin-typed-handleable.js +51 -0
  130. package/src/plugin-typed-handleable.js.map +1 -0
  131. package/src/registry-config.d.ts +15 -0
  132. package/src/registry-config.d.ts.map +1 -0
  133. package/src/registry-config.js +3 -0
  134. package/src/registry-config.js.map +1 -0
  135. package/src/registry-error-type.d.ts +13 -0
  136. package/src/registry-error-type.d.ts.map +1 -0
  137. package/src/registry-error-type.js +17 -0
  138. package/src/registry-error-type.js.map +1 -0
  139. package/src/registry-error.d.ts +19 -0
  140. package/src/registry-error.d.ts.map +1 -0
  141. package/src/registry-error.js +48 -0
  142. package/src/registry-error.js.map +1 -0
  143. package/src/strict-types.d.ts +19 -0
  144. package/src/strict-types.d.ts.map +1 -0
  145. package/src/strict-types.js +18 -0
  146. package/src/strict-types.js.map +1 -0
  147. package/src/template.d.ts +13 -0
  148. package/src/template.d.ts.map +1 -0
  149. package/src/template.js +31 -0
  150. package/src/template.js.map +1 -0
  151. package/src/timezone.d.ts +12 -0
  152. package/src/timezone.d.ts.map +1 -0
  153. package/src/timezone.js +24 -0
  154. package/src/timezone.js.map +1 -0
  155. package/src/translatable.d.ts +6 -0
  156. package/src/translatable.d.ts.map +1 -0
  157. package/src/translatable.js +12 -0
  158. package/src/translatable.js.map +1 -0
  159. package/src/translation-engine.d.ts +9 -0
  160. package/src/translation-engine.d.ts.map +1 -0
  161. package/src/translation-engine.js +3 -0
  162. package/src/translation-engine.js.map +1 -0
  163. package/src/translation-request.d.ts +10 -0
  164. package/src/translation-request.d.ts.map +1 -0
  165. package/src/translation-request.js +3 -0
  166. package/src/translation-request.js.map +1 -0
  167. package/src/translation-response.d.ts +9 -0
  168. package/src/translation-response.d.ts.map +1 -0
  169. package/src/translation-response.js +3 -0
  170. package/src/translation-response.js.map +1 -0
  171. package/src/typed-error.d.ts +73 -0
  172. package/src/typed-error.d.ts.map +1 -0
  173. package/src/typed-error.js +267 -0
  174. package/src/typed-error.js.map +1 -0
  175. package/src/typed-handleable.d.ts +15 -0
  176. package/src/typed-handleable.d.ts.map +1 -0
  177. package/src/typed-handleable.js +46 -0
  178. package/src/typed-handleable.js.map +1 -0
  179. package/src/{types.ts → types.d.ts} +21 -75
  180. package/src/types.d.ts.map +1 -0
  181. package/src/types.js +19 -0
  182. package/src/types.js.map +1 -0
  183. package/src/unified-translator.d.ts +31 -0
  184. package/src/unified-translator.d.ts.map +1 -0
  185. package/src/unified-translator.js +71 -0
  186. package/src/unified-translator.js.map +1 -0
  187. package/src/utils.d.ts +65 -0
  188. package/src/utils.d.ts.map +1 -0
  189. package/src/utils.js +129 -0
  190. package/src/utils.js.map +1 -0
  191. package/src/validation-config.d.ts +12 -0
  192. package/src/validation-config.d.ts.map +1 -0
  193. package/src/validation-config.js +3 -0
  194. package/src/validation-config.js.map +1 -0
  195. package/src/validation-result.d.ts +13 -0
  196. package/src/validation-result.d.ts.map +1 -0
  197. package/src/validation-result.js +3 -0
  198. package/src/validation-result.js.map +1 -0
  199. package/LICENSE +0 -21
  200. package/src/active-context.ts +0 -30
  201. package/src/component-definition.ts +0 -11
  202. package/src/component-registration.ts +0 -13
  203. package/src/component-registry.ts +0 -392
  204. package/src/context-error-type.ts +0 -3
  205. package/src/context-error.ts +0 -16
  206. package/src/context-manager.ts +0 -71
  207. package/src/context.ts +0 -90
  208. package/src/core-i18n.ts +0 -609
  209. package/src/core-string-key.ts +0 -49
  210. package/src/create-translation-adapter.ts +0 -47
  211. package/src/currency-code.ts +0 -35
  212. package/src/currency.ts +0 -52
  213. package/src/default-config.ts +0 -199
  214. package/src/enum-registry.ts +0 -138
  215. package/src/global-active-context.ts +0 -255
  216. package/src/handleable.ts +0 -79
  217. package/src/i-global-active-context.ts +0 -59
  218. package/src/i-handleable-error-options.ts +0 -6
  219. package/src/i-handleable.ts +0 -5
  220. package/src/i18n-config.ts +0 -29
  221. package/src/i18n-engine.ts +0 -491
  222. package/src/language-definition.ts +0 -13
  223. package/src/language-registry.ts +0 -292
  224. package/src/plugin-i18n-engine.ts +0 -520
  225. package/src/plugin-translatable-generic-error.ts +0 -106
  226. package/src/plugin-translatable-handleable-generic.ts +0 -60
  227. package/src/plugin-typed-handleable.ts +0 -77
  228. package/src/registry-config.ts +0 -15
  229. package/src/registry-error-type.ts +0 -12
  230. package/src/registry-error.ts +0 -74
  231. package/src/strict-types.ts +0 -35
  232. package/src/template.ts +0 -63
  233. package/src/timezone.ts +0 -20
  234. package/src/translatable.ts +0 -15
  235. package/src/translation-engine.ts +0 -8
  236. package/src/translation-request.ts +0 -12
  237. package/src/translation-response.ts +0 -8
  238. package/src/typed-error.ts +0 -384
  239. package/src/typed-handleable.ts +0 -70
  240. package/src/unified-translator.ts +0 -96
  241. package/src/utils.ts +0 -213
  242. package/src/validation-config.ts +0 -11
  243. package/src/validation-result.ts +0 -12
package/src/utils.ts DELETED
@@ -1,213 +0,0 @@
1
- import moment from 'moment-timezone';
2
-
3
- /**
4
- * Replaces variables in a string with their corresponding values from vars or constants.
5
- * @param str - The string containing variables to replace
6
- * @param vars - An object mapping variable names to their replacement values
7
- * @param constants - An object containing constant values for replacement
8
- * @returns The string with variables replaced
9
- */
10
- export function replaceVariables(
11
- str: string,
12
- vars?: Record<string, string | number>,
13
- constants?: any,
14
- ): string {
15
- // Ensure input is a string
16
- if (typeof str !== 'string') {
17
- str = String(str);
18
- }
19
-
20
- const variables = str.match(/\{(.+?)\}/g);
21
- if (!variables) return str;
22
-
23
- let result = str;
24
- for (const variable of variables) {
25
- const varName = variable.slice(1, -1);
26
- let replacement = '';
27
-
28
- if (vars && varName in vars) {
29
- replacement = String(vars[varName]);
30
- } else if (constants && varName in constants) {
31
- replacement = String(constants[varName]);
32
- }
33
-
34
- if (replacement) {
35
- result = result.replace(variable, replacement);
36
- }
37
- }
38
-
39
- return result;
40
- }
41
-
42
- /**
43
- * Checks if a given key indicates a template string.
44
- * @param key - The key to check
45
- * @returns True if the key indicates a template, false otherwise
46
- */
47
- export function isTemplate(key: string): boolean {
48
- return key.trim().toLowerCase().endsWith('template');
49
- }
50
-
51
- /**
52
- * Checks if a given timezone string is valid.
53
- * @param timezone - The timezone string to validate
54
- * @returns
55
- */
56
- export function isValidTimezone(timezone: string): boolean {
57
- return moment.tz.zone(timezone) !== null;
58
- }
59
-
60
- /**
61
- * Converts parts to a single string key, joining with underscores.
62
- * @param parts - The parts to join
63
- * @returns The joined string key
64
- */
65
- export function toStringKey<TStringKey extends string>(
66
- ...parts: string[]
67
- ): TStringKey {
68
- return parts.join('_') as TStringKey;
69
- }
70
-
71
- /**
72
- * Converts an enum value to a string key by joining parts with underscores and appending the enum value.
73
- * @param value - The enum value
74
- * @param parts - Additional parts to join
75
- * @returns The constructed string key
76
- */
77
- export function toStringKeyFromEnum<TStringKey extends string>(
78
- value: string,
79
- ...parts: string[]
80
- ): TStringKey {
81
- const allParts = [...parts, value];
82
- return allParts.join('_') as TStringKey;
83
- }
84
-
85
- /**
86
- * Type that constructs string keys from enum values with prefixes and optional template suffix
87
- */
88
- type BuildStringKey<
89
- TEnumValue extends string,
90
- TPrefixes extends readonly string[],
91
- TIsTemplate extends boolean = false,
92
- > = TPrefixes extends readonly []
93
- ? `${TEnumValue}${TIsTemplate extends true ? 'Template' : ''}`
94
- : TPrefixes extends readonly [infer First, ...infer Rest]
95
- ? First extends string
96
- ? Rest extends readonly string[]
97
- ? `${First}_${BuildStringKey<TEnumValue, Rest, TIsTemplate>}`
98
- : never
99
- : never
100
- : never;
101
-
102
- /**
103
- * Type that maps all enum values to their corresponding string keys
104
- */
105
- type ReasonMapFromEnum<
106
- TEnum extends Record<string, string>,
107
- TStringKey extends string,
108
- TPrefixes extends readonly string[] = [],
109
- TTemplateKeys extends Set<TEnum[keyof TEnum]> = never,
110
- > = {
111
- [K in TEnum[keyof TEnum]]: BuildStringKey<
112
- K,
113
- TPrefixes,
114
- TTemplateKeys extends Set<K> ? true : false
115
- > extends TStringKey
116
- ? BuildStringKey<K, TPrefixes, TTemplateKeys extends Set<K> ? true : false>
117
- : never;
118
- };
119
-
120
- /**
121
- * Builds a reason map from an enum object, mapping each enum value to a string key.
122
- * @param enumObj - The enum object
123
- * @param prefixes - Prefixes to prepend to each string key
124
- * @param templateKeys - Optional set of enum values that should have 'Template' suffix for template processing
125
- * @returns The constructed reason map
126
- */
127
- export function buildReasonMap<
128
- TEnum extends Record<string, string>,
129
- TStringKey extends string,
130
- >(
131
- enumObj: TEnum,
132
- prefixes: string[] = [],
133
- templateKeys?: Set<TEnum[keyof TEnum]>,
134
- ): Record<TEnum[keyof TEnum], TStringKey> {
135
- const map = {} as Record<TEnum[keyof TEnum], TStringKey>;
136
-
137
- Object.values(enumObj).forEach((value) => {
138
- const baseKey = [...prefixes, value].join('_');
139
- const finalKey = templateKeys?.has(value as TEnum[keyof TEnum])
140
- ? baseKey + 'Template'
141
- : baseKey;
142
- map[value as TEnum[keyof TEnum]] = finalKey as TStringKey;
143
- });
144
-
145
- return map;
146
- }
147
-
148
- /**
149
- * Type-safe version of buildReasonMap that ensures all enum values are mapped and all string keys exist
150
- */
151
- export function buildTypeSafeReasonMap<
152
- TEnum extends Record<string, string>,
153
- TStringKey extends string,
154
- TPrefixes extends readonly string[] = [],
155
- TTemplateKeys extends Set<TEnum[keyof TEnum]> = never,
156
- >(
157
- enumObj: TEnum,
158
- prefixes: TPrefixes,
159
- templateKeys?: TTemplateKeys,
160
- ): ReasonMapFromEnum<TEnum, TStringKey, TPrefixes, TTemplateKeys> {
161
- const map = {} as any;
162
-
163
- Object.values(enumObj).forEach((value) => {
164
- const baseKey = [...prefixes, value].join('_');
165
- const finalKey = templateKeys?.has(value as TEnum[keyof TEnum])
166
- ? baseKey + 'Template'
167
- : baseKey;
168
- map[value as TEnum[keyof TEnum]] = finalKey;
169
- });
170
-
171
- return map;
172
- }
173
-
174
- /**
175
- * Validates that a reason map has entries for all enum values
176
- */
177
- export function validateReasonMap<
178
- TEnum extends Record<string, string>,
179
- TStringKey extends string,
180
- >(
181
- enumObj: TEnum,
182
- reasonMap: Partial<Record<TEnum[keyof TEnum], TStringKey>>,
183
- ): reasonMap is Record<TEnum[keyof TEnum], TStringKey> {
184
- return Object.values(enumObj).every(
185
- (value) =>
186
- value in reasonMap &&
187
- reasonMap[value as TEnum[keyof TEnum]] !== undefined,
188
- );
189
- }
190
-
191
- /**
192
- * Creates a complete reason map ensuring all enum values are covered
193
- */
194
- export function createCompleteReasonMap<
195
- TEnum extends Record<string, string>,
196
- TStringKey extends string,
197
- >(
198
- enumObj: TEnum,
199
- prefixes: readonly string[] = [],
200
- templateKeys?: Set<TEnum[keyof TEnum]>,
201
- ): Record<TEnum[keyof TEnum], TStringKey> {
202
- const map = buildReasonMap(enumObj, [...prefixes], templateKeys) as Record<
203
- TEnum[keyof TEnum],
204
- TStringKey
205
- >;
206
-
207
- if (!validateReasonMap(enumObj, map)) {
208
- const missing = Object.values(enumObj).filter((value) => !(value in map));
209
- throw new Error(`Missing reason map entries for: ${missing.join(', ')}`);
210
- }
211
-
212
- return map;
213
- }
@@ -1,11 +0,0 @@
1
- /**
2
- * Configuration for component registration validation
3
- */
4
- export interface ValidationConfig {
5
- /** Whether to require all languages to have all strings */
6
- readonly requireCompleteStrings: boolean;
7
- /** Whether to allow registration with missing strings (will use fallbacks) */
8
- readonly allowPartialRegistration: boolean;
9
- /** Default language to fall back to for missing strings */
10
- readonly fallbackLanguageId: string;
11
- }
@@ -1,12 +0,0 @@
1
- /**
2
- * Validation result for component registration
3
- */
4
- export interface ValidationResult {
5
- readonly isValid: boolean;
6
- readonly missingKeys: ReadonlyArray<{
7
- readonly languageId: string;
8
- readonly componentId: string;
9
- readonly stringKey: string;
10
- }>;
11
- readonly errors: readonly string[];
12
- }