refactor: move linked roles to core package (#138)

* refactor: move linked roles to core package

* chore: remove entry from tsconfig

* chore: fix undefined existing in docs path name on windows

* chore: refactor copy api script to support "subpackages"

.changeset/itchy-spiders-grin.md

@@ -0,0 +1,5 @@
+---
+"@buape/carbon": minor
+---
+
+refactor: move linked roles to core package

apps/rocko/package.json

@@ -10,7 +10,6 @@
 	},
 	"dependencies": {
 		"@buape/carbon": "workspace:*",
-		"@buape/carbon-linked-roles": "workspace:*",
 		"@buape/carbon-nodejs": "workspace:*",
 		"@types/node": "22.5.5"
 	},

apps/rocko/src/index.ts

@@ -1,11 +1,11 @@
 import { dirname } from "node:path"
 import { fileURLToPath } from "node:url"
 import { Client, ClientMode } from "@buape/carbon"
+import { loadCommands, serve } from "@buape/carbon-nodejs"
 import {
 	ApplicationRoleConnectionMetadataType,
 	LinkedRoles
-} from "@buape/carbon-linked-roles"
-import { loadCommands, serve } from "@buape/carbon-nodejs"
+} from "@buape/carbon/linked-roles"
 const __dirname = dirname(fileURLToPath(import.meta.url))
 
 if (

formatter.mjs

@@ -1,4 +1,4 @@
-import { dirname, relative } from "node:path"
+import { dirname, relative, sep } from "node:path"
 // @ts-check
 import { fileURLToPath } from "node:url"
 import { MarkdownPageEvent } from "typedoc-plugin-markdown"
@@ -27,7 +27,7 @@ export function load(app) {
 		(page) => {
 			if (!page.contents) return
 			const rel = relative(root, dirname(page.filename))
-			const parts = rel.split("/")
+			const parts = rel.split(sep)
 			const pkg = parts[1]
 			const dirParts = parts.slice(3)
 			const dir = dirParts.length ? `${dirParts.join("/")}/` : ""

packages/carbon/package.json

@@ -4,6 +4,16 @@
 	"type": "module",
 	"main": "./dist/src/index.js",
 	"repository": "github:buape/carbon",
+	"exports": {
+		".": {
+			"types": "./dist/src/index.d.ts",
+			"import": "./dist/src/index.js"
+		},
+		"./*": {
+			"types": "./dist/src/plugins/*/index.d.ts",
+			"import": "./dist/src/plugins/*/index.js"
+		}
+	},
 	"scripts": {
 		"build": "tsc",
 		"dev": "tsc -w",

packages/linked-roles/src/LinkedRoles.ts → packages/carbon/src/plugins/linked-roles/LinkedRoles.ts

@@ -1,4 +1,4 @@
-import type { Client } from "@buape/carbon"
+import type { Client } from "../../classes/Client.js"
 import {
 	ApplicationRoleConnectionMetadataType,
 	type LinkedRolesOptions

packages/carbon/typedoc.json

@@ -1,7 +1,7 @@
 {
 	"$schema": "https://typedoc.org/schema.json",
 	"extends": ["../../typedoc.json"],
-	"entryPoints": ["src/index.ts"],
+	"entryPoints": ["src/index.ts", "src/plugins/*/index.ts"],
 	"name": "@buape/carbon",
 	"out": "docs",
 	"excludeExternals": true,

website/content/carbon/meta.json

@@ -8,6 +8,7 @@
 		"...",
 		"--- Usage ---",
 		"classes",
+		"plugins",
 		"helpful-guides",
 		"even-more",
 		"--- API Reference ---",

website/content/carbon/plugins/index.mdx

@@ -0,0 +1,6 @@
+---
+title: Plugins
+index: true
+icon: Cable
+---
+

website/content/linked-roles/index.mdx → website/content/carbon/plugins/linked-roles.mdx

@@ -1,5 +1,6 @@
 ---
 title: Linked Roles
+description: Linked Roles are a handy feature of Discord that allows you to create roles that users have to meet certain criteria in order to claim those roles.
 ---
 
 Linked Roles are a handy feature of Discord that allows you to create roles that users have to meet certain criteria in order to claim those roles.
@@ -17,13 +18,13 @@ Then, create a new instance of the `LinkedRoles` class, and pass it your metadat
 
 ### Installation
 
-<CommandTabs command="install" args={["@buape/carbon @buape/carbon-linked-roles"]} />
+<CommandTabs command="install" args={["@buape/carbon"]} />
 
 ### Example
 
 ```ts title="src/index.ts"
 import { Client } from "@buape/carbon"
-import { LinkedRoles } from "@buape/carbon-linked-roles"
+import { LinkedRoles } from "@buape/carbon/linked-roles"
 
 const client = new Client({
 	clientId: "12345678901234567890",

website/content/carbon/plugins/meta.json

@@ -0,0 +1 @@
+{ "title": "Plugins" }