feat: add CanBeSource type

docs/api/reactivity-utility.md

@@ -74,7 +74,9 @@ Utility used to read a value that is either a primitive or a source.
 - **Type**
 
     ```luau
-    function read<T>(value: T | () -> T): T
+    type CanBeSource<T> = T | (() -> T)
+
+    function read<T>(value: CanBeSource<T>): T
     ```
 
 ## batch()

init.luau

@@ -2,6 +2,7 @@ local vide = require "@self/src/lib"
 
 export type source<T> = vide.source<T>
 export type Source<T> = vide.Source<T>
+export type CanBeSource<T> = read.CanBeSource<T>
 export type context<T> = vide.context<T>
 export type Context<T> = vide.Context<T>
 export type Instances = vide.Instances

src/init.luau

@@ -4,6 +4,7 @@ local vide = require("@self/lib")
 
 export type source<T> = vide.source<T>
 export type Source<T> = vide.Source<T>
+export type CanBeSource<T> = vide.CanBeSource<T>
 export type context<T> = vide.context<T>
 export type Context<T> = vide.Context<T>
 export type Instances = vide.Instances

src/lib.luau

@@ -25,6 +25,7 @@ local flags = require "./flags"
 
 export type Source<T> = source.Source<T>
 export type source<T> = Source<T>
+export type CanBeSource<T> = read.CanBeSource<T>
 export type Context<T> = context.Context<T>
 export type context<T> = Context<T>
 export type Instances = create.Instances

src/read.luau

@@ -1,4 +1,6 @@
-local function read<T>(value: T | () -> T): T
+export type CanBeSource<T> = T | (() -> T)
+
+local function read<T>(value: CanBeSource<T>): T
     return if type(value) == "function" then value() else value
 end