doc generator + generated stdlib doc

Author: Frotty

.github/workflows/docgen.yml

@@ -0,0 +1,59 @@
+name: Regenerate stdlib reference
+
+# Regenerates the auto-documentation under _doc/stdlib/ref/ from the WurstStdlib2 hotdoc and
+# opens a PR with the result. Runs on demand, weekly, or when WurstStdlib2 dispatches an event.
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: "0 6 * * 1" # Mondays 06:00 UTC
+  repository_dispatch:
+    types: [stdlib-updated]
+
+permissions:
+  contents: write
+  pull-requests: write
+
+concurrency:
+  group: stdlib-docgen
+  cancel-in-progress: true
+
+jobs:
+  docgen:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout website
+        uses: actions/checkout@v4
+
+      - name: Checkout WurstStdlib2
+        uses: actions/checkout@v4
+        with:
+          repository: wurstscript/WurstStdlib2
+          ref: master
+          path: _stdlib
+
+      - name: Set up Deno
+        uses: denoland/setup-deno@v2
+        with:
+          deno-version: v2.x
+
+      - name: Generate reference
+        working-directory: tools/docgen
+        run: deno task gen --src "$GITHUB_WORKSPACE/_stdlib/wurst" --out "$GITHUB_WORKSPACE"
+
+      - name: Open pull request
+        uses: peter-evans/create-pull-request@v6
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          branch: auto/stdlib-docgen
+          delete-branch: true
+          base: master
+          title: "docs(stdlib): regenerate API reference"
+          commit-message: "docs(stdlib): regenerate API reference"
+          body: |
+            Automated regeneration of the stdlib API reference from the latest
+            [WurstStdlib2](https://github.com/wurstscript/WurstStdlib2) hotdoc.
+
+            Generated by `.github/workflows/docgen.yml` (`tools/docgen`).
+          add-paths: |
+            _doc/stdlib/ref/**
+            _data/stdlib_index.json

.gitignore

@@ -1,4 +1,5 @@
 .DS_Store
 config.codekit
 _site
-.jekyll-metadata
+.jekyll-metadata
+_stdlib

_config.yml

@@ -13,6 +13,7 @@ plugins:
 
 exclude:
   - vendor
+  - tools
   - assets/plugins/elegant_font/css/index.html
   - assets/plugins/jquery-match-height/test.html
   - assets/plugins/jquery-scrollTo/demo

_data/stdlib_curated.yml

@@ -0,0 +1,37 @@
+# Maps a stdlib package name to a hand-written "detailed guide" page on this site.
+# The docgen reads this (it never writes it) and adds a prominent "Detailed guide" link to
+# the matching auto-generated reference page. Add an entry when you write a longer-form guide.
+#   PackageName: /stdlib/<path-without-extension>
+
+# Data structures
+HashMap: /stdlib/hash_map
+HashList: /stdlib/hash_list
+LinkedList: /stdlib/linked_list
+BitSet: /stdlib/bitset
+
+# Closures
+ClosureEvents: /stdlib/closure_events
+ClosureForGroups: /stdlib/closure_for_groups
+ClosureTimers: /stdlib/closure_timers
+Execute: /stdlib/execute
+
+# Dummies
+DummyCaster: /stdlib/dummy_caster
+DummyRecycler: /stdlib/dummy_recycler
+
+# Math
+Angle: /stdlib/angle
+Vectors: /stdlib/vectors
+
+# Object editing
+AbilityObjEditing: /stdlib/abil_objed
+BuffObjEditing: /stdlib/buff_objed
+ItemObjEditing: /stdlib/item_objed
+UnitObjEditing: /stdlib/unit_objed
+UpgradeObjEditing: /stdlib/upg_objed
+
+# Core / util
+Assets: /stdlib/assets
+ErrorHandling: /stdlib/errorhandling
+Wurstunit: /stdlib/wurstunit
+DialogBox: /stdlib/dialogbox