Consolidate interpreter window access and replace WheelHandler singleton with ControlDeck-owned dependency

.github/workflows/docs.yml

@@ -0,0 +1,78 @@
+name: docs
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+# Allow one concurrent deployment
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install Doxygen and Graphviz
+        run: sudo apt-get install -y doxygen graphviz
+
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+
+      - name: Install Jekyll dependencies
+        run: |
+          cd docs
+          bundle install
+
+      - name: Generate Doxygen API docs
+        run: doxygen Doxyfile
+
+      - name: Build Jekyll site
+        run: |
+          cd docs
+          bundle exec jekyll build \
+            --destination ../_site
+
+      - name: Copy Doxygen output into site
+        run: cp -r doxygen_out/html _site/api
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: _site
+
+      - name: Upload site preview artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: site-preview
+          path: _site
+          retention-days: 7
+
+  deploy:
+    if: github.ref == 'refs/heads/main'
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Configure Pages
+        uses: actions/configure-pages@v5
+        with:
+          enablement: true
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -371,4 +371,8 @@ extern/nlohmann-json/*_jsonConfig*
 *.pbxproj
 *.xcworkspace
 *.xcsettings
-build*
+build*
+doxygen_out/
+docs/_site/
+docs/.jekyll-cache/
+docs/Gemfile.lock

CMakeLists.txt

@@ -8,6 +8,8 @@ if(POLICY CMP0141)
 endif()
 
 option(NON_PORTABLE "Build a non-portable version" OFF)
+option(INCLUDE_PROFILING "Enable action and tickable profiling timers" OFF)
+option(COMPONENT_THREAD_SAFE "Enable thread safety for Component parent/child lists" OFF)
 option(DISABLE_DLL_LOADER "Disable dynamic library loading support" OFF)
 option(ENABLE_SCRIPTING "Enable TCC-based C mod compilation and scripting system" OFF)
 

Doxyfile

@@ -0,0 +1,117 @@
+# Doxyfile for libultraship
+# Run: doxygen Doxyfile
+
+#---------------------------------------------------------------------------
+# Project
+#---------------------------------------------------------------------------
+PROJECT_NAME           = "libultraship"
+PROJECT_BRIEF          = "Reimplementations of libultra (N64 SDK) functions for modern hardware"
+PROJECT_LOGO           =
+
+#---------------------------------------------------------------------------
+# Input
+#---------------------------------------------------------------------------
+INPUT                  = include/ README.md
+RECURSIVE              = YES
+FILE_PATTERNS          = *.h *.hpp *.md
+EXTENSION_MAPPING      =
+USE_MDFILE_AS_MAINPAGE = README.md
+EXCLUDE                = include/libultraship/libultra
+EXCLUDE_PATTERNS       = */fast/README.md
+
+#---------------------------------------------------------------------------
+# Output
+#---------------------------------------------------------------------------
+OUTPUT_DIRECTORY       = doxygen_out
+GENERATE_HTML          = YES
+HTML_OUTPUT            = html
+GENERATE_LATEX         = NO
+
+#---------------------------------------------------------------------------
+# Extraction
+#---------------------------------------------------------------------------
+EXTRACT_ALL            = YES
+EXTRACT_STATIC         = YES
+EXTRACT_PRIVATE        = NO
+EXTRACT_ANON_NSPACES   = NO
+
+#---------------------------------------------------------------------------
+# Filtering
+#---------------------------------------------------------------------------
+# Define all feature-gate and platform macros so Doxygen sees the complete API
+# surface.  OS macros are defined simultaneously so that every platform-specific
+# code path appears in the generated documentation.
+PREDEFINED             = INCLUDE_MPQ_SUPPORT \
+                         INCLUDE_PROFILING \
+                         COMPONENT_THREAD_SAFE \
+                         INIT_EVENT_IDS \
+                         ENABLE_SCRIPTING \
+                         ENABLE_OPENGL \
+                         ENABLE_DX11 \
+                         ENABLE_DX12 \
+                         DECLARE_GFX_DXGI_FUNCTIONS \
+                         USE_OPENGLES \
+                         USE_GBI_TRACE \
+                         _WIN32 \
+                         _MSC_VER \
+                         __APPLE__ \
+                         __linux__ \
+                         __OpenBSD__ \
+                         __cplusplus
+
+# Exclude symbols that live outside the Ship / LUS / Fast namespace hierarchy.
+# This includes:
+#   - Objective-C bridge namespaces used by Metal headers (MTL, CA, NS).
+#   - The tinyxml2 library namespace exposed by forward declarations.
+#   - Global-scope utility classes (StringHelper, Path, DiskFile, Directory,
+#     BitConverter, Endianness) that have not yet been moved into a Ship sub-namespace.
+#   - Global-scope C-compatible structs/enums from fast/interpreter.h
+#     (ColorCombinerKey, CCFeatures, ShaderOpts) that must remain at global scope
+#     for C-linkage but are not part of the public C++ API.
+EXCLUDE_SYMBOLS        = MTL MTL::* CA CA::* NS NS::* tinyxml2 tinyxml2::* \
+                         StringHelper \
+                         Path \
+                         DiskFile \
+                         Directory \
+                         BinaryReader \
+                         BitConverter \
+                         Endianness \
+                         ColorCombinerKey \
+                         CCFeatures \
+                         ShaderOpts
+
+#---------------------------------------------------------------------------
+# Source browsing
+#---------------------------------------------------------------------------
+SOURCE_BROWSER         = NO
+INLINE_SOURCES         = NO
+
+#---------------------------------------------------------------------------
+# Graphs (requires Graphviz)
+#---------------------------------------------------------------------------
+HAVE_DOT               = YES
+DOT_IMAGE_FORMAT       = svg
+INTERACTIVE_SVG        = YES
+CLASS_GRAPH            = YES
+COLLABORATION_GRAPH    = YES
+INCLUDE_GRAPH          = YES
+INCLUDED_BY_GRAPH      = YES
+CALL_GRAPH             = NO
+CALLER_GRAPH           = NO
+DIRECTORY_GRAPH        = YES
+DOT_CLEANUP            = YES
+
+#---------------------------------------------------------------------------
+# Messages
+#---------------------------------------------------------------------------
+QUIET                  = YES
+WARNINGS               = YES
+WARN_IF_UNDOCUMENTED   = NO
+
+#---------------------------------------------------------------------------
+# HTML appearance
+#---------------------------------------------------------------------------
+GENERATE_TREEVIEW      = YES
+DISABLE_INDEX          = NO
+FULL_SIDEBAR           = NO
+HTML_COLORSTYLE        = AUTO_LIGHT

