@red-hat-developer-hub/backstage-plugin-translations 0.3.1 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @red-hat-developer-hub/backstage-plugin-translations
 
+## 0.5.0
+
+### Minor Changes
+
+- 71cd222: Backstage version bump to v1.54.6
+
+## 0.4.0
+
+### Minor Changes
+
+- 838a80d: Add NFS (New Frontend System) support and graduate to stable. NFS extensions include PageBlueprint, ApiBlueprint, TranslationBlueprint, and AppRootWrapperBlueprint. OFS exports are now available at `./legacy`.
+- 6456930: Add pseudo-localization support using `i18next-pseudo` to help identify untranslated or hardcoded strings in the UI. Strings are transformed with diacritical marks and brackets (e.g., `"Settings"` → `"[Ṣḛḛţţḭḭṇḡṡ]"`). Activate via `?pseudolocalization=true` URL parameter or `i18n.pseudolocalization.enabled: true` in app-config. Includes a `PseudoLocalizationProvider` component for use as a dynamic plugin at the `application/provider` mount point.
+- 772a1a6: Backstage version bump to v1.52.1
+
 ## 0.3.1
 
 ### Patch Changes

package/app-config.dynamic.yaml

@@ -0,0 +1,16 @@
+# please keep this in sync with rhdh/dynamic-plugins.default.yaml
+dynamicPlugins:
+  frontend:
+    red-hat-developer-hub.backstage-plugin-translations:
+      translationResources:
+        - importName: translationsPluginTranslations
+          module: Alpha
+          ref: translationsPluginTranslationRef
+      dynamicRoutes:
+        - path: /translations
+          importName: TranslationsPage
+          module: Legacy
+      mountPoints:
+        - mountPoint: application/provider
+          importName: PseudoLocalizationProvider
+          module: Legacy

package/config.schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "i18n": {
+      "type": "object",
+      "properties": {
+        "pseudolocalization": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "description": "When true, enables i18next-pseudo for strings that go through the translation API.",
+              "visibility": "frontend"
+            },
+            "language": {
+              "type": "string",
+              "description": "Language code to pseudolocalize (e.g. en, de). Defaults to the active UI language when omitted.",
+              "visibility": "frontend"
+            }
+          },
+          "description": "Pseudolocalization stretches translated strings to test layout (i18next-pseudo).",
+          "deepVisibility": "frontend"
+        }
+      }
+    }
+  }
+}

package/dist/alpha.d.ts

@@ -1,17 +1,16 @@
 import * as _backstage_frontend_plugin_api from '@backstage/frontend-plugin-api';
 
 /**
- * @alpha
+ * @public
  */
 declare const translationsPluginTranslationRef: _backstage_frontend_plugin_api.TranslationRef<"plugin.translations", {
+    readonly "page.title": string;
+    readonly "page.subtitle": string;
     readonly "table.title": string;
     readonly "table.headers.refId": string;
     readonly "table.headers.key": string;
     readonly "table.options.pageSize": string;
     readonly "table.options.pageSizeOptions": string;
-    readonly "language.displayFormat": string;
-    readonly "page.title": string;
-    readonly "page.subtitle": string;
     readonly "export.title": string;
     readonly "export.downloadButton": string;
     readonly "export.filename": string;
@@ -19,11 +18,11 @@ declare const translationsPluginTranslationRef: _backstage_frontend_plugin_api.T
     readonly "common.error": string;
     readonly "common.noData": string;
     readonly "common.refresh": string;
+    readonly "language.displayFormat": string;
 }>;
 
 /**
- *  @alpha
- *
+ * @public
  */
 declare const translationsPluginTranslations: _backstage_frontend_plugin_api.TranslationResource<"plugin.translations">;
 

package/dist/apis/pseudolocalization.esm.js

@@ -0,0 +1,48 @@
+import Pseudo from 'i18next-pseudo';
+
+function mergePostProcess(i18n) {
+  const cur = i18n.options.postProcess;
+  let list;
+  if (!cur) {
+    list = [];
+  } else if (Array.isArray(cur)) {
+    list = [...cur];
+  } else {
+    list = [cur];
+  }
+  if (!list.includes("pseudo")) {
+    list.push("pseudo");
+  }
+  i18n.options.postProcess = list;
+}
+function attachPseudolocalization(translationApi, options) {
+  const i18n = translationApi.getI18nInstance();
+  const wrapped = options?.wrapped ?? true;
+  const languageToPseudo = options?.languageToPseudo ?? i18n.resolvedLanguage ?? i18n.language ?? "en";
+  const pseudo = new Pseudo({
+    enabled: true,
+    wrapped,
+    languageToPseudo
+  });
+  i18n.use(pseudo);
+  mergePostProcess(i18n);
+  const syncLanguageToPseudo = () => {
+    const next = options?.languageToPseudo ?? i18n.resolvedLanguage ?? i18n.language ?? "en";
+    pseudo.configurePseudo({ languageToPseudo: next });
+  };
+  syncLanguageToPseudo();
+  i18n.on("languageChanged", syncLanguageToPseudo);
+}
+function attachPseudolocalizationIfEnabled(translationApi, configApi, locationSearch) {
+  const params = new URLSearchParams(locationSearch ?? window.location.search);
+  const fromQuery = params.get("pseudolocalization") === "true";
+  const fromConfig = configApi.getOptionalBoolean("i18n.pseudolocalization.enabled") ?? false;
+  if (!fromQuery && !fromConfig) {
+    return;
+  }
+  const languageToPseudo = params.get("lng") ?? configApi.getOptionalString("i18n.pseudolocalization.language") ?? void 0;
+  attachPseudolocalization(translationApi, { languageToPseudo });
+}
+
+export { attachPseudolocalization, attachPseudolocalizationIfEnabled };
+//# sourceMappingURL=pseudolocalization.esm.js.map

