C# Compiler

.envrc

@@ -0,0 +1 @@
+use flake . --no-pure-eval --accept-flake-config

.gitattributes

@@ -0,0 +1,6 @@
+* text=auto eol=lf
+
+*.cmd text eol=crlf
+*.bat text eol=crlf
+*.vbs text eol=crlf
+*.bas text eol=crlf

.github/workflows/build.yaml

@@ -0,0 +1,35 @@
+name: Build Compiler
+
+on:
+  push:
+    branches: [ master ]
+    paths: ["src/Compiler/**", ".github/workflows/build.yaml"]
+  pull_request:
+    paths: ["src/Compiler/**", ".github/workflows/build.yaml"]
+  workflow_call:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup DotNet
+        uses: actions/setup-dotnet@v4
+        with:
+          cache: true
+          dotnet-version: 10.0.x
+          cache-dependency-path: "src/Compiler/packages.lock.json"
+
+      - name: Install dependencies
+        run: dotnet restore
+
+      - name: Build
+        run: dotnet publish ./src/Compiler/Compiler.csproj -c Release -r win-x64
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: Compiler
+          path: ./src/Compiler/bin/Release/win-x64/publish/Compiler.exe

.github/workflows/compile-scripts.yaml

@@ -0,0 +1,87 @@
+name: Powershell Compiler
+
+on:
+  push:
+    branches: [master]
+    paths: [ "src/**/*.ps1", ".github/workflows/compile-scripts.yaml" ]
+  pull_request:
+    paths: [ "src/**/*.ps1", ".github/workflows/compile-scripts.yaml" ]
+  workflow_dispatch:
+
+jobs:
+  changes:
+    runs-on: ubuntu-latest
+    outputs:
+      compiled: ${{ steps.changes.outputs.compiled }}
+      src: ${{ steps.changes.outputs.src }}
+      src_deleted: ${{ steps.changes.outputs.src_deleted }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+        # Checks for changes in the 'compiled' and 'src' directories
+        # We also check for deleted files so we can cleanup the compiled directory
+      - name: Collect Changes for Upcoming Jobs
+        uses: dorny/[email protected]
+        id: changes
+        with:
+          list-files: shell
+          filters: |
+            compiled:
+              - 'compiled/**'
+            src:
+              - 'src/**/*.(ps1|psm1)'
+            src_deleted:
+              - deleted: 'src/**/*.(ps1|psm1)'
+
+  cleanup-directory:
+    runs-on: ubuntu-latest
+    needs: changes
+    if: needs.changes.outputs.src_deleted == 'true'
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Delete Compiled versions of deleted files
+        id: delete_files
+        run: ./utils/clean-compiled.sh
+
+      - name: Commit Changes
+        if: ${{ steps.delete_files.outputs.FOUND_DELETED == 'true' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch') }}
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "chore(compiled): Remove compiled versions of deleted files"
+
+  build:
+    uses: ./.github/workflows/build.yaml
+
+  compile-scripts:
+    runs-on: windows-latest
+    needs: [changes, build]
+    if: ${{ needs.changes.outputs.src == 'true' }}
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Download Compiler Artifact
+        uses: dawidd6/action-download-artifact@v6
+        with:
+          workflow: build.yaml
+          workflow_conclusion: success
+          name: Compiler
+          path: /tmp/Compiler
+
+      - name: Run Compiler
+        shell: pwsh
+        run: /tmp/Compiler/Compiler.exe --input src --output compiled --force -vvv -f
+
+      - name: Commit Changes
+        if: ${{ github.event_name == 'workflow_dispatch' || (needs.changes.outputs.src == 'true' && github.event_name == 'push') }}
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "chore(compiled): Compile scripts"

.github/workflows/documentation.yaml

@@ -1,18 +1,20 @@
-name: Documentaion
+name: Generate PowerShell Docs
 
 on:
   push:
-    branches: [ master ]
-    paths: [ 'docs/**', 'src/**', 'utils/Generate-Documentation.ps1', '.github/workflows/documentation.yaml' ]
-  pull_request:
-    paths: [ 'docs/**', 'src/**' ]
+    branches: [master]
+    paths:
+      - "docs/**"
+      - "src/**"
+      - "utils/Generate-Documentation.ps1"
+      - ".github/workflows/documentation.yaml"
 
 jobs:
   update_docs:
     name: Update Documentation
     runs-on: ubuntu-latest
     outputs:
-      changes: ${{ steps.changes.outputs.changes }}
+      docs: ${{ steps.changes.outputs.docs }}
     permissions:
       contents: write
       pull-requests: write
@@ -23,7 +25,9 @@ jobs:
 
       - name: Generate Documentation
         shell: pwsh
-        run: .\utils\Generate-Documentation.ps1
+        run: |
+          Install-Module -Name platyPS -Scope CurrentUser
+          .\utils\Generate-Documentation.ps1
 
       - name: Check for changes
         id: changes
@@ -34,7 +38,7 @@ jobs:
               - 'docs/docs/**'
 
       - name: Commit changes
-        if: ${{ steps.changes.outputs.changes == 'true' }}
+        if: ${{ steps.changes.outputs.docs == 'true' }}
         uses: stefanzweifel/git-auto-commit-action@v5
         with:
           commit_message: "chore(docs): Update documentation"
@@ -43,7 +47,7 @@ jobs:
     name: Deploy Documentation
     runs-on: ubuntu-latest
     needs: update_docs
-    if : ${{ github.event_name == 'push' && needs.update_docs.outputs.changes.docs == 'true' }}
+    if: ${{ github.event_name == 'push' && needs.update_docs.outputs.docs == 'true' }}
     permissions:
       contents: read
       pull-requests: read

.github/workflows/external.yaml

@@ -0,0 +1,30 @@
+name: External Script Updater
+
+on:
+  workflow_dispatch:
+  push:
+    paths: [ 'src/external/source/**', 'src/external/Update.ps1' ]
+  schedule:
+    - cron: '0 0 * * *'
+
+jobs:
+  update:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Run Update Script
+        shell: pwsh
+        run: ./src/external/Update.ps1
+
+      - name: Validate Scripts
+        shell: pwsh
+        run: ./src/external/Update.ps1 -Validate
+
+      - name: Commit Changes
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "chore(external): Update external scripts"
+          file_pattern: "src/external/scripts/*"

.github/workflows/generate.yaml

@@ -0,0 +1,64 @@
+name: Generate Scripts
+
+on:
+  push:
+    branches: [master]
+    paths:
+      - "src/automation/registry/Generate.ps1"
+      - "src/automation/registry/definitions/**"
+      - ".github/workflows/generate.yaml"
+
+jobs:
+  generate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Collect Changes
+        uses: dorny/[email protected]
+        id: changes
+        with:
+          list-files: shell
+          filters: |
+            definition:
+              - 'src/automation/registry/definitions/**'
+            definition_deleted:
+              - deleted: 'src/automation/registry/definitions/**'
+
+      - name: Remove Deleted Definitions
+        id: delete_files
+        if: ${{ steps.changes.outputs.definition_deleted == 'true' }}
+        run: |
+          shopt -s globstar nullglob
+          for file in src/automation/registry/definitions/**; do
+            no_prefix=${file#src/automation/registry/definitions/}
+            if [ ! -f "src/automation/registry/Generate.ps1" ]; then
+              echo "Found deleted definition file ${no_prefix}, deleting."
+              rm "$file"
+            fi
+          done
+
+          DIR="src/automation/registry"
+          DEFINITIONS_DIR="${DIR}/definitions"
+          GENERATED_DIR="${DIR}/generated"
+          for file in "${GENERATED_DIR}"/*; do
+            no_prefix=${file#"$GENERATED_DIR"/}
+            without_extension=${no_prefix%.*}
+            fullWithoutExtension="${DEFINITIONS_DIR}/${without_extension}"
+            if [ ! -f "$fullWithoutExtension.json" ] && [ ! -f "$fullWithoutExtension.jsonc" ]; then
+              echo "FOUND_DELETED=true" >> "$GITHUB_OUTPUT"
+              echo "Found deleted generated file ${no_prefix}, deleting."
+              rm "$file"
+            fi
+          done
+          echo "Cleanup completed."
+
+      - name: Execute Generate Script
+        if: ${{ steps.changes.outputs.definition == 'true' }}
+        run: pwsh src/automation/registry/Generate.ps1
+
+      - name: Commit Changes
+        if: ${{ (steps.changes.outputs.definition == 'true' || steps.delete_files.outputs.FOUND_DELETED == 'true') && github.event_name == 'push' }}
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "chore(Generated): Update generated scripts"