handlebars-i18n 1.9.0 → 1.10.1

package/.github/workflows/ci.yml

@@ -1,10 +1,7 @@
-name: CI
+name: CI Build (manual)
 
 on:
-  pull_request:
-  push:
-  release:
-    types: [published]
+  workflow_dispatch:
 
 env:
   IMAGE_ID: ${{ github.repository }}

package/.github/workflows/coveralls.yml

@@ -1,4 +1,4 @@
-name: Test and Coverage
+name: CI Test and Coverage
 
 on:
   push:
@@ -13,10 +13,10 @@ jobs:
 
       - uses: actions/checkout@v3
 
-      - name: Use Node.js 16.x
+      - name: Use Node.js 22.x
         uses: actions/setup-node@v3
         with:
-          node-version: 16.x
+          node-version: 22.x
 
       - name: npm install, make test-coverage
         run: |

package/.github/workflows/node.js.yml

@@ -1,7 +1,7 @@
 # This workflow will do a clean installation of node dependencies, cache/restore them, build the source code and run tests across different versions of node
 # For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-nodejs
 
-name: Node.js CI
+name: CI Build 16, 18, 20
 
 on:
   push:
@@ -16,15 +16,15 @@ jobs:
 
     strategy:
       matrix:
-        node-version: [14.x, 16.x, 18.x]
+        node-version: [ 16.x, 18.x, 20.x ]
         # See supported Node.js release schedule at https://nodejs.org/en/about/releases/
 
     steps:
-    - uses: actions/checkout@v3
-    - name: Use Node.js ${{ matrix.node-version }}
-      uses: actions/setup-node@v3
-      with:
-        node-version: ${{ matrix.node-version }}
-        cache: 'npm'
-    - run: npm ci
-    - run: npm run build --if-present
+      - uses: actions/checkout@v3
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v3
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+      - run: npm ci
+      - run: npm run build --if-present

package/dist/handlebars-i18n.js

@@ -389,7 +389,7 @@
 
           // Force object/array return if needed
           const result = (typeof i18next !== "undefined")
-            ? i18next.t(key, { ...hash, returnObjects: true })
+            ? i18next.t(key, {...hash, returnObjects: true})
             : key;
 
           if (typeof result === "string") {
@@ -398,6 +398,18 @@
           return result;
         }
       );
