v1.2.0 (#3)

.github/workflows/docs.yml

@@ -0,0 +1,29 @@
+name: Deploy Docs
+
+on:
+  push:
+    branches:
+      - default
+
+jobs:
+  deploy:
+    name: Build and Deploy Docs
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v2
+
+      - name: Setup Node LTS
+        uses: actions/setup-node@v2
+        with:
+          node-version: lts
+
+      - name: Install Moonwave
+        run: npm install -g moonwave
+
+      - name: Publish Docs
+        run: moonwave build --publish
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/publish.yml

@@ -0,0 +1,78 @@
+name: Publish Package
+
+env:
+  ASSET_ID_STABLE: 6573728888
+
+on:
+  workflow_dispatch:
+  release:
+    types: [published]
+
+jobs:
+  publish-public:
+    runs-on: ubuntu-latest
+    timeout-minutes: 8
+
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v2
+
+      - name: Test Roblox Login Tokens
+        shell: bash
+        run: |
+          if [ -z "${{ secrets.ROBLOSECURITY }}" ]; then
+            echo "No cookie found. Please set the ROBLOSECURITY secret."
+            exit 1
+          fi
+
+          RBX_USERNAME=$(curl -s -X GET -H "Cookie: .ROBLOSECURITY=${{ secrets.ROBLOSECURITY }}" https://users.roblox.com/v1/users/authenticated | jq -r ".name")
+
+          if [ -z "$RBX_USERNAME" ]; then
+            echo "ROBLOSECURITY is invalid or expired. Please reset the ROBLOSECURITY secret."
+            exit 1
+          fi
+
+          echo "Logged in as $RBX_USERNAME."
+
+      - name: Setup Node LTS
+        uses: actions/setup-node@v2
+        with:
+          node-version: lts
+
+      - name: Setup Toolchain
+        uses: Roblox/setup-foreman@v1
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Report Tool Versions
+        run: |
+          foreman list
+          npm -v
+          node -v
+
+      - name: Install Dependencies
+        run: |
+          npm install
+          wally install
+
+      - name: Remove Tests
+        run: |
+          find . -name "*.spec.lua" -delete
+
+      - name: Publish to Roblox
+        if: ${{ github.event.release.prerelease == false }}
+        shell: bash
+        run: rojo upload default.project.json --asset_id $ASSET_ID_STABLE --cookie "${{ secrets.ROBLOSECURITY }}"
+
+      - name: Publish to Wally
+        env:
+          WALLY_TOKEN: ${{ secrets.WALLY_TOKEN }}
+        run: |
+          mkdir =p ~/.wally
+          printf "[tokens]\n\"https://api.wally.run/\" = \"%s\"" "$WALLY_TOKEN" >> ~/.wally/auth.toml
+          wally publish
+
+      - name: Publish to NPM
+        uses: JS-DevTools/npm-publish@v1
+        with:
+          token: ${{ secrets.NPM_TOKEN }}

.github/workflows/release.yml

@@ -0,0 +1,72 @@
+name: Create GitHub Release
+
+on:
+  workflow_dispatch:
+    branches:
+      - default
+
+jobs:
+  create-release:
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v2
+
+      - name: Ensure Wally+NPM Version Numbers Match
+        run: |
+          NPM_VERSION=$( jq -r '.version' package.json )
+          WALLY_VERSION=$( grep -Po '(?<=version = ")([^"]+)' wally.toml )
+
+          if [ -z "$NPM_VERSION" ]; then
+            echo "NPM version not found in package.json"
+            exit 1
+          fi
+
+          if [ -z "$WALLY_VERSION" ]; then
+            echo "Wally version not found in wally.toml"
+            exit 1
+          fi
+
+          if [ "$WALLY_VERSION" != "$NPM_VERSION" ]; then
+            echo "Wally version ($WALLY_VERSION) does not match NPM version ($NPM_VERSION)"
+            exit 1
+          fi
+
+      - name: Setup Toolchain
+        uses: Roblox/setup-foreman@v1
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          version: "^1.0.1"
+
+      - name: Report Tool Versions
+        run: foreman list
+
+      - name: Get Release Details
+        shell: bash
+        run: echo "PROJECT_VERSION=`grep -Po '(?<=version = ")([^"]+)' wally.toml`" >> $GITHUB_ENV
+
+      - name: Set Release Filename
+        shell: bash
+        run: |
+          echo "RELEASE_FILENAME=${{ github.event.repository.name }}-$PROJECT_VERSION.rbxm" >> $GITHUB_ENV
+
+      - name: Install Dependencies
+        run: wally install
+
+      - name: Remove Tests
+        run: |
+          find . -name "*.spec.lua" -delete
+
+      - name: Build Project
+        run: rojo build default.project.json -o $RELEASE_FILENAME
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v1
+        with:
+          name: ${{ env.PROJECT_VERSION }}
+          tag_name: ${{ env.PROJECT_VERSION }}
+          fail_on_unmatched_files: true
+          files: |
+            ${{ env.RELEASE_FILENAME }}
+          draft: true

.gitignore

@@ -7,4 +7,5 @@ node_modules/
 *.tsbuildinfo
 include/
 out/
+build/
 *packages/

.vscode/extensions.json

@@ -3,6 +3,8 @@
     "kampfkarren.selene-vscode",
     "nightrains.robloxlsp",
     "evaera.vscode-rojo",
-    "redhat.vscode-yaml"
+    "redhat.vscode-yaml",
+    "johnnymorganz.stylua",
+    "bungcip.better-toml"
   ]
 }

.vscode/scripts/run-tests.ps1

@@ -1,4 +1,6 @@
+$FILE_NAME = "test-place"
+
 foreman install
-rojo build .\test.project.json -o .\test-place.rbxlx
-run-in-roblox --place .\test-place.rbxlx --script .\test-runner.server.lua
-Remove-Item -Force .\test-place.rbxlx
+rojo build .\test.project.json -o ".\$FILE_NAME.rbxl"
+run-in-roblox --place ".\$FILE_NAME.rbxl" --script ".\test-runner.server.lua"
+Remove-Item -Force ".\$FILE_NAME.rbxl"

.vscode/settings.json

@@ -1,5 +1,8 @@
 {
-  "git.ignoreSubmodules": true,
-  "git.autoRepositoryDetection": "openEditors",
-  "git.detectSubmodules": false
+  "robloxLsp.diagnostics.severity": {
+    "unused-local": "Error",
+    "unused-function": "Error",
+    "unused-vararg": "Error",
+    "duplicate-index": "Error"
+  }
 }