use-intl 2.7.3 → 2.7.4-alpha.2

package/dist/use-intl.esm8.js

@@ -1,42 +1,50 @@
-import { inheritsLoose as _inheritsLoose, wrapNativeSuper as _wrapNativeSuper } from './_virtual/use-intl.esm.js';
-
-var IntlErrorCode;
-
-(function (IntlErrorCode) {
-  IntlErrorCode["MISSING_MESSAGE"] = "MISSING_MESSAGE";
-  IntlErrorCode["MISSING_FORMAT"] = "MISSING_FORMAT";
-  IntlErrorCode["INSUFFICIENT_PATH"] = "INSUFFICIENT_PATH";
-  IntlErrorCode["INVALID_MESSAGE"] = "INVALID_MESSAGE";
-  IntlErrorCode["INVALID_KEY"] = "INVALID_KEY";
-  IntlErrorCode["FORMATTING_ERROR"] = "FORMATTING_ERROR";
-})(IntlErrorCode || (IntlErrorCode = {}));
-
-var IntlError = /*#__PURE__*/function (_Error) {
-  _inheritsLoose(IntlError, _Error);
-
-  function IntlError(code, originalMessage) {
-    var _this;
-
-    var message = code;
-
-    if (originalMessage) {
-      message += ': ' + originalMessage;
-    }
-
-    _this = _Error.call(this, message) || this;
-    _this.code = void 0;
-    _this.originalMessage = void 0;
-    _this.code = code;
-
-    if (originalMessage) {
-      _this.originalMessage = originalMessage;
-    }
-
-    return _this;
-  }
-
-  return IntlError;
-}( /*#__PURE__*/_wrapNativeSuper(Error));
-
-export { IntlErrorCode, IntlError as default };
+import { useState, useEffect } from 'react';
+import useIntlContext from './use-intl.esm11.js';
+
+function getNow() {
+  return new Date();
+}
+/**
+ * Reading the current date via `new Date()` in components should be avoided, as
+ * it causes components to be impure and can lead to flaky tests. Instead, this
+ * hook can be used.
+ *
+ * By default, it returns the time when the component mounts. If `updateInterval`
+ * is specified, the value will be updated based on the interval.
+ *
+ * You can however also return a static value from this hook, if you
+ * configure the `now` parameter on the context provider. Note however,
+ * that if `updateInterval` is configured in this case, the component
+ * will initialize with the global value, but will afterwards update
+ * continuously based on the interval.
+ *
+ * For unit tests, this can be mocked to a constant value. For end-to-end
+ * testing, an environment parameter can be passed to the `now` parameter
+ * of the provider to mock this to a static value.
+ */
+
+
+function useNow(options) {
+  var updateInterval = options == null ? void 0 : options.updateInterval;
+
+  var _useIntlContext = useIntlContext(),
+      globalNow = _useIntlContext.now;
+
+  var _useState = useState(globalNow || getNow()),
+      now = _useState[0],
+      setNow = _useState[1];
+
+  useEffect(function () {
+    if (!updateInterval) return;
+    var intervalId = setInterval(function () {
+      setNow(getNow());
+    }, updateInterval);
+    return function () {
+      clearInterval(intervalId);
+    };
+  }, [globalNow, updateInterval]);
+  return now;
+}
+
+export { useNow as default };
 //# sourceMappingURL=use-intl.esm8.js.map

