From 527203350e9279ad1b67678a3cbfc93b472967b5 Mon Sep 17 00:00:00 2001
From: Wilhelm Behncke <2522299+grebaldi@users.noreply.github.com>
Date: Tue, 14 Jan 2025 14:55:19 +0100
Subject: [PATCH] !!!FEATURE: Reform i18n mechanism (#3804)
Prelude to: https://github.com/neos/neos-ui/pull/3773
refs: https://github.com/neos/neos-ui/issues/3119
This PR reforms the UI's i18n mechanism by exposing a new function `translate` directly from the `@neos-project/neos-ui-i18n` package.
The function looks as follows:
```typescript
function translate(
fullyQualifiedTranslationAddressAsString: string,
fallback: string | [string, string],
parameters: Parameters = [],
quantity: number = 0
): string;
```
And can be used like this:
```typescript
translate(
'Neos.Neos:Main:workspaces.allChangesInWorkspaceHaveBeenDiscarded',
'All changes from workspace "{0}" have been discarded.',
['user-admin']
);
// output (en): All changes from workspace "user-admin" have been discarded.
```
The new mechanism is completely independent from registries. There's no longer a need for injecting the `I18nRegistry` to use translations, instead `translate` can be used directly.
`translate` will only work after the translations have been loaded during the bootstrapping process of `@neos-project/neos-ui`. If it is used too early, it throws an exception.
The function now also properly supports plural rules (via [`Intl` Web API](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl)). Tha `I18nRegistry` had only supported English plurals, but with broken rules (quantity=0 yielded singular instead of plural).
Other changes included in this PR are:
- Everything in `@neos-project/neos-ui-i18n` is now TypeScript (save `manifest.js`)
- The ``-component was deprecated
- The `I18nRegistry` is now properly documented, but was also deprecated
- The `xliff.json` endpoint is now discovered via ``-tag, instead of initial data
- The ``-tag is marked with `prefetch` to slightly speed up the fetch request
- The `@neos-project/neos-ui-i18n` now has a comprehensive README.md
This change is breaking, because translations may have relied on the broken plural rules. It is also breaking, because the signature for substitution parameters has changed slightly - although this should be non-breaking at runtime.
---
.eslintrc.js | 5 +-
...-fetch-npm-4.0.0-9c67668db4-ecca4f37ff.zip | Bin 0 -> 30760 bytes
...-fetch-npm-2.7.0-587d57004e-d76d2f5edb.zip | Bin 0 -> 47935 bytes
Classes/Presentation/ApplicationView.php | 14 +
package.json | 1 +
.../src/setupBrowserEnv.js | 3 +-
packages/neos-ts-interfaces/package.json | 3 +
packages/neos-ts-interfaces/src/index.ts | 7 +-
.../SelectBox/selectBoxHelpers.spec.ts | 4 +-
.../container/ErrorBoundary/ErrorBoundary.tsx | 2 +-
packages/neos-ui-i18n/README.md | 244 ++++++++++++++
packages/neos-ui-i18n/package.json | 4 +-
.../neos-ui-i18n/src/component/I18n.spec.tsx | 41 +++
packages/neos-ui-i18n/src/component/I18n.tsx | 43 +++
packages/neos-ui-i18n/src/component/index.ts | 10 +
.../neos-ui-i18n/src/global/globals.spec.ts | 45 +++
packages/neos-ui-i18n/src/global/globals.ts | 64 ++++
packages/neos-ui-i18n/src/global/index.ts | 13 +
.../src/global/initializeI18n.spec.ts | 196 +++++++++++
.../neos-ui-i18n/src/global/initializeI18n.ts | 113 +++++++
.../neos-ui-i18n/src/global/setupI18n.spec.ts | 45 +++
packages/neos-ui-i18n/src/global/setupI18n.ts | 37 +++
.../src/global/teardownI18n.spec.ts | 34 ++
.../neos-ui-i18n/src/global/teardownI18n.ts | 20 ++
packages/neos-ui-i18n/src/index.spec.js | 22 --
packages/neos-ui-i18n/src/index.ts | 16 +
packages/neos-ui-i18n/src/index.tsx | 39 ---
packages/neos-ui-i18n/src/manifest.js | 11 +-
.../neos-ui-i18n/src/model/Locale.spec.ts | 50 +++
packages/neos-ui-i18n/src/model/Locale.ts | 66 ++++
packages/neos-ui-i18n/src/model/Parameters.ts | 14 +
.../neos-ui-i18n/src/model/PluralRule.spec.ts | 39 +++
packages/neos-ui-i18n/src/model/PluralRule.ts | 66 ++++
.../src/model/PluralRules.spec.ts | 50 +++
.../neos-ui-i18n/src/model/PluralRules.ts | 52 +++
.../src/model/Translation.spec.ts | 142 ++++++++
.../neos-ui-i18n/src/model/Translation.ts | 48 +++
.../src/model/TranslationAddress.spec.ts | 44 +++
.../src/model/TranslationAddress.ts | 52 +++
.../src/model/TranslationRepository.spec.ts | 35 ++
.../src/model/TranslationRepository.ts | 44 +++
packages/neos-ui-i18n/src/model/index.ts | 17 +
.../neos-ui-i18n/src/registry/I18nRegistry.js | 111 -------
.../src/registry/I18nRegistry.spec.js | 180 ----------
.../src/registry/I18nRegistry.spec.ts | 113 +++++++
.../neos-ui-i18n/src/registry/I18nRegistry.ts | 214 ++++++++++++
.../src/registry/LegacyParameters.ts | 10 +
.../registry/getTranslationAddress.spec.ts | 34 ++
.../src/registry/getTranslationAddress.ts | 38 +++
packages/neos-ui-i18n/src/registry/index.js | 5 -
packages/neos-ui-i18n/src/registry/index.ts | 15 +
.../registry/substitutePlaceholders.spec.ts | 182 +++++++++++
.../src/registry/substitutePlaceholders.ts | 66 ++++
packages/neos-ui-i18n/src/translate.spec.ts | 308 ++++++++++++++++++
packages/neos-ui-i18n/src/translate.ts | 68 ++++
.../neos-ui-sagas/src/UI/Impersonate/index.js | 15 +-
.../SyncWorkspaceDialog/ConflictList.tsx | 3 +-
.../ResolutionStrategyConfirmationDialog.tsx | 4 +-
.../ResolutionStrategySelectionDialog.tsx | 4 +-
.../SyncWorkspaceDialog.tsx | 3 +-
.../WorkspaceSync/WorkspaceSync.tsx | 3 +-
.../Inspector/PropertyGroup/index.spec.js | 11 +
packages/neos-ui/src/index.js | 11 +-
yarn.lock | 27 +-
64 files changed, 2776 insertions(+), 404 deletions(-)
create mode 100644 .yarn/cache/cross-fetch-npm-4.0.0-9c67668db4-ecca4f37ff.zip
create mode 100644 .yarn/cache/node-fetch-npm-2.7.0-587d57004e-d76d2f5edb.zip
create mode 100644 packages/neos-ui-i18n/README.md
create mode 100644 packages/neos-ui-i18n/src/component/I18n.spec.tsx
create mode 100644 packages/neos-ui-i18n/src/component/I18n.tsx
create mode 100644 packages/neos-ui-i18n/src/component/index.ts
create mode 100644 packages/neos-ui-i18n/src/global/globals.spec.ts
create mode 100644 packages/neos-ui-i18n/src/global/globals.ts
create mode 100644 packages/neos-ui-i18n/src/global/index.ts
create mode 100644 packages/neos-ui-i18n/src/global/initializeI18n.spec.ts
create mode 100644 packages/neos-ui-i18n/src/global/initializeI18n.ts
create mode 100644 packages/neos-ui-i18n/src/global/setupI18n.spec.ts
create mode 100644 packages/neos-ui-i18n/src/global/setupI18n.ts
create mode 100644 packages/neos-ui-i18n/src/global/teardownI18n.spec.ts
create mode 100644 packages/neos-ui-i18n/src/global/teardownI18n.ts
delete mode 100644 packages/neos-ui-i18n/src/index.spec.js
create mode 100644 packages/neos-ui-i18n/src/index.ts
delete mode 100644 packages/neos-ui-i18n/src/index.tsx
create mode 100644 packages/neos-ui-i18n/src/model/Locale.spec.ts
create mode 100644 packages/neos-ui-i18n/src/model/Locale.ts
create mode 100644 packages/neos-ui-i18n/src/model/Parameters.ts
create mode 100644 packages/neos-ui-i18n/src/model/PluralRule.spec.ts
create mode 100644 packages/neos-ui-i18n/src/model/PluralRule.ts
create mode 100644 packages/neos-ui-i18n/src/model/PluralRules.spec.ts
create mode 100644 packages/neos-ui-i18n/src/model/PluralRules.ts
create mode 100644 packages/neos-ui-i18n/src/model/Translation.spec.ts
create mode 100644 packages/neos-ui-i18n/src/model/Translation.ts
create mode 100644 packages/neos-ui-i18n/src/model/TranslationAddress.spec.ts
create mode 100644 packages/neos-ui-i18n/src/model/TranslationAddress.ts
create mode 100644 packages/neos-ui-i18n/src/model/TranslationRepository.spec.ts
create mode 100644 packages/neos-ui-i18n/src/model/TranslationRepository.ts
create mode 100644 packages/neos-ui-i18n/src/model/index.ts
delete mode 100644 packages/neos-ui-i18n/src/registry/I18nRegistry.js
delete mode 100644 packages/neos-ui-i18n/src/registry/I18nRegistry.spec.js
create mode 100644 packages/neos-ui-i18n/src/registry/I18nRegistry.spec.ts
create mode 100644 packages/neos-ui-i18n/src/registry/I18nRegistry.ts
create mode 100644 packages/neos-ui-i18n/src/registry/LegacyParameters.ts
create mode 100644 packages/neos-ui-i18n/src/registry/getTranslationAddress.spec.ts
create mode 100644 packages/neos-ui-i18n/src/registry/getTranslationAddress.ts
delete mode 100644 packages/neos-ui-i18n/src/registry/index.js
create mode 100644 packages/neos-ui-i18n/src/registry/index.ts
create mode 100644 packages/neos-ui-i18n/src/registry/substitutePlaceholders.spec.ts
create mode 100644 packages/neos-ui-i18n/src/registry/substitutePlaceholders.ts
create mode 100644 packages/neos-ui-i18n/src/translate.spec.ts
create mode 100644 packages/neos-ui-i18n/src/translate.ts
diff --git a/.eslintrc.js b/.eslintrc.js
index cfff665808..b25c1fd719 100644
--- a/.eslintrc.js
+++ b/.eslintrc.js
@@ -30,6 +30,9 @@ module.exports = {
'default-case': 'off',
'no-mixed-operators': 'off',
'no-negated-condition': 'off',
- 'complexity': 'off'
+ 'complexity': 'off',
+
+ // This rule would prevent us from implementing meaningful value objects
+ 'no-useless-constructor': 'off'
},
}
diff --git a/.yarn/cache/cross-fetch-npm-4.0.0-9c67668db4-ecca4f37ff.zip b/.yarn/cache/cross-fetch-npm-4.0.0-9c67668db4-ecca4f37ff.zip
new file mode 100644
index 0000000000000000000000000000000000000000..bddbef91a20ac444aa633999625641f72f7d327b
GIT binary patch
literal 30760
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