Initial commit

Author: NotNite

.github/workflows_/deploy.yml

@@ -0,0 +1,30 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  deploy:
+    name: Deploy to GitHub Pages
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-node@v3
+        with:
+          node-version: 18
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+      - name: Build website
+        run: pnpm run build
+
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./build
+          user_name: github-actions[bot]
+          user_email: 41898282+github-actions[bot]@users.noreply.github.com

.gitignore

@@ -0,0 +1,20 @@
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

.prettierrc

@@ -0,0 +1,6 @@
+{
+  "printWidth": 80,
+  "trailingComma": "none",
+  "tabWidth": 2,
+  "singleQuote": false
+}

README.md

@@ -0,0 +1,3 @@
+# moonlight-mod.github.io
+
+The official website and documentation for [moonlight](https://github.com/moonlight-mod/moonlight).

babel.config.js

@@ -0,0 +1,3 @@
+module.exports = {
+  presets: [require.resolve("@docusaurus/core/lib/babel/preset")]
+};

docs/dev/_category_.json

@@ -0,0 +1,4 @@
+{
+  "label": "moonlight developers",
+  "position": 3
+}

docs/dev/setup.md

@@ -0,0 +1,33 @@
+# Project setup
+
+## Building from source
+
+You will need [pnpm](https://pnpm.io), as moonlight uses it for dependency and workspace management.
+
+- Clone the repository.
+- Install dependencies with `pnpm i`.
+- Build the project with `pnpm run build`.
+  - For working on moonlight, a watch mode is available with `pnpm run dev`.
+
+## Project structure
+
+moonlight is split into a [pnpm workspace](https://pnpm.io/workspaces). The project is comprised of multiple packages:
+
+- `core`: core code and utilities responsible for loading extensions
+- `injector`: the entrypoint for moonlight loaded by the patched Discord client
+  - loads the config and detected extensions from disk and forwards them to the other stages
+  - loads host modules
+  - sets up `node-preload` to be ran when the browser window is created
+- `node-preload`: ran before Discord's code on the Node side
+  - receives the config/detected extensions from `injector` and forwards it to `web-preload`
+  - loads node modules
+  - loads `web-preload` and forwards some inforation to it
+- `web-preload`: ran before Discord's code on the web side
+  - receives the loaded config and detected extensions from `node-preload`
+  - loads extensions and installs their Webpack modules and patches
+- `core-extensions`: built-in extensions that come with every moonlight install, mostly libraries
+- `types`: types for moonlight's core, core extensions, and plugin manifests/exports
+
+## Build system
+
+moonlight uses [esbuild](https://esbuild.github.io) as its build system (`build.mjs`). This script is responsible for outputting `injector`, `node-preload`, and `web-preload` into `dist`, along with all core extensions.

docs/ext-dev/_category_.json

@@ -0,0 +1,4 @@
+{
+  "label": "Extension developers",
+  "position": 2
+}

docs/ext-dev/getting-started.md

@@ -0,0 +1,12 @@
+# Getting started
+
+## Sample extension
+
+A sample extension is provided to start development quickly:
+
+- Pre-configured build system (esbuild)
+- TypeScript support
+- Both web and Node.js entrypoints
+- Example patch & Webpack modules
+
+You can view it [here](https://github.com/moonlight-mod/sample-extension).

docs/ext-dev/helpful-exts.md

@@ -0,0 +1,36 @@
+# Helpful extensions
+
+This is a list of helpful extensions that can be used to aid extension development.
+
+## Config options
+
+These aren't extensions, but rather options in the moonlight config:
+
+- `devSearchPaths`: An array of directories to recursively search for built extensions (`manifest.json`).
+  - When developing extensions, use the `dist` folder instead of the root folder. This is because the `manifest.json` resides in the root of the source code, but does not have the built files, which wastes time resolving files that will never exist.
+- `loggerLevel`: The level to log at. If not set, defaults to `info`.
+- `patchAll`: Set to `true` to wrap every Webpack module in a function. This slows down client starts significantly, but can make debugging easier.
+
+## Common
+
+Common exposes multiple Webpack modules useful for development:
+
+- `common_react`: Discord's version of React (required to be in scope for JSX)
+- `common_flux`: Discord's version of Flux
+- `common_stores`: A proxy around Discord's Flux stores
+  - Access stores as properties, e.g. `require("common_stores").UserStore`
+- `common_http`: A small HTTP client
+
+## Disable Sentry & No Track
+
+Both of these extensions do not provide any utilities, but prevent your client from sending metrics to Discord, which lessens the risk of moonlight related errors being reported. These should always be enabled. These are not magical tools to prevent account suspension, and you should always consider safety when writing an extension (especially one that makes requests automatically).
+
+## Spacepack
+
+Spacepack allows you to find and inspect Webpack modules. The "Add to global scope" setting is suggested, so you can use Spacepack from within DevTools.
+
+- `require`: Standard Webpack require.
+- `inspect`: Fetch a Webpack module by its ID and return an isolated copy of it, which can be double-clicked in DevTools to inspect the source code.
+- `findByCode`, `findByExports`: Returns an array of Webpack modules that has code/exports that match the arguments.
+- `findObjectFromKey`, `findObjectFromValue`, `findObjectFromKeyValuePair`, `findFunctionByStrings`: Search the exports of a Webpack module to find an object or function using the given arguments.
+- `modules`, `cache`: The Webpack modules and cache objects.