package/dist/use-intl.esm8.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-intl.esm8.js","sources":["../src/IntlError.tsx"],"sourcesContent":["export enum IntlErrorCode {\n  MISSING_MESSAGE = 'MISSING_MESSAGE',\n  MISSING_FORMAT = 'MISSING_FORMAT',\n  INSUFFICIENT_PATH = 'INSUFFICIENT_PATH',\n  INVALID_MESSAGE = 'INVALID_MESSAGE',\n  INVALID_KEY = 'INVALID_KEY',\n  FORMATTING_ERROR = 'FORMATTING_ERROR'\n}\n\nexport default class IntlError extends Error {\n  public readonly code: IntlErrorCode;\n  public readonly originalMessage: string | undefined;\n\n  constructor(code: IntlErrorCode, originalMessage?: string) {\n    let message: string = code;\n    if (originalMessage) {\n      message += ': ' + originalMessage;\n    }\n    super(message);\n\n    this.code = code;\n    if (originalMessage) {\n      this.originalMessage = originalMessage;\n    }\n  }\n}\n"],"names":["IntlErrorCode","IntlError","code","originalMessage","message","Error"],"mappings":";;IAAYA,cAAZ;;AAAA,CAAA,UAAYA,aAAZ,EAAyB;AACvBA,EAAAA,aAAA,CAAA,iBAAA,CAAA,GAAA,iBAAA,CAAA;AACAA,EAAAA,aAAA,CAAA,gBAAA,CAAA,GAAA,gBAAA,CAAA;AACAA,EAAAA,aAAA,CAAA,mBAAA,CAAA,GAAA,mBAAA,CAAA;AACAA,EAAAA,aAAA,CAAA,iBAAA,CAAA,GAAA,iBAAA,CAAA;AACAA,EAAAA,aAAA,CAAA,aAAA,CAAA,GAAA,aAAA,CAAA;AACAA,EAAAA,aAAA,CAAA,kBAAA,CAAA,GAAA,kBAAA,CAAA;AACD,CAPD,EAAYA,aAAa,KAAbA,aAAa,GAOxB,EAPwB,CAAzB,CAAA,CAAA;;IASqBC;;;AAInB,EAAYC,SAAAA,SAAAA,CAAAA,IAAZ,EAAiCC,eAAjC,EAAyD;AAAA,IAAA,IAAA,KAAA,CAAA;;AACvD,IAAIC,IAAAA,OAAO,GAAWF,IAAtB,CAAA;;AACA,IAAA,IAAIC,eAAJ,EAAqB;AACnBC,MAAAA,OAAO,IAAI,IAAA,GAAOD,eAAlB,CAAA;AACD,KAAA;;AACD,IAAA,KAAA,GAAA,MAAA,CAAA,IAAA,CAAA,IAAA,EAAMC,OAAN,CAAA,IAAA,IAAA,CAAA;AALuD,IAAA,KAAA,CAHzCF,IAGyC,GAAA,KAAA,CAAA,CAAA;AAAA,IAAA,KAAA,CAFzCC,eAEyC,GAAA,KAAA,CAAA,CAAA;AAOvD,IAAKD,KAAAA,CAAAA,IAAL,GAAYA,IAAZ,CAAA;;AACA,IAAA,IAAIC,eAAJ,EAAqB;AACnB,MAAKA,KAAAA,CAAAA,eAAL,GAAuBA,eAAvB,CAAA;AACD,KAAA;;AAVsD,IAAA,OAAA,KAAA,CAAA;AAWxD,GAAA;;;iCAfoCE;;;;"}
+{"version":3,"file":"use-intl.esm8.js","sources":["../src/useNow.tsx"],"sourcesContent":["import {useState, useEffect} from 'react';\nimport useIntlContext from './useIntlContext';\n\ntype Options = {\n  updateInterval?: number;\n};\n\nfunction getNow() {\n  return new Date();\n}\n\n/**\n * Reading the current date via `new Date()` in components should be avoided, as\n * it causes components to be impure and can lead to flaky tests. Instead, this\n * hook can be used.\n *\n * By default, it returns the time when the component mounts. If `updateInterval`\n * is specified, the value will be updated based on the interval.\n *\n * You can however also return a static value from this hook, if you\n * configure the `now` parameter on the context provider. Note however,\n * that if `updateInterval` is configured in this case, the component\n * will initialize with the global value, but will afterwards update\n * continuously based on the interval.\n *\n * For unit tests, this can be mocked to a constant value. For end-to-end\n * testing, an environment parameter can be passed to the `now` parameter\n * of the provider to mock this to a static value.\n */\nexport default function useNow(options?: Options) {\n  const updateInterval = options?.updateInterval;\n\n  const {now: globalNow} = useIntlContext();\n  const [now, setNow] = useState(globalNow || getNow());\n\n  useEffect(() => {\n    if (!updateInterval) return;\n\n    const intervalId = setInterval(() => {\n      setNow(getNow());\n    }, updateInterval);\n\n    return () => {\n      clearInterval(intervalId);\n    };\n  }, [globalNow, updateInterval]);\n\n  return now;\n}\n"],"names":["getNow","Date","useNow","options","updateInterval","useIntlContext","globalNow","now","useState","setNow","useEffect","intervalId","setInterval","clearInterval"],"mappings":";;;AAOA,SAASA,MAAT,GAAe;AACb,EAAO,OAAA,IAAIC,IAAJ,EAAP,CAAA;AACD,CAAA;AAED;;;;;;;;;;;;;;;;;AAiBG;;;AACqB,SAAAC,MAAA,CAAOC,OAAP,EAAwB;AAC9C,EAAA,IAAMC,cAAc,GAAGD,OAAH,IAAGA,IAAAA,GAAAA,KAAAA,CAAAA,GAAAA,OAAO,CAAEC,cAAhC,CAAA;;AAEA,EAAA,IAAA,eAAA,GAAyBC,cAAc,EAAvC;AAAA,MAAYC,SAAZ,mBAAOC,GAAP,CAAA;;AACA,EAAA,IAAA,SAAA,GAAsBC,QAAQ,CAACF,SAAS,IAAIN,MAAM,EAApB,CAA9B;AAAA,MAAOO,GAAP,GAAA,SAAA,CAAA,CAAA,CAAA;AAAA,MAAYE,MAAZ,GAAA,SAAA,CAAA,CAAA,CAAA,CAAA;;AAEAC,EAAAA,SAAS,CAAC,YAAK;AACb,IAAI,IAAA,CAACN,cAAL,EAAqB,OAAA;AAErB,IAAA,IAAMO,UAAU,GAAGC,WAAW,CAAC,YAAK;AAClCH,MAAAA,MAAM,CAACT,MAAM,EAAP,CAAN,CAAA;AACD,KAF6B,EAE3BI,cAF2B,CAA9B,CAAA;AAIA,IAAA,OAAO,YAAK;AACVS,MAAAA,aAAa,CAACF,UAAD,CAAb,CAAA;AACD,KAFD,CAAA;AAGD,GAVQ,EAUN,CAACL,SAAD,EAAYF,cAAZ,CAVM,CAAT,CAAA;AAYA,EAAA,OAAOG,GAAP,CAAA;AACD;;;;"}

