@vocab/core 1.1.2 → 1.2.0

package/README.md

@@ -422,20 +422,81 @@ Or to re-run the compiler when files change use:
 $ vocab compile --watch
 ```
 
-## External translation tooling
+## External Translation Tooling
 
 Vocab can be used to synchronize your translations with translations from a remote translation platform.
 
-| Platform                                     | Environment Variables               |
-| -------------------------------------------- | ----------------------------------- |
-| [Phrase](https://developers.phrase.com/api/) | PHRASE_PROJECT_ID, PHRASE_API_TOKEN |
+| Platform | Environment Variables               |
+| -------- | ----------------------------------- |
+| [Phrase] | PHRASE_PROJECT_ID, PHRASE_API_TOKEN |
 
 ```bash
 $ vocab push --branch my-branch
-$ vocab push --branch my-branch --delete-unused-keys
 $ vocab pull --branch my-branch
 ```
 
+### [Phrase] Platform Features
+
+#### Delete Unused keys
+
+When uploading translations, Phrase identifies keys that exist in the Phrase project, but were not
+referenced in the upload. These keys can be deleted from Phrase by providing the
+`---delete-unused-keys` flag to `vocab push`. E.g.
+
+```sh
+$ vocab push --branch my-branch --delete-unused-keys
+```
+
+[phrase]: https://developers.phrase.com/api/
+
+#### [Tags]
+
+`vocab push` supports uploading [tags] to Phrase.
+
+Tags can be added to an individual key via the `tags` property:
+
+```jsonc
+// translations.json
+{
+  "Hello": {
+    "message": "Hello",
+    "tags": ["greeting", "home_page"]
+  },
+  "Goodbye": {
+    "message": "Goodbye",
+    "tags": ["home_page"]
+  }
+}
+```
+
+Tags can also be added under a top-level `_meta` field. This will result in the tags applying to all
+keys specified in the file:
+
+```jsonc
+// translations.json
+{
+  "_meta": {
+    "tags": ["home_page"]
+  },
+  "Hello": {
+    "message": "Hello",
+    "tags": ["greeting"]
+  },
+  "Goodbye": {
+    "message": "Goodbye"
+  }
+}
+```
+
+In the above example, both the `Hello` and `Goodbye` keys would have the `home_page` tag attached to
+them, but only the `Hello` key would have the `usage_greeting` tag attached to it.
+
+**NOTE**: Only tags specified on keys in your [`devLanguage`][configuration] will be uploaded.
+Tags on keys in other languages will be ignored.
+
+[tags]: https://support.phrase.com/hc/en-us/articles/5822598372252-Tags-Strings-
+[configuration]: #Configuration
+
 ## Troubleshooting
 
 ### Problem: Passed locale is being ignored or using en-US instead

package/dist/declarations/src/load-translations.d.ts

@@ -1,4 +1,4 @@
-import { TranslationsByKey, UserConfig, LoadedTranslation, LanguageTarget } from '@vocab/types';
+import type { TranslationsByKey, UserConfig, LoadedTranslation, LanguageTarget } from '@vocab/types';
 import { Fallback } from './utils';
 export declare function getUniqueKey(key: string, namespace: string): string;
 export declare function mergeWithDevLanguageTranslation({ translation, devTranslation, }: {
@@ -20,11 +20,13 @@ export declare function loadAltLanguageFile({ filePath, languageName, devTransla
     devTranslation: TranslationsByKey;
     fallbacks: Fallback;
 }, { devLanguage, languages }: UserConfig): TranslationsByKey;
-export declare function loadTranslation({ filePath, fallbacks, }: {
+export declare function loadTranslation({ filePath, fallbacks, withTags, }: {
     filePath: string;
     fallbacks: Fallback;
+    withTags?: boolean;
 }, userConfig: UserConfig): LoadedTranslation;
-export declare function loadAllTranslations({ fallbacks, includeNodeModules, }: {
+export declare function loadAllTranslations({ fallbacks, includeNodeModules, withTags, }: {
     fallbacks: Fallback;
     includeNodeModules: boolean;
+    withTags?: boolean;
 }, config: UserConfig): Promise<Array<LoadedTranslation>>;

package/dist/vocab-core.cjs.dev.js

@@ -279,18 +279,20 @@ function printValidationError(...params) {
   console.error(chalk__default['default'].red('Error loading translation:'), ...params);
 }
 
-function getTranslationsFromFile(translations, {
+function getTranslationsFromFile(translationFileContents, {
   isAltLanguage,
-  filePath
+  filePath,
+  withTags
 }) {
-  if (!translations || typeof translations !== 'object') {
-    throw new Error(`Unable to read translation file ${filePath}. Translations must be an object`);
+  if (!translationFileContents || typeof translationFileContents !== 'object') {
+    throw new Error(`Unable to read translation file ${filePath}. Translations must be an object.`);
   }
 
   const {
     $namespace,
+    _meta,
     ...keys
-  } = translations;
+  } = translationFileContents;
 
   if (isAltLanguage && $namespace) {
     printValidationError(`Found $namespace in alt language file in ${filePath}. $namespace is only used in the dev language and will be ignored.`);
@@ -300,9 +302,18 @@ function getTranslationsFromFile(translations, {
     printValidationError(`Found non-string $namespace in language file in ${filePath}. $namespace must be a string.`);
   }
 
+  if (isAltLanguage && _meta !== null && _meta !== void 0 && _meta.tags) {
+    printValidationError(`Found _meta.tags in alt language file in ${filePath}. _meta.tags is only used in the dev language and will be ignored.`);
+  } // Never return tags if we're fetching translations for an alt language
+
+
+  const includeTags = !isAltLanguage && withTags;
   const validKeys = {};
 
-  for (const [translationKey, translation] of Object.entries(keys)) {
+  for (const [translationKey, {
+    tags,
+    ...translation
+  }] of Object.entries(keys)) {
     if (typeof translation === 'string') {
       printValidationError(`Found string for a translation "${translationKey}" in ${filePath}. Translation must be an object of the format {message: string}.`);
       continue;
@@ -318,12 +329,18 @@ function getTranslationsFromFile(translations, {
       continue;
     }
 
-    validKeys[translationKey] = translation;
+    validKeys[translationKey] = { ...translation,
+      tags: includeTags ? tags : undefined
+    };
   }
 
+  const metadata = {
+    tags: includeTags ? _meta === null || _meta === void 0 ? void 0 : _meta.tags : undefined
+  };
   return {
     $namespace,
-    keys: validKeys
+    keys: validKeys,
+    metadata
   };
 }
 
@@ -374,9 +391,18 @@ function loadAltLanguageFile({
 
   return altLanguageTranslation;
 }
+
+function stripTagsFromTranslations(translations) {
+  return Object.fromEntries(Object.entries(translations).map(([key, {
+    tags,
+    ...rest
+  }]) => [key, rest]));
+}
+
 function loadTranslation({
   filePath,
-  fallbacks
+  fallbacks,
+  withTags
 }, userConfig) {
   trace(`Loading translation file in "${fallbacks}" fallback mode: "${filePath}"`);
   const languageSet = {};
@@ -387,21 +413,24 @@ function loadTranslation({
   const relativePath = path__default['default'].relative(userConfig.projectRoot || process.cwd(), filePath);
   const {
     $namespace,
-    keys: devTranslation
+    keys: devTranslation,
+    metadata
   } = getTranslationsFromFile(translationContent, {
     filePath,
-    isAltLanguage: false
+    isAltLanguage: false,
+    withTags
   });
   const namespace = typeof $namespace === 'string' ? $namespace : getNamespaceByFilePath(relativePath, userConfig);
   trace(`Found file ${filePath}. Using namespace ${namespace}`);
   languageSet[userConfig.devLanguage] = devTranslation;
+  const devTranslationNoTags = withTags ? stripTagsFromTranslations(devTranslation) : devTranslation;
   const altLanguages = getAltLanguages(userConfig);
 
   for (const languageName of altLanguages) {
     languageSet[languageName] = loadAltLanguageFile({
       filePath,
       languageName,
-      devTranslation,
+      devTranslation: devTranslationNoTags,
       fallbacks
     }, userConfig);
   }
@@ -424,12 +453,14 @@ function loadTranslation({
     keys: Object.keys(devTranslation),
     namespace,
     relativePath,
-    languages: languageSet
+    languages: languageSet,
+    metadata
   };
 }
 async function loadAllTranslations({
   fallbacks,
-  includeNodeModules
+  includeNodeModules,
+  withTags
 }, config) {
   const {
     projectRoot,
@@ -443,7 +474,8 @@ async function loadAllTranslations({
   trace(`Found ${translationFiles.length} translation files`);
   const result = await Promise.all(translationFiles.map(filePath => loadTranslation({
     filePath,
-    fallbacks
+    fallbacks,
+    withTags
   }, config)));
   const keys = new Set();
 
@@ -569,7 +601,7 @@ async function generateRuntime(loadedTranslation) {
     languages: loadedLanguages,
     filePath
   } = loadedTranslation;
-  trace('Generating types for', loadedTranslation.filePath);
+  trace('Generating types for', filePath);
   const translationTypes = new Map();
   let imports = new Set();
 
@@ -629,7 +661,7 @@ function watch(config) {
 
     if (targetFile) {
       try {
-        const loadedTranslation = await loadTranslation({
+        const loadedTranslation = loadTranslation({
           filePath: targetFile,
           fallbacks: 'all'
         }, config);

package/dist/vocab-core.cjs.prod.js

@@ -279,18 +279,20 @@ function printValidationError(...params) {
   console.error(chalk__default['default'].red('Error loading translation:'), ...params);
 }
 
-function getTranslationsFromFile(translations, {
+function getTranslationsFromFile(translationFileContents, {
   isAltLanguage,
-  filePath
+  filePath,
+  withTags
 }) {
-  if (!translations || typeof translations !== 'object') {
-    throw new Error(`Unable to read translation file ${filePath}. Translations must be an object`);
+  if (!translationFileContents || typeof translationFileContents !== 'object') {
+    throw new Error(`Unable to read translation file ${filePath}. Translations must be an object.`);
   }
 
   const {
     $namespace,
+    _meta,
     ...keys
-  } = translations;
+  } = translationFileContents;
 
   if (isAltLanguage && $namespace) {
     printValidationError(`Found $namespace in alt language file in ${filePath}. $namespace is only used in the dev language and will be ignored.`);
@@ -300,9 +302,18 @@ function getTranslationsFromFile(translations, {
     printValidationError(`Found non-string $namespace in language file in ${filePath}. $namespace must be a string.`);
   }
 
+  if (isAltLanguage && _meta !== null && _meta !== void 0 && _meta.tags) {
+    printValidationError(`Found _meta.tags in alt language file in ${filePath}. _meta.tags is only used in the dev language and will be ignored.`);
+  } // Never return tags if we're fetching translations for an alt language
+
+
+  const includeTags = !isAltLanguage && withTags;
   const validKeys = {};
 
-  for (const [translationKey, translation] of Object.entries(keys)) {
+  for (const [translationKey, {
+    tags,
+    ...translation
+  }] of Object.entries(keys)) {
     if (typeof translation === 'string') {
       printValidationError(`Found string for a translation "${translationKey}" in ${filePath}. Translation must be an object of the format {message: string}.`);
       continue;
@@ -318,12 +329,18 @@ function getTranslationsFromFile(translations, {
       continue;
     }
 
-    validKeys[translationKey] = translation;
+    validKeys[translationKey] = { ...translation,
+      tags: includeTags ? tags : undefined
+    };
   }
 
+  const metadata = {
+    tags: includeTags ? _meta === null || _meta === void 0 ? void 0 : _meta.tags : undefined
+  };
   return {
     $namespace,
-    keys: validKeys
+    keys: validKeys,
+    metadata
   };
 }
 
@@ -374,9 +391,18 @@ function loadAltLanguageFile({
 
   return altLanguageTranslation;
 }
+
+function stripTagsFromTranslations(translations) {
+  return Object.fromEntries(Object.entries(translations).map(([key, {
+    tags,
+    ...rest
+  }]) => [key, rest]));
+}
+
 function loadTranslation({
   filePath,
-  fallbacks
+  fallbacks,
+  withTags
 }, userConfig) {
   trace(`Loading translation file in "${fallbacks}" fallback mode: "${filePath}"`);
   const languageSet = {};
@@ -387,21 +413,24 @@ function loadTranslation({
   const relativePath = path__default['default'].relative(userConfig.projectRoot || process.cwd(), filePath);
   const {
     $namespace,
-    keys: devTranslation
+    keys: devTranslation,
+    metadata
   } = getTranslationsFromFile(translationContent, {
     filePath,
-    isAltLanguage: false
+    isAltLanguage: false,
+    withTags
   });
   const namespace = typeof $namespace === 'string' ? $namespace : getNamespaceByFilePath(relativePath, userConfig);
   trace(`Found file ${filePath}. Using namespace ${namespace}`);
   languageSet[userConfig.devLanguage] = devTranslation;
+  const devTranslationNoTags = withTags ? stripTagsFromTranslations(devTranslation) : devTranslation;
   const altLanguages = getAltLanguages(userConfig);
 
   for (const languageName of altLanguages) {
     languageSet[languageName] = loadAltLanguageFile({
       filePath,
       languageName,
-      devTranslation,
+      devTranslation: devTranslationNoTags,
       fallbacks
     }, userConfig);
   }
@@ -424,12 +453,14 @@ function loadTranslation({
     keys: Object.keys(devTranslation),
     namespace,
     relativePath,
-    languages: languageSet
+    languages: languageSet,
+    metadata
   };
 }
 async function loadAllTranslations({
   fallbacks,
-  includeNodeModules
+  includeNodeModules,
+  withTags
 }, config) {
   const {
     projectRoot,
@@ -443,7 +474,8 @@ async function loadAllTranslations({
   trace(`Found ${translationFiles.length} translation files`);
   const result = await Promise.all(translationFiles.map(filePath => loadTranslation({
     filePath,
-    fallbacks
+    fallbacks,
+    withTags
   }, config)));
   const keys = new Set();
 
@@ -569,7 +601,7 @@ async function generateRuntime(loadedTranslation) {
     languages: loadedLanguages,
     filePath
   } = loadedTranslation;
-  trace('Generating types for', loadedTranslation.filePath);
+  trace('Generating types for', filePath);
   const translationTypes = new Map();
   let imports = new Set();
 
@@ -629,7 +661,7 @@ function watch(config) {
 
     if (targetFile) {
       try {
-        const loadedTranslation = await loadTranslation({
+        const loadedTranslation = loadTranslation({
           filePath: targetFile,
           fallbacks: 'all'
         }, config);

package/dist/vocab-core.esm.js

@@ -263,18 +263,20 @@ function printValidationError(...params) {
   console.error(chalk.red('Error loading translation:'), ...params);
 }
 
-function getTranslationsFromFile(translations, {
+function getTranslationsFromFile(translationFileContents, {
   isAltLanguage,
-  filePath
+  filePath,
+  withTags
 }) {
-  if (!translations || typeof translations !== 'object') {
-    throw new Error(`Unable to read translation file ${filePath}. Translations must be an object`);
+  if (!translationFileContents || typeof translationFileContents !== 'object') {
+    throw new Error(`Unable to read translation file ${filePath}. Translations must be an object.`);
   }
 
   const {
     $namespace,
+    _meta,
     ...keys
-  } = translations;
+  } = translationFileContents;
 
   if (isAltLanguage && $namespace) {
     printValidationError(`Found $namespace in alt language file in ${filePath}. $namespace is only used in the dev language and will be ignored.`);
@@ -284,9 +286,18 @@ function getTranslationsFromFile(translations, {
     printValidationError(`Found non-string $namespace in language file in ${filePath}. $namespace must be a string.`);
   }
 
+  if (isAltLanguage && _meta !== null && _meta !== void 0 && _meta.tags) {
+    printValidationError(`Found _meta.tags in alt language file in ${filePath}. _meta.tags is only used in the dev language and will be ignored.`);
+  } // Never return tags if we're fetching translations for an alt language
+
+
+  const includeTags = !isAltLanguage && withTags;
   const validKeys = {};
 
-  for (const [translationKey, translation] of Object.entries(keys)) {
+  for (const [translationKey, {
+    tags,
+    ...translation
+  }] of Object.entries(keys)) {
     if (typeof translation === 'string') {
       printValidationError(`Found string for a translation "${translationKey}" in ${filePath}. Translation must be an object of the format {message: string}.`);
       continue;
@@ -302,12 +313,18 @@ function getTranslationsFromFile(translations, {
       continue;
     }
 
-    validKeys[translationKey] = translation;
+    validKeys[translationKey] = { ...translation,
+      tags: includeTags ? tags : undefined
+    };
   }
 
+  const metadata = {
+    tags: includeTags ? _meta === null || _meta === void 0 ? void 0 : _meta.tags : undefined
+  };
   return {
     $namespace,
-    keys: validKeys
+    keys: validKeys,
+    metadata
   };
 }
 
@@ -358,9 +375,18 @@ function loadAltLanguageFile({
 
   return altLanguageTranslation;
 }
+
+function stripTagsFromTranslations(translations) {
+  return Object.fromEntries(Object.entries(translations).map(([key, {
+    tags,
+    ...rest
+  }]) => [key, rest]));
+}
+
 function loadTranslation({
   filePath,
-  fallbacks
+  fallbacks,
+  withTags
 }, userConfig) {
   trace(`Loading translation file in "${fallbacks}" fallback mode: "${filePath}"`);
   const languageSet = {};
@@ -371,21 +397,24 @@ function loadTranslation({
   const relativePath = path.relative(userConfig.projectRoot || process.cwd(), filePath);
   const {
     $namespace,
-    keys: devTranslation
+    keys: devTranslation,
+    metadata
   } = getTranslationsFromFile(translationContent, {
     filePath,
-    isAltLanguage: false
+    isAltLanguage: false,
+    withTags
   });
   const namespace = typeof $namespace === 'string' ? $namespace : getNamespaceByFilePath(relativePath, userConfig);
   trace(`Found file ${filePath}. Using namespace ${namespace}`);
   languageSet[userConfig.devLanguage] = devTranslation;
+  const devTranslationNoTags = withTags ? stripTagsFromTranslations(devTranslation) : devTranslation;
   const altLanguages = getAltLanguages(userConfig);
 
   for (const languageName of altLanguages) {
     languageSet[languageName] = loadAltLanguageFile({
       filePath,
       languageName,
-      devTranslation,
+      devTranslation: devTranslationNoTags,
       fallbacks
     }, userConfig);
   }
@@ -408,12 +437,14 @@ function loadTranslation({
     keys: Object.keys(devTranslation),
     namespace,
     relativePath,
-    languages: languageSet
+    languages: languageSet,
+    metadata
   };
 }
 async function loadAllTranslations({
   fallbacks,
-  includeNodeModules
+  includeNodeModules,
+  withTags
 }, config) {
   const {
     projectRoot,
@@ -427,7 +458,8 @@ async function loadAllTranslations({
   trace(`Found ${translationFiles.length} translation files`);
   const result = await Promise.all(translationFiles.map(filePath => loadTranslation({
     filePath,
-    fallbacks
+    fallbacks,
+    withTags
   }, config)));
   const keys = new Set();
 
@@ -553,7 +585,7 @@ async function generateRuntime(loadedTranslation) {
     languages: loadedLanguages,
     filePath
   } = loadedTranslation;
-  trace('Generating types for', loadedTranslation.filePath);
+  trace('Generating types for', filePath);
   const translationTypes = new Map();
   let imports = new Set();
 
@@ -613,7 +645,7 @@ function watch(config) {
 
     if (targetFile) {
       try {
-        const loadedTranslation = await loadTranslation({
+        const loadedTranslation = loadTranslation({
           filePath: targetFile,
           fallbacks: 'all'
         }, config);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vocab/core",
-  "version": "1.1.2",
+  "version": "1.2.0",
   "main": "dist/vocab-core.cjs.js",
   "module": "dist/vocab-core.esm.js",
   "exports": {
@@ -40,7 +40,7 @@
   ],
   "dependencies": {
     "@formatjs/icu-messageformat-parser": "^2.0.10",
-    "@vocab/types": "^1.1.1",
+    "@vocab/types": "^1.1.2",
     "chalk": "^4.1.0",
     "chokidar": "^3.4.3",
     "debug": "^4.3.1",

package/CHANGELOG.md

@@ -1,204 +0,0 @@
-# @vocab/core
-
-## 1.1.2
-
-### Patch Changes
-
-- [`e5a066c`](https://github.com/seek-oss/vocab/commit/e5a066c8a7539a62a9c1c4d813aa87461ba43cdc) [#96](https://github.com/seek-oss/vocab/pull/96) Thanks [@askoufis](https://github.com/askoufis)! - Update `intl-messageformat` dependencies
-
-- Updated dependencies [[`e5a066c`](https://github.com/seek-oss/vocab/commit/e5a066c8a7539a62a9c1c4d813aa87461ba43cdc)]:
-  - @vocab/types@1.1.1
-
-## 1.1.1
-
-### Patch Changes
-
-- [`09a698a`](https://github.com/seek-oss/vocab/commit/09a698af6aff86a851e4f829916b8f1f6beaca58) [#89](https://github.com/seek-oss/vocab/pull/89) Thanks [@mikebarkmin](https://github.com/mikebarkmin)! - Add exports to packages with multiple entry points. This fixes
-  `ERR_UNSUPPORTED_DIR_IMPORT` issues e.g. with NextJS or other setups, which
-  rely on the new node resolver when using ESM packages.
-
-## 1.1.0
-
-### Minor Changes
-
-- [`87333d7`](https://github.com/seek-oss/vocab/commit/87333d79c4a883b07d7d8f2c272b16e2243c49bd) [#80](https://github.com/seek-oss/vocab/pull/80) Thanks [@askoufis](https://github.com/askoufis)! - Enable the creation of generated languages via the `generatedLanguages` config.
-  See [the docs] for more information and examples.
-
-  [the docs]: https://github.com/seek-oss/vocab#generated-languages
-
-### Patch Changes
-
-- Updated dependencies [[`87333d7`](https://github.com/seek-oss/vocab/commit/87333d79c4a883b07d7d8f2c272b16e2243c49bd)]:
-  - @vocab/types@1.1.0
-
-## 1.0.4
-
-### Patch Changes
-
-- [`206c0fa`](https://github.com/seek-oss/vocab/commit/206c0fa36b05f23da593ebed801197c523477af6) [#78](https://github.com/seek-oss/vocab/pull/78) Thanks [@askoufis](https://github.com/askoufis)! - Fix incorrect language hierarchy when an extended language extends another language
-
-## 1.0.3
-
-### Patch Changes
-
-- [`78e874f`](https://github.com/seek-oss/vocab/commit/78e874f720ca34d771072c09fe55b57ff3158e02) [#71](https://github.com/seek-oss/vocab/pull/71) Thanks [@mattcompiles](https://github.com/mattcompiles)! - Only write compiled runtime files to disk if they have been changed
-
-## 1.0.2
-
-### Patch Changes
-
-- [`3ec6dba`](https://github.com/seek-oss/vocab/commit/3ec6dbaad590299cc33e2d9d4a877576eb05853a) [#63](https://github.com/seek-oss/vocab/pull/63) Thanks [@jahredhope](https://github.com/jahredhope)! - Migrate to new @formatjs/icu-messageformat-parser as intl-messageformat-parser has been deprecated
-
-- Updated dependencies [[`3ec6dba`](https://github.com/seek-oss/vocab/commit/3ec6dbaad590299cc33e2d9d4a877576eb05853a)]:
-  - @vocab/types@1.0.1
-
-## 1.0.1
-
-### Patch Changes
-
-- [`c9a38dd`](https://github.com/seek-oss/vocab/commit/c9a38dd15e2c2a47fc4d5eb2348fdd08a6982768) [#54](https://github.com/seek-oss/vocab/pull/54) Thanks [@jahredhope](https://github.com/jahredhope)! - Allow special characters within translation keys and messages
-
-## 1.0.0
-
-### Major Changes
-
-- [`3031054`](https://github.com/seek-oss/vocab/commit/303105440851db6126f0606e1607745b27dd981c) [#51](https://github.com/seek-oss/vocab/pull/51) Thanks [@jahredhope](https://github.com/jahredhope)! - Release v1.0.0
-
-  Release Vocab as v1.0.0 to signify a stable API and support future [semver versioning](https://semver.org/) releases.
-
-  Vocab has seen a lot of iteration and changes since it was first published on 20 November 2020. We are now confident with the API and believe Vocab is ready for common use.
-
-### Patch Changes
-
-- [`0074382`](https://github.com/seek-oss/vocab/commit/007438273ef70f5d5ded45777933651ad8df36f6) [#52](https://github.com/seek-oss/vocab/pull/52) Thanks [@jahredhope](https://github.com/jahredhope)! - Remove React dependency on core types.
-
-  Direct use of tags in Translations now have stricter type definitions.
-
-- Updated dependencies [[`0074382`](https://github.com/seek-oss/vocab/commit/007438273ef70f5d5ded45777933651ad8df36f6), [`3031054`](https://github.com/seek-oss/vocab/commit/303105440851db6126f0606e1607745b27dd981c)]:
-  - @vocab/types@1.0.0
-
-## 0.0.11
-
-### Patch Changes
-
-- [`5b1fdc0`](https://github.com/seek-oss/vocab/commit/5b1fdc019522b12e7ef94b2fec57b54a9310d41c) [#46](https://github.com/seek-oss/vocab/pull/46) Thanks [@jahredhope](https://github.com/jahredhope)! - Enable the use of translation files directly with 3 new documented methods for working with translations.
-
-  ```typescript
-  /**
-   *  Retrieve messages. If not available, will attempt to load messages and resolve once complete.
-   */
-  translations.getMessages(language);
-  /**
-   *  Retrieve already loaded messages. Will return null if messages haven't been loaded.
-   */
-  translations.getLoadedMessages(language);
-  /**
-   *  Load messages for the given language. Resolving once complete.
-   */
-  translations.load(language);
-  ```
-
-- Updated dependencies [[`5b1fdc0`](https://github.com/seek-oss/vocab/commit/5b1fdc019522b12e7ef94b2fec57b54a9310d41c)]:
-  - @vocab/types@0.0.9
-
-## 0.0.10
-
-### Patch Changes
-
-- [`7c96a14`](https://github.com/seek-oss/vocab/commit/7c96a142f602132d38c1df1a47a1f4657dc5c94c) [#43](https://github.com/seek-oss/vocab/pull/43) Thanks [@mattcompiles](https://github.com/mattcompiles)! - Return `NonNullable<ReactNode>` instead of `ReactNode` from translation function
-
-## 0.0.9
-
-### Patch Changes
-
-- [`3034bd3`](https://github.com/seek-oss/vocab/commit/3034bd3de610a9d1f3bfbd8caefa27064dee2710) [#40](https://github.com/seek-oss/vocab/pull/40) Thanks [@jahredhope](https://github.com/jahredhope)! - Fix .vocab files with no prefix not compiling
-
-* [`c110745`](https://github.com/seek-oss/vocab/commit/c110745b79df1a8ade6b1d8a49e798b04a7b95e1) [#42](https://github.com/seek-oss/vocab/pull/42) Thanks [@jahredhope](https://github.com/jahredhope)! - Avoid overriding existing translations files for new directories
-
-## 0.0.8
-
-### Patch Changes
-
-- [`f2fca67`](https://github.com/seek-oss/vocab/commit/f2fca679c66ae65405a0aa24f0a0e472026aad0d) [#36](https://github.com/seek-oss/vocab/pull/36) Thanks [@mattcompiles](https://github.com/mattcompiles)! - Support custom locales for ICU message parsing
-
-- Updated dependencies [[`f2fca67`](https://github.com/seek-oss/vocab/commit/f2fca679c66ae65405a0aa24f0a0e472026aad0d)]:
-  - @vocab/types@0.0.8
-
-## 0.0.7
-
-### Patch Changes
-
-- [`283bcad`](https://github.com/seek-oss/vocab/commit/283bcada06e622ab14ed891743ed3f55cf09e245) [#33](https://github.com/seek-oss/vocab/pull/33) Thanks [@mattcompiles](https://github.com/mattcompiles)! - Move all vocab files to single directory with configurable suffix
-
-* [`ad0d240`](https://github.com/seek-oss/vocab/commit/ad0d2404545ded8e11621eae8f29467ff3352366) [#31](https://github.com/seek-oss/vocab/pull/31) Thanks [@mattcompiles](https://github.com/mattcompiles)! - Move the node runtime from @vocab/webpack to @vocab/core
-
-- [`f3992ef`](https://github.com/seek-oss/vocab/commit/f3992efbf08939ebf853fac650a49cc46dc51dfb) [#34](https://github.com/seek-oss/vocab/pull/34) Thanks [@jahredhope](https://github.com/jahredhope)! - Create translation files for newly created vocab directories
-
-* [`f3992ef`](https://github.com/seek-oss/vocab/commit/f3992efbf08939ebf853fac650a49cc46dc51dfb) [#34](https://github.com/seek-oss/vocab/pull/34) Thanks [@jahredhope](https://github.com/jahredhope)! - Validate translation files as loaded. Providing additional error messaging.
-
-* Updated dependencies [[`283bcad`](https://github.com/seek-oss/vocab/commit/283bcada06e622ab14ed891743ed3f55cf09e245), [`f3992ef`](https://github.com/seek-oss/vocab/commit/f3992efbf08939ebf853fac650a49cc46dc51dfb)]:
-  - @vocab/types@0.0.7
-
-## 0.0.6
-
-### Patch Changes
-
-- [`80a46c0`](https://github.com/seek-oss/vocab/commit/80a46c01a55408675f5822c3618519f80136c3ab) [#27](https://github.com/seek-oss/vocab/pull/27) Thanks [@mattcompiles](https://github.com/mattcompiles)! - Add `ignore` config for ignoring files/folders from cli scripts
-
-* [`80a46c0`](https://github.com/seek-oss/vocab/commit/80a46c01a55408675f5822c3618519f80136c3ab) [#27](https://github.com/seek-oss/vocab/pull/27) Thanks [@mattcompiles](https://github.com/mattcompiles)! - Ignore node_modules from push, pull and compile scripts
-
-* Updated dependencies [[`80a46c0`](https://github.com/seek-oss/vocab/commit/80a46c01a55408675f5822c3618519f80136c3ab)]:
-  - @vocab/types@0.0.6
-
-## 0.0.5
-
-### Patch Changes
-
-- [`371ed16`](https://github.com/seek-oss/vocab/commit/371ed16a232a04dab13afa7e2b352dfb6724eea4) [#25](https://github.com/seek-oss/vocab/pull/25) Thanks [@mattcompiles](https://github.com/mattcompiles)! - Watch alt language files as well as dev language
-
-* [`c222d68`](https://github.com/seek-oss/vocab/commit/c222d68a3c0c24723a338eccb959798881f6a118) [#24](https://github.com/seek-oss/vocab/pull/24) Thanks [@mattcompiles](https://github.com/mattcompiles)! - Changed glob constants to functions
-
-## 0.0.4
-
-### Patch Changes
-
-- [`5f5c581`](https://github.com/seek-oss/vocab/commit/5f5c581a65bff28729ee19e1ec0bdea488a9d6c2) [#19](https://github.com/seek-oss/vocab/pull/19) Thanks [@jahredhope](https://github.com/jahredhope)! - Compile useable TypeScript importable files with `vocab compile`.
-
-  The new `vocab compile` step replaces `vocab generate-types` in creating a fully functional **translations.ts** file.
-
-  This allows vocab to be used **without the Webpack Plugin**, however use of the plugin is still heavily advised to ensure optimal loading of translation content on the web.
-
-  Support for unit testing is now better than ever! The newly created **translations.ts** means your unit test code will see the same code as available while rendering.
-
-  See the [documentation](https://github.com/seek-oss/vocab) for further usage details.
-
-* [`02f943c`](https://github.com/seek-oss/vocab/commit/02f943ca892913b41f9e4720a72400777cf14b3d) [#17](https://github.com/seek-oss/vocab/pull/17) Thanks [@jahredhope](https://github.com/jahredhope)! - Add additional debug traces
-
-* Updated dependencies [[`5f5c581`](https://github.com/seek-oss/vocab/commit/5f5c581a65bff28729ee19e1ec0bdea488a9d6c2)]:
-  - @vocab/types@0.0.5
-
-## 0.0.3
-
-### Patch Changes
-
-- [`08de30d`](https://github.com/seek-oss/vocab/commit/08de30d338c2a5ebdcf14da7c736dddf22e7ca9e) [#14](https://github.com/seek-oss/vocab/pull/14) Thanks [@mattcompiles](https://github.com/mattcompiles)! - Add ability to override files namespace with \$namespace
-
-* [`ed6cf40`](https://github.com/seek-oss/vocab/commit/ed6cf408973f2e9c4d07a71fcb52f40294ebaf65) [#13](https://github.com/seek-oss/vocab/pull/13) Thanks [@mattcompiles](https://github.com/mattcompiles)! - Add validation script for identifying missing keys
-
-- [`26b52f4`](https://github.com/seek-oss/vocab/commit/26b52f4878ded440841e08c858bdc9e685500c2a) [#16](https://github.com/seek-oss/vocab/pull/16) Thanks [@jahredhope](https://github.com/jahredhope)! - Enable debugging with DEBUG environment variable
-
-* [`b5a5a05`](https://github.com/seek-oss/vocab/commit/b5a5a05a5bb87b48e6e9160af75f555728143ea2) [#15](https://github.com/seek-oss/vocab/pull/15) Thanks [@mattcompiles](https://github.com/mattcompiles)! - Added watch mode to generate-types
-
-* Updated dependencies [[`08de30d`](https://github.com/seek-oss/vocab/commit/08de30d338c2a5ebdcf14da7c736dddf22e7ca9e)]:
-  - @vocab/types@0.0.4
-
-## 0.0.2
-
-### Patch Changes
-
-- [`4710f34`](https://github.com/seek-oss/vocab/commit/4710f341f2827643e3eff69ef7e26d44ec6e8a2b) [#8](https://github.com/seek-oss/vocab/pull/8) Thanks [@mattcompiles](https://github.com/mattcompiles)! - Infer `t` return type more intelligently
-
-  The translate key function (`t`) will now infer the return type as ReactNode only when the tag syntax is used.
-
-- Updated dependencies [[`4710f34`](https://github.com/seek-oss/vocab/commit/4710f341f2827643e3eff69ef7e26d44ec6e8a2b)]:
-  - @vocab/types@0.0.3