Add build for modern browsers (index.modern.js)

Bump css-loader from 6.2.0 to 6.4.0

.eslintignore

@@ -1 +1,2 @@
-build/*
+build/*
+/**/*.d.ts

.eslintrc.json

@@ -1,30 +1,26 @@
 {
-    "parser": "babel-eslint",
+    "parser": "@typescript-eslint/parser",
     "parserOptions": {
         "ecmaVersion": 6,
         "sourceType": "module",
         "ecmaFeatures": {
-            "jsx": true,
             "modules": true,
             "experimentalObjectRestSpread": true
         }
     },
-    "plugins": [
-        "react"
-    ],
-    "extends": ["eslint:recommended", "plugin:react/recommended"],
+    "plugins": ["@typescript-eslint"],
+    "extends": ["eslint:recommended", "plugin:@typescript-eslint/recommended"],
     "rules": {
         "comma-dangle": 0,
         "no-unused-vars": "warn",
         "no-unexpected-multiline": "warn",
-        "prefer-const": "warn"
-    },
-    "settings": {
-        "react": {
-            "pragma": "React",
-            "version": "15.6.1"
-        }
+        "prefer-const": "warn",
+        "@typescript-eslint/no-empty-function": "off",
+        "@typescript-eslint/explicit-module-boundary-types": "off",
+        "@typescript-eslint/no-explicit-any": "off",
+        "@typescript-eslint/no-var-requires": "off"
     },
+    "settings": {},
     "env": {
         "browser": true,
         "node": true,
@@ -32,4 +28,4 @@
         "jest": true,
         "es6": true
     }
-}
+}

.github/FUNDING.yml

@@ -1 +1 @@
-github: hodgef
+custom: https://hge.to/thanks

.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+- package-ecosystem: npm
+  directory: "/"
+  schedule:
+    interval: daily
+    time: "04:00"
+    timezone: America/Montreal
+  open-pull-requests-limit: 10
+  versioning-strategy: increase

.github/stale.yml

@@ -1,11 +1,13 @@
 # Number of days of inactivity before an issue becomes stale
-daysUntilStale: 3
+daysUntilStale: 5
 # Number of days of inactivity before a stale issue is closed
 daysUntilClose: 2
 # Issues with these labels will never be considered stale
 exemptLabels:
   - pinned
   - security
+  - "💥 Bug"
+  - "⚡️ Enhancement"
 # Label to use when marking an issue as stale
 staleLabel: Stale
 # Comment to post when marking an issue as stale. Set to `false` to disable
@@ -14,4 +16,4 @@ markComment: >
   recent activity. It will be closed if no further activity occurs. Thank you
   for your contributions.
 # Comment to post when closing a stale issue. Set to `false` to disable
-closeComment: false
+closeComment: false

.github/workflows/main.yml

@@ -1,44 +1,47 @@
 name: Build