package/dist/apis/pseudolocalization.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pseudolocalization.esm.js","sources":["../../src/apis/pseudolocalization.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\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 type { ConfigApi } from '@backstage/core-plugin-api';\nimport type { i18n as I18n } from 'i18next';\nimport Pseudo from 'i18next-pseudo';\n\nimport type { I18nextTranslationApi } from './I18nextTranslationApi';\n\n/** @public */\nexport interface PseudolocalizationOptions {\n  wrapped?: boolean;\n  languageToPseudo?: string;\n}\n\nfunction mergePostProcess(i18n: I18n): void {\n  const cur = i18n.options.postProcess;\n  let list: string[];\n  if (!cur) {\n    list = [];\n  } else if (Array.isArray(cur)) {\n    list = [...cur];\n  } else {\n    list = [cur as string];\n  }\n  if (!list.includes('pseudo')) {\n    list.push('pseudo');\n  }\n  i18n.options.postProcess = list;\n}\n\n/**\n * Attaches the i18next-pseudo post-processor to a translation API's i18n\n * instance. Call once after {@link I18nextTranslationApi.create}.\n *\n * @public\n */\nexport function attachPseudolocalization(\n  translationApi: I18nextTranslationApi,\n  options?: PseudolocalizationOptions,\n): void {\n  const i18n = translationApi.getI18nInstance();\n  const wrapped = options?.wrapped ?? true;\n  const languageToPseudo =\n    options?.languageToPseudo ?? i18n.resolvedLanguage ?? i18n.language ?? 'en';\n\n  const pseudo = new Pseudo({\n    enabled: true,\n    wrapped,\n    languageToPseudo,\n  });\n\n  i18n.use(pseudo);\n  mergePostProcess(i18n);\n\n  const syncLanguageToPseudo = () => {\n    const next =\n      options?.languageToPseudo ??\n      i18n.resolvedLanguage ??\n      i18n.language ??\n      'en';\n    pseudo.configurePseudo({ languageToPseudo: next });\n  };\n\n  syncLanguageToPseudo();\n  i18n.on('languageChanged', syncLanguageToPseudo);\n}\n\n/**\n * Convenience wrapper that enables pseudo-localization when activated via\n * URL query parameter (`?pseudolocalization=true`) or app-config\n * (`i18n.pseudolocalization.enabled: true`).\n *\n * @public\n */\nexport function attachPseudolocalizationIfEnabled(\n  translationApi: I18nextTranslationApi,\n  configApi: ConfigApi,\n  locationSearch?: string,\n): void {\n  const params = new URLSearchParams(locationSearch ?? window.location.search);\n  const fromQuery = params.get('pseudolocalization') === 'true';\n  const fromConfig =\n    configApi.getOptionalBoolean('i18n.pseudolocalization.enabled') ?? false;\n\n  if (!fromQuery && !fromConfig) {\n    return;\n  }\n\n  const languageToPseudo =\n    params.get('lng') ??\n    configApi.getOptionalString('i18n.pseudolocalization.language') ??\n    undefined;\n\n  attachPseudolocalization(translationApi, { languageToPseudo });\n}\n"],"names":[],"mappings":";;AA4BA,SAAS,iBAAiB,IAAA,EAAkB;AAC1C,EAAA,MAAM,GAAA,GAAM,KAAK,OAAA,CAAQ,WAAA;AACzB,EAAA,IAAI,IAAA;AACJ,EAAA,IAAI,CAAC,GAAA,EAAK;AACR,IAAA,IAAA,GAAO,EAAC;AAAA,EACV,CAAA,MAAA,IAAW,KAAA,CAAM,OAAA,CAAQ,GAAG,CAAA,EAAG;AAC7B,IAAA,IAAA,GAAO,CAAC,GAAG,GAAG,CAAA;AAAA,EAChB,CAAA,MAAO;AACL,IAAA,IAAA,GAAO,CAAC,GAAa,CAAA;AAAA,EACvB;AACA,EAAA,IAAI,CAAC,IAAA,CAAK,QAAA,CAAS,QAAQ,CAAA,EAAG;AAC5B,IAAA,IAAA,CAAK,KAAK,QAAQ,CAAA;AAAA,EACpB;AACA,EAAA,IAAA,CAAK,QAAQ,WAAA,GAAc,IAAA;AAC7B;AAQO,SAAS,wBAAA,CACd,gBACA,OAAA,EACM;AACN,EAAA,MAAM,IAAA,GAAO,eAAe,eAAA,EAAgB;AAC5C,EAAA,MAAM,OAAA,GAAU,SAAS,OAAA,IAAW,IAAA;AACpC,EAAA,MAAM,mBACJ,OAAA,EAAS,gBAAA,IAAoB,IAAA,CAAK,gBAAA,IAAoB,KAAK,QAAA,IAAY,IAAA;AAEzE,EAAA,MAAM,MAAA,GAAS,IAAI,MAAA,CAAO;AAAA,IACxB,OAAA,EAAS,IAAA;AAAA,IACT,OAAA;AAAA,IACA;AAAA,GACD,CAAA;AAED,EAAA,IAAA,CAAK,IAAI,MAAM,CAAA;AACf,EAAA,gBAAA,CAAiB,IAAI,CAAA;AAErB,EAAA,MAAM,uBAAuB,MAAM;AACjC,IAAA,MAAM,OACJ,OAAA,EAAS,gBAAA,IACT,IAAA,CAAK,gBAAA,IACL,KAAK,QAAA,IACL,IAAA;AACF,IAAA,MAAA,CAAO,eAAA,CAAgB,EAAE,gBAAA,EAAkB,IAAA,EAAM,CAAA;AAAA,EACnD,CAAA;AAEA,EAAA,oBAAA,EAAqB;AACrB,EAAA,IAAA,CAAK,EAAA,CAAG,mBAAmB,oBAAoB,CAAA;AACjD;AASO,SAAS,iCAAA,CACd,cAAA,EACA,SAAA,EACA,cAAA,EACM;AACN,EAAA,MAAM,SAAS,IAAI,eAAA,CAAgB,cAAA,IAAkB,MAAA,CAAO,SAAS,MAAM,CAAA;AAC3E,EAAA,MAAM,SAAA,GAAY,MAAA,CAAO,GAAA,CAAI,oBAAoB,CAAA,KAAM,MAAA;AACvD,EAAA,MAAM,UAAA,GACJ,SAAA,CAAU,kBAAA,CAAmB,iCAAiC,CAAA,IAAK,KAAA;AAErE,EAAA,IAAI,CAAC,SAAA,IAAa,CAAC,UAAA,EAAY;AAC7B,IAAA;AAAA,EACF;AAEA,EAAA,MAAM,gBAAA,GACJ,OAAO,GAAA,CAAI,KAAK,KAChB,SAAA,CAAU,iBAAA,CAAkB,kCAAkC,CAAA,IAC9D,MAAA;AAEF,EAAA,wBAAA,CAAyB,cAAA,EAAgB,EAAE,gBAAA,EAAkB,CAAA;AAC/D;;;;"}

package/dist/components/LoadedTranslationsTable.esm.js

@@ -5,6 +5,10 @@ import { appLanguageApiRef, translationApiRef } from '@backstage/core-plugin-api
 import { useMemo } from 'react';
 import { useTranslation } from '../hooks/useTranslation.esm.js';
 