package/dist/use-intl.esm9.js

@@ -1,6 +1,32 @@
-import { createContext } from 'react';
+import IntlError, { IntlErrorCode } from './use-intl.esm5.js';
 
-var IntlContext = /*#__PURE__*/createContext(undefined);
+function validateMessagesSegment(messages, invalidKeyLabels, parentPath) {
+  Object.entries(messages).forEach(function (_ref) {
+    var key = _ref[0],
+        messageOrMessages = _ref[1];
 
-export { IntlContext as default };
+    if (key.includes('.')) {
+      var keyLabel = key;
+      if (parentPath) keyLabel += " (at " + parentPath + ")";
+      invalidKeyLabels.push(keyLabel);
+    }
+
+    if (messageOrMessages != null && typeof messageOrMessages === 'object') {
+      validateMessagesSegment(messageOrMessages, invalidKeyLabels, [parentPath, key].filter(function (part) {
+        return part != null;
+      }).join('.'));
+    }
+  });
+}
+
+function validateMessages(messages, onError) {
+  var invalidKeyLabels = [];
+  validateMessagesSegment(messages, invalidKeyLabels);
+
+  if (invalidKeyLabels.length > 0) {
+    onError(new IntlError(IntlErrorCode.INVALID_KEY, "Namespace keys can not contain the character \".\" as this is used to express nesting. Please remove it or replace it with another character.\n\nInvalid " + (invalidKeyLabels.length === 1 ? 'key' : 'keys') + ": " + invalidKeyLabels.join(', ')));
+  }
+}
+
+export { validateMessages as default };
 //# sourceMappingURL=use-intl.esm9.js.map