-on: [push]
+on:
+  push:
+    paths-ignore:
+      - README.md
+      - .gitignore
+      - .github/**
 
 jobs:
   build:
     runs-on: ${{ matrix.os }}
+    if: contains(github.ref, 'master')
     strategy:
       matrix:
         node-version: [12.x]
         os: [ubuntu-latest]
     steps:
-    - uses: actions/checkout@v1
-    - name: Use Node.js ${{ matrix.node_version }}
-      uses: actions/setup-node@v1
-      with:
-        node-version: ${{ matrix.node_version }}
-    - name: npm install, build, and test
-      run: |
-        npm install
-        npm run start -- --testMode
-        npm run demo
-        npm run coverage
-    - uses: codecov/codecov-action@v1.0.2
-      with:
-        token: ${{secrets.CODECOV_TOKEN}}
-      env:
-        CI: true
-        
-    - name: Discord notification
-      if: success()
-      env:
-        DISCORD_WEBHOOK: ${{ secrets.DISCORD_WEBHOOK }}
-      uses: Ilshidur/action-discord@master
-      with:
-        args: 'simple-keyboard - CI Build Passed'
-        
-    - name: Discord notification
-      if: failure()
-      env:
-        DISCORD_WEBHOOK: ${{ secrets.DISCORD_WEBHOOK }}
-      uses: Ilshidur/action-discord@master
-      with:
-        args: 'simple-keyboard - CI Build Failed'
-        
+      - uses: actions/checkout@v1
+      - name: Use Node.js ${{ matrix.node_version }}
+        uses: actions/setup-node@v1
+        with:
+          node-version: ${{ matrix.node_version }}
+      - name: npm install, build, and test
+        run: |
+          npm install
+          npm run coverage
+      - uses: codecov/codecov-action@v1.0.2
+        with:
+          token: ${{secrets.CODECOV_TOKEN}}
+        env:
+          CI: true
+
+      - name: Discord notification
+        if: success()
+        env:
+          DISCORD_WEBHOOK: ${{ secrets.DISCORD_WEBHOOK }}
+        uses: Ilshidur/action-discord@master
+        with:
+          args: "simple-keyboard - CI Build Passed"
+
+      - name: Discord notification
+        if: failure()
+        env:
+          DISCORD_WEBHOOK: ${{ secrets.DISCORD_WEBHOOK }}
+        uses: Ilshidur/action-discord@master
+        with:
+          args: "simple-keyboard - CI Build Failed"

.github/workflows/mirroring.yml

@@ -0,0 +1,19 @@
+name: Mirroring
+
+on:
+  push:
+    branches:
+      - master
+  delete:
+    branches:
+      - master
+
+jobs:
+  mirroring:
+    runs-on: ubuntu-18.04
+    steps:
+      - uses: actions/checkout@v1
+      - uses: pixta-dev/repository-mirroring-action@v1
+        with:
+          target_repo_url: git@gitlab.com:hodgef/simple-keyboard.git
+          ssh_private_key: ${{ secrets.GL_KEY }}

.github/workflows/publish.yml

@@ -4,6 +4,10 @@ on:
   push:
     branches:
       - master
+    paths-ignore:
+      - README.md
+      - .gitignore
+      - .github/**
 
 jobs:
   publish:
@@ -15,7 +19,7 @@ jobs:
           node-version: 12
       - run: npm install
       - run: npm run test -- --coverage --watchAll=false
-        
+
       - name: Setup GIT
         run: |
           git reset --hard
@@ -24,8 +28,8 @@ jobs:
           git config user.email "$GH_EMAIL"
           git config user.name "Francisco Hodge"
         env:
-            GH_EMAIL: ${{secrets.GH_EMAIL}}
-          
+          GH_EMAIL: ${{secrets.GH_EMAIL}}
+
       - name: Bump version
         run: |
           git reset --hard
@@ -36,10 +40,10 @@ jobs:
           git push "https://$GITHUB_ACTOR:$GITHUB_TOKEN@github.com/$GITHUB_REPOSITORY"
         env:
           GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}
-          
+
       - name: npm publish
         run: |
           npm config set //registry.npmjs.org/:_authToken=$NODE_AUTH_TOKEN
           npm run trypublish
         env:
-            NODE_AUTH_TOKEN: ${{secrets.NODE_AUTH_TOKEN}}
+          NODE_AUTH_TOKEN: ${{secrets.NODE_AUTH_TOKEN}}

.github/workflows/pull_request.yml

@@ -1,24 +1,24 @@
-name: Build PR
-on: [pull_request]
+name: Build PR (Standard)
+
+on: pull_request
 
 jobs:
   build:
     runs-on: ${{ matrix.os }}
+    if: ${{ github.actor != 'dependabot[bot]' }}
     strategy:
       matrix:
         node-version: [12.x]
         os: [ubuntu-latest]
     steps:
-    - uses: actions/checkout@v1
-    - name: Use Node.js ${{ matrix.node_version }}
-      uses: actions/setup-node@v1
-      with:
-        node-version: ${{ matrix.node_version }}
-    - name: npm install, build, and test
-      run: |
-        npm install
-        npm run start -- --testMode
-        npm run demo
-        npm run coverage
-      env:
-        CI: true
+      - uses: actions/checkout@v1
+      - name: Use Node.js ${{ matrix.node_version }}
+        uses: actions/setup-node@v1
+        with:
+          node-version: ${{ matrix.node_version }}
+      - name: npm install, build, and test
+        run: |
+          npm install
+          npm run coverage
+        env:
+          CI: true

.github/workflows/pull_request_dependabot.yml

@@ -0,0 +1,48 @@
+name: Build PR (Dependabot)
+
+on: pull_request_target
+
+jobs:
+  build:
+    runs-on: ${{ matrix.os }}
+    if: ${{ github.actor == 'dependabot[bot]' }}
+    strategy:
+      matrix:
+        node-version: [12.x]
+        os: [ubuntu-latest]
+    steps:
+      - uses: actions/checkout@v2
+        with:
+          ref: ${{ github.event.pull_request.head.sha }}
+      - name: Use Node.js ${{ matrix.node_version }}
+        uses: actions/setup-node@v1
+        with:
+          node-version: ${{ matrix.node_version }}
+      - name: npm install, build, and test
+        run: |
+          npm install
+          npm run coverage
+        env:
+          CI: true
+      - name: Merge PR
+        if: success()
+        uses: "actions/github-script@v2"
+        with:
+          github-token: "${{ secrets.GH_KEY }}"
+          script: |
+            const pullRequest = context.payload.pull_request
+            const repository = context.repo
+
+            await github.pulls.merge({
+              merge_method: "merge",
+              owner: repository.owner,
+              pull_number: pullRequest.number,
+              repo: repository.repo,
+            })
+      - name: Reject PR
+        if: failure()
+        uses: peter-evans/close-pull@v1
+        with:
+          pull-request-number: ${{github.event.number}}
+          comment: "Closing PR due to failing tests."
+          delete-branch: true

.gitignore

@@ -5,9 +5,6 @@
 /.pnp
 .pnp.js
 
-# production
-/demo
-
 # testing
 /coverage
 

.npmignore

@@ -2,6 +2,7 @@
 /node_modules
 
 # testing
+/tests
 /coverage
 
 # docs
@@ -13,12 +14,13 @@
 .env.development.local
 .env.test.local
 .env.production.local
+/.github
+/demo
+.esdoc.json
 
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
-/.github
-/demo
 
 # Development folders and files
 public
@@ -29,4 +31,6 @@ config
 CHANGELOG.md
 README.md
 .eslintignore
-.eslintrc.json
+.eslintrc.json
+webpack.config.js
+babel.config.js

.travis.yml

@@ -1,19 +0,0 @@
-language: node_js
-node_js:
- - node
-install:
-  - npm install -g codecov
-  - npm install
-script:
-- npm run start -- --testMode
-- npm run demo
-- npm run coverage
-- codecov
-after_success:
-  - wget https://raw.githubusercontent.com/DiscordHooks/travis-ci-discord-webhook/master/send.sh
-  - chmod +x send.sh
-  - ./send.sh success $WEBHOOK_URL
-after_failure:
-  - wget https://raw.githubusercontent.com/DiscordHooks/travis-ci-discord-webhook/master/send.sh
-  - chmod +x send.sh
-  - ./send.sh failure $WEBHOOK_URL

CODE_OF_CONDUCT.md

@@ -0,0 +1,76 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, sex characteristics, gender identity and expression,
+level of experience, education, socio-economic status, nationality, personal
+appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+ advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+ address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+ professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at opensource@hodgef.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see
+https://www.contributor-covenant.org/faq

CONTRIBUTING.md

@@ -0,0 +1,15 @@
+# Contributing
+
+When contributing to this repository, please first discuss the change you wish to make via issue,
+email, or any other method with the owners of this repository before working on a change. 
+
+Please note we have a code of conduct, please follow it in all your interactions with the project.
+
+## Pull Request Guidelines
+
+1. Please ensure your proposal will not radically change current functionality or bring along breaking changes.
+2. PRs only consisting of typo fixes (or other automated contributions), will not be accepted.
+3. Do not add any dependencies to the project.
+4. Document your changes thoroughly.
+5. Ensure coverage is complete (`npm run coverage` should show 100% coverage) and that none of the tests fail.
+6. Be reactive to any comments, reviews or change requests entered in your pull request.

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2019 Francisco Hodge
+Copyright (c) 2019 Francisco Hodge and project contributors.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

README.md

@@ -1,6 +1,6 @@
 <p>
   <a href="https://simple-keyboard.com/demo">
-	<img alt="simple-keyboard: Javascript Virtual Keyboard" src="https://i.imgur.com/Po6659n.gif">
+	<img alt="simple-keyboard: Javascript Virtual Keyboard" src="https://i.imgur.com/PrpbdIu.png">
   </a>
 	
   <a href="https://www.npmjs.com/package/simple-keyboard">
@@ -14,72 +14,69 @@
   <a href="https://github.com/hodgef/simple-keyboard/actions">
      <img alt="Publish Status" src="https://github.com/hodgef/simple-keyboard/workflows/Publish/badge.svg?color=green" />
   </a>
-
-  <a href="https://bundlephobia.com/result?p=simple-keyboard">
-    <img src="https://badgen.net/bundlephobia/minzip/simple-keyboard/?color=green" alt="install size">
-  </a>
   
   <a href="https://david-dm.org/hodgef/simple-keyboard">
     <img src="https://badgen.net/david/dep/hodgef/simple-keyboard" alt="coverage">
   </a>
-
-  <a href="https://codecov.io/gh/hodgef/simple-keyboard">
-    <img src="https://badgen.net/codecov/c/github/hodgef/simple-keyboard" alt="coverage">
-  </a>
 </p>
 
-<blockquote>The slick virtual keyboard for Javascript. Compatible with your JS, React, Angular or Vue projects.</blockquote>
+<blockquote>Virtual Keyboard for Javascript. Compatible with your JS, React, Angular or Vue projects.</blockquote>
+
+## 🚀 Demo
 
-## Demo 🚀 
 [Demo Showcase (Vanilla, Angular, React, Vue)](https://simple-keyboard.com/demo)
 
-## Installation & Usage 📦 
+## 📦 Installation & Usage
+
 You can use simple-keyboard as a `<script>` tag from a CDN, or install it from npm.
-  
+
 Check out the [Getting Started](https://simple-keyboard.com/getting-started) docs to begin.
 
-## Documentation 📖 
+## 📖 Documentation
+
 Check out the [simple-keyboard documentation](https://simple-keyboard.com/documentation) site.
 
 Feel free to browse the [Questions & Answers (FAQ)](https://simple-keyboard.com/qa-use-cases/) page for common use-cases.
 
-
 ### To run demo on your own computer
 
-* Clone this repository
-* `npm install`
-* `npm start`
-* Visit [http://localhost:3000/](http://localhost:3000/)
+- Clone this repository
+- `npm install`
+- `npm start`
+- Visit [http://localhost:3000/](http://localhost:3000/)
 
 ### Other versions
 
-* [React.js](https://github.com/hodgef/react-simple-keyboard)
-* [Angular](https://simple-keyboard.com/demo)
-* [Vue.js](https://simple-keyboard.com/demo)
+- [React.js](https://github.com/hodgef/react-simple-keyboard)
+- [Angular](https://simple-keyboard.com/demo)
+- [Vue.js](https://simple-keyboard.com/demo)
 
 ### Questions? Join the chat
 
 <a href="https://discordapp.com/invite/SJexsCG" title="Join our Discord chat" target="_blank"><img src="https://discordapp.com/api/guilds/498978399801573396/widget.png?style=banner2" align="center"></a>
 
-## Modules ✳️ 
+## ✳️ Modules
 
 You can extend simple-keyboard's functionality with [modules](https://hodgef.com/simple-keyboard/modules/). Such as:
 
-* [Autocorrect](https://hodgef.com/simple-keyboard/modules/autocorrect/)
-* [Input Mask](https://hodgef.com/simple-keyboard/modules/input-mask/)
-* [Key Navigation](https://hodgef.com/simple-keyboard/modules/key-navigation/)
-* [Swipe Keyboard](https://hodgef.com/simple-keyboard/modules/swipe-keyboard/)
+- [Autocorrect](https://hodgef.com/simple-keyboard/modules/autocorrect/)
+- [Input Mask](https://hodgef.com/simple-keyboard/modules/input-mask/)
+- [Key Navigation](https://hodgef.com/simple-keyboard/modules/key-navigation/)
+- [Swipe Keyboard](https://hodgef.com/simple-keyboard/modules/swipe-keyboard/)
 
 Want to create your own module? Check out the [Modules page](https://hodgef.com/simple-keyboard/modules/) for instructions.
 
-## Compatibility 🎯 
+## 🎯 Compatibility
 
-> Simple-keyboard is intended for modern, standards-compliant browsers.
-> Internet Explorer is sadly not one of them, and since its market-share is negligible (~2% for IE11), resources won't be spent in trying to support it.
->
-> For more information, check out [this Q&A entry](https://hodgef.com/simple-keyboard/questions-answers/internet-explorer-not-supported/).
+- Internet Explorer 11
+- Edge (Spartan) 16+
+- Edge (Anaheim/Edge Chromium) 79+
+- Chrome 49+
+- Safari 9+
+- Firefox 57+
+- iOS 9+
 
-## Contributing ✅ 
+## ✅ Contributing
 
 PRs and issues are always welcome. Feel free to submit any issues you have at:
 [https://github.com/hodgef/simple-keyboard/issues](https://github.com/hodgef/simple-keyboard/issues)

babel.config.js

@@ -0,0 +1,22 @@
+module.exports = {
+  presets: [
+    ["@babel/env", {
+      corejs:"3",
+      useBuiltIns: 'usage',
+      "targets": {
+        "browsers": [
+          "edge >= 16",
+          "safari >= 9",
+          "firefox >= 57",
+          "ie >= 11",
+          "ios >= 9",
+          "chrome >= 49"
+        ]
+      },
+    }]
+  ],
+  plugins: [
+    ["@babel/plugin-proposal-class-properties"],
+    ["@babel/plugin-transform-typescript"]
+  ]
+};

build/css/index.css

@@ -1,12 +1,11 @@
 /*!
  * 
- *   simple-keyboard v2.31.0
+ *   simple-keyboard v3.3.0
  *   https://github.com/hodgef/simple-keyboard
- * 
- *   Copyright (c) Francisco Hodge (https://github.com/hodgef)
- * 
+ *
+ *   Copyright (c) Francisco Hodge (https://github.com/hodgef) and project contributors.
+ *
  *   This source code is licensed under the MIT license found in the
  *   LICENSE file in the root directory of this source tree.
- *   
- */.hg-theme-default{width:100%;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;box-sizing:border-box;overflow:hidden;touch-action:manipulation}.hg-theme-default .hg-button span{pointer-events:none}.hg-theme-default button.hg-button{border-width:0;outline:0;font-size:inherit}.hg-theme-default{font-family:"HelveticaNeue-Light","Helvetica Neue Light","Helvetica Neue",Helvetica,Arial,"Lucida Grande",sans-serif;background-color:#ececec;padding:5px;border-radius:5px}.hg-theme-default .hg-button{display:inline-block;flex-grow:1}.hg-theme-default .hg-row{display:flex}.hg-theme-default .hg-row:not(:last-child){margin-bottom:5px}.hg-theme-default .hg-row .hg-button-container,.hg-theme-default .hg-row .hg-button:not(:last-child){margin-right:5px}.hg-theme-default .hg-row>div:last-child{margin-right:0}.hg-theme-default .hg-row .hg-button-container{display:flex}.hg-theme-default .hg-button{box-shadow:0 0 3px -1px rgba(0,0,0,.3);height:40px;border-radius:5px;box-sizing:border-box;padding:5px;background:#fff;border-bottom:1px solid #b5b5b5;cursor:pointer;display:flex;align-items:center;justify-content:center;-webkit-tap-highlight-color:rgba(0,0,0,0)}.hg-theme-default .hg-button.hg-activeButton{background:#efefef}.hg-theme-default.hg-layout-numeric .hg-button{width:33.3%;height:60px;align-items:center;display:flex;justify-content:center}.hg-theme-default .hg-button.hg-button-numpadadd,.hg-theme-default .hg-button.hg-button-numpadenter{height:85px}.hg-theme-default .hg-button.hg-button-numpad0{width:105px}.hg-theme-default .hg-button.hg-button-com{max-width:85px}.hg-theme-default .hg-button.hg-standardBtn.hg-button-at{max-width:45px}.hg-theme-default .hg-button.hg-selectedButton{background:rgba(5,25,70,.53);color:#fff}.hg-theme-default .hg-button.hg-standardBtn[data-skbtn=".com"]{max-width:82px}.hg-theme-default .hg-button.hg-standardBtn[data-skbtn="@"]{max-width:60px}
-/*# sourceMappingURL=index.css.map */
+ *
+ */.hg-theme-default{background-color:#ececec;border-radius:5px;box-sizing:border-box;font-family:HelveticaNeue-Light,Helvetica Neue Light,Helvetica Neue,Helvetica,Arial,Lucida Grande,sans-serif;overflow:hidden;padding:5px;touch-action:manipulation;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;width:100%}.hg-theme-default .hg-button span{pointer-events:none}.hg-theme-default button.hg-button{border-width:0;font-size:inherit;outline:0}.hg-theme-default .hg-button{display:inline-block;flex-grow:1}.hg-theme-default .hg-row{display:flex}.hg-theme-default .hg-row:not(:last-child){margin-bottom:5px}.hg-theme-default .hg-row .hg-button:not(:last-child){margin-right:5px}.hg-theme-default .hg-row .hg-button-container{margin-right:5px}.hg-theme-default .hg-row>div:last-child{margin-right:0}.hg-theme-default .hg-row .hg-button-container{display:flex}.hg-theme-default .hg-button{-webkit-tap-highlight-color:rgba(0,0,0,0);align-items:center;background:#fff;border-bottom:1px solid #b5b5b5;border-radius:5px;box-shadow:0 0 3px -1px rgba(0,0,0,.3);box-sizing:border-box;cursor:pointer;display:flex;height:40px;justify-content:center;padding:5px}.hg-theme-default .hg-button.hg-standardBtn{width:20px}.hg-theme-default .hg-button.hg-activeButton{background:#efefef}.hg-theme-default.hg-layout-numeric .hg-button{align-items:center;display:flex;height:60px;justify-content:center;width:33.3%}.hg-theme-default .hg-button.hg-button-numpadadd,.hg-theme-default .hg-button.hg-button-numpadenter{height:85px}.hg-theme-default .hg-button.hg-button-numpad0{width:105px}.hg-theme-default .hg-button.hg-button-com{max-width:85px}.hg-theme-default .hg-button.hg-standardBtn.hg-button-at{max-width:45px}.hg-theme-default .hg-button.hg-selectedButton{background:rgba(5,25,70,.53);color:#fff}.hg-theme-default .hg-button.hg-standardBtn[data-skbtn=".com"]{max-width:82px}.hg-theme-default .hg-button.hg-standardBtn[data-skbtn="@"]{max-width:60px}.hg-candidate-box{background:#ececec;border-bottom:2px solid #b5b5b5;border-radius:5px;display:inline-flex;margin-top:-10px;max-width:272px;position:absolute;transform:translateY(-100%);-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none}ul.hg-candidate-box-list{display:flex;flex:1;list-style:none;margin:0;padding:0}li.hg-candidate-box-list-item{align-items:center;display:flex;height:40px;justify-content:center;width:40px}li.hg-candidate-box-list-item:hover{background:rgba(0,0,0,.03);cursor:pointer}li.hg-candidate-box-list-item:active{background:rgba(0,0,0,.1)}.hg-candidate-box-prev:before{content:"◄"}.hg-candidate-box-next:before{content:"►"}.hg-candidate-box-next,.hg-candidate-box-prev{align-items:center;background:#d0d0d0;color:#969696;cursor:pointer;display:flex;padding:0 10px}.hg-candidate-box-next{border-bottom-right-radius:5px;border-top-right-radius:5px}.hg-candidate-box-prev{border-bottom-left-radius:5px;border-top-left-radius:5px}.hg-candidate-box-btn-active{color:#444}

build/types/components/CandidateBox.d.ts

@@ -0,0 +1,14 @@
+import "./css/CandidateBox.css";
+import Utilities from "../services/Utilities";
+import { CandidateBoxParams, CandidateBoxRenderParams, CandidateBoxShowParams } from "./../interfaces";
+declare class CandidateBox {
+    utilities: Utilities;
+    candidateBoxElement: HTMLDivElement;
+    pageIndex: number;
+    pageSize: number;
+    constructor({ utilities }: CandidateBoxParams);
+    destroy(): void;
+    show({ candidateValue, targetElement, onSelect, }: CandidateBoxShowParams): void;
+    renderPage({ candidateListPages, targetElement, pageIndex, nbPages, onItemSelected, }: CandidateBoxRenderParams): void;
+}
+export default CandidateBox;

build/types/components/Keyboard.d.ts

@@ -0,0 +1,283 @@
+import "./css/Keyboard.css";
+import PhysicalKeyboard from "../services/PhysicalKeyboard";
+import { KeyboardOptions, KeyboardInput, KeyboardButtonElements, KeyboardHandlerEvent, KeyboardElement, KeyboardParams } from "../interfaces";
+import CandidateBox from "./CandidateBox";
+/**
+ * Root class for simple-keyboard.
+ * This class:
+ * - Parses the options
+ * - Renders the rows and buttons
+ * - Handles button functionality
+ */
+declare class SimpleKeyboard {
+    input: KeyboardInput;
+    options: KeyboardOptions;
+    utilities: any;
+    caretPosition: number | null;
+    caretPositionEnd: number | null;
+    keyboardDOM: KeyboardElement;
+    keyboardPluginClasses: string;
+    keyboardDOMClass: string;
+    buttonElements: KeyboardButtonElements;
+    currentInstanceName: string;
+    allKeyboardInstances: {
+        [key: string]: SimpleKeyboard;
+    };
+    keyboardInstanceNames: string[];
+    isFirstKeyboardInstance: boolean;
+    physicalKeyboard: PhysicalKeyboard;
+    modules: {
+        [key: string]: any;
+    };
+    activeButtonClass: string;
+    holdInteractionTimeout: number;
+    holdTimeout: number;
+    isMouseHold: boolean;
+    initialized: boolean;
+    candidateBox: CandidateBox | null;
+    keyboardRowsDOM: KeyboardElement;
+    defaultName: string;
+    activeInputElement: HTMLInputElement | HTMLTextAreaElement | null;
+    /**
+     * Creates an instance of SimpleKeyboard
+     * @param {Array} params If first parameter is a string, it is considered the container class. The second parameter is then considered the options object. If first parameter is an object, it is considered the options object.
+     */
+    constructor(...params: KeyboardParams);
+    /**
+     * parseParams
+     */
+    handleParams: (params: KeyboardParams) => {
+        keyboardDOMClass: string;
+        keyboardDOM: KeyboardElement;
+        options: Partial<KeyboardOptions | undefined>;
+    };
+    /**
+     * Getters
+     */
+    getOptions: () => KeyboardOptions;
+    getCaretPosition: () => number | null;
+    getCaretPositionEnd: () => number | null;
+    /**
+     * Changes the internal caret position
+     * @param {number} position The caret's start position
+     * @param {number} positionEnd The caret's end position
+     */
+    setCaretPosition(position: number | null, endPosition?: number | null): void;
+    /**
+     * Retrieve the candidates for a given input
+     * @param input The input string to check
+     */
+    getInputCandidates(input: string): {
+        candidateKey: string;
+        candidateValue: string;
+    } | Record<string, never>;
+    /**
+     * Shows a suggestion box with a list of candidate words
+     * @param candidates The chosen candidates string as defined in the layoutCandidates option
+     * @param targetElement The element next to which the candidates box will be shown
+     */
+    showCandidatesBox(candidateKey: string, candidateValue: string, targetElement: KeyboardElement): void;
+    /**
+     * Handles clicks made to keyboard buttons
+     * @param  {string} button The button's layout name.
+     */
+    handleButtonClicked(button: string, e?: KeyboardHandlerEvent): void;
+    /**
+     * Handles button mousedown
+     */
+    handleButtonMouseDown(button: string, e: KeyboardHandlerEvent): void;
+    /**
+     * Handles button mouseup
+     */
+    handleButtonMouseUp(button?: string, e?: KeyboardHandlerEvent): void;
+    /**
+     * Handles container mousedown
+     */
+    handleKeyboardContainerMouseDown(e: KeyboardHandlerEvent): void;
+    /**
+     * Handles button hold
+     */
+    handleButtonHold(button: string): void;
+    /**
+     * Send a command to all simple-keyboard instances (if you have several instances).
+     */
+    syncInstanceInputs(): void;
+    /**
+     * Clear the keyboard’s input.
+     * @param {string} [inputName] optional - the internal input to select
+     */
+    clearInput(inputName?: string): void;
+    /**
+     * Get the keyboard’s input (You can also get it from the onChange prop).
+     * @param  {string} [inputName] optional - the internal input to select
+     */
+    getInput(inputName?: string, skipSync?: boolean): string;
+    /**
+     * Get all simple-keyboard inputs
+     */
+    getAllInputs(): KeyboardInput;
+    /**
+     * Set the keyboard’s input.
+     * @param  {string} input the input value
+     * @param  {string} inputName optional - the internal input to select
+     */
+    setInput(input: string, inputName?: string, skipSync?: boolean): void;
+    /**
+     * Replace the input object (`keyboard.input`)
+     * @param  {object} inputObj The input object
+     */
+    replaceInput(inputObj: KeyboardInput): void;
+    /**
+     * Set new option or modify existing ones after initialization.
+     * @param  {object} options The options to set
+     */
+    setOptions(options?: {}): void;
+    /**
+     * Detecting changes to non-function options
+     * This allows us to ascertain whether a button re-render is needed
+     */
+    changedOptions(newOptions: Partial<KeyboardOptions>): string[];
+    /**
+     * Executing actions depending on changed options
+     * @param  {object} options The options to set
+     */
+    onSetOptions(changedOptions?: string[]): void;
+    /**
+     * Remove all keyboard rows and reset keyboard values.
+     * Used internally between re-renders.
+     */
+    resetRows(): void;
+    /**
+     * Send a command to all simple-keyboard instances at once (if you have multiple instances).
+     * @param  {function(instance: object, key: string)} callback Function to run on every instance
+     */
+    dispatch(callback: (instance: SimpleKeyboard, key?: string) => void): void;
+    /**
+     * Adds/Modifies an entry to the `buttonTheme`. Basically a way to add a class to a button.
+     * @param  {string} buttons List of buttons to select (separated by a space).
+     * @param  {string} className Classes to give to the selected buttons (separated by space).
+     */
+    addButtonTheme(buttons: string, className: string): void;
+    /**
+     * Removes/Amends an entry to the `buttonTheme`. Basically a way to remove a class previously added to a button through buttonTheme or addButtonTheme.
+     * @param  {string} buttons List of buttons to select (separated by a space).
+     * @param  {string} className Classes to give to the selected buttons (separated by space).
+     */
+    removeButtonTheme(buttons: string, className: string): void;
+    /**
+     * Get the DOM Element of a button. If there are several buttons with the same name, an array of the DOM Elements is returned.
+     * @param  {string} button The button layout name to select
+     */
+    getButtonElement(button: string): KeyboardElement | KeyboardElement[] | undefined;
+    /**
+     * This handles the "inputPattern" option
+     * by checking if the provided inputPattern passes
+     */
+    inputPatternIsValid(inputVal: string): boolean;
+    /**
+     * Handles simple-keyboard event listeners
+     */
+    setEventListeners(): void;
+    /**
+     * Event Handler: KeyUp
+     */
+    handleKeyUp(event: KeyboardHandlerEvent): void;
+    /**
+     * Event Handler: KeyDown
+     */
+    handleKeyDown(event: KeyboardHandlerEvent): void;
+    /**
+     * Event Handler: MouseUp
+     */
+    handleMouseUp(event: KeyboardHandlerEvent): void;
+    /**
+     * Event Handler: TouchEnd
+     */
+    handleTouchEnd(event: KeyboardHandlerEvent): void;
+    /**
+     * Event Handler: Select
+     */
+    handleSelect(event: KeyboardHandlerEvent): void;
+    /**
+     * Event Handler: SelectionChange
+     */
+    handleSelectionChange(event: KeyboardHandlerEvent): void;
+    /**
+     * Called by {@link setEventListeners} when an event that warrants a cursor position update is triggered
+     */
+    caretEventHandler(event: KeyboardHandlerEvent): void;
+    /**
+     * Execute an operation on each button
+     */
+    recurseButtons(fn: any): void;
+    /**
+     * Destroy keyboard listeners and DOM elements
+     */
+    destroy(): void;
+    /**
+     * Process buttonTheme option
+     */
+    getButtonThemeClasses(button: string): string[];
+    /**
+     * Process buttonAttributes option
+     */
+    setDOMButtonAttributes(button: string, callback: any): void;
+    onTouchDeviceDetected(): void;
+    /**
+     * Disabling contextual window for hg-button
+     */
+    disableContextualWindow(): void;
+    /**
+     * Process autoTouchEvents option
+     */
+    processAutoTouchEvents(): void;
+    /**
+     * Executes the callback function once simple-keyboard is rendered for the first time (on initialization).
+     */
+    onInit(): void;
+    /**
+     * Executes the callback function before a simple-keyboard render.
+     */
+    beforeFirstRender(): void;
+    /**
+     * Executes the callback function before a simple-keyboard render.
+     */
+    beforeRender(): void;
+    /**
+     * Executes the callback function every time simple-keyboard is rendered (e.g: when you change layouts).
+     */
+    onRender(): void;
+    /**
+     * Executes the callback function once all modules have been loaded
+     */
+    onModulesLoaded(): void;
+    /**
+     * Register module
+     */
+    registerModule: (name: string, initCallback: any) => void;
+    /**
+     * Load modules
+     */
+    loadModules(): void;
+    /**
+     * Get module prop
+     */
+    getModuleProp(name: string, prop: string): any;
+    /**
+     * getModulesList
+     */
+    getModulesList(): string[];
+    /**
+     * Parse Row DOM containers
+     */
+    parseRowDOMContainers(rowDOM: HTMLDivElement, rowIndex: number, containerStartIndexes: number[], containerEndIndexes: number[]): HTMLDivElement;
+    /**
+     * getKeyboardClassString
+     */
+    getKeyboardClassString: (...baseDOMClasses: any[]) => string;
+    /**
+     * Renders rows and buttons as per options
+     */
+    render(): void;
+}
+export default SimpleKeyboard;

build/types/index.d.ts

@@ -0,0 +1,3 @@
+import "./polyfills";
+import SimpleKeyboard from "./components/Keyboard";
+export default SimpleKeyboard;

build/types/interfaces.d.ts

@@ -1,313 +1,216 @@
-declare module 'simple-keyboard' {
-  interface KeyboardLayoutObject {
+import SimpleKeyboard from "./components/Keyboard";
+import Utilities from "./services/Utilities";
+export interface KeyboardLayoutObject {
     [key: string]: string[];
-  }
-
-  interface KeyboardButtonTheme {
+}
+export declare type KeyboardButtonTheme = {
     class: string;
     buttons: string;
-  }
-
-  interface KeyboardButtonAttributes {
+} | null;
+export interface KeyboardButtonAttributes {
     attribute: string;
     value: string;
     buttons: string;
-  }
-
-  interface KeyboardOptions {
+}
+export interface KeyboardInput {
+    [key: string]: string;
+}
+export declare type KeyboardParams = [KeyboardOptions] | [string | HTMLDivElement, KeyboardOptions];
+export declare type CandidateBoxParams = {
+    utilities: Utilities;
+};
+export declare type CandidateBoxShowParams = {
+    candidateValue: string;
+    targetElement: KeyboardElement;
+    onSelect: (selectedCandidate: string, e: MouseEvent) => void;
+};
+export declare type CandidateBoxRenderParams = {
+    candidateListPages: string[][];
+    targetElement: KeyboardElement;
+    pageIndex: number;
+    nbPages: number;
+    onItemSelected: (selectedCandidate: string, e: MouseEvent) => void;
+};
+export declare type KeyboardElement = HTMLDivElement | HTMLButtonElement;
+export declare type KeyboardHandlerEvent = any;
+export interface KeyboardButtonElements {
+    [key: string]: KeyboardElement[];
+}
+export interface UtilitiesParams {
+    getOptions: () => KeyboardOptions;
+    getCaretPosition: () => number | null;
+    getCaretPositionEnd: () => number | null;
+    dispatch: any;
+}
+export interface PhysicalKeyboardParams {
+    getOptions: () => KeyboardOptions;
+    dispatch: any;
+}
+export interface KeyboardOptions {
     /**
      * Modify the keyboard layout.
      */
     layout?: KeyboardLayoutObject;
-
     /**
      * Specifies which layout should be used.
      */
     layoutName?: string;
-
     /**
      * Replaces variable buttons (such as `{bksp}`) with a human-friendly name (e.g.: `backspace`).
      */
-    display?: { [button: string]: string };
-
+    display?: {
+        [button: string]: string;
+    };
     /**
      * By default, when you set the display property, you replace the default one. This setting merges them instead.
      */
     mergeDisplay?: boolean;
-
     /**
      * A prop to add your own css classes to the keyboard wrapper. You can add multiple classes separated by a space.
      */
     theme?: string;
-
     /**
      * A prop to add your own css classes to one or several buttons.
      */
     buttonTheme?: KeyboardButtonTheme[];
-
     /**
      * A prop to add your own attributes to one or several buttons.
      */
     buttonAttributes?: KeyboardButtonAttributes[];
-
     /**
      * Runs a `console.log` every time a key is pressed. Displays the buttons pressed and the current input.
      */
     debug?: boolean;
-
     /**
      * Specifies whether clicking the "ENTER" button will input a newline (`\n`) or not.
      */
     newLineOnEnter?: boolean;
-
     /**
      * Specifies whether clicking the "TAB" button will input a tab character (`\t`) or not.
      */
     tabCharOnTab?: boolean;
-
     /**
      * Allows you to use a single simple-keyboard instance for several inputs.
      */
     inputName?: string;
-
     /**
      * `number`: Restrains all of simple-keyboard inputs to a certain length. This should be used in addition to the input element’s maxlengthattribute.
      *
      * `{ [inputName: string]: number }`: Restrains simple-keyboard’s individual inputs to a certain length. This should be used in addition to the input element’s maxlengthattribute.
      */
     maxLength?: any;
-
     /**
      * When set to true, this option synchronizes the internal input of every simple-keyboard instance.
      */
     syncInstanceInputs?: boolean;
-
     /**
      * Enable highlighting of keys pressed on physical keyboard.
      */
     physicalKeyboardHighlight?: boolean;
-
     /**
-     * Calling preventDefault for the mousedown events keeps the focus on the input.
+     * Calls handler for a button highlighted by physicalKeyboardHighlight
+     * In other words, this calls keyboard.handleButtonClicked(buttonName) on the highlighted button
      */
-    preventMouseDownDefault?: boolean;
-
+    physicalKeyboardHighlightPress?: boolean;
     /**
-     * Calling preventDefault for the mouseup events.
+     * Trigger click on a button's element when using physicalKeyboardHighlightPress
+     * In other words, this calls button.click() on the highlighted button
      */
-    preventMouseUpDefault?: boolean;
-    
-    /**
-     * Stops pointer down events on simple-keyboard buttons from bubbling to parent elements.
-     */
-    stopMouseDownPropagation?: boolean;
-
-    /**
-     * Stops pointer up events on simple-keyboard buttons from bubbling to parent elements.
-     */
-    stopMouseUpPropagation?: boolean;
-
+    physicalKeyboardHighlightPressUseClick?: boolean;
     /**
      * Define the text color that the physical keyboard highlighted key should have.
      */
     physicalKeyboardHighlightTextColor?: string;
-
     /**
      * Define the background color that the physical keyboard highlighted key should have.
      */
     physicalKeyboardHighlightBgColor?: string;
-
+    /**
+     * Calling preventDefault for the mousedown events keeps the focus on the input.
+     */
+    preventMouseDownDefault?: boolean;
+    /**
+     * Calling preventDefault for the mouseup events.
+     */
+    preventMouseUpDefault?: boolean;
+    /**
+     * Stops pointer down events on simple-keyboard buttons from bubbling to parent elements.
+     */
+    stopMouseDownPropagation?: boolean;
+    /**
+     * Stops pointer up events on simple-keyboard buttons from bubbling to parent elements.
+     */
+    stopMouseUpPropagation?: boolean;
     /**
      * Render buttons as a button element instead of a div element.
      */
     useButtonTag?: boolean;
-
     /**
      * A prop to ensure characters are always be added/removed at the end of the string.
      */
     disableCaretPositioning?: boolean;
-
     /**
      * Restrains input(s) change to the defined regular expression pattern.
      */
     inputPattern?: any;
-
     /**
      * Instructs simple-keyboard to use touch events instead of click events.
      */
     useTouchEvents?: boolean;
-
     /**
      * Enable useTouchEvents automatically when touch device is detected.
      */
     autoUseTouchEvents?: boolean;
-
     /**
      * Opt out of PointerEvents handling, falling back to the prior mouse event logic.
      */
     useMouseEvents?: boolean;
-
     /**
      * Disable button hold action.
      */
     disableButtonHold?: boolean;
-
     /**
      * Adds unicode right-to-left control characters to input return values.
      */
     rtl?: boolean;
-
     /**
-     * Executes the callback function on key press. Returns button layout name (i.e.: "{shift}").
+     * Enable input method editor candidate list support.
      */
-    onKeyPress?: (button: string) => any;
-
+    enableLayoutCandidates?: boolean;
     /**
-     * Executes the callback function on key release.
+     * Character suggestions to be shown on certain key presses
      */
-    onKeyReleased?: (button: string) => any;
-
+    layoutCandidates?: {
+        [key: string]: string;
+    };
     /**
-     * Executes the callback function on input change. Returns the current input's string.
+     * Exclude buttons from layout
      */
-    onChange?: (input: string) => any;
-
+    excludeFromLayout?: {
+        [key: string]: string[];
+    };
     /**
-     * Executes the callback function before the first simple-keyboard render.
+     * Determine size of layout candidate list
      */
-    beforeFirstRender?: () => void;
-
-    /**
-     * Executes the callback function before a simple-keyboard render.
-     */
-    beforeRender?: () => void;
-
+    layoutCandidatesPageSize?: number;
     /**
      * Executes the callback function every time simple-keyboard is rendered (e.g: when you change layouts).
      */
-    onRender?: () => void;
-
+    onRender?: (instance?: SimpleKeyboard) => void;
     /**
      * Executes the callback function once simple-keyboard is rendered for the first time (on initialization).
      */
-    onInit?: () => void;
-
+    onInit?: (instance?: SimpleKeyboard) => void;
     /**
-     * Executes the callback function on input change. Returns the input object with all defined inputs.
+     * Retrieves the current input
      */
-    onChangeAll?: (inputs: any) => any;
-
+    onChange?: (input: string, e?: MouseEvent) => any;
     /**
-     * Module classes to be loaded by simple-keyboard.
+     * Retrieves all inputs
      */
-    modules?: any[];
-
+    onChangeAll?: (inputObj: KeyboardInput, e?: MouseEvent) => any;
     /**
      * Module options can have any format
      */
     [name: string]: any;
-  }
-
-  class Keyboard {
-    constructor(selector: string, options: KeyboardOptions);
-    constructor(selector: HTMLDivElement, options: KeyboardOptions);
-    constructor(options: KeyboardOptions);
-
-    /**
-     * Options
-     */
-    options: KeyboardOptions;
-
-    /**
-     * Utilities
-     */
-    utilities?: any;
-
-    /**
-     * caretPosition
-     */
-    caretPosition?: number;
-
-
-    /**
-     * caretPositionEnd
-     */
-    caretPositionEnd?: number;
-
-    /**
-     * Changes the internal caret position
-     * @param {number} position The caret's start position
-     * @param {number} positionEnd The caret's end position
-     */
-    setCaretPosition(position: number, positionEnd?: number): void;
-
-    /**
-     * Retrieves the internal caret position
-     */
-    getCaretPosition(): number;
-
-    /**
-     * Retrieves the internal end caret position
-     */
-    getCaretPositionEnd(): number;
-
-    /**
-     * Adds/Modifies an entry to the `buttonTheme`. Basically a way to add a class to a button.
-     * @param  {string} buttons List of buttons to select (separated by a space).
-     * @param  {string} className Classes to give to the selected buttons (separated by space).
-     */
-    addButtonTheme(buttons: string, className: string): void;
-
-    /**
-     * Removes/Amends an entry to the `buttonTheme`. Basically a way to remove a class previously added to a button through buttonTheme or addButtonTheme.
-     * @param  {string} buttons List of buttons to select (separated by a space).
-     * @param  {string} className Classes to give to the selected buttons (separated by space).
-     */
-    removeButtonTheme(buttons: string, className: string): void;
-
-    /**
-     * Clear the keyboard's input.
-     *
-     * @param {string} [inputName] optional - the internal input to select
-     */
-    clearInput(inputName?: string): void;
-
-    /**
-     * Get the keyboard’s input (You can also get it from the onChange prop).
-     * @param  {string} [inputName] optional - the internal input to select
-     */
-    getInput(inputName?: string): string;
-
-    /**
-     * Set the keyboard’s input.
-     * @param  {string} input the input value
-     * @param  {string} inputName optional - the internal input to select
-     */
-    setInput(input: string, inputName?: string): void;
-
-    /**
-     * Set new option or modify existing ones after initialization.
-     * @param  {KeyboardOptions} option The option to set
-     */
-    setOptions(options: KeyboardOptions): void;
-
-    /**
-     * Send a command to all simple-keyboard instances at once (if you have multiple instances).
-     * @param  {function(instance: object, key: string)} callback Function to run on every instance
-     */
-    dispatch(callback: (instance: any, key: string) => void): void;
-
-    /**
-     * Get the DOM Element of a button. If there are several buttons with the same name, an array of the DOM Elements is returned.
-     * @param  {string} button The button layout name to select
-     */
-    getButtonElement(button: string): HTMLElement | HTMLElement[];
-
-    /**
-     * Clears keyboard listeners and DOM elements.
-     */
-    destroy(): void;
-  }
-
-  export default Keyboard;
 }

build/types/services/KeyboardLayout.d.ts

@@ -0,0 +1,4 @@
+export declare const getDefaultLayout: () => {
+    default: string[];
+    shift: string[];
+};

build/types/services/PhysicalKeyboard.d.ts

@@ -0,0 +1,24 @@
+import { KeyboardOptions, PhysicalKeyboardParams } from "../interfaces";
+/**
+ * Physical Keyboard Service
+ */
+declare class PhysicalKeyboard {
+    getOptions: () => KeyboardOptions;
+    dispatch: any;
+    /**
+     * Creates an instance of the PhysicalKeyboard service
+     */
+    constructor({ dispatch, getOptions }: PhysicalKeyboardParams);
+    handleHighlightKeyDown(event: KeyboardEvent): void;
+    handleHighlightKeyUp(event: KeyboardEvent): void;
+    /**
+     * Transforms a KeyboardEvent's "key.code" string into a simple-keyboard layout format
+     * @param  {object} event The KeyboardEvent
+     */
+    getSimpleKeyboardLayoutKey(event: KeyboardEvent): string;
+    /**
+     * Retrieve key from keyCode
+     */
+    keyCodeToKey(keyCode: number): string | undefined;
+}
+export default PhysicalKeyboard;

build/types/services/Utilities.d.ts

@@ -0,0 +1,193 @@
+import { KeyboardInput } from "./../interfaces";
+import { KeyboardOptions, UtilitiesParams } from "../interfaces";
+/**
+ * Utility Service
+ */
+declare class Utilities {
+    getOptions: () => KeyboardOptions;
+    getCaretPosition: () => number | null;
+    getCaretPositionEnd: () => number | null;
+    dispatch: any;
+    maxLengthReached: boolean;
+    /**
+     * Creates an instance of the Utility service
+     */
+    constructor({ getOptions, getCaretPosition, getCaretPositionEnd, dispatch, }: UtilitiesParams);
+    /**
+     * Retrieve button type
+     *
+     * @param  {string} button The button's layout name
+     * @return {string} The button type
+     */
+    getButtonType(button: string): string;
+    /**
+     * Adds default classes to a given button
+     *
+     * @param  {string} button The button's layout name
+     * @return {string} The classes to be added to the button
+     */
+    getButtonClass(button: string): string;
+    /**
+     * Default button display labels
+     */
+    getDefaultDiplay(): {
+        "{bksp}": string;
+        "{backspace}": string;
+        "{enter}": string;
+        "{shift}": string;
+        "{shiftleft}": string;
+        "{shiftright}": string;
+        "{alt}": string;
+        "{s}": string;
+        "{tab}": string;
+        "{lock}": string;
+        "{capslock}": string;
+        "{accept}": string;
+        "{space}": string;
+        "{//}": string;
+        "{esc}": string;
+        "{escape}": string;
+        "{f1}": string;
+        "{f2}": string;
+        "{f3}": string;
+        "{f4}": string;
+        "{f5}": string;
+        "{f6}": string;
+        "{f7}": string;
+        "{f8}": string;
+        "{f9}": string;
+        "{f10}": string;
+        "{f11}": string;
+        "{f12}": string;
+        "{numpaddivide}": string;
+        "{numlock}": string;
+        "{arrowup}": string;
+        "{arrowleft}": string;
+        "{arrowdown}": string;
+        "{arrowright}": string;
+        "{prtscr}": string;
+        "{scrolllock}": string;
+        "{pause}": string;
+        "{insert}": string;
+        "{home}": string;
+        "{pageup}": string;
+        "{delete}": string;
+        "{forwarddelete}": string;
+        "{end}": string;
+        "{pagedown}": string;
+        "{numpadmultiply}": string;
+        "{numpadsubtract}": string;
+        "{numpadadd}": string;
+        "{numpadenter}": string;
+        "{period}": string;
+        "{numpaddecimal}": string;
+        "{numpad0}": string;
+        "{numpad1}": string;
+        "{numpad2}": string;
+        "{numpad3}": string;
+        "{numpad4}": string;
+        "{numpad5}": string;
+        "{numpad6}": string;
+        "{numpad7}": string;
+        "{numpad8}": string;
+        "{numpad9}": string;
+    };
+    /**
+     * Returns the display (label) name for a given button
+     *
+     * @param  {string} button The button's layout name
+     * @param  {object} display The provided display option
+     * @param  {boolean} mergeDisplay Whether the provided param value should be merged with the default one.
+     */
+    getButtonDisplayName(button: string, display: KeyboardOptions["display"], mergeDisplay: boolean): string;
+    /**
+     * Returns the updated input resulting from clicking a given button
+     *
+     * @param  {string} button The button's layout name
+     * @param  {string} input The input string
+     * @param  {number} caretPos The cursor's current position
+     * @param  {number} caretPosEnd The cursor's current end position
+     * @param  {boolean} moveCaret Whether to update simple-keyboard's cursor
+     */
+    getUpdatedInput(button: string, input: string, caretPos: number, caretPosEnd?: number, moveCaret?: boolean): string;
+    /**
+     * Moves the cursor position by a given amount
+     *
+     * @param  {number} length Represents by how many characters the input should be moved
+     * @param  {boolean} minus Whether the cursor should be moved to the left or not.
+     */
+    updateCaretPos(length: number, minus?: boolean): void;
+    /**
+     * Action method of updateCaretPos
+     *
+     * @param  {number} length Represents by how many characters the input should be moved
+     * @param  {boolean} minus Whether the cursor should be moved to the left or not.
+     */
+    updateCaretPosAction(length: number, minus?: boolean): number | null;
+    /**
+     * Adds a string to the input at a given position
+     *
+     * @param  {string} source The source input
+     * @param  {string} str The string to add
+     * @param  {number} position The (cursor) position where the string should be added
+     * @param  {boolean} moveCaret Whether to update simple-keyboard's cursor
+     */
+    addStringAt(source: string, str: string, position?: number, positionEnd?: number, moveCaret?: boolean): string;
+    /**
+     * Check whether the button is a standard button
+     */
+    isStandardButton: (button: string) => boolean | "";
+    /**
+     * Removes an amount of characters before a given position
+     *
+     * @param  {string} source The source input
+     * @param  {number} position The (cursor) position from where the characters should be removed
+     * @param  {boolean} moveCaret Whether to update simple-keyboard's cursor
+     */
+    removeAt(source: string, position?: number, positionEnd?: number, moveCaret?: boolean): string;
+    /**
+     * Removes an amount of characters after a given position
+     *
+     * @param  {string} source The source input
+     * @param  {number} position The (cursor) position from where the characters should be removed
+     */
+    removeForwardsAt(source: string, position?: number, positionEnd?: number, moveCaret?: boolean): string;
+    /**
+     * Determines whether the maxLength has been reached. This function is called when the maxLength option it set.
+     *
+     * @param  {object} inputObj
+     * @param  {string} updatedInput
+     */
+    handleMaxLength(inputObj: KeyboardInput, updatedInput: string): boolean | undefined;
+    /**
+     * Gets the current value of maxLengthReached
+     */
+    isMaxLengthReached(): boolean;
+    /**
+     * Determines whether a touch device is being used
+     */
+    isTouchDevice(): number | true;
+    /**
+     * Determines whether pointer events are supported
+     */
+    pointerEventsSupported(): boolean;
+    /**
+     * Bind all methods in a given class
+     */
+    static bindMethods(myClass: any, instance: any): void;
+    /**
+     * Transforms an arbitrary string to camelCase
+     *
+     * @param  {string} str The string to transform.
+     */
+    camelCase(str: string): string;
+    /**
+     * Split array into chunks
+     */
+    chunkArray<T>(arr: T[], size: number): T[][];
+    /**
+     * Reusable empty function
+     */
+    static noop: () => void;
+}
+export default Utilities;

config/env.js

@@ -1,101 +0,0 @@
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const paths = require('./paths');
-
-// Make sure that including paths.js after env.js will read .env variables.
-delete require.cache[require.resolve('./paths')];
-
-const NODE_ENV = process.env.NODE_ENV;
-if (!NODE_ENV) {
-  throw new Error(
-    'The NODE_ENV environment variable is required but was not specified.'
-  );
-}
-
-// https://github.com/bkeepers/dotenv#what-other-env-files-can-i-use
-const dotenvFiles = [
-  `${paths.dotenv}.${NODE_ENV}.local`,
-  `${paths.dotenv}.${NODE_ENV}`,
-  // Don't include `.env.local` for `test` environment
-  // since normally you expect tests to produce the same
-  // results for everyone
-  NODE_ENV !== 'test' && `${paths.dotenv}.local`,
-  paths.dotenv,
-].filter(Boolean);
-
-// Load environment variables from .env* files. Suppress warnings using silent
-// if this file is missing. dotenv will never modify any environment variables
-// that have already been set.  Variable expansion is supported in .env files.
-// https://github.com/motdotla/dotenv
-// https://github.com/motdotla/dotenv-expand
-dotenvFiles.forEach(dotenvFile => {
-  if (fs.existsSync(dotenvFile)) {
-    require('dotenv-expand')(
-      require('dotenv').config({
-        path: dotenvFile,
-      })
-    );
-  }
-});
-
-// We support resolving modules according to `NODE_PATH`.
-// This lets you use absolute paths in imports inside large monorepos:
-// https://github.com/facebook/create-react-app/issues/253.
-// It works similar to `NODE_PATH` in Node itself:
-// https://nodejs.org/api/modules.html#modules_loading_from_the_global_folders
-// Note that unlike in Node, only *relative* paths from `NODE_PATH` are honored.
-// Otherwise, we risk importing Node.js core modules into an app instead of webpack shims.
-// https://github.com/facebook/create-react-app/issues/1023#issuecomment-265344421
-// We also resolve them to make sure all tools using them work consistently.
-const appDirectory = fs.realpathSync(process.cwd());
-process.env.NODE_PATH = (process.env.NODE_PATH || '')
-  .split(path.delimiter)
-  .filter(folder => folder && !path.isAbsolute(folder))
-  .map(folder => path.resolve(appDirectory, folder))
-  .join(path.delimiter);
-
-// Grab NODE_ENV and REACT_APP_* environment variables and prepare them to be
-// injected into the application via DefinePlugin in webpack configuration.
-const REACT_APP = /^REACT_APP_/i;
-
-function getClientEnvironment(publicUrl) {
-  const raw = Object.keys(process.env)
-    .filter(key => REACT_APP.test(key))
-    .reduce(
-      (env, key) => {
-        env[key] = process.env[key];
-        return env;
-      },
-      {
-        // Useful for determining whether we’re running in production mode.
-        // Most importantly, it switches React into the correct mode.
-        NODE_ENV: process.env.NODE_ENV || 'development',
-        // Useful for resolving the correct path to static assets in `public`.
-        // For example, <img src={process.env.PUBLIC_URL + '/img/logo.png'} />.
-        // This should only be used as an escape hatch. Normally you would put
-        // images into the `src` and `import` them in code to get their paths.
-        PUBLIC_URL: publicUrl,
-        // We support configuring the sockjs pathname during development.
-        // These settings let a developer run multiple simultaneous projects.
-        // They are used as the connection `hostname`, `pathname` and `port`
-        // in webpackHotDevClient. They are used as the `sockHost`, `sockPath`
-        // and `sockPort` options in webpack-dev-server.
-        WDS_SOCKET_HOST: process.env.WDS_SOCKET_HOST,
-        WDS_SOCKET_PATH: process.env.WDS_SOCKET_PATH,
-        WDS_SOCKET_PORT: process.env.WDS_SOCKET_PORT,
-      }
-    );
-  // Stringify all values so we can feed into webpack DefinePlugin
-  const stringified = {
-    'process.env': Object.keys(raw).reduce((env, key) => {
-      env[key] = JSON.stringify(raw[key]);
-      return env;
-    }, {}),
-  };
-
-  return { raw, stringified };
-}
-
-module.exports = getClientEnvironment;

config/getHttpsConfig.js

@@ -1,66 +0,0 @@
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const crypto = require('crypto');
-const chalk = require('react-dev-utils/chalk');
-const paths = require('./paths');
-
-// Ensure the certificate and key provided are valid and if not
-// throw an easy to debug error
-function validateKeyAndCerts({ cert, key, keyFile, crtFile }) {
-  let encrypted;
-  try {
-    // publicEncrypt will throw an error with an invalid cert
-    encrypted = crypto.publicEncrypt(cert, Buffer.from('test'));
-  } catch (err) {
-    throw new Error(
-      `The certificate "${chalk.yellow(crtFile)}" is invalid.\n${err.message}`
-    );
-  }
-
-  try {
-    // privateDecrypt will throw an error with an invalid key
-    crypto.privateDecrypt(key, encrypted);
-  } catch (err) {
-    throw new Error(
-      `The certificate key "${chalk.yellow(keyFile)}" is invalid.\n${
-        err.message
-      }`
-    );
-  }
-}
-
-// Read file and throw an error if it doesn't exist
-function readEnvFile(file, type) {
-  if (!fs.existsSync(file)) {
-    throw new Error(
-      `You specified ${chalk.cyan(
-        type
-      )} in your env, but the file "${chalk.yellow(file)}" can't be found.`
-    );
-  }
-  return fs.readFileSync(file);
-}
-
-// Get the https config
-// Return cert files if provided in env, otherwise just true or false
-function getHttpsConfig() {
-  const { SSL_CRT_FILE, SSL_KEY_FILE, HTTPS } = process.env;
-  const isHttps = HTTPS === 'true';
-
-  if (isHttps && SSL_CRT_FILE && SSL_KEY_FILE) {
-    const crtFile = path.resolve(paths.appPath, SSL_CRT_FILE);
-    const keyFile = path.resolve(paths.appPath, SSL_KEY_FILE);
-    const config = {
-      cert: readEnvFile(crtFile, 'SSL_CRT_FILE'),
-      key: readEnvFile(keyFile, 'SSL_KEY_FILE'),
-    };
-
-    validateKeyAndCerts({ ...config, keyFile, crtFile });
-    return config;
-  }
-  return isHttps;
-}
-
-module.exports = getHttpsConfig;

config/jest/cssTransform.js

@@ -1,14 +0,0 @@
-'use strict';
-
-// This is a custom Jest transformer turning style imports into empty objects.
-// http://facebook.github.io/jest/docs/en/webpack.html
-
-module.exports = {
-  process() {
-    return 'module.exports = {};';
-  },
-  getCacheKey() {
-    // The output is always the same.
-    return 'cssTransform';
-  },
-};

config/jest/fileTransform.js

@@ -1,40 +0,0 @@
-'use strict';
-
-const path = require('path');
-const camelcase = require('camelcase');
-
-// This is a custom Jest transformer turning file imports into filenames.
-// http://facebook.github.io/jest/docs/en/webpack.html
-
-module.exports = {
-  process(src, filename) {
-    const assetFilename = JSON.stringify(path.basename(filename));
-
-    if (filename.match(/\.svg$/)) {
-      // Based on how SVGR generates a component name:
-      // https://github.com/smooth-code/svgr/blob/01b194cf967347d43d4cbe6b434404731b87cf27/packages/core/src/state.js#L6
-      const pascalCaseFilename = camelcase(path.parse(filename).name, {
-        pascalCase: true,
-      });
-      const componentName = `Svg${pascalCaseFilename}`;
-      return `const React = require('react');
-      module.exports = {
-        __esModule: true,
-        default: ${assetFilename},
-        ReactComponent: React.forwardRef(function ${componentName}(props, ref) {
-          return {
-            $$typeof: Symbol.for('react.element'),
-            type: 'svg',
-            ref: ref,
-            key: null,
-            props: Object.assign({}, props, {
-              children: ${assetFilename}
-            })
-          };
-        }),
-      };`;
-    }
-
-    return `module.exports = ${assetFilename};`;
-  },
-};

config/modules.js

@@ -1,141 +0,0 @@
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const paths = require('./paths');
-const chalk = require('react-dev-utils/chalk');
-const resolve = require('resolve');
-
-/**
- * Get additional module paths based on the baseUrl of a compilerOptions object.
- *
- * @param {Object} options
- */
-function getAdditionalModulePaths(options = {}) {
-  const baseUrl = options.baseUrl;
-
-  // We need to explicitly check for null and undefined (and not a falsy value) because
-  // TypeScript treats an empty string as `.`.
-  if (baseUrl == null) {
-    // If there's no baseUrl set we respect NODE_PATH
-    // Note that NODE_PATH is deprecated and will be removed
-    // in the next major release of create-react-app.
-
-    const nodePath = process.env.NODE_PATH || '';
-    return nodePath.split(path.delimiter).filter(Boolean);
-  }
-
-  const baseUrlResolved = path.resolve(paths.appPath, baseUrl);
-
-  // We don't need to do anything if `baseUrl` is set to `node_modules`. This is
-  // the default behavior.
-  if (path.relative(paths.appNodeModules, baseUrlResolved) === '') {
-    return null;
-  }
-
-  // Allow the user set the `baseUrl` to `appSrc`.
-  if (path.relative(paths.appSrc, baseUrlResolved) === '') {
-    return [paths.appSrc];
-  }
-
-  // If the path is equal to the root directory we ignore it here.
-  // We don't want to allow importing from the root directly as source files are
-  // not transpiled outside of `src`. We do allow importing them with the
-  // absolute path (e.g. `src/Components/Button.js`) but we set that up with
-  // an alias.
-  if (path.relative(paths.appPath, baseUrlResolved) === '') {
-    return null;
-  }
-
-  // Otherwise, throw an error.
-  throw new Error(
-    chalk.red.bold(
-      "Your project's `baseUrl` can only be set to `src` or `node_modules`." +
-        ' Create React App does not support other values at this time.'
-    )
-  );
-}
-
-/**
- * Get webpack aliases based on the baseUrl of a compilerOptions object.
- *
- * @param {*} options
- */
-function getWebpackAliases(options = {}) {
-  const baseUrl = options.baseUrl;
-
-  if (!baseUrl) {
-    return {};
-  }
-
-  const baseUrlResolved = path.resolve(paths.appPath, baseUrl);
-
-  if (path.relative(paths.appPath, baseUrlResolved) === '') {
-    return {
-      src: paths.appSrc,
-    };
-  }
-}
-
-/**
- * Get jest aliases based on the baseUrl of a compilerOptions object.
- *
- * @param {*} options
- */
-function getJestAliases(options = {}) {
-  const baseUrl = options.baseUrl;
-
-  if (!baseUrl) {
-    return {};
-  }
-
-  const baseUrlResolved = path.resolve(paths.appPath, baseUrl);
-
-  if (path.relative(paths.appPath, baseUrlResolved) === '') {
-    return {
-      '^src/(.*)$': '<rootDir>/src/$1',
-    };
-  }
-}
-
-function getModules() {
-  // Check if TypeScript is setup
-  const hasTsConfig = fs.existsSync(paths.appTsConfig);
-  const hasJsConfig = fs.existsSync(paths.appJsConfig);
-
-  if (hasTsConfig && hasJsConfig) {
-    throw new Error(
-      'You have both a tsconfig.json and a jsconfig.json. If you are using TypeScript please remove your jsconfig.json file.'
-    );
-  }
-
-  let config;
-
-  // If there's a tsconfig.json we assume it's a
-  // TypeScript project and set up the config
-  // based on tsconfig.json
-  if (hasTsConfig) {
-    const ts = require(resolve.sync('typescript', {
-      basedir: paths.appNodeModules,
-    }));
-    config = ts.readConfigFile(paths.appTsConfig, ts.sys.readFile).config;
-    // Otherwise we'll check if there is jsconfig.json
-    // for non TS projects.
-  } else if (hasJsConfig) {
-    config = require(paths.appJsConfig);
-  }
-
-  config = config || {};
-  const options = config.compilerOptions || {};
-
-  const additionalModulePaths = getAdditionalModulePaths(options);
-
-  return {
-    additionalModulePaths: additionalModulePaths,
-    webpackAliases: getWebpackAliases(options),
-    jestAliases: getJestAliases(options),
-    hasTsConfig,
-  };
-}
-
-module.exports = getModules();

config/paths.js

@@ -1,73 +0,0 @@
-
-
-const path = require('path');
-const fs = require('fs');
-const getPublicUrlOrPath = require('react-dev-utils/getPublicUrlOrPath');
-
-// Make sure any symlinks in the project folder are resolved:
-// https://github.com/facebook/create-react-app/issues/637
-const appDirectory = fs.realpathSync(process.cwd());
-const resolveApp = relativePath => path.resolve(appDirectory, relativePath);
-
-
-// We use `PUBLIC_URL` environment variable or "homepage" field to infer
-// "public path" at which the app is served.
-// webpack needs to know it to put the right <script> hrefs into HTML even in
-// single-page apps that may serve index.html for nested URLs like /todos/42.
-// We can't use a relative path in HTML because we don't want to load something
-// like /todos/42/static/js/bundle.7289d.js. We have to know the root.
-const publicUrlOrPath = '/';
-
-const moduleFileExtensions = [
-  'web.mjs',
-  'mjs',
-  'web.js',
-  'js',
-  'web.ts',
-  'ts',
-  'web.tsx',
-  'tsx',
-  'json',
-  'web.jsx',
-  'jsx',
-];
-
-// Resolve file paths in the same order as webpack
-const resolveModule = (resolveFn, filePath) => {
-  const extension = moduleFileExtensions.find(extension =>
-    fs.existsSync(resolveFn(`${filePath}.${extension}`))
-  );
-
-  if (extension) {
-    return resolveFn(`${filePath}.${extension}`);
-  }
-
-  return resolveFn(`${filePath}.js`);
-};
-
-// config after eject: we're in ./config/
-module.exports = {
-  dotenv: resolveApp('.env'),
-  appPath: resolveApp('.'),
-  appBuild: resolveApp('build'),
-  appDemo: resolveApp('demo'),
-  appPublic: resolveApp('public'),
-  appHtml: resolveApp('public/index.html'),
-  appIndexJs: resolveModule(resolveApp, 'src/demo/index'),
-  appLibIndexJs: resolveModule(resolveApp, 'src/lib/index'),
-  appDemoIndexJs: resolveModule(resolveApp, 'src/demo/index'),
-  appPackageJson: resolveApp('package.json'),
-  appSrc: resolveApp('src'),
-  appSrcLib: resolveApp('src/lib'),
-  appSrcLibTypes: resolveApp('src/lib/@types'),
-  appSrcDemo: resolveApp('src/demo'),
-  appTsConfig: resolveApp('tsconfig.json'),
-  appJsConfig: resolveApp('jsconfig.json'),
-  yarnLockFile: resolveApp('yarn.lock'),
-  testsSetup: resolveModule(resolveApp, 'src/setupTests'),
-  proxySetup: resolveApp('src/setupProxy.js'),
-  appNodeModules: resolveApp('node_modules'),
-  publicUrlOrPath
-};
-
-module.exports.moduleFileExtensions = moduleFileExtensions;

config/pnpTs.js

@@ -1,35 +0,0 @@
-'use strict';
-
-const { resolveModuleName } = require('ts-pnp');
-
-exports.resolveModuleName = (
-  typescript,
-  moduleName,
-  containingFile,
-  compilerOptions,
-  resolutionHost
-) => {
-  return resolveModuleName(
-    moduleName,
-    containingFile,
-    compilerOptions,
-    resolutionHost,
-    typescript.resolveModuleName
-  );
-};
-
-exports.resolveTypeReferenceDirective = (
-  typescript,
-  moduleName,
-  containingFile,
-  compilerOptions,
-  resolutionHost
-) => {
-  return resolveModuleName(
-    moduleName,
-    containingFile,
-    compilerOptions,
-    resolutionHost,
-    typescript.resolveTypeReferenceDirective
-  );
-};

config/webpack.config.demo.js

@@ -1,674 +0,0 @@
-const fs = require('fs');
-const path = require('path');
-const webpack = require('webpack');
-const resolve = require('resolve');
-const PnpWebpackPlugin = require('pnp-webpack-plugin');
-const HtmlWebpackPlugin = require('html-webpack-plugin');
-const CaseSensitivePathsPlugin = require('case-sensitive-paths-webpack-plugin');
-const InlineChunkHtmlPlugin = require('react-dev-utils/InlineChunkHtmlPlugin');
-const TerserPlugin = require('terser-webpack-plugin');
-const MiniCssExtractPlugin = require('mini-css-extract-plugin');
-const OptimizeCSSAssetsPlugin = require('optimize-css-assets-webpack-plugin');
-const safePostCssParser = require('postcss-safe-parser');
-const ManifestPlugin = require('webpack-manifest-plugin');
-const InterpolateHtmlPlugin = require('react-dev-utils/InterpolateHtmlPlugin');
-const WorkboxWebpackPlugin = require('workbox-webpack-plugin');
-const WatchMissingNodeModulesPlugin = require('react-dev-utils/WatchMissingNodeModulesPlugin');
-const ModuleScopePlugin = require('react-dev-utils/ModuleScopePlugin');
-const getCSSModuleLocalIdent = require('react-dev-utils/getCSSModuleLocalIdent');
-const paths = require('./paths');
-const modules = require('./modules');
-const getClientEnvironment = require('./env');
-const ModuleNotFoundPlugin = require('react-dev-utils/ModuleNotFoundPlugin');
-const ForkTsCheckerWebpackPlugin = require('react-dev-utils/ForkTsCheckerWebpackPlugin');
-const typescriptFormatter = require('react-dev-utils/typescriptFormatter');
-const getPackageJson = require('./getPackageJson');
-const eslint = require('eslint');
-
-const postcssNormalize = require('postcss-normalize');
-
-const appPackageJson = require(paths.appPackageJson);
-
-// Source maps are resource heavy and can cause out of memory issue for large source files.
-const shouldUseSourceMap = process.env.GENERATE_SOURCEMAP !== 'false';
-// Some apps do not need the benefits of saving a web request, so not inlining the chunk
-// makes for a smoother build process.
-const shouldInlineRuntimeChunk = process.env.INLINE_RUNTIME_CHUNK !== 'false';
-
-const isExtendingEslintConfig = process.env.EXTEND_ESLINT === 'true';
-
-const imageInlineSizeLimit = parseInt(
-  process.env.IMAGE_INLINE_SIZE_LIMIT || '10000'
-);
-
-// Check if TypeScript is setup
-const useTypeScript = fs.existsSync(paths.appTsConfig);
-
-// style files regexes
-const cssRegex = /\.css$/;
-const cssModuleRegex = /\.module\.css$/;
-const sassRegex = /\.(scss|sass)$/;
-const sassModuleRegex = /\.module\.(scss|sass)$/;
-
-// This is the production and development configuration.
-// It is focused on developer experience, fast rebuilds, and a minimal bundle.
-module.exports = function(webpackEnv) {
-  const isEnvDevelopment = webpackEnv === 'development';
-  const isEnvProduction = webpackEnv === 'production';
-
-  // Variable used for enabling profiling in Production
-  // passed into alias object. Uses a flag if passed into the build command
-  const isEnvProductionProfile =
-    isEnvProduction && process.argv.includes('--profile');
-
-  // We will provide `paths.publicUrlOrPath` to our app
-  // as %PUBLIC_URL% in `index.html` and `process.env.PUBLIC_URL` in JavaScript.
-  // Omit trailing slash as %PUBLIC_URL%/xyz looks better than %PUBLIC_URL%xyz.
-  // Get environment variables to inject into our app.
-  const env = getClientEnvironment(paths.publicUrlOrPath.slice(0, -1));
-
-  // common function to get style loaders
-  const getStyleLoaders = (cssOptions, preProcessor) => {
-    const loaders = [
-      isEnvDevelopment && require.resolve('style-loader'),
-      isEnvProduction && {
-        loader: MiniCssExtractPlugin.loader,
-        // css is located in `static/css`, use '../../' to locate index.html folder
-        // in production `paths.publicUrlOrPath` can be a relative path
-        options: paths.publicUrlOrPath.startsWith('.')
-          ? { publicPath: '../../' }
-          : {},
-      },
-      {
-        loader: require.resolve('css-loader'),
-        options: cssOptions,
-      },
-      {
-        // Options for PostCSS as we reference these options twice
-        // Adds vendor prefixing based on your specified browser support in
-        // package.json
-        loader: require.resolve('postcss-loader'),
-        options: {
-          // Necessary for external CSS imports to work
-          // https://github.com/facebook/create-react-app/issues/2677
-          ident: 'postcss',
-          plugins: () => [
-            require('postcss-flexbugs-fixes'),
-            require('postcss-preset-env')({
-              autoprefixer: {
-                flexbox: 'no-2009',
-              },
-              stage: 3,
-            }),
-            // Adds PostCSS Normalize as the reset css with default options,
-            // so that it honors browserslist config in package.json
-            // which in turn let's users customize the target behavior as per their needs.
-            postcssNormalize(),
-          ],
-          sourceMap: isEnvProduction && shouldUseSourceMap,
-        },
-      },
-    ].filter(Boolean);
-    if (preProcessor) {
-      loaders.push(
-        {
-          loader: require.resolve('resolve-url-loader'),
-          options: {
-            sourceMap: isEnvProduction && shouldUseSourceMap,
-          },
-        },
-        {
-          loader: require.resolve(preProcessor),
-          options: {
-            sourceMap: true,
-          },
-        }
-      );
-    }
-    return loaders;
-  };
-
-  return {
-    mode: 'production',
-    // Stop compilation early in production
-    bail: isEnvProduction,
-    devtool: isEnvProduction
-      ? shouldUseSourceMap
-        ? 'source-map'
-        : false
-      : isEnvDevelopment && 'cheap-module-source-map',
-    // These are the "entry points" to our application.
-    // This means they will be the "root" imports that are included in JS bundle.
-    entry: isEnvProduction ? [paths.appDemoIndexJs] : [
-      // Include an alternative client for WebpackDevServer. A client's job is to
-      // connect to WebpackDevServer by a socket and get notified about changes.
-      // When you save a file, the client will either apply hot updates (in case
-      // of CSS changes), or refresh the page (in case of JS changes). When you
-      // make a syntax error, this client will display a syntax error overlay.
-      // Note: instead of the default WebpackDevServer client, we use a custom one
-      // to bring better experience for Create React App users. You can replace
-      // the line below with these two lines if you prefer the stock client:
-      // require.resolve('webpack-dev-server/client') + '?/',
-      // require.resolve('webpack/hot/dev-server'),
-      isEnvDevelopment &&
-        require.resolve('react-dev-utils/webpackHotDevClient'),
-      // Finally, this is your app's code:
-      paths.appDemoIndexJs,
-      // We include the app code last so that if there is a runtime error during
-      // initialization, it doesn't blow up the WebpackDevServer client, and
-      // changing JS code would still trigger a refresh.
-    ].filter(Boolean),
-    output: {
-      // The build folder.
-      path: isEnvProduction ? paths.appDemo : undefined,
-      // Add /* filename */ comments to generated require()s in the output.
-      pathinfo: isEnvDevelopment,
-      // There will be one main bundle, and one file per asynchronous chunk.
-      // In development, it does not produce real files.
-      filename: 'index.js',
-      // TODO: remove this when upgrading to webpack 5
-      futureEmitAssets: true,
-      // There are also additional JS chunk files if you use code splitting.
-      chunkFilename: isEnvProduction
-        ? 'static/js/[name].[contenthash:8].chunk.js'
-        : isEnvDevelopment && 'static/js/[name].chunk.js',
-      // webpack uses `publicPath` to determine where the app is being served from.
-      // It requires a trailing slash, or the file assets will get an incorrect path.
-      // We inferred the "public path" (such as / or /my-project) from homepage.
-      publicPath: paths.publicUrlOrPath,
-      // Point sourcemap entries to original disk location (format as URL on Windows)
-      devtoolModuleFilenameTemplate: isEnvProduction
-        ? info =>
-            path
-              .relative(paths.appSrcDemo, info.absoluteResourcePath)
-              .replace(/\\/g, '/')
-        : isEnvDevelopment &&
-          (info => path.resolve(info.absoluteResourcePath).replace(/\\/g, '/')),
-      // Prevents conflicts when multiple webpack runtimes (from different apps)
-      // are used on the same page.
-      jsonpFunction: `webpackJsonp${appPackageJson.name}`,
-      // this defaults to 'window', but by setting it to 'this' then
-      // module chunks which are built will work in web workers as well.
-      globalObject: 'this',
-    },
-    optimization: {
-      minimize: isEnvProduction,
-      minimizer: [
-        // This is only used in production mode
-        new TerserPlugin({
-          terserOptions: {
-            parse: {
-              // We want terser to parse ecma 8 code. However, we don't want it
-              // to apply any minification steps that turns valid ecma 5 code
-              // into invalid ecma 5 code. This is why the 'compress' and 'output'
-              // sections only apply transformations that are ecma 5 safe
-              // https://github.com/facebook/create-react-app/pull/4234
-              ecma: 8,
-            },
-            compress: {
-              ecma: 5,
-              warnings: false,
-              // Disabled because of an issue with Uglify breaking seemingly valid code:
-              // https://github.com/facebook/create-react-app/issues/2376
-              // Pending further investigation:
-              // https://github.com/mishoo/UglifyJS2/issues/2011
-              comparisons: false,
-              // Disabled because of an issue with Terser breaking valid code:
-              // https://github.com/facebook/create-react-app/issues/5250
-              // Pending further investigation:
-              // https://github.com/terser-js/terser/issues/120
-              inline: 2,
-            },
-            mangle: {
-              safari10: true,
-              keep_classnames: true,
-              keep_fnames: true,
-              module: true
-            },
-            output: {
-              ecma: 5,
-              comments: false,
-              // Turned on because emoji and regex is not minified properly using default
-              // https://github.com/facebook/create-react-app/issues/2488
-              ascii_only: true,
-            },
-          },
-          cache: true,
-          sourceMap: shouldUseSourceMap,
-        }),
-        new OptimizeCSSAssetsPlugin({
-          cssProcessorOptions: {
-            parser: safePostCssParser,
-            map: shouldUseSourceMap
-              ? {
-                  // `inline: false` forces the sourcemap to be output into a
-                  // separate file
-                  inline: false,
-                  // `annotation: true` appends the sourceMappingURL to the end of
-                  // the css file, helping the browser find the sourcemap
-                  annotation: true,
-                }
-              : false,
-          },
-          cssProcessorPluginOptions: {
-            preset: ['default', { minifyFontValues: { removeQuotes: false } }],
-          },
-        }),
-      ],
-      // Automatically split vendor and commons
-      // https://twitter.com/wSokra/status/969633336732905474
-      // https://medium.com/webpack/webpack-4-code-splitting-chunk-graph-and-the-splitchunks-optimization-be739a861366
-      splitChunks: {
-        cacheGroups: {
-          default: false,
-        }
-      },
-      // Keep the runtime chunk separated to enable long term caching
-      // https://twitter.com/wSokra/status/969679223278505985
-      // https://github.com/facebook/create-react-app/issues/5358
-      runtimeChunk: false,
-    },
-    resolve: {
-      // This allows you to set a fallback for where webpack should look for modules.
-      // We placed these paths second because we want `node_modules` to "win"
-      // if there are any conflicts. This matches Node resolution mechanism.
-      // https://github.com/facebook/create-react-app/issues/253
-      modules: ['node_modules', paths.appNodeModules].concat(
-        modules.additionalModulePaths || []
-      ),
-      // These are the reasonable defaults supported by the Node ecosystem.
-      // We also include JSX as a common component filename extension to support
-      // some tools, although we do not recommend using it, see:
-      // https://github.com/facebook/create-react-app/issues/290
-      // `web` extension prefixes have been added for better support
-      // for React Native Web.
-      extensions: paths.moduleFileExtensions
-        .map(ext => `.${ext}`)
-        .filter(ext => useTypeScript || !ext.includes('ts')),
-      alias: {
-        // Support React Native Web
-        // https://www.smashingmagazine.com/2016/08/a-glimpse-into-the-future-with-react-native-for-web/
-        'react-native': 'react-native-web',
-        // Allows for better profiling with ReactDevTools
-        ...(isEnvProductionProfile && {
-          'react-dom$': 'react-dom/profiling',
-          'scheduler/tracing': 'scheduler/tracing-profiling',
-        }),
-        ...(modules.webpackAliases || {}),
-      },
-      plugins: [
-        // Adds support for installing with Plug'n'Play, leading to faster installs and adding
-        // guards against forgotten dependencies and such.
-        PnpWebpackPlugin,
-        // Prevents users from importing files from outside of src/ (or node_modules/).
-        // This often causes confusion because we only process files within src/ with babel.
-        // To fix this, we prevent you from importing files out of src/ -- if you'd like to,
-        // please link the files into your node_modules/ and let module-resolution kick in.
-        // Make sure your source files are compiled, as they will not be processed in any way.
-        new ModuleScopePlugin(paths.appSrc, [paths.appPackageJson]),
-      ],
-    },
-    resolveLoader: {
-      plugins: [
-        // Also related to Plug'n'Play, but this time it tells webpack to load its loaders
-        // from the current package.
-        PnpWebpackPlugin.moduleLoader(module),
-      ],
-    },
-    module: {
-      strictExportPresence: true,
-      rules: [
-        // Disable require.ensure as it's not a standard language feature.
-        { parser: { requireEnsure: false } },
-
-        // First, run the linter.
-        // It's important to do this before Babel processes the JS.
-        {
-          test: /\.(js|mjs|jsx|ts|tsx)$/,
-          enforce: 'pre',
-          use: [
-            {
-              options: {
-                cache: true,
-                formatter: require.resolve('react-dev-utils/eslintFormatter'),
-                eslintPath: require.resolve('eslint'),
-                resolvePluginsRelativeTo: __dirname,
-                
-              },
-              loader: require.resolve('eslint-loader'),
-            },
-          ],
-          include: paths.appSrcDemo,
-        },
-        {
-          // "oneOf" will traverse all following loaders until one will
-          // match the requirements. When no loader matches it will fall
-          // back to the "file" loader at the end of the loader list.
-          oneOf: [
-            // "url" loader works like "file" loader except that it embeds assets
-            // smaller than specified limit in bytes as data URLs to avoid requests.
-            // A missing `test` is equivalent to a match.
-            {
-              test: [/\.bmp$/, /\.gif$/, /\.jpe?g$/, /\.png$/],
-              loader: require.resolve('url-loader'),
-              options: {
-                limit: imageInlineSizeLimit,
-                name: 'static/media/[name].[hash:8].[ext]',
-              },
-            },
-            // Process application JS with Babel.
-            // The preset includes JSX, Flow, TypeScript, and some ESnext features.
-            {
-              test: /\.(js|mjs|jsx|ts|tsx)$/,
-              include: paths.appSrcDemo,
-              loader: require.resolve('babel-loader'),
-              options: {
-                customize: require.resolve(
-                  'babel-preset-react-app/webpack-overrides'
-                ),
-                
-                plugins: [
-                  [
-                    require.resolve('babel-plugin-named-asset-import'),
-                    {
-                      loaderMap: {
-                        svg: {
-                          ReactComponent:
-                            '@svgr/webpack?-svgo,+titleProp,+ref![path]',
-                        },
-                      },
-                    },
-                  ],
-                ],
-                // This is a feature of `babel-loader` for webpack (not Babel itself).
-                // It enables caching results in ./node_modules/.cache/babel-loader/
-                // directory for faster rebuilds.
-                cacheDirectory: true,
-                // See #6846 for context on why cacheCompression is disabled
-                cacheCompression: false,
-                compact: isEnvProduction,
-              },
-            },
-            // Process any JS outside of the app with Babel.
-            // Unlike the application JS, we only compile the standard ES features.
-            {
-              test: /\.(js|mjs)$/,
-              exclude: /@babel(?:\/|\\{1,2})runtime/,
-              loader: require.resolve('babel-loader'),
-              options: {
-                babelrc: false,
-                configFile: false,
-                compact: false,
-                presets: [
-                  [
-                    require.resolve('babel-preset-react-app/dependencies'),
-                    { helpers: true },
-                  ],
-                  "@babel/preset-env",
-                  "@babel/preset-react"
-                ],
-                plugins: [
-                  [
-                    "@babel/plugin-proposal-class-properties"
-                  ]
-                ],
-                cacheDirectory: true,
-                // See #6846 for context on why cacheCompression is disabled
-                cacheCompression: false,
-                
-                // Babel sourcemaps are needed for debugging into node_modules
-                // code.  Without the options below, debuggers like VSCode
-                // show incorrect code and set breakpoints on the wrong lines.
-                sourceMaps: shouldUseSourceMap,
-                inputSourceMap: shouldUseSourceMap,
-              },
-            },
-            // "postcss" loader applies autoprefixer to our CSS.
-            // "css" loader resolves paths in CSS and adds assets as dependencies.
-            // "style" loader turns CSS into JS modules that inject <style> tags.
-            // In production, we use MiniCSSExtractPlugin to extract that CSS
-            // to a file, but in development "style" loader enables hot editing
-            // of CSS.
-            // By default we support CSS Modules with the extension .module.css
-            {
-              test: cssRegex,
-              exclude: cssModuleRegex,
-              use: getStyleLoaders({
-                importLoaders: 1,
-                sourceMap: isEnvProduction && shouldUseSourceMap,
-              }),
-              // Don't consider CSS imports dead code even if the
-              // containing package claims to have no side effects.
-              // Remove this when webpack adds a warning or an error for this.
-              // See https://github.com/webpack/webpack/issues/6571
-              sideEffects: true,
-            },
-            // Adds support for CSS Modules (https://github.com/css-modules/css-modules)
-            // using the extension .module.css
-            {
-              test: cssModuleRegex,
-              use: getStyleLoaders({
-                importLoaders: 1,
-                sourceMap: isEnvProduction && shouldUseSourceMap,
-                modules: {
-                  getLocalIdent: getCSSModuleLocalIdent,
-                },
-              }),
-            },
-            // Opt-in support for SASS (using .scss or .sass extensions).
-            // By default we support SASS Modules with the
-            // extensions .module.scss or .module.sass
-            {
-              test: sassRegex,
-              exclude: sassModuleRegex,
-              use: getStyleLoaders(
-                {
-                  importLoaders: 3,
-                  sourceMap: isEnvProduction && shouldUseSourceMap,
-                },
-                'sass-loader'
-              ),
-              // Don't consider CSS imports dead code even if the
-              // containing package claims to have no side effects.
-              // Remove this when webpack adds a warning or an error for this.
-              // See https://github.com/webpack/webpack/issues/6571
-              sideEffects: true,
-            },
-            // Adds support for CSS Modules, but using SASS
-            // using the extension .module.scss or .module.sass
-            {
-              test: sassModuleRegex,
-              use: getStyleLoaders(
-                {
-                  importLoaders: 3,
-                  sourceMap: isEnvProduction && shouldUseSourceMap,
-                  modules: {
-                    getLocalIdent: getCSSModuleLocalIdent,
-                  },
-                },
-                'sass-loader'
-              ),
-            },
-            // "file" loader makes sure those assets get served by WebpackDevServer.
-            // When you `import` an asset, you get its (virtual) filename.
-            // In production, they would get copied to the `build` folder.
-            // This loader doesn't use a "test" so it will catch all modules
-            // that fall through the other loaders.
-            {
-              loader: require.resolve('file-loader'),
-              // Exclude `js` files to keep "css" loader working as it injects
-              // its runtime that would otherwise be processed through "file" loader.
-              // Also exclude `html` and `json` extensions so they get processed
-              // by webpacks internal loaders.
-              exclude: [/\.(js|mjs|jsx|ts|tsx)$/, /\.html$/, /\.json$/],
-              options: {
-                name: 'static/media/[name].[hash:8].[ext]',
-              },
-            },
-            // ** STOP ** Are you adding a new loader?
-            // Make sure to add the new loader(s) before the "file" loader.
-          ],
-        },
-      ],
-    },
-    plugins: [
-      // Generates an `index.html` file with the <script> injected.
-      new HtmlWebpackPlugin(
-        Object.assign(
-          {},
-          {
-            inject: true,
-            template: paths.appHtml,
-          },
-          isEnvProduction
-            ? {
-                minify: {
-                  removeComments: true,
-                  collapseWhitespace: true,
-                  removeRedundantAttributes: true,
-                  useShortDoctype: true,
-                  removeEmptyAttributes: true,
-                  removeStyleLinkTypeAttributes: true,
-                  keepClosingSlash: true,
-                  minifyJS: true,
-                  minifyCSS: true,
-                  minifyURLs: true,
-                },
-              }
-            : undefined
-        )
-      ),
-      // Inlines the webpack runtime script. This script is too small to warrant
-      // a network request.
-      // https://github.com/facebook/create-react-app/issues/5358
-      isEnvProduction &&
-        shouldInlineRuntimeChunk &&
-        new InlineChunkHtmlPlugin(HtmlWebpackPlugin, [/runtime-.+[.]js/]),
-      // Makes some environment variables available in index.html.
-      // The public URL is available as %PUBLIC_URL% in index.html, e.g.:
-      // <link rel="icon" href="%PUBLIC_URL%/favicon.ico">
-      // It will be an empty string unless you specify "homepage"
-      // in `package.json`, in which case it will be the pathname of that URL.
-      new InterpolateHtmlPlugin(HtmlWebpackPlugin, env.raw),
-      // This gives some necessary context to module not found errors, such as
-      // the requesting resource.
-      new ModuleNotFoundPlugin(paths.appPath),
-      // Makes some environment variables available to the JS code, for example:
-      // if (process.env.NODE_ENV === 'production') { ... }. See `./env.js`.
-      // It is absolutely essential that NODE_ENV is set to production
-      // during a production build.
-      // Otherwise React will be compiled in the very slow development mode.
-      new webpack.DefinePlugin(env.stringified),
-      // This is necessary to emit hot updates (currently CSS only):
-      isEnvDevelopment && new webpack.HotModuleReplacementPlugin(),
-      // Watcher doesn't work well if you mistype casing in a path so we use
-      // a plugin that prints an error when you attempt to do this.
-      // See https://github.com/facebook/create-react-app/issues/240
-      isEnvDevelopment && new CaseSensitivePathsPlugin(),
-      // If you require a missing module and then `npm install` it, you still have
-      // to restart the development server for webpack to discover it. This plugin
-      // makes the discovery automatic so you don't have to restart.
-      // See https://github.com/facebook/create-react-app/issues/186
-      isEnvDevelopment &&
-        new WatchMissingNodeModulesPlugin(paths.appNodeModules),
-      isEnvProduction &&
-        new MiniCssExtractPlugin({
-          // Options similar to the same options in webpackOptions.output
-          // both options are optional
-          filename: 'index.css',
-          chunkFilename: 'index.[contenthash:8].chunk.css',
-        }),
-      // Generate an asset manifest file with the following content:
-      // - "files" key: Mapping of all asset filenames to their corresponding
-      //   output file so that tools can pick it up without having to parse
-      //   `index.html`
-      // - "entrypoints" key: Array of files which are included in `index.html`,
-      //   can be used to reconstruct the HTML if necessary
-      /*new ManifestPlugin({
-        fileName: 'asset-manifest.json',
-        publicPath: paths.publicUrlOrPath,
-        generate: (seed, files, entrypoints) => {
-          const manifestFiles = files.reduce((manifest, file) => {
-            manifest[file.name] = file.path;
-            return manifest;
-          }, seed);
-          const entrypointFiles = entrypoints.main.filter(
-            fileName => !fileName.endsWith('.map')
-          );
-
-          return {
-            files: manifestFiles,
-            entrypoints: entrypointFiles,
-          };
-        },
-      }),*/
-      // Moment.js is an extremely popular library that bundles large locale files
-      // by default due to how webpack interprets its code. This is a practical
-      // solution that requires the user to opt into importing specific locales.
-      // https://github.com/jmblog/how-to-optimize-momentjs-with-webpack
-      // You can remove this if you don't use Moment.js:
-      new webpack.IgnorePlugin(/^\.\/locale$/, /moment$/),
-      // Generate a service worker script that will precache, and keep up to date,
-      // the HTML & assets that are part of the webpack build.
-      /*isEnvProduction &&
-        new WorkboxWebpackPlugin.GenerateSW({
-          clientsClaim: true,
-          exclude: [/\.map$/, /asset-manifest\.json$/],
-          importWorkboxFrom: 'cdn',
-          navigateFallback: paths.publicUrlOrPath + 'index.html',
-          navigateFallbackBlacklist: [
-            // Exclude URLs starting with /_, as they're likely an API call
-            new RegExp('^/_'),
-            // Exclude any URLs whose last part seems to be a file extension
-            // as they're likely a resource and not a SPA route.
-            // URLs containing a "?" character won't be blacklisted as they're likely
-            // a route with query params (e.g. auth callbacks).
-            new RegExp('/[^/?]+\\.[^/]+$'),
-          ],
-        }),*/
-      // TypeScript type checking
-      useTypeScript &&
-        new ForkTsCheckerWebpackPlugin({
-          typescript: resolve.sync('typescript', {
-            basedir: paths.appNodeModules,
-          }),
-          async: isEnvDevelopment,
-          useTypescriptIncrementalApi: true,
-          checkSyntacticErrors: true,
-          resolveModuleNameModule: process.versions.pnp
-            ? `${__dirname}/pnpTs.js`
-            : undefined,
-          resolveTypeReferenceDirectiveModule: process.versions.pnp
-            ? `${__dirname}/pnpTs.js`
-            : undefined,
-          tsconfig: paths.appTsConfig,
-          reportFiles: [
-            '**',
-            '!**/__tests__/**',
-            '!**/?(*.)(spec|test).*',
-            '!**/src/setupProxy.*',
-            '!**/src/setupTests.*',
-          ],
-          watch: paths.appSrcDemo,
-          silent: true,
-          // The formatter is invoked directly in WebpackDevServerUtils during development
-          formatter: isEnvProduction ? typescriptFormatter : undefined,
-        }),
-    ].filter(Boolean),
-    // Some libraries import Node modules but don't use them in the browser.
-    // Tell webpack to provide empty mocks for them so importing them works.
-    node: {
-      module: 'empty',
-      dgram: 'empty',
-      dns: 'mock',
-      fs: 'empty',
-      http2: 'empty',
-      net: 'empty',
-      tls: 'empty',
-      child_process: 'empty',
-    },
-    // Turn off performance processing because we utilize
-    // our own hints via the FileSizeReporter
-    performance: false,
-  };
-};

config/webpack.config.js

@@ -1,712 +0,0 @@
-const fs = require('fs');
-const path = require('path');
-const webpack = require('webpack');
-const resolve = require('resolve');
-const PnpWebpackPlugin = require('pnp-webpack-plugin');
-const HtmlWebpackPlugin = require('html-webpack-plugin');
-const CaseSensitivePathsPlugin = require('case-sensitive-paths-webpack-plugin');
-const InlineChunkHtmlPlugin = require('react-dev-utils/InlineChunkHtmlPlugin');
-const TerserPlugin = require('terser-webpack-plugin');
-const MiniCssExtractPlugin = require('mini-css-extract-plugin');
-const OptimizeCSSAssetsPlugin = require('optimize-css-assets-webpack-plugin');
-const safePostCssParser = require('postcss-safe-parser');
-const ManifestPlugin = require('webpack-manifest-plugin');
-const InterpolateHtmlPlugin = require('react-dev-utils/InterpolateHtmlPlugin');
-const WorkboxWebpackPlugin = require('workbox-webpack-plugin');
-const WatchMissingNodeModulesPlugin = require('react-dev-utils/WatchMissingNodeModulesPlugin');
-const ModuleScopePlugin = require('react-dev-utils/ModuleScopePlugin');
-const getCSSModuleLocalIdent = require('react-dev-utils/getCSSModuleLocalIdent');
-const paths = require('./paths');
-const modules = require('./modules');
-const getClientEnvironment = require('./env');
-const ModuleNotFoundPlugin = require('react-dev-utils/ModuleNotFoundPlugin');
-const ForkTsCheckerWebpackPlugin = require('react-dev-utils/ForkTsCheckerWebpackPlugin');
-const typescriptFormatter = require('react-dev-utils/typescriptFormatter');
-const CopyWebpackPlugin = require('copy-webpack-plugin');
-const getPackageJson = require('./getPackageJson');
-const PrettierPlugin = require("prettier-webpack-plugin");
-const eslint = require('eslint');
-const postcssNormalize = require('postcss-normalize');
-const appPackageJson = require(paths.appPackageJson);
-
-// Source maps are resource heavy and can cause out of memory issue for large source files.
-const shouldUseSourceMap = process.env.GENERATE_SOURCEMAP !== 'false';
-// Some apps do not need the benefits of saving a web request, so not inlining the chunk
-// makes for a smoother build process.
-const shouldInlineRuntimeChunk = process.env.INLINE_RUNTIME_CHUNK !== 'false';
-
-const isExtendingEslintConfig = process.env.EXTEND_ESLINT === 'true';
-
-const imageInlineSizeLimit = parseInt(
-  process.env.IMAGE_INLINE_SIZE_LIMIT || '10000'
-);
-
-// Check if TypeScript is setup
-const useTypeScript = fs.existsSync(paths.appTsConfig);
-
-// style files regexes
-const cssRegex = /\.css$/;
-const cssModuleRegex = /\.module\.css$/;
-const sassRegex = /\.(scss|sass)$/;
-const sassModuleRegex = /\.module\.(scss|sass)$/;
-
-const {
-  version,
-  name,
-  license,
-  repository,
-  author,
-} = getPackageJson('version', 'name', 'license', 'repository', 'author');
-
-const banner = `
-  ${name} v${version}
-  ${repository.url}
-
-  Copyright (c) ${author.replace(/ *<[^)]*> */g, " ")}
-
-  This source code is licensed under the ${license} license found in the
-  LICENSE file in the root directory of this source tree.
-  `;
-
-// This is the production and development configuration.
-// It is focused on developer experience, fast rebuilds, and a minimal bundle.
-module.exports = function(webpackEnv) {
-  const isEnvDevelopment = webpackEnv === 'development';
-  const isEnvProduction = webpackEnv === 'production';
-
-  // Variable used for enabling profiling in Production
-  // passed into alias object. Uses a flag if passed into the build command
-  const isEnvProductionProfile =
-    isEnvProduction && process.argv.includes('--profile');
-
-  // We will provide `paths.publicUrlOrPath` to our app
-  // as %PUBLIC_URL% in `index.html` and `process.env.PUBLIC_URL` in JavaScript.
-  // Omit trailing slash as %PUBLIC_URL%/xyz looks better than %PUBLIC_URL%xyz.
-  // Get environment variables to inject into our app.
-  const env = getClientEnvironment(paths.publicUrlOrPath.slice(0, -1));
-
-  // common function to get style loaders
-  const getStyleLoaders = (cssOptions, preProcessor) => {
-    const loaders = [
-      isEnvDevelopment && require.resolve('style-loader'),
-      isEnvProduction && {
-        loader: MiniCssExtractPlugin.loader,
-        // css is located in `static/css`, use '../../' to locate index.html folder
-        // in production `paths.publicUrlOrPath` can be a relative path
-        options: paths.publicUrlOrPath.startsWith('.')
-          ? { publicPath: '../../' }
-          : {},
-      },
-      {
-        loader: require.resolve('css-loader'),
-        options: cssOptions,
-      },
-      {
-        // Options for PostCSS as we reference these options twice
-        // Adds vendor prefixing based on your specified browser support in
-        // package.json
-        loader: require.resolve('postcss-loader'),
-        options: {
-          // Necessary for external CSS imports to work
-          // https://github.com/facebook/create-react-app/issues/2677
-          ident: 'postcss',
-          plugins: () => [
-            require('postcss-flexbugs-fixes'),
-            require('postcss-preset-env')({
-              autoprefixer: {
-                flexbox: 'no-2009',
-              },
-              stage: 3,
-            }),
-            // Adds PostCSS Normalize as the reset css with default options,
-            // so that it honors browserslist config in package.json
-            // which in turn let's users customize the target behavior as per their needs.
-            postcssNormalize(),
-          ],
-          sourceMap: isEnvProduction && shouldUseSourceMap,
-        },
-      },
-    ].filter(Boolean);
-    if (preProcessor) {
-      loaders.push(
-        {
-          loader: require.resolve('resolve-url-loader'),
-          options: {
-            sourceMap: isEnvProduction && shouldUseSourceMap,
-          },
-        },
-        {
-          loader: require.resolve(preProcessor),
-          options: {
-            sourceMap: true,
-          },
-        }
-      );
-    }
-    return loaders;
-  };
-
-  return {
-    mode: isEnvProduction ? 'production' : isEnvDevelopment && 'development',
-    // Stop compilation early in production
-    bail: isEnvProduction,
-    devtool: isEnvProduction
-      ? shouldUseSourceMap
-        ? 'source-map'
-        : false
-      : isEnvDevelopment && 'cheap-module-source-map',
-    // These are the "entry points" to our application.
-    // This means they will be the "root" imports that are included in JS bundle.
-    entry: isEnvProduction ? [paths.appLibIndexJs] : [
-      // Include an alternative client for WebpackDevServer. A client's job is to
-      // connect to WebpackDevServer by a socket and get notified about changes.
-      // When you save a file, the client will either apply hot updates (in case
-      // of CSS changes), or refresh the page (in case of JS changes). When you
-      // make a syntax error, this client will display a syntax error overlay.
-      // Note: instead of the default WebpackDevServer client, we use a custom one
-      // to bring better experience for Create React App users. You can replace
-      // the line below with these two lines if you prefer the stock client:
-      // require.resolve('webpack-dev-server/client') + '?/',
-      // require.resolve('webpack/hot/dev-server'),
-      isEnvDevelopment &&
-        require.resolve('react-dev-utils/webpackHotDevClient'),
-      // Finally, this is your app's code:
-      paths.appIndexJs,
-      // We include the app code last so that if there is a runtime error during
-      // initialization, it doesn't blow up the WebpackDevServer client, and
-      // changing JS code would still trigger a refresh.
-    ].filter(Boolean),
-    output: {
-      // The build folder.
-      path: isEnvProduction ? paths.appBuild : undefined,
-      // Add /* filename */ comments to generated require()s in the output.
-      pathinfo: isEnvDevelopment,
-      // There will be one main bundle, and one file per asynchronous chunk.
-      // In development, it does not produce real files.
-      filename: isEnvProduction
-        ? 'index.js'
-        : isEnvDevelopment && 'static/js/bundle.js',
-      // TODO: remove this when upgrading to webpack 5
-      futureEmitAssets: true,
-      // There are also additional JS chunk files if you use code splitting.
-      chunkFilename: isEnvProduction
-        ? 'static/js/[name].[contenthash:8].chunk.js'
-        : isEnvDevelopment && 'static/js/[name].chunk.js',
-      // webpack uses `publicPath` to determine where the app is being served from.
-      // It requires a trailing slash, or the file assets will get an incorrect path.
-      // We inferred the "public path" (such as / or /my-project) from homepage.
-      publicPath: paths.publicUrlOrPath,
-      library: "SimpleKeyboard",
-      libraryTarget: 'umd',
-      umdNamedDefine: true,
-      // Point sourcemap entries to original disk location (format as URL on Windows)
-      devtoolModuleFilenameTemplate: isEnvProduction
-        ? info =>
-            path
-              .relative(paths.appSrcLib, info.absoluteResourcePath)
-              .replace(/\\/g, '/')
-        : isEnvDevelopment &&
-          (info => path.resolve(info.absoluteResourcePath).replace(/\\/g, '/')),
-      // Prevents conflicts when multiple webpack runtimes (from different apps)
-      // are used on the same page.
-      jsonpFunction: `webpackJsonp${appPackageJson.name}`,
-      // this defaults to 'window', but by setting it to 'this' then
-      // module chunks which are built will work in web workers as well.
-      globalObject: 'this',
-    },
-    optimization: {
-      minimize: isEnvProduction,
-      minimizer: [
-        // This is only used in production mode
-        new TerserPlugin({
-          terserOptions: {
-            parse: {
-              // We want terser to parse ecma 8 code. However, we don't want it
-              // to apply any minification steps that turns valid ecma 5 code
-              // into invalid ecma 5 code. This is why the 'compress' and 'output'
-              // sections only apply transformations that are ecma 5 safe
-              // https://github.com/facebook/create-react-app/pull/4234
-              ecma: 8,
-            },
-            compress: {
-              ecma: 5,
-              warnings: false,
-              // Disabled because of an issue with Uglify breaking seemingly valid code:
-              // https://github.com/facebook/create-react-app/issues/2376
-              // Pending further investigation:
-              // https://github.com/mishoo/UglifyJS2/issues/2011
-              comparisons: false,
-              // Disabled because of an issue with Terser breaking valid code:
-              // https://github.com/facebook/create-react-app/issues/5250
-              // Pending further investigation:
-              // https://github.com/terser-js/terser/issues/120
-              inline: 2,
-            },
-            mangle: {
-              safari10: true,
-              keep_classnames: true,
-              keep_fnames: true,
-              module: true
-            },
-            // Added for profiling in devtools
-            keep_classnames: isEnvProductionProfile,
-            keep_fnames: isEnvProductionProfile,
-            output: {
-              ecma: 5,
-              comments: false,
-              // Turned on because emoji and regex is not minified properly using default
-              // https://github.com/facebook/create-react-app/issues/2488
-              ascii_only: true,
-            },
-          },
-          cache: true,
-          sourceMap: shouldUseSourceMap,
-        }),
-        // This is only used in production mode
-        new webpack.BannerPlugin({ 
-          banner: banner, 
-          entryOnly: true 
-        }),
-        new OptimizeCSSAssetsPlugin({
-          cssProcessorOptions: {
-            parser: safePostCssParser,
-            map: shouldUseSourceMap
-              ? {
-                  // `inline: false` forces the sourcemap to be output into a
-                  // separate file
-                  inline: false,
-                  // `annotation: true` appends the sourceMappingURL to the end of
-                  // the css file, helping the browser find the sourcemap
-                  annotation: true,
-                }
-              : false,
-          },
-          cssProcessorPluginOptions: {
-            preset: ['default', { minifyFontValues: { removeQuotes: false } }],
-          },
-        }),
-      ],
-      // Automatically split vendor and commons
-      // https://twitter.com/wSokra/status/969633336732905474
-      // https://medium.com/webpack/webpack-4-code-splitting-chunk-graph-and-the-splitchunks-optimization-be739a861366
-      splitChunks: {
-        cacheGroups: {
-          default: false,
-        }
-      },
-      // Keep the runtime chunk separated to enable long term caching
-      // https://twitter.com/wSokra/status/969679223278505985
-      // https://github.com/facebook/create-react-app/issues/5358
-      runtimeChunk: false,
-    },
-    resolve: {
-      // This allows you to set a fallback for where webpack should look for modules.
-      // We placed these paths second because we want `node_modules` to "win"
-      // if there are any conflicts. This matches Node resolution mechanism.
-      // https://github.com/facebook/create-react-app/issues/253
-      modules: ['node_modules', paths.appNodeModules].concat(
-        modules.additionalModulePaths || []
-      ),
-      // These are the reasonable defaults supported by the Node ecosystem.
-      // We also include JSX as a common component filename extension to support
-      // some tools, although we do not recommend using it, see:
-      // https://github.com/facebook/create-react-app/issues/290
-      // `web` extension prefixes have been added for better support
-      // for React Native Web.
-      extensions: paths.moduleFileExtensions
-        .map(ext => `.${ext}`)
-        .filter(ext => useTypeScript || !ext.includes('ts')),
-      alias: {
-        // Support React Native Web
-        // https://www.smashingmagazine.com/2016/08/a-glimpse-into-the-future-with-react-native-for-web/
-        'react-native': 'react-native-web',
-        // Allows for better profiling with ReactDevTools
-        ...(isEnvProductionProfile && {
-          'react-dom$': 'react-dom/profiling',
-          'scheduler/tracing': 'scheduler/tracing-profiling',
-        }),
-        ...(modules.webpackAliases || {}),
-      },
-      plugins: [
-        // Adds support for installing with Plug'n'Play, leading to faster installs and adding
-        // guards against forgotten dependencies and such.
-        PnpWebpackPlugin,
-        // Prevents users from importing files from outside of src/ (or node_modules/).
-        // This often causes confusion because we only process files within src/ with babel.
-        // To fix this, we prevent you from importing files out of src/ -- if you'd like to,
-        // please link the files into your node_modules/ and let module-resolution kick in.
-        // Make sure your source files are compiled, as they will not be processed in any way.
-        new ModuleScopePlugin(paths.appSrc, [paths.appPackageJson]),
-      ],
-    },
-    resolveLoader: {
-      plugins: [
-        // Also related to Plug'n'Play, but this time it tells webpack to load its loaders
-        // from the current package.
-        PnpWebpackPlugin.moduleLoader(module),
-      ],
-    },
-    module: {
-      strictExportPresence: true,
-      rules: [
-        // Disable require.ensure as it's not a standard language feature.
-        { parser: { requireEnsure: false } },
-
-        // First, run the linter.
-        // It's important to do this before Babel processes the JS.
-        {
-          test: /\.(js|mjs|jsx|ts|tsx)$/,
-          enforce: 'pre',
-          use: [
-            {
-              options: {
-                cache: true,
-                formatter: require.resolve('react-dev-utils/eslintFormatter'),
-                eslintPath: require.resolve('eslint'),
-                resolvePluginsRelativeTo: __dirname,
-                
-              },
-              loader: require.resolve('eslint-loader'),
-            },
-          ],
-          include: paths.appSrcLib,
-        },
-        {
-          // "oneOf" will traverse all following loaders until one will
-          // match the requirements. When no loader matches it will fall
-          // back to the "file" loader at the end of the loader list.
-          oneOf: [
-            // "url" loader works like "file" loader except that it embeds assets
-            // smaller than specified limit in bytes as data URLs to avoid requests.
-            // A missing `test` is equivalent to a match.
-            {
-              test: [/\.bmp$/, /\.gif$/, /\.jpe?g$/, /\.png$/],
-              loader: require.resolve('url-loader'),
-              options: {
-                limit: imageInlineSizeLimit,
-                name: 'static/media/[name].[hash:8].[ext]',
-              },
-            },
-            // Process application JS with Babel.
-            // The preset includes JSX, Flow, TypeScript, and some ESnext features.
-            {
-              test: /\.(js|mjs|jsx|ts|tsx)$/,
-              include: paths.appSrcLib,
-              loader: require.resolve('babel-loader'),
-              options: {
-                customize: require.resolve(
-                  'babel-preset-react-app/webpack-overrides'
-                ),
-                
-                plugins: [
-                  [
-                    require.resolve('babel-plugin-named-asset-import'),
-                    {
-                      loaderMap: {
-                        svg: {
-                          ReactComponent:
-                            '@svgr/webpack?-svgo,+titleProp,+ref![path]',
-                        },
-                      },
-                    },
-                  ],
-                ],
-                // This is a feature of `babel-loader` for webpack (not Babel itself).
-                // It enables caching results in ./node_modules/.cache/babel-loader/
-                // directory for faster rebuilds.
-                cacheDirectory: true,
-                // See #6846 for context on why cacheCompression is disabled
-                cacheCompression: false,
-                compact: isEnvProduction,
-              },
-            },
-            // Process any JS outside of the app with Babel.
-            // Unlike the application JS, we only compile the standard ES features.
-            {
-              test: /\.(js|mjs)$/,
-              exclude: /@babel(?:\/|\\{1,2})runtime/,
-              loader: require.resolve('babel-loader'),
-              options: {
-                babelrc: false,
-                configFile: false,
-                compact: false,
-                presets: [
-                  [
-                    require.resolve('babel-preset-react-app/dependencies'),
-                    { helpers: true },
-                  ],
-                  "@babel/preset-env",
-                  "@babel/preset-react"
-                ],
-                plugins: [
-                  [
-                    "@babel/plugin-proposal-class-properties"
-                  ]
-                ],
-                cacheDirectory: true,
-                // See #6846 for context on why cacheCompression is disabled
-                cacheCompression: false,
-                
-                // Babel sourcemaps are needed for debugging into node_modules
-                // code.  Without the options below, debuggers like VSCode
-                // show incorrect code and set breakpoints on the wrong lines.
-                sourceMaps: shouldUseSourceMap,
-                inputSourceMap: shouldUseSourceMap,
-              },
-            },
-            // "postcss" loader applies autoprefixer to our CSS.
-            // "css" loader resolves paths in CSS and adds assets as dependencies.
-            // "style" loader turns CSS into JS modules that inject <style> tags.
-            // In production, we use MiniCSSExtractPlugin to extract that CSS
-            // to a file, but in development "style" loader enables hot editing
-            // of CSS.
-            // By default we support CSS Modules with the extension .module.css
-            {
-              test: cssRegex,
-              exclude: cssModuleRegex,
-              use: getStyleLoaders({
-                importLoaders: 1,
-                sourceMap: isEnvProduction && shouldUseSourceMap,
-              }),
-              // Don't consider CSS imports dead code even if the
-              // containing package claims to have no side effects.
-              // Remove this when webpack adds a warning or an error for this.
-              // See https://github.com/webpack/webpack/issues/6571
-              sideEffects: true,
-            },
-            // Adds support for CSS Modules (https://github.com/css-modules/css-modules)
-            // using the extension .module.css
-            {
-              test: cssModuleRegex,
-              use: getStyleLoaders({
-                importLoaders: 1,
-                sourceMap: isEnvProduction && shouldUseSourceMap,
-                modules: {
-                  getLocalIdent: getCSSModuleLocalIdent,
-                },
-              }),
-            },
-            // Opt-in support for SASS (using .scss or .sass extensions).
-            // By default we support SASS Modules with the
-            // extensions .module.scss or .module.sass
-            {
-              test: sassRegex,
-              exclude: sassModuleRegex,
-              use: getStyleLoaders(
-                {
-                  importLoaders: 3,
-                  sourceMap: isEnvProduction && shouldUseSourceMap,
-                },
-                'sass-loader'
-              ),
-              // Don't consider CSS imports dead code even if the
-              // containing package claims to have no side effects.
-              // Remove this when webpack adds a warning or an error for this.
-              // See https://github.com/webpack/webpack/issues/6571
-              sideEffects: true,
-            },
-            // Adds support for CSS Modules, but using SASS
-            // using the extension .module.scss or .module.sass
-            {
-              test: sassModuleRegex,
-              use: getStyleLoaders(
-                {
-                  importLoaders: 3,
-                  sourceMap: isEnvProduction && shouldUseSourceMap,
-                  modules: {
-                    getLocalIdent: getCSSModuleLocalIdent,
-                  },
-                },
-                'sass-loader'
-              ),
-            },
-            // "file" loader makes sure those assets get served by WebpackDevServer.
-            // When you `import` an asset, you get its (virtual) filename.
-            // In production, they would get copied to the `build` folder.
-            // This loader doesn't use a "test" so it will catch all modules
-            // that fall through the other loaders.
-            {
-              loader: require.resolve('file-loader'),
-              // Exclude `js` files to keep "css" loader working as it injects
-              // its runtime that would otherwise be processed through "file" loader.
-              // Also exclude `html` and `json` extensions so they get processed
-              // by webpacks internal loaders.
-              exclude: [/\.(js|mjs|jsx|ts|tsx)$/, /\.html$/, /\.json$/],
-              options: {
-                name: 'static/media/[name].[hash:8].[ext]',
-              },
-            },
-            // ** STOP ** Are you adding a new loader?
-            // Make sure to add the new loader(s) before the "file" loader.
-          ],
-        },
-      ],
-    },
-    plugins: [
-      isEnvDevelopment &&
-      // Generates an `index.html` file with the <script> injected.
-      new HtmlWebpackPlugin(
-        Object.assign(
-          {},
-          {
-            inject: true,
-            template: paths.appHtml,
-          },
-          isEnvProduction
-            ? {
-                minify: {
-                  removeComments: true,
-                  collapseWhitespace: true,
-                  removeRedundantAttributes: true,
-                  useShortDoctype: true,
-                  removeEmptyAttributes: true,
-                  removeStyleLinkTypeAttributes: true,
-                  keepClosingSlash: true,
-                  minifyJS: true,
-                  minifyCSS: true,
-                  minifyURLs: true,
-                },
-              }
-            : undefined
-        )
-      ),
-      // Inlines the webpack runtime script. This script is too small to warrant
-      // a network request.
-      // https://github.com/facebook/create-react-app/issues/5358
-      isEnvProduction &&
-        shouldInlineRuntimeChunk &&
-        new InlineChunkHtmlPlugin(HtmlWebpackPlugin, [/runtime-.+[.]js/]),
-      // Makes some environment variables available in index.html.
-      // The public URL is available as %PUBLIC_URL% in index.html, e.g.:
-      // <link rel="icon" href="%PUBLIC_URL%/favicon.ico">
-      // It will be an empty string unless you specify "homepage"
-      // in `package.json`, in which case it will be the pathname of that URL.
-      new InterpolateHtmlPlugin(HtmlWebpackPlugin, env.raw),
-      // This gives some necessary context to module not found errors, such as
-      // the requesting resource.
-      new ModuleNotFoundPlugin(paths.appPath),
-      // Makes some environment variables available to the JS code, for example:
-      // if (process.env.NODE_ENV === 'production') { ... }. See `./env.js`.
-      // It is absolutely essential that NODE_ENV is set to production
-      // during a production build.
-      // Otherwise React will be compiled in the very slow development mode.
-      new webpack.DefinePlugin(env.stringified),
-      // This is necessary to emit hot updates (currently CSS only):
-      isEnvDevelopment && new webpack.HotModuleReplacementPlugin(),
-      // Watcher doesn't work well if you mistype casing in a path so we use
-      // a plugin that prints an error when you attempt to do this.
-      // See https://github.com/facebook/create-react-app/issues/240
-      isEnvDevelopment && new CaseSensitivePathsPlugin(),
-      // If you require a missing module and then `npm install` it, you still have
-      // to restart the development server for webpack to discover it. This plugin
-      // makes the discovery automatic so you don't have to restart.
-      // See https://github.com/facebook/create-react-app/issues/186
-      isEnvDevelopment &&
-        new WatchMissingNodeModulesPlugin(paths.appNodeModules),
-      isEnvProduction &&
-        new MiniCssExtractPlugin({
-          // Options similar to the same options in webpackOptions.output
-          // both options are optional
-          filename: 'css/index.css',
-          chunkFilename: 'css/index.[contenthash:8].chunk.css',
-        }),
-      // Generate an asset manifest file with the following content:
-      // - "files" key: Mapping of all asset filenames to their corresponding
-      //   output file so that tools can pick it up without having to parse
-      //   `index.html`
-      // - "entrypoints" key: Array of files which are included in `index.html`,
-      //   can be used to reconstruct the HTML if necessary
-      /*new ManifestPlugin({
-        fileName: 'asset-manifest.json',
-        publicPath: paths.publicUrlOrPath,
-        generate: (seed, files, entrypoints) => {
-          const manifestFiles = files.reduce((manifest, file) => {
-            manifest[file.name] = file.path;
-            return manifest;
-          }, seed);
-          const entrypointFiles = entrypoints.main.filter(
-            fileName => !fileName.endsWith('.map')
-          );
-
-          return {
-            files: manifestFiles,
-            entrypoints: entrypointFiles,
-          };
-        },
-      }),*/
-      // Moment.js is an extremely popular library that bundles large locale files
-      // by default due to how webpack interprets its code. This is a practical
-      // solution that requires the user to opt into importing specific locales.
-      // https://github.com/jmblog/how-to-optimize-momentjs-with-webpack
-      // You can remove this if you don't use Moment.js:
-      new webpack.IgnorePlugin(/^\.\/locale$/, /moment$/),
-      new CopyWebpackPlugin([
-        {
-          from: `${paths.appSrcLibTypes}`,
-          to: paths.appBuild
-        }
-      ]),
-      new PrettierPlugin(),
-      // Generate a service worker script that will precache, and keep up to date,
-      // the HTML & assets that are part of the webpack build.
-      /*isEnvProduction &&
-        new WorkboxWebpackPlugin.GenerateSW({
-          clientsClaim: true,
-          exclude: [/\.map$/, /asset-manifest\.json$/],
-          importWorkboxFrom: 'cdn',
-          navigateFallback: paths.publicUrlOrPath + 'index.html',
-          navigateFallbackBlacklist: [
-            // Exclude URLs starting with /_, as they're likely an API call
-            new RegExp('^/_'),
-            // Exclude any URLs whose last part seems to be a file extension
-            // as they're likely a resource and not a SPA route.
-            // URLs containing a "?" character won't be blacklisted as they're likely
-            // a route with query params (e.g. auth callbacks).
-            new RegExp('/[^/?]+\\.[^/]+$'),
-          ],
-        }),*/
-      // TypeScript type checking
-      useTypeScript &&
-        new ForkTsCheckerWebpackPlugin({
-          typescript: resolve.sync('typescript', {
-            basedir: paths.appNodeModules,
-          }),
-          async: isEnvDevelopment,
-          useTypescriptIncrementalApi: true,
-          checkSyntacticErrors: true,
-          resolveModuleNameModule: process.versions.pnp
-            ? `${__dirname}/pnpTs.js`
-            : undefined,
-          resolveTypeReferenceDirectiveModule: process.versions.pnp
-            ? `${__dirname}/pnpTs.js`
-            : undefined,
-          tsconfig: paths.appTsConfig,
-          reportFiles: [
-            '**',
-            '!**/__tests__/**',
-            '!**/?(*.)(spec|test).*',
-            '!**/src/setupProxy.*',
-            '!**/src/setupTests.*',
-          ],
-          silent: true,
-          // The formatter is invoked directly in WebpackDevServerUtils during development
-          formatter: isEnvProduction ? typescriptFormatter : undefined,
-        }),
-    ].filter(Boolean),
-    // Some libraries import Node modules but don't use them in the browser.
-    // Tell webpack to provide empty mocks for them so importing them works.
-    node: {
-      module: 'empty',
-      dgram: 'empty',
-      dns: 'mock',
-      fs: 'empty',
-      http2: 'empty',
-      net: 'empty',
-      tls: 'empty',
-      child_process: 'empty',
-    },
-    // Turn off performance processing because we utilize
-    // our own hints via the FileSizeReporter
-    performance: false,
-  };
-};

config/webpackDevServer.config.js

@@ -1,130 +0,0 @@
-'use strict';
-
-const fs = require('fs');
-const errorOverlayMiddleware = require('react-dev-utils/errorOverlayMiddleware');
-const evalSourceMapMiddleware = require('react-dev-utils/evalSourceMapMiddleware');
-const noopServiceWorkerMiddleware = require('react-dev-utils/noopServiceWorkerMiddleware');
-const ignoredFiles = require('react-dev-utils/ignoredFiles');
-const redirectServedPath = require('react-dev-utils/redirectServedPathMiddleware');
-const paths = require('./paths');
-const getHttpsConfig = require('./getHttpsConfig');
-
-const host = process.env.HOST || '0.0.0.0';
-const sockHost = process.env.WDS_SOCKET_HOST;
-const sockPath = process.env.WDS_SOCKET_PATH; // default: '/sockjs-node'
-const sockPort = process.env.WDS_SOCKET_PORT;
-
-module.exports = function(proxy, allowedHost) {
-  return {
-    // WebpackDevServer 2.4.3 introduced a security fix that prevents remote
-    // websites from potentially accessing local content through DNS rebinding:
-    // https://github.com/webpack/webpack-dev-server/issues/887
-    // https://medium.com/webpack/webpack-dev-server-middleware-security-issues-1489d950874a
-    // However, it made several existing use cases such as development in cloud
-    // environment or subdomains in development significantly more complicated:
-    // https://github.com/facebook/create-react-app/issues/2271
-    // https://github.com/facebook/create-react-app/issues/2233
-    // While we're investigating better solutions, for now we will take a
-    // compromise. Since our WDS configuration only serves files in the `public`
-    // folder we won't consider accessing them a vulnerability. However, if you
-    // use the `proxy` feature, it gets more dangerous because it can expose
-    // remote code execution vulnerabilities in backends like Django and Rails.
-    // So we will disable the host check normally, but enable it if you have
-    // specified the `proxy` setting. Finally, we let you override it if you
-    // really know what you're doing with a special environment variable.
-    disableHostCheck:
-      !proxy || process.env.DANGEROUSLY_DISABLE_HOST_CHECK === 'true',
-    // Enable gzip compression of generated files.
-    compress: true,
-    // Silence WebpackDevServer's own logs since they're generally not useful.
-    // It will still show compile warnings and errors with this setting.
-    clientLogLevel: 'none',
-    // By default WebpackDevServer serves physical files from current directory
-    // in addition to all the virtual build products that it serves from memory.
-    // This is confusing because those files won’t automatically be available in
-    // production build folder unless we copy them. However, copying the whole
-    // project directory is dangerous because we may expose sensitive files.
-    // Instead, we establish a convention that only files in `public` directory
-    // get served. Our build script will copy `public` into the `build` folder.
-    // In `index.html`, you can get URL of `public` folder with %PUBLIC_URL%:
-    // <link rel="icon" href="%PUBLIC_URL%/favicon.ico">
-    // In JavaScript code, you can access it with `process.env.PUBLIC_URL`.
-    // Note that we only recommend to use `public` folder as an escape hatch
-    // for files like `favicon.ico`, `manifest.json`, and libraries that are
-    // for some reason broken when imported through webpack. If you just want to
-    // use an image, put it in `src` and `import` it from JavaScript instead.
-    contentBase: paths.appPublic,
-    contentBasePublicPath: paths.publicUrlOrPath,
-    // By default files from `contentBase` will not trigger a page reload.
-    watchContentBase: true,
-    // Enable hot reloading server. It will provide WDS_SOCKET_PATH endpoint
-    // for the WebpackDevServer client so it can learn when the files were
-    // updated. The WebpackDevServer client is included as an entry point
-    // in the webpack development configuration. Note that only changes
-    // to CSS are currently hot reloaded. JS changes will refresh the browser.
-    hot: true,
-    // Use 'ws' instead of 'sockjs-node' on server since we're using native
-    // websockets in `webpackHotDevClient`.
-    transportMode: 'ws',
-    // Prevent a WS client from getting injected as we're already including
-    // `webpackHotDevClient`.
-    injectClient: false,
-    // Enable custom sockjs pathname for websocket connection to hot reloading server.
-    // Enable custom sockjs hostname, pathname and port for websocket connection
-    // to hot reloading server.
-    sockHost,
-    sockPath,
-    sockPort,
-    // It is important to tell WebpackDevServer to use the same "publicPath" path as
-    // we specified in the webpack config. When homepage is '.', default to serving
-    // from the root.
-    // remove last slash so user can land on `/test` instead of `/test/`
-    publicPath: paths.publicUrlOrPath.slice(0, -1),
-    // WebpackDevServer is noisy by default so we emit custom message instead
-    // by listening to the compiler events with `compiler.hooks[...].tap` calls above.
-    quiet: true,
-    // Reportedly, this avoids CPU overload on some systems.
-    // https://github.com/facebook/create-react-app/issues/293
-    // src/node_modules is not ignored to support absolute imports
-    // https://github.com/facebook/create-react-app/issues/1065
-    watchOptions: {
-      ignored: ignoredFiles(paths.appSrc),
-    },
-    https: getHttpsConfig(),
-    host,
-    overlay: false,
-    historyApiFallback: {
-      // Paths with dots should still use the history fallback.
-      // See https://github.com/facebook/create-react-app/issues/387.
-      disableDotRule: true,
-      index: paths.publicUrlOrPath,
-    },
-    public: allowedHost,
-    // `proxy` is run between `before` and `after` `webpack-dev-server` hooks
-    proxy,
-    before(app, server) {
-      // Keep `evalSourceMapMiddleware` and `errorOverlayMiddleware`
-      // middlewares before `redirectServedPath` otherwise will not have any effect
-      // This lets us fetch source contents from webpack for the error overlay
-      app.use(evalSourceMapMiddleware(server));
-      // This lets us open files from the runtime error overlay.
-      app.use(errorOverlayMiddleware());
-
-      if (fs.existsSync(paths.proxySetup)) {
-        // This registers user provided middleware for proxy reasons
-        require(paths.proxySetup)(app);
-      }
-    },
-    after(app) {
-      // Redirect to `PUBLIC_URL` or `homepage` from `package.json` if url not match
-      app.use(redirectServedPath(paths.publicUrlOrPath));
-
-      // This service worker file is effectively a 'no-op' that will reset any
-      // previous service worker registered for the same host:port combination.
-      // We do this in development to avoid hitting the production cache if
-      // it used the same host and port.
-      // https://github.com/facebook/create-react-app/issues/2272#issuecomment-302832432
-      app.use(noopServiceWorkerMiddleware(paths.publicUrlOrPath));
-    },
-  };
-};

package.json

@@ -1,15 +1,15 @@
 {
   "name": "simple-keyboard",
-  "version": "2.31.0",
+  "version": "3.3.0",
   "description": "On-screen Javascript Virtual Keyboard",
   "main": "build/index.js",
-  "types": "build/index.d.ts",
+  "types": "build/types/index.d.ts",
   "scripts": {
-    "start": "node scripts/start.js",
-    "build": "node scripts/build.js",
-    "demo": "node scripts/demo.js",
-    "test": "node scripts/test.js",
-    "coverage": "node scripts/test.js --coverage --watchAll=false",
+    "start": "webpack serve --config webpack.config.demo.js",
+    "build": "webpack && tsc && npm run build-modern",
+    "build-modern": "webpack --config webpack.config.modern.js",
+    "test": "jest --silent",
+    "coverage": "npm run test -- --coverage",
     "prepare": "npm run build",
     "trypublish": "npm publish || true"
   },
@@ -40,85 +40,38 @@
   ],
   "license": "MIT",
   "devDependencies": {
-    "@babel/core": "7.12.0",
-    "@babel/plugin-proposal-class-properties": "^7.10.4",
-    "@babel/preset-env": "^7.12.0",
-    "@babel/preset-react": "^7.10.4",
-    "@svgr/webpack": "5.4.0",
-    "@testing-library/jest-dom": "^5.11.4",
-    "@testing-library/react": "^11.1.0",
-    "@testing-library/user-event": "^12.1.8",
-    "@typescript-eslint/eslint-plugin": "^2.10.0",
-    "@typescript-eslint/parser": "^2.10.0",
+    "@babel/cli": "^7.15.7",
+    "@babel/core": "^7.15.8",
+    "@babel/plugin-proposal-class-properties": "^7.14.5",
+    "@babel/plugin-transform-typescript": "^7.15.8",
+    "@babel/polyfill": "^7.12.1",
+    "@babel/preset-env": "^7.15.8",
+    "@types/jest": "^27.0.1",
+    "@typescript-eslint/eslint-plugin": "^4.31.2",
+    "@typescript-eslint/parser": "^4.33.0",
+    "autoprefixer": "^10.3.6",
     "babel-eslint": "^10.1.0",
-    "babel-jest": "^26.5.2",
-    "babel-loader": "8.1.0",
-    "babel-plugin-named-asset-import": "^0.3.6",
-    "babel-preset-react-app": "^9.1.2",
-    "camelcase": "^6.1.0",
-    "case-sensitive-paths-webpack-plugin": "2.3.0",
-    "copy-webpack-plugin": "^5.1.2",
-    "css-loader": "5.0.0",
-    "dotenv": "8.2.0",
-    "dotenv-expand": "5.1.0",
-    "eslint": "^6.8.0",
-    "eslint-config-react-app": "^5.0.1",
-    "eslint-loader": "4.0.2",
-    "eslint-plugin-flowtype": "4.7.0",
-    "eslint-plugin-import": "2.22.1",
-    "eslint-plugin-jsx-a11y": "6.3.1",
-    "eslint-plugin-react": "7.21.4",
-    "eslint-plugin-react-hooks": "^4.1.2",
-    "file-loader": "6.1.1",
-    "fs-extra": "9.0.1",
-    "html-webpack-plugin": "4.5.0",
-    "identity-obj-proxy": "3.0.0",
-    "jest": "26.5.3",
-    "jest-environment-jsdom-fourteen": "1.0.1",
-    "jest-resolve": "26.5.2",
-    "jest-watch-typeahead": "0.6.1",
-    "mini-css-extract-plugin": "1.0.0",
-    "optimize-css-assets-webpack-plugin": "5.0.4",
-    "pnp-webpack-plugin": "1.6.4",
-    "postcss-flexbugs-fixes": "4.2.1",
-    "postcss-loader": "3.0.0",
-    "postcss-normalize": "9.0.0",
-    "postcss-preset-env": "6.7.0",
-    "postcss-safe-parser": "5.0.2",
-    "prettier": "^1.19.1",
+    "babel-loader": "^8.2.2",
+    "babel-preset-minify": "^0.5.0",
+    "core-js": "^3.18.2",
+    "css-loader": "^6.4.0",
+    "eslint": "^7.31.0",
+    "file-loader": "^6.2.0",
+    "html-webpack-plugin": "^5.3.2",
+    "jest": "^26.6.3",
+    "mini-css-extract-plugin": "^2.4.2",
+    "optimize-css-assets-webpack-plugin": "^6.0.1",
+    "postcss": "^8.3.9",
+    "postcss-loader": "^6.1.1",
+    "prettier": "^2.4.1",
     "prettier-webpack-plugin": "^1.2.0",
-    "react": "^16.14.0",
-    "react-app-polyfill": "^1.0.6",
-    "react-dev-utils": "^10.2.1",
-    "react-dom": "^16.13.1",
-    "resolve": "1.17.0",
-    "resolve-url-loader": "3.1.1",
-    "sass-loader": "10.0.3",
-    "semver": "7.3.2",
-    "style-loader": "2.0.0",
-    "terser-webpack-plugin": "4.2.3",
-    "ts-pnp": "1.2.0",
-    "uglifyjs-webpack-plugin": "^2.2.0",
-    "url-loader": "4.1.1",
-    "webpack": "4.44.2",
-    "webpack-dev-server": "3.11.0",
-    "webpack-manifest-plugin": "2.2.0",
-    "workbox-webpack-plugin": "5.1.4"
-  },
-  "eslintConfig": {
-    "extends": "react-app"
-  },
-  "browserslist": {
-    "production": [
-      ">0.2%",
-      "not dead",
-      "not op_mini all"
-    ],
-    "development": [
-      "last 1 chrome version",
-      "last 1 firefox version",
-      "last 1 safari version"
-    ]
+    "style-loader": "^3.3.0",
+    "terser-webpack-plugin": "^5.2.4",
+    "typescript": "^4.4.3",
+    "url-loader": "^4.1.1",
+    "webpack": "^5.40.0",
+    "webpack-cli": "^4.9.0",
+    "webpack-dev-server": "4.3.1"
   },
   "jest": {
     "roots": [
@@ -128,35 +81,24 @@
       "src/**/*.{js,jsx,ts,tsx}",
       "!src/**/*.d.ts",
       "!src/lib/index.js",
-      "!src/demo/index.js",
+      "!src/lib/polyfills.js",
+      "!src/demo/**",
       "!src/utils/**",
       "!src/**/*.d.ts",
       "!**/tests/**"
     ],
-    "setupFiles": [
-      "react-app-polyfill/jsdom"
-    ],
-    "setupFilesAfterEnv": [
-      "<rootDir>/src/setupTests.js"
-    ],
     "testMatch": [
       "<rootDir>/src/**/__tests__/**/*.{js,jsx,ts,tsx}",
       "<rootDir>/src/**/*.{spec,test}.{js,jsx,ts,tsx}"
     ],
-    "testEnvironment": "jest-environment-jsdom-fourteen",
-    "transform": {
-      "^.+\\.(js|jsx|ts|tsx)$": "<rootDir>/node_modules/babel-jest",
-      "^.+\\.css$": "<rootDir>/config/jest/cssTransform.js",
-      "^(?!.*\\.(js|jsx|ts|tsx|css|json)$)": "<rootDir>/config/jest/fileTransform.js"
-    },
     "transformIgnorePatterns": [
       "[/\\\\]node_modules[/\\\\].+\\.(js|jsx|ts|tsx)$",
       "^.+\\.module\\.(css|sass|scss)$"
     ],
     "modulePaths": [],
     "moduleNameMapper": {
-      "^react-native$": "react-native-web",
-      "^.+\\.module\\.(css|sass|scss)$": "identity-obj-proxy"
+      "\\.(jpg|jpeg|png|gif|eot|otf|webp|svg|ttf|woff|woff2|mp4|webm|wav|mp3|m4a|aac|oga)$": "<rootDir>/scripts/testMock.js",
+      "\\.(css|less)$": "<rootDir>/scripts/testMock.js"
     },
     "moduleFileExtensions": [
       "web.js",
@@ -169,21 +111,6 @@
       "web.jsx",
       "jsx",
       "node"
-    ],
-    "watchPlugins": [
-      "jest-watch-typeahead/filename",
-      "jest-watch-typeahead/testname"
-    ]
-  },
-  "babel": {
-    "presets": [
-      "@babel/preset-env",
-      "@babel/preset-react"
-    ],
-    "plugins": [
-      [
-        "@babel/plugin-proposal-class-properties"
-      ]
     ]
   }
 }

public/index.html

@@ -1,28 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-  <head>
-    <meta charset="utf-8" />
-    <meta
-      name="viewport"
-      content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no"
-    />
-    <meta name="theme-color" content="#000000" />
-    <title>simple-keyboard</title>
-    <style>
-      /**
-       * Disabling double-tap to zoom in iOS 10+
-       * as it interferes with simple-keyboard
-       */
-      body,
-      html {
-        touch-action: manipulation;
-      }
-    </style>
-  </head>
-  <body>
-    <noscript>
-      You need to enable JavaScript to run this app.
-    </noscript>
-    <div id="root"></div>
-  </body>
-</html>

scripts/build.js

@@ -1,209 +0,0 @@
-// Do this as the first thing so that any code reading it knows the right env.
-process.env.BABEL_ENV = 'production';
-process.env.NODE_ENV = 'production';
-
-// Makes the script crash on unhandled rejections instead of silently
-// ignoring them. In the future, promise rejections that are not handled will
-// terminate the Node.js process with a non-zero exit code.
-process.on('unhandledRejection', err => {
-  throw err;
-});
-
-// Ensure environment variables are read.
-require('../config/env');
-
-
-const path = require('path');
-const chalk = require('react-dev-utils/chalk');
-const fs = require('fs-extra');
-const webpack = require('webpack');
-const configFactory = require('../config/webpack.config');
-const paths = require('../config/paths');
-const checkRequiredFiles = require('react-dev-utils/checkRequiredFiles');
-const formatWebpackMessages = require('react-dev-utils/formatWebpackMessages');
-const printHostingInstructions = require('react-dev-utils/printHostingInstructions');
-const FileSizeReporter = require('react-dev-utils/FileSizeReporter');
-const printBuildError = require('react-dev-utils/printBuildError');
-
-const measureFileSizesBeforeBuild =
-  FileSizeReporter.measureFileSizesBeforeBuild;
-const printFileSizesAfterBuild = FileSizeReporter.printFileSizesAfterBuild;
-const useYarn = fs.existsSync(paths.yarnLockFile);
-
-// These sizes are pretty large. We'll warn for bundles exceeding them.
-const WARN_AFTER_BUNDLE_GZIP_SIZE = 512 * 1024;
-const WARN_AFTER_CHUNK_GZIP_SIZE = 1024 * 1024;
-
-const isInteractive = process.stdout.isTTY;
-
-// Warn and crash if required files are missing
-if (!checkRequiredFiles([paths.appHtml, paths.appIndexJs])) {
-  process.exit(1);
-}
-
-// Generate configuration
-const config = configFactory('production');
-
-// We require that you explicitly set browsers and do not fall back to
-// browserslist defaults.
-const { checkBrowsers } = require('react-dev-utils/browsersHelper');
-checkBrowsers(paths.appPath, isInteractive)
-  .then(() => {
-    // First, read the current file sizes in build directory.
-    // This lets us display how much they changed later.
-    return measureFileSizesBeforeBuild(paths.appBuild);
-  })
-  .then(previousFileSizes => {
-    // Remove all content but keep the directory so that
-    // if you're in it, you don't end up in Trash
-    fs.emptyDirSync(paths.appBuild);
-    // Merge with the public folder
-    //copyPublicFolder();
-    // Start the webpack build
-    return build(previousFileSizes);
-  })
-  .then(
-    ({ stats, previousFileSizes, warnings }) => {
-      if (warnings.length) {
-        console.log(chalk.yellow('Compiled with warnings.\n'));
-        console.log(warnings.join('\n\n'));
-        console.log(
-          '\nSearch for the ' +
-            chalk.underline(chalk.yellow('keywords')) +
-            ' to learn more about each warning.'
-        );
-        console.log(
-          'To ignore, add ' +
-            chalk.cyan('// eslint-disable-next-line') +
-            ' to the line before.\n'
-        );
-      } else {
-        console.log(chalk.green('Compiled successfully.\n'));
-      }
-
-      console.log('File sizes after gzip:\n');
-      printFileSizesAfterBuild(
-        stats,
-        previousFileSizes,
-        paths.appBuild,
-        WARN_AFTER_BUNDLE_GZIP_SIZE,
-        WARN_AFTER_CHUNK_GZIP_SIZE
-      );
-      console.log();
-
-      const appPackage = require(paths.appPackageJson);
-      const publicUrl = paths.publicUrlOrPath;
-      const publicPath = config.output.publicPath;
-      const buildFolder = path.relative(process.cwd(), paths.appBuild);
-      printHostingInstructions(
-        appPackage,
-        publicUrl,
-        publicPath,
-        buildFolder,
-        useYarn
-      );
-    },
-    err => {
-      const tscCompileOnError = process.env.TSC_COMPILE_ON_ERROR === 'true';
-      if (tscCompileOnError) {
-        console.log(
-          chalk.yellow(
-            'Compiled with the following type errors (you may want to check these before deploying your app):\n'
-          )
-        );
-        printBuildError(err);
-      } else {
-        console.log(chalk.red('Failed to compile.\n'));
-        printBuildError(err);
-        process.exit(1);
-      }
-    }
-  )
-  .catch(err => {
-    if (err && err.message) {
-      console.log(err.message);
-    }
-    process.exit(1);
-  });
-
-// Create the production build and print the deployment instructions.
-function build(previousFileSizes) {
-  // We used to support resolving modules according to `NODE_PATH`.
-  // This now has been deprecated in favor of jsconfig/tsconfig.json
-  // This lets you use absolute paths in imports inside large monorepos:
-  if (process.env.NODE_PATH) {
-    console.log(
-      chalk.yellow(
-        'Setting NODE_PATH to resolve modules absolutely has been deprecated in favor of setting baseUrl in jsconfig.json (or tsconfig.json if you are using TypeScript) and will be removed in a future major release of create-react-app.'
-      )
-    );
-    console.log();
-  }
-
-  console.log('Creating an optimized production build...');
-
-  const compiler = webpack(config);
-  return new Promise((resolve, reject) => {
-    compiler.run((err, stats) => {
-      let messages;
-      if (err) {
-        if (!err.message) {
-          return reject(err);
-        }
-
-        let errMessage = err.message;
-
-        // Add additional information for postcss errors
-        if (Object.prototype.hasOwnProperty.call(err, 'postcssNode')) {
-          errMessage +=
-            '\nCompileError: Begins at CSS selector ' +
-            err['postcssNode'].selector;
-        }
-
-        messages = formatWebpackMessages({
-          errors: [errMessage],
-          warnings: [],
-        });
-      } else {
-        messages = formatWebpackMessages(
-          stats.toJson({ all: false, warnings: true, errors: true })
-        );
-      }
-      if (messages.errors.length) {
-        // Only keep the first error. Others are often indicative
-        // of the same problem, but confuse the reader with noise.
-        if (messages.errors.length > 1) {
-          messages.errors.length = 1;
-        }
-        return reject(new Error(messages.errors.join('\n\n')));
-      }
-      if (
-        process.env.CI &&
-        (typeof process.env.CI !== 'string' ||
-          process.env.CI.toLowerCase() !== 'false') &&
-        messages.warnings.length
-      ) {
-        console.log(
-          chalk.yellow(
-            '\nTreating warnings as errors because process.env.CI = true.\n' +
-              'Most CI servers set it automatically.\n'
-          )
-        );
-        return reject(new Error(messages.warnings.join('\n\n')));
-      }
-
-      return resolve({
-        stats,
-        previousFileSizes,
-        warnings: messages.warnings,
-      });
-    });
-  });
-}
-
-function copyPublicFolder() {
-  fs.copySync(paths.appPublic, paths.appBuild, {
-    dereference: true,
-    filter: file => file !== paths.appHtml,
-  });
-}

scripts/demo.js

@@ -1,209 +0,0 @@
-// Do this as the first thing so that any code reading it knows the right env.
-process.env.BABEL_ENV = 'production';
-process.env.NODE_ENV = 'production';
-
-// Makes the script crash on unhandled rejections instead of silently
-// ignoring them. In the future, promise rejections that are not handled will
-// terminate the Node.js process with a non-zero exit code.
-process.on('unhandledRejection', err => {
-  throw err;
-});
-
-// Ensure environment variables are read.
-require('../config/env');
-
-
-const path = require('path');
-const chalk = require('react-dev-utils/chalk');
-const fs = require('fs-extra');
-const webpack = require('webpack');
-const configFactory = require('../config/webpack.config.demo');
-const paths = require('../config/paths');
-const checkRequiredFiles = require('react-dev-utils/checkRequiredFiles');
-const formatWebpackMessages = require('react-dev-utils/formatWebpackMessages');
-const printHostingInstructions = require('react-dev-utils/printHostingInstructions');
-const FileSizeReporter = require('react-dev-utils/FileSizeReporter');
-const printBuildError = require('react-dev-utils/printBuildError');
-
-const measureFileSizesBeforeBuild =
-  FileSizeReporter.measureFileSizesBeforeBuild;
-const printFileSizesAfterBuild = FileSizeReporter.printFileSizesAfterBuild;
-const useYarn = fs.existsSync(paths.yarnLockFile);
-
-// These sizes are pretty large. We'll warn for bundles exceeding them.
-const WARN_AFTER_BUNDLE_GZIP_SIZE = 512 * 1024;
-const WARN_AFTER_CHUNK_GZIP_SIZE = 1024 * 1024;
-
-const isInteractive = process.stdout.isTTY;
-
-// Warn and crash if required files are missing
-if (!checkRequiredFiles([paths.appHtml, paths.appDemoIndexJs])) {
-  process.exit(1);
-}
-
-// Generate configuration
-const config = configFactory('production');
-
-// We require that you explicitly set browsers and do not fall back to
-// browserslist defaults.
-const { checkBrowsers } = require('react-dev-utils/browsersHelper');
-checkBrowsers(paths.appPath, isInteractive)
-  .then(() => {
-    // First, read the current file sizes in build directory.
-    // This lets us display how much they changed later.
-    return measureFileSizesBeforeBuild(paths.appDemo);
-  })
-  .then(previousFileSizes => {
-    // Remove all content but keep the directory so that
-    // if you're in it, you don't end up in Trash
-    fs.emptyDirSync(paths.appDemo);
-    // Merge with the public folder
-    copyPublicFolder();
-    // Start the webpack build
-    return build(previousFileSizes);
-  })
-  .then(
-    ({ stats, previousFileSizes, warnings }) => {
-      if (warnings.length) {
-        console.log(chalk.yellow('Compiled with warnings.\n'));
-        console.log(warnings.join('\n\n'));
-        console.log(
-          '\nSearch for the ' +
-            chalk.underline(chalk.yellow('keywords')) +
-            ' to learn more about each warning.'
-        );
-        console.log(
-          'To ignore, add ' +
-            chalk.cyan('// eslint-disable-next-line') +
-            ' to the line before.\n'
-        );
-      } else {
-        console.log(chalk.green('Compiled successfully.\n'));
-      }
-
-      console.log('File sizes after gzip:\n');
-      printFileSizesAfterBuild(
-        stats,
-        previousFileSizes,
-        paths.appDemo,
-        WARN_AFTER_BUNDLE_GZIP_SIZE,
-        WARN_AFTER_CHUNK_GZIP_SIZE
-      );
-      console.log();
-
-      const appPackage = require(paths.appPackageJson);
-      const publicUrl = paths.publicUrlOrPath;
-      const publicPath = config.output.publicPath;
-      const buildFolder = path.relative(process.cwd(), paths.appDemo);
-      printHostingInstructions(
-        appPackage,
-        publicUrl,
-        publicPath,
-        buildFolder,
-        useYarn
-      );
-    },
-    err => {
-      const tscCompileOnError = process.env.TSC_COMPILE_ON_ERROR === 'true';
-      if (tscCompileOnError) {
-        console.log(
-          chalk.yellow(
-            'Compiled with the following type errors (you may want to check these before deploying your app):\n'
-          )
-        );
-        printBuildError(err);
-      } else {
-        console.log(chalk.red('Failed to compile.\n'));
-        printBuildError(err);
-        process.exit(1);
-      }
-    }
-  )
-  .catch(err => {
-    if (err && err.message) {
-      console.log(err.message);
-    }
-    process.exit(1);
-  });
-
-// Create the production build and print the deployment instructions.
-function build(previousFileSizes) {
-  // We used to support resolving modules according to `NODE_PATH`.
-  // This now has been deprecated in favor of jsconfig/tsconfig.json
-  // This lets you use absolute paths in imports inside large monorepos:
-  if (process.env.NODE_PATH) {
-    console.log(
-      chalk.yellow(
-        'Setting NODE_PATH to resolve modules absolutely has been deprecated in favor of setting baseUrl in jsconfig.json (or tsconfig.json if you are using TypeScript) and will be removed in a future major release of create-react-app.'
-      )
-    );
-    console.log();
-  }
-
-  console.log('Creating an optimized production build...');
-
-  const compiler = webpack(config);
-  return new Promise((resolve, reject) => {
-    compiler.run((err, stats) => {
-      let messages;
-      if (err) {
-        if (!err.message) {
-          return reject(err);
-        }
-
-        let errMessage = err.message;
-
-        // Add additional information for postcss errors
-        if (Object.prototype.hasOwnProperty.call(err, 'postcssNode')) {
-          errMessage +=
-            '\nCompileError: Begins at CSS selector ' +
-            err['postcssNode'].selector;
-        }
-
-        messages = formatWebpackMessages({
-          errors: [errMessage],
-          warnings: [],
-        });
-      } else {
-        messages = formatWebpackMessages(
-          stats.toJson({ all: false, warnings: true, errors: true })
-        );
-      }
-      if (messages.errors.length) {
-        // Only keep the first error. Others are often indicative
-        // of the same problem, but confuse the reader with noise.
-        if (messages.errors.length > 1) {
-          messages.errors.length = 1;
-        }
-        return reject(new Error(messages.errors.join('\n\n')));
-      }
-      if (
-        process.env.CI &&
-        (typeof process.env.CI !== 'string' ||
-          process.env.CI.toLowerCase() !== 'false') &&
-        messages.warnings.length
-      ) {
-        console.log(
-          chalk.yellow(
-            '\nTreating warnings as errors because process.env.CI = true.\n' +
-              'Most CI servers set it automatically.\n'
-          )
-        );
-        return reject(new Error(messages.warnings.join('\n\n')));
-      }
-
-      return resolve({
-        stats,
-        previousFileSizes,
-        warnings: messages.warnings,
-      });
-    });
-  });
-}
-
-function copyPublicFolder() {
-  fs.copySync(paths.appPublic, paths.appDemo, {
-    dereference: true,
-    filter: file => file !== paths.appHtml,
-  });
-}

scripts/getPackageJson.js

@@ -22,4 +22,4 @@ const getPackageJson = function(...args) {
   }, {});
 };
 
