From 33d69a938a7e9f340580dc0fa46f5aa9bc62be1b Mon Sep 17 00:00:00 2001 From: Muhammad Azeez Date: Wed, 15 Nov 2023 16:40:28 +0300 Subject: [PATCH 1/5] docs: add typedoc dependency --- package-lock.json | 87 ++++++++++++++++++++++++++++++++++++++++++++--- package.json | 4 ++- 2 files changed, 86 insertions(+), 5 deletions(-) diff --git a/package-lock.json b/package-lock.json index 919f9ea..727b79d 100644 --- a/package-lock.json +++ b/package-lock.json @@ -21,7 +21,9 @@ "playwright": "^1.39.0", "prettier": "^2.7.1", "tape": "^5.7.1", - "typedoc": "^0.25.2", + "typedoc": "^0.25.3", + "typedoc-github-wiki-theme": "^1.1.0", + "typedoc-plugin-markdown": "^3.17.1", "typescript": "^5.2.2" } }, @@ -2170,6 +2172,27 @@ "integrity": "sha512-EtKwoO6kxCL9WO5xipiHTZlSzBm7WLT627TqC/uVRd0HKmq8NXyebnNYxDoBi7wt8eTWrUrKXCOVaFq9x1kgag==", "dev": true }, + "node_modules/handlebars": { + "version": "4.7.8", + "resolved": "https://registry.npmjs.org/handlebars/-/handlebars-4.7.8.tgz", + "integrity": "sha512-vafaFqs8MZkRrSX7sFVUdo3ap/eNiLnb4IakshzvP56X5Nr1iGKAIqdX6tMlm6HcNRIkr6AxO5jFEoJzzpT8aQ==", + "dev": true, + "dependencies": { + "minimist": "^1.2.5", + "neo-async": "^2.6.2", + "source-map": "^0.6.1", + "wordwrap": "^1.0.0" + }, + "bin": { + "handlebars": "bin/handlebars" + }, + "engines": { + "node": ">=0.4.7" + }, + "optionalDependencies": { + "uglify-js": "^3.1.4" + } + }, "node_modules/has": { "version": "1.0.3", "resolved": "https://registry.npmjs.org/has/-/has-1.0.3.tgz", @@ -2788,6 +2811,12 @@ "integrity": "sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==", "dev": true }, + "node_modules/neo-async": { + "version": "2.6.2", + "resolved": "https://registry.npmjs.org/neo-async/-/neo-async-2.6.2.tgz", + "integrity": "sha512-Yd3UES5mWCSqR+qNT93S3UoYUkqAZ9lLg8a7g9rimsWmYGK8cVToA4/sF3RrshdyV3sAGMXVUmpMYOw+dLpOuw==", + "dev": true + }, "node_modules/object-inspect": { "version": "1.13.0", "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.0.tgz", @@ -3246,6 +3275,15 @@ "node": ">=8" } }, + "node_modules/source-map": { + "version": "0.6.1", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz", + "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==", + "dev": true, + "engines": { + "node": ">=0.10.0" + } + }, "node_modules/stop-iteration-iterator": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/stop-iteration-iterator/-/stop-iteration-iterator-1.0.0.tgz", @@ -3500,9 +3538,9 @@ } }, "node_modules/typedoc": { - "version": "0.25.2", - "resolved": "https://registry.npmjs.org/typedoc/-/typedoc-0.25.2.tgz", - "integrity": "sha512-286F7BeATBiWe/qC4PCOCKlSTwfnsLbC/4cZ68oGBbvAqb9vV33quEOXx7q176OXotD+JdEerdQ1OZGJ818lnA==", + "version": "0.25.3", + "resolved": "https://registry.npmjs.org/typedoc/-/typedoc-0.25.3.tgz", + "integrity": "sha512-Ow8Bo7uY1Lwy7GTmphRIMEo6IOZ+yYUyrc8n5KXIZg1svpqhZSWgni2ZrDhe+wLosFS8yswowUzljTAV/3jmWw==", "dev": true, "dependencies": { "lunr": "^2.3.9", @@ -3520,6 +3558,28 @@ "typescript": "4.6.x || 4.7.x || 4.8.x || 4.9.x || 5.0.x || 5.1.x || 5.2.x" } }, + "node_modules/typedoc-github-wiki-theme": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/typedoc-github-wiki-theme/-/typedoc-github-wiki-theme-1.1.0.tgz", + "integrity": "sha512-VyFmz8ZV2j/qEsCjD5EtR6FgZsCoy64Zr6SS9kCTcq7zx69Cx4UJBx8Ga/naxqs08TDggE6myIfODY6awwAGcA==", + "dev": true, + "peerDependencies": { + "typedoc": ">=0.24.0", + "typedoc-plugin-markdown": ">=3.15.0" + } + }, + "node_modules/typedoc-plugin-markdown": { + "version": "3.17.1", + "resolved": "https://registry.npmjs.org/typedoc-plugin-markdown/-/typedoc-plugin-markdown-3.17.1.tgz", + "integrity": "sha512-QzdU3fj0Kzw2XSdoL15ExLASt2WPqD7FbLeaqwT70+XjKyTshBnUlQA5nNREO1C2P8Uen0CDjsBLMsCQ+zd0lw==", + "dev": true, + "dependencies": { + "handlebars": "^4.7.7" + }, + "peerDependencies": { + "typedoc": ">=0.24.0" + } + }, "node_modules/typescript": { "version": "5.2.2", "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.2.2.tgz", @@ -3533,6 +3593,19 @@ "node": ">=14.17" } }, + "node_modules/uglify-js": { + "version": "3.17.4", + "resolved": "https://registry.npmjs.org/uglify-js/-/uglify-js-3.17.4.tgz", + "integrity": "sha512-T9q82TJI9e/C1TAxYvfb16xO120tMVFZrGA3f9/P4424DNu6ypK103y0GPFVa17yotwSyZW5iYXgjYHkGrJW/g==", + "dev": true, + "optional": true, + "bin": { + "uglifyjs": "bin/uglifyjs" + }, + "engines": { + "node": ">=0.8.0" + } + }, "node_modules/unbox-primitive": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/unbox-primitive/-/unbox-primitive-1.0.2.tgz", @@ -3640,6 +3713,12 @@ "url": "https://github.com/sponsors/ljharb" } }, + "node_modules/wordwrap": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/wordwrap/-/wordwrap-1.0.0.tgz", + "integrity": "sha512-gvVzJFlPycKc5dZN4yPkP8w7Dc37BtP1yczEneOb4uq34pXZcvrtRTmWV8W+Ume+XCxKgbjM+nevkyFPMybd4Q==", + "dev": true + }, "node_modules/wrappy": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz", diff --git a/package.json b/package.json index e8c41c1..248043e 100644 --- a/package.json +++ b/package.json @@ -55,7 +55,9 @@ "playwright": "^1.39.0", "prettier": "^2.7.1", "tape": "^5.7.1", - "typedoc": "^0.25.2", + "typedoc": "^0.25.3", + "typedoc-github-wiki-theme": "^1.1.0", + "typedoc-plugin-markdown": "^3.17.1", "typescript": "^5.2.2" } } From 1c3b611b7b65c088aa4105b97474100699caf97c Mon Sep 17 00:00:00 2001 From: Muhammad Azeez Date: Wed, 15 Nov 2023 17:06:45 +0300 Subject: [PATCH 2/5] add workflow to deploy to github pages --- .github/workflows/release.yml | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 68b0191..2608c33 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -46,3 +46,11 @@ jobs: uses: JS-DevTools/npm-publish@v2.2.2 with: token: ${{ secrets.NPM_TOKEN }} + + - name: typedoc + run: npx typedoc .\src\mod.ts + + - name: Deploy docs to GitHub Pages + uses: JamesIves/github-pages-deploy-action@v4 + with: + folder: docs From 9ea538dea49c0828cc6d2dccb2856087ead678d3 Mon Sep 17 00:00:00 2001 From: Muhammad Azeez Date: Wed, 15 Nov 2023 17:22:56 +0300 Subject: [PATCH 3/5] fix yml indentation --- .github/workflows/release.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 2608c33..98ea001 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -52,5 +52,5 @@ jobs: - name: Deploy docs to GitHub Pages uses: JamesIves/github-pages-deploy-action@v4 - with: - folder: docs + with: + folder: docs From 8582e91d08c2268f640ea2778550742e8c3cb81d Mon Sep 17 00:00:00 2001 From: Muhammad Azeez Date: Wed, 15 Nov 2023 18:26:11 +0300 Subject: [PATCH 4/5] use peaceiris/actions-gh-pages --- .github/workflows/release.yml | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 98ea001..7244529 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -51,6 +51,7 @@ jobs: run: npx typedoc .\src\mod.ts - name: Deploy docs to GitHub Pages - uses: JamesIves/github-pages-deploy-action@v4 + uses: peaceiris/actions-gh-pages@v3 with: - folder: docs + github_token: ${{ secrets.GITHUB_TOKEN }} + publish_dir: ./docs From ccaaf93e7c3840f5669723f6f3bced4d0bef95c0 Mon Sep 17 00:00:00 2001 From: Chris Dickinson Date: Wed, 15 Nov 2023 12:29:10 -0800 Subject: [PATCH 5/5] fix: use "just docs" in release workflow --- .github/workflows/release.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 7244529..6f2218a 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -48,7 +48,7 @@ jobs: token: ${{ secrets.NPM_TOKEN }} - name: typedoc - run: npx typedoc .\src\mod.ts + run: just docs - name: Deploy docs to GitHub Pages uses: peaceiris/actions-gh-pages@v3