[pull] master from crowdin:master

.docs-config/styles.css

@@ -0,0 +1,47 @@
+:root {
+    /* Light */
+    --light-color-background: #fcfcfc;
+    --light-color-secondary-background: #fff;
+    --light-color-text: #263238;
+    --light-color-text-aside: #707070;
+    --light-color-link: #4da6ff;
+    --light-color-menu-divider: #eee;
+    --light-color-menu-divider-focus: #000;
+    --light-color-menu-label: #707070;
+    --light-color-panel: var(--light-color-secondary-background);
+    --light-color-panel-divider: #eee;
+    --light-color-comment-tag: #707070;
+    --light-color-comment-tag-text: #fff;
+    --light-color-ts: #43a047;
+    --light-color-ts-interface: #647f1b;
+    --light-color-ts-enum: #937210;
+    --light-color-ts-class: #2196f3;
+    --light-color-ts-private: #707070;
+    --light-color-toolbar: #fff;
+    --light-color-toolbar-text: #333;
+    --light-icon-filter: invert(0);
+    --light-external-icon: url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100' width='10' height='10'><path fill-opacity='0' stroke='%23000' stroke-width='10' d='m43,35H5v60h60V57M45,5v10l10,10-30,30 20,20 30-30 10,10h10V5z'/></svg>");
+
+    /* Dark */
+    --dark-color-background: #36393f;
+    --dark-color-secondary-background: #2f3136;
+    --dark-color-text: #ffffff;
+    --dark-color-text-aside: #e6e4e4;
+    --dark-color-link: #00aff4;
+    --dark-color-menu-divider: #eee;
+    --dark-color-menu-divider-focus: #000;
+    --dark-color-menu-label: #707070;
+    --dark-color-panel: var(--dark-color-secondary-background);
+    --dark-color-panel-divider: #818181;
+    --dark-color-comment-tag: #dcddde;
+    --dark-color-comment-tag-text: #2f3136;
+    --dark-color-ts: #c97dff;
+    --dark-color-ts-interface: #9cbe3c;
+    --dark-color-ts-enum: #d6ab29;
+    --dark-color-ts-class: #3695f3;
+    --dark-color-ts-private: #e2e2e2;
+    --dark-color-toolbar: #34373c;
+    --dark-color-toolbar-text: #ffffff;
+    --dark-icon-filter: invert(1);
+    --dark-external-icon: url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100' width='10' height='10'><path fill-opacity='0' stroke='%23fff' stroke-width='10' d='m43,35H5v60h60V57M45,5v10l10,10-30,30 20,20 30-30 10,10h10V5z'/></svg>");
+}

.docs-config/typedoc.json

@@ -0,0 +1,10 @@
+{
+  "entryPoints": ["../src/index.ts"],
+  "out": "../docs",
+  "customCss": "styles.css",
+  "excludeInternal": true,
+  "excludeProtected": true,
+  "excludeExternals": true,
+  "excludePrivate": true,
+  "hideGenerator": true
+}

.eslintrc

@@ -21,6 +21,7 @@
         "curly": 2,
 		"semi": 2,
 		"brace-style": 2,
-        "quotes": [2, "single", "avoid-escape"]
+        "quotes": [2, "single", "avoid-escape"],
+        "prefer-rest-params": "off"
     }
 }

.github/dependabot.yml

@@ -0,0 +1,15 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "npm" # See documentation for possible values 
+    directory: "/" # Location of package manifests
+    target-branch: "master"
+    schedule:
+      interval: "weekly"
+    ignore:
+      - dependency-name: "*" #All the dependency it gonna ignore for major update
+        update-types: [ "version-update:semver-major" ]

.github/workflows/basic.yml

@@ -0,0 +1,104 @@
+name: Tests
+
+on:
+  pull_request:
+    branches:
+      - 'master'
+  push:
+    branches:
+      - '*'
+    paths-ignore:
+      - 'README.md'
+      - 'LICENSE'
+      - 'CODE_OF_CONDUCT.md'
+      - 'CONTRIBUTING.md'
+
+jobs:
+  tests:
+    strategy:
+      matrix:
+        node-version: [ 16.x, 18.x ]
+        os: [ ubuntu-latest, windows-latest, macos-latest ]
+
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Cache node modules
+        uses: actions/cache@v4
+        env:
+          cache-name: cache-node-modules
+        with:
+          path: ~/.npm
+          key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-build-${{ env.cache-name }}-
+            ${{ runner.os }}-build-
+            ${{ runner.os }}-
+
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+
+      - name: Print NPM version
+        run: npm -v
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Build
+        run: npm run build
+
+      - name: Tests
+        run: npm run test
+
+      - name: Publish Dry Run
+        run: npm publish --dry-run
+
+  code-coverage:
+    runs-on: ubuntu-latest
+    needs: tests
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Cache node modules
+        uses: actions/cache@v4
+        env:
+          cache-name: cache-node-modules
+        with:
+          path: ~/.npm
+          key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-build-${{ env.cache-name }}-
+            ${{ runner.os }}-build-
+            ${{ runner.os }}-
+
+      - name: Use Node.js 16.x
+        uses: actions/setup-node@v4
+        with:
+          node-version: 16.x
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Lint
+        run: npm run lint-ci
+
+      - name: Generate code coverage report
+        run: npm run test-coverage
+
+      - name: Test Report
+        uses: dorny/test-reporter@v1
+        if: ${{ (success() || failure()) && github.ref == 'refs/heads/master' }}
+        with:
+          name: Test results
+          path: junit.xml
+          reporter: jest-junit
+
+      - name: Upload coverage report to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}

.github/workflows/dependency-analysis.yml

@@ -0,0 +1,15 @@
+name: Dependency Analysis
+
+on:
+  push:
+    branches:
+      - master
+  schedule:
+    - cron: '0 0 * * MON'
+  workflow_dispatch:
+
+jobs:
+  dependency-analysis:
+    uses: crowdin/.github/.github/workflows/dependency-analysis.yml@main
+    secrets:
+      FOSSA_API_KEY: ${{ secrets.FOSSA_API_KEY }}

.github/workflows/docs.yml

@@ -0,0 +1,31 @@
+name: Documentation
+
+on:
+  release:
+    types: [published]
+  repository_dispatch:
+    types: [publish]
+
+jobs:
+  build-and-deploy-docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 16
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Generate docs
+        run: npm run generate-docs
+
+      - name: Deploy 🚀
+        uses: JamesIves/github-pages-deploy-action@v4
+        with:
+          branch: gh-pages
+          folder: docs

.github/workflows/lint-pr-title.yml

@@ -0,0 +1,18 @@
+name: lint-pr-title
+
+on:
+  pull_request_target:
+    types:
+      - opened
+      - reopened
+      - edited
+      - synchronize
+
+jobs:
+  main:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: amannn/action-semantic-pull-request@v5
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/publish.yml

@@ -0,0 +1,41 @@
+name: Publish
+
+on:
+  release:
+    types: [published]
+  repository_dispatch:
+    types: [publish]
+  workflow_dispatch:
+
+jobs:
+  publish-npm:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 18
+          registry-url: https://registry.npmjs.org/
+
+      - name: Install npm CLI
+        run: npm install -g npm@latest
+
+      - name: Install dependencies and build
+        run: |
+          npm -v
+          npm ci
+          npm run build
+
+      - name: Publish Dry Run
+        run: |
+          npm publish --dry-run
+
+      - name: Publish the package
+        run: |
+          npm publish --provenance
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.github/workflows/release.yml

@@ -0,0 +1,29 @@
+name: Release
+run-name: Release ${{ github.event.inputs.version }} version
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        type: choice
+        description: Version
+        options:
+          - patch
+          - minor
+          - major
+
+jobs:
+  version:
+    permissions:
+      contents: write
+    uses: crowdin/.github/.github/workflows/bump-version.yml@main
+
+  publish:
+    runs-on: ubuntu-latest
+    needs: version
+    permissions:
+      contents: write
+    steps:
+      - uses: peter-evans/repository-dispatch@v3
+        with:
+          event-type: publish

.gitignore

@@ -4,4 +4,6 @@ node_modules
 coverage
 junit.xml
 .vscode
-sandbox.js
+sandbox.js
+docs
+.DS_Store

.npmignore

@@ -4,7 +4,14 @@ tests
 .vscode
 .eslint
 .prettierrc
+.idea
+coverage
+junit.xml
+sandbox.js
 jestconfig.json
 tsconfig.json
 yarn.lock
-node_modules
+node_modules
+docs
+.docs-config
+.github

.release-it.json

@@ -0,0 +1,17 @@
+{
+  "git": {
+    "push": true,
+    "commit": true,
+    "commitMessage": "chore: version ${version} [skip ci]",
+    "requireBranch": "master",
+    "tag": true
+  },
+  "github": {
+    "release": true,
+    "autoGenerate": true,
+    "releaseName": "${version}"
+  },
+  "npm": {
+    "publish": false
+  }
+}