-module.exports = getPackageJson;
+module.exports = getPackageJson;

scripts/start.js

@@ -1,187 +0,0 @@
-
-
-// Do this as the first thing so that any code reading it knows the right env.
-process.env.BABEL_ENV = 'development';
-process.env.NODE_ENV = 'development';
-
-// Makes the script crash on unhandled rejections instead of silently
-// ignoring them. In the future, promise rejections that are not handled will
-// terminate the Node.js process with a non-zero exit code.
-process.on('unhandledRejection', err => {
-  throw err;
-});
-
-// Ensure environment variables are read.
-require('../config/env');
-
-
-const fs = require('fs');
-const chalk = require('react-dev-utils/chalk');
-const webpack = require('webpack');
-const WebpackDevServer = require('webpack-dev-server');
-const clearConsole = require('react-dev-utils/clearConsole');
-const checkRequiredFiles = require('react-dev-utils/checkRequiredFiles');
-const {
-  choosePort,
-  createCompiler,
-  prepareProxy,
-  prepareUrls,
-} = require('react-dev-utils/WebpackDevServerUtils');
-const openBrowser = require('react-dev-utils/openBrowser');
-const paths = require('../config/paths');
-const configFactory = require('../config/webpack.config');
-const createDevServerConfig = require('../config/webpackDevServer.config');
-
-const useYarn = fs.existsSync(paths.yarnLockFile);
-const isInteractive = process.stdout.isTTY;
-
-// Warn and crash if required files are missing
-if (!checkRequiredFiles([paths.appHtml, paths.appDemoIndexJs])) {
-  process.exit(1);
-}
-
-// Tools like Cloud9 rely on this.
-const DEFAULT_PORT = parseInt(process.env.PORT, 10) || 3000;
-const HOST = process.env.HOST || '0.0.0.0';
-
-if (process.env.HOST) {
-  console.log(
-    chalk.cyan(
-      `Attempting to bind to HOST environment variable: ${chalk.yellow(
-        chalk.bold(process.env.HOST)
-      )}`
-    )
-  );
-  console.log(
-    `If this was unintentional, check that you haven't mistakenly set it in your shell.`
-  );
-  console.log(
-    `Learn more here: ${chalk.yellow('https://bit.ly/CRA-advanced-config')}`
-  );
-  console.log();
-}
-
-// We require that you explicitly set browsers and do not fall back to
-// browserslist defaults.
-const { checkBrowsers } = require('react-dev-utils/browsersHelper');
-checkBrowsers(paths.appPath, isInteractive)
-  .then(() => {
-    // We attempt to use the default port but if it is busy, we offer the user to
-    // run on a different port. `choosePort()` Promise resolves to the next free port.
-    return choosePort(HOST, DEFAULT_PORT);
-  })
-  .then(port => {
-    if (port == null) {
-      // We have not found a port.
-      return;
-    }
-    const args = process.argv;
-    const testMode = args[2] === "--testMode";
-    const config = configFactory('development');
-    const protocol = process.env.HTTPS === 'true' ? 'https' : 'http';
-    const appName = require(paths.appPackageJson).name;
-    const useTypeScript = fs.existsSync(paths.appTsConfig);
-    const tscCompileOnError = process.env.TSC_COMPILE_ON_ERROR === 'true';
-    const urls = prepareUrls(
-      protocol,
-      HOST,
-      port,
-      paths.publicUrlOrPath.slice(0, -1)
-    );
-    const devSocket = {
-      warnings: warnings =>
-        devServer.sockWrite(devServer.sockets, 'warnings', warnings),
-      errors: errors =>
-        devServer.sockWrite(devServer.sockets, 'errors', errors),
-    };
-    // Create a webpack compiler that is configured with custom messages.
-    const compiler = createCompiler({
-      appName,
-      config,
-      devSocket,
-      urls,
-      useYarn,
-      useTypeScript,
-      tscCompileOnError,
-      webpack,
-    });
-    // Load proxy config
-    const proxySetting = require(paths.appPackageJson).proxy;
-    const proxyConfig = prepareProxy(
-      proxySetting,
-      paths.appPublic
-    );
-    // Serve webpack assets generated by the compiler over a web server.
-    const serverConfig = createDevServerConfig(
-      proxyConfig,
-      urls.lanUrlForConfig
-    );
-    const devServer = new WebpackDevServer(compiler, serverConfig);
-    // Launch WebpackDevServer.
-    devServer.listen(port, HOST, err => {
-      if (err) {
-        return console.log(err);
-      }
-      if (isInteractive) {
-        clearConsole();
-      }
-
-      // We used to support resolving modules according to `NODE_PATH`.
-      // This now has been deprecated in favor of jsconfig/tsconfig.json
-      // This lets you use absolute paths in imports inside large monorepos:
-      if (process.env.NODE_PATH) {
-        console.log(
-          chalk.yellow(
-            'Setting NODE_PATH to resolve modules absolutely has been deprecated in favor of setting baseUrl in jsconfig.json (or tsconfig.json if you are using TypeScript) and will be removed in a future major release of create-react-app.'
-          )
-        );
-        console.log();
-      }
-
-      console.log(chalk.cyan('Starting the development server...\n'));
-      openBrowser(urls.localUrlForBrowser);
-
-      /**
-       * Handle testMode
-       */
-      if(testMode){
-        compiler.hooks.done.tap('done', (stats) => {
-          stats = stats.toJson();
-      
-          if (stats.errors && stats.errors.length > 0) {
-              devServer.close();
-              process.exit(1);
-          }
-  
-          console.warn("App started in test mode. Closing in 5 seconds.");
-          const closeTimeout = setTimeout(() => {
-            clearTimeout(closeTimeout);
-            devServer.close();
-            process.exit();
-          }, 5000);
-        });
-      }
-    });
-
-    ['SIGINT', 'SIGTERM'].forEach(function(sig) {
-      process.on(sig, function() {
-        devServer.close();
-        process.exit();
-      });
-    });
-
-    if (isInteractive || process.env.CI !== 'true') {
-      // Gracefully exit when stdin ends
-      process.stdin.on('end', function() {
-        devServer.close();
-        process.exit();
-      });
-      process.stdin.resume();
-    }
-  })
-  .catch(err => {
-    if (err && err.message) {
-      console.log(err.message);
-    }
-    process.exit(1);
-  });

