Skip to content

Commit

Permalink
docs: add typedoc-json-parser (#20)
Browse files Browse the repository at this point in the history
  • Loading branch information
RealShadowNova committed Jun 10, 2022
1 parent 50c1b1f commit c18bd4f
Show file tree
Hide file tree
Showing 6 changed files with 266 additions and 1 deletion.
93 changes: 93 additions & 0 deletions .github/workflows/documentation.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,93 @@
name: Documentation

on:
push:
branches:
- main
tags:
- 'v*'

jobs:
build:
name: Build Documentation
runs-on: ubuntu-latest

if: github.repository_owner == 'RealShadowNova'
steps:
- name: Checkout Project
uses: actions/checkout@2541b1294d2704b0964813337f33b291d3f8596b # tag=v3
- name: Use Node.js v16
uses: actions/setup-node@17f8bd926464a1afa4c6a11669539e9c1ba77048 # tag=v3
with:
node-version: 16
cache: yarn
registry-url: https://registry.npmjs.org/
- name: Install Dependencies
run: yarn --immutable
- name: Build Documentation
run: yarn docs
- name: Upload Documentation Artifacts
uses: actions/cache@v2
with:
name: docs
path: docs/api.json
- name: Set Output
id: env
run: |
echo "::set-output name=NAME::${GITHUB_REF_NAME}"
echo "::set-output name=TYPE::${GITHUB_REF_TYPE}"
echo "::set-output name=SHA::${GITHUB_SHA}"
upload:
name: Upload Documentation
needs: build
runs-on: ubuntu-latest
env:
NAME: ${{ needs.build.outputs.REF }}
TYPE: ${{ needs.build.outputs.TYPE }}
SHA: ${{ needs.build.outputs.SHA }}
steps:
- name: Checkout Project
uses: actions/checkout@2541b1294d2704b0964813337f33b291d3f8596b # tag=v3
- name: Use Node.js v16
uses: actions/setup-node@17f8bd926464a1afa4c6a11669539e9c1ba77048 # tag=v3
with:
node-version: 16
cache: yarn
registry-url: https://registry.npmjs.org/
- name: Install Dependencies
run: yarn --immutable
- name: Download Documentation Artifacts
uses: actions/download-artifact@v2
with:
name: docs
path: docs
- name: Checkout Documentation Project
uses: actions/checkout@2541b1294d2704b0964813337f33b291d3f8596b # tag=v3
with:
repository: 'RealShadowNova/docs'
path: 'out'

- name: Move Documentation
if: ${{ env.TYPE == 'tag' }}
env:
SEMVER: ${{ env.NAME }}
run: |
mkdir -p out/property-helpers
mv docs/api.json out/property-helpers/${SEMVER}.json
- name: Move Documentation
if: ${{ env.TYPE == 'branch' }}
run: |
mkdir -p out/property-helpers
mv docs/api.json out/property-helpers/${NAME}.json
- name: Commit & Push
run: |
cd out
git config user.name github-actions[bot]
git config user.email 41898282+github-actions[bot]@users.noreply.github.com
git add .
git commit -m "docs(property-helpers): build for ${TYPE} ${NAME}: ${SHA}"
git push
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ node_modules/
# Build Artifacts
dist/
build/
docs/

# Ignore heapsnapshot and log files
*.heapsnapshot
Expand Down
1 change: 1 addition & 0 deletions .typedoc-json-parserrc.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
json: 'docs/api.json'
3 changes: 3 additions & 0 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@
},
"scripts": {
"clean": "rimraf dist node_modules/.cache",
"docs": "typedoc-json-parser",
"lint": "eslint src tests --ext ts --fix",
"format": "prettier --write {src,tests}/**/*.ts",
"test": "jest",
Expand Down Expand Up @@ -55,6 +56,8 @@
"rollup-plugin-typescript2": "^0.32.0",
"ts-jest": "^28.0.4",
"tsup": "^6.0.1",
"typedoc": "^0.22.15",
"typedoc-json-parser": "^1.0.0",
"typescript": "^4.7.3"
},
"repository": {
Expand Down
7 changes: 7 additions & 0 deletions typedoc.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
{
"$schema": "https://typedoc.org/schema.json",
"entryPoints": ["src/index.ts"],
"json": "docs/api.json",
"treatWarningsAsErrors": true,
"tsconfig": "src/tsconfig.json"
}
162 changes: 161 additions & 1 deletion yarn.lock
Original file line number Diff line number Diff line change
Expand Up @@ -780,6 +780,15 @@ __metadata:
languageName: node
linkType: hard

"@favware/colorette-spinner@npm:^1.0.0":
version: 1.0.0
resolution: "@favware/colorette-spinner@npm:1.0.0"
dependencies:
colorette: "*"
checksum: b7fe7d983f8063bb069c1748a7f8819f59577d9abec16968fcbf9a58461dadfa0188702f528244f5184d5ae93468548da51ec265b71712743d6904ef1e8b59f1
languageName: node
linkType: hard

"@favware/npm-deprecate@npm:^1.0.4":
version: 1.0.4
resolution: "@favware/npm-deprecate@npm:1.0.4"
Expand Down Expand Up @@ -1947,6 +1956,15 @@ __metadata:
languageName: node
linkType: hard

"brace-expansion@npm:^2.0.1":
version: 2.0.1
resolution: "brace-expansion@npm:2.0.1"
dependencies:
balanced-match: ^1.0.0
checksum: a61e7cd2e8a8505e9f0036b3b6108ba5e926b4b55089eeb5550cd04a471fe216c96d4fe7e4c7f995c728c554ae20ddfc4244cad10aef255e72b62930afd233d1
languageName: node
linkType: hard

"braces@npm:^3.0.1, braces@npm:^3.0.2, braces@npm:~3.0.2":
version: 3.0.2
resolution: "braces@npm:3.0.2"
Expand Down Expand Up @@ -2288,6 +2306,13 @@ __metadata:
languageName: node
linkType: hard

"colorette@npm:*, colorette@npm:^2.0.17":
version: 2.0.17
resolution: "colorette@npm:2.0.17"
checksum: 693a56d816846e0e213f92c8061b65eb5025030b28a113f90c539fe34c860abc41132c03599af26bcbc213170a31bac1bf2d4c535ccad5ac7b5cb3248f9d98a8
languageName: node
linkType: hard

"colorette@npm:^2.0.14, colorette@npm:^2.0.16":
version: 2.0.16
resolution: "colorette@npm:2.0.16"
Expand Down Expand Up @@ -3565,6 +3590,33 @@ __metadata:
languageName: node
linkType: hard

"glob@npm:^7.2.0":
version: 7.2.3
resolution: "glob@npm:7.2.3"
dependencies:
fs.realpath: ^1.0.0
inflight: ^1.0.4
inherits: 2
minimatch: ^3.1.1
once: ^1.3.0
path-is-absolute: ^1.0.0
checksum: 29452e97b38fa704dabb1d1045350fb2467cf0277e155aa9ff7077e90ad81d1ea9d53d3ee63bd37c05b09a065e90f16aec4a65f5b8de401d1dac40bc5605d133
languageName: node
linkType: hard

"glob@npm:^8.0.3":
version: 8.0.3
resolution: "glob@npm:8.0.3"
dependencies:
fs.realpath: ^1.0.0
inflight: ^1.0.4
inherits: 2
minimatch: ^5.0.1
once: ^1.3.0
checksum: 50bcdea19d8e79d8de5f460b1939ffc2b3299eac28deb502093fdca22a78efebc03e66bf54f0abc3d3d07d8134d19a32850288b7440d77e072aa55f9d33b18c5
languageName: node
linkType: hard

"global-dirs@npm:^0.1.1":
version: 0.1.1
resolution: "global-dirs@npm:0.1.1"
Expand Down Expand Up @@ -4568,6 +4620,13 @@ __metadata:
languageName: node
linkType: hard

"jsonc-parser@npm:^3.0.0":
version: 3.0.0
resolution: "jsonc-parser@npm:3.0.0"
checksum: 1df2326f1f9688de30c70ff19c5b2a83ba3b89a1036160da79821d1361090775e9db502dc57a67c11b56e1186fc1ed70b887f25c5febf9a3ec4f91435836c99d
languageName: node
linkType: hard

"jsonfile@npm:^6.0.1":
version: 6.1.0
resolution: "jsonfile@npm:6.1.0"
Expand Down Expand Up @@ -4758,6 +4817,13 @@ __metadata:
languageName: node
linkType: hard

"lunr@npm:^2.3.9":
version: 2.3.9
resolution: "lunr@npm:2.3.9"
checksum: 176719e24fcce7d3cf1baccce9dd5633cd8bdc1f41ebe6a180112e5ee99d80373fe2454f5d4624d437e5a8319698ca6837b9950566e15d2cae5f2a543a3db4b8
languageName: node
linkType: hard

"make-dir@npm:^3.0.0, make-dir@npm:^3.0.2":
version: 3.1.0
resolution: "make-dir@npm:3.1.0"
Expand Down Expand Up @@ -4821,6 +4887,15 @@ __metadata:
languageName: node
linkType: hard

"marked@npm:^4.0.12, marked@npm:^4.0.16":
version: 4.0.16
resolution: "marked@npm:4.0.16"
bin:
marked: bin/marked.js
checksum: c0ef780bf56c9bb49c15b66683e5648410c924c1d725f1489fc3c7dc3bd01194c50d720052bb0282ad7907f472dfdc8fa278acbc7903c5db3be4b83487e0d684
languageName: node
linkType: hard

"meow@npm:^8.0.0":
version: 8.1.2
resolution: "meow@npm:8.1.2"
Expand Down Expand Up @@ -4895,7 +4970,7 @@ __metadata:
languageName: node
linkType: hard

"minimatch@npm:^3.0.4, minimatch@npm:^3.1.2":
"minimatch@npm:^3.0.4, minimatch@npm:^3.1.1, minimatch@npm:^3.1.2":
version: 3.1.2
resolution: "minimatch@npm:3.1.2"
dependencies:
Expand All @@ -4904,6 +4979,15 @@ __metadata:
languageName: node
linkType: hard

"minimatch@npm:^5.0.1, minimatch@npm:^5.1.0":
version: 5.1.0
resolution: "minimatch@npm:5.1.0"
dependencies:
brace-expansion: ^2.0.1
checksum: 15ce53d31a06361e8b7a629501b5c75491bc2b59712d53e802b1987121d91b433d73fcc5be92974fde66b2b51d8fb28d75a9ae900d249feb792bb1ba2a4f0a90
languageName: node
linkType: hard

"minimist-options@npm:4.1.0":
version: 4.1.0
resolution: "minimist-options@npm:4.1.0"
Expand Down Expand Up @@ -5589,6 +5673,8 @@ __metadata:
rollup-plugin-typescript2: ^0.32.0
ts-jest: ^28.0.4
tsup: ^6.0.1
typedoc: ^0.22.15
typedoc-json-parser: ^1.0.0
typescript: ^4.7.3
languageName: unknown
linkType: soft
Expand Down Expand Up @@ -5987,6 +6073,17 @@ __metadata:
languageName: node
linkType: hard

"shiki@npm:^0.10.1":
version: 0.10.1
resolution: "shiki@npm:0.10.1"
dependencies:
jsonc-parser: ^3.0.0
vscode-oniguruma: ^1.6.1
vscode-textmate: 5.2.0
checksum: fb746f3cb3de7e545e3b10a6cb658d3938f840e4ccc9a3c90ceb7e69a8f89dbb432171faac1e9f02a03f103684dad88ee5e54b5c4964fa6b579fca6e8e26424d
languageName: node
linkType: hard

"signal-exit@npm:^3.0.2, signal-exit@npm:^3.0.3, signal-exit@npm:^3.0.7":
version: 3.0.7
resolution: "signal-exit@npm:3.0.7"
Expand Down Expand Up @@ -6679,6 +6776,55 @@ __metadata:
languageName: node
linkType: hard

"typedoc-json-parser@npm:^1.0.0":
version: 1.0.0
resolution: "typedoc-json-parser@npm:1.0.0"
dependencies:
"@favware/colorette-spinner": ^1.0.0
colorette: ^2.0.17
commander: ^9.3.0
js-yaml: ^4.1.0
typedoc: ^0.22.17
bin:
typedoc-json-parser: ./dist/bin/index.js
checksum: 287cc526265927d944f936586c4d9c4f46d5d0b88da96f05c59c634ad10f1773ff17829f094ce5267e4b9ee832b4c334ccbfa1cb798aaa0351b19d56c8e5f800
languageName: node
linkType: hard

"typedoc@npm:^0.22.15":
version: 0.22.15
resolution: "typedoc@npm:0.22.15"
dependencies:
glob: ^7.2.0
lunr: ^2.3.9
marked: ^4.0.12
minimatch: ^5.0.1
shiki: ^0.10.1
peerDependencies:
typescript: 4.0.x || 4.1.x || 4.2.x || 4.3.x || 4.4.x || 4.5.x || 4.6.x
bin:
typedoc: bin/typedoc
checksum: 3f5f1cb9288bf811f42df59750c7062a026a23257b38dfe227515a30007a28e3d8139187949fcd19300fd6b2ef76bcdc4cf54549100bff3e000e61bb19958fb2
languageName: node
linkType: hard

"typedoc@npm:^0.22.17":
version: 0.22.17
resolution: "typedoc@npm:0.22.17"
dependencies:
glob: ^8.0.3
lunr: ^2.3.9
marked: ^4.0.16
minimatch: ^5.1.0
shiki: ^0.10.1
peerDependencies:
typescript: 4.0.x || 4.1.x || 4.2.x || 4.3.x || 4.4.x || 4.5.x || 4.6.x || 4.7.x
bin:
typedoc: bin/typedoc
checksum: 3a2f492477989855fa43afc0ebfb84dca819436ec5c868ca175cb02485c6347c04dbb2d11669a8be04fc6860a8f3d29d124300b5718ba17174622ace29a0276a
languageName: node
linkType: hard

"typescript@npm:^4.6.3":
version: 4.6.3
resolution: "typescript@npm:4.6.3"
Expand Down Expand Up @@ -6844,6 +6990,20 @@ __metadata:
languageName: node
linkType: hard

"vscode-oniguruma@npm:^1.6.1":
version: 1.6.2
resolution: "vscode-oniguruma@npm:1.6.2"
checksum: 6b754acdafd5b68242ea5938bb00a32effc16c77f471d4f0f337d879d0e8e592622998e2441f42d9a7ff799c1593f31c11f26ca8d9bf9917e3ca881d3c1f3e19
languageName: node
linkType: hard

"vscode-textmate@npm:5.2.0":
version: 5.2.0
resolution: "vscode-textmate@npm:5.2.0"
checksum: 5449b42d451080f6f3649b66948f4b5ee4643c4e88cfe3558a3b31c84c78060cfdd288c4958c1690eaa5cd65d09992fa6b7c3bef9d4aa72b3651054a04624d20
languageName: node
linkType: hard

"walker@npm:^1.0.7":
version: 1.0.8
resolution: "walker@npm:1.0.8"
Expand Down

0 comments on commit c18bd4f

Please sign in to comment.