- Finished most of LuaCsSetup top-level functionality.

- Removed some unneeded interface definitions. - Clean-slated some Services that need to be re-written.
2025-02-14 12:34:59 -05:00
parent d2b9ca4c1b
commit 7436ea3e8c
39 changed files with 1009 additions and 2045 deletions
@@ -0,0 +1,88 @@
+using System;
+using System.Collections.Generic;
+using System.Collections.Immutable;
+using System.Reflection;
+using System.Threading.Tasks;
+using Barotrauma.LuaCs.Data;
+using MoonSharp.Interpreter;
+using MoonSharp.Interpreter.Interop;
+
+namespace Barotrauma.LuaCs.Services;
+
+public interface ILuaScriptManagementService : IReusableService
+{
+    #region Script_Ops
+
+    Task<FluentResults.Result> LoadScriptResourcesAsync(ImmutableArray<ILuaScriptResourceInfo> resourcesInfo);
+    
+    FluentResults.Result ExecuteLoadedScripts(ContentPackage package, bool pauseExecutionOnError = false, bool verboseLogging = false);
+    FluentResults.Result ExecuteLoadedScripts(ImmutableArray<ILuaScriptResourceInfo> scripts, bool pauseExecutionOnError = false, bool verboseLogging = false);
+    FluentResults.Result ExecuteLoadedScripts(bool pauseExecutionOnError = false, bool verboseLogging = false);
+    FluentResults.Result DisposePackageResources(ContentPackage package);
+    FluentResults.Result UnloadActiveScripts();
+    FluentResults.Result DisposeAllPackageResources();
+
+    #endregion
+    
+    #region Type_Registration
+
+    IUserDataDescriptor RegisterType(Type type);
+    /// <summary>
+    /// <b>[Deprecated]</b><br/>
+    /// Use <see cref="GetTypeInfo"/>() instead.
+    /// Gets the type information for an already registered type.
+    /// </summary>
+    /// <param name="typeName">The fully qualified name of the type and namespace.</param>
+    /// <returns>The <see cref="IUserDataDescriptor"/> for the type, if registered. Null if none is found.</returns>
+    [Obsolete($"Use {nameof(GetTypeInfo)} instead.")]
+    IUserDataDescriptor RegisterType(string typeName) => GetTypeInfo(typeName);
+    IUserDataDescriptor RegisterGenericType(Type type);
+    /// <summary>
+    /// <b>[Deprecated]</b><br/>
+    /// Use <see cref="GetTypeInfo"/>() instead.
+    /// Gets the generic type information for an already registered type.
+    /// </summary>
+    /// <param name="typeName">The fully qualified name of the generic type and namespace.</param>
+    /// <param name="typeNameArgs">The fully qualified name of the template types.</param>
+    /// <returns>The <see cref="IUserDataDescriptor"/> for the type, if registered. Null if none is found.</returns>
+    [Obsolete($"Use {nameof(GetGenericTypeInfo)} instead.")]
+    IUserDataDescriptor RegisterGenericType(string typeName, params string[] typeNameArgs) => GetGenericTypeInfo(typeName, typeNameArgs);
+    /// <summary>
+    /// Gets the type information for an already registered type.
+    /// </summary>
+    /// <param name="typeName">The fully qualified name of the type and namespace.</param>
+    /// <returns>The <see cref="IUserDataDescriptor"/> for the type, if registered. Null if none is found.</returns>
+    IUserDataDescriptor GetTypeInfo(string typeName);
+    /// <summary>
+    /// Gets the generic type information for an already registered type.
+    /// </summary>
+    /// <param name="typeName">The fully qualified name of the generic type and namespace.</param>
+    /// <param name="typeNameArgs">The fully qualified name of the template types.</param>
+    /// <returns>The <see cref="IUserDataDescriptor"/> for the type, if registered. Null if none is found.</returns>
+    IUserDataDescriptor GetGenericTypeInfo(string typeName, params string[] typeNameArgs);
+    void UnregisterType(Type type);
+    
+    #endregion
+    
+    #region Type_Checks_&Utilities
+    
+    bool IsRegistered(Type type);
+    bool IsTargetType(object obj, string typeName);
+    string TypeOf(object obj);
+    object CreateStatic(string typeName);
+    object CreateEnumTable(string typeName);
+    FieldInfo FindFieldRecursively(Type type, string fieldName);
+    void MakeFieldAccessible(IUserDataDescriptor descriptor, string fieldName);
+    MethodInfo FindMethodRecursively(Type type, string methodName, Type[] types = null);
+    void MakeMethodAccessible(IUserDataDescriptor descriptor, string methodName, string[] parameters = null);
+    PropertyInfo FindPropertyRecursively(Type type, string propertyName);
+    void MakePropertyAccessible(IUserDataDescriptor descriptor, string propertyName);
+    void AddMethod(IUserDataDescriptor descriptor, string methodName, object function);
+    void AddField(IUserDataDescriptor descriptor, string fieldName, DynValue value);
+    void RemoveMember(IUserDataDescriptor descriptor, string memberName);
+    bool HasMember(object obj, string memberName);
+    DynValue CreateUserDataFromDescriptor(DynValue scriptObject, IUserDataDescriptor descriptor);
+    DynValue CreateUserDataFromType(DynValue scriptObject, Type desiredType);
+    
+    #endregion
+}