scripts/test.js

@@ -1,53 +0,0 @@
-'use strict';
-
-// Do this as the first thing so that any code reading it knows the right env.
-process.env.BABEL_ENV = 'test';
-process.env.NODE_ENV = 'test';
-process.env.PUBLIC_URL = '';
-
-// Makes the script crash on unhandled rejections instead of silently
-// ignoring them. In the future, promise rejections that are not handled will
-// terminate the Node.js process with a non-zero exit code.
-process.on('unhandledRejection', err => {
-  throw err;
-});
-
-// Ensure environment variables are read.
-require('../config/env');
-
-
-const jest = require('jest');
-const execSync = require('child_process').execSync;
-let argv = process.argv.slice(2);
-
-function isInGitRepository() {
-  try {
-    execSync('git rev-parse --is-inside-work-tree', { stdio: 'ignore' });
-    return true;
-  } catch (e) {
-    return false;
-  }
-}
-
-function isInMercurialRepository() {
-  try {
-    execSync('hg --cwd . root', { stdio: 'ignore' });
-    return true;
-  } catch (e) {
-    return false;
-  }
-}
-
-// Watch unless on CI or explicitly running all tests
-if (
-  !process.env.CI &&
-  argv.indexOf('--watchAll') === -1 &&
-  argv.indexOf('--watchAll=false') === -1
-) {
-  // https://github.com/facebook/create-react-app/issues/5210
-  const hasSourceControl = isInGitRepository() || isInMercurialRepository();
-  argv.push(hasSourceControl ? '--watch' : '--watchAll');
-}
-
-
-jest.run(argv);

