Merge branch 'development'

Author: jhett12321

.github/workflows/ci.yml

@@ -7,12 +7,14 @@ on:
       - development
     paths-ignore:
       - '**.md'
+      - 'docs/**'
   pull_request:
     branches:
       - master
       - development
     paths-ignore:
       - '**.md'
+      - 'docs/**'
   workflow_dispatch:
     inputs:
       tag:

NWN.Anvil.csproj

@@ -19,6 +19,7 @@
         <GenerateDocumentationFile>true</GenerateDocumentationFile>
         <EnableDynamicLoading>true</EnableDynamicLoading>
         <IncludeSymbols>true</IncludeSymbols>
+        <DebugSymbols>true</DebugSymbols>
         <SymbolPackageFormat>snupkg</SymbolPackageFormat>
         <RepositoryUrl>https://github.com/nwn-dotnet/Anvil</RepositoryUrl>
         <RepositoryType>git</RepositoryType>

README.md

@@ -122,6 +122,6 @@ Checking in the console or server logs, you should get the following output:
 ## Core Services
 Anvil is bundled with a core set of services that you can depend on in your own plugins and systems.
 
-These services handle game events, task scheduling, and more! Examples of how to use these services can be found in the [Anvil docs](https://nwn-dotnet.github.io/Anvil/classNWN_1_1Services_1_1ServiceBindingAttribute.html#details).
+These services handle game events, task scheduling, and more! Examples of how to use these services can be found in the [Anvil docs](https://nwn-dotnet.github.io/Anvil/classAnvil_1_1Services_1_1ServiceBindingAttribute.html).
 
-You can also find a full list of the services bundled by Anvil [HERE](https://nwn-dotnet.github.io/Anvil/namespaceNWN_1_1Services.html).
+You can also find a full list of the services bundled by Anvil [HERE](https://nwn-dotnet.github.io/Anvil/namespaceAnvil_1_1Services.html).

docs/Doxyfile

@@ -4,7 +4,7 @@
 # Project related configuration options
 #---------------------------------------------------------------------------
 DOXYFILE_ENCODING      = UTF-8
-PROJECT_NAME           = "NWN.Managed"
+PROJECT_NAME           = "Anvil"
 PROJECT_NUMBER         =
 PROJECT_BRIEF          =
 PROJECT_LOGO           =
@@ -82,10 +82,10 @@ SHOW_GROUPED_MEMB_INC  = NO
 FORCE_LOCAL_INCLUDES   = NO
 INLINE_INFO            = YES
 SORT_MEMBER_DOCS       = YES
-SORT_BRIEF_DOCS        = NO
-SORT_MEMBERS_CTORS_1ST = NO
+SORT_BRIEF_DOCS        = YES
+SORT_MEMBERS_CTORS_1ST = YES
 SORT_GROUP_NAMES       = YES
-SORT_BY_SCOPE_NAME     = NO
+SORT_BY_SCOPE_NAME     = YES
 STRICT_PROTO_MATCHING  = NO
 GENERATE_TODOLIST      = YES
 GENERATE_TESTLIST      = YES
@@ -209,7 +209,7 @@ HTML_COLORSTYLE_SAT    = 100
 HTML_COLORSTYLE_GAMMA  = 80
 HTML_TIMESTAMP         = NO
 HTML_DYNAMIC_SECTIONS  = YES
-HTML_INDEX_NUM_ENTRIES = 100
+HTML_INDEX_NUM_ENTRIES = 0
 GENERATE_DOCSET        = NO
 DOCSET_FEEDNAME        = "Doxygen generated docs"
 DOCSET_BUNDLE_ID       = org.doxygen.Project
@@ -221,7 +221,7 @@ HHC_LOCATION           =
 GENERATE_CHI           = NO
 CHM_INDEX_ENCODING     =
 BINARY_TOC             = NO
-TOC_EXPAND             = NO
+TOC_EXPAND             = YES
 GENERATE_QHP           = NO
 QCH_FILE               =
 QHP_NAMESPACE          = org.doxygen.Project

docs/DoxygenLayout.xml

@@ -3,7 +3,7 @@
   <!-- Navigation index tabs for HTML output -->
   <navindex>
     <tab type="mainpage" visible="yes" title=""/>
-    <tab type="classlist" visible="yes" title="API" intro=""/>
+    <tab type="classlist" visible="yes" title="API Reference" intro=""/>
   </navindex>
 
   <!-- Layout definition for a class page -->

src/main/Anvil/API/Async/MainThreadSynchronizationContext.cs

@@ -0,0 +1,89 @@
+using System;
+using System.Collections.Generic;
+using System.Threading;
+using Anvil.Services;
+using NLog;
+
+namespace Anvil.API
+{
+  [ServiceBinding(typeof(MainThreadSynchronizationContext))]
+  [ServiceBinding(typeof(IUpdateable))]
+  [ServiceBindingOptions(BindingOrder.API)]
+  public sealed class MainThreadSynchronizationContext : SynchronizationContext, IUpdateable, IAwaitable
+  {
+    private static readonly Logger Log = LogManager.GetCurrentClassLogger();
+
+    private readonly List<QueuedTask> queuedTasks = new List<QueuedTask>();
+    private readonly List<QueuedTask> currentWork = new List<QueuedTask>();
+
+    void IUpdateable.Update()
+    {
+      lock (queuedTasks)
+      {
+        currentWork.AddRange(queuedTasks);
+        queuedTasks.Clear();
+      }
+
+      try
+      {
+        foreach (QueuedTask task in currentWork)
+        {
+          task.Invoke();
+        }
+      }
+      catch (Exception e)
+      {
+        Log.Error(e);
+      }
+      finally
+      {
+        currentWork.Clear();
+      }
+    }
+
+    public override void Post(SendOrPostCallback callback, object state)
+    {
+      lock (queuedTasks)
+      {
+        queuedTasks.Add(new QueuedTask(callback, state));
+      }
+    }
+
+    public override void Send(SendOrPostCallback callback, object state)
+    {
+      lock (queuedTasks)
+      {
+        queuedTasks.Add(new QueuedTask(callback, state));
+      }
+    }
+
+    public IAwaiter GetAwaiter()
+    {
+      return new SynchronizationContextAwaiter(this);
+    }
+
+    private readonly struct QueuedTask
+    {
+      private readonly SendOrPostCallback callback;
+      private readonly object state;
+
+      public QueuedTask(SendOrPostCallback callback, object state)
+      {
+        this.callback = callback;
+        this.state = state;
+      }
+
+      public void Invoke()
+      {
+        try
+        {
+          callback(state);
+        }
+        catch (Exception e)
+        {
+          Log.Error(e);
+        }
+      }
+    }
+  }
+}