+      handlebars.registerHelper('keyExists',
+        /**
+         * checks if a translation key exists
+         * use like: {{#if (keyExists "myKey")}} {{__ "myKey"}} {{/if}}
+         *
+         * @param {string} key - The translation key to check
+         * @returns {boolean}
+         */
+        function (key) {
+          return i18next.exists(key);
+        }
+      );
       handlebars.registerHelper('_locale',
         /**
          * echos the current language
@@ -543,6 +555,7 @@
       );
       handlebars.registerHelper('_dateDiff',
         /**
+         * Outputs the relative time difference between two given dates in the requested unit.
          *
          * @param dateInputA
          * @param dateInputB

package/dist/handlebars-i18n.min.js

@@ -1 +1 @@
-!function(e,t){if("object"==typeof exports&&"object"==typeof module){const e=require("handlebars"),r=require("i18next"),n=require("intl"),a=require("relative-time-format");module.exports=t(e,r,n,a,"TEST"===process?.env?.NODE_ENV)}else if("function"==typeof define&&define.amd)define(["Handlebars","i18next","Intl"],t);else{if("object"!=typeof e.Handlebars||"object"!=typeof e.i18next||"object"!=typeof e.Intl)return console.error("@ handlebars-i18n: One or more dependencies are missing. Check for Handlebars, i18next and Intl."),!1;e.HandlebarsI18n=t(e.Handlebars,e.i18next,e.Intl)}}(this,(function(e,t,r,n,a){"use strict";const o={DateTimeFormat:{standard:{},custom:{}},RelativeTimeFormat:{standard:{all:{unit:"hours"}},custom:{}},NumberFormat:{standard:{},custom:{}},PriceFormat:{standard:{all:{style:"currency",currency:"EUR"}},custom:{}}};let i=JSON.parse(JSON.stringify(o));const s={};function u(e,t){let r=[null].concat(t);return new(e.bind.apply(e,r))}function l(e,t,r){if("object"==typeof e&&"object"==typeof e.hash&&Object.keys(e.hash).length>0){let n=e.hash;if(void 0===n.format)return n;if(void 0!==r.custom[n.format]&&void 0!==r.custom[n.format][t])return r.custom[n.format][t]}return void 0!==r.standard[t]?r.standard[t]:void 0!==r.standard.all?r.standard.all:{}}function c(e,t,r,n){return"string"!=typeof e?(console.error("@ handlebars-i18n.configure(): Invalid argument <"+e+'> First argument must be a string with language code such as "en".'),!1):["DateTimeFormat","RelativeTimeFormat","NumberFormat","PriceFormat"].includes(t)?"object"!=typeof r?(console.error("@ handlebars-i18n.configure(): Invalid argument <"+r+"> Third argument must be an object containing the configuration parameters."),!1):(null==n||"string"==typeof n)&&""!==n&&" "!==n||(console.error("@ handlebars-i18n.configure(): Invalid argument <"+n+"> Fourth argument (optional) must be a string naming your custom format configuration."),!1):(console.error("@ handlebars-i18n.configure(): Invalid argument <"+t+'>. Second argument must be a string with the options key. Use either "DateTimeFormat", "RelativeTimeFormat", "NumberFormat", or "PriceFormat".'),!1)}function m(e,t,r,n){return null!=n?(void 0===i[t].custom[n]&&(i[t].custom[n]={}),i[t].custom[n][e]=r):i[t].standard[e]=r,!0}function g(e){return"number"==typeof e||"string"==typeof e&&""!==e}function f(e){let t;if("number"==typeof e)t=new Date(e);else if("string"==typeof e)if("["===e.charAt(0)&&"]"===e.slice(-1)){let r=(e=e.substring(1,e.length-1).replace(/ /g,"")).split(",");t=u.bind(null,Date)(r)}else t="now"===e.toLowerCase()||"today"===e.toLowerCase()?new Date:new Date(e);else t=new Date;return t}function d(e,t){if("function"==typeof r.RelativeTimeFormat)return new r.RelativeTimeFormat(e,t);if(void 0===s[e])try{s[e]=require(`relative-time-format/locale/${e}`)}catch(e){console.error(e)}return n.addLocale(s[e]),new n(e,t)}function b(e,t){return t=t||"hour",Math.trunc(e/{second:1e3,seconds:1e3,minute:6e4,minutes:6e4,hour:36e5,hours:36e5,day:864e5,days:864e5,week:6048e5,weeks:6048e5,month:2629746e3,months:2629746e3,quarter:78894e5,quarters:78894e5,year:315576e5,years:315576e5}[t])}return{configure:function(e,t,r,n){if("string"!=typeof e&&!Array.isArray(e))return console.error("@ handlebars-i18n.configure(): Invalid argument <"+e+'> First argument must be a string with language code such as "en" or an array with language parameters.'),!1;if(Array.isArray(e)){if(e.length<1)return console.log("@ handlebars-i18n.configure(): You passed an empty array, no parameters taken."),!1;e.forEach((e=>{if(!c(e[0],e[1],e[2],e[3]))return!1;m(e[0],e[1],e[2],e[3])}))}else{if(!c(e,t,r,n))return!1;m(e,t,r,n)}return!0},reset:function(){return i=JSON.parse(JSON.stringify(o)),!0},init:function(n,a){return"object"==typeof n&&null!==n?e=n:null!=n&&console.error("@ handlebars-i18n.init(): Invalid Argument [1] given for overrideHndlbrs. Argument must be the Handlebars object. Using generic Handlebars object instead."),"object"==typeof a&&null!==a?t=a:null!=a&&console.error("@ handlebars-i18n.init(): Invalid Argument [2] given for overrideI18n. Argument must be the i18next object. Using generic i18next object on module level instead."),e.registerHelper("__",(function(r,n){const a=n.hash||{},o=void 0!==t?t.t(r,{...a,returnObjects:!0}):r;return"string"==typeof o?new e.SafeString(o):o})),e.registerHelper("_locale",(function(){return t.language})),e.registerHelper("localeIs",(function(e){return t.language===e})),e.registerHelper("_date",(function(e,n){const a=f(e),o=l(n,t.language,i.DateTimeFormat);return new r.DateTimeFormat(t.language,o).format(a)})),e.registerHelper("_dateAdd",(function(e,n,a){if("number"!=typeof e&&"string"!=typeof e)throw new Error('@ handlebars-i18n: invalid first argument "dateInput" was given for _dateAdd.');if("number"!=typeof n)throw new Error('@ handlebars-i18n: invalid second argument "offset" was given for _dateAdd.');const o=f(e),s=l(a,t.language,i.DateTimeFormat);switch(s.unit=s.unit||"hour",s.unit){case"second":case"seconds":o.setSeconds(o.getSeconds()+n);break;case"minute":case"minutes":o.setMinutes(o.getMinutes()+n);break;case"hour":case"hours":o.setHours(o.getHours()+n);break;case"day":case"days":o.setDate(o.getDate()+n);break;case"week":case"weeks":o.setDate(o.getDate()+7*n);break;case"month":case"months":o.setMonth(o.getMonth()+n);break;case"quarter":case"quarters":o.setMonth(o.getMonth()+3*n);break;case"year":case"years":o.setFullYear(o.getFullYear()+n);break;default:throw new Error('@ handlebars-i18n: invalid argument "unit" was given for _dateAdd.Unit must be one of "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year".')}return new r.DateTimeFormat(t.language,s).format(o)})),e.registerHelper("_dateRel",(function(e,r){const n=parseInt(e),a=l(r,t.language,i.RelativeTimeFormat);return d(t.language,a).format(n,a.unit)})),e.registerHelper("_dateDiff",(function(e,r,n){let a,o=l(n,t.language,i.RelativeTimeFormat);if(!g(e))return console.error("@ handlebars-i18n: invalid first argument dateInputA was given for _dateDiff."),null;r=r||"now",a=f(e)-f(r);const s=b(a,o.unit);return d(t.language,o).format(s,o.unit)})),e.registerHelper("_num",(function(e,n){let a=l(n,t.language,i.NumberFormat);return new r.NumberFormat(t.language,a).format(e)})),e.registerHelper("_price",(function(e,n){let a=l(n,t.language,i.PriceFormat);"string"!=typeof a.style&&"string"==typeof a.currency&&(a.style="currency");return new r.NumberFormat(t.language,a).format(e)})),e},...a&&{private:{applyToConstructor:u,configLookup:l,validateArgs:c,setArgs:m,isNumOrString:g,createDateObj:f,getRelDateFormatPolyfill:d,getDateDiff:b}}}}));
+!function(e,t){if("object"==typeof exports&&"object"==typeof module){const e=require("handlebars"),r=require("i18next"),n=require("intl"),a=require("relative-time-format");module.exports=t(e,r,n,a,"TEST"===process?.env?.NODE_ENV)}else if("function"==typeof define&&define.amd)define(["Handlebars","i18next","Intl"],t);else{if("object"!=typeof e.Handlebars||"object"!=typeof e.i18next||"object"!=typeof e.Intl)return console.error("@ handlebars-i18n: One or more dependencies are missing. Check for Handlebars, i18next and Intl."),!1;e.HandlebarsI18n=t(e.Handlebars,e.i18next,e.Intl)}}(this,(function(e,t,r,n,a){"use strict";const o={DateTimeFormat:{standard:{},custom:{}},RelativeTimeFormat:{standard:{all:{unit:"hours"}},custom:{}},NumberFormat:{standard:{},custom:{}},PriceFormat:{standard:{all:{style:"currency",currency:"EUR"}},custom:{}}};let i=JSON.parse(JSON.stringify(o));const s={};function u(e,t){let r=[null].concat(t);return new(e.bind.apply(e,r))}function l(e,t,r){if("object"==typeof e&&"object"==typeof e.hash&&Object.keys(e.hash).length>0){let n=e.hash;if(void 0===n.format)return n;if(void 0!==r.custom[n.format]&&void 0!==r.custom[n.format][t])return r.custom[n.format][t]}return void 0!==r.standard[t]?r.standard[t]:void 0!==r.standard.all?r.standard.all:{}}function c(e,t,r,n){return"string"!=typeof e?(console.error("@ handlebars-i18n.configure(): Invalid argument <"+e+'> First argument must be a string with language code such as "en".'),!1):["DateTimeFormat","RelativeTimeFormat","NumberFormat","PriceFormat"].includes(t)?"object"!=typeof r?(console.error("@ handlebars-i18n.configure(): Invalid argument <"+r+"> Third argument must be an object containing the configuration parameters."),!1):(null==n||"string"==typeof n)&&""!==n&&" "!==n||(console.error("@ handlebars-i18n.configure(): Invalid argument <"+n+"> Fourth argument (optional) must be a string naming your custom format configuration."),!1):(console.error("@ handlebars-i18n.configure(): Invalid argument <"+t+'>. Second argument must be a string with the options key. Use either "DateTimeFormat", "RelativeTimeFormat", "NumberFormat", or "PriceFormat".'),!1)}function m(e,t,r,n){return null!=n?(void 0===i[t].custom[n]&&(i[t].custom[n]={}),i[t].custom[n][e]=r):i[t].standard[e]=r,!0}function g(e){return"number"==typeof e||"string"==typeof e&&""!==e}function f(e){let t;if("number"==typeof e)t=new Date(e);else if("string"==typeof e)if("["===e.charAt(0)&&"]"===e.slice(-1)){let r=(e=e.substring(1,e.length-1).replace(/ /g,"")).split(",");t=u.bind(null,Date)(r)}else t="now"===e.toLowerCase()||"today"===e.toLowerCase()?new Date:new Date(e);else t=new Date;return t}function d(e,t){if("function"==typeof r.RelativeTimeFormat)return new r.RelativeTimeFormat(e,t);if(void 0===s[e])try{s[e]=require(`relative-time-format/locale/${e}`)}catch(e){console.error(e)}return n.addLocale(s[e]),new n(e,t)}function b(e,t){return t=t||"hour",Math.trunc(e/{second:1e3,seconds:1e3,minute:6e4,minutes:6e4,hour:36e5,hours:36e5,day:864e5,days:864e5,week:6048e5,weeks:6048e5,month:2629746e3,months:2629746e3,quarter:78894e5,quarters:78894e5,year:315576e5,years:315576e5}[t])}return{configure:function(e,t,r,n){if("string"!=typeof e&&!Array.isArray(e))return console.error("@ handlebars-i18n.configure(): Invalid argument <"+e+'> First argument must be a string with language code such as "en" or an array with language parameters.'),!1;if(Array.isArray(e)){if(e.length<1)return console.log("@ handlebars-i18n.configure(): You passed an empty array, no parameters taken."),!1;e.forEach((e=>{if(!c(e[0],e[1],e[2],e[3]))return!1;m(e[0],e[1],e[2],e[3])}))}else{if(!c(e,t,r,n))return!1;m(e,t,r,n)}return!0},reset:function(){return i=JSON.parse(JSON.stringify(o)),!0},init:function(n,a){return"object"==typeof n&&null!==n?e=n:null!=n&&console.error("@ handlebars-i18n.init(): Invalid Argument [1] given for overrideHndlbrs. Argument must be the Handlebars object. Using generic Handlebars object instead."),"object"==typeof a&&null!==a?t=a:null!=a&&console.error("@ handlebars-i18n.init(): Invalid Argument [2] given for overrideI18n. Argument must be the i18next object. Using generic i18next object on module level instead."),e.registerHelper("__",(function(r,n){const a=n.hash||{},o=void 0!==t?t.t(r,{...a,returnObjects:!0}):r;return"string"==typeof o?new e.SafeString(o):o})),e.registerHelper("keyExists",(function(e){return t.exists(e)})),e.registerHelper("_locale",(function(){return t.language})),e.registerHelper("localeIs",(function(e){return t.language===e})),e.registerHelper("_date",(function(e,n){const a=f(e),o=l(n,t.language,i.DateTimeFormat);return new r.DateTimeFormat(t.language,o).format(a)})),e.registerHelper("_dateAdd",(function(e,n,a){if("number"!=typeof e&&"string"!=typeof e)throw new Error('@ handlebars-i18n: invalid first argument "dateInput" was given for _dateAdd.');if("number"!=typeof n)throw new Error('@ handlebars-i18n: invalid second argument "offset" was given for _dateAdd.');const o=f(e),s=l(a,t.language,i.DateTimeFormat);switch(s.unit=s.unit||"hour",s.unit){case"second":case"seconds":o.setSeconds(o.getSeconds()+n);break;case"minute":case"minutes":o.setMinutes(o.getMinutes()+n);break;case"hour":case"hours":o.setHours(o.getHours()+n);break;case"day":case"days":o.setDate(o.getDate()+n);break;case"week":case"weeks":o.setDate(o.getDate()+7*n);break;case"month":case"months":o.setMonth(o.getMonth()+n);break;case"quarter":case"quarters":o.setMonth(o.getMonth()+3*n);break;case"year":case"years":o.setFullYear(o.getFullYear()+n);break;default:throw new Error('@ handlebars-i18n: invalid argument "unit" was given for _dateAdd.Unit must be one of "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year".')}return new r.DateTimeFormat(t.language,s).format(o)})),e.registerHelper("_dateRel",(function(e,r){const n=parseInt(e),a=l(r,t.language,i.RelativeTimeFormat);return d(t.language,a).format(n,a.unit)})),e.registerHelper("_dateDiff",(function(e,r,n){let a,o=l(n,t.language,i.RelativeTimeFormat);if(!g(e))return console.error("@ handlebars-i18n: invalid first argument dateInputA was given for _dateDiff."),null;r=r||"now",a=f(e)-f(r);const s=b(a,o.unit);return d(t.language,o).format(s,o.unit)})),e.registerHelper("_num",(function(e,n){let a=l(n,t.language,i.NumberFormat);return new r.NumberFormat(t.language,a).format(e)})),e.registerHelper("_price",(function(e,n){let a=l(n,t.language,i.PriceFormat);"string"!=typeof a.style&&"string"==typeof a.currency&&(a.style="currency");return new r.NumberFormat(t.language,a).format(e)})),e},...a&&{private:{applyToConstructor:u,configLookup:l,validateArgs:c,setArgs:m,isNumOrString:g,createDateObj:f,getRelDateFormatPolyfill:d,getDateDiff:b}}}}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "handlebars-i18n",
-  "version": "1.9.0",
+  "version": "1.10.1",
   "description": "handlebars-i18n adds internationalization to handlebars.js using i18next and Intl.",
   "main": "dist/handlebars-i18n.js",
   "scripts": {
@@ -42,26 +42,27 @@
     "intl": "^1.2.5"
   },
   "devDependencies": {
-    "@commitlint/cli": "17.6.1",
-    "@commitlint/config-conventional": "16.2.1",
+    "@commitlint/cli": "20.2.0",
+    "@commitlint/config-conventional": "20.2.0",
     "@types/intl": "^1.2.2",
-    "@types/node": "^24.5.2",
+    "@types/node": "^24.10.1",
     "c8": "^10.1.3",
-    "chai": "4.3.6",
-    "coveralls-next": "^4.2.1",
-    "gulp": "5.0.0",
-    "gulp-rename": "2.0.0",
+    "chai": "6.2.1",
+    "coveralls-next": "^6.0.1",
+    "glob": "^13.0.0",
+    "gulp": "5.0.1",
+    "gulp-rename": "2.1.0",
     "gulp-uglify": "3.0.2",
     "gulp-uglify-es": "3.0.0",
     "html-entities": "^2.6.0",
-    "mocha": "10.7.3",
+    "mocha": "11.7.5",
     "mocha-lcov-reporter": "^1.3.0",
-    "nyc": "15.1.0",
-    "typescript": "^4.9.5"
+    "nyc": "17.1.0",
+    "typescript": "^5.9.3"
   },
   "dependencies": {
     "handlebars": "^4.7.8",
-    "i18next": "^21.10.0",
+    "i18next": "^25.7.1",
     "intl": "^1.2.5",
     "relative-time-format": "^1.1.11"
   },

package/readme.md

@@ -2,7 +2,7 @@
 
 *What it is about:* `handlebars-i18n` adds the translation features of [i18next](https://www.i18next.com/)
 to [handlebars.js](https://handlebarsjs.com/). It also provides **date**, **number**, and **currency formatting**
-via [Intl](https://developer.mozilla.org/de/docs/Web/JavaScript/Reference/Global_Objects/Intl). Use as node module or in the web browser. handlebars-i18n is listed amongst i18next’s official [framework helpers](https://www.i18next.com/overview/supported-frameworks).
+via [Intl](https://developer.mozilla.org/de/docs/Web/JavaScript/Reference/Global_Objects/Intl). Use as node module or in the web browser. `handlebars-i18n` is listed amongst i18next’s official [framework helpers](https://www.i18next.com/overview/supported-frameworks).
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 ![Node.js version](https://img.shields.io/badge/node-%3E%3D14-brightgreen)
@@ -17,7 +17,7 @@ via [Intl](https://developer.mozilla.org/de/docs/Web/JavaScript/Reference/Global
 
 ## Key Features & Advantages
 
-- handlebars-i18n comes lightweight, well tested, and with detailed [examples](#-detailed-examples)
+- handlebars-i18n comes lightweight, well tested, and with detailed [examples](#detailed-examples)
 - allows granular custom [presets](#generic-language-format-settings) per language
 - supports Typescript
 - has an optional [CLI](#additional-cli-helper-for-handlebars-i18n-available) for automatic Translations via DeepL
@@ -25,7 +25,7 @@ via [Intl](https://developer.mozilla.org/de/docs/Web/JavaScript/Reference/Global
 
 ## Please Support
 
-`handlebars-i18n` is free but not free of value. If you make serious use of handlebars-i18n, I’d be delighted if you 
+`handlebars-i18n` is free but not free of value. If you make serious use of handlebars-i18n, I’d be delighted if you
 
 [![BuyMeACoffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-ffdd00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black)](https://www.buymeacoffee.com/fwalzel)
 
@@ -38,7 +38,7 @@ npm i handlebars-i18n
 
 ## Import
 
-Import with ES6 import syntax:
+Import with ES6 syntax:
 
 ```typescript
 import HandlebarsI18n from "handlebars-i18n";
@@ -66,7 +66,7 @@ Usage in web browser (old school):
 
 Via CDN:
 ```javascript
-<script src="https://cdn.jsdelivr.net/npm/handlebars-i18n@1.9.0/dist/handlebars-i18n.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/handlebars-i18n@1.10.1/dist/handlebars-i18n.min.js"></script>
 ```
 
 ## Quick Example
@@ -157,7 +157,7 @@ Finally use in template:
 
 ## Additional CLI Helper for Handlebars-i18n available
 
-:metal: Handlebars-i18n has its own command line
+:metal: `handlebars-i18n` has its own command line
 interface [handlebars-i18n-cli](https://www.npmjs.com/package/handlebars-i18n-cli).
 
 ```sh
@@ -168,13 +168,13 @@ npm i handlebars-i18n-cli --save-dev
   JSON files from it
 * automatic translation of i18next JSON via [DeepL’s](https://www.deepl.com/en/pro-api/) free API
 
-## Public Functions
+## Template Functions
 
 ### `__`
 
 Returns the phrase associated with the given key for the selected language. `__` will take all options
 i18next’s [t-function](https://www.i18next.com/overview/api#t) would take.
-The primary key can be passed hard encoded in the template when written in quotes:
+The key can be passed hard encoded in the template when written in quotes:
 
 ```hbs
 {{__ "keyToTranslationPhrase"}}
@@ -204,6 +204,8 @@ The i18next resource:
 }
 ```
 
+* output: en → **Everything is fine.**
+
 **Plurals**
 
 ```hbs
@@ -249,11 +251,21 @@ In this case the key `fruits` would contain an array of translation strings, lik
 }
 ```
 
-It is recommended to set `returnObjects` actively to `true` in the `i18next.init` object if you want to loop over 
+It is recommended to set `returnObjects` actively to `true` in the `i18next.init` object if you want to loop over
 an array or objects of properties.
 
 ---
 
+### `keyExists`
+
+Checks if a i18next translation key exists. Returns `true` or `false`.
+
+```hbs
+{{#if (keyExists "myKey")}} {{__ "myKey"}} {{/if}}
+```
+
+---
+
 ### `_locale`
 
 Returns the shortcode of i18next’s currently selected language such as `en`, `de`, `ja` … etc.
@@ -266,7 +278,7 @@ Returns the shortcode of i18next’s currently selected language such as `en`, `
 
 ### `localeIs`
 
-Checks a string against i18next’s currently selected language. Returns **true** or **false**.
+Checks a string against i18next’s currently selected language. Returns `true` or `false`.
 
 ```hbs
 {{#if (localeIs "en")}} ... {{/if}}
@@ -312,7 +324,7 @@ seconds [, milliseconds]]]]]]:
 {{_date "[2012, 11, 20, 3, 0, 0]"}}
 ```
 
-**Additional arguments for formatting**
+**Additional arguments for formatting:**
 
 You can add multiple arguments for individual formatting.
 See [Intl DateTimeFormat](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat)
@@ -325,7 +337,7 @@ in [handlebars-i18n.d.ts](./dist/handlebars-i18n.d.ts).
 
 ---
 
-### `_dateAdd` :tada: new in 1.8
+### `_dateAdd`
 
 Adds a time offset in a given unit to a date, returns the modified date.
 
@@ -335,16 +347,16 @@ Adds a time offset in a given unit to a date, returns the modified date.
 
 * output: en → **12/18/1996**
 
-The first argument is a date (see function `_date` for valid date inputs). The second argument is a time amount given 
+The first argument is a date (see function `_date` for valid date inputs). The second argument is a time amount given
 as number. The option **unit** specifies the time amount. Possible units
-are `"second"` | `"minute"` | `"hour"` | `"day"` | `"week"` | `"month"` | `"quarter"` |`"year"` (default is `"hour"`).
+are `second` | `minute` | `hour` | `day` | `week` | `month` | `quarter` | `year` (default is `hour`).
 Further options as for function `_date` can be applied.
 
 ---
 
 ### `_dateDiff`
 
-Outputs the relative time difference between two given dates.
+Outputs the time difference between two given dates in the requested unit.
 
 ```hbs
 {{_dateDiff "2000-12-17" "2001-12-17" unit="year"}}
@@ -352,12 +364,12 @@ Outputs the relative time difference between two given dates.
 * output: en → **in 1 year**
 
 The second date argument is subtracted from the first. If the difference is a positive value, a future event statement
-is made. A negative value refers to a past date. (If no second argument is given, the default date is the present moment). 
-Allowed date input formats are similar to `_date`, options equal `_dateRel`. Default unit is `"hour"`.
+is made. A negative value refers to a past date. (If no second argument is given, the default date is the present moment).
+Allowed date input formats are similar to `_date`, options equal `_dateRel`. Default unit is `hour`.
 
 ---
 
-### `_dateRel` 
+### `_dateRel`
 
 Outputs a string with a relative date statement, formatted according to the language specific conventions.
 
@@ -374,7 +386,7 @@ Outputs a string with a relative date statement, formatted according to the lang
 * output: en → **7 hours ago**
 
 A positive number argument leads to a future event statement, a negative refers to a past date. Possible units
-are `"second"` | `"minute"` | `"hour"` | `"day"` | `"week"` | `"month"` | `"quarter"` |`"year"` (default is `"hour"`). 
+are `second` | `minute` | `hour` | `day` | `week` | `month` | `quarter` | `year` (default is `hour`).
 For a complete set of options (such as `numberingSystem` or `localeMatcher`)
 see [Intl.RelativeTimeFormat Constructor](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/RelativeTimeFormat/RelativeTimeFormat).
 Alternatively check this repo’s TS types in [handlebars-i18n.d.ts](./dist/handlebars-i18n.d.ts).
@@ -386,10 +398,10 @@ Alternatively check this repo’s TS types in [handlebars-i18n.d.ts](./dist/hand
 Outputs a formatted number according to the language specific conventions of number representation.
 
 ```hbs
-{{_num 4100000.8314 }}
+{{_num 3.14159}}
 ```
 
-**Additional arguments for formatting**
+**Additional arguments for formatting:**
 
 You can add multiple arguments for individual formatting.
 See [Intl NumberFormat](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat)
@@ -412,7 +424,7 @@ Outputs a formatted currency string according to the language specific conventio
 {{_price 9999.99}}
 ```
 
-**Additional arguments for formatting**
+**Additional arguments for formatting:**
 
 You can add multiple arguments for individual currency formatting.
 See [Intl NumberFormat](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat)
@@ -440,7 +452,7 @@ First argument is the language shortcode or `"all"` for all languages. Second is
 address (`DateTimeFormat`, `RelativeTimeFormat`, `NumberFormat`, or `PriceFormat`). Third argument is the options object
 with the specific settings.
 
-Examples for generic settings:
+**Examples for generic settings:**
 
 ```javascript
 HandlebarsI18n.configure("all", "RelativeTimeFormat", {style: "long", unit: "second"});
@@ -527,7 +539,7 @@ it instead of the generic Handlebars object like so:
 ```javascript
 const HandlebarsModified = require("handlebars");
 HandlebarsModified.registerHelper("foo", function () {
-  return "what you want"
+  return "bar"
 });
 HandlebarsI18n.init(HandlebarsModified);
 ```

package/test/handlebars-i18n.test.js

@@ -219,6 +219,30 @@ describe('handlebars-i18n Tests', function () {
   });
 
 
+  /****************************************
+   Tests against function keyExists
+   ****************************************/
+
+  it('should return true for an existing translation key', function() {
+    const exists = hI18n.helpers.keyExists('key1');
+    assert.isTrue(exists);
+  });
+
+  it('should return false for a non-existing translation key', function() {
+    const exists = hI18n.helpers.keyExists('nonExistentKey');
+    assert.isFalse(exists);
+  });
+
+  it('should return false when called with no parameters', function() {
+    const exists = hI18n.helpers.keyExists();
+    assert.isFalse(exists);
+  });
+
+  it('should return false when called with null or undefined', function() {
+    assert.isFalse(hI18n.helpers.keyExists(null));
+    assert.isFalse(hI18n.helpers.keyExists(undefined));
+  });
+
   /****************************************
    Tests against function _date
    ****************************************/