@backstage/core-app-api 1.10.0-next.0 → 1.10.0-next.2

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # @backstage/core-app-api
 
+## 1.10.0-next.2
+
+### Minor Changes
+
+- 6e30769cc627: Introduced experimental support for internationalization.
+
+### Patch Changes
+
+- 8cec7664e146: Removed `@types/node` dependency
+- Updated dependencies
+  - @backstage/core-plugin-api@1.6.0-next.2
+  - @backstage/config@1.1.0-next.1
+  - @backstage/types@1.1.0
+  - @backstage/version-bridge@1.0.4
+
+## 1.10.0-next.1
+
+### Patch Changes
+
+- Updated dependencies
+  - @backstage/config@1.1.0-next.0
+  - @backstage/core-plugin-api@1.6.0-next.1
+  - @backstage/types@1.1.0
+  - @backstage/version-bridge@1.0.4
+
 ## 1.10.0-next.0
 
 ### Minor Changes

package/alpha/package.json

@@ -0,0 +1,7 @@
+{
+  "name": "@backstage/core-app-api",
+  "version": "1.10.0-next.2",
+  "main": "../dist/alpha.esm.js",
+  "module": "../dist/alpha.esm.js",
+  "types": "../dist/alpha.d.ts"
+}

package/dist/alpha.d.ts

@@ -0,0 +1,49 @@
+import { TranslationRef, AppTranslationApi } from '@backstage/core-plugin-api/alpha';
+import { i18n } from 'i18next';
+
+/** @alpha */
+type ExperimentalI18n = {
+    supportedLanguages: string[];
+    fallbackLanguage?: string | string[];
+    messages?: Array<{
+        ref: TranslationRef;
+        messages?: TranslationMessages<TranslationRef>;
+        lazyMessages: Record<string, () => Promise<{
+            messages: TranslationMessages<TranslationRef>;
+        }>>;
+    }>;
+};
+/** @alpha */
+declare class AppTranslationApiImpl implements AppTranslationApi {
+    private readonly i18n;
+    static create(options?: ExperimentalI18n): AppTranslationApiImpl;
+    private readonly cache;
+    private readonly lazyCache;
+    getI18n(): i18n;
+    initMessages(options?: ExperimentalI18n): void;
+    addResourcesByRef<Messages extends Record<string, string>>(translationRef: TranslationRef<Messages>): void;
+    addResources<Messages extends Record<string, string>>(translationRef: TranslationRef<Messages>, initResources?: TranslationMessages<TranslationRef<Messages>>): void;
+    addLazyResources<Messages extends Record<string, string>>(translationRef: TranslationRef<Messages>, initResources?: Record<string, () => Promise<{
+        messages: TranslationMessages<TranslationRef>;
+    }>>): void;
+    private constructor();
+}
+
+/** @alpha */
+type TranslationMessages<T> = T extends TranslationRef<infer R> ? Record<string, Partial<R>> : never;
+/** @alpha */
+declare function createTranslationResource<T extends TranslationRef>(options: {
+    ref: T;
+    messages?: TranslationMessages<T>;
+    lazyMessages: Record<string, () => Promise<{
+        messages: TranslationMessages<T>;
+    }>>;
+}): {
+    ref: T;
+    messages?: TranslationMessages<T> | undefined;
+    lazyMessages: Record<string, () => Promise<{
+        messages: TranslationMessages<T>;
+    }>>;
+};
+
+export { AppTranslationApiImpl, ExperimentalI18n, TranslationMessages, createTranslationResource };

package/dist/alpha.esm.js

@@ -0,0 +1,11 @@
+export { A as AppTranslationApiImpl } from './esm/AppTranslationImpl-8560b672.esm.js';
+import 'i18next';
+import 'react-i18next';
+import 'i18next-browser-languagedetector';
+
+function createTranslationResource(options) {
+  return options;
+}
+
+export { createTranslationResource };
+//# sourceMappingURL=alpha.esm.js.map