package/dist/use-intl.esm9.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-intl.esm9.js","sources":["../src/IntlContext.tsx"],"sourcesContent":["import {createContext} from 'react';\nimport AbstractIntlMessages from './AbstractIntlMessages';\nimport Formats from './Formats';\nimport IntlError from './IntlError';\nimport {RichTranslationValues} from './TranslationValues';\n\nexport type IntlContextShape = {\n  messages?: AbstractIntlMessages;\n  locale: string;\n  formats?: Partial<Formats>;\n  timeZone?: string;\n  onError(error: IntlError): void;\n  getMessageFallback(info: {\n    error: IntlError;\n    key: string;\n    namespace?: string;\n  }): string;\n  now?: Date;\n  defaultTranslationValues?: RichTranslationValues;\n};\n\nconst IntlContext = createContext<IntlContextShape | undefined>(undefined);\n\nexport default IntlContext;\n"],"names":["IntlContext","createContext","undefined"],"mappings":";;AAqBA,IAAMA,WAAW,gBAAGC,aAAa,CAA+BC,SAA/B;;;;"}
+{"version":3,"file":"use-intl.esm9.js","sources":["../src/validateMessages.tsx"],"sourcesContent":["import AbstractIntlMessages from './AbstractIntlMessages';\nimport IntlError, {IntlErrorCode} from './IntlError';\n\nfunction validateMessagesSegment(\n  messages: AbstractIntlMessages,\n  invalidKeyLabels: Array<string>,\n  parentPath?: string\n) {\n  Object.entries(messages).forEach(([key, messageOrMessages]) => {\n    if (key.includes('.')) {\n      let keyLabel = key;\n      if (parentPath) keyLabel += ` (at ${parentPath})`;\n      invalidKeyLabels.push(keyLabel);\n    }\n\n    if (messageOrMessages != null && typeof messageOrMessages === 'object') {\n      validateMessagesSegment(\n        messageOrMessages,\n        invalidKeyLabels,\n        [parentPath, key].filter((part) => part != null).join('.')\n      );\n    }\n  });\n}\n\nexport default function validateMessages(\n  messages: AbstractIntlMessages,\n  onError: (error: IntlError) => void\n) {\n  const invalidKeyLabels: Array<string> = [];\n  validateMessagesSegment(messages, invalidKeyLabels);\n\n  if (invalidKeyLabels.length > 0) {\n    onError(\n      new IntlError(\n        IntlErrorCode.INVALID_KEY,\n        `Namespace keys can not contain the character \".\" as this is used to express nesting. Please remove it or replace it with another character.\\n\\nInvalid ${\n          invalidKeyLabels.length === 1 ? 'key' : 'keys'\n        }: ${invalidKeyLabels.join(', ')}`\n      )\n    );\n  }\n}\n"],"names":["validateMessagesSegment","messages","invalidKeyLabels","parentPath","Object","entries","forEach","key","messageOrMessages","includes","keyLabel","push","filter","part","join","validateMessages","onError","length","IntlError","IntlErrorCode","INVALID_KEY"],"mappings":";;AAGA,SAASA,uBAAT,CACEC,QADF,EAEEC,gBAFF,EAGEC,UAHF,EAGqB;AAEnBC,EAAAA,MAAM,CAACC,OAAP,CAAeJ,QAAf,CAAyBK,CAAAA,OAAzB,CAAiC,UAA6B,IAAA,EAAA;AAAA,IAAA,IAA3BC,GAA2B,GAAA,IAAA,CAAA,CAAA,CAAA;AAAA,QAAtBC,iBAAsB,GAAA,IAAA,CAAA,CAAA,CAAA,CAAA;;AAC5D,IAAA,IAAID,GAAG,CAACE,QAAJ,CAAa,GAAb,CAAJ,EAAuB;AACrB,MAAIC,IAAAA,QAAQ,GAAGH,GAAf,CAAA;AACA,MAAA,IAAIJ,UAAJ,EAAgBO,QAAQ,IAAA,OAAA,GAAYP,UAAZ,GAAR,GAAA,CAAA;AAChBD,MAAAA,gBAAgB,CAACS,IAAjB,CAAsBD,QAAtB,CAAA,CAAA;AACD,KAAA;;AAED,IAAIF,IAAAA,iBAAiB,IAAI,IAArB,IAA6B,OAAOA,iBAAP,KAA6B,QAA9D,EAAwE;AACtER,MAAAA,uBAAuB,CACrBQ,iBADqB,EAErBN,gBAFqB,EAGrB,CAACC,UAAD,EAAaI,GAAb,CAAA,CAAkBK,MAAlB,CAAyB,UAACC,IAAD,EAAA;AAAA,QAAUA,OAAAA,IAAI,IAAI,IAAlB,CAAA;AAAA,OAAzB,CAAiDC,CAAAA,IAAjD,CAAsD,GAAtD,CAHqB,CAAvB,CAAA;AAKD,KAAA;AACF,GAdD,CAAA,CAAA;AAeD,CAAA;;AAEa,SAAUC,gBAAV,CACZd,QADY,EAEZe,OAFY,EAEuB;AAEnC,EAAMd,IAAAA,gBAAgB,GAAkB,EAAxC,CAAA;AACAF,EAAAA,uBAAuB,CAACC,QAAD,EAAWC,gBAAX,CAAvB,CAAA;;AAEA,EAAA,IAAIA,gBAAgB,CAACe,MAAjB,GAA0B,CAA9B,EAAiC;AAC/BD,IAAAA,OAAO,CACL,IAAIE,SAAJ,CACEC,aAAa,CAACC,WADhB,EAAA,2JAAA,IAGIlB,gBAAgB,CAACe,MAAjB,KAA4B,CAA5B,GAAgC,KAAhC,GAAwC,MAH5C,CAIOf,GAAAA,IAAAA,GAAAA,gBAAgB,CAACY,IAAjB,CAAsB,IAAtB,CAJP,CADK,CAAP,CAAA;AAQD,GAAA;AACF;;;;"}