docs/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gem "just-the-docs", "~> 0.10"

docs/PORTING.md

@@ -1,3 +1,9 @@
+---
+title: Porting Guide
+parent: Guides
+nav_order: 1
+---
+
 # Libultraship (LUS) Porting Guide
 
 **Libultraship (LUS)** is a library designed to facilitate PC ports of Nintendo 64 games. It is not a recompilation tool; rather, it allows developers to build a game's original source code (derived from decompilation) on modern hardware by providing a header-compatible wrapper around modern reimplementations of N64 SDK functions.

docs/SCRIPTING.md

@@ -1,3 +1,9 @@
+---
+title: Scripting
+parent: Guides
+nav_order: 2
+---
+
 # Scripting System
 
 This document covers the C-based mod scripting system — how archives are structured, how the manifest is parsed, how signing and integrity verification work, and how to write a mod using the event system.

docs/_config.yml

@@ -0,0 +1,25 @@
+title: libultraship
+description: >-
+  A library providing reimplementations of libultra (N64 SDK) functions
+  for modern hardware. Enables PC ports of N64 games.
+
+theme: just-the-docs
+
+url: "https://kenix3.github.io"
+baseurl: "/libultraship"
+
+aux_links:
+  GitHub: "https://github.com/Kenix3/libultraship"
+
+aux_links_new_tab: true
+
+nav_external_links:
+  - title: API Reference
+    url: api/index.html
+    hide_icon: false
+
+# Exclude source files Jekyll should not process
+exclude:
+  - Gemfile
+  - Gemfile.lock
+  - "*.gemspec"