scripts/testMock.js

@@ -0,0 +1 @@
+module.exports = {};

src/demo/BasicDemo.js

@@ -2,7 +2,7 @@ import Keyboard from "../lib";
 import "./css/BasicDemo.css";
 
 const setDOM = () => {
-  document.querySelector("#root").innerHTML = `
+  document.querySelector("body").innerHTML = `
     <input class="input" placeholder="Tap on the virtual keyboard to start" />
     <div class="simple-keyboard"></div>
   `;

src/demo/ButtonThemeDemo.js

@@ -2,7 +2,7 @@ import Keyboard from "../lib";
 import "./css/ButtonThemeDemo.css";
 
 const setDOM = () => {
-  document.querySelector("#root").innerHTML = `
+  document.querySelector("body").innerHTML = `
     <input class="input" placeholder="Tap on the virtual keyboard to start" />
     <div class="simple-keyboard"></div>
   `;

src/demo/CandidateBoxDemo.js

@@ -0,0 +1,81 @@
+import Keyboard from "../lib";
+import "./css/CandidateBoxDemo.css";
+
+const setDOM = () => {
+  document.querySelector("body").innerHTML = `
+    <input class="input" placeholder="Tap on the virtual keyboard to start" />
+    <div class="simple-keyboard"></div>
+  `;
+};
+
+class Demo {
+  constructor() {
+    setDOM();
+
+    /**
+     * Demo Start
+     */
+    this.keyboard = new Keyboard({
+      onChange: input => this.onChange(input),
+      onKeyPress: button => this.onKeyPress(button),
+      preventMouseDownDefault: true,
+      layoutCandidates: {
+        ni: "你 尼",
+        hao: "好 号"
+      }
+    });
+
+    /**
+     * Update simple-keyboard when input is changed directly
+     */
+    document.querySelector(".input").addEventListener("input", event => {
+      this.keyboard.setInput(event.target.value);
+    });
+  }
+
+  onChange(input) {
+    const inputElement = document.querySelector(".input");
+
+    /**
+     * Updating input's value
+     */
+    inputElement.value = input;
+    console.log("Input changed", input);
+
+    /**
+     * Synchronizing input caret position
+     */
+    const caretPosition = this.keyboard.caretPosition;
+    if (caretPosition !== null)
+      this.setInputCaretPosition(inputElement, caretPosition);
+
+    console.log("caretPosition", caretPosition);
+  }
+
+  setInputCaretPosition(elem, pos) {
+    if (elem.setSelectionRange) {
+      elem.focus();
+      elem.setSelectionRange(pos, pos);
+    }
+  }
+
+  onKeyPress(button) {
+    console.log("Button pressed", button);
+
+    /**
+     * If you want to handle the shift and caps lock buttons
+     */
+    if (button === "{shift}" || button === "{lock}") this.handleShift();
+  }
+
+  handleShift() {
+    const currentLayout = this.keyboard.options.layoutName;
+    const shiftToggle = currentLayout === "default" ? "shift" : "default";
+
+    this.keyboard.setOptions({
+      layoutName: shiftToggle
+    });
+  }
+}
+
+export default Demo;

src/demo/DOMElementDemo.js

@@ -4,7 +4,7 @@ import "./css/DOMElementDemo.css";
 class Demo {
   constructor() {
     const rootDOM =
-      document.querySelector("#root") || document.createElement("div");
+      document.querySelector("body") || document.createElement("div");
 
     const keyboard1DOM = document.createElement("div");
     keyboard1DOM.className = "my-keyboard";

src/demo/FullKeyboardDemo.js

@@ -2,7 +2,7 @@ import Keyboard from "../lib";
 import "./css/FullKeyboardDemo.css";
 
 const setDOM = () => {
-  document.querySelector("#root").innerHTML = `
+  document.querySelector("body").innerHTML = `
     <input class="input" placeholder="Tap on the virtual keyboard to start" />
     <div class="keyboardContainer">
       <div class="simple-keyboard-main"></div>

src/demo/MultipleKeyboardsDestroyDemo.js

@@ -2,7 +2,7 @@ import Keyboard from "../lib";
 import "./css/MultipleKeyboardsDestroyDemo.css";
 
 const setDOM = () => {
-  document.querySelector("#root").innerHTML = `
+  document.querySelector("body").innerHTML = `
     <input class="input" placeholder="Tap on the virtual keyboard to start" />
     <div class="simple-keyboard"></div>
 

src/demo/RTLDemo.js

@@ -2,7 +2,7 @@ import Keyboard from "../lib";
 import "./css/RTLDemo.css";
 
 const setDOM = () => {
-  document.querySelector("#root").innerHTML = `
+  document.querySelector("body").innerHTML = `
     <input class="input" placeholder="Tap on the virtual keyboard to start" />
     <div class="simple-keyboard"></div>
   `;

src/demo/css/CandidateBoxDemo.css

@@ -0,0 +1,12 @@
+input {
+  width: 100%;
+  height: 100px;
+  padding: 20px;
+  font-size: 20px;
+  border: none;
+  box-sizing: border-box;
+}
+
+.simple-keyboard {
+  max-width: 850px;
+}

src/demo/index.js

@@ -9,6 +9,7 @@ import BasicDemo from "./BasicDemo";
 //import DOMElementDemo from "./DOMElementDemo";
 //import FullKeyboardDemo from "./FullKeyboardDemo";
 //import MultipleKeyboardsDemo from "./MultipleKeyboardsDestroyDemo";
+//import CandidateBoxDemo from "./CandidateBoxDemo";
 
 /**
  * Selected demo

src/demo/tests/CandidateBoxDemo.test.js

@@ -0,0 +1,36 @@
+import { setDOM } from '../../utils/TestUtility';
+import CandidateBoxDemo from '../CandidateBoxDemo';
+
+it('Demo will load', () => {
+  setDOM();
+
+  new CandidateBoxDemo();
+});
+
+it('Demo caret positioning will adjust accordingly', () => {
+  setDOM();
+
+  const demo = new CandidateBoxDemo();
+
+  demo.keyboard.setCaretPosition(0);
+
+  demo.keyboard.getButtonElement("n").click();
+  demo.keyboard.getButtonElement("h").click();
+  demo.keyboard.getButtonElement("a").click();
+  demo.keyboard.getButtonElement("o").click();
+  expect(demo.keyboard.getCaretPosition()).toBe(4);
+
+  demo.keyboard.candidateBox.candidateBoxElement.querySelector("li").click();
+
+  expect(demo.keyboard.getCaretPosition()).toBe(2);
+
+  demo.keyboard.setCaretPosition(1);
+  demo.keyboard.getButtonElement("i").click();
+
+  expect(demo.keyboard.getCaretPosition()).toBe(2);
+
+  demo.keyboard.candidateBox.candidateBoxElement.querySelector("li").click();
+
+  expect(demo.keyboard.getCaretPosition()).toBe(1);
+  expect(demo.keyboard.getInput()).toBe("你好");
+});

src/lib/components/CandidateBox.ts

@@ -0,0 +1,138 @@
+import "./css/CandidateBox.css";
+
+import Utilities from "../services/Utilities";
+import {
+  CandidateBoxParams,
+  CandidateBoxRenderParams,
+  CandidateBoxShowParams,
+} from "./../interfaces";
+
+class CandidateBox {
+  utilities: Utilities;
+  candidateBoxElement!: HTMLDivElement;
+  pageIndex = 0;
+  pageSize;
+
+  constructor({ utilities }: CandidateBoxParams) {
+    this.utilities = utilities;
+    Utilities.bindMethods(CandidateBox, this);
+    this.pageSize = this.utilities.getOptions().layoutCandidatesPageSize || 5;
+  }
+
+  destroy() {
+    if (this.candidateBoxElement) {
+      this.candidateBoxElement.remove();
+      this.pageIndex = 0;
+    }
+  }
+
+  show({
+    candidateValue,
+    targetElement,
+    onSelect,
+  }: CandidateBoxShowParams): void {
+    if (!candidateValue || !candidateValue.length) {
+      return;
+    }
+
+    const candidateListPages = this.utilities.chunkArray(
+      candidateValue.split(" "),
+      this.pageSize
+    );
+
+    this.renderPage({
+      candidateListPages,
+      targetElement,
+      pageIndex: this.pageIndex,
+      nbPages: candidateListPages.length,
+      onItemSelected: (selectedCandidate: string, e: MouseEvent) => {
+        onSelect(selectedCandidate, e);
+        this.destroy();
+      },
+    });
+  }
+
+  renderPage({
+    candidateListPages,
+    targetElement,
+    pageIndex,
+    nbPages,
+    onItemSelected,
+  }: CandidateBoxRenderParams) {
+    // Remove current candidate box, if any
+    this.candidateBoxElement?.remove();
+
+    // Create candidate box element
+    this.candidateBoxElement = document.createElement("div");
+    this.candidateBoxElement.className = "hg-candidate-box";
+
+    // Candidate box list
+    const candidateListULElement = document.createElement("ul");
+    candidateListULElement.className = "hg-candidate-box-list";
+
+    // Create Candidate box list items
+    candidateListPages[pageIndex].forEach((candidateListItem) => {
+      const candidateListLIElement = document.createElement("li");
+      const getMouseEvent = () => {
+        const mouseEvent = new MouseEvent("click");
+        Object.defineProperty(mouseEvent, "target", {
+          value: candidateListLIElement,
+        });
+        return mouseEvent;
+      };
+
+      candidateListLIElement.className = "hg-candidate-box-list-item";
+      candidateListLIElement.textContent = candidateListItem;
+      candidateListLIElement.onclick = (e = getMouseEvent()) =>
+        onItemSelected(candidateListItem, e);
+
+      // Append list item to ul
+      candidateListULElement.appendChild(candidateListLIElement);
+    });
+
+    // Add previous button
+    const isPrevBtnElementActive = pageIndex > 0;
+    const prevBtnElement = document.createElement("div");
+    prevBtnElement.classList.add("hg-candidate-box-prev");
+    isPrevBtnElementActive &&
+      prevBtnElement.classList.add("hg-candidate-box-btn-active");
+    prevBtnElement.onclick = () => {
+      if (!isPrevBtnElementActive) return;
+      this.renderPage({
+        candidateListPages,
+        targetElement,
+        pageIndex: pageIndex - 1,
+        nbPages,
+        onItemSelected,
+      });
+    };
+    this.candidateBoxElement.appendChild(prevBtnElement);
+
+    // Add elements to container
+    this.candidateBoxElement.appendChild(candidateListULElement);
+
+    // Add next button
+    const isNextBtnElementActive = pageIndex < nbPages - 1;
+    const nextBtnElement = document.createElement("div");
+    nextBtnElement.classList.add("hg-candidate-box-next");
+    isNextBtnElementActive &&
+      nextBtnElement.classList.add("hg-candidate-box-btn-active");
+
+    nextBtnElement.onclick = () => {
+      if (!isNextBtnElementActive) return;
+      this.renderPage({
+        candidateListPages,
+        targetElement,
+        pageIndex: pageIndex + 1,
+        nbPages,
+        onItemSelected,
+      });
+    };
+    this.candidateBoxElement.appendChild(nextBtnElement);
+
+    // Append candidate box to target element
+    targetElement.prepend(this.candidateBoxElement);
+  }
+}
+
+export default CandidateBox;

src/lib/components/css/CandidateBox.css

@@ -0,0 +1,68 @@
+.hg-candidate-box {
+  display: inline-flex;
+  border-radius: 5px;
+  position: absolute;
+  background: #ececec;
+  border-bottom: 2px solid #b5b5b5;
+  user-select: none;
+  max-width: 272px;
+  transform: translateY(-100%);
+  margin-top: -10px;
+}
+
+ul.hg-candidate-box-list {
+  display: flex;
+  list-style: none;
+  padding: 0;
+  margin: 0;
+  flex: 1;
+}
+
+li.hg-candidate-box-list-item {
+  height: 40px;
+  width: 40px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+
+li.hg-candidate-box-list-item:hover {
+  background: rgba(0, 0, 0, 0.03);
+  cursor: pointer;
+}
+
+li.hg-candidate-box-list-item:active {
+  background: rgba(0, 0, 0, 0.1);
+}
+
+.hg-candidate-box-prev::before {
+  content: "◄";
+}
+
+.hg-candidate-box-next::before {
+  content: "►";
+}
+
+.hg-candidate-box-next,
+.hg-candidate-box-prev {
+  display: flex;
+  align-items: center;
+  padding: 0 10px;
+  background: #d0d0d0;
+  color: #969696;
+  cursor: pointer;
+}
+
+.hg-candidate-box-next {
+  border-top-right-radius: 5px;
+  border-bottom-right-radius: 5px;
+}
+
+.hg-candidate-box-prev {
+  border-top-left-radius: 5px;
+  border-bottom-left-radius: 5px;
+}
+
+.hg-candidate-box-btn-active {
+  color: #444;
+}

src/lib/components/css/Keyboard.css

@@ -8,6 +8,11 @@
   box-sizing: border-box;
   overflow: hidden;
   touch-action: manipulation;
+  font-family: "HelveticaNeue-Light", "Helvetica Neue Light", "Helvetica Neue",
+    Helvetica, Arial, "Lucida Grande", sans-serif;
+  background-color: #ececec;
+  padding: 5px;
+  border-radius: 5px;
 }
 
 .hg-theme-default .hg-button span {
@@ -21,14 +26,6 @@
   font-size: inherit;
 }
 
-.hg-theme-default {
-  font-family: "HelveticaNeue-Light", "Helvetica Neue Light", "Helvetica Neue",
-    Helvetica, Arial, "Lucida Grande", sans-serif;
-  background-color: #ececec;
-  padding: 5px;
-  border-radius: 5px;
-}
-
 .hg-theme-default .hg-button {
   display: inline-block;
   flex-grow: 1;
@@ -74,6 +71,10 @@
   -webkit-tap-highlight-color: rgba(0, 0, 0, 0);
 }
 
+.hg-theme-default .hg-button.hg-standardBtn {
+  width: 20px;
+}
+
 .hg-theme-default .hg-button.hg-activeButton {
   background: #efefef;
 }

src/lib/components/tests/CandidateBox.test.js

@@ -0,0 +1,372 @@
+import Keyboard from '../Keyboard';
+import { setDOM, clearDOM } from '../../../utils/TestUtility';
+import CandidateBox from '../CandidateBox';
+
+beforeEach(() => {
+  setDOM();
+});
+
+afterEach(() => {
+  clearDOM();
+});
+
+it('CandidateBox class will be instantiated by default', () => {
+  document.querySelector("body").innerHTML = `
+    <input class="input" placeholder="Tap on the virtual keyboard to start" />
+    <div class="simple-keyboard"></div>
+
+    <input class="input2" placeholder="Tap on the virtual keyboard to start" />
+    <div class="keyboard2"></div>
+  `;
+
+  const keyboard1 = new Keyboard({
+    layout: {
+      default: [
+        "a b"
+      ]
+    }
+  });
+
+  const keyboard2 = new Keyboard(".keyboard2", {
+    layout: {
+      default: [
+        "a b"
+      ]
+    },
+    layoutCandidates: {
+      a: "1 2"
+    }
+  });
+
+  expect(keyboard1.candidateBox).toBeInstanceOf(CandidateBox);
+  expect(keyboard2.candidateBox).toBeInstanceOf(CandidateBox);
+
+  keyboard1.destroy();
+  keyboard2.destroy();
+});
+
+it('CandidateBox class will not be instantiated on enableLayoutCandidates: false', () => {
+  const keyboard = new Keyboard({
+    layout: {
+      default: [
+        "a b"
+      ]
+    },
+    layoutCandidates: {
+      a: "1 2"
+    },
+    enableLayoutCandidates: false
+  });
+
+  expect(keyboard.candidateBox).toBeNull();
+  keyboard.destroy();
+});
+
+it('CandidateBox will respect layoutCandidatesPageSize', () => {
+  const keyboard = new Keyboard({
+    layout: {
+      default: [
+        "a b {bksp}"
+      ]
+    },
+    layoutCandidates: {
+      a: "1 2 3 4 5 6"
+    },
+    layoutCandidatesPageSize: 3
+  });
+
+  keyboard.getButtonElement("a").click();
+
+  expect(keyboard.candidateBox.candidateBoxElement.querySelectorAll("li").length).toBe(3);
+
+  keyboard.getButtonElement("{bksp}").click();
+  keyboard.setOptions({
+    layoutCandidatesPageSize: 6
+  });
+
+  keyboard.getButtonElement("a").click();
+
+  expect(keyboard.candidateBox.candidateBoxElement.querySelectorAll("li").length).toBe(6);
+  keyboard.destroy();
+});
+
+it('CandidateBox will respect layoutCandidatesPageSize', () => {
+  const keyboard = new Keyboard({
+    layout: {
+      default: [
+        "a b {bksp}"
+      ]
+    },
+    layoutCandidates: {
+      a: "1 2 3 4 5 6"
+    },
+    layoutCandidatesPageSize: 3
+  });
+
+  keyboard.getButtonElement("a").click();
+
+  expect(keyboard.candidateBox.candidateBoxElement.querySelectorAll("li").length).toBe(3);
+
+  keyboard.getButtonElement("{bksp}").click();
+  keyboard.setOptions({
+    layoutCandidatesPageSize: 6
+  });
+
+  keyboard.getButtonElement("a").click();
+
+  expect(keyboard.candidateBox.candidateBoxElement.querySelectorAll("li").length).toBe(6);
+  keyboard.destroy();
+});
+
+it('CandidateBox will reset on layoutCandidates change', () => {
+  const keyboard = new Keyboard({
+    layout: {
+      default: [
+        "a b {bksp}"
+      ]
+    },
+    layoutCandidates: {
+      a: "1 2 3 4 5 6"
+    },
+    layoutCandidatesPageSize: 3
+  });
+
+  keyboard.getButtonElement("a").click();
+
+  expect(keyboard.candidateBox.candidateBoxElement.querySelector("li").textContent).toBe("1");
+
+  keyboard.getButtonElement("{bksp}").click();
+  keyboard.setOptions({
+    layoutCandidates: {
+      a: "s1 s2 s3 s4 s5 s6"
+    }
+  });
+
+  keyboard.getButtonElement("a").click();
+
+  expect(keyboard.candidateBox.candidateBoxElement.querySelector("li").textContent).toBe("s1");
+  keyboard.destroy();
+});
+
+it('CandidateBox show will return early if candidateValue is not provided', () => {
+  const keyboard = new Keyboard({
+    layout: {
+      default: [
+        "a b {bksp}"
+      ]
+    }
+  });
+
+  keyboard.candidateBox.renderPage = jest.fn();
+  keyboard.candidateBox.show({
+    candidateValue: null,
+    targetElement: document.createElement("div"),
+    onSelect: () => {}
+  });
+
+  expect(keyboard.candidateBox.renderPage).not.toBeCalled();
+  keyboard.destroy();
+});
+
+it('CandidateBox show will call renderPage if candidateValue is provided', () => {
+  const keyboard = new Keyboard({
+    layout: {
+      default: [
+        "a b {bksp}"
+      ]
+    }
+  });
+
+  keyboard.candidateBox.renderPage = jest.fn();
+  keyboard.candidateBox.show({
+    candidateValue: "a b",
+    targetElement: document.createElement("div"),
+    onSelect: () => {}
+  });
+
+  expect(keyboard.candidateBox.renderPage).toBeCalled();
+  keyboard.destroy();
+});
+
+it('CandidateBox select candidate will work', () => {
+  const keyboard = new Keyboard({
+    layout: {
+      default: [
+        "a b {bksp}"
+      ]
+    },
+    layoutCandidates: {
+      a: "1 2 3 4 5 6"
+    }
+  });
+
+  let candidateBoxOnItemSelected;
+  const onSelect = jest.fn().mockImplementation((selectedCandidate) => {
+    candidateBoxOnItemSelected(selectedCandidate);
+    keyboard.candidateBox.destroy();
+  });
+
+  const candidateBoxRenderFn = keyboard.candidateBox.renderPage;
+  jest.spyOn(keyboard.candidateBox, "renderPage").mockImplementation((params) => {
+    candidateBoxOnItemSelected = params.onItemSelected;
+    params.onItemSelected = onSelect;
+    candidateBoxRenderFn(params);
+  });
+
+  keyboard.getButtonElement("a").click();
+  keyboard.candidateBox.candidateBoxElement.querySelector("li").click();
+
+  expect(onSelect).toBeCalledWith("1", expect.anything());
+  keyboard.destroy();
+});
+
+it('CandidateBox select next and previous page will work', () => {
+  const keyboard = new Keyboard({
+    layout: {
+      default: [
+        "a b {bksp}"
+      ]
+    },
+    layoutCandidates: {
+      a: "1 2 3 4 5 6"
+    },
+    layoutCandidatesPageSize: 3
+  });
+
+  keyboard.getButtonElement("a").click();
+  keyboard.candidateBox.candidateBoxElement.querySelector(".hg-candidate-box-next").click();
+
+  expect(keyboard.candidateBox.candidateBoxElement.querySelector("ul").textContent).toBe("456");
+
+  keyboard.candidateBox.candidateBoxElement.querySelector(".hg-candidate-box-prev").click();
+
+  expect(keyboard.candidateBox.candidateBoxElement.querySelector("ul").textContent).toBe("123");
+  keyboard.destroy();
+});
+
+it('CandidateBox selecting next and previous page when not available will do nothing', () => {
+  const keyboard = new Keyboard({
+    layout: {
+      default: [
+        "a b {bksp}"
+      ]
+    },
+    layoutCandidates: {
+      a: "1 2 3 4 5 6"
+    },
+    layoutCandidatesPageSize: 3
+  });
+
+  keyboard.getButtonElement("a").click();
+
+  keyboard.candidateBox.candidateBoxElement.querySelector(".hg-candidate-box-prev").click();
+  expect(keyboard.candidateBox.candidateBoxElement.querySelector("ul").textContent).toBe("123");
+
+  keyboard.candidateBox.candidateBoxElement.querySelector(".hg-candidate-box-next").click();
+  expect(keyboard.candidateBox.candidateBoxElement.querySelector("ul").textContent).toBe("456");
+
+  keyboard.candidateBox.candidateBoxElement.querySelector(".hg-candidate-box-next").click();
+  expect(keyboard.candidateBox.candidateBoxElement.querySelector("ul").textContent).toBe("456");
+
+  keyboard.destroy();
+});
+
+it('CandidateBox will not show anything when there is no candidates', () => {
+  const keyboard = new Keyboard({
+    layout: {
+      default: [
+        "a b {bksp}"
+      ]
+    },
+    layoutCandidates: {
+      a: "1 2 3 4 5 6"
+    }
+  });
+
+  keyboard.getButtonElement("b").click();
+
+  expect(keyboard.candidateBox.candidateBoxElement).toBeUndefined();
+  keyboard.destroy();
+});
+
+it('CandidateBox will propose the better matching result, regardless of layoutCandidates order', () => {
+  const keyboard = new Keyboard({
+    layout: {
+      default: [
+        "a b {bksp}"
+      ]
+    },
+    layoutCandidates: {
+      a: "1 2 3",
+      aa: "6 7 8"
+    }
+  });
+
+  keyboard.getButtonElement("a").click();
+  expect(keyboard.candidateBox.candidateBoxElement.querySelector("ul").textContent).toBe("123");
+
+  keyboard.getButtonElement("a").click(); // This will get you the 'aa' layoutCandidates instead of the 'a' ones.
+  expect(keyboard.candidateBox.candidateBoxElement.querySelector("ul").textContent).toBe("678");
+
+  keyboard.getButtonElement("{bksp}").click();
+  expect(keyboard.candidateBox.candidateBoxElement.querySelector("ul").textContent).toBe("123");
+
+  keyboard.destroy();
+});
+
+it('CandidateBox show not be called if keyboard.candidateBox is undefined upon showCandidatesBox call', () => {
+  const keyboard = new Keyboard({
+    layout: {
+      default: [
+        "a b {bksp}"
+      ]
+    },
+    layoutCandidates: {
+      a: "1 2 3",
+      aa: "6 7 8"
+    }
+  });
+
+  keyboard.candidateBox = null;
+  keyboard.showCandidatesBox();
+});
+
+it('CandidateBox selection should trigger onChange', () => {
+    const keyboard = new Keyboard({
+      layout: {
+        default: [
+          "a b {bksp}"
+        ]
+      },
+      layoutCandidates: {
+        a: "1 2 3 4 5 6"
+      },
+      onChange: jest.fn(),
+      onChangeAll: jest.fn()
+    });
+  
+    let candidateBoxOnItemSelected;
+    
+    const onSelect = jest.fn().mockImplementation((selectedCandidate) => {
+      candidateBoxOnItemSelected(selectedCandidate);
+      keyboard.candidateBox.destroy();
+    });
+  
+    const candidateBoxRenderFn = keyboard.candidateBox.renderPage;
+    
+    jest.spyOn(keyboard.candidateBox, "renderPage").mockImplementation((params) => {
+      candidateBoxOnItemSelected = params.onItemSelected;
+      params.onItemSelected = onSelect;
+      candidateBoxRenderFn(params);
+    });
+  
+    keyboard.getButtonElement("a").click();
+    keyboard.candidateBox.candidateBoxElement.querySelector("li").click();
+  
+    expect(keyboard.options.onChange.mock.calls[0][0]).toBe("a");
+    expect(keyboard.options.onChangeAll.mock.calls[0][0]).toMatchObject({"default": "a"});
+
+    expect(keyboard.options.onChange.mock.calls[1][0]).toBe("1");
+    expect(keyboard.options.onChangeAll.mock.calls[1][0]).toMatchObject({"default": "1"});
+    keyboard.destroy();
+  });

src/lib/components/tests/Keyboard.test.js

@@ -1,7 +1,17 @@
 import Keyboard from '../Keyboard';
-import { setDOM, clearDOM, testLayoutStdButtons, iterateButtons, triggerDocumentPointerUp, triggerDocumentPointerDown } from '../../../utils/TestUtility';
+import { setDOM, clearDOM, testLayoutStdButtons, triggerDocumentPointerUp } from '../../../utils/TestUtility';
+
+beforeEach(() => {
+  setDOM();
+});
+
+afterEach(() => {
+  clearDOM();
+});
 
 it('Keyboard will not render without target element', () => {
+  clearDOM();
+  
   try {
     new Keyboard();
     expect(true).toBe(false);
@@ -10,18 +20,29 @@ it('Keyboard will not render without target element', () => {
   }
 });
 
-it('Keyboard will run without options', () => {
-  // Prepare target DOM element
-  setDOM();
+describe('When window is undefined', () => {
+  const { window } = global;
+  beforeAll(() => {
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    delete global.window;
+  });
+  afterAll(() => {
+    global.window = window;
+  });
+  
+  it('Keyboard will return early if window is undefined', () => {
+    const keyboard = new Keyboard();
+    expect(keyboard.initialized).toBeUndefined();
+  });
+});
 
+it('Keyboard will run without options', () => {
   // No options
   new Keyboard();
 });
 
 it('Keyboard will run with empty options', () => {
-  // Prepare target DOM element
-  setDOM();
-
   // No options
   new Keyboard({});
 });
@@ -101,9 +122,7 @@ it('Keyboard setOptions will work without a param', () => {
 });
 
 it('Keyboard empty buttons wont do anything as expected', () => {
-  setDOM();
-
-  const keyboard = new Keyboard({
+    const keyboard = new Keyboard({
     layout: {
       default: [
         "{//} {button} d",
@@ -116,9 +135,7 @@ it('Keyboard empty buttons wont do anything as expected', () => {
 });
 
 it('Keyboard onKeyPress will work', () => {
-  setDOM();
-
-  let pressed = false;
+    let pressed = false;
 
   const keyboard = new Keyboard({
     onKeyPress: () => {
@@ -133,13 +150,11 @@ it('Keyboard onKeyPress will work', () => {
 });
 
 it('Keyboard standard function buttons will not change input', () => {
-  setDOM();
-
-  const keyboard = new Keyboard({
+    const keyboard = new Keyboard({
     useButtonTag: true
   });
 
-  iterateButtons((button) => {
+  keyboard.recurseButtons((button) => {
     if(button.getAttribute("data-skbtn") === "{shift}"){
       button.onclick();
     }
@@ -189,9 +204,7 @@ it('Keyboard syncInstanceInputs will work', () => {
 });
 
 it('Keyboard onChange will work', () => {
-  setDOM();
-
-  let output = false;
+    let output = false;
 
   const keyboard = new Keyboard({
     onChange: (input) => {
@@ -206,9 +219,7 @@ it('Keyboard onChange will work', () => {
 });
 
 it('Keyboard onChangeAll will work', () => {
-  setDOM();
-
-  let output;
+    let output;
 
   const keyboard = new Keyboard({
     onChangeAll: (input) => {
@@ -223,9 +234,7 @@ it('Keyboard onChangeAll will work', () => {
 });
 
 it('Keyboard clearInput will work', () => {
-  setDOM();
-
-  const keyboard = new Keyboard();
+    const keyboard = new Keyboard();
 
   /**
    * Avoid setInput for this test
@@ -267,9 +276,7 @@ it('Keyboard clearInput will work with syncInstanceInputs', () => {
 });
 
 it('Keyboard setInput will work', () => {
-  setDOM();
-
-  const keyboard = new Keyboard();
+    const keyboard = new Keyboard();
 
   keyboard.setInput("hello");
 
@@ -297,9 +304,7 @@ it('Keyboard setInput will work with syncInstanceInputs', () => {
 });
 
 it('Keyboard dispatch will work', () => {
-  setDOM();
-
-  document.body.innerHTML = `
+    document.body.innerHTML = `
     <div class="keyboard1"></div>
     <div class="keyboard2"></div>
   `;
@@ -322,9 +327,7 @@ it('Keyboard dispatch will work', () => {
 });
 
 it('Keyboard dispatch will not work without SimpleKeyboardInstances', () => {
-  setDOM();
-
-  document.body.innerHTML = `
+    document.body.innerHTML = `
     <div class="keyboard1"></div>
     <div class="keyboard2"></div>
   `;
@@ -353,27 +356,21 @@ it('Keyboard dispatch will not work without SimpleKeyboardInstances', () => {
 });
 
 it('Keyboard addButtonTheme will work', () => {
-  setDOM();
-
-  const keyboard = new Keyboard();
+    const keyboard = new Keyboard();
   keyboard.addButtonTheme("q", "test");
 
   expect(keyboard.options.buttonTheme[0].class).toBe("test");
 });
 
 it('Keyboard addButtonTheme will not work without params', () => {
-  setDOM();
-
-  const keyboard = new Keyboard();
+    const keyboard = new Keyboard();
   const returnVal = keyboard.addButtonTheme();
 
   expect(returnVal).toBeFalsy();
 });
 
 it('Keyboard addButtonTheme will amend a buttonTheme', () => {
-  setDOM();
-
-  const keyboard = new Keyboard({
+    const keyboard = new Keyboard({
     buttonTheme: [
       {
         class: "test",
@@ -388,9 +385,7 @@ it('Keyboard addButtonTheme will amend a buttonTheme', () => {
 });
 
 it('Keyboard addButtonTheme will create a buttonTheme', () => {
-  setDOM();
-
-  const keyboard = new Keyboard({
+    const keyboard = new Keyboard({
     buttonTheme: [
       {
         class: "blurb",
@@ -405,9 +400,7 @@ it('Keyboard addButtonTheme will create a buttonTheme', () => {
 });
 
 it('Keyboard addButtonTheme will ignore a repeated buttonTheme', () => {
-  setDOM();
-
-  const keyboard = new Keyboard({
+    const keyboard = new Keyboard({
     buttonTheme: [
       {
         class: "test",
@@ -422,9 +415,7 @@ it('Keyboard addButtonTheme will ignore a repeated buttonTheme', () => {
 });
 
 it('Keyboard addButtonTheme will amend a buttonTheme', () => {
-  setDOM();
-
-  const keyboard = new Keyboard({
+    const keyboard = new Keyboard({
     buttonTheme: [
       {
         class: "test",
@@ -440,9 +431,7 @@ it('Keyboard addButtonTheme will amend a buttonTheme', () => {
 
 
 it('Keyboard removeButtonTheme without params will remove all button themes', () => {
-  setDOM();
-
-  const keyboard = new Keyboard({
+    const keyboard = new Keyboard({
     buttonTheme: [
       {
         class: "test",
@@ -458,9 +447,7 @@ it('Keyboard removeButtonTheme without params will remove all button themes', ()
 
 
 it('Keyboard removeButtonTheme will work', () => {
-  setDOM();
-
-  const keyboard = new Keyboard({
+    const keyboard = new Keyboard({
     buttonTheme: [
       {
         class: "test",
@@ -475,9 +462,7 @@ it('Keyboard removeButtonTheme will work', () => {
 });
 
 it('Keyboard removeButtonTheme will work wihtout a class', () => {
-  setDOM();
-
-  const keyboard = new Keyboard({
+    const keyboard = new Keyboard({
     buttonTheme: [
       {
         class: "test",
@@ -492,9 +477,7 @@ it('Keyboard removeButtonTheme will work wihtout a class', () => {
 });
 
 it('Keyboard removeButtonTheme will do nothing without a button param', () => {
-  setDOM();
-
-  const keyboard = new Keyboard({
+    const keyboard = new Keyboard({
     buttonTheme: [
       {
         class: "test",
@@ -509,9 +492,7 @@ it('Keyboard removeButtonTheme will do nothing without a button param', () => {
 });
 
 it('Keyboard removeButtonTheme does nothing if req button doesnt have a buttonTheme', () => {
-  setDOM();
-
-  const keyboard = new Keyboard({
+    const keyboard = new Keyboard({
     buttonTheme: [
       {
         class: "test",
@@ -526,9 +507,7 @@ it('Keyboard removeButtonTheme does nothing if req button doesnt have a buttonTh
 });
 
 it('Keyboard removeButtonTheme does nothing if buttonTheme class does not exist', () => {
-  setDOM();
-
-  const keyboard = new Keyboard({
+    const keyboard = new Keyboard({
     buttonTheme: [
       {
         class: "testy",
@@ -543,9 +522,7 @@ it('Keyboard removeButtonTheme does nothing if buttonTheme class does not exist'
 });
 
 it('Keyboard removeButtonTheme does nothing if buttonTheme doesnt have the requested buttons', () => {
-  setDOM();
-
-  const keyboard = new Keyboard({
+    const keyboard = new Keyboard({
     buttonTheme: [
       {
         class: "test",
@@ -560,9 +537,7 @@ it('Keyboard removeButtonTheme does nothing if buttonTheme doesnt have the reque
 });
 
 it('Keyboard getButtonElement will not return anything if empty match', () => {
-  setDOM();
-
-  const keyboard = new Keyboard({
+    const keyboard = new Keyboard({
     layout: {
       default: [
         "{//} {button} d",
@@ -575,17 +550,13 @@ it('Keyboard getButtonElement will not return anything if empty match', () => {
 });
 
 it('Keyboard getButtonElement will return multiple matched buttons', () => {
-  setDOM();
-
-  const keyboard = new Keyboard();
+    const keyboard = new Keyboard();
 
   expect(keyboard.getButtonElement("{shift}").length).toBe(2);
 });
 
 it('Keyboard will receive physical keyboard events', () => {
-  setDOM();
-
-  new Keyboard({
+    new Keyboard({
     debug: true,
     physicalKeyboardHighlight: true
   });
@@ -602,9 +573,7 @@ it('Keyboard will receive physical keyboard events', () => {
 });
 
 it('Keyboard caretEventHandler will detect input, textarea focus', () => {
-  setDOM();
-
-  const keyboard = new Keyboard();
+    const keyboard = new Keyboard();
   const myInput = document.createElement('input');
 
   keyboard.caretEventHandler({
@@ -619,9 +588,7 @@ it('Keyboard caretEventHandler will detect input, textarea focus', () => {
 });
 
 it('Keyboard caretEventHandler will not set caretPosition on disableCaretPositioning', () => {
-  setDOM();
-
-  const keyboard = new Keyboard();
+    const keyboard = new Keyboard();
   const myInput = document.createElement('input');
 
   keyboard.caretEventHandler({
@@ -650,9 +617,7 @@ it('Keyboard caretEventHandler will not set caretPosition on disableCaretPositio
 });
 
 it('Keyboard caretEventHandler ignore positioning if input, textarea is blur', () => {
-  setDOM();
-
-  const keyboard = new Keyboard();
+    const keyboard = new Keyboard();
 
   keyboard.isMouseHold = true;
 
@@ -668,9 +633,7 @@ it('Keyboard caretEventHandler ignore positioning if input, textarea is blur', (
 });
 
 it('Keyboard caretEventHandler will work with debug', () => {
-  setDOM();
-
-  const keyboard = new Keyboard({
+    const keyboard = new Keyboard({
     debug: true
   });
 
@@ -693,9 +656,7 @@ it('Keyboard caretEventHandler will work with debug', () => {
 });
 
 it('Keyboard onInit will work', () => {
-  setDOM();
-
-  let passed = false;
+    let passed = false;
 
   new Keyboard({
     onInit: () => {
@@ -707,9 +668,7 @@ it('Keyboard onInit will work', () => {
 });
 
 it('Keyboard onRender will work', () => {
-  setDOM();
-
-  let passed = false;
+    let passed = false;
 
   new Keyboard({
     onRender: () => {
@@ -721,9 +680,7 @@ it('Keyboard onRender will work', () => {
 });
 
 it('Keyboard buttonTheme that is invalid will be ignored and not throw', () => {
-  setDOM();
-
-  new Keyboard({
+    new Keyboard({
     buttonTheme: [
       {
         class: null,
@@ -734,9 +691,7 @@ it('Keyboard buttonTheme that is invalid will be ignored and not throw', () => {
 });
 
 it('Keyboard buttonTheme buttons that are invalid will be ignored and not throw', () => {
-  setDOM();
-
-  new Keyboard({
+    new Keyboard({
     buttonTheme: [
       {
         class: null,
@@ -747,9 +702,7 @@ it('Keyboard buttonTheme buttons that are invalid will be ignored and not throw'
 });
 
 it('Keyboard buttonTheme will be ignored if buttons param not a string', () => {
-  setDOM();
-
-  new Keyboard({
+    new Keyboard({
     buttonTheme: [
       {
         class: "test",
@@ -762,9 +715,7 @@ it('Keyboard buttonTheme will be ignored if buttons param not a string', () => {
 });
 
 it('Keyboard buttonTheme will be ignored if already added', () => {
-  setDOM();
-
-  new Keyboard({
+    new Keyboard({
     buttonTheme: [
       {
         class: "test",
@@ -791,9 +742,7 @@ it('Keyboard buttonTheme will be ignored if already added', () => {
 });
 
 it('Keyboard can set a module', () => {
-  setDOM();
-
-  const keyboard = new Keyboard();
+    const keyboard = new Keyboard();
 
   keyboard.registerModule(
     "test",
@@ -806,9 +755,7 @@ it('Keyboard can set a module', () => {
 });
 
 it('Keyboard registerModule will return current module tree', () => {
-  setDOM();
-
-  const keyboard = new Keyboard();
+    const keyboard = new Keyboard();
 
   keyboard.modules.test = {
     testy: "test"
@@ -826,9 +773,7 @@ it('Keyboard registerModule will return current module tree', () => {
 });
 
 it('Keyboard can set a module by amending the modules tree', () => {
-  setDOM();
-
-  const keyboard = new Keyboard();
+    const keyboard = new Keyboard();
 
   keyboard.modules = {
     testman: {
@@ -847,17 +792,13 @@ it('Keyboard can set a module by amending the modules tree', () => {
 });
 
 it('Keyboard will not retrieve an option for an inexistent module', () => {
-  setDOM();
-
-  const keyboard = new Keyboard();
+    const keyboard = new Keyboard();
 
   expect(keyboard.getModuleProp("test", "foo")).toBeFalsy();
 });
 
 it('Keyboard will get a list of modules', () => {
-  setDOM();
-
-  const keyboard = new Keyboard();
+    const keyboard = new Keyboard();
 
   keyboard.registerModule(
     "test",
@@ -870,9 +811,7 @@ it('Keyboard will get a list of modules', () => {
 });
 
 it('Keyboard loadModules will load a simple module', () => {
-  setDOM();
-
-  class myClass {
+    class myClass {
     init = (module) => {
       module.foo = "bar";
     };
@@ -886,9 +825,7 @@ it('Keyboard loadModules will load a simple module', () => {
 });
 
 it('Keyboard handleButtonMouseUp will set isMouseHold to false', () => {
-  setDOM();
-
-  const keyboard = new Keyboard();
+    const keyboard = new Keyboard();
 
   keyboard.isMouseHold = true;
 
@@ -900,9 +837,7 @@ it('Keyboard handleButtonMouseUp will set isMouseHold to false', () => {
 });
 
 it('Keyboard handleButtonMouseUp clear holdInteractionTimeout', () => {
-  setDOM();
-
-  const keyboard = new Keyboard();
+    const keyboard = new Keyboard();
 
   keyboard.isMouseHold = true;
   keyboard.holdInteractionTimeout = setTimeout(() => {}, 10000);
@@ -913,9 +848,7 @@ it('Keyboard handleButtonMouseUp clear holdInteractionTimeout', () => {
 });
 
 it('Keyboard handleButtonMouseDown will work', () => {
-  setDOM();
-
-  const keyboard = new Keyboard({ useMouseEvents: true });
+    const keyboard = new Keyboard({ useMouseEvents: true });
 
   console.log(keyboard.getButtonElement("q"))
   keyboard.getButtonElement("q").onclick();
@@ -927,9 +860,7 @@ it('Keyboard handleButtonMouseDown will work', () => {
 });
 
 it('Keyboard handleButtonMouseDown will work with preventMouseDownDefault', () => {
-  setDOM();
-
-  const keyboard = new Keyboard({
+    const keyboard = new Keyboard({
     preventMouseDownDefault: true,
     stopMouseDownPropagation: true
   });
@@ -958,9 +889,7 @@ it('Keyboard handleButtonMouseDown will work with preventMouseDownDefault', () =
 });
 
 it('Keyboard handleButtonMouseUp will work with preventMouseUpDefault and stopMouseUpPropagation', () => {
-  setDOM();
-
-  const keyboard = new Keyboard({
+    const keyboard = new Keyboard({
     preventMouseUpDefault: true,
     stopMouseUpPropagation: true
   });
@@ -987,9 +916,7 @@ it('Keyboard handleButtonMouseUp will work with preventMouseUpDefault and stopMo
 });
 
 it('Keyboard onModulesLoaded will work', () => {
-  setDOM();
-
-  class myClass {
+    class myClass {
     init = (module) => {
       module.foo = "bar";
     };
@@ -1010,9 +937,7 @@ it('Keyboard onModulesLoaded will work', () => {
 });
 
 it('Keyboard inputPattern will work globally', () => {
-  setDOM();
-
-  const keyboard = new Keyboard({
+    const keyboard = new Keyboard({
     inputPattern: /^\d+$/,
     useMouseEvents: true
   });
@@ -1027,9 +952,7 @@ it('Keyboard inputPattern will work globally', () => {
 });
 
 it('Keyboard inputPattern will work by input name', () => {
-  setDOM();
-
-  const keyboard = new Keyboard({
+    const keyboard = new Keyboard({
     debug: true,
     inputName: "test1",
     inputPattern: {
@@ -1054,9 +977,7 @@ it('Keyboard inputPattern will work by input name', () => {
 });
 
 it('Keyboard processAutoTouchEvents will work', () => {
-  setDOM();
-
-  navigator.maxTouchPoints = true;
+    navigator.maxTouchPoints = true;
 
   const keyboard = new Keyboard({
     autoUseTouchEvents: true
@@ -1066,9 +987,7 @@ it('Keyboard processAutoTouchEvents will work', () => {
 });
 
 it('Keyboard processAutoTouchEvents will work with debugging enabled', () => {
-  setDOM();
-
-  navigator.maxTouchPoints = true;
+    navigator.maxTouchPoints = true;
 
   const keyboard = new Keyboard({
     autoUseTouchEvents: true,
@@ -1079,9 +998,7 @@ it('Keyboard processAutoTouchEvents will work with debugging enabled', () => {
 });
 
 it('Keyboard beforeFirstRender method will work', () => {
-  setDOM();
-
-  let timesCalled = 0;
+    let timesCalled = 0;
 
   const keyboard = new Keyboard({
     beforeFirstRender: () => {
@@ -1100,9 +1017,7 @@ it('Keyboard beforeFirstRender method will work', () => {
 });
 
 it('Keyboard beforeFirstRender will show PointerEvents warning', () => {
-  setDOM();
-
-  let timesCalled = 0;
+    let timesCalled = 0;
 
   window.PointerEvent = window.PointerEvent ? window.PointerEvent : () => {};
 
@@ -1117,9 +1032,7 @@ it('Keyboard beforeFirstRender will show PointerEvents warning', () => {
 });
 
 it('Keyboard beforeRender method will work', () => {
-  setDOM();
-
-  let timesCalled = 0;
+    let timesCalled = 0;
 
   const keyboard = new Keyboard({
     beforeRender: () => {
@@ -1138,9 +1051,7 @@ it('Keyboard beforeRender method will work', () => {
 });
 
 it('Keyboard parseRowDOMContainers will work', () => {
-  setDOM();
-
-  const keyboard = new Keyboard({
+    const keyboard = new Keyboard({
     layout: {
       'default': [
         '` [1 2 3 4 5 6 7 8 9] 0 - = {bksp}',
@@ -1171,9 +1082,7 @@ it('Keyboard parseRowDOMContainers will work', () => {
 });
 
 it('Keyboard parseRowDOMContainers will ignore empty rows', () => {
-  setDOM();
-
-  let failed = false;
+    let failed = false;
 
   try {
     const keyboard = new Keyboard();
@@ -1189,9 +1098,7 @@ it('Keyboard parseRowDOMContainers will ignore empty rows', () => {
 
 
 it('Keyboard parseRowDOMContainers will ignore missing endIndex or endIndex before startIndex', () => {
-  setDOM();
-
-  new Keyboard({
+    new Keyboard({
     layout: {
       'default': [
         '` [1 2 3 4 5 6 7 8 9 0 - = {bksp}',
@@ -1206,9 +1113,7 @@ it('Keyboard parseRowDOMContainers will ignore missing endIndex or endIndex befo
 });
 
 it('Keyboard disableRowButtonContainers will bypass parseRowDOMContainers', () => {
-  setDOM();
-
-  new Keyboard({
+    new Keyboard({
     disableRowButtonContainers: true,
     layout: {
       'default': [
@@ -1233,33 +1138,8 @@ it('Keyboard disableRowButtonContainers will bypass parseRowDOMContainers', () =
   expect(containers.length).toBe(0);
 });
 
-it('Keyboard inputName change will trigget caretPosition reset', () => {
-  setDOM();
-
-  const keyboard = new Keyboard();
-
-  keyboard.setCaretPosition(0);
-
-  keyboard.getButtonElement("q").onpointerdown();
-  keyboard.getButtonElement("1").onpointerdown();
-
-  expect(keyboard.getCaretPosition()).toBe(2);
-
-  keyboard.setOptions({
-    inputName: "myInput"
-  });
-
-  keyboard.getButtonElement("q").onpointerdown();
-  keyboard.getButtonElement("1").onpointerdown();
-  keyboard.getButtonElement("b").onpointerdown();
-
-  expect(keyboard.getCaretPosition()).toBe(null);
-});
-
 it('Keyboard destroy will work', () => {
-  setDOM();
-
-  const keyboard = new Keyboard();
+    const keyboard = new Keyboard();
   keyboard.destroy();
   expect(keyboard.keyboardDOM.innerHTML).toBe("");
 
@@ -1280,17 +1160,13 @@ it('Keyboard destroy will work', () => {
 });
 
 it('Keyboard destroy will work with debug option', () => {
-  setDOM();
-
-  const keyboard = new Keyboard({ debug: true });
+    const keyboard = new Keyboard({ debug: true });
   keyboard.destroy();
   expect(keyboard.keyboardDOM.innerHTML).toBe("");
 });
 
 it('Keyboard disableButtonHold will work', () => {
-  setDOM();
-
-  const keyboard = new Keyboard({
+    const keyboard = new Keyboard({
     disableButtonHold: true
   });
 
@@ -1298,9 +1174,7 @@ it('Keyboard disableButtonHold will work', () => {
 });
 
 it('Keyboard caretEventHandler will be triggered on mouseup and ontouchend', () => {
-  setDOM();
-
-  const keyboard = new Keyboard({
+    const keyboard = new Keyboard({
     disableCaretPositioning: true
   });
 
@@ -1323,9 +1197,7 @@ it('Keyboard caretEventHandler will be triggered on mouseup and ontouchend', ()
 });
 
 it('Keyboard onKeyReleased will work', () => {
-  setDOM();
-
-  let pressed = false;
+    let pressed = false;
   let firedTimes = 0;
   let buttonPressed;
 
@@ -1347,9 +1219,7 @@ it('Keyboard onKeyReleased will work', () => {
 });
 
 it('Keyboard buttonAttribute will work', () => {
-  setDOM();
-
-  new Keyboard({
+    new Keyboard({
     buttonAttributes: [
       {
         attribute: "aria-label",
@@ -1361,9 +1231,7 @@ it('Keyboard buttonAttribute will work', () => {
 });
 
 it('Keyboard buttonAttribute will warn about invalid entries', () => {
-  setDOM();
-
-  new Keyboard({
+    new Keyboard({
     buttonAttributes: [
       {
         attribute: false,
@@ -1376,7 +1244,7 @@ it('Keyboard buttonAttribute will warn about invalid entries', () => {
 it('Keyboard recurseButtons will not work without a valid param', () => {
   setDOM();
   const keyboard = new Keyboard();
-  expect(keyboard.recurseButtons()).toBe(false);
+  expect(keyboard.recurseButtons()).toBeFalsy();
 });
 
 it('Keyboard will not work with a DOM element param without class', () => {
@@ -1403,16 +1271,12 @@ it('Keyboard will work with a DOM element param with class', () => {
 });
 
 it('Keyboard handleKeyboardContainerMouseDown will work', () => {
-  setDOM();
-
-  const keyboard = new Keyboard();
+    const keyboard = new Keyboard();
   keyboard.keyboardDOM.onpointerdown();
 });
 
 it('Keyboard handleKeyboardContainerMouseDown will respect preventMouseDownDefault', () => {
-  setDOM();
-
-  let works = false;
+    let works = false;
   const keyboard = new Keyboard({ preventMouseDownDefault: true });
   keyboard.keyboardDOM.onpointerdown({ preventDefault: () => {
     works = true
@@ -1422,9 +1286,7 @@ it('Keyboard handleKeyboardContainerMouseDown will respect preventMouseDownDefau
 });
 
 it('Keyboard caret positioning will work', () => {
-  setDOM();
-
-  const keyboard = new Keyboard({
+    const keyboard = new Keyboard({
     onKeyPress: (button) => {
       if (button === "{shift}" || button === "{lock}") handleShift();
       else if (keyboard.options.layoutName === "shift") handleShift();
@@ -1449,4 +1311,44 @@ it('Keyboard caret positioning will work', () => {
   keyboard.getButtonElement("l").onpointerdown();
 
   expect(keyboard.getInput()).toBe("hEllo");
+});
+
+it('Keyboard excludeFromLayout will work', () => {
+  const keyboard = new Keyboard();
+
+  expect(keyboard.getButtonElement("a")).toBeDefined();
+
+  keyboard.setOptions({
+    excludeFromLayout: {
+      default: ["a"]
+    }
+  });
+
+  expect(keyboard.getButtonElement("a")).toBeUndefined();
+});
+
+it('Keyboard onSetOptions can be called without changedOptions param', () => {
+  const keyboard = new Keyboard();
+  expect(keyboard.onSetOptions()).toBeUndefined();
+});
+
+it('Keyboard will handle selected input with unchanged updatedInput edge case', () => {
+  const inputElem = document.createElement("input");
+  const onChange = jest.fn();
+  const keyboard = new Keyboard({ onChange });
+  
+  const initialValue = "3";
+  inputElem.value = initialValue;
+  inputElem.select();
+  keyboard.setInput(initialValue);
+  keyboard.activeInputElement = inputElem;
+  keyboard.setCaretPosition(0, 1);
+
+  keyboard.getButtonElement("3").onpointerdown();
+  keyboard.getButtonElement("3").onpointerdown();
+
+  expect(onChange).toBeCalledTimes(2);
+  expect(keyboard.getInput()).toBe("33");
+  expect(keyboard.getCaretPosition()).toBe(2);
+  expect(keyboard.getCaretPositionEnd()).toBe(2);
 });

src/lib/index.modern.ts

@@ -0,0 +1,2 @@
+import SimpleKeyboard from "./components/Keyboard";
+export default SimpleKeyboard;

src/lib/index.ts

@@ -0,0 +1,3 @@
+import "./polyfills";
+import SimpleKeyboard from "./components/Keyboard";
+export default SimpleKeyboard;

src/lib/interfaces.ts

@@ -1,20 +1,68 @@
-declare module 'simple-keyboard' {
-  interface KeyboardLayoutObject {
-    [key: string]: string[];
-  }
+/* eslint-disable no-unused-vars */
+import SimpleKeyboard from "./components/Keyboard";
+import Utilities from "./services/Utilities";
 
-  interface KeyboardButtonTheme {
+export interface KeyboardLayoutObject {
+    [key: string]: string[];
+}
+
+export type KeyboardButtonTheme = {
     class: string;
     buttons: string;
-  }
+} | null;
 
-  interface KeyboardButtonAttributes {
+export interface KeyboardButtonAttributes {
     attribute: string;
     value: string;
     buttons: string;
-  }
+}
 
-  interface KeyboardOptions {
+export interface KeyboardInput {
+    [key: string]: string
+}
+
+export type KeyboardParams = [KeyboardOptions] | [string | HTMLDivElement, KeyboardOptions];
+
+export type CandidateBoxParams = {
+    utilities: Utilities
+}
+
+export type CandidateBoxShowParams = {
+    candidateValue: string,
+    targetElement: KeyboardElement,
+    // eslint-disable-next-line no-unused-vars
+    onSelect: (selectedCandidate: string, e: MouseEvent) => void
+}
+
+export type CandidateBoxRenderParams = {
+    candidateListPages: string[][],
+    targetElement: KeyboardElement,
+    pageIndex: number;
+    nbPages: number;
+    // eslint-disable-next-line no-unused-vars
+    onItemSelected: (selectedCandidate: string, e: MouseEvent) => void
+}
+
+export type KeyboardElement = HTMLDivElement | HTMLButtonElement;
+export type KeyboardHandlerEvent = any;
+
+export interface KeyboardButtonElements {
+    [key: string]: KeyboardElement[]
+}
+
+export interface UtilitiesParams {
+    getOptions: () => KeyboardOptions;
+    getCaretPosition: () => number | null;
+    getCaretPositionEnd: () => number | null;
+    dispatch: any;
+}
+
+export interface PhysicalKeyboardParams {
+    getOptions: () => KeyboardOptions;
+    dispatch: any;
+}
+
+export interface KeyboardOptions {
     /**
      * Modify the keyboard layout.
      */
@@ -87,6 +135,28 @@ declare module 'simple-keyboard' {
      */
     physicalKeyboardHighlight?: boolean;
 
+    /**
+     * Calls handler for a button highlighted by physicalKeyboardHighlight
+     * In other words, this calls keyboard.handleButtonClicked(buttonName) on the highlighted button
+     */
+    physicalKeyboardHighlightPress?: boolean;
+
+    /**
+     * Trigger click on a button's element when using physicalKeyboardHighlightPress
+     * In other words, this calls button.click() on the highlighted button
+     */
+    physicalKeyboardHighlightPressUseClick?: boolean;
+
+    /**
+     * Define the text color that the physical keyboard highlighted key should have.
+     */
+    physicalKeyboardHighlightTextColor?: string;
+
+    /**
+     * Define the background color that the physical keyboard highlighted key should have.
+     */
+    physicalKeyboardHighlightBgColor?: string;
+
     /**
      * Calling preventDefault for the mousedown events keeps the focus on the input.
      */
@@ -107,16 +177,6 @@ declare module 'simple-keyboard' {
      */
     stopMouseUpPropagation?: boolean;
 
-    /**
-     * Define the text color that the physical keyboard highlighted key should have.
-     */
-    physicalKeyboardHighlightTextColor?: string;
-
-    /**
-     * Define the background color that the physical keyboard highlighted key should have.
-     */
-    physicalKeyboardHighlightBgColor?: string;
-
     /**
      * Render buttons as a button element instead of a div element.
      */
@@ -158,156 +218,47 @@ declare module 'simple-keyboard' {
     rtl?: boolean;
 
     /**
-     * Executes the callback function on key press. Returns button layout name (i.e.: "{shift}").
+     * Enable input method editor candidate list support.
      */
-    onKeyPress?: (button: string) => any;
+    enableLayoutCandidates?: boolean;
 
     /**
-     * Executes the callback function on key release.
+     * Character suggestions to be shown on certain key presses
      */
-    onKeyReleased?: (button: string) => any;
+    layoutCandidates?: { [key: string]: string };
 
     /**
-     * Executes the callback function on input change. Returns the current input's string.
+     * Exclude buttons from layout
      */
-    onChange?: (input: string) => any;
+    excludeFromLayout?: { [key: string]: string[] };
 
     /**
-     * Executes the callback function before the first simple-keyboard render.
+     * Determine size of layout candidate list
      */
-    beforeFirstRender?: () => void;
-
-    /**
-     * Executes the callback function before a simple-keyboard render.
-     */
-    beforeRender?: () => void;
+    layoutCandidatesPageSize?: number;
 
     /**
      * Executes the callback function every time simple-keyboard is rendered (e.g: when you change layouts).
      */
-    onRender?: () => void;
+     onRender?: (instance?: SimpleKeyboard) => void;
 
     /**
      * Executes the callback function once simple-keyboard is rendered for the first time (on initialization).
      */
-    onInit?: () => void;
+     onInit?: (instance?: SimpleKeyboard) => void;
 
     /**
-     * Executes the callback function on input change. Returns the input object with all defined inputs.
+     * Retrieves the current input
      */
-    onChangeAll?: (inputs: any) => any;
+    onChange?: (input: string, e?: MouseEvent) => any;
 
     /**
-     * Module classes to be loaded by simple-keyboard.
+     * Retrieves all inputs
      */
-    modules?: any[];
+    onChangeAll?: (inputObj: KeyboardInput, e?: MouseEvent) => any;
 
     /**
      * Module options can have any format
      */
     [name: string]: any;
-  }
-
-  class Keyboard {
-    constructor(selector: string, options: KeyboardOptions);
-    constructor(selector: HTMLDivElement, options: KeyboardOptions);
-    constructor(options: KeyboardOptions);
-
-    /**
-     * Options
-     */
-    options: KeyboardOptions;
-
-    /**
-     * Utilities
-     */
-    utilities?: any;
-
-    /**
-     * caretPosition
-     */
-    caretPosition?: number;
-
-
-    /**
-     * caretPositionEnd
-     */
-    caretPositionEnd?: number;
-
-    /**
-     * Changes the internal caret position
-     * @param {number} position The caret's start position
-     * @param {number} positionEnd The caret's end position
-     */
-    setCaretPosition(position: number, positionEnd?: number): void;
-
-    /**
-     * Retrieves the internal caret position
-     */
-    getCaretPosition(): number;
-
-    /**
-     * Retrieves the internal end caret position
-     */
-    getCaretPositionEnd(): number;
-
-    /**
-     * Adds/Modifies an entry to the `buttonTheme`. Basically a way to add a class to a button.
-     * @param  {string} buttons List of buttons to select (separated by a space).
-     * @param  {string} className Classes to give to the selected buttons (separated by space).
-     */
-    addButtonTheme(buttons: string, className: string): void;
-
-    /**
-     * Removes/Amends an entry to the `buttonTheme`. Basically a way to remove a class previously added to a button through buttonTheme or addButtonTheme.
-     * @param  {string} buttons List of buttons to select (separated by a space).
-     * @param  {string} className Classes to give to the selected buttons (separated by space).
-     */
-    removeButtonTheme(buttons: string, className: string): void;
-
-    /**
-     * Clear the keyboard's input.
-     *
-     * @param {string} [inputName] optional - the internal input to select
-     */
-    clearInput(inputName?: string): void;
-
-    /**
-     * Get the keyboard’s input (You can also get it from the onChange prop).
-     * @param  {string} [inputName] optional - the internal input to select
-     */
-    getInput(inputName?: string): string;
-
-    /**
-     * Set the keyboard’s input.
-     * @param  {string} input the input value
-     * @param  {string} inputName optional - the internal input to select
-     */
-    setInput(input: string, inputName?: string): void;
-
-    /**
-     * Set new option or modify existing ones after initialization.
-     * @param  {KeyboardOptions} option The option to set
-     */
-    setOptions(options: KeyboardOptions): void;
-
-    /**
-     * Send a command to all simple-keyboard instances at once (if you have multiple instances).
-     * @param  {function(instance: object, key: string)} callback Function to run on every instance
-     */
-    dispatch(callback: (instance: any, key: string) => void): void;
-
-    /**
-     * Get the DOM Element of a button. If there are several buttons with the same name, an array of the DOM Elements is returned.
-     * @param  {string} button The button layout name to select
-     */
-    getButtonElement(button: string): HTMLElement | HTMLElement[];
-
-    /**
-     * Clears keyboard listeners and DOM elements.
-     */
-    destroy(): void;
-  }
-
-  export default Keyboard;
-}
+}

src/lib/polyfills.js

@@ -0,0 +1,252 @@
+// element.remove() polyfill
+if (typeof Element !== "undefined" && !("remove" in Element.prototype)) {
+  Element.prototype["remove"] = function () {
+    if (this.parentNode) {
+      this.parentNode.removeChild(this);
+    }
+  };
+}
+
+/*
+ * classList.js: Cross-browser full element.classList implementation.
+ * 1.2.20171210
+ *
+ * By Eli Grey, http://eligrey.com
+ * License: Dedicated to the public domain.
+ *   See https://github.com/eligrey/classList.js/blob/master/LICENSE.md
+ */
+if (typeof self !== "undefined" && "document" in self) {
+  // Full polyfill for browsers with no classList support
+  // Including IE < Edge missing SVGElement.classList
+  if (
+    !("classList" in document.createElement("_")) ||
+    (document.createElementNS &&
+      !(
+        "classList" in
+        document.createElementNS("http://www.w3.org/2000/svg", "g")
+      ))
+  ) {
+    (function (view) {
+      "use strict";
+
+      if (!("Element" in view)) return;
+
+      var classListProp = "classList",
+        protoProp = "prototype",
+        elemCtrProto = view.Element[protoProp],
+        objCtr = Object,
+        strTrim =
+          String[protoProp].trim ||
+          function () {
+            return this.replace(/^\s+|\s+$/g, "");
+          },
+        arrIndexOf =
+          Array[protoProp].indexOf ||
+          function (item) {
+            var i = 0,
+              len = this.length;
+            for (; i < len; i++) {
+              if (i in this && this[i] === item) {
+                return i;
+              }
+            }
+            return -1;
+          },
+        // Vendors: please allow content code to instantiate DOMExceptions
+        DOMEx = function (type, message) {
+          this.name = type;
+          this.code = DOMException[type];
+          this.message = message;
+        },
+        checkTokenAndGetIndex = function (classList, token) {
+          if (token === "") {
+            throw new DOMEx("SYNTAX_ERR", "The token must not be empty.");
+          }
+          if (/\s/.test(token)) {
+            throw new DOMEx(
+              "INVALID_CHARACTER_ERR",
+              "The token must not contain space characters."
+            );
+          }
+          return arrIndexOf.call(classList, token);
+        },
+        ClassList = function (elem) {
+          var trimmedClasses = strTrim.call(elem.getAttribute("class") || ""),
+            classes = trimmedClasses ? trimmedClasses.split(/\s+/) : [],
+            i = 0,
+            len = classes.length;
+          for (; i < len; i++) {
+            this.push(classes[i]);
+          }
+          this._updateClassName = function () {
+            elem.setAttribute("class", this.toString());
+          };
+        },
+        classListProto = (ClassList[protoProp] = []),
+        classListGetter = function () {
+          return new ClassList(this);
+        };
+      // Most DOMException implementations don't allow calling DOMException's toString()
+      // on non-DOMExceptions. Error's toString() is sufficient here.
+      DOMEx[protoProp] = Error[protoProp];
+      classListProto.item = function (i) {
+        return this[i] || null;
+      };
+      classListProto.contains = function (token) {
+        return ~checkTokenAndGetIndex(this, token + "");
+      };
+      classListProto.add = function () {
+        var tokens = arguments,
+          i = 0,
+          l = tokens.length,
+          token,
+          updated = false;
+        do {
+          token = tokens[i] + "";
+          if (!~checkTokenAndGetIndex(this, token)) {
+            this.push(token);
+            updated = true;
+          }
+        } while (++i < l);
+
+        if (updated) {
+          this._updateClassName();
+        }
+      };
+      classListProto.remove = function () {
+        var tokens = arguments,
+          i = 0,
+          l = tokens.length,
+          token,
+          updated = false,
+          index;
+        do {
+          token = tokens[i] + "";
+          index = checkTokenAndGetIndex(this, token);
+          while (~index) {
+            this.splice(index, 1);
+            updated = true;
+            index = checkTokenAndGetIndex(this, token);
+          }
+        } while (++i < l);
+
+        if (updated) {
+          this._updateClassName();
+        }
+      };
+      classListProto.toggle = function (token, force) {
+        var result = this.contains(token),
+          method = result
+            ? force !== true && "remove"
+            : force !== false && "add";
+        if (method) {
+          this[method](token);
+        }
+
+        if (force === true || force === false) {
+          return force;
+        } else {
+          return !result;
+        }
+      };
+      classListProto.replace = function (token, replacement_token) {
+        var index = checkTokenAndGetIndex(token + "");
+        if (~index) {
+          this.splice(index, 1, replacement_token);
+          this._updateClassName();
+        }
+      };
+      classListProto.toString = function () {
+        return this.join(" ");
+      };
+
+      if (objCtr.defineProperty) {
+        var classListPropDesc = {
+          get: classListGetter,
+          enumerable: true,
+          configurable: true,
+        };
+        try {
+          objCtr.defineProperty(elemCtrProto, classListProp, classListPropDesc);
+        } catch (ex) {
+          // IE 8 doesn't support enumerable:true
+          // adding undefined to fight this issue https://github.com/eligrey/classList.js/issues/36
+          // modernie IE8-MSW7 machine has IE8 8.0.6001.18702 and is affected
+          if (ex.number === undefined || ex.number === -0x7ff5ec54) {
+            classListPropDesc.enumerable = false;
+            objCtr.defineProperty(
+              elemCtrProto,
+              classListProp,
+              classListPropDesc
+            );
+          }
+        }
+      } else if (objCtr[protoProp].__defineGetter__) {
+        elemCtrProto.__defineGetter__(classListProp, classListGetter);
+      }
+    })(self);
+  }
+
+  // There is full or partial native classList support, so just check if we need
+  // to normalize the add/remove and toggle APIs.
+
+  (function () {
+    "use strict";
+
+    var testElement = document.createElement("_");
+
+    testElement.classList.add("c1", "c2");
+
+    // Polyfill for IE 10/11 and Firefox <26, where classList.add and
+    // classList.remove exist but support only one argument at a time.
+    if (!testElement.classList.contains("c2")) {
+      var createMethod = function (method) {
+        var original = DOMTokenList.prototype[method];
+
+        DOMTokenList.prototype[method] = function (token) {
+          var i,
+            len = arguments.length;
+
+          for (i = 0; i < len; i++) {
+            token = arguments[i];
+            original.call(this, token);
+          }
+        };
+      };
+      createMethod("add");
+      createMethod("remove");
+    }
+
+    testElement.classList.toggle("c3", false);
+
+    // Polyfill for IE 10 and Firefox <24, where classList.toggle does not
+    // support the second argument.
+    if (testElement.classList.contains("c3")) {
+      var _toggle = DOMTokenList.prototype.toggle;
+
+      DOMTokenList.prototype.toggle = function (token, force) {
+        if (1 in arguments && !this.contains(token) === !force) {
+          return force;
+        } else {
+          return _toggle.call(this, token);
+        }
+      };
+    }
+
+    // replace() polyfill
+    if (!("replace" in document.createElement("_").classList)) {
+      DOMTokenList.prototype.replace = function (token, replacement_token) {
+        var tokens = this.toString().split(" "),
+          index = tokens.indexOf(token + "");
+        if (~index) {
+          tokens = tokens.slice(index);
+          this.remove.apply(this, tokens);
+          this.add(replacement_token);
+          this.add.apply(this, tokens.slice(1));
+        }
+      };
+    }
+
+    testElement = null;
+  })();
+}

src/lib/services/KeyboardLayout.ts

@@ -5,14 +5,14 @@ export const getDefaultLayout = () => {
       "{tab} q w e r t y u i o p [ ] \\",
       "{lock} a s d f g h j k l ; ' {enter}",
       "{shift} z x c v b n m , . / {shift}",
-      ".com @ {space}"
+      ".com @ {space}",
     ],
     shift: [
       "~ ! @ # $ % ^ & * ( ) _ + {bksp}",
       "{tab} Q W E R T Y U I O P { } |",
       '{lock} A S D F G H J K L : " {enter}',
       "{shift} Z X C V B N M < > ? {shift}",
-      ".com @ {space}"
-    ]
+      ".com @ {space}",
+    ],
   };
 };

src/lib/services/PhysicalKeyboard.js

@@ -1,92 +0,0 @@
-import Utilities from "../services/Utilities";
-
-/**
- * Physical Keyboard Service
- */
-class PhysicalKeyboard {
-  /**
-   * Creates an instance of the PhysicalKeyboard service
-   */
-  constructor({ dispatch, getOptions }) {
-    /**
-     * @type {object} A simple-keyboard instance
-     */
-    this.dispatch = dispatch;
-    this.getOptions = getOptions;
-
-    /**
-     * Bindings
-     */
-    Utilities.bindMethods(PhysicalKeyboard, this);
-  }
-
-  handleHighlightKeyDown(event) {
-    const options = this.getOptions();
-    const buttonPressed = this.getSimpleKeyboardLayoutKey(event);
-
-    this.dispatch(instance => {
-      const buttonDOM =
-        instance.getButtonElement(buttonPressed) ||
-        instance.getButtonElement(`{${buttonPressed}}`);
-
-      if (buttonDOM) {
-        buttonDOM.style.backgroundColor =
-          options.physicalKeyboardHighlightBgColor || "#dadce4";
-        buttonDOM.style.color =
-          options.physicalKeyboardHighlightTextColor || "black";
-      }
-    });
-  }
-
-  handleHighlightKeyUp(event) {
-    const buttonPressed = this.getSimpleKeyboardLayoutKey(event);
-
-    this.dispatch(instance => {
-      const buttonDOM =
-        instance.getButtonElement(buttonPressed) ||
-        instance.getButtonElement(`{${buttonPressed}}`);
-
-      if (buttonDOM && buttonDOM.removeAttribute) {
-        buttonDOM.removeAttribute("style");
-      }
-    });
-  }
-
-  /**
-   * Transforms a KeyboardEvent's "key.code" string into a simple-keyboard layout format
-   * @param  {object} event The KeyboardEvent
-   */
-  getSimpleKeyboardLayoutKey(event) {
-    let output;
-
-    if (
-      event.code.includes("Numpad") ||
-      event.code.includes("Shift") ||
-      event.code.includes("Space") ||
-      event.code.includes("Backspace") ||
-      event.code.includes("Control") ||
-      event.code.includes("Alt") ||
-      event.code.includes("Meta")
-    ) {
-      output = event.code;
-    } else {
-      output = event.key;
-    }
-
-    /**
-     * If button is not uppercase, casting to lowercase
-     */
-    if (
-      output !== output.toUpperCase() ||
-      (event.code[0] === "F" &&
-        Number.isInteger(Number(event.code[1])) &&
-        event.code.length <= 3)
-    ) {
-      output = output.toLowerCase();
-    }
-
-    return output;
-  }
-}
-
-export default PhysicalKeyboard;

src/lib/services/PhysicalKeyboard.ts

@@ -0,0 +1,211 @@
+import { KeyboardOptions, PhysicalKeyboardParams } from "../interfaces";
+import Utilities from "../services/Utilities";
+
+/**
+ * Physical Keyboard Service
+ */
+class PhysicalKeyboard {
+  getOptions: () => KeyboardOptions;
+  dispatch: any;
+
+  /**
+   * Creates an instance of the PhysicalKeyboard service
+   */
+  constructor({ dispatch, getOptions }: PhysicalKeyboardParams) {
+    /**
+     * @type {object} A simple-keyboard instance
+     */
+    this.dispatch = dispatch;
+    this.getOptions = getOptions;
+
+    /**
+     * Bindings
+     */
+    Utilities.bindMethods(PhysicalKeyboard, this);
+  }
+
+  handleHighlightKeyDown(event: KeyboardEvent) {
+    const options = this.getOptions();
+    const buttonPressed = this.getSimpleKeyboardLayoutKey(event);
+
+    this.dispatch((instance: any) => {
+      const standardButtonPressed = instance.getButtonElement(buttonPressed);
+      const functionButtonPressed = instance.getButtonElement(
+        `{${buttonPressed}}`
+      );
+      let buttonDOM;
+      let buttonName;
+
+      if (standardButtonPressed) {
+        buttonDOM = standardButtonPressed;
+        buttonName = buttonPressed;
+      } else if (functionButtonPressed) {
+        buttonDOM = functionButtonPressed;
+        buttonName = `{${buttonPressed}}`;
+      } else {
+        return;
+      }
+
+      if (buttonDOM) {
+        buttonDOM.style.backgroundColor =
+          options.physicalKeyboardHighlightBgColor || "#dadce4";
+        buttonDOM.style.color =
+          options.physicalKeyboardHighlightTextColor || "black";
+
+        if (options.physicalKeyboardHighlightPress) {
+          if (options.physicalKeyboardHighlightPressUseClick) {
+            buttonDOM.click();
+          } else {
+            instance.handleButtonClicked(buttonName, event);
+          }
+        }
+      }
+    });
+  }
+
+  handleHighlightKeyUp(event: KeyboardEvent) {
+    const buttonPressed = this.getSimpleKeyboardLayoutKey(event);
+
+    this.dispatch((instance: any) => {
+      const buttonDOM =
+        instance.getButtonElement(buttonPressed) ||
+        instance.getButtonElement(`{${buttonPressed}}`);
+
+      if (buttonDOM && buttonDOM.removeAttribute) {
+        buttonDOM.removeAttribute("style");
+      }
+    });
+  }
+
+  /**
+   * Transforms a KeyboardEvent's "key.code" string into a simple-keyboard layout format
+   * @param  {object} event The KeyboardEvent
+   */
+  getSimpleKeyboardLayoutKey(event: KeyboardEvent) {
+    let output = "";
+    const keyId = event.code || event.key || this.keyCodeToKey(event?.keyCode);
+
+    if (
+      keyId?.includes("Numpad") ||
+      keyId?.includes("Shift") ||
+      keyId?.includes("Space") ||
+      keyId?.includes("Backspace") ||
+      keyId?.includes("Control") ||
+      keyId?.includes("Alt") ||
+      keyId?.includes("Meta")
+    ) {
+      output = event.code || "";
+    } else {
+      output = event.key || this.keyCodeToKey(event?.keyCode) || "";
+    }
+
+    return output.length > 1 ? output?.toLowerCase() : output;
+  }
+
+  /**
+   * Retrieve key from keyCode
+   */
+  keyCodeToKey(keyCode: number) {
+    return {
+      8: "Backspace",
+      9: "Tab",
+      13: "Enter",
+      16: "Shift",
+      17: "Ctrl",
+      18: "Alt",
+      19: "Pause",
+      20: "CapsLock",
+      27: "Esc",
+      32: "Space",
+      33: "PageUp",
+      34: "PageDown",
+      35: "End",
+      36: "Home",
+      37: "ArrowLeft",
+      38: "ArrowUp",
+      39: "ArrowRight",
+      40: "ArrowDown",
+      45: "Insert",
+      46: "Delete",
+      48: "0",
+      49: "1",
+      50: "2",
+      51: "3",
+      52: "4",
+      53: "5",
+      54: "6",
+      55: "7",
+      56: "8",
+      57: "9",
+      65: "A",
+      66: "B",
+      67: "C",
+      68: "D",
+      69: "E",
+      70: "F",
+      71: "G",
+      72: "H",
+      73: "I",
+      74: "J",
+      75: "K",
+      76: "L",
+      77: "M",
+      78: "N",
+      79: "O",
+      80: "P",
+      81: "Q",
+      82: "R",
+      83: "S",
+      84: "T",
+      85: "U",
+      86: "V",
+      87: "W",
+      88: "X",
+      89: "Y",
+      90: "Z",
+      91: "Meta",
+      96: "Numpad0",
+      97: "Numpad1",
+      98: "Numpad2",
+      99: "Numpad3",
+      100: "Numpad4",
+      101: "Numpad5",
+      102: "Numpad6",
+      103: "Numpad7",
+      104: "Numpad8",
+      105: "Numpad9",
+      106: "NumpadMultiply",
+      107: "NumpadAdd",
+      109: "NumpadSubtract",
+      110: "NumpadDecimal",
+      111: "NumpadDivide",
+      112: "F1",
+      113: "F2",
+      114: "F3",
+      115: "F4",
+      116: "F5",
+      117: "F6",
+      118: "F7",
+      119: "F8",
+      120: "F9",
+      121: "F10",
+      122: "F11",
+      123: "F12",
+      144: "NumLock",
+      145: "ScrollLock",
+      186: ";",
+      187: "=",
+      188: ",",
+      189: "-",
+      190: ".",
+      191: "/",
+      192: "`",
+      219: "[",
+      220: "\\",
+      221: "]",
+      222: "'",
+    }[keyCode];
+  }
+}
+
+export default PhysicalKeyboard;

src/lib/services/Utilities.ts

@@ -1,11 +1,25 @@
+import { KeyboardInput } from "./../interfaces";
+import { KeyboardOptions, UtilitiesParams } from "../interfaces";
+
 /**
  * Utility Service
  */
 class Utilities {
+  getOptions: () => KeyboardOptions;
+  getCaretPosition: () => number | null;
+  getCaretPositionEnd: () => number | null;
+  dispatch: any;
+  maxLengthReached!: boolean;
+
   /**
    * Creates an instance of the Utility service
    */
-  constructor({ getOptions, getCaretPosition, getCaretPositionEnd, dispatch }) {
+  constructor({
+    getOptions,
+    getCaretPosition,
+    getCaretPositionEnd,
+    dispatch,
+  }: UtilitiesParams) {
     this.getOptions = getOptions;
     this.getCaretPosition = getCaretPosition;
     this.getCaretPositionEnd = getCaretPositionEnd;
@@ -17,17 +31,26 @@ class Utilities {
     Utilities.bindMethods(Utilities, this);
   }
 
+  /**
+   * Retrieve button type
+   *
+   * @param  {string} button The button's layout name
+   * @return {string} The button type
+   */
+  getButtonType(button: string): string {
+    return button.includes("{") && button.includes("}") && button !== "{//}"
+      ? "functionBtn"
+      : "standardBtn";
+  }
+
   /**
    * Adds default classes to a given button
    *
    * @param  {string} button The button's layout name
    * @return {string} The classes to be added to the button
    */
-  getButtonClass(button) {
-    const buttonTypeClass =
-      button.includes("{") && button.includes("}") && button !== "{//}"
-        ? "functionBtn"
-        : "standardBtn";
+  getButtonClass(button: string): string {
+    const buttonTypeClass = this.getButtonType(button);
     const buttonWithoutBraces = button.replace("{", "").replace("}", "");
     let buttonNormalized = "";
 
@@ -83,6 +106,7 @@ class Utilities {
       "{home}": "home",
       "{pageup}": "up",
       "{delete}": "del",
+      "{forwarddelete}": "del",
       "{end}": "end",
       "{pagedown}": "down",
       "{numpadmultiply}": "*",
@@ -100,7 +124,7 @@ class Utilities {
       "{numpad6}": "6",
       "{numpad7}": "7",
       "{numpad8}": "8",
-      "{numpad9}": "9"
+      "{numpad9}": "9",
     };
   }
   /**
@@ -110,7 +134,11 @@ class Utilities {
    * @param  {object} display The provided display option
    * @param  {boolean} mergeDisplay Whether the provided param value should be merged with the default one.
    */
-  getButtonDisplayName(button, display, mergeDisplay) {
+  getButtonDisplayName(
+    button: string,
+    display: KeyboardOptions["display"],
+    mergeDisplay: boolean
+  ) {
     if (mergeDisplay) {
       display = Object.assign({}, this.getDefaultDiplay(), display);
     } else {
@@ -130,14 +158,18 @@ class Utilities {
    * @param  {boolean} moveCaret Whether to update simple-keyboard's cursor
    */
   getUpdatedInput(
-    button,
-    input,
-    caretPos,
+    button: string,
+    input: string,
+    caretPos: number,
     caretPosEnd = caretPos,
     moveCaret = false
   ) {
     const options = this.getOptions();
-    const commonParams = [caretPos, caretPosEnd, moveCaret];
+    const commonParams: [number, number, boolean] = [
+      caretPos,
+      caretPosEnd,
+      moveCaret,
+    ];
 
     let output = input;
 
@@ -146,6 +178,11 @@ class Utilities {
       output.length > 0
     ) {
       output = this.removeAt(output, ...commonParams);
+    } else if (
+      (button === "{delete}" || button === "{forwarddelete}") &&
+      output.length > 0
+    ) {
+      output = this.removeForwardsAt(output, ...commonParams);
     } else if (button === "{space}")
       output = this.addStringAt(output, " ", ...commonParams);
     else if (
@@ -194,10 +231,10 @@ class Utilities {
    * @param  {number} length Represents by how many characters the input should be moved
    * @param  {boolean} minus Whether the cursor should be moved to the left or not.
    */
-  updateCaretPos(length, minus) {
+  updateCaretPos(length: number, minus = false) {
     const newCaretPos = this.updateCaretPosAction(length, minus);
 
-    this.dispatch(instance => {
+    this.dispatch((instance: any) => {
       instance.setCaretPosition(newCaretPos);
     });
   }
@@ -208,18 +245,20 @@ class Utilities {
    * @param  {number} length Represents by how many characters the input should be moved
    * @param  {boolean} minus Whether the cursor should be moved to the left or not.
    */
-  updateCaretPosAction(length, minus) {
+  updateCaretPosAction(length: number, minus = false) {
     const options = this.getOptions();
     let caretPosition = this.getCaretPosition();
 
-    if (minus) {
-      if (caretPosition > 0) caretPosition = caretPosition - length;
-    } else {
-      caretPosition = caretPosition + length;
+    if (caretPosition != null) {
+      if (minus) {
+        if (caretPosition > 0) caretPosition = caretPosition - length;
+      } else {
+        caretPosition = caretPosition + length;
+      }
     }
 
     if (options.debug) {
-      console.log("Caret at:", caretPosition, `(${this.keyboardDOMClass})`);
+      console.log("Caret at:", caretPosition);
     }
 
     return caretPosition;
@@ -234,8 +273,8 @@ class Utilities {
    * @param  {boolean} moveCaret Whether to update simple-keyboard's cursor
    */
   addStringAt(
-    source,
-    str,
+    source: string,
+    str: string,
     position = source.length,
     positionEnd = source.length,
     moveCaret = false
@@ -261,14 +300,20 @@ class Utilities {
   }
 
   /**
-   * Removes an amount of characters at a given position
+   * Check whether the button is a standard button
+   */
+  isStandardButton = (button: string) =>
+    button && !(button[0] === "{" && button[button.length - 1] === "}");
+
+  /**
+   * Removes an amount of characters before a given position
    *
    * @param  {string} source The source input
    * @param  {number} position The (cursor) position from where the characters should be removed
    * @param  {boolean} moveCaret Whether to update simple-keyboard's cursor
    */
   removeAt(
-    source,
+    source: string,
     position = source.length,
     positionEnd = source.length,
     moveCaret = false
@@ -314,7 +359,7 @@ class Utilities {
     } else {
       output = source.slice(0, position) + source.slice(positionEnd);
       if (moveCaret) {
-        this.dispatch(instance => {
+        this.dispatch((instance: any) => {
           instance.setCaretPosition(position);
         });
       }
@@ -322,16 +367,62 @@ class Utilities {
 
     return output;
   }
+
+  /**
+   * Removes an amount of characters after a given position
+   *
+   * @param  {string} source The source input
+   * @param  {number} position The (cursor) position from where the characters should be removed
+   */
+  removeForwardsAt(
+    source: string,
+    position: number = source.length,
+    positionEnd: number = source.length,
+    moveCaret = false
+  ) {
+    if (!source?.length || position === null) {
+      return source;
+    }
+
+    let output;
+
+    if (position === positionEnd) {
+      const emojiMatchedReg = /([\uD800-\uDBFF][\uDC00-\uDFFF])/g;
+
+      /**
+       * Emojis are made out of two characters, so we must take a custom approach to trim them.
+       * For more info: https://mathiasbynens.be/notes/javascript-unicode
+       */
+      const nextTwoChars = source.substring(position, position + 2);
+      const emojiMatched = nextTwoChars.match(emojiMatchedReg);
+
+      if (emojiMatched) {
+        output = source.substr(0, position) + source.substr(position + 2);
+      } else {
+        output = source.substr(0, position) + source.substr(position + 1);
+      }
+    } else {
+      output = source.slice(0, position) + source.slice(positionEnd);
+      if (moveCaret) {
+        this.dispatch((instance: any) => {
+          instance.setCaretPosition(position);
+        });
+      }
+    }
+
+    return output;
+  }
+
   /**
    * Determines whether the maxLength has been reached. This function is called when the maxLength option it set.
    *
    * @param  {object} inputObj
    * @param  {string} updatedInput
    */
-  handleMaxLength(inputObj, updatedInput) {
+  handleMaxLength(inputObj: KeyboardInput, updatedInput: string) {
     const options = this.getOptions();
     const maxLength = options.maxLength;
-    const currentInput = inputObj[options.inputName];
+    const currentInput = inputObj[options.inputName || "default"];
     const condition = updatedInput.length - 1 >= maxLength;
 
     if (
@@ -362,7 +453,8 @@ class Utilities {
     }
 
     if (typeof maxLength === "object") {
-      const condition = currentInput.length === maxLength[options.inputName];
+      const condition =
+        updatedInput.length - 1 >= maxLength[options.inputName || "default"];
 
       if (options.debug) {
         console.log("maxLength (obj) reached:", condition);
@@ -396,14 +488,14 @@ class Utilities {
    * Determines whether pointer events are supported
    */
   pointerEventsSupported() {
-    return window.PointerEvent;
+    return !!window.PointerEvent;
   }
 
   /**
    * Bind all methods in a given class
    */
 
-  static bindMethods(myClass, instance) {
+  static bindMethods(myClass: any, instance: any) {
     // eslint-disable-next-line no-unused-vars
     for (const myMethod of Object.getOwnPropertyNames(myClass.prototype)) {
       const excludeMethod =
@@ -419,8 +511,8 @@ class Utilities {
    *
    * @param  {string} str The string to transform.
    */
-  camelCase(str) {
-    if (!str) return false;
+  camelCase(str: string): string {
+    if (!str) return "";
 
     return str
       .toLowerCase()
@@ -430,6 +522,20 @@ class Utilities {
         word.length ? str + word[0].toUpperCase() + word.slice(1) : str
       );
   }
+
+  /**
+   * Split array into chunks
+   */
+  chunkArray<T>(arr: T[], size: number): T[][] {
+    return [...Array(Math.ceil(arr.length / size))].map((_, i) =>
+      arr.slice(size * i, size + size * i)
+    );
+  }
+
+  /**
+   * Reusable empty function
+   */
+  static noop = () => {};
 }
 
 export default Utilities;

src/lib/services/tests/PhysicalKeyboard.test.js

@@ -113,4 +113,113 @@ it('PhysicalKeyboard will work with F1-F12 keys', () => {
       tagName: "input"
     }
   }));
+});
+
+it('PhysicalKeyboard will work with physicalKeyboardHighlightPress', () => {
+  setDOM();
+
+  new Keyboard({
+    physicalKeyboardHighlight: true,
+    physicalKeyboardHighlightPress: true,
+    debug: true
+  });
+
+  document.dispatchEvent(new KeyboardEvent('keydown', {
+    code: "KeyF",
+    key: "f",
+    target: {
+      tagName: "input"
+    }
+  }));
+
+  document.dispatchEvent(new KeyboardEvent('keyup', {
+    code: "KeyF",
+    key: "f",
+    target: {
+      tagName: "input"
+    }
+  }));
+});
+
+it('PhysicalKeyboard will work with physicalKeyboardHighlightPress (touch)', () => {
+  setDOM();
+
+  new Keyboard({
+    physicalKeyboardHighlight: true,
+    physicalKeyboardHighlightPress: true,
+    useTouchEvents: true,
+    debug: true
+  });
+
+  document.dispatchEvent(new KeyboardEvent('keydown', {
+    code: "KeyF",
+    key: "f",
+    target: {
+      tagName: "input"
+    }
+  }));
+
+  document.dispatchEvent(new KeyboardEvent('keyup', {
+    code: "KeyF",
+    key: "f",
+    target: {
+      tagName: "input"
+    }
+  }));
+});
+
+it('PhysicalKeyboard with physicalKeyboardHighlightPress can trigger noop', () => {
+  setDOM();
+
+  const keyboard = new Keyboard({
+    physicalKeyboardHighlight: true,
+    physicalKeyboardHighlightPress: true,
+    useTouchEvents: true,
+    debug: true
+  });
+
+  keyboard.getButtonElement('f').onmousedown = null;
+  keyboard.getButtonElement('f').onpointerdown = null;
+  keyboard.getButtonElement('f').ontouchstart = null;
+
+  document.dispatchEvent(new KeyboardEvent('keydown', {
+    code: "KeyF",
+    key: "f",
+    target: {
+      tagName: "input"
+    }
+  }));
+
+  keyboard.getButtonElement('f').onmouseup = null;
+  keyboard.getButtonElement('f').onpointerup = null;
+  keyboard.getButtonElement('f').ontouchend = null;
+
+  document.dispatchEvent(new KeyboardEvent('keyup', {
+    code: "KeyF",
+    key: "f",
+    target: {
+      tagName: "input"
+    }
+  }));
+});
+
+it('PhysicalKeyboard keyCodeToKey will work', () => {
+  setDOM();
+
+  const keyboard = new Keyboard({
+    physicalKeyboardHighlight: true
+  });
+
+  expect(keyboard.physicalKeyboard.keyCodeToKey(186)).toBe(";");
+
+  const methodTest = spyOn(keyboard.physicalKeyboard, "keyCodeToKey");
+
+  document.dispatchEvent(new KeyboardEvent('keyup', {
+    keyCode: 186,
+    target: {
+      tagName: "input"
+    }
+  }));
+
+  expect(methodTest).toBeCalledWith(186);
 });

src/lib/services/tests/Utilities.test.js

@@ -17,11 +17,11 @@ it('Keyboard mergeDisplay will work', () => {
 it('Keyboard function buttons will work', () => {
   setDOM();
 
-  new Keyboard();
+  const keyboard = new Keyboard();
   
-  testLayoutFctButtons((fctBtnCount, fctBtnHasOnclickCount) => {
+  testLayoutFctButtons(keyboard, (fctBtnCount, fctBtnHasOnclickCount) => {
     expect(fctBtnCount).toBe(fctBtnHasOnclickCount);
-  });
+  }, keyboard);
 });
 
 it('Keyboard {bksp} button will work', () => {
@@ -34,6 +34,16 @@ it('Keyboard {bksp} button will work', () => {
   expect(output).toBe("tes");
 });
 
+it('Keyboard {delete} button will work', () => {
+  setDOM();
+
+  const keyboard = new Keyboard();
+
+  const output = keyboard.utilities.getUpdatedInput("{delete}", "test", 1);
+  
+  expect(output).toBe("tst");
+});
+
 it('Keyboard {space} button will work', () => {
   setDOM();
 
@@ -585,3 +595,167 @@ it('Keyboard camelCase will work with empty strings', () => {
   const keyboard = new Keyboard();
   expect(keyboard.utilities.camelCase()).toBeFalsy();
 });
+
+it('Keyboard removeForwardsAt will exit out on caretPosition:0', () => {
+  setDOM();
+
+  const keyboard = new Keyboard();
+
+  keyboard.setInput("test");
+
+  keyboard.setCaretPosition(0);
+  keyboard.utilities.removeForwardsAt(keyboard.getInput(), 0);
+  expect(keyboard.getInput()).toBe("test");
+
+  keyboard.setInput("test");
+
+  keyboard.setCaretPosition(5);
+  keyboard.utilities.removeForwardsAt(keyboard.getInput(), 0, 0, true);
+  expect(keyboard.caretPosition).toBe(5);
+});
+
+it('Keyboard removeForwardsAt will remove multi-byte unicodes with caretPos>0', () => {
+  setDOM();
+
+  const keyboard = new Keyboard();
+
+  keyboard.setCaretPosition(4);
+  let output = keyboard.utilities.removeForwardsAt("test\uD83D\uDE00", 4, 4);
+  expect(output).toBe("test");
+
+  keyboard.setCaretPosition(4);
+  output = keyboard.utilities.removeForwardsAt("test\uD83D\uDE00", 4, 4, true);
+  expect(keyboard.caretPosition).toBe(4);
+});
+
+it('Keyboard removeForwardsAt will not remove multi-byte unicodes with caretPos:0', () => {
+  setDOM();
+
+  const str = "\uD83D\uDE00";
+  const keyboard = new Keyboard();
+  let output = keyboard.utilities.removeForwardsAt(str, 0);
+  expect(output).toBe("");
+
+  output = keyboard.utilities.removeForwardsAt(str, 0, 0, true);
+  expect(output).toBe("");
+});
+
+it('Keyboard removeForwardsAt will propagate caretPosition', () => {
+  clearDOM();
+
+  document.body.innerHTML = `
+    <div class="simple-keyboard"></div>
+    <div class="keyboard2"></div>
+  `;
+
+  const keyboard = new Keyboard({
+    useMouseEvents: true,
+    layout: {
+      default: ["{delete}"]
+    }
+  });
+  const keyboard2 = new Keyboard('.keyboard2');
+
+  keyboard.input.default = "hello";
+  keyboard2.input.default = "world"
+  
+  keyboard.setCaretPosition(1);
+  expect(keyboard.getCaretPosition()).toBe(1);
+  expect(keyboard.getCaretPositionEnd()).toBe(1);
+  
+  keyboard.setCaretPosition(1, 3);
+  expect(keyboard.getCaretPosition()).toBe(1);
+  expect(keyboard.getCaretPositionEnd()).toBe(3);
+
+  keyboard.getButtonElement('{delete}').onclick();
+  
+  expect(keyboard.getCaretPosition()).toBe(1);
+  expect(keyboard2.getCaretPosition()).toBe(1);
+
+  expect(keyboard.getInput()).toBe('hlo');
+  expect(keyboard.getCaretPositionEnd()).toBe(1);
+  expect(keyboard2.getCaretPositionEnd()).toBe(1);
+});
+
+it('Keyboard removeForwardsAt will propagate caretPosition in a syncInstanceInputs setting', () => {
+  clearDOM();
+
+  document.body.innerHTML = `
+    <div class="simple-keyboard"></div>
+    <div class="keyboard2"></div>
+  `;
+
+  const keyboard = new Keyboard({
+    useMouseEvents: true,
+    syncInstanceInputs: true,
+    layout: {
+      default: ["{delete}"]
+    }
+  });
+  const keyboard2 = new Keyboard('.keyboard2');
+
+  keyboard.input.default = "hello"
+  
+  keyboard.setCaretPosition(1);
+  expect(keyboard.getCaretPosition()).toBe(1);
+  expect(keyboard.getCaretPositionEnd()).toBe(1);
+  
+  keyboard.setCaretPosition(1, 3);
+  expect(keyboard.getCaretPosition()).toBe(1);
+  expect(keyboard.getCaretPositionEnd()).toBe(3);
+
+  keyboard.getButtonElement('{delete}').onclick();
+  
+  expect(keyboard.getCaretPosition()).toBe(1);
+  expect(keyboard2.getCaretPosition()).toBe(1);
+
+  expect(keyboard.getInput()).toBe('hlo');
+  expect(keyboard.getCaretPositionEnd()).toBe(1);
+  expect(keyboard2.getCaretPositionEnd()).toBe(1);
+});
+
+it('Keyboard removeForwardsAt will remove regular strings', () => {
+  setDOM();
+
+  const keyboard = new Keyboard({
+    debug: true
+  });
+
+  keyboard.setCaretPosition(6);
+  let output = keyboard.utilities.removeForwardsAt("testie", 5, 5);
+  expect(output).toBe("testi");
+
+  keyboard.setCaretPosition(5);
+  output = keyboard.utilities.removeForwardsAt("testie", 5, 5, true);
+  expect(keyboard.caretPosition).toBe(5);
+});
+
+it('Keyboard removeForwardsAt will work with unset or start caretPosition', () => {
+  setDOM();
+
+  const keyboard = new Keyboard({
+    debug: true
+  });
+
+  let output = keyboard.utilities.removeForwardsAt("test", 3);
+  expect(output).toBe("tes");
+
+  output = keyboard.utilities.removeForwardsAt("test", null, null);
+  expect(output).toBe("test");
+
+  output = keyboard.utilities.removeForwardsAt("😀", 0);
+  expect(output).toBe("");
+
+  /**
+   * Will also work with moveCaret
+   */
+  output = keyboard.utilities.removeForwardsAt("test", null, null, true);
+  expect(output).toBe("test");
+  expect(keyboard.getCaretPosition()).toBe(null);
+
+  keyboard.setCaretPosition(2);
+  const str = "😀";
+  output = keyboard.utilities.removeForwardsAt(str, null, null, true);
+  expect(output).toBe(str);
+  expect(keyboard.getCaretPosition()).toBe(2);
+});

src/setupTests.js

@@ -1,5 +0,0 @@
-// jest-dom adds custom jest matchers for asserting on DOM nodes.
-// allows you to do things like:
-// expect(element).toHaveTextContent(/react/i)
-// learn more: https://github.com/testing-library/jest-dom
-import '@testing-library/jest-dom/extend-expect';

src/utils/TestUtility.js

@@ -44,7 +44,7 @@
     let stdBtnCount = 0;
     let fullInput = '';
 
-    iterateButtons((button) => {
+    keyboard.recurseButtons((button) => {
       const label = button.getAttribute("data-skbtn");
 
       if(label.includes("{"))
@@ -89,11 +89,11 @@
   /**
    * Test if function buttons are interactive (have an onclick)
    */
-  export const testLayoutFctButtons = (callback) => {
+  export const testLayoutFctButtons = (keyboard, callback) => {
     let fctBtnCount = 0;
     let fctBtnHasOnclickCount = 0;
 
-    iterateButtons((button) => {
+    keyboard.recurseButtons((button) => {
       const label = button.getAttribute("data-skbtn");
 
       if(!label.includes("{") && !label.includes("}"))
@@ -110,19 +110,6 @@
     });
   }
 
-  /**
-   * Iterates on the keyboard buttons
-   */
-  export const iterateButtons = (callback, selector) => {
-    const rows = document.body.querySelector(selector || '.simple-keyboard').children;
-
-    Array.from(rows).forEach(row => {
-      Array.from(row.children).forEach((button) => {
-        callback(button);
-      });
-    });
-  }
-
   /**
    * Remove RTL control chars
    */

tsconfig.json

@@ -0,0 +1,19 @@
+{
+    "compilerOptions": {
+      "noImplicitAny": true,
+      "outDir": "build/types",
+      "module": "esnext",
+      "target": "es5",
+      "allowJs": true,
+      "sourceMap": true,
+      "declaration": true,
+      "emitDeclarationOnly": true,
+      "suppressImplicitAnyIndexErrors": true,
+      "lib": ["es2020", "dom"],
+      "moduleResolution": "node",
+      "downlevelIteration": true,
+      "strict": true
+    },
+    "include": ["src/lib"],
+    "exclude": ["src/lib/**/tests"],
+}

webpack.config.demo.js

@@ -0,0 +1,51 @@
+const MiniCssExtractPlugin = require("mini-css-extract-plugin");
+const HtmlWebpackPlugin = require('html-webpack-plugin');
+
+module.exports = {
+  mode: "development",
+  devtool: 'cheap-module-source-map',
+  entry: './src/demo/index.js',
+  output: {
+    filename: 'index.js'
+  },
+  optimization: {
+    minimize: false,
+  },
+  devServer: {
+    open: true,
+    hot: true,
+    host: "localhost",
+    port: 9000
+  },
+  module: {
+    rules: [
+      {
+        test: /\.(m|j|t)s$/,
+        exclude: /(node_modules|bower_components)/,
+        use: {
+          loader: 'babel-loader'
+        }
+      },
+      {
+        test: /\.(sa|sc|c)ss$/,
+        use: [
+          MiniCssExtractPlugin.loader,
+          { loader: "css-loader", options: { sourceMap: true } },
+        ],
+      },
+      {
+        test: /\.(png|jpe?g|gif|svg|eot|ttf|woff|woff2)$/,
+        use: ['url-loader'],
+      }
+    ]
+  },
+  plugins: [
+    new MiniCssExtractPlugin({
+      filename: 'css/index.css'
+    }),
+    new HtmlWebpackPlugin(),
+  ],
+  resolve: {
+    extensions: ['.ts', '.js', '.json']
+  }
+};

webpack.config.js

@@ -0,0 +1,100 @@
+const path = require('path');
+const webpack = require('webpack');
+const PrettierPlugin = require("prettier-webpack-plugin");
+const TerserPlugin = require('terser-webpack-plugin');
+const getPackageJson = require('./scripts/getPackageJson');
+const MiniCssExtractPlugin = require("mini-css-extract-plugin");
+const OptimizeCSSAssetsPlugin = require("optimize-css-assets-webpack-plugin");
+
+const {
+  version,
+  name,
+  license,
+  repository,
+  author,
+} = getPackageJson('version', 'name', 'license', 'repository', 'author');
+
+const banner = `
+  ${name} v${version}
+  ${repository.url}
+
+  Copyright (c) ${author.replace(/ *<[^)]*> */g, " ")} and project contributors.
+
+  This source code is licensed under the ${license} license found in the
+  LICENSE file in the root directory of this source tree.
+`;
+
+module.exports = {
+  mode: "production",
+  entry: './src/lib/index.ts',
+  target: 'es5',
+  output: {
+    filename: 'index.js',
+    path: path.resolve(__dirname, 'build'),
+    library: "SimpleKeyboard",
+    libraryTarget: 'umd',
+    clean: true,
+    globalObject: 'this',
+    environment: {
+      arrowFunction: false
+    }
+  },
+  optimization: {
+    minimize: true,
+    minimizer: [
+      new TerserPlugin({ extractComments: false }),
+      new OptimizeCSSAssetsPlugin()
+    ],
+  },
+  devServer: {
+    open: true,
+    hot: true,
+    host: "localhost",
+    static: path.join(__dirname, 'demo'),
+    port: 9000
+  },
+  module: {
+    rules: [
+      {
+        test: /\.m?(j|t)s$/,
+        exclude: /(node_modules|bower_components)/,
+        use: {
+          loader: 'babel-loader'
+        }
+      },
+      {
+        test: /\.(sa|sc|c)ss$/,
+        use: [
+          MiniCssExtractPlugin.loader,
+          { loader: "css-loader" },
+          {
+            loader: "postcss-loader",
+            options: {
+              postcssOptions: {
+                plugins: [
+                  [
+                    "autoprefixer"
+                  ],
+                ],
+              },
+            },
+          },
+        ],
+      },
+      {
+        test: /\.(png|jpe?g|gif|svg|eot|ttf|woff|woff2)$/,
+        use: ['url-loader'],
+      }
+    ]
+  },
+  plugins: [
+    new PrettierPlugin(),
+    new MiniCssExtractPlugin({
+        filename: 'css/index.css'
+    }),
+    new webpack.BannerPlugin(banner)
+  ],
+  resolve: {
+    extensions: ['.ts', '.js', '.json']
+  }
+};

webpack.config.modern.js

@@ -0,0 +1,75 @@
+/**
+ * Config to support modern browsers only (build/index.modern.js)
+ */
+const path = require('path');
+const webpack = require('webpack');
+const TerserPlugin = require('terser-webpack-plugin');
+const getPackageJson = require('./scripts/getPackageJson');
+
+const {
+  version,
+  name,
+  license,
+  repository,
+  author,
+} = getPackageJson('version', 'name', 'license', 'repository', 'author');
+
+const banner = `
+  ${name} v${version} (index.modern.js - Modern Browsers bundle)
+  ${repository.url}
+
+  NOTE: This modern browsers bundle (index.modern.js) removes all polyfills
+  included in the standard version. Use this if you are supporting
+  modern browsers only. Otherwise, use the standard version (index.js).
+
+  Copyright (c) ${author.replace(/ *<[^)]*> */g, " ")} and project contributors.
+
+  This source code is licensed under the ${license} license found in the
+  LICENSE file in the root directory of this source tree.
+`;
+
+module.exports = {
+  mode: "production",
+  entry: './src/lib/index.modern.ts',
+  target: 'es5',
+  output: {
+    filename: 'index.modern.js',
+    path: path.resolve(__dirname, 'build'),
+    library: "SimpleKeyboard",
+    libraryTarget: 'umd',
+    globalObject: 'this'
+  },
+  optimization: {
+    minimize: true,
+    minimizer: [
+      new TerserPlugin({ extractComments: false }),
+    ],
+  },
+  module: {
+    rules: [
+      {
+        test: /\.m?(j|t)s$/,
+        exclude: /(node_modules|bower_components)/,
+        use: {
+          loader: 'babel-loader',
+          options: {
+            presets: [
+              ["@babel/env"]
+            ],
+            plugins: [
+              ["@babel/plugin-proposal-class-properties"],
+              ["@babel/plugin-transform-typescript"]
+            ]
+          }
+        }
+      }
+    ]
+  },
+  plugins: [
+    new webpack.IgnorePlugin({ resourceRegExp: /\.(sa|sc|c)ss$/ }),
+    new webpack.BannerPlugin(banner)
+  ],
+  resolve: {
+    extensions: ['.ts', '.js', '.json']
+  }
+};