package/dist/alpha.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alpha.esm.js","sources":["../src/app/TranslationResource.ts"],"sourcesContent":["/*\n * Copyright 2023 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { TranslationRef } from '@backstage/core-plugin-api/alpha';\n\n/** @alpha */\nexport type TranslationMessages<T> = T extends TranslationRef<infer R>\n  ? Record<string, Partial<R>>\n  : never;\n\n/** @alpha */\nexport function createTranslationResource<T extends TranslationRef>(options: {\n  ref: T;\n  messages?: TranslationMessages<T>;\n  lazyMessages: Record<\n    string,\n    () => Promise<{ messages: TranslationMessages<T> }>\n  >;\n}) {\n  return options;\n}\n"],"names":[],"mappings":";;;;;AAwBO,SAAS,0BAAoD,OAOjE,EAAA;AACD,EAAO,OAAA,OAAA,CAAA;AACT;;;;"}

package/dist/esm/AppTranslationImpl-8560b672.esm.js

@@ -0,0 +1,132 @@
+import i18next from 'i18next';
+import { initReactI18next } from 'react-i18next';
+import LanguageDetector from 'i18next-browser-languagedetector';
+
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+class AppTranslationApiImpl {
+  constructor(i18n, options) {
+    this.i18n = i18n;
+    __publicField(this, "cache", /* @__PURE__ */ new WeakSet());
+    __publicField(this, "lazyCache", /* @__PURE__ */ new WeakMap());
+    this.initMessages(options);
+  }
+  static create(options) {
+    const i18n = i18next.createInstance().use(initReactI18next);
+    i18n.use(LanguageDetector);
+    i18n.init({
+      fallbackLng: (options == null ? void 0 : options.fallbackLanguage) || "en",
+      supportedLngs: (options == null ? void 0 : options.supportedLanguages) || ["en"],
+      interpolation: {
+        escapeValue: false
+      },
+      react: {
+        bindI18n: "loaded languageChanged"
+      }
+    });
+    return new AppTranslationApiImpl(i18n, options);
+  }
+  getI18n() {
+    return this.i18n;
+  }
+  initMessages(options) {
+    var _a;
+    if ((_a = options == null ? void 0 : options.messages) == null ? void 0 : _a.length) {
+      options.messages.forEach((appMessage) => {
+        if (appMessage.messages) {
+          this.addResources(appMessage.ref, appMessage.messages);
+        }
+        if (appMessage.lazyMessages) {
+          this.addLazyResources(appMessage.ref, appMessage.lazyMessages);
+        }
+      });
+    }
+  }
+  addResourcesByRef(translationRef) {
+    this.addResources(translationRef);
+    this.addLazyResources(translationRef);
+  }
+  addResources(translationRef, initResources) {
+    const resources = initResources || translationRef.getResources();
+    if (!resources || this.cache.has(translationRef)) {
+      return;
+    }
+    this.cache.add(translationRef);
+    Object.entries(resources).forEach(([language, messages]) => {
+      this.i18n.addResourceBundle(
+        language,
+        translationRef.getId(),
+        messages,
+        true,
+        false
+      );
+    });
+  }
+  addLazyResources(translationRef, initResources) {
+    let cache = this.lazyCache.get(translationRef);
+    if (!cache) {
+      cache = /* @__PURE__ */ new Set();
+      this.lazyCache.set(translationRef, cache);
+    }
+    const {
+      language: currentLanguage,
+      services,
+      options,
+      addResourceBundle,
+      reloadResources
+    } = this.i18n;
+    if (cache.has(currentLanguage)) {
+      return;
+    }
+    const namespace = translationRef.getId();
+    const lazyResources = initResources || translationRef.getLazyResources();
+    const fallbackLanguages = services.languageUtils.getFallbackCodes(
+      options.fallbackLng,
+      currentLanguage
+    );
+    Promise.allSettled(
+      [...fallbackLanguages, currentLanguage].map(addLanguage)
+    ).then((results) => {
+      if (results.some((result) => result.status === "fulfilled")) {
+        this.i18n.emit("loaded");
+      }
+    });
+    async function addLanguage(language) {
+      var _a;
+      if (cache.has(language)) {
+        return;
+      }
+      cache.add(language);
+      let loadBackend;
+      if ((_a = services.backendConnector) == null ? void 0 : _a.backend) {
+        loadBackend = reloadResources([language], [namespace]);
+      }
+      const loadLazyResources = lazyResources == null ? void 0 : lazyResources[language];
+      if (!loadLazyResources) {
+        await loadBackend;
+        return;
+      }
+      const [result] = await Promise.allSettled([
+        loadLazyResources(),
+        loadBackend
+      ]);
+      if (result.status === "rejected") {
+        throw result.reason;
+      }
+      addResourceBundle(
+        language,
+        namespace,
+        result.value.messages,
+        true,
+        false
+      );
+    }
+  }
+}
+
+export { AppTranslationApiImpl as A };
+//# sourceMappingURL=AppTranslationImpl-8560b672.esm.js.map

