docs: generate static imports for types with api-extractor

2026-03-11 09:03:29 +01:00 · 2023-04-17 19:08:01 +02:00
parent 516c46117c
commit 98a76db482
31 changed files with 209 additions and 143 deletions
--- a/packages/brokers/api-extractor-docs.json
+++ b/packages/brokers/api-extractor-docs.json
@@ -0,0 +1,4 @@
+{
+	"extends": "./api-extractor.json",
+	"mainEntryPointFilePath": "<projectFolder>/dist-docs/index.d.ts"
+}
--- a/packages/brokers/package.json
+++ b/packages/brokers/package.json
@@ -9,7 +9,7 @@
 		"lint": "prettier --check . && cross-env TIMING=1 eslint src __tests__ --ext .mjs,.js,.ts --format=pretty",
 		"format": "prettier --write . && cross-env TIMING=1 eslint src __tests__ --ext .mjs,.js,.ts --fix --format=pretty",
 		"fmt": "yarn format",
-		"docs": "yarn build:docs && api-extractor run --local",
+		"docs": "yarn build:docs && api-extractor run --local && api-extractor run --local --config ./api-extractor-docs.json",
 		"prepack": "yarn lint && yarn test && yarn build",
 		"changelog": "git cliff --prepend ./CHANGELOG.md -u -c ./cliff.toml -r ../../ --include-path 'packages/brokers/*'",
 		"release": "cliff-jumper"
--- a/packages/builders/api-extractor-docs.json
+++ b/packages/builders/api-extractor-docs.json
@@ -0,0 +1,4 @@
+{
+	"extends": "./api-extractor.json",
+	"mainEntryPointFilePath": "<projectFolder>/dist-docs/index.d.ts"
+}
--- a/packages/builders/package.json
+++ b/packages/builders/package.json
@@ -9,7 +9,7 @@
 		"lint": "prettier --check . && cross-env TIMING=1 eslint src __tests__ --ext .mjs,.js,.ts --format=pretty",
 		"format": "prettier --write . && cross-env TIMING=1 eslint src __tests__ --ext .mjs,.js,.ts --fix --format=pretty",
 		"fmt": "yarn format",
-		"docs": "yarn build:docs && api-extractor run --local",
+		"docs": "yarn build:docs && api-extractor run --local && api-extractor run --local --config ./api-extractor-docs.json",
 		"prepack": "yarn lint && yarn test && yarn build",
 		"changelog": "git cliff --prepend ./CHANGELOG.md -u -c ./cliff.toml -r ../../ --include-path 'packages/builders/*'",
 		"release": "cliff-jumper"
@@ -58,7 +58,7 @@
 		"@discordjs/formatters": "workspace:^",
 		"@discordjs/util": "workspace:^",
 		"@sapphire/shapeshift": "^3.8.2",
-		"discord-api-types": "^0.37.38",
+		"discord-api-types": "^0.37.39",
 		"fast-deep-equal": "^3.1.3",
 		"ts-mixer": "^6.0.3",
 		"tslib": "^2.5.0"
--- a/packages/collection/api-extractor-docs.json
+++ b/packages/collection/api-extractor-docs.json
@@ -0,0 +1,4 @@
+{
+	"extends": "./api-extractor.json",
+	"mainEntryPointFilePath": "<projectFolder>/dist-docs/index.d.ts"
+}
--- a/packages/collection/package.json
+++ b/packages/collection/package.json
@@ -9,7 +9,7 @@
 		"lint": "prettier --check . && cross-env TIMING=1 eslint src __tests__ --ext .mjs,.js,.ts --format=pretty",
 		"format": "prettier --write . && cross-env TIMING=1 eslint src __tests__ --ext .mjs,.js,.ts --fix --format=pretty",
 		"fmt": "yarn format",
-		"docs": "yarn build:docs && api-extractor run --local",
+		"docs": "yarn build:docs && api-extractor run --local && api-extractor run --local --config ./api-extractor-docs.json",
 		"prepack": "yarn lint && yarn test && yarn build",
 		"changelog": "git cliff --prepend ./CHANGELOG.md -u -c ./cliff.toml -r ../../ --include-path 'packages/collection/*'",
 		"release": "cliff-jumper"
--- a/packages/core/api-extractor-docs.json
+++ b/packages/core/api-extractor-docs.json
@@ -0,0 +1,4 @@
+{
+	"extends": "./api-extractor.json",
+	"mainEntryPointFilePath": "<projectFolder>/dist-docs/index.d.ts"
+}
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -8,7 +8,7 @@
 		"build:docs": "tsc -p tsconfig.docs.json",
 		"lint": "prettier --check . && cross-env TIMING=1 eslint src --ext .mjs,.js,.ts --format=pretty",
 		"format": "prettier --write . && cross-env TIMING=1 eslint src --ext .mjs,.js,.ts --fix --format=pretty",