package/dist/useTranslations.d.ts

@@ -13,20 +13,32 @@ import NestedValueOf from './utils/NestedValueOf';
  * The namespace can also indicate nesting by using a dot
  * (e.g. `namespace.Component`).
  */
-export default function useTranslations<NestedKey extends NamespaceKeys<IntlMessages, NestedKeyOf<IntlMessages>>>(namespace?: NestedKey): {
+export default function useTranslations<NestedKey extends NamespaceKeys<IntlMessages, NestedKeyOf<IntlMessages>> = never>(namespace?: NestedKey): {
     <TargetKey extends MessageKeys<NestedValueOf<{
         '!': IntlMessages;
-    }, NamespaceKeys<IntlMessages, NestedKeyOf<IntlMessages>> extends NestedKey ? '!' : `!.${NestedKey}`>, NestedKeyOf<NestedValueOf<{
+    }, [
+        NestedKey
+    ] extends [never] ? '!' : `!.${NestedKey}`>, NestedKeyOf<NestedValueOf<{
         '!': IntlMessages;
-    }, NamespaceKeys<IntlMessages, NestedKeyOf<IntlMessages>> extends NestedKey ? '!' : `!.${NestedKey}`>>>>(key: TargetKey, values?: TranslationValues, formats?: Partial<Formats>): string;
+    }, [
+        NestedKey
+    ] extends [never] ? '!' : `!.${NestedKey}`>>>>(key: TargetKey, values?: TranslationValues, formats?: Partial<Formats>): string;
     rich<TargetKey extends MessageKeys<NestedValueOf<{
         '!': IntlMessages;
-    }, NamespaceKeys<IntlMessages, NestedKeyOf<IntlMessages>> extends NestedKey ? '!' : `!.${NestedKey}`>, NestedKeyOf<NestedValueOf<{
+    }, [
+        NestedKey
+    ] extends [never] ? '!' : `!.${NestedKey}`>, NestedKeyOf<NestedValueOf<{
         '!': IntlMessages;
-    }, NamespaceKeys<IntlMessages, NestedKeyOf<IntlMessages>> extends NestedKey ? '!' : `!.${NestedKey}`>>>>(key: TargetKey, values?: RichTranslationValues, formats?: Partial<Formats>): string | ReactElement | ReactNodeArray;
+    }, [
+        NestedKey
+    ] extends [never] ? '!' : `!.${NestedKey}`>>>>(key: TargetKey, values?: RichTranslationValues, formats?: Partial<Formats>): string | ReactElement | ReactNodeArray;
     raw<TargetKey extends MessageKeys<NestedValueOf<{
         '!': IntlMessages;
-    }, NamespaceKeys<IntlMessages, NestedKeyOf<IntlMessages>> extends NestedKey ? '!' : `!.${NestedKey}`>, NestedKeyOf<NestedValueOf<{
+    }, [
+        NestedKey
+    ] extends [never] ? '!' : `!.${NestedKey}`>, NestedKeyOf<NestedValueOf<{
         '!': IntlMessages;
-    }, NamespaceKeys<IntlMessages, NestedKeyOf<IntlMessages>> extends NestedKey ? '!' : `!.${NestedKey}`>>>>(key: TargetKey): any;
+    }, [
+        NestedKey
+    ] extends [never] ? '!' : `!.${NestedKey}`>>>>(key: TargetKey): any;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "use-intl",
-  "version": "2.7.3",
+  "version": "2.7.4-alpha.2",
   "sideEffects": false,
   "author": "Jan Amann <jan@amann.me>",
   "description": "Minimal, but complete solution for managing internationalization in React apps.",