package/dist/esm/AppTranslationImpl-8560b672.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppTranslationImpl-8560b672.esm.js","sources":["../../src/apis/implementations/AppTranslationApi/AppTranslationImpl.ts"],"sourcesContent":["/*\n * Copyright 2023 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  AppTranslationApi,\n  TranslationRef,\n} from '@backstage/core-plugin-api/alpha';\nimport i18next, { type i18n } from 'i18next';\nimport { initReactI18next } from 'react-i18next';\nimport LanguageDetector from 'i18next-browser-languagedetector';\n\nimport { TranslationMessages } from '../../../alpha';\n\n/** @alpha */\nexport type ExperimentalI18n = {\n  supportedLanguages: string[];\n  fallbackLanguage?: string | string[];\n  messages?: Array<{\n    ref: TranslationRef;\n    messages?: TranslationMessages<TranslationRef>;\n    lazyMessages: Record<\n      string,\n      () => Promise<{ messages: TranslationMessages<TranslationRef> }>\n    >;\n  }>;\n};\n\n/** @alpha */\nexport class AppTranslationApiImpl implements AppTranslationApi {\n  static create(options?: ExperimentalI18n) {\n    const i18n = i18next.createInstance().use(initReactI18next);\n\n    i18n.use(LanguageDetector);\n\n    i18n.init({\n      fallbackLng: options?.fallbackLanguage || 'en',\n      supportedLngs: options?.supportedLanguages || ['en'],\n      interpolation: {\n        escapeValue: false,\n      },\n      react: {\n        bindI18n: 'loaded languageChanged',\n      },\n    });\n\n    return new AppTranslationApiImpl(i18n, options);\n  }\n\n  private readonly cache = new WeakSet<TranslationRef>();\n  private readonly lazyCache = new WeakMap<TranslationRef, Set<string>>();\n\n  getI18n() {\n    return this.i18n;\n  }\n\n  initMessages(options?: ExperimentalI18n) {\n    if (options?.messages?.length) {\n      options.messages.forEach(appMessage => {\n        if (appMessage.messages) {\n          this.addResources(appMessage.ref, appMessage.messages);\n        }\n\n        if (appMessage.lazyMessages) {\n          this.addLazyResources(appMessage.ref, appMessage.lazyMessages);\n        }\n      });\n    }\n  }\n\n  addResourcesByRef<Messages extends Record<string, string>>(\n    translationRef: TranslationRef<Messages>,\n  ): void {\n    this.addResources(translationRef);\n    this.addLazyResources(translationRef);\n  }\n\n  addResources<Messages extends Record<string, string>>(\n    translationRef: TranslationRef<Messages>,\n    initResources?: TranslationMessages<TranslationRef<Messages>>,\n  ) {\n    const resources = initResources || translationRef.getResources();\n    if (!resources || this.cache.has(translationRef)) {\n      return;\n    }\n    this.cache.add(translationRef);\n    Object.entries(resources).forEach(([language, messages]) => {\n      this.i18n.addResourceBundle(\n        language,\n        translationRef.getId(),\n        messages,\n        true,\n        false,\n      );\n    });\n  }\n\n  addLazyResources<Messages extends Record<string, string>>(\n    translationRef: TranslationRef<Messages>,\n    initResources?: Record<\n      string,\n      () => Promise<{ messages: TranslationMessages<TranslationRef> }>\n    >,\n  ) {\n    let cache = this.lazyCache.get(translationRef);\n\n    if (!cache) {\n      cache = new Set();\n      this.lazyCache.set(translationRef, cache);\n    }\n\n    const {\n      language: currentLanguage,\n      services,\n      options,\n      addResourceBundle,\n      reloadResources,\n    } = this.i18n;\n\n    if (cache.has(currentLanguage)) {\n      return;\n    }\n\n    const namespace = translationRef.getId();\n    const lazyResources = initResources || translationRef.getLazyResources();\n\n    const fallbackLanguages = services.languageUtils.getFallbackCodes(\n      options.fallbackLng,\n      currentLanguage,\n    ) as string[];\n\n    Promise.allSettled(\n      [...fallbackLanguages, currentLanguage].map(addLanguage),\n    ).then(results => {\n      if (results.some(result => result.status === 'fulfilled')) {\n        this.i18n.emit('loaded');\n      }\n    });\n\n    async function addLanguage(language: string) {\n      if (cache!.has(language)) {\n        return;\n      }\n\n      cache!.add(language);\n\n      let loadBackend: Promise<void> | undefined;\n\n      if (services.backendConnector?.backend) {\n        loadBackend = reloadResources([language], [namespace]);\n      }\n\n      const loadLazyResources = lazyResources?.[language];\n\n      if (!loadLazyResources) {\n        await loadBackend;\n        return;\n      }\n\n      const [result] = await Promise.allSettled([\n        loadLazyResources(),\n        loadBackend,\n      ]);\n\n      if (result.status === 'rejected') {\n        throw result.reason;\n      }\n\n      addResourceBundle(\n        language,\n        namespace,\n        result.value.messages,\n        true,\n        false,\n      );\n    }\n  }\n\n  private constructor(private readonly i18n: i18n, options?: ExperimentalI18n) {\n    this.initMessages(options);\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -6,6 +6,7 @@ import * as _backstage_types from '@backstage/types';
 import { Observable, JsonValue } from '@backstage/types';
 import { Config, AppConfig } from '@backstage/config';
 export { ConfigReader } from '@backstage/config';
+import { TranslationRef } from '@backstage/core-plugin-api/alpha';
 
 /**
  * Prop types for the ApiProvider component.
@@ -802,6 +803,13 @@ type TargetRouteMap<ExternalRoutes extends {
 type AppRouteBinder = <ExternalRoutes extends {
     [name: string]: ExternalRouteRef;
 }>(externalRoutes: ExternalRoutes, targetRoutes: PartialKeys<TargetRouteMap<ExternalRoutes>, KeysWithType<ExternalRoutes, ExternalRouteRef<any, true>>>) => void;
+/**
+ * TODO: To be remove when TranslationMessages in packages/core-app-api/src/app/TranslationResource.ts
+ * come to be public
+ *
+ * @ignore
+ * */
+type TranslationMessages<T> = T extends TranslationRef<infer R> ? Record<string, Partial<R>> : never;
 /**
  * The options accepted by {@link createSpecializedApp}.
  *
@@ -900,6 +908,21 @@ type AppOptions = {
     bindRoutes?(context: {
         bind: AppRouteBinder;
     }): void;
+    /**
+     * TODO: Change to ExperimentalI18n type when packages/core-app-api/src/apis/implementations/AppTranslationApi/AppTranslationImpl.ts
+     * become to public
+     */
+    __experimentalI18n?: {
+        supportedLanguages: string[];
+        fallbackLanguage?: string | string[];
+        messages?: Array<{
+            ref: TranslationRef;
+            messages?: TranslationMessages<TranslationRef>;
+            lazyMessages: Record<string, () => Promise<{
+                messages: TranslationMessages<TranslationRef>;
+            }>>;
+        }>;
+    };
 };
 /**
  * The public API of the output of {@link createSpecializedApp}.

package/dist/index.esm.js

@@ -8,7 +8,12 @@ import { ConfigReader } from '@backstage/config';
 export { ConfigReader } from '@backstage/config';
 import { createRoutesFromChildren, Route, useLocation, matchRoutes, Routes, generatePath, useRoutes } from 'react-router-dom';
 import useAsync from 'react-use/lib/useAsync';
+import { appTranslationApiRef } from '@backstage/core-plugin-api/alpha';
 import useObservable from 'react-use/lib/useObservable';
+import { I18nextProvider } from 'react-i18next';
+import { A as AppTranslationApiImpl } from './esm/AppTranslationImpl-8560b672.esm.js';
+import 'i18next';
+import 'i18next-browser-languagedetector';
 
 var __defProp$l = Object.defineProperty;
 var __defNormalProp$l = (obj, key, value) => key in obj ? __defProp$l(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
@@ -3179,6 +3184,12 @@ function resolveRouteBindings(bindRoutes) {
   return result;
 }
 
+function AppTranslationProvider({ children }) {
+  const appTranslationAPi = useApi(appTranslationApiRef);
+  const i18n = appTranslationAPi.getI18n();
+  return /* @__PURE__ */ React.createElement(I18nextProvider, { i18n }, children);
+}
+
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => {
@@ -3294,6 +3305,7 @@ class AppManager {
     __publicField(this, "configLoader");
     __publicField(this, "defaultApis");
     __publicField(this, "bindRoutes");
+    __publicField(this, "appTranslationApi");
     __publicField(this, "appIdentityProxy", new AppIdentityProxy());
     __publicField(this, "apiFactoryRegistry");
     __privateAdd(this, _getProviderCalled, false);
@@ -3308,6 +3320,9 @@ class AppManager {
     this.defaultApis = (_e = options.defaultApis) != null ? _e : [];
     this.bindRoutes = options.bindRoutes;
     this.apiFactoryRegistry = new ApiFactoryRegistry();
+    this.appTranslationApi = AppTranslationApiImpl.create(
+      options.__experimentalI18n
+    );
   }
   getPlugins() {
     return Array.from(this.plugins);
@@ -3421,7 +3436,7 @@ class AppManager {
         }
       }
       const { ThemeProvider = AppThemeProvider } = this.components;
-      return /* @__PURE__ */ React.createElement(ApiProvider, { apis: this.getApiHolder() }, /* @__PURE__ */ React.createElement(AppContextProvider, { appContext }, /* @__PURE__ */ React.createElement(ThemeProvider, null, /* @__PURE__ */ React.createElement(
+      return /* @__PURE__ */ React.createElement(ApiProvider, { apis: this.getApiHolder() }, /* @__PURE__ */ React.createElement(AppContextProvider, { appContext }, /* @__PURE__ */ React.createElement(AppTranslationProvider, null, /* @__PURE__ */ React.createElement(ThemeProvider, null, /* @__PURE__ */ React.createElement(
         RoutingProvider,
         {
           routePaths: routing.paths,
@@ -3440,7 +3455,7 @@ class AppManager {
           },
           children
         )
-      ))));
+      )))));
     };
     return Provider;
   }
@@ -3484,6 +3499,11 @@ class AppManager {
       deps: {},
       factory: () => this.appIdentityProxy
     });
+    this.apiFactoryRegistry.register("static", {
+      api: appTranslationApiRef,
+      deps: {},
+      factory: () => this.appTranslationApi
+    });
     this.apiFactoryRegistry.register("default", {
       api: featureFlagsApiRef,
       deps: {},