-		"docs": "yarn build:docs && api-extractor run --local",
+		"docs": "yarn build:docs && api-extractor run --local && api-extractor run --local --config ./api-extractor-docs.json",
 		"prepack": "yarn build && yarn lint",
 		"changelog": "git cliff --prepend ./CHANGELOG.md -u -c ./cliff.toml -r ../../ --include-path 'packages/core/*'",
 		"release": "cliff-jumper"
@@ -58,7 +58,7 @@
 		"@discordjs/ws": "workspace:^",
 		"@sapphire/snowflake": "^3.4.2",
 		"@vladfrangu/async_event_emitter": "^2.2.1",
-		"discord-api-types": "^0.37.38"
+		"discord-api-types": "^0.37.39"
 	},
 	"devDependencies": {
 		"@favware/cliff-jumper": "^2.0.0",
--- a/packages/discord.js/package.json
+++ b/packages/discord.js/package.json
@@ -56,7 +56,7 @@
    "@discordjs/util": "workspace:^",
    "@sapphire/snowflake": "^3.4.2",
    "@types/ws": "^8.5.4",
-    "discord-api-types": "^0.37.38",
+    "discord-api-types": "^0.37.39",
    "fast-deep-equal": "^3.1.3",
    "lodash.snakecase": "^4.1.1",
    "tslib": "^2.5.0",
--- a/packages/docgen/package.json
+++ b/packages/docgen/package.json
@@ -43,7 +43,7 @@
 		"commander": "^10.0.1",
 		"jsdoc-to-markdown": "^8.0.0",
 		"tslib": "^2.5.0",
-		"typedoc": "^0.24.1"
+		"typedoc": "^0.24.4"
 	},
 	"devDependencies": {
 		"@favware/cliff-jumper": "^2.0.0",
--- a/packages/formatters/api-extractor-docs.json
+++ b/packages/formatters/api-extractor-docs.json
@@ -0,0 +1,4 @@
+{
+	"extends": "./api-extractor.json",
+	"mainEntryPointFilePath": "<projectFolder>/dist-docs/index.d.ts"
+}
--- a/packages/formatters/package.json
+++ b/packages/formatters/package.json
@@ -8,7 +8,7 @@
 		"build:docs": "tsc -p tsconfig.docs.json",
 		"lint": "prettier --check . && cross-env TIMING=1 eslint src __tests__ --ext .mjs,.js,.ts --format=pretty",
 		"format": "prettier --write . && cross-env TIMING=1 eslint src __tests__ --ext .mjs,.js,.ts --fix --format=pretty",
-		"docs": "yarn build:docs && api-extractor run --local",
+		"docs": "yarn build:docs && api-extractor run --local && api-extractor run --local --config ./api-extractor-docs.json",
 		"prepack": "yarn build && yarn lint",
 		"changelog": "git cliff --prepend ./CHANGELOG.md -u -c ./cliff.toml -r ../../ --include-path 'packages/formatters/*'",
 		"release": "cliff-jumper"
@@ -45,7 +45,7 @@
 	},
 	"homepage": "https://discord.js.org",
 	"dependencies": {
-		"discord-api-types": "^0.37.38"
+		"discord-api-types": "^0.37.39"
 	},
 	"devDependencies": {
 		"@favware/cliff-jumper": "^2.0.0",
--- a/packages/next/api-extractor-docs.json
+++ b/packages/next/api-extractor-docs.json
@@ -0,0 +1,4 @@
+{
+	"extends": "./api-extractor.json",
+	"mainEntryPointFilePath": "<projectFolder>/dist-docs/index.d.ts"
+}
--- a/packages/next/package.json
+++ b/packages/next/package.json
@@ -8,7 +8,7 @@
 		"build:docs": "tsc -p tsconfig.docs.json",
 		"lint": "prettier --check . && cross-env TIMING=1 eslint src __tests__ --ext .mjs,.js,.ts --format=pretty",
 		"format": "prettier --write . && cross-env TIMING=1 eslint src __tests__ --ext .mjs,.js,.ts --fix --format=pretty",
-		"docs": "yarn build:docs && api-extractor run --local",
+		"docs": "yarn build:docs && api-extractor run --local && api-extractor run --local --config ./api-extractor-docs.json",
 		"prepack": "yarn build && yarn lint",
 		"changelog": "git cliff --prepend ./CHANGELOG.md -u -c ./cliff.toml -r ../../ --include-path 'packages/next/*'",
 		"release": "cliff-jumper"
@@ -59,7 +59,7 @@
 		"@discordjs/rest": "workspace:^",
 		"@discordjs/util": "workspace:^",
 		"@discordjs/ws": "workspace:^",
-		"discord-api-types": "^0.37.38"
+		"discord-api-types": "^0.37.39"
 	},
 	"devDependencies": {
 		"@favware/cliff-jumper": "^2.0.0",
--- a/packages/proxy/api-extractor-docs.json
+++ b/packages/proxy/api-extractor-docs.json
@@ -0,0 +1,4 @@
+{
+	"extends": "./api-extractor.json",
+	"mainEntryPointFilePath": "<projectFolder>/dist-docs/index.d.ts"
+}
--- a/packages/proxy/package.json
+++ b/packages/proxy/package.json
@@ -9,7 +9,7 @@
 		"lint": "prettier --check . && cross-env TIMING=1 eslint src __tests__ --ext .mjs,.js,.ts --format=pretty",
 		"format": "prettier --write . && cross-env TIMING=1 eslint src __tests__ --ext .mjs,.js,.ts --fix --format=pretty",
 		"fmt": "yarn format",
-		"docs": "yarn build:docs && api-extractor run --local",
+		"docs": "yarn build:docs && api-extractor run --local && api-extractor run --local --config ./api-extractor-docs.json",
 		"prepack": "yarn lint && yarn test && yarn build",
 		"changelog": "git cliff --prepend ./CHANGELOG.md -u -c ./cliff.toml -r ../../ --include-path 'packages/proxy/*'",
 		"release": "cliff-jumper"
--- a/packages/rest/api-extractor-docs.json
+++ b/packages/rest/api-extractor-docs.json
@@ -0,0 +1,4 @@
+{
+	"extends": "./api-extractor.json",
+	"mainEntryPointFilePath": "<projectFolder>/dist-docs/index.d.ts"
+}
--- a/packages/rest/package.json
+++ b/packages/rest/package.json
@@ -9,7 +9,7 @@
 		"lint": "prettier --check . && cross-env TIMING=1 eslint src __tests__ --ext .mjs,.js,.ts --format=pretty",
 		"format": "prettier --write . && cross-env TIMING=1 eslint src __tests__ --ext .mjs,.js,.ts --fix --format=pretty",
 		"fmt": "yarn format",
-		"docs": "yarn build:docs && api-extractor run --local",
+		"docs": "yarn build:docs && api-extractor run --local && api-extractor run --local --config ./api-extractor-docs.json",
 		"prepack": "yarn lint && yarn test && yarn build",
 		"changelog": "git cliff --prepend ./CHANGELOG.md -u -c ./cliff.toml -r ../../ --include-path 'packages/rest/*'",
 		"release": "cliff-jumper"
@@ -57,7 +57,7 @@
 		"@discordjs/util": "workspace:^",
 		"@sapphire/async-queue": "^1.5.0",
 		"@sapphire/snowflake": "^3.4.2",
-		"discord-api-types": "^0.37.38",
+		"discord-api-types": "^0.37.39",
 		"file-type": "^18.2.1",
 		"tslib": "^2.5.0",
 		"undici": "^5.21.2"
--- a/packages/scripts/src/template/template.package.json
+++ b/packages/scripts/src/template/template.package.json
@@ -8,7 +8,7 @@
 		"build:docs": "tsc -p tsconfig.docs.json",
 		"lint": "prettier --check . && cross-env TIMING=1 eslint src __tests__ --ext .mjs,.js,.ts --format=pretty",
 		"format": "prettier --write . && cross-env TIMING=1 eslint src __tests__ --ext .mjs,.js,.ts --fix --format=pretty",
-		"docs": "yarn build:docs && api-extractor run --local",
+		"docs": "yarn build:docs && api-extractor run --local && api-extractor run --local --config ./api-extractor-docs.json",
 		"prepack": "yarn build && yarn lint",
 		"changelog": "git cliff --prepend ./CHANGELOG.md -u -c ./cliff.toml -r ../../ --include-path 'packages/{name}/*'",
 		"release": "cliff-jumper"
--- a/packages/ui/api-extractor-docs.json
+++ b/packages/ui/api-extractor-docs.json
@@ -0,0 +1,4 @@
+{
+	"extends": "./api-extractor.json",
+	"mainEntryPointFilePath": "<projectFolder>/dist-docs/index.d.ts"
+}
--- a/packages/ui/package.json
+++ b/packages/ui/package.json
@@ -79,7 +79,7 @@
 		"typescript": "^5.0.4",
 		"unocss": "^0.51.4",
 		"vite": "^4.2.1",
-		"vite-plugin-dts": "^2.2.0",
+		"vite-plugin-dts": "^2.3.0",
 		"vitest": "^0.29.8"
 	},
 	"engines": {
--- a/packages/util/api-extractor-docs.json
+++ b/packages/util/api-extractor-docs.json
@@ -0,0 +1,4 @@
+{
+	"extends": "./api-extractor.json",
+	"mainEntryPointFilePath": "<projectFolder>/dist-docs/index.d.ts"
+}
--- a/packages/util/package.json
+++ b/packages/util/package.json
@@ -9,7 +9,7 @@
 		"lint": "prettier --check . && TIMING=1 eslint src --ext .mjs,.js,.ts --format=pretty",
 		"format": "prettier --write . && TIMING=1 eslint src --ext .mjs,.js,.ts --fix --format=pretty",
 		"fmt": "yarn format",
-		"docs": "yarn build:docs && api-extractor run --local",
+		"docs": "yarn build:docs && api-extractor run --local && api-extractor run --local --config ./api-extractor-docs.json",
 		"prepack": "yarn lint && yarn test && yarn build",
 		"changelog": "git cliff --prepend ./CHANGELOG.md -u -c ./cliff.toml -r ../../ --include-path 'packages/util/*'",
 		"release": "cliff-jumper"
--- a/packages/voice/api-extractor-docs.json
+++ b/packages/voice/api-extractor-docs.json
@@ -0,0 +1,4 @@
+{
+	"extends": "./api-extractor.json",
+	"mainEntryPointFilePath": "<projectFolder>/dist-docs/index.d.ts"
+}
--- a/packages/voice/package.json
+++ b/packages/voice/package.json
@@ -9,7 +9,7 @@
 		"lint": "prettier --check . && cross-env TIMING=1 eslint src __tests__ --ext .mjs,.js,.ts --format=pretty",
 		"format": "prettier --write . && cross-env TIMING=1 eslint src __tests__ --ext .mjs,.js,.ts --fix --format=pretty",
 		"fmt": "yarn format",
-		"docs": "yarn build:docs && api-extractor run --local",
+		"docs": "yarn build:docs && api-extractor run --local && api-extractor run --local --config ./api-extractor-docs.json",
 		"prepack": "yarn lint && yarn test && yarn build",
 		"changelog": "git cliff --prepend ./CHANGELOG.md -u -c ./cliff.toml -r ../../ --include-path 'packages/voice/*'",
 		"release": "cliff-jumper"
@@ -54,7 +54,7 @@
 	"homepage": "https://discord.js.org",
 	"dependencies": {
 		"@types/ws": "^8.5.4",
-		"discord-api-types": "^0.37.38",
+		"discord-api-types": "^0.37.39",
 		"prism-media": "^1.3.5",
 		"tslib": "^2.5.0",
 		"ws": "^8.13.0"
--- a/packages/ws/api-extractor-docs.json
+++ b/packages/ws/api-extractor-docs.json
@@ -0,0 +1,4 @@
+{
+	"extends": "./api-extractor.json",
+	"mainEntryPointFilePath": "<projectFolder>/dist-docs/index.d.ts"
+}
--- a/packages/ws/package.json
+++ b/packages/ws/package.json
@@ -8,7 +8,7 @@
 		"build:docs": "tsc -p tsconfig.docs.json",
 		"lint": "prettier --check . && cross-env TIMING=1 eslint src __tests__ --ext .mjs,.js,.ts --format=pretty",
 		"format": "prettier --write . && cross-env TIMING=1 eslint src __tests__ --ext .mjs,.js,.ts --fix --format=pretty",
-		"docs": "yarn build:docs && api-extractor run --local",
+		"docs": "yarn build:docs && api-extractor run --local && api-extractor run --local --config ./api-extractor-docs.json",
 		"prepack": "yarn build && yarn lint",
 		"changelog": "git cliff --prepend ./CHANGELOG.md -u -c ./cliff.toml -r ../../ --include-path 'packages/ws/*'",
 		"release": "cliff-jumper"
@@ -65,7 +65,7 @@
 		"@sapphire/async-queue": "^1.5.0",
 		"@types/ws": "^8.5.4",
 		"@vladfrangu/async_event_emitter": "^2.2.1",
-		"discord-api-types": "^0.37.38",
+		"discord-api-types": "^0.37.39",
 		"tslib": "^2.5.0",
 		"ws": "^8.13.0"
 	},