gt-vue 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # gt-vue
 
+## 0.1.2
+
+### Patch Changes
+
+- Updated dependencies [[`34845f9`](https://github.com/generaltranslation/gt/commit/34845f92d64fd9c94a712e4710e8958022066b7b)]:
+  - generaltranslation@9.1.8
+  - gt-i18n@1.0.18
+
+## 0.1.1
+
+### Patch Changes
+
+- [#2130](https://github.com/generaltranslation/gt/pull/2130) [`b25c1d8`](https://github.com/generaltranslation/gt/commit/b25c1d87def728352d3dc089d954ef48bb3bd40e) Thanks [@eoinest](https://github.com/eoinest)! - Support custom locale mappings in request-scoped `createGT()` plugins.
+
 ## 0.1.0
 
 ### Minor Changes

package/README.md

@@ -251,6 +251,19 @@ and then the default locale. Inside `<T>`, the rich translation pipeline owns
 formatting locales: source fallbacks use the default locale, while translated
 content uses the active locale followed by the default.
 
+Pass `customMapping` to `createGT()` when a catalog uses a locale alias that
+should format with a canonical locale. The alias remains the catalog loader,
+cache, and cookie value; only formatters and plural rules use the mapped code.
+
+```ts
+const gt = createGT({
+  defaultLocale: 'en-US',
+  locale: 'pirate',
+  customMapping: { pirate: { code: 'fr-FR' } },
+  loadTranslations,
+});
+```
+
 In a browser, gt-vue persists the active locale in the
 `generaltranslation.locale` path-wide session cookie. When `locale` is omitted
 from `createGT()`, that cookie wins over `defaultLocale`. Use

package/dist/index.cjs

@@ -33,7 +33,7 @@ const gtContextKey = Symbol.for("generaltranslation.gt-vue.context");
 function createGT(options = {}) {
 	return createGTRuntime(options).plugin;
 }
-function createGTRuntime({ defaultLocale = generaltranslation_internal.libraryDefaultLocale, loadTranslations, locale: explicitLocale, localeCookieName = gt_i18n_internal_cookies.defaultLocaleCookieName } = {}, runtimeOptions = {}) {
+function createGTRuntime({ customMapping, defaultLocale = generaltranslation_internal.libraryDefaultLocale, loadTranslations, locale: explicitLocale, localeCookieName = gt_i18n_internal_cookies.defaultLocaleCookieName } = {}, runtimeOptions = {}) {
 	const localeAccessor = createCookieBackedLocale({
 		defaultLocale,
 		locale: explicitLocale,
@@ -45,6 +45,7 @@ function createGTRuntime({ defaultLocale = generaltranslation_internal.libraryDe
 	const pending = /* @__PURE__ */ new Map();
 	const initialLocale = localeAccessor.getLocale();
 	const getLocale = runtimeOptions.pinLocale ? () => initialLocale : () => localeAccessor.getLocale();
+	const resolveFormattingLocale = runtimeOptions.resolveFormattingLocale ?? createFormattingLocaleResolver(customMapping);
 	let localeRequest = 0;
 	const load = async (locale) => {
 		const targetLocale = runtimeOptions.resolveLocale?.(locale) ?? locale;
@@ -92,7 +93,7 @@ function createGTRuntime({ defaultLocale = generaltranslation_internal.libraryDe
 			return getLocale();
 		},
 		loadTranslations: load,
-		resolveFormattingLocale: runtimeOptions.resolveFormattingLocale,
+		resolveFormattingLocale,
 		revision,
 		setLocale
 	};
@@ -109,6 +110,18 @@ function createGTRuntime({ defaultLocale = generaltranslation_internal.libraryDe
 		state
 	};
 }
+function createFormattingLocaleResolver(customMapping) {
+	if (customMapping === void 0) return void 0;
+	return (locale) => {
+		const customLocale = customMapping[locale];
+		const mappedLocale = typeof customLocale === "object" && customLocale !== null && typeof customLocale.code === "string" ? customLocale.code : locale;
+		try {
+			return Intl.getCanonicalLocales(mappedLocale)[0] ?? locale;
+		} catch {
+			return locale;
+		}
+	};
+}
 function useGTState() {
 	const state = (0, vue.inject)(gtContextKey);
 	if (state) return state;