Fixes issues #2, #7, #8, #9, #11

LuaTests.xcodeproj/xcshareddata/xcschemes/LuaTests.xcscheme

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "0630"
+   LastUpgradeVersion = "1630"
    version = "1.3">
    <BuildAction
       parallelizeBuildables = "YES"
@@ -23,10 +23,19 @@
       </BuildActionEntries>
    </BuildAction>
    <TestAction
+      buildConfiguration = "Debug"
       selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
       selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
-      shouldUseLaunchSchemeArgsEnv = "YES"
-      buildConfiguration = "Debug">
+      shouldUseLaunchSchemeArgsEnv = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "E47E87251B04845B00108EAE"
+            BuildableName = "LuaTests.xctest"
+            BlueprintName = "LuaTests"
+            ReferencedContainer = "container:LuaTests.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
       <Testables>
          <TestableReference
             skipped = "NO">
@@ -39,24 +48,16 @@
             </BuildableReference>
          </TestableReference>
       </Testables>
-      <MacroExpansion>
-         <BuildableReference
-            BuildableIdentifier = "primary"
-            BlueprintIdentifier = "E47E87251B04845B00108EAE"
-            BuildableName = "LuaTests.xctest"
-            BlueprintName = "LuaTests"
-            ReferencedContainer = "container:LuaTests.xcodeproj">
-         </BuildableReference>
-      </MacroExpansion>
    </TestAction>
    <LaunchAction
+      buildConfiguration = "Debug"
       selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
       selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
       launchStyle = "0"
       useCustomWorkingDirectory = "NO"
-      buildConfiguration = "Debug"
       ignoresPersistentStateOnLaunch = "NO"
       debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
       allowLocationSimulation = "YES">
       <MacroExpansion>
          <BuildableReference
@@ -67,14 +68,12 @@
             ReferencedContainer = "container:LuaTests.xcodeproj">
          </BuildableReference>
       </MacroExpansion>
-      <AdditionalOptions>
-      </AdditionalOptions>
    </LaunchAction>
    <ProfileAction
+      buildConfiguration = "Release"
       shouldUseLaunchSchemeArgsEnv = "YES"
       savedToolIdentifier = ""
       useCustomWorkingDirectory = "NO"
-      buildConfiguration = "Release"
       debugDocumentVersioning = "YES">
       <MacroExpansion>
          <BuildableReference

LuaTests.xcodeproj/xcshareddata/xcschemes/obj2lua-ios.xcscheme

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "0630"
+   LastUpgradeVersion = "1630"
    version = "1.3">
    <BuildAction
       parallelizeBuildables = "YES"
@@ -23,21 +23,22 @@
       </BuildActionEntries>
    </BuildAction>
    <TestAction
+      buildConfiguration = "Debug"
       selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
       selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
-      shouldUseLaunchSchemeArgsEnv = "YES"
-      buildConfiguration = "Debug">
+      shouldUseLaunchSchemeArgsEnv = "YES">
       <Testables>
       </Testables>
    </TestAction>
    <LaunchAction
+      buildConfiguration = "Debug"
       selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
       selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
       launchStyle = "0"
       useCustomWorkingDirectory = "NO"
-      buildConfiguration = "Debug"
       ignoresPersistentStateOnLaunch = "NO"
       debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
       allowLocationSimulation = "YES">
       <MacroExpansion>
          <BuildableReference
@@ -48,14 +49,12 @@
             ReferencedContainer = "container:LuaTests.xcodeproj">
          </BuildableReference>
       </MacroExpansion>
-      <AdditionalOptions>
-      </AdditionalOptions>
    </LaunchAction>
    <ProfileAction
+      buildConfiguration = "Release"
       shouldUseLaunchSchemeArgsEnv = "YES"
       savedToolIdentifier = ""
       useCustomWorkingDirectory = "NO"
-      buildConfiguration = "Release"
       debugDocumentVersioning = "YES">
       <MacroExpansion>
          <BuildableReference

LuaTests.xcodeproj/xcshareddata/xcschemes/objc2lua.xcscheme

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "0630"
+   LastUpgradeVersion = "1630"
    version = "1.3">
    <BuildAction
       parallelizeBuildables = "YES"
