refactor: improve structure and alien-signals integration

packages/react-charm/src/__tests__/helpers/renderHook.luau

@@ -0,0 +1,40 @@
+_G.__ROACT_17_MOCK_SCHEDULER__ = true
+
+local React = require("../../../React")
+local ReactRoblox = require("../../../ReactRoblox")
+
+type RenderedHook<Props, Result> = {
+	result: Result,
+	rerender: (Props?) -> (),
+	unmount: () -> (),
+}
+
+local function renderHook<Props, Result>(callback: (Props) -> Result, props: Props?): RenderedHook<Props, Result>
+	local root = ReactRoblox.createLegacyRoot(Instance.new("Folder"))
+	local hook = {}
+
+	local function Component(props)
+		hook.result = callback(props)
+	end
+
+	function hook.rerender(newProps)
+		props = newProps or props
+		ReactRoblox.act(function()
+			root:render(React.createElement(Component, props))
+		end)
+	end
+
+	function hook.unmount()
+		ReactRoblox.act(function()
+			root:unmount()
+		end)
+	end
+
+	ReactRoblox.act(function()
+		hook.rerender(props)
+	end)
+
+	return hook
+end
+
+return renderHook

packages/react-charm/src/__tests__/spec.luau

@@ -0,0 +1,15 @@
+local suite = require("../../../../test/suite")
+
+suite.describe("react-charm", function()
+	if not game then
+		return suite.skip()
+	end
+	suite.describe("useAtom", function()
+		require("./useAtom.spec")
+	end)
+	suite.describe("useAtomBinding", function()
+		require("./useAtomBinding.spec")
+	end)
+end)
+
+return {}

packages/react-charm/src/__tests__/useAtom.spec.luau

@@ -0,0 +1,47 @@
+local Charm = require("../../Charm")
+local ReactCharm = require("../")
+local renderHook = require("./helpers/renderHook")
+local suite = require("../../../../test/suite")
+
+local atom = Charm.atom
+local useAtom = ReactCharm.useAtom
+local test = suite.test
+
+test("tracks atom state", function()
+	local state = atom(0)
+	local hook = renderHook(function()
+		return useAtom(state)
+	end)
+	assert(hook.result == 0, "should return 0")
+	state(1)
+	assert(hook.result == 1, "should return 1")
+end)
+
+test("accepts a selector", function()
+	local state = atom(0)
+	local hook = renderHook(function()
+		return useAtom(function()
+			return 2 * state()
+		end)
+	end)
+	assert(hook.result == 0, "should return 0")
+	state(1)
+	assert(hook.result == 2, "should return 2")
+end)
+
+test("tracks dependencies", function()
+	local state = atom(0)
+	local hook = renderHook(function()
+		return useAtom(state, { state })
+	end)
+	assert(hook.result == 0, "should return 0")
+	state(1)
+	assert(hook.result == 1, "should return 1")
+	state = atom(0)
+	hook.rerender()
+	assert(hook.result == 0, "should return 0")
+	state(1)
+	assert(hook.result == 1, "should return 1")
+end)
+
+return {}

packages/react-charm/src/__tests__/useAtomBinding.spec.luau

@@ -0,0 +1,47 @@
+local Charm = require("../../Charm")
+local ReactCharm = require("../")
+local renderHook = require("./helpers/renderHook")
+local suite = require("../../../../test/suite")
+
+local atom = Charm.atom
+local useAtomBinding = ReactCharm.useAtomBinding
+local test = suite.test
+
+test("tracks atom state", function()
+	local state = atom(0)
+	local hook = renderHook(function()
+		return useAtomBinding(state)
+	end)
+	assert(hook.result:getValue() == 0, "should return 0")
+	state(1)
+	assert(hook.result:getValue() == 1, "should return 1")
+end)
+
+test("accepts a selector", function()
+	local state = atom(0)
+	local hook = renderHook(function()
+		return useAtomBinding(function()
+			return 2 * state()
+		end)
+	end)
+	assert(hook.result:getValue() == 0, "should return 0")
+	state(1)
+	assert(hook.result:getValue() == 2, "should return 2")
+end)
+
+test("tracks dependencies", function()
+	local state = atom(0)
+	local hook = renderHook(function()
+		return useAtomBinding(state, { state })
+	end)
+	assert(hook.result:getValue() == 0, "should return 0")
+	state(1)
+	assert(hook.result:getValue() == 1, "should return 1")
+	state = atom(0)
+	hook.rerender()
+	assert(hook.result:getValue() == 0, "should return 0")
+	state(1)
+	assert(hook.result:getValue() == 1, "should return 1")
+end)
+
+return {}

packages/react-charm/src/index.d.ts

@@ -0,0 +1 @@
+export {};

packages/react-charm/src/init.luau

@@ -1,5 +1,5 @@
-local Charm = require(script.Parent.Charm)
-local React = require(script.Parent.React)
+local Charm = require("./Charm")
+local React = require("./React")
 
 local effect = Charm.effect
 local useBinding = React.useBinding