Make changed() run initially

CHANGELOG.md

@@ -17,6 +17,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 - Reactive scopes created within reactive scopes are now destroyed on rerun.
 - `untrack()` can be called outside of reactive scopes.
+- `changed()` will also run its callback with the initial property value.
 
 ### Fixed
 

docs/api/creation.md

@@ -154,3 +154,23 @@ instances.
         changed("Text", output)
     }
     ```
+
+## changed()
+
+A wrapper for `action()` to listen for property changes.
+
+- **Type**
+
+    ```lua
+    function changed(property: string, callback: (...unknown) -> ()): Action
+    ```
+
+- **Details**
+
+    Will run the given callback any time the property is changed, as well as
+    when the action is initially run.
+
+    The changed connection is disconnected when the reactive scope the action is
+    ran in is destroyed.
+
+    Runs with an action priority of 1.

src/changed.luau

@@ -12,6 +12,8 @@ local function changed<T>(property: string, callback: (T) -> ())
         cleanup(function()
             con:Disconnect()
         end)
+
+        callback((instance :: any)[property])
     end)
 end
 

test/tests.luau

@@ -1806,7 +1806,7 @@ TEST("changed()", wrap_root(function()
             changed("Text", output)
         }
 
-        --CHECK(output() == "a")
+        CHECK(output() == "a")
         text.Text = "b"
         CHECK(output() == "b")
     end