@@ -59,5 +59,5 @@
   "engines": {
     "node": ">=10"
   },
-  "gitHead": "96716718eccdc05566b080c55863d7b7e9a0bfdc"
+  "gitHead": "6683168cc739943b8a3c7e86585fa614679440e6"
 }

package/src/useTranslations.tsx

@@ -17,7 +17,10 @@ import NestedValueOf from './utils/NestedValueOf';
  * (e.g. `namespace.Component`).
  */
 export default function useTranslations<
-  NestedKey extends NamespaceKeys<IntlMessages, NestedKeyOf<IntlMessages>>
+  NestedKey extends NamespaceKeys<
+    IntlMessages,
+    NestedKeyOf<IntlMessages>
+  > = never
 >(
   namespace?: NestedKey
 ): // Explicitly defining the return type is necessary as TypeScript would get it wrong
@@ -27,19 +30,12 @@ export default function useTranslations<
     TargetKey extends MessageKeys<
       NestedValueOf<
         {'!': IntlMessages},
-        NamespaceKeys<IntlMessages, NestedKeyOf<IntlMessages>> extends NestedKey
-          ? '!'
-          : `!.${NestedKey}`
+        [NestedKey] extends [never] ? '!' : `!.${NestedKey}`
       >,
       NestedKeyOf<
         NestedValueOf<
           {'!': IntlMessages},
-          NamespaceKeys<
-            IntlMessages,
-            NestedKeyOf<IntlMessages>
-          > extends NestedKey
-            ? '!'
-            : `!.${NestedKey}`
+          [NestedKey] extends [never] ? '!' : `!.${NestedKey}`
         >
       >
     >
@@ -54,19 +50,12 @@ export default function useTranslations<
     TargetKey extends MessageKeys<
       NestedValueOf<
         {'!': IntlMessages},
-        NamespaceKeys<IntlMessages, NestedKeyOf<IntlMessages>> extends NestedKey
-          ? '!'
-          : `!.${NestedKey}`
+        [NestedKey] extends [never] ? '!' : `!.${NestedKey}`
       >,
       NestedKeyOf<
         NestedValueOf<
           {'!': IntlMessages},
-          NamespaceKeys<
-            IntlMessages,
-            NestedKeyOf<IntlMessages>
-          > extends NestedKey
-            ? '!'
-            : `!.${NestedKey}`
+          [NestedKey] extends [never] ? '!' : `!.${NestedKey}`
         >
       >
     >
@@ -81,19 +70,12 @@ export default function useTranslations<
     TargetKey extends MessageKeys<
       NestedValueOf<
         {'!': IntlMessages},
-        NamespaceKeys<IntlMessages, NestedKeyOf<IntlMessages>> extends NestedKey
-          ? '!'
-          : `!.${NestedKey}`
+        [NestedKey] extends [never] ? '!' : `!.${NestedKey}`
       >,
       NestedKeyOf<
         NestedValueOf<
           {'!': IntlMessages},
-          NamespaceKeys<
-            IntlMessages,
-            NestedKeyOf<IntlMessages>
-          > extends NestedKey
-            ? '!'
-            : `!.${NestedKey}`
+          [NestedKey] extends [never] ? '!' : `!.${NestedKey}`
         >
       >
     >
@@ -109,9 +91,7 @@ export default function useTranslations<
   // The prefix ("!"") is arbitrary, but we have to use some.
   return useTranslationsImpl<
     {'!': IntlMessages},
-    NamespaceKeys<IntlMessages, NestedKeyOf<IntlMessages>> extends NestedKey
-      ? '!'
-      : `!.${NestedKey}`
+    [NestedKey] extends [never] ? '!' : `!.${NestedKey}`
   >(
     {'!': messages},
     // @ts-ignore