Version 1.2.0

Bumps [rollup](https://github.com/rollup/rollup) from 2.53.1 to 2.53.2.
- [Release notes](https://github.com/rollup/rollup/releases)
- [Changelog](https://github.com/rollup/rollup/blob/master/CHANGELOG.md)
- [Commits](https://github.com/rollup/rollup/compare/v2.53.1...v2.53.2)

---
updated-dependencies:
- dependency-name: rollup
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,38 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

README.md

@@ -1,12 +1,17 @@
 # Alphabets
 
 [![CI](https://github.com/garraflavatra/alphabets/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/garraflavatra/alphabets/actions/workflows/test.yml)
+[![npm](https://img.shields.io/npm/v/alphabets)](https://www.npmjs.com/package/alphabets)
+[![npm bundle size](https://img.shields.io/bundlephobia/min/alphabets)](https://www.npmjs.com/package/alphabets)
+[![GitHub last commit](https://img.shields.io/github/last-commit/garraflavatra/alphabets)](https://github.com/garraflavatra/alphabets)
+[![Forum](https://img.shields.io/badge/-forum-blue)](https://github.com/garraflavatra/alphabets)
+
 
 A tiny JS dependency (<2kb!) which exports many alphabets for many use
 cases.
 
 More information is available in the
-[documentation](https://alphabets.romeinvanburen.nl).
+[documentation](https://projects.romeinvanburen.nl/alphabets/).
 
 ## Why would I use this?
 
@@ -85,4 +90,5 @@ Usage: see [Usage](#usage).
 | Icelandic | `icelandic` |
 | Latin | `latin` |
 | Norwegian | `norwegian` |
+| Russian | `russian` |
 | Swedish | `swedish` |

docs/CNAME

@@ -1 +0,0 @@
-alphabets.romeinvanburen.nl

docs/Gemfile.lock

@@ -7,7 +7,7 @@ GEM
       minitest (~> 5.1)
       tzinfo (~> 1.1)
       zeitwerk (~> 2.2, >= 2.2.2)
-    addressable (2.7.0)
+    addressable (2.8.0)
       public_suffix (>= 2.0.2, < 5.0)
     coffee-script (2.4.1)
       coffee-script-source
@@ -225,6 +225,8 @@ GEM
       racc (~> 1.4)
     nokogiri (1.11.5-x86_64-darwin)
       racc (~> 1.4)
+    nokogiri (1.11.5-x86_64-linux)
+      racc (~> 1.4)
     octokit (4.21.0)
       faraday (>= 0.9)
       sawyer (~> 0.8.0, >= 0.5.3)
@@ -267,6 +269,7 @@ GEM
 
 PLATFORMS
   universal-darwin-20
+  x86_64-linux
 
 DEPENDENCIES
   github-pages

docs/_config.yml

@@ -35,4 +35,6 @@ defaults:
     values:
       layout: single
       toc: true
+      sidebar:
+        nav: "docs"
     

docs/_data/navigation.yml

@@ -1,3 +1,25 @@
 main:
+  - title: "Forums"
+    url: https://github.com/garraflavatra/alphabets/discussions
   - title: "GitHub"
     url: https://github.com/garraflavatra/alphabets
+
+docs:
+  - title: About
+    children:
+      - title: Why would I use this?
+        url: /about/why
+      - title: Alternatives
+        url: /about/alternatives
+  - title: Usage
+    children:
+      - title: Installation
+        url: /usage/installation
+      - title: Usage
+        url: /usage/usage
+      - title: Advanced
+        url: /usage/advanced
+  - title: API
+    children:
+      - title: Supported alphabets
+        url: /api/supported-alphabets

docs/about/alternatives.md

@@ -0,0 +1,29 @@
+---
+title: Alternatives to Alphabets
+---
+
+Know more alternatives? Please open an
+[issue](https://github.com/garraflavatra/alphabet.js/issues/new) or 
+[pull request](https://github.com/garraflavatra/alphabet.js)!
+{: .notice--info}
+
+## [alphabet](https://www.npmjs.com/package/alphabet)
+
+(whithout trailing `s`)
+
+I do not say this package doesn't work. I think it will work perfectly, but it
+has less features:
+{: .notice--warning}
+
+Seems a good alternative, right? But:
+
+* It only supports the Latin alphabet.
+* It is larger. (The size is equal to this package's size, but this package
+  includes more.)
+* It is only [CommonJS](https://en.wikipedia.org/wiki/CommonJS) and not 
+  [ECMAScript](https://en.wikipedia.org/wiki/ECMAScript) etc.
+* When did the author last update it? Right.
+  <figure>
+    <img src="https://projects.romeinvanburen.nl/alphabets/images/competitors/alphabet-last-publish.png" alt="Last updated: 6 years ago">
+    <figcaption>Hmmm...</figcaption>
+  </figure>

docs/about/why.md

@@ -0,0 +1,44 @@
+---
+title: Why would I use this?
+---
+
+I have seen developers doing this:
+
+```js
+const alphabet = 'abcdefghijklmnopqrstuvwxyz'.split('');
+```
+
+Or worse:
+
+```js
+const alphabet = ["a", "b", "c", "d", "e", "f", "g", "h", "i", "j", "k", "l", "m", "n", "o", "p", "q", "r", "s", "t", "u", "v", "w", "x", "y", "z"];
+```
+
+My opinion about this? 🙄. It's ugly, it makes your code less readable
+(read: ugly) and it's simply not something you should want to have in your 
+code! Instead, you should do it like so:
+
+```js
+import { latin } from 'alphabets';
+// or
+const alphabets = require('alphabets');
+```
+
+Much cleaner, right? That's why I made this package.
+
+## Why not?
+
+I see very few reasons not to use this package.
+
+### But doesn't it cost me performance?
+
+No. This package is only <800 bytes so it should not cost you any performance.
+Neither via [CDN](/usage/installation/#cdn) nor if you use a bundler like
+webpack, Parcel or Rollup.
+
+### Why not making an array on my own?
+
+It's a choice. This whole package is **opinionated**. *I* think you should not
+do `const alphabet = 'abcdefghijklmnopqrstuvwxyz'.split('');` in your code. *I*
+think you should use a package for that. Do you think it's OK to define your own
+alphabet array? Do that!

docs/api/supported-alphabets.md

@@ -0,0 +1,18 @@
+---
+title: Supported alphabets
+toc: false
+---
+
+Usage: see [Usage](#usage).
+
+| Name | Export name |
+|------|-------------|
+| Danish | `danish` |
+| Faroese | `faroese` |
+| Greek (modern) | `greek` |
+| Greek (ancient/polytonic) | `greekPolytonic` |
+| Icelandic | `icelandic` |
+| Latin | `latin` |
+| Norwegian | `norwegian` |
+| Russian | `russian` |
+| Swedish | `swedish` |

docs/index.md

@@ -1,133 +1,16 @@
 ---
 title: Alphabets
+toc: false
 ---
 
-A tiny JS dependency (<2kb!) which exports many alphabets for many use
+A tiny JS dependency (<2kb!) which exports many alphabet arrays for many use
 cases.
 
 [![CI](https://github.com/garraflavatra/alphabets/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/garraflavatra/alphabets/actions/workflows/test.yml)
+[![npm](https://img.shields.io/npm/v/alphabets)](https://www.npmjs.com/package/alphabets)
+[![npm bundle size](https://img.shields.io/bundlephobia/min/alphabets)](https://www.npmjs.com/package/alphabets)
+[![GitHub last commit](https://img.shields.io/github/last-commit/garraflavatra/alphabets)](https://github.com/garraflavatra/alphabets)
+[![Forum](https://img.shields.io/badge/-forum-blue)](https://github.com/garraflavatra/alphabets)
 
-## Why would I use this?
+Are you convinced [why to use this](about/why)? Get started
-
+[here](usage/installation)!
-### Why?
-
-I have seen developers doing this:
-
-```js
-const alphabet = 'abcdefghijklmnopqrstuvwxyz'.split('');
-```
-
-Or worse:
-
-```js
-const alphabet = ["a", "b", "c", "d", "e", "f", "g", "h", "i", "j", "k", "l", "m", "n", "o", "p", "q", "r", "s", "t", "u", "v", "w", "x", "y", "z"];
-```
-
-My opinion about this? 🙄. It's ugly, it makes your code less readable
-(read: ugly) and it's simply not something you should want to have in your 
-code! Instead, you should do it like so:
-
-```js
-import { latin } from 'alphabets';
-// or
-const alphabets = require('alphabets');
-```
-
-Much cleaner, right? That's why I made this package.
-
-### Why not?
-
-I see very few reasons not to use this package.
-
-#### But doesn't it cost me performance?
-
-No. This package is only <800 bytes so it should not cost you any performance.
-Neither via CDN nor if you use a bundler like webpack, Parcel or Rollup.
-
-#### Why not making an array on my own?
-
-It's a choice. This whole package is **opinionated**. *I* think you should not
-do `const alphabet = 'abcdefghijklmnopqrstuvwxyz'.split('');` in your code. *I*
-think you should use a package for that. Do you think it's OK to define your own
-alphabet array? Do that!
-
-### Competitors
-
-Know more alternatives? Please open an
-[issue](https://github.com/garraflavatra/alphabet.js/issues/new) or 
-[pull request](https://github.com/garraflavatra/alphabet.js)!
-{: .notice--info}
-
-#### [alphabet](https://www.npmjs.com/package/alphabet)
-
-Seems a good alternative, right? But:
-
-* It only supports the Latin alphabet.
-* It is larger. (The size is equal to this package's size, but this package
-  includes more.)
-* It is only [CommonJS](https://en.wikipedia.org/wiki/CommonJS) and not 
-  [ECMAScript](https://en.wikipedia.org/wiki/ECMAScript) etc.
-* When did the author last update it? Right.
-  <figure>
-    <img src="/images/competitors/alphabet-last-publish.png" alt="Last updated: 6 years ago">
-    <figcaption>Hmmm...</figcaption>
-  </figure>
-
-I do not say this package doesn't work. I think it will work perfectly, but it
-has less features.
-{: .notice--warning}
-
-## Usage
-
-### Installation
-
-Use npm:
-
-```bash
-npm install alphabets --save
-```
-
-Or if you prefer Yarn:
-
-```bash
-yarn add alphabets
-```
-
-CDN, if that's more your style:
-
-```html
-<script src="https://unpkg.com/alphabet@1/dist/bundle.js"></script>
-```
-
-### Usage
-
-```js
-import { <alphabetYouWantToUse> } from 'alphabets';
-```
-
-or:
-
-```js
-const alphabets = require('alphabets');
-console.log(alphabets.<alphabetYouWantToUse>);
-```
-
-where `<alphabetYouWantToUse>` is an alphabet this package supports.
-[Here](#supported-alphabets) is a list from which you can choose.
-
-## API
-
-### Supported alphabets
-
-Usage: see [Usage](#usage).
-
-| Name | Export name |
-|------|-------------|
-| Danish | `danish` |
-| Faroese | `faroese` |
-| Greek (modern) | `greek` |
-| Greek (ancient/polytonic) | `greekPolytonic` |
-| Icelandic | `icelandic` |
-| Latin | `latin` |
-| Norwegian | `norwegian` |
-| Swedish | `swedish` |

docs/usage/advanced.md

@@ -0,0 +1,17 @@
+---
+title: Advanced usage
+---
+
+## Alphabet as a string
+
+```js
+alphabet.join('')[0];
+//=> 'abcdefghijklmnopqrstuvwxyz'
+```
+
+## Uppercase
+
+```js
+alphabet.toUpperCase();
+//=> ["Α", "Β", "Γ", "Δ", "Ε", "Ζ", "Η", "Θ", "Ι", "Κ", "Λ", "Μ", "Ν", "Ξ", "Ο", "Π", "Ρ", "Σ", "Τ", "Υ", "Φ", "Χ", "Ψ", "Ω"]
+```

docs/usage/installation.md

@@ -0,0 +1,21 @@
+---
+title: Installation
+---
+
+## npm
+
+```bash
+npm install alphabets --save
+```
+
+## Yarn
+
+```bash
+yarn add alphabets
+```
+
+## CDN
+
+```html
+<script src="https://unpkg.com/alphabet@1/dist/bundle.js"></script>
+```

docs/usage/usage.md

@@ -0,0 +1,18 @@
+---
+title: Usage
+toc: false
+---
+
+```js
+import { <alphabetYouWantToUse> } from 'alphabets';
+```
+
+or:
+
+```js
+const alphabets = require('alphabets');
+console.log(alphabets.<alphabetYouWantToUse>);
+```
+
+where `<alphabetYouWantToUse>` is an alphabet this package supports.
+[Here](/api/supported-alphabets) is a list from which you can choose.

package.json

@@ -1,6 +1,6 @@
 {
   "name": "alphabets",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Exports many alphabets for many use cases",
   "main": "dist/bundle.js",
   "scripts": {
@@ -11,14 +11,14 @@
   "keywords": [],
   "author": "Romein van Buren <romein@vburen.eu>",
   "license": "MIT",
-  "homepage": "https://alphabets.romeinvanburen.nl",
+  "homepage": "https://projects.romeinvanburen.nl/alphabets/",
   "repository": {
     "type": "git",
     "url": "https://github.com/garraflavatra/alphabets.git"
   },
   "devDependencies": {
-    "husky": "^6.0.0",
+    "husky": "^7.0.1",
-    "jest": "^26.6.3",
+    "jest": "^27.0.1",
     "rollup": "^2.49.0",
     "rollup-plugin-clear": "^2.0.7",
     "rollup-plugin-terser": "^7.0.2"

src/main.js

@@ -1,12 +1,13 @@
-export const danish = ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z', 'æ', 'ø', 'å'];
+export const danish = ["a", "b", "c", "d", "e", "f", "g", "h", "i", "j", "k", "l", "m", "n", "o", "p", "q", "r", "s", "t", "u", "v", "w", "x", "y", "z", "æ", "ø", "å"];
-export const elfadian = ['a', 'ą', 'b', 'd', 'ð', 'e', 'ę', 'f', 'g', 'h', 'i', 'į', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'r', 's', 't', 'u', 'ų', 'v', 'w', 'y', 'y̨', 'å', 'ą̊', 'ä', 'ö'];
+export const elfadian = ["a", "ą", "b", "d", "ð", "e", "ę", "f", "g", "h", "i", "į", "j", "k", "l", "m", "n", "o", "p", "r", "s", "t", "u", "ų", "v", "w", "y", "y̨", "å", "ą̊", "ä", "ö"];
-export const faroese = ['a', 'á', 'b', 'd', 'ð', 'e', 'f', 'g', 'h', 'i', 'í', 'j', 'k', 'l', 'm', 'n', 'o', 'ó', 'p', 'r', 's', 't', 'u', 'ú', 'v', 'y', 'ý', 'æ', 'ø'];
+export const faroese = ["a", "á", "b", "d", "ð", "e", "f", "g", "h", "i", "í", "j", "k", "l", "m", "n", "o", "ó", "p", "r", "s", "t", "u", "ú", "v", "y", "ý", "æ", "ø"];
 export const greek = ["α", "β", "γ", "δ", "ε", "ζ", "η", "θ", "ι", "κ", "λ", "μ", "ν", "ξ", "ο", "π", "ρ", "σ", "τ", "υ", "φ", "χ", "ψ", "ω"];
 export const greekPolytonic = ["α", "β", "γ", "δ", "ε", "ζ", "η", "θ", "ι", "κ", "λ", "μ", "ν", "ξ", "ο", "π", "ρ", "σ", "τ", "υ", "φ", "χ", "ψ", "ω"];
-export const icelandic = ['a', 'á', 'b', 'd', 'ð', 'e', 'é', 'f', 'g', 'h', 'i', 'í', 'j', 'k', 'l', 'm', 'n', 'o', 'ó', 'p', 'r', 's', 't', 'u', 'ú', 'v', 'x', 'y', 'ý', 'þ', 'æ', 'ö'];
+export const icelandic = ["a", "á", "b", "d", "ð", "e", "é", "f", "g", "h", "i", "í", "j", "k", "l", "m", "n", "o", "ó", "p", "r", "s", "t", "u", "ú", "v", "x", "y", "ý", "þ", "æ", "ö"];
 export const latin = ["a", "b", "c", "d", "e", "f", "g", "h", "i", "j", "k", "l", "m", "n", "o", "p", "q", "r", "s", "t", "u", "v", "w", "x", "y", "z"];
-export const norwegian = ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z', 'æ', 'ø', 'å'];
+export const norwegian = ["a", "b", "c", "d", "e", "f", "g", "h", "i", "j", "k", "l", "m", "n", "o", "p", "q", "r", "s", "t", "u", "v", "w", "x", "y", "z", "æ", "ø", "å"];
-export const swedish = ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z', 'å', 'ä', 'ö'];
+export const russian = ["а", "б", "в", "г", "д", "е", "ё", "ж", "з", "и", "й", "к", "л", "м", "н", "о", "п", "р", "с", "т", "у", "ф", "х", "ц", "ч", "ш", "щ", "ъ", "ы", "ь", "э", "ю", "я"];
+export const swedish = ["a", "b", "c", "d", "e", "f", "g", "h", "i", "j", "k", "l", "m", "n", "o", "p", "q", "r", "s", "t", "u", "v", "w", "x", "y", "z", "å", "ä", "ö"];
 
 export default [
   danish,
@@ -17,5 +18,6 @@ export default [
   icelandic,
   latin,
   norwegian,
+  russian,
   swedish,
 ];