+function getI18nInstance(translationApi) {
+  const api = translationApi;
+  return typeof api.getI18nInstance === "function" ? api.getI18nInstance() : void 0;
+}
 const getLanguageDisplayName = (language) => {
   try {
     const names = new Intl.DisplayNames([language], {
@@ -29,27 +33,28 @@ const LoadedTranslationsTable = () => {
   const { t } = useTranslation();
   const appLanguageApi = useApi(appLanguageApiRef);
   const translationApi = useApi(translationApiRef);
-  const i18n = translationApi.getI18nInstance();
-  const resources = i18n.store.data;
+  const i18n = getI18nInstance(translationApi);
+  const resources = i18n?.store.data;
   const showLanguages = useMemo(
-    () => [
+    () => i18n ? [
       "en",
       ...appLanguageApi.getAvailableLanguages().languages.filter((lang) => lang !== "en")
-    ],
-    [appLanguageApi]
+    ] : [],
+    [appLanguageApi, i18n]
   );
   const columns = useMemo(
-    () => [
+    () => i18n ? [
       { title: t("table.headers.refId"), field: "ref" },
       { title: t("table.headers.key"), field: "key" },
       ...showLanguages.map((lang) => ({
         title: getLanguageDisplayName(lang),
         field: lang
       }))
-    ],
-    [showLanguages, t]
+    ] : [],
+    [showLanguages, t, i18n]
   );
   const data = useMemo(() => {
+    if (!resources) return [];
     const rows = [];
     if (resources.en) {
       for (const ref of Object.keys(resources.en)) {
@@ -104,6 +109,17 @@ const LoadedTranslationsTable = () => {
     }
     return rows;
   }, [resources, showLanguages]);
+  if (!i18n) {
+    return /* @__PURE__ */ jsx(
+      Table,
+      {
+        title: t("table.title", { count: "0" }),
+        columns: [],
+        data: [],
+        emptyContent: /* @__PURE__ */ jsx("span", { children: "Translation resource data is not available with the built-in TranslationApi." })
+      }
+    );
+  }
   return /* @__PURE__ */ jsx(
     Table,
     {

package/dist/components/LoadedTranslationsTable.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"LoadedTranslationsTable.esm.js","sources":["../../src/components/LoadedTranslationsTable.tsx"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\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 */\nimport { Table } from '@backstage/core-components';\nimport { useApi } from '@backstage/core-plugin-api';\nimport {\n  appLanguageApiRef,\n  translationApiRef,\n} from '@backstage/core-plugin-api/alpha';\n\nimport type { i18n as I18n, Resource } from 'i18next';\nimport { useMemo } from 'react';\nimport { useTranslation } from '../hooks/useTranslation';\n\ninterface Row {\n  ref: string;\n  key: string;\n  [lang: string]: string | undefined;\n}\n\n// From https://github.com/backstage/backstage/blob/89f191b72c154e3f0bde70548a7bccbb23af8de0/plugins/user-settings/src/components/General/UserSettingsLanguageToggle.tsx#L68\nconst getLanguageDisplayName = (language: string) => {\n  try {\n    const names = new Intl.DisplayNames([language], {\n      type: 'language',\n    });\n    const languageDisplayName = names.of(language);\n    if (languageDisplayName) {\n      return `${languageDisplayName} (${language})`;\n    }\n    return language;\n  } catch (err) {\n    return language;\n  }\n};\n\nconst getTranslation = (\n  resources: Resource,\n  lang: string,\n  ref: string,\n  key: string,\n) => {\n  const resourceLang = resources[lang];\n  const resourceKey = resourceLang?.[ref];\n  const translation =\n    typeof resourceKey === 'object' ? resourceKey?.[key] : undefined;\n  return translation;\n};\n\nexport const LoadedTranslationsTable = () => {\n  const { t } = useTranslation();\n  const appLanguageApi = useApi(appLanguageApiRef);\n  const translationApi = useApi(translationApiRef);\n  const i18n: I18n = (translationApi as any).getI18nInstance();\n\n  const resources = i18n.store.data;\n\n  // FIXME: the available languages are not yet loaded...\n  const showLanguages = useMemo(\n    () => [\n      'en',\n      ...appLanguageApi\n        .getAvailableLanguages()\n        .languages.filter(lang => lang !== 'en'),\n    ],\n    [appLanguageApi],\n  );\n\n  const columns = useMemo(\n    () => [\n      { title: t('table.headers.refId'), field: 'ref' },\n      { title: t('table.headers.key'), field: 'key' },\n      ...showLanguages.map(lang => ({\n        title: getLanguageDisplayName(lang),\n        field: lang,\n      })),\n    ],\n    [showLanguages, t],\n  );\n\n  const data = useMemo(() => {\n    const rows: Row[] = [];\n\n    // Iterate first over primary language english\n    if (resources.en) {\n      for (const ref of Object.keys(resources.en)) {\n        for (const key of Object.keys(resources.en[ref])) {\n          rows.push(\n            showLanguages.reduce(\n              (row, lang) => {\n                row[lang] = getTranslation(resources, lang, ref, key);\n                return row;\n              },\n              {\n                ref,\n                key,\n              } as Row,\n            ),\n          );\n        }\n      }\n    }\n\n    // Check if other languages have additional keys\n    for (const otherLang of Object.keys(resources)) {\n      if (otherLang === 'en') {\n        continue;\n      }\n      for (const ref of Object.keys(resources[otherLang])) {\n        for (const key of Object.keys(resources[otherLang][ref])) {\n          // if the key exists in english, then it was already added\n          const resourceLang = resources.en;\n          const resourceKey = resourceLang?.[ref];\n          if (typeof resourceKey === 'object' && resourceKey?.[key]) {\n            continue;\n          }\n          // Check if we already have a row for this ref/key combination\n          // from another language. If yes, then we can skip this as well.\n          const existingRow = rows.find(r => r.ref === ref && r.key === key);\n          if (existingRow) {\n            showLanguages.forEach(lang => {\n              existingRow[lang] = getTranslation(resources, lang, ref, key);\n            });\n            continue;\n          }\n          // Otherwise add a new row and include all languages\n          rows.push(\n            showLanguages.reduce(\n              (row, lang) => {\n                row[lang] = getTranslation(resources, lang, ref, key);\n                return row;\n              },\n              {\n                ref,\n                key,\n              } as Row,\n            ),\n          );\n        }\n      }\n    }\n\n    return rows;\n  }, [resources, showLanguages]);\n\n  return (\n    <Table\n      title={t('table.title' as any, { count: data.length.toString() })}\n      columns={columns}\n      data={data}\n      options={{\n        pageSize: 10,\n        pageSizeOptions: [10, 25, 100],\n      }}\n    />\n  );\n};\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"LoadedTranslationsTable.esm.js","sources":["../../src/components/LoadedTranslationsTable.tsx"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\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 */\nimport { Table } from '@backstage/core-components';\nimport { useApi } from '@backstage/core-plugin-api';\nimport {\n  appLanguageApiRef,\n  translationApiRef,\n} from '@backstage/core-plugin-api/alpha';\n\nimport type { i18n as I18n, Resource } from 'i18next';\nimport { useMemo } from 'react';\nimport { useTranslation } from '../hooks/useTranslation';\n\nfunction getI18nInstance(translationApi: unknown): I18n | undefined {\n  const api = translationApi as { getI18nInstance?: () => I18n };\n  return typeof api.getI18nInstance === 'function'\n    ? api.getI18nInstance()\n    : undefined;\n}\n\ninterface Row {\n  ref: string;\n  key: string;\n  [lang: string]: string | undefined;\n}\n\n// From https://github.com/backstage/backstage/blob/89f191b72c154e3f0bde70548a7bccbb23af8de0/plugins/user-settings/src/components/General/UserSettingsLanguageToggle.tsx#L68\nconst getLanguageDisplayName = (language: string) => {\n  try {\n    const names = new Intl.DisplayNames([language], {\n      type: 'language',\n    });\n    const languageDisplayName = names.of(language);\n    if (languageDisplayName) {\n      return `${languageDisplayName} (${language})`;\n    }\n    return language;\n  } catch (err) {\n    return language;\n  }\n};\n\nconst getTranslation = (\n  resources: Resource,\n  lang: string,\n  ref: string,\n  key: string,\n) => {\n  const resourceLang = resources[lang];\n  const resourceKey = resourceLang?.[ref];\n  const translation =\n    typeof resourceKey === 'object' ? resourceKey?.[key] : undefined;\n  return translation;\n};\n\nexport const LoadedTranslationsTable = () => {\n  const { t } = useTranslation();\n  const appLanguageApi = useApi(appLanguageApiRef);\n  const translationApi = useApi(translationApiRef);\n  const i18n = getI18nInstance(translationApi);\n\n  const resources = i18n?.store.data;\n\n  // FIXME: the available languages are not yet loaded...\n  const showLanguages = useMemo(\n    () =>\n      i18n\n        ? [\n            'en',\n            ...appLanguageApi\n              .getAvailableLanguages()\n              .languages.filter(lang => lang !== 'en'),\n          ]\n        : [],\n    [appLanguageApi, i18n],\n  );\n\n  const columns = useMemo(\n    () =>\n      i18n\n        ? [\n            { title: t('table.headers.refId'), field: 'ref' },\n            { title: t('table.headers.key'), field: 'key' },\n            ...showLanguages.map(lang => ({\n              title: getLanguageDisplayName(lang),\n              field: lang,\n            })),\n          ]\n        : [],\n    [showLanguages, t, i18n],\n  );\n\n  const data = useMemo(() => {\n    if (!resources) return [];\n    const rows: Row[] = [];\n\n    if (resources.en) {\n      for (const ref of Object.keys(resources.en)) {\n        for (const key of Object.keys(resources.en[ref])) {\n          rows.push(\n            showLanguages.reduce(\n              (row, lang) => {\n                row[lang] = getTranslation(resources, lang, ref, key);\n                return row;\n              },\n              {\n                ref,\n                key,\n              } as Row,\n            ),\n          );\n        }\n      }\n    }\n\n    for (const otherLang of Object.keys(resources)) {\n      if (otherLang === 'en') {\n        continue;\n      }\n      for (const ref of Object.keys(resources[otherLang])) {\n        for (const key of Object.keys(resources[otherLang][ref])) {\n          const resourceLang = resources.en;\n          const resourceKey = resourceLang?.[ref];\n          if (typeof resourceKey === 'object' && resourceKey?.[key]) {\n            continue;\n          }\n          const existingRow = rows.find(r => r.ref === ref && r.key === key);\n          if (existingRow) {\n            showLanguages.forEach(lang => {\n              existingRow[lang] = getTranslation(resources, lang, ref, key);\n            });\n            continue;\n          }\n          rows.push(\n            showLanguages.reduce(\n              (row, lang) => {\n                row[lang] = getTranslation(resources, lang, ref, key);\n                return row;\n              },\n              {\n                ref,\n                key,\n              } as Row,\n            ),\n          );\n        }\n      }\n    }\n\n    return rows;\n  }, [resources, showLanguages]);\n\n  if (!i18n) {\n    return (\n      <Table\n        title={t('table.title' as any, { count: '0' })}\n        columns={[]}\n        data={[]}\n        emptyContent={\n          <span>\n            Translation resource data is not available with the built-in\n            TranslationApi.\n          </span>\n        }\n      />\n    );\n  }\n\n  return (\n    <Table\n      title={t('table.title' as any, { count: data.length.toString() })}\n      columns={columns}\n      data={data}\n      options={{\n        pageSize: 10,\n        pageSizeOptions: [10, 25, 100],\n      }}\n    />\n  );\n};\n"],"names":[],"mappings":"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"}

package/dist/components/PseudoLocalizationProvider.esm.js

@@ -0,0 +1,28 @@
+import { jsx, Fragment } from 'react/jsx-runtime';
+import { useRef, useEffect } from 'react';
+import { useApi, configApiRef } from '@backstage/core-plugin-api';
+import { translationApiRef } from '@backstage/core-plugin-api/alpha';
+import { attachPseudolocalizationIfEnabled } from '../apis/pseudolocalization.esm.js';
+
+const PseudoLocalizationProvider = ({
+  children
+}) => {
+  const configApi = useApi(configApiRef);
+  const translationApi = useApi(translationApiRef);
+  const attached = useRef(false);
+  useEffect(() => {
+    if (attached.current) {
+      return;
+    }
+    attached.current = true;
+    const api = translationApi;
+    if (typeof api.getI18nInstance !== "function") {
+      return;
+    }
+    attachPseudolocalizationIfEnabled(api, configApi);
+  }, [translationApi, configApi]);
+  return /* @__PURE__ */ jsx(Fragment, { children });
+};
+
+export { PseudoLocalizationProvider };
+//# sourceMappingURL=PseudoLocalizationProvider.esm.js.map

package/dist/components/PseudoLocalizationProvider.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PseudoLocalizationProvider.esm.js","sources":["../../src/components/PseudoLocalizationProvider.tsx"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\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 { type PropsWithChildren, useEffect, useRef } from 'react';\n\nimport { configApiRef, useApi } from '@backstage/core-plugin-api';\nimport { translationApiRef } from '@backstage/core-plugin-api/alpha';\n\nimport { attachPseudolocalizationIfEnabled } from '../apis/pseudolocalization';\n\n/**\n * Provider component that enables pseudo-localization when activated via\n * URL query parameter (`?pseudolocalization=true`) or app-config\n * (`i18n.pseudolocalization.enabled: true`).\n *\n * Requires the TranslationApi implementation to expose `getI18nInstance()`.\n * When the built-in NFS API is used (which does not have this method),\n * pseudo-localization is silently skipped.\n *\n * @public\n */\nexport const PseudoLocalizationProvider = ({\n  children,\n}: PropsWithChildren<{}>) => {\n  const configApi = useApi(configApiRef);\n  const translationApi = useApi(translationApiRef);\n  const attached = useRef(false);\n\n  useEffect(() => {\n    if (attached.current) {\n      return;\n    }\n    attached.current = true;\n\n    const api = translationApi as unknown as {\n      getI18nInstance?: () => unknown;\n    };\n    if (typeof api.getI18nInstance !== 'function') {\n      return;\n    }\n    attachPseudolocalizationIfEnabled(api as any, configApi);\n  }, [translationApi, configApi]);\n\n  return <>{children}</>;\n};\n"],"names":[],"mappings":";;;;;;AAkCO,MAAM,6BAA6B,CAAC;AAAA,EACzC;AACF,CAAA,KAA6B;AAC3B,EAAA,MAAM,SAAA,GAAY,OAAO,YAAY,CAAA;AACrC,EAAA,MAAM,cAAA,GAAiB,OAAO,iBAAiB,CAAA;AAC/C,EAAA,MAAM,QAAA,GAAW,OAAO,KAAK,CAAA;AAE7B,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,SAAS,OAAA,EAAS;AACpB,MAAA;AAAA,IACF;AACA,IAAA,QAAA,CAAS,OAAA,GAAU,IAAA;AAEnB,IAAA,MAAM,GAAA,GAAM,cAAA;AAGZ,IAAA,IAAI,OAAO,GAAA,CAAI,eAAA,KAAoB,UAAA,EAAY;AAC7C,MAAA;AAAA,IACF;AACA,IAAA,iCAAA,CAAkC,KAAY,SAAS,CAAA;AAAA,EACzD,CAAA,EAAG,CAAC,cAAA,EAAgB,SAAS,CAAC,CAAA;AAE9B,EAAA,uCAAU,QAAA,EAAS,CAAA;AACrB;;;;"}

package/dist/index.d.ts

@@ -1,46 +1,83 @@
-import { TranslationApi, AppLanguageApi, TranslationMessages, TranslationResource, TranslationRef, TranslationSnapshot } from '@backstage/core-plugin-api/alpha';
-import { i18n } from 'i18next';
-import { Observable } from '@backstage/types';
+import * as react from 'react';
 import * as _backstage_frontend_plugin_api from '@backstage/frontend-plugin-api';
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import * as _backstage_core_plugin_api from '@backstage/core-plugin-api';
-
-/** @public */
-interface I18nextTranslationApiOptions {
-    languageApi: AppLanguageApi;
-    resources?: Array<TranslationMessages | TranslationResource>;
-}
-/** @public */
-declare class I18nextTranslationApi implements TranslationApi {
-    #private;
-    static create(options: I18nextTranslationApiOptions): I18nextTranslationApi;
-    private constructor();
-    getI18nInstance(): i18n;
-    getTranslation<TMessages extends {
-        [key in string]: string;
-    }>(translationRef: TranslationRef<string, TMessages>): TranslationSnapshot<TMessages>;
-    translation$<TMessages extends {
-        [key in string]: string;
-    }>(translationRef: TranslationRef<string, TMessages>): Observable<TranslationSnapshot<TMessages>>;
-}
+export { translationsPluginTranslationRef, translationsPluginTranslations } from './alpha.js';
 
 /**
+ * The Translations frontend plugin for the new Backstage frontend system.
+ *
  * @public
  */
-declare const translationsPlugin: _backstage_core_plugin_api.BackstagePlugin<{
-    root: _backstage_core_plugin_api.RouteRef<undefined>;
-}, {}, {}>;
+declare const _default: _backstage_frontend_plugin_api.OverridableFrontendPlugin<{}, {}, {
+    "page:translations": _backstage_frontend_plugin_api.OverridableExtensionDefinition<{
+        kind: "page";
+        name: undefined;
+        config: {
+            path: string | undefined;
+            title: string | undefined;
+        };
+        configInput: {
+            path?: string | undefined;
+            title?: string | undefined;
+        };
+        output: _backstage_frontend_plugin_api.ExtensionDataRef<string, "core.routing.path", {}> | _backstage_frontend_plugin_api.ExtensionDataRef<_backstage_frontend_plugin_api.RouteRef<_backstage_frontend_plugin_api.AnyRouteRefParams>, "core.routing.ref", {
+            optional: true;
+        }> | _backstage_frontend_plugin_api.ExtensionDataRef<react.JSX.Element, "core.reactElement", {}> | _backstage_frontend_plugin_api.ExtensionDataRef<string, "core.title", {
+            optional: true;
+        }> | _backstage_frontend_plugin_api.ExtensionDataRef<_backstage_frontend_plugin_api.IconElement, "core.icon", {
+            optional: true;
+        }>;
+        inputs: {
+            pages: _backstage_frontend_plugin_api.ExtensionInput<_backstage_frontend_plugin_api.ConfigurableExtensionDataRef<react.JSX.Element, "core.reactElement", {}> | _backstage_frontend_plugin_api.ConfigurableExtensionDataRef<string, "core.routing.path", {}> | _backstage_frontend_plugin_api.ConfigurableExtensionDataRef<_backstage_frontend_plugin_api.RouteRef<_backstage_frontend_plugin_api.AnyRouteRefParams>, "core.routing.ref", {
+                optional: true;
+            }> | _backstage_frontend_plugin_api.ConfigurableExtensionDataRef<string, "core.title", {
+                optional: true;
+            }> | _backstage_frontend_plugin_api.ConfigurableExtensionDataRef<_backstage_frontend_plugin_api.IconElement, "core.icon", {
+                optional: true;
+            }>, {
+                singleton: false;
+                optional: false;
+                internal: false;
+            }>;
+        };
+        params: {
+            path: string;
+            title?: string;
+            icon?: _backstage_frontend_plugin_api.IconElement;
+            loader?: () => Promise<react.JSX.Element>;
+            routeRef?: _backstage_frontend_plugin_api.RouteRef;
+            noHeader?: boolean;
+        };
+    }>;
+    "translation:translations/translations-i18n": _backstage_frontend_plugin_api.OverridableExtensionDefinition<{
+        kind: "translation";
+        name: "translations-i18n";
+        config: {};
+        configInput: {};
+        output: _backstage_frontend_plugin_api.ExtensionDataRef<_backstage_frontend_plugin_api.TranslationResource<string> | _backstage_frontend_plugin_api.TranslationMessages<string, {
+            [x: string]: string;
+        }, boolean>, "core.translation.translation", {}>;
+        inputs: {};
+        params: {
+            resource: _backstage_frontend_plugin_api.TranslationResource | _backstage_frontend_plugin_api.TranslationMessages;
+        };
+    }>;
+}>;
+
 /**
+ * Module that replaces the built-in TranslationApi with one that
+ * exposes `getI18nInstance()`, needed by the translations debug page
+ * and pseudo-localization. Also attaches pseudo-localization when
+ * enabled via app-config or URL param.
+ *
  * @public
  */
-declare const TranslationsPage: () => react_jsx_runtime.JSX.Element;
+declare const translationsApiModule: _backstage_frontend_plugin_api.FrontendModule;
 /**
- * Export Translation Keys
+ * Pseudo-localization module for OFS / dynamic plugins.
+ * In NFS, pseudo-localization is handled by `translationsApiModule` instead.
+ *
  * @public
  */
-declare const ExportTranslationKeys: ({ resources, }: {
-    resources: _backstage_frontend_plugin_api.TranslationRef[];
-}) => react_jsx_runtime.JSX.Element;
+declare const translationsPseudoLocalizationModule: _backstage_frontend_plugin_api.FrontendModule;
 
-export { ExportTranslationKeys, I18nextTranslationApi, TranslationsPage, translationsPlugin };
-export type { I18nextTranslationApiOptions };
+export { _default as default, translationsApiModule, translationsPseudoLocalizationModule };

package/dist/index.esm.js

@@ -1,3 +1,74 @@
-export { I18nextTranslationApi } from './apis/I18nextTranslationApi.esm.js';
-export { ExportTranslationKeys, TranslationsPage, translationsPlugin } from './plugin.esm.js';
+import { jsx } from 'react/jsx-runtime';
+import { PageBlueprint, ApiBlueprint, configApiRef, appLanguageApiRef, translationApiRef, createExtensionInput, createFrontendPlugin, createFrontendModule } from '@backstage/frontend-plugin-api';
+import ExtensionIcon from '@mui/icons-material/Extension';
+import { TranslationBlueprint, AppRootWrapperBlueprint } from '@backstage/plugin-app-react';
+import { translationsPluginTranslations } from './translations/index.esm.js';
+import { I18nextTranslationApi } from './apis/I18nextTranslationApi.esm.js';
+import { attachPseudolocalizationIfEnabled } from './apis/pseudolocalization.esm.js';
+import { PseudoLocalizationProvider } from './components/PseudoLocalizationProvider.esm.js';
+export { translationsPluginTranslationRef } from './translations/ref.esm.js';
+
+const translationsPage = PageBlueprint.make({
+  params: {
+    path: "/translations",
+    title: "Translations",
+    icon: /* @__PURE__ */ jsx(ExtensionIcon, {}),
+    noHeader: true,
+    loader: () => import('./components/TranslationsPage.esm.js').then((m) => /* @__PURE__ */ jsx(m.TranslationsPage, {}))
+  }
+});
+const i18nTranslation = TranslationBlueprint.make({
+  name: "translations-i18n",
+  params: {
+    resource: translationsPluginTranslations
+  }
+});
+const translationsApiExtension = ApiBlueprint.makeWithOverrides({
+  name: "translations",
+  inputs: {
+    translations: createExtensionInput(
+      [TranslationBlueprint.dataRefs.translation],
+      { replaces: [{ id: "app", input: "translations" }], internal: true }
+    )
+  },
+  factory: (originalFactory, { inputs }) => {
+    return originalFactory(
+      (defineParams) => defineParams({
+        api: translationApiRef,
+        deps: { languageApi: appLanguageApiRef, configApi: configApiRef },
+        factory: ({ languageApi, configApi }) => {
+          const resources = inputs.translations.map(
+            (i) => i.get(TranslationBlueprint.dataRefs.translation)
+          );
+          const api = I18nextTranslationApi.create({
+            languageApi,
+            resources
+          });
+          attachPseudolocalizationIfEnabled(api, configApi);
+          return api;
+        }
+      })
+    );
+  }
+});
+const pseudoLocalizationWrapper = AppRootWrapperBlueprint.make({
+  name: "pseudo-localization",
+  params: {
+    component: PseudoLocalizationProvider
+  }
+});
+var index = createFrontendPlugin({
+  pluginId: "translations",
+  extensions: [translationsPage, i18nTranslation]
+});
+const translationsApiModule = createFrontendModule({
+  pluginId: "app",
+  extensions: [translationsApiExtension]
+});
+const translationsPseudoLocalizationModule = createFrontendModule({
+  pluginId: "app",
+  extensions: [pseudoLocalizationWrapper]
+});
+
+export { index as default, translationsApiModule, translationsPluginTranslations, translationsPseudoLocalizationModule };
 //# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}
+{"version":3,"file":"index.esm.js","sources":["../src/index.tsx"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\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  ApiBlueprint,\n  appLanguageApiRef,\n  configApiRef,\n  createExtensionInput,\n  createFrontendModule,\n  createFrontendPlugin,\n  PageBlueprint,\n  translationApiRef,\n} from '@backstage/frontend-plugin-api';\nimport ExtensionIcon from '@mui/icons-material/Extension';\nimport {\n  AppRootWrapperBlueprint,\n  TranslationBlueprint,\n} from '@backstage/plugin-app-react';\n\nimport {\n  translationsPluginTranslationRef,\n  translationsPluginTranslations,\n} from './translations';\nimport { I18nextTranslationApi } from './apis/I18nextTranslationApi';\nimport { attachPseudolocalizationIfEnabled } from './apis/pseudolocalization';\nimport { PseudoLocalizationProvider } from './components/PseudoLocalizationProvider';\n\nconst translationsPage = PageBlueprint.make({\n  params: {\n    path: '/translations',\n    title: 'Translations',\n    icon: <ExtensionIcon />,\n    noHeader: true,\n    loader: () =>\n      import('./components/TranslationsPage').then(m => <m.TranslationsPage />),\n  },\n});\n\nconst i18nTranslation = TranslationBlueprint.make({\n  name: 'translations-i18n',\n  params: {\n    resource: translationsPluginTranslations,\n  },\n});\n\nconst translationsApiExtension = ApiBlueprint.makeWithOverrides({\n  name: 'translations',\n  inputs: {\n    translations: createExtensionInput(\n      [TranslationBlueprint.dataRefs.translation],\n      { replaces: [{ id: 'app', input: 'translations' }], internal: true },\n    ),\n  },\n  factory: (originalFactory, { inputs }) => {\n    return originalFactory(defineParams =>\n      defineParams({\n        api: translationApiRef,\n        deps: { languageApi: appLanguageApiRef, configApi: configApiRef },\n        factory: ({ languageApi, configApi }) => {\n          const resources = inputs.translations.map(i =>\n            i.get(TranslationBlueprint.dataRefs.translation),\n          );\n          const api = I18nextTranslationApi.create({\n            languageApi,\n            resources,\n          });\n          attachPseudolocalizationIfEnabled(api, configApi);\n          return api;\n        },\n      }),\n    );\n  },\n});\n\nconst pseudoLocalizationWrapper = AppRootWrapperBlueprint.make({\n  name: 'pseudo-localization',\n  params: {\n    component: PseudoLocalizationProvider,\n  },\n});\n\n/**\n * The Translations frontend plugin for the new Backstage frontend system.\n *\n * @public\n */\nexport default createFrontendPlugin({\n  pluginId: 'translations',\n  extensions: [translationsPage, i18nTranslation],\n});\n\n/**\n * Module that replaces the built-in TranslationApi with one that\n * exposes `getI18nInstance()`, needed by the translations debug page\n * and pseudo-localization. Also attaches pseudo-localization when\n * enabled via app-config or URL param.\n *\n * @public\n */\nexport const translationsApiModule = createFrontendModule({\n  pluginId: 'app',\n  extensions: [translationsApiExtension],\n});\n\n/**\n * Pseudo-localization module for OFS / dynamic plugins.\n * In NFS, pseudo-localization is handled by `translationsApiModule` instead.\n *\n * @public\n */\nexport const translationsPseudoLocalizationModule = createFrontendModule({\n  pluginId: 'app',\n  extensions: [pseudoLocalizationWrapper],\n});\n\nexport { translationsPluginTranslationRef, translationsPluginTranslations };\n"],"names":[],"mappings":";;;;;;;;;;AAwCA,MAAM,gBAAA,GAAmB,cAAc,IAAA,CAAK;AAAA,EAC1C,MAAA,EAAQ;AAAA,IACN,IAAA,EAAM,eAAA;AAAA,IACN,KAAA,EAAO,cAAA;AAAA,IACP,IAAA,sBAAO,aAAA,EAAA,EAAc,CAAA;AAAA,IACrB,QAAA,EAAU,IAAA;AAAA,IACV,MAAA,EAAQ,MACN,OAAO,sCAA+B,CAAA,CAAE,IAAA,CAAK,CAAA,CAAA,qBAAK,GAAA,CAAC,CAAA,CAAE,gBAAA,EAAF,EAAmB,CAAE;AAAA;AAE9E,CAAC,CAAA;AAED,MAAM,eAAA,GAAkB,qBAAqB,IAAA,CAAK;AAAA,EAChD,IAAA,EAAM,mBAAA;AAAA,EACN,MAAA,EAAQ;AAAA,IACN,QAAA,EAAU;AAAA;AAEd,CAAC,CAAA;AAED,MAAM,wBAAA,GAA2B,aAAa,iBAAA,CAAkB;AAAA,EAC9D,IAAA,EAAM,cAAA;AAAA,EACN,MAAA,EAAQ;AAAA,IACN,YAAA,EAAc,oBAAA;AAAA,MACZ,CAAC,oBAAA,CAAqB,QAAA,CAAS,WAAW,CAAA;AAAA,MAC1C,EAAE,QAAA,EAAU,CAAC,EAAE,EAAA,EAAI,KAAA,EAAO,KAAA,EAAO,cAAA,EAAgB,CAAA,EAAG,QAAA,EAAU,IAAA;AAAK;AACrE,GACF;AAAA,EACA,OAAA,EAAS,CAAC,eAAA,EAAiB,EAAE,QAAO,KAAM;AACxC,IAAA,OAAO,eAAA;AAAA,MAAgB,kBACrB,YAAA,CAAa;AAAA,QACX,GAAA,EAAK,iBAAA;AAAA,QACL,IAAA,EAAM,EAAE,WAAA,EAAa,iBAAA,EAAmB,WAAW,YAAA,EAAa;AAAA,QAChE,OAAA,EAAS,CAAC,EAAE,WAAA,EAAa,WAAU,KAAM;AACvC,UAAA,MAAM,SAAA,GAAY,OAAO,YAAA,CAAa,GAAA;AAAA,YAAI,CAAA,CAAA,KACxC,CAAA,CAAE,GAAA,CAAI,oBAAA,CAAqB,SAAS,WAAW;AAAA,WACjD;AACA,UAAA,MAAM,GAAA,GAAM,sBAAsB,MAAA,CAAO;AAAA,YACvC,WAAA;AAAA,YACA;AAAA,WACD,CAAA;AACD,UAAA,iCAAA,CAAkC,KAAK,SAAS,CAAA;AAChD,UAAA,OAAO,GAAA;AAAA,QACT;AAAA,OACD;AAAA,KACH;AAAA,EACF;AACF,CAAC,CAAA;AAED,MAAM,yBAAA,GAA4B,wBAAwB,IAAA,CAAK;AAAA,EAC7D,IAAA,EAAM,qBAAA;AAAA,EACN,MAAA,EAAQ;AAAA,IACN,SAAA,EAAW;AAAA;AAEf,CAAC,CAAA;AAOD,YAAe,oBAAA,CAAqB;AAAA,EAClC,QAAA,EAAU,cAAA;AAAA,EACV,UAAA,EAAY,CAAC,gBAAA,EAAkB,eAAe;AAChD,CAAC,CAAA;AAUM,MAAM,wBAAwB,oBAAA,CAAqB;AAAA,EACxD,QAAA,EAAU,KAAA;AAAA,EACV,UAAA,EAAY,CAAC,wBAAwB;AACvC,CAAC;AAQM,MAAM,uCAAuC,oBAAA,CAAqB;AAAA,EACvE,QAAA,EAAU,KAAA;AAAA,EACV,UAAA,EAAY,CAAC,yBAAyB;AACxC,CAAC;;;;"}

package/dist/legacy.d.ts

@@ -0,0 +1,82 @@
+import { TranslationApi, AppLanguageApi, TranslationMessages, TranslationResource, TranslationRef, TranslationSnapshot } from '@backstage/core-plugin-api/alpha';
+import { i18n } from 'i18next';
+import { Observable } from '@backstage/types';
+import * as _backstage_core_plugin_api from '@backstage/core-plugin-api';
+import { ConfigApi } from '@backstage/core-plugin-api';
+import * as _backstage_frontend_plugin_api from '@backstage/frontend-plugin-api';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { PropsWithChildren } from 'react';
+
+/** @public */
+interface I18nextTranslationApiOptions {
+    languageApi: AppLanguageApi;
+    resources?: Array<TranslationMessages | TranslationResource>;
+}
+/** @public */
+declare class I18nextTranslationApi implements TranslationApi {
+    #private;
+    static create(options: I18nextTranslationApiOptions): I18nextTranslationApi;
+    private constructor();
+    getI18nInstance(): i18n;
+    getTranslation<TMessages extends {
+        [key in string]: string;
+    }>(translationRef: TranslationRef<string, TMessages>): TranslationSnapshot<TMessages>;
+    translation$<TMessages extends {
+        [key in string]: string;
+    }>(translationRef: TranslationRef<string, TMessages>): Observable<TranslationSnapshot<TMessages>>;
+}
+
+/** @public */
+interface PseudolocalizationOptions {
+    wrapped?: boolean;
+    languageToPseudo?: string;
+}
+/**
+ * Attaches the i18next-pseudo post-processor to a translation API's i18n
+ * instance. Call once after {@link I18nextTranslationApi.create}.
+ *
+ * @public
+ */
+declare function attachPseudolocalization(translationApi: I18nextTranslationApi, options?: PseudolocalizationOptions): void;
+/**
+ * Convenience wrapper that enables pseudo-localization when activated via
+ * URL query parameter (`?pseudolocalization=true`) or app-config
+ * (`i18n.pseudolocalization.enabled: true`).
+ *
+ * @public
+ */
+declare function attachPseudolocalizationIfEnabled(translationApi: I18nextTranslationApi, configApi: ConfigApi, locationSearch?: string): void;
+
+/**
+ * @public
+ */
+declare const translationsPlugin: _backstage_core_plugin_api.BackstagePlugin<{
+    root: _backstage_core_plugin_api.RouteRef<undefined>;
+}, {}, {}>;
+/**
+ * @public
+ */
+declare const TranslationsPage: () => react_jsx_runtime.JSX.Element;
+/**
+ * Export Translation Keys
+ * @public
+ */
+declare const ExportTranslationKeys: ({ resources, }: {
+    resources: _backstage_frontend_plugin_api.TranslationRef[];
+}) => react_jsx_runtime.JSX.Element;
+
+/**
+ * Provider component that enables pseudo-localization when activated via
+ * URL query parameter (`?pseudolocalization=true`) or app-config
+ * (`i18n.pseudolocalization.enabled: true`).
+ *
+ * Requires the TranslationApi implementation to expose `getI18nInstance()`.
+ * When the built-in NFS API is used (which does not have this method),
+ * pseudo-localization is silently skipped.
+ *
+ * @public
+ */
+declare const PseudoLocalizationProvider: ({ children, }: PropsWithChildren<{}>) => react_jsx_runtime.JSX.Element;
+
+export { ExportTranslationKeys, I18nextTranslationApi, PseudoLocalizationProvider, TranslationsPage, attachPseudolocalization, attachPseudolocalizationIfEnabled, translationsPlugin };
+export type { I18nextTranslationApiOptions, PseudolocalizationOptions };

package/dist/legacy.esm.js

@@ -0,0 +1,5 @@
+export { I18nextTranslationApi } from './apis/I18nextTranslationApi.esm.js';
+export { attachPseudolocalization, attachPseudolocalizationIfEnabled } from './apis/pseudolocalization.esm.js';
+export { ExportTranslationKeys, TranslationsPage, translationsPlugin } from './plugin.esm.js';
+export { PseudoLocalizationProvider } from './components/PseudoLocalizationProvider.esm.js';
+//# sourceMappingURL=legacy.esm.js.map

package/dist/legacy.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}

package/dist/translations/index.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.js","sources":["../../src/translations/index.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\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 */\nimport { createTranslationResource } from '@backstage/core-plugin-api/alpha';\nimport { translationsPluginTranslationRef } from './ref';\n\n/**\n *  @alpha\n *\n */\nexport const translationsPluginTranslations = createTranslationResource({\n  ref: translationsPluginTranslationRef,\n  translations: {\n    de: () => import('./de'),\n    es: () => import('./es'),\n    fr: () => import('./fr'),\n    it: () => import('./it'),\n    ja: () => import('./ja'),\n  },\n});\n/**\n * @alpha\n */\nexport { translationsPluginTranslationRef };\n"],"names":[],"mappings":";;;AAsBO,MAAM,iCAAiC,yBAAA,CAA0B;AAAA,EACtE,GAAA,EAAK,gCAAA;AAAA,EACL,YAAA,EAAc;AAAA,IACZ,EAAA,EAAI,MAAM,OAAO,aAAM,CAAA;AAAA,IACvB,EAAA,EAAI,MAAM,OAAO,aAAM,CAAA;AAAA,IACvB,EAAA,EAAI,MAAM,OAAO,aAAM,CAAA;AAAA,IACvB,EAAA,EAAI,MAAM,OAAO,aAAM,CAAA;AAAA,IACvB,EAAA,EAAI,MAAM,OAAO,aAAM;AAAA;AAE3B,CAAC;;;;"}
+{"version":3,"file":"index.esm.js","sources":["../../src/translations/index.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\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 */\nimport { createTranslationResource } from '@backstage/core-plugin-api/alpha';\nimport { translationsPluginTranslationRef } from './ref';\n\n/**\n * @public\n */\nexport const translationsPluginTranslations = createTranslationResource({\n  ref: translationsPluginTranslationRef,\n  translations: {\n    de: () => import('./de'),\n    es: () => import('./es'),\n    fr: () => import('./fr'),\n    it: () => import('./it'),\n    ja: () => import('./ja'),\n  },\n});\n\n/**\n * @public\n */\nexport { translationsPluginTranslationRef };\n"],"names":[],"mappings":";;;AAqBO,MAAM,iCAAiC,yBAAA,CAA0B;AAAA,EACtE,GAAA,EAAK,gCAAA;AAAA,EACL,YAAA,EAAc;AAAA,IACZ,EAAA,EAAI,MAAM,OAAO,aAAM,CAAA;AAAA,IACvB,EAAA,EAAI,MAAM,OAAO,aAAM,CAAA;AAAA,IACvB,EAAA,EAAI,MAAM,OAAO,aAAM,CAAA;AAAA,IACvB,EAAA,EAAI,MAAM,OAAO,aAAM,CAAA;AAAA,IACvB,EAAA,EAAI,MAAM,OAAO,aAAM;AAAA;AAE3B,CAAC;;;;"}

package/dist/translations/ref.esm.js

@@ -33,7 +33,14 @@ const translationsMessages = {
 };
 const translationsPluginTranslationRef = createTranslationRef({
   id: "plugin.translations",
-  messages: translationsMessages
+  messages: translationsMessages,
+  translations: {
+    de: () => import('./de.esm.js'),
+    es: () => import('./es.esm.js'),
+    fr: () => import('./fr.esm.js'),
+    it: () => import('./it.esm.js'),
+    ja: () => import('./ja.esm.js')
+  }
 });
 
 export { translationsMessages, translationsPluginTranslationRef };

package/dist/translations/ref.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"ref.esm.js","sources":["../../src/translations/ref.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\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 */\nimport { createTranslationRef } from '@backstage/core-plugin-api/alpha';\n\n/**\n * @alpha\n */\nexport const translationsMessages = {\n  page: {\n    title: 'Translations',\n    subtitle: 'Manage and view loaded translations',\n  },\n  table: {\n    title: 'Loaded translations ({{count}})',\n    headers: {\n      refId: 'Ref ID',\n      key: 'Key',\n    },\n    options: {\n      pageSize: 'Items per page',\n      pageSizeOptions: 'Show {{count}} items',\n    },\n  },\n  export: {\n    title: 'Translations',\n    downloadButton: 'Download default translations (English)',\n    filename: 'translations-{{timestamp}}.json',\n  },\n  common: {\n    loading: 'Loading...',\n    error: 'An error occurred',\n    noData: 'No data available',\n    refresh: 'Refresh',\n  },\n  language: {\n    displayFormat: '{{displayName}} ({{code}})',\n  },\n};\n/**\n * @alpha\n */\nexport const translationsPluginTranslationRef = createTranslationRef({\n  id: 'plugin.translations',\n  messages: translationsMessages,\n});\n"],"names":[],"mappings":";;AAoBO,MAAM,oBAAA,GAAuB;AAAA,EAClC,IAAA,EAAM;AAAA,IACJ,KAAA,EAAO,cAAA;AAAA,IACP,QAAA,EAAU;AAAA,GACZ;AAAA,EACA,KAAA,EAAO;AAAA,IACL,KAAA,EAAO,iCAAA;AAAA,IACP,OAAA,EAAS;AAAA,MACP,KAAA,EAAO,QAAA;AAAA,MACP,GAAA,EAAK;AAAA,KACP;AAAA,IACA,OAAA,EAAS;AAAA,MACP,QAAA,EAAU,gBAAA;AAAA,MACV,eAAA,EAAiB;AAAA;AACnB,GACF;AAAA,EACA,MAAA,EAAQ;AAAA,IACN,KAAA,EAAO,cAAA;AAAA,IACP,cAAA,EAAgB,yCAAA;AAAA,IAChB,QAAA,EAAU;AAAA,GACZ;AAAA,EACA,MAAA,EAAQ;AAAA,IACN,OAAA,EAAS,YAAA;AAAA,IACT,KAAA,EAAO,mBAAA;AAAA,IACP,MAAA,EAAQ,mBAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACX;AAAA,EACA,QAAA,EAAU;AAAA,IACR,aAAA,EAAe;AAAA;AAEnB;AAIO,MAAM,mCAAmC,oBAAA,CAAqB;AAAA,EACnE,EAAA,EAAI,qBAAA;AAAA,EACJ,QAAA,EAAU;AACZ,CAAC;;;;"}
+{"version":3,"file":"ref.esm.js","sources":["../../src/translations/ref.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\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 */\nimport { createTranslationRef } from '@backstage/core-plugin-api/alpha';\n\n/**\n * @public\n */\nexport const translationsMessages = {\n  page: {\n    title: 'Translations',\n    subtitle: 'Manage and view loaded translations',\n  },\n  table: {\n    title: 'Loaded translations ({{count}})',\n    headers: {\n      refId: 'Ref ID',\n      key: 'Key',\n    },\n    options: {\n      pageSize: 'Items per page',\n      pageSizeOptions: 'Show {{count}} items',\n    },\n  },\n  export: {\n    title: 'Translations',\n    downloadButton: 'Download default translations (English)',\n    filename: 'translations-{{timestamp}}.json',\n  },\n  common: {\n    loading: 'Loading...',\n    error: 'An error occurred',\n    noData: 'No data available',\n    refresh: 'Refresh',\n  },\n  language: {\n    displayFormat: '{{displayName}} ({{code}})',\n  },\n};\n/**\n * @public\n */\nexport const translationsPluginTranslationRef = createTranslationRef({\n  id: 'plugin.translations',\n  messages: translationsMessages,\n  translations: {\n    de: () => import('./de') as any,\n    es: () => import('./es') as any,\n    fr: () => import('./fr') as any,\n    it: () => import('./it') as any,\n    ja: () => import('./ja') as any,\n  },\n});\n"],"names":[],"mappings":";;AAoBO,MAAM,oBAAA,GAAuB;AAAA,EAClC,IAAA,EAAM;AAAA,IACJ,KAAA,EAAO,cAAA;AAAA,IACP,QAAA,EAAU;AAAA,GACZ;AAAA,EACA,KAAA,EAAO;AAAA,IACL,KAAA,EAAO,iCAAA;AAAA,IACP,OAAA,EAAS;AAAA,MACP,KAAA,EAAO,QAAA;AAAA,MACP,GAAA,EAAK;AAAA,KACP;AAAA,IACA,OAAA,EAAS;AAAA,MACP,QAAA,EAAU,gBAAA;AAAA,MACV,eAAA,EAAiB;AAAA;AACnB,GACF;AAAA,EACA,MAAA,EAAQ;AAAA,IACN,KAAA,EAAO,cAAA;AAAA,IACP,cAAA,EAAgB,yCAAA;AAAA,IAChB,QAAA,EAAU;AAAA,GACZ;AAAA,EACA,MAAA,EAAQ;AAAA,IACN,OAAA,EAAS,YAAA;AAAA,IACT,KAAA,EAAO,mBAAA;AAAA,IACP,MAAA,EAAQ,mBAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACX;AAAA,EACA,QAAA,EAAU;AAAA,IACR,aAAA,EAAe;AAAA;AAEnB;AAIO,MAAM,mCAAmC,oBAAA,CAAqB;AAAA,EACnE,EAAA,EAAI,qBAAA;AAAA,EACJ,QAAA,EAAU,oBAAA;AAAA,EACV,YAAA,EAAc;AAAA,IACZ,EAAA,EAAI,MAAM,OAAO,aAAM,CAAA;AAAA,IACvB,EAAA,EAAI,MAAM,OAAO,aAAM,CAAA;AAAA,IACvB,EAAA,EAAI,MAAM,OAAO,aAAM,CAAA;AAAA,IACvB,EAAA,EAAI,MAAM,OAAO,aAAM,CAAA;AAAA,IACvB,EAAA,EAAI,MAAM,OAAO,aAAM;AAAA;AAE3B,CAAC;;;;"}

package/dist/translations-api-module.d.ts

@@ -0,0 +1,4 @@
+export { translationsApiModule as default } from './index.js';
+import 'react';
+import '@backstage/frontend-plugin-api';
+import './alpha.js';

package/dist/translations-api-module.esm.js

@@ -0,0 +1,2 @@
+export { translationsApiModule as default } from './index.esm.js';
+//# sourceMappingURL=translations-api-module.esm.js.map

package/dist/translations-api-module.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translations-api-module.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/translations-pseudo-localization-module.d.ts

@@ -0,0 +1,4 @@
+export { translationsPseudoLocalizationModule as default } from './index.js';
+import 'react';
+import '@backstage/frontend-plugin-api';
+import './alpha.js';

package/dist/translations-pseudo-localization-module.esm.js

@@ -0,0 +1,2 @@
+export { translationsPseudoLocalizationModule as default } from './index.esm.js';
+//# sourceMappingURL=translations-pseudo-localization-module.esm.js.map

package/dist/translations-pseudo-localization-module.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translations-pseudo-localization-module.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@red-hat-developer-hub/backstage-plugin-translations",
-  "version": "0.3.1",
+  "version": "0.5.0",
   "license": "Apache-2.0",
   "publishConfig": {
     "access": "public"
   },
   "exports": {
     ".": {
+      "backstage": "@backstage/FrontendPlugin",
       "import": "./dist/index.esm.js",
       "types": "./dist/index.d.ts",
       "default": "./dist/index.esm.js"
@@ -16,6 +17,23 @@
       "types": "./dist/alpha.d.ts",
       "default": "./dist/alpha.esm.js"
     },
+    "./legacy": {
+      "import": "./dist/legacy.esm.js",
+      "types": "./dist/legacy.d.ts",
+      "default": "./dist/legacy.esm.js"
+    },
+    "./translations-api-module": {
+      "backstage": "@backstage/FrontendModule",
+      "import": "./dist/translations-api-module.esm.js",
+      "types": "./dist/translations-api-module.d.ts",
+      "default": "./dist/translations-api-module.esm.js"
+    },
+    "./translations-pseudo-localization-module": {
+      "backstage": "@backstage/FrontendModule",
+      "import": "./dist/translations-pseudo-localization-module.esm.js",
+      "types": "./dist/translations-pseudo-localization-module.d.ts",
+      "default": "./dist/translations-pseudo-localization-module.esm.js"
+    },
     "./package.json": "./package.json"
   },
   "typesVersions": {
@@ -23,6 +41,15 @@
       "alpha": [
         "dist/alpha.d.ts"
       ],
+      "legacy": [
+        "dist/legacy.d.ts"
+      ],
+      "translations-api-module": [
+        "dist/translations-api-module.d.ts"
+      ],
+      "translations-pseudo-localization-module": [
+        "dist/translations-pseudo-localization-module.d.ts"
+      ],
       "package.json": [
         "package.json"
       ]
@@ -35,17 +62,34 @@
     "url": "https://github.com/redhat-developer/rhdh-plugins",
     "directory": "workspaces/translations/plugins/translations"
   },
+  "configSchema": "config.schema.json",
   "backstage": {
     "role": "frontend-plugin",
     "pluginId": "translations",
     "pluginPackages": [
       "@red-hat-developer-hub/backstage-plugin-translations",
       "@red-hat-developer-hub/backstage-plugin-translations-backend"
-    ]
+    ],
+    "features": {
+      ".": "@backstage/FrontendPlugin",
+      "./translations-api-module": "@backstage/FrontendModule",
+      "./translations-pseudo-localization-module": "@backstage/FrontendModule"
+    }
+  },
+  "scalprum": {
+    "name": "red-hat-developer-hub.backstage-plugin-translations",
+    "exposedModules": {
+      "PluginRoot": "./src/index.tsx",
+      "Alpha": "./src/alpha.ts",
+      "Legacy": "./src/legacy.ts",
+      "TranslationsApiModule": "./src/translationsApiModuleExport.ts",
+      "TranslationsPseudoLocalizationModule": "./src/translationsPseudoLocalizationModuleExport.ts"
+    }
   },
   "sideEffects": false,
   "scripts": {
     "start": "backstage-cli package start",
+    "start:legacy": "backstage-cli package start --entrypoint dev/legacy.tsx",
     "build": "backstage-cli package build",
     "lint": "backstage-cli package lint",
     "test": "backstage-cli package test",
@@ -54,24 +98,28 @@
     "postpack": "backstage-cli package postpack"
   },
   "dependencies": {
-    "@backstage/core-components": "^0.18.8",
-    "@backstage/core-plugin-api": "^1.12.4",
-    "@backstage/plugin-user-settings": "^0.9.1",
-    "@backstage/theme": "^0.7.2",
+    "@backstage/core-components": "^0.18.13",
+    "@backstage/core-plugin-api": "^1.12.9",
+    "@backstage/plugin-user-settings": "^0.9.6",
+    "@backstage/theme": "^0.7.3",
     "@backstage/types": "^1.2.2",
     "@mui/icons-material": "5.18.0",
     "@mui/material": "5.18.0",
     "i18next": "^22.4.15",
+    "i18next-pseudo": "^2.2.1",
     "zen-observable": "^0.10.0"
   },
   "peerDependencies": {
-    "react": "^16.13.1 || ^17.0.0 || ^18.0.0"
+    "react": "^16.13.1 || ^17.0.0 || ^18.0.0",
+    "react-dom": "*"
   },
   "devDependencies": {
-    "@backstage/cli": "^0.36.0",
-    "@backstage/core-app-api": "^1.19.6",
-    "@backstage/dev-utils": "^1.1.21",
-    "@backstage/test-utils": "^1.7.16",
+    "@backstage/cli": "^0.36.5",
+    "@backstage/config": "^1.3.8",
+    "@backstage/core-app-api": "^1.20.4",
+    "@backstage/dev-utils": "^1.1.26",
+    "@backstage/frontend-defaults": "^0.5.5",
+    "@backstage/test-utils": "^1.7.21",
     "@testing-library/jest-dom": "^6.0.0",
     "@testing-library/react": "^14.0.0",
     "@testing-library/user-event": "^14.0.0",
@@ -80,7 +128,9 @@
     "react": "^16.13.1 || ^17.0.0 || ^18.0.0"
   },
   "files": [
-    "dist"
+    "app-config.dynamic.yaml",
+    "dist",
+    "config.schema.json"
   ],
   "module": "./dist/index.esm.js"
 }