[refactor] Monorepo

.github/workflows/ci.yml

@@ -0,0 +1,60 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  fmt:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+      - name: Install tooling
+        uses: CompeyDev/[email protected]
+        with:
+          cache: true
+      - name: Check formatting
+        run: lune run fmt
+
+  lint:
+    runs-on: ubuntu-latest
+    needs: ["fmt"]
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+      - name: Install tooling
+        uses: CompeyDev/[email protected]
+        with:
+          cache: true
+      - name: Lint
+        run: lune run lint
+  typecheck:
+    runs-on: ubuntu-latest
+    needs: ["lint"]
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+      - name: Install tooling
+        uses: CompeyDev/[email protected]
+        with:
+          cache: true
+      - name: Setup lune typedefs
+        run: lune setup
+      - name: Typecheck
+        run: lune run analyze
+  test:
+    runs-on: ubuntu-latest
+    needs: ["typecheck"]
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          submodules: true
+      - name: Install tooling
+        uses: CompeyDev/[email protected]
+        with:
+          cache: true
+      - name: Run unit-tests
+        run: lune run test

.github/workflows/update-documentation.yml

@@ -18,6 +18,6 @@ jobs:
         uses: peter-evans/repository-dispatch@v3
         with:
           token: ${{ secrets.PAT }}
-          repository: DiscordLuau/Discord-Luau-Site
+          repository: DiscordLuau/docs
           event-type: update-ref
           client-payload: '{"ref": "${{ github.ref }}", "sha": "${{ github.sha }}"}'

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "extern/frktest"]
+	path = extern/frktest
+	url = https://github.com/itsfrank/frktest.git

.luaurc

@@ -4,13 +4,18 @@
 		"*": false
 	},
 	"aliases": {
-		"Builders": "./Package/Classes/Builders",
-		"Network": "./Package/Classes/Network",
-		"Objects": "./Package/Classes/Objects",
-		"Data": "./Package/Data",
-		"Enums": "./Package/Enums",
-		"Std": "./Package/Std",
-		"Utils": "./Package/Utils",
-		"Vendor": "./Package/Vendor"
+		"builders": "./packages/builders/src",
+		"cdn": "./packages/cdn/src",
+		"classes": "./packages/classes/src",
+		"core": "./packages/core/src",
+		"extensions": "./packages/extensions/src",
+		"std-polyfills": "./packages/std-polyfills/src",
+		"api-types": "./packages/api-types/src",
+		"rest": "./packages/rest/src",
+		"utils": "./packages/utils/src",
+		"vendor": "./packages/vendor/src",
+		"voice": "./packages/voice/src",
+		"websocket": "./packages/websocket/src",
+		"frktest": "./extern/frktest/src"
 	}
 }

.lune/analyze.luau

@@ -0,0 +1,10 @@
+--> Task to typecheck packages using luau-lsp
+
+local task = require("./task")
+
+task.new("luau-lsp")
+	:addArgument("analyze")
+	:addArgument("--base-luaurc=.luaurc")
+	:addArgument("--settings=.vscode/settings.json")
+	:addArgument("packages")
+	:execute()

.lune/fmt.luau

@@ -0,0 +1,10 @@
+--> Task to execute StyLua for checking validity of formatting
+
+local task = require("./task")
+
+task.new("stylua")
+	:addArgument("--check")
+	:addArgument("--output-format")
+	:addArgument("Summary")
+	:addArgument("packages")
+	:execute()

.lune/lint.luau

@@ -0,0 +1,5 @@
+--> Task for linting packages using selene
+
+local task = require("./task")
+
+task.new("selene"):addArgument("packages"):execute()

.lune/task/init.luau

@@ -0,0 +1,65 @@
+--> An internal library for lune scripts to execute tasks in CI/CD
+
+-- NOTE: We use the `Lune` runtime in the CI/CD environment, so we're not going to be using the `@std-polyfills`
+-- package that the discord-luau package uses.
+
+local process = require("@lune/process")
+local stdio = require("@lune/stdio")
+
+local Task = {}
+
+Task.Prototype = {}
+Task.Interface = {}
+
+--[[
+	Responsible for adding an argument to the executable.
+]]
+function Task.Prototype.addArgument(self: Task, argument: string): Task
+	table.insert(self.arguments, argument)
+
+	return self
+end
+
+--[[
+	Responsible for executing the task.
+
+	Inherits the standard IO of the process.
+]]
+function Task.Prototype.execute(self: Task): process.SpawnResult
+	local spawnResult = process.spawn(self.executable, self.arguments, {
+		stdio = "forward",
+	})
+
+	if not spawnResult.ok then
+		print(
+			`\n[{stdio.color("red")}error{stdio.color("reset")}] \`{self.executable}\` exited with code {spawnResult.code} `
+		)
+
+		process.exit(spawnResult.code)
+	end
+
+	return spawnResult
+end
+
+--[[
+	Constructor for the Task object.
+]]
+function Task.Interface.new(executable: string): Task
+	return setmetatable(
+		{
+			executable = executable,
+
+			arguments = {},
+		} :: Task,
+		{
+			__index = Task.Prototype,
+		}
+	)
+end
+
+export type Task = typeof(Task.Prototype) & {
+	executable: string,
+	arguments: { string },
+}
+
+return Task.Interface

.lune/task/requireTests.luau

@@ -0,0 +1,36 @@
+--> Runs tests located in the tests/ directory
+
+-- NOTE: we're using the `Lune` runtime in the CI/CD environment, so we're not going to be using the `@std-polyfills`
+-- package that the discord-luau package uses.
+
+local fs = require("@lune/fs")
+local stdio = require("@lune/stdio")
+local process = require("@lune/process")
+
+local requireTests
+local requireFile
+
+function requireFile(fullPath: string)
+	local success, result = pcall(require, fullPath)
+
+	if not success then
+		print(`\n{stdio.color("red")}Failed to require unit-test at \`{fullPath}\`, error:`)
+		print(`{stdio.style("dim")}{result}`)
+
+		process.exit(1)
+	else
+		result()
+	end
+end
+
+function requireTests(path: string)
+	for _, object in fs.readDir(path) do
+		if fs.isDir(`{path}/{object}`) then
+			requireTests(`{path}/{object}`)
+		else
+			requireFile(`{path}/{object}`)
+		end
+	end
+end
+
+return requireTests

.lune/test.luau

@@ -0,0 +1,15 @@
+--> Task for running unit-tests using frktest
+
+local frktest = require("@frktest/frktest")
+local reporter = require("@frktest/reporters/lune_console_reporter")
+
+local requireTests = require("./task/requireTests")
+
+requireTests("tests")
+
+reporter.init()
+
+if not frktest.run() then
+	print("--------------------")
+	error(`See above for test failures.`, -1)
+end