gt-vue 0.1.0-iris.2 → 0.1.1

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # gt-vue
 
+## 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
+
+- [#2012](https://github.com/generaltranslation/gt/pull/2012) [`8d376e2`](https://github.com/generaltranslation/gt/commit/8d376e23c80828dfd8756e2f0fbf0f7725e0f178) Thanks [@eoinest](https://github.com/eoinest)! - Add a lightweight Vue 3 runtime with catalog-backed string and rich-content
+  translation, cookie-backed reactive locale switching, child-only variables,
+  and typed value props for number, currency, and date formatting. Browser SPAs
+  restore the locale from a configurable cookie, while an explicit server locale
+  wins during SSR hydration.
+
+### Patch Changes
+
+- [#2068](https://github.com/generaltranslation/gt/pull/2068) [`f2204b9`](https://github.com/generaltranslation/gt/commit/f2204b990278865c54d14d337392930ea1ec31bf) Thanks [@eoinest](https://github.com/eoinest)! - Translate statically authored custom-component default slots, preserve authored
+  Fragments, and align Branch and Plural wire values, rendering fallbacks, and
+  locale selection with React. Add React-compatible `context`, `id`, `maxChars`,
+  and `requiresReview` metadata to `<T>`, including compiler-facing `$` aliases.
+
+- [#2080](https://github.com/generaltranslation/gt/pull/2080) [`5d8b78a`](https://github.com/generaltranslation/gt/commit/5d8b78a1085d5dadc5bdc7435b3c6addf8981c38) Thanks [@eoinest](https://github.com/eoinest)! - Migrate the package license from FSL-1.1-ALv2 to MIT.
+
+- [#2090](https://github.com/generaltranslation/gt/pull/2090) [`95b48df`](https://github.com/generaltranslation/gt/commit/95b48df677d27f41a336f13e01ae7aa9aa484c73) Thanks [@eoinest](https://github.com/eoinest)! - Add browser SPA initialization and synchronous module-level `t()` translations
+  to gt-vue.
+- Updated dependencies [[`f2204b9`](https://github.com/generaltranslation/gt/commit/f2204b990278865c54d14d337392930ea1ec31bf), [`b05b470`](https://github.com/generaltranslation/gt/commit/b05b4703fbbfd34a3cbee335c786e2e606346167), [`8d376e2`](https://github.com/generaltranslation/gt/commit/8d376e23c80828dfd8756e2f0fbf0f7725e0f178)]:
+  - @generaltranslation/format@0.1.8
+  - generaltranslation@9.1.7
+  - gt-i18n@1.0.17
+
 ## 0.1.0-iris.2
 
 ### Patch Changes

package/README.md

@@ -87,8 +87,8 @@ applied.
 ## Module-level translations in a Vite SPA
 
 Browser-only SPAs can call `t()` at module scope after `initializeGTSPA()` has
-loaded the active locale. Use a bootstrap module with top-level `await`, and
-dynamically import the rest of the application only after initialization.
+loaded the active locale. Use an async bootstrap function, and dynamically
+import the rest of the application only after initialization.
 This complements rather than replaces the `gt()` callback from `useGT()`,
 which remains the normal API inside Vue components and for SSR applications.
 
@@ -98,9 +98,15 @@ import { initializeGTSPA } from 'gt-vue';
 import gtConfig from '../gt.config.json';
 import loadTranslations from './loadTranslations';
 
-const gt = await initializeGTSPA({ ...gtConfig, loadTranslations });
-const { mount } = await import('./main');
-mount(gt);
+async function bootstrap() {
+  const gt = await initializeGTSPA({ ...gtConfig, loadTranslations });
+  const { mount } = await import('./main');
+  mount(gt);
+}
+
+void bootstrap().catch((error: unknown) => {
+  console.error(error);
+});
 ```
 
 Configure the CLI output and the Vite loader to use the same directory:
@@ -245,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;