Generate docs with @2gis/ts-docs-generator (#41)

* Generate docs with @2gis/ts-docs-generator

* Try to fix test job

* Migrate to @2gis/ts-docs-generator

* Update workflow

* Bump @2gis/ts-docs-generator

* Remove redundant env

* Allow openssl legacy

* Bump jest-dev-server, fix test on updated node

---------

Co-authored-by: Dmitry Nishcheta <nish.dima@gmail.com>

Author: dnischeta

.github/workflows/prettier-check.yml

@@ -9,6 +9,6 @@ jobs:
             - uses: actions/checkout@v3
             - uses: actions/setup-node@v3
               with:
-                  node-version: 16
+                  node-version: 18
             - run: npm ci
             - run: npm run prettier

.github/workflows/release.yml

@@ -13,10 +13,11 @@ jobs:
       - uses: actions/checkout@v2
       - uses: actions/setup-node@v2
         with:
-          node-version: 16
+          node-version: 18
           registry-url: https://registry.npmjs.org/
       - run: npm ci
       - run: npm run build
       - run: npm publish --access public
         env:
+          VERSION: $GITHUB_REF_NAME
           NODE_AUTH_TOKEN: ${{secrets.npm_token}}

.github/workflows/test.yml

@@ -14,10 +14,10 @@ jobs:
             - uses: actions/checkout@v3
             - uses: actions/setup-node@v3
               with:
-                  node-version: 16
+                  node-version: 18
             - run: npm ci
             - run: npm run test:screenshots
-            - uses: actions/upload-artifact@v3
+            - uses: actions/upload-artifact@v4
               if: ${{ failure() }}
               with:
                   path: test/screenshots/__screenshots__/**/__diff_output__/*.png

build/docs.js

@@ -0,0 +1,26 @@
+const { generateDocs } = require('@2gis/ts-docs-generator');
+const fs = require('fs');
+const path = require('path');
+
+const version = process.env.VERSION || 'branch';
+fs.mkdirSync(path.join('dist', 'docs', version), { recursive: true });
+
+generateDocs({
+    version,
+    project: 'deck2gisLayer',
+    defaultReference: 'Deck2gisLayer',
+    docsHost: 'https://unpkg.com/@2gis/deck2gis-layer@^2/dist/docs',
+    excludePaths: [],
+    globs: ['src/**/*'],
+    ignoreMarkdown: true,
+    legacyOutPath: 'dist/docs.json',
+})
+    .then((result) => {
+        fs.writeFileSync(path.join('dist', 'docs', 'manifest.json'), result.manifest);
+        fs.writeFileSync(path.join('dist', 'docs', version, 'en.json'), result.reference.en);
+        fs.writeFileSync(path.join('dist', 'docs', version, 'ru.json'), result.reference.ru);
+    })
+    .catch((e) => {
+        console.log(e);
+        process.exit(1);
+    });