version 0.5

.claude/settings.local.json

@@ -0,0 +1,9 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(dotnet build:*)",
+      "Bash(dotnet run:*)"
+    ],
+    "deny": []
+  }
+}

.editorconfig

@@ -39,7 +39,7 @@ dotnet_style_parentheses_in_other_operators = never_if_unnecessary
 dotnet_style_parentheses_in_relational_binary_operators = always_for_clarity
 
 # Modifier preferences
-dotnet_style_require_accessibility_modifiers = for_non_interface_members
+dotnet_style_require_accessibility_modifiers = omit_if_default
 
 # Expression-level preferences
 dotnet_style_coalesce_expression = true
@@ -77,9 +77,9 @@ dotnet_style_allow_statement_immediately_after_block_experimental = true
 #### C# Coding Conventions ####
 
 # var preferences
-csharp_style_var_elsewhere = false
-csharp_style_var_for_built_in_types = false
-csharp_style_var_when_type_is_apparent = false
+csharp_style_var_elsewhere = true
+csharp_style_var_for_built_in_types = true
+csharp_style_var_when_type_is_apparent = true
 
 # Expression-bodied members
 csharp_style_expression_bodied_accessors = true
@@ -104,14 +104,14 @@ csharp_style_conditional_delegate_call = true
 
 # Modifier preferences
 csharp_prefer_static_local_function = true
-csharp_preferred_modifier_order = public,private,protected,internal,file,static,extern,new,virtual,abstract,sealed,override,readonly,unsafe,required,volatile,async
+csharp_preferred_modifier_order = public, private, protected, internal, file, static, extern, new, virtual, abstract, sealed, override, readonly, unsafe, required, volatile, async
 csharp_style_prefer_readonly_struct = true
 csharp_style_prefer_readonly_struct_member = true
 
 # Code-block preferences
 csharp_prefer_braces = true
 csharp_prefer_simple_using_statement = true
-csharp_style_namespace_declarations = block_scoped
+csharp_style_namespace_declarations = file_scoped
 csharp_style_prefer_method_group_conversion = true
 csharp_style_prefer_primary_constructors = true
 csharp_style_prefer_top_level_statements = true
@@ -208,26 +208,26 @@ dotnet_naming_rule.non_field_members_should_be_pascal_case.style = pascal_case
 
 dotnet_naming_symbols.interface.applicable_kinds = interface
 dotnet_naming_symbols.interface.applicable_accessibilities = public, internal, private, protected, protected_internal, private_protected
-dotnet_naming_symbols.interface.required_modifiers = 
+dotnet_naming_symbols.interface.required_modifiers =
 
 dotnet_naming_symbols.types.applicable_kinds = class, struct, interface, enum
 dotnet_naming_symbols.types.applicable_accessibilities = public, internal, private, protected, protected_internal, private_protected
-dotnet_naming_symbols.types.required_modifiers = 
+dotnet_naming_symbols.types.required_modifiers =
 
 dotnet_naming_symbols.non_field_members.applicable_kinds = property, event, method
 dotnet_naming_symbols.non_field_members.applicable_accessibilities = public, internal, private, protected, protected_internal, private_protected
-dotnet_naming_symbols.non_field_members.required_modifiers = 
+dotnet_naming_symbols.non_field_members.required_modifiers =
 
 # Naming styles
 
-dotnet_naming_style.pascal_case.required_prefix = 
-dotnet_naming_style.pascal_case.required_suffix = 
-dotnet_naming_style.pascal_case.word_separator = 
+dotnet_naming_style.pascal_case.required_prefix =
+dotnet_naming_style.pascal_case.required_suffix =
+dotnet_naming_style.pascal_case.word_separator =
 dotnet_naming_style.pascal_case.capitalization = pascal_case
 
 dotnet_naming_style.begins_with_i.required_prefix = I
-dotnet_naming_style.begins_with_i.required_suffix = 
-dotnet_naming_style.begins_with_i.word_separator = 
+dotnet_naming_style.begins_with_i.required_suffix =
+dotnet_naming_style.begins_with_i.word_separator =
 dotnet_naming_style.begins_with_i.capitalization = pascal_case
 
 

CLAUDE.md

@@ -0,0 +1,126 @@
+
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Lua-CSharp is a high-performance Lua interpreter implemented in C# for .NET and Unity. It provides a Lua 5.2 interpreter with async/await integration, Source Generator support for easy C#-Lua interop, and Unity support.
+
+## Common Development Commands
+
+### Building
+```bash
+# Build entire solution
+dotnet build
+
+# Build in Release mode
+dotnet build -c Release
+
+# Build specific project
+dotnet build src/Lua/Lua.csproj
+```
+### Running
+
+Write lua to `sandbox/ConsoleApp1/test.lua`, then:
+```bash
+# Run simple tests
+dotnet run --project sandbox/ConsoleApp1/ConsoleApp1.csproj
+
+# For pattern matching testing, you can run specific Lua scripts like:
+# echo 'print(string.gsub("hello", "()l", function(pos) return "[" .. pos .. "]" end))' > sandbox/ConsoleApp1/test.lua
+# echo 'print(string.gsub("abc", "", "."))' > sandbox/ConsoleApp1/test.lua  
+# echo 'print(string.gsub("(hello) and (world)", "%b()", function(s) return s:upper() end))' > sandbox/ConsoleApp1/test.lua
+```
+
+
+### Testing
+```bash
+# Run all tests
+dotnet test
+
+# Run tests with detailed output
+dotnet test --logger "console;verbosity=detailed"
+
+# Run specific test project
+dotnet test tests/Lua.Tests/Lua.Tests.csproj
+```
+
+### Benchmarking
+```bash
+# Run performance benchmarks
+dotnet run -c Release --project sandbox/Benchmark/Benchmark.csproj
+```
+
+### Packaging
+```bash
+# Create NuGet package
+dotnet pack -c Release
+```
+
+## Architecture Overview
+
+### Core Components
+
+1. **Lua Runtime (`src/Lua/`)**
+   - `LuaState.cs`: Main entry point for Lua execution
+   - `LuaValue.cs`: Represents values in Lua (nil, boolean, number, string, table, function, userdata, thread)
+   - `Runtime/LuaVirtualMachine.cs`: Core VM implementation that executes Lua bytecode
+   - `Runtime/OpCode.cs`, `Runtime/Instruction.cs`: VM instruction definitions
+   - `CodeAnalysis/`: Lexer, parser, and compiler that converts Lua source to bytecode
+
+2. **Source Generator (`src/Lua.SourceGenerator/`)**
+   - Generates code for classes marked with `[LuaObject]` attribute
+   - Enables seamless C#-Lua interop by auto-generating wrapper code
+   - Key file: `LuaObjectGenerator.cs`
+
+3. **Standard Libraries (`src/Lua/Standard/`)**
+   - Implementations of Lua standard libraries (math, string, table, io, etc.)
+   - Entry point: `OpenLibsExtensions.cs`
+
+### Key Design Patterns
+
+1. **Async/Await Integration**
+   - All Lua execution methods are async (`DoStringAsync`, `DoFileAsync`)
+   - LuaFunction can wrap async C# methods
+   - Enables non-blocking execution of Lua scripts
+
+2. **Value Representation**
+   - `LuaValue` is a discriminated union struct
+   - Implicit conversions between C# and Lua types
+   - Zero-allocation for primitive types
+
+3**Memory Management**
+   - Heavy use of object pooling (`Pool.cs`, `PooledArray.cs`, `PooledList.cs`)
+   - Stack-based value types where possible
+   - Careful management of closures and upvalues
+
+### Unity Integration (`src/Lua.Unity/`)
+
+- Custom asset importer for `.lua` files
+- Integration with Unity's Resources and Addressables systems
+- Works with both Mono and IL2CPP
+
+### Testing Structure
+
+- Unit tests in `tests/Lua.Tests/`
+- Lua test suite from official Lua 5.2 in `tests/Lua.Tests/tests-lua/`
+- Benchmarks comparing with MoonSharp and NLua in `sandbox/Benchmark/`
+
+## Important Notes
+
+- The project targets .NET Standard 2.1, .NET 6.0, and .NET 8.0
+- Uses C# 13 language features
+- Heavy use of unsafe code for performance
+- Strings are UTF-16 (differs from standard Lua)
+
+## TODO
+
+- **ILuaStream Interface Changes**: The ILuaStream interface has been updated with new methods:
+  - Added `IsOpen` property to track stream state
+  - Added `ReadNumberAsync()` for reading numeric values (supports formats like "6.0", "-3.23", "15e12", hex numbers)
+  - Changed `ReadLineAsync()` to accept a `keepEol` parameter for controlling line ending behavior
+  - Renamed `ReadStringAsync()` to `ReadAsync()`
+  - Added `CloseAsync()` method for async stream closing
+  - ✅ Implemented `ReadNumberAsync()` in all implementations
+  - Need to properly implement the `keepEol` parameter in `ReadLineAsync()` for TextLuaStream

Lua.slnx

@@ -0,0 +1,16 @@
+<Solution>
+    <Folder Name="/sandbox/">
+        <File Path="sandbox/ConsoleApp2/.gitignore"/>
+        <Project Path="sandbox/Benchmark/Benchmark.csproj"/>
+        <Project Path="sandbox/ConsoleApp1/ConsoleApp1.csproj"/>
+        <Project Path="sandbox/ConsoleApp2/ConsoleApp2.csproj"/>
+        <Project Path="sandbox/JitTest/JitTest.csproj"/>
+    </Folder>
+    <Folder Name="/src/">
+        <Project Path="src/Lua.SourceGenerator/Lua.SourceGenerator.csproj"/>
+        <Project Path="src/Lua/Lua.csproj"/>
+    </Folder>
+    <Folder Name="/tests/">
+        <Project Path="tests/Lua.Tests/Lua.Tests.csproj"/>
+    </Folder>
+</Solution>

README.md

@@ -552,4 +552,4 @@ While `collectgarbage()` is available, it simply calls the corresponding .NET ga
 
 ## License
 
-Lua-CSharp is licensed under the [MIT License](LICENSE).
+Lua-CSharp is licensed under the [MIT License](LICENSE).

sandbox/Benchmark/AddBenchmark.cs

@@ -22,10 +22,11 @@ public void Setup()
         core.Setup("add.lua");
         core.LuaCSharpState.OpenStandardLibraries();
 
-        core.LuaCSharpState.Environment["add"] = new LuaFunction("add", (context, buffer, ct) =>
+        core.LuaCSharpState.Environment["add"] = new LuaFunction("add", (context, ct) =>
         {
-            buffer.Span[0] = context.GetArgument<double>(0) + context.GetArgument<double>(1);
-            return new(1);
+            var a = context.GetArgument<double>(0);
+            var b = context.GetArgument<double>(1);
+            return new(context.Return(a + b));
         });
         core.MoonSharpState.Globals["add"] = (Func<double, double, double>)Add;
         core.NLuaState.RegisterFunction("add", typeof(AddBenchmark).GetMethod(nameof(Add), BindingFlags.Static | BindingFlags.Public));

sandbox/Benchmark/Benchmark.csproj

@@ -1,20 +1,20 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
-  <PropertyGroup>
-    <OutputType>Exe</OutputType>
-    <TargetFramework>net8.0</TargetFramework>
-    <ImplicitUsings>enable</ImplicitUsings>
-    <Nullable>enable</Nullable>
-  </PropertyGroup>
+    <PropertyGroup>
+        <OutputType>Exe</OutputType>
+        <TargetFramework>net8.0</TargetFramework>
+        <ImplicitUsings>enable</ImplicitUsings>
+        <Nullable>enable</Nullable>
+    </PropertyGroup>
 
-  <ItemGroup>
-    <PackageReference Include="BenchmarkDotNet" Version="0.14.0" />
-    <PackageReference Include="MoonSharp" Version="2.0.0" />
-    <PackageReference Include="NLua" Version="1.7.3" />
-  </ItemGroup>
+    <ItemGroup>
+        <PackageReference Include="BenchmarkDotNet" Version="0.14.0"/>
+        <PackageReference Include="MoonSharp" Version="2.0.0"/>
+        <PackageReference Include="NLua" Version="1.7.3"/>
+    </ItemGroup>
 
-  <ItemGroup>
-    <ProjectReference Include="..\..\src\Lua\Lua.csproj" />
-  </ItemGroup>
+    <ItemGroup>
+        <ProjectReference Include="..\..\src\Lua\Lua.csproj"/>
+    </ItemGroup>
 
 </Project>

sandbox/Benchmark/BenchmarkCore.cs

@@ -18,7 +18,7 @@ public class BenchmarkCore : IDisposable
     public void Setup(string fileName)
     {
         // moonsharp
-        moonSharpState = new Script();
+        moonSharpState = new();
         Script.WarmUp();
 
         // NLua

sandbox/Benchmark/HookedBenchmark.cs

@@ -0,0 +1,40 @@
+using BenchmarkDotNet.Attributes;
+using Lua;
+using Lua.Standard;
+
+[Config(typeof(BenchmarkConfig))]
+public class HookedBenchmark
+{
+    BenchmarkCore core = default!;
+    LuaValue[] buffer = new LuaValue[1];
+
+    [IterationSetup]
+    public void Setup()
+    {
+        core = new();
+        core.Setup("hooked.lua");
+        core.LuaCSharpState.OpenStandardLibraries();
+    }
+
+    [IterationCleanup]
+    public void Cleanup()
+    {
+        core.Dispose();
+        core = default!;
+        GC.Collect();
+    }
+
+
+    [Benchmark(Description = "NLua (DoString)", Baseline = true)]
+    public object[] Benchmark_NLua_String()
+    {
+        return core.NLuaState.DoString(core.SourceText);
+    }
+
+    [Benchmark(Description = "Lua-CSharp (DoString)")]
+    public async Task<LuaValue> Benchmark_LuaCSharp_String()
+    {
+        await core.LuaCSharpState.DoStringAsync(core.SourceText, buffer);
+        return buffer[0];
+    }
+}