@@ -23,10 +23,19 @@
       </BuildActionEntries>
    </BuildAction>
    <TestAction
+      buildConfiguration = "Debug"
       selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
       selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
-      shouldUseLaunchSchemeArgsEnv = "YES"
-      buildConfiguration = "Debug">
+      shouldUseLaunchSchemeArgsEnv = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "D4A9E61718A95F6F002A9EA5"
+            BuildableName = "libobjc2lua.a"
+            BlueprintName = "objc2lua"
+            ReferencedContainer = "container:LuaTests.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
       <Testables>
          <TestableReference
             skipped = "NO">
@@ -39,24 +48,18 @@
             </BuildableReference>
          </TestableReference>
       </Testables>
-      <MacroExpansion>
-         <BuildableReference
-            BuildableIdentifier = "primary"
-            BlueprintIdentifier = "D4A9E61718A95F6F002A9EA5"
-            BuildableName = "libobjc2lua.a"
-            BlueprintName = "objc2lua"
-            ReferencedContainer = "container:LuaTests.xcodeproj">
-         </BuildableReference>
-      </MacroExpansion>
    </TestAction>
    <LaunchAction
+      buildConfiguration = "Debug"
       selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
       selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      enableAddressSanitizer = "YES"
+      enableUBSanitizer = "YES"
       launchStyle = "0"
       useCustomWorkingDirectory = "NO"
-      buildConfiguration = "Debug"
       ignoresPersistentStateOnLaunch = "NO"
       debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
       allowLocationSimulation = "YES">
       <MacroExpansion>
          <BuildableReference
@@ -68,13 +71,18 @@
          </BuildableReference>
       </MacroExpansion>
       <AdditionalOptions>
+         <AdditionalOption
+            key = "NSZombieEnabled"
+            value = "YES"
+            isEnabled = "YES">
+         </AdditionalOption>
       </AdditionalOptions>
    </LaunchAction>
    <ProfileAction
+      buildConfiguration = "Release"
       shouldUseLaunchSchemeArgsEnv = "YES"
       savedToolIdentifier = ""
       useCustomWorkingDirectory = "NO"
-      buildConfiguration = "Release"
       debugDocumentVersioning = "YES">
       <MacroExpansion>
          <BuildableReference

README.md

@@ -1,60 +1,77 @@
 ObjC-Lua
 ========
 
-A simple Objective-C <-> Lua bridge modeled after iOS 7's JavaScriptCore.
+A simple Objective-C <-> Lua bridge modeled after iOS 7's and macOS'
+[JavaScriptCore](https://developer.apple.com/documentation/javascriptcore).
 
 A trivial use might look like this:
+
 ```objective-c
 static NSString *const myScript =
 LUA_STRING(
-           globalVar = { 0.0, 1.0 }
-
-           function myFunction(parameter)
-               return parameter >= globalVar[1] and parameter <= globalVar[2]
-           end
+  globalVar = { 0.0, 1.0 }
+
+  function myFunction(parameter)
+    return parameter >= globalVar[1] and parameter <= globalVar[2]
+  end
+
+  return doubleThisValue(2) * 3
 );
 
 - (void)doLua {
     LuaContext *ctx = [LuaContext new];
+
+    // install the global function `doubleThisValue` as a block
+    ctx[@"doubleThisValue"] = ^(NSNumber *v) {
+        // we receive and return NSNumber objects, not plain ints!
+        return @(v.integerValue * 2);
+    };
+
     NSError *error = nil;
     if( ! [ctx parse:myScript error:&error] ) {
         NSLog(@"Error parsing lua script: %@", error);
         return;
     }
+
+    NSLog(@"the script returned: %@ (should be 12)", ctx.parseResult);
 
-    NSLog(@"globalVar is: %@", ctx[@"globalVar"]); // should print "globalVar is: [ 0.0, 1.0 ]"
+    NSLog(@"globalVar is: %@ (should be “(0,1)”)", ctx[@"globalVar"]);
 
-    id result = [ctx call:@"myFunction" args:@[ @0.5 ] error:&error];
+    id result = [ctx call:"myFunction" with:@[ @0.5 ] error:&error];
     if( error ) {
         NSLog(@"Error calling myFunction: %@", error);
         return;
     }
-    NSLog(@"myFunction returned: %@", result); // should print "myFunction returned: '1'"
+    NSLog(@"myFunction returned: %@ (should be 1)", result);
 
-    ctx[@"globalVar"] = @[ 0.2, 0.4 ];
+    ctx[@"globalVar"] = @[ @0.2, @0.4 ];
+    NSLog(@"globalVar is: %@ (should be “(0.2,0.4)”)", ctx[@"globalVar"]);
 
-    result = [ctx call:@"myFunction" args:@[ @0.5 ] error:&error];
+    result = [ctx call:"myFunction" with:@[ @0.5 ] error:&error];
     if( error ) {
         NSLog(@"Error calling myFunction: %@", error);
         return;
     }
-    NSLog(@"myFunction returned: %@", result); // should print "myFunction returned: '0'"
+    NSLog(@"myFunction returned: %@ (should be 0)", result);
 }
 ```
 
-A more complex use might be:
+Here's a more complex use that involves an entire
+class exposed to Lua (via the `LuaExport` protocol,
+similar to [JSExport](https://developer.apple.com/documentation/javascriptcore/jsexport)).
+
 ```objective-c
 static NSString *const myScript =
 LUA_STRING(
-           function moveView(view)
-               local center = view.center
-               center.y = center.y + 5
-               center.x = center.x + 5
-               view.center = center
-           end
+    function moveView(view)
+        local center = view.center
+        center.y = center.y + 5
+        center.x = center.x + 5
+        view.center = center
+    end
 );
 
-@protcol UIViewLuaExports <LuaExport>
+@protocol UIViewLuaExports <LuaExport>
 
 @property(nonatomic) CGFloat alpha;
 @property(nonatomic) CGRect bounds;
@@ -78,7 +95,7 @@ LUA_STRING(
         return;
     }
 
-    [ctx call:@"moveView" args:@[ onView ] error:&error];
+    [ctx call:"moveView" with:@[ onView ] error:&error];
     if( error ) {
         NSLog(@"Error calling myFunction: %@", error);
         return;

classes/LuaCallable.h

@@ -0,0 +1,28 @@
+//
+//  LuaCallable.h
+//  LuaTests
+//
+//  Created by Brian Pedersen on 03/08/2024.
+//  Copyright © 2024 Sean Meiners. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "lua.h"
+#import "lauxlib.h"
+#import "lualib.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+@class LuaContext;
+
+@interface LuaCallable : NSObject
+
+@property (readonly) int handle;
+@property (readonly,assign) lua_State *L;
+
+- (id)initWithState:(lua_State *)L index:(int)index;
+- (void)destroy;
+
+@end
+
+NS_ASSUME_NONNULL_END

classes/LuaCallable.m

@@ -0,0 +1,46 @@
+//
+//  LuaCallable.m
+//  LuaTests
+//
+//  Created by Brian Pedersen on 03/08/2024.
+//  Copyright © 2024 Sean Meiners. All rights reserved.
+//
+
+#import "LuaCallable.h"
+#import "LuaContext.h"
+
+@implementation LuaCallable
+
+- (id)initWithState:(lua_State *)L index:(int)index {
+    lua_pushvalue(L, index);
+    lua_Integer ref = luaL_ref(L, LUA_REGISTRYINDEX);
+    if (self = [super init]) {
+        _handle = (int) ref;
+        _L = L;
+    } else {
+        _L = NULL;
+    }
+    return self;
+}
+
+- (void)dealloc {
+    [self destroy];
+}
+
+- (void)destroy {
+    if (_L) {
+        lua_State *L = _L;
+        _L = NULL;
+        luaL_unref(L, LUA_REGISTRYINDEX, (int)_handle);
+    }
+}
+
+- (NSString *)description {
+    return [NSString stringWithFormat:@"Anonymous callable object with handle %d",_handle];
+}
+
+- (NSString *)debugDescription {
+    return [self description];
+}
+
+@end