@quenty/valueobject 7.18.0 → 7.19.0

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [7.19.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/valueobject@7.18.0...@quenty/valueobject@7.19.0) (2023-07-23)
+
+
+### Features
+
+* Add ValueObject:ObserveBrio(condition) ([2d3766a](https://github.com/Quenty/NevermoreEngine/commit/2d3766a535706d45ce5d217a7cdc81daa198f1f7))
+
+
+
+
+
 # [7.18.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/valueobject@7.17.0...@quenty/valueobject@7.18.0) (2023-07-15)
 
 **Note:** Version bump only for package @quenty/valueobject

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quenty/valueobject",
-  "version": "7.18.0",
+  "version": "7.19.0",
   "description": "To work like value objects in Roblox and track a single item with .Changed events",
   "keywords": [
     "Roblox",
@@ -36,5 +36,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "af7a623f58fe7ec96b47c80e385b71f820fd4cb8"
+  "gitHead": "c1fbe93a0a20b5c0c4b9ffbbac771926b07ac251"
 }

package/src/Shared/ValueObject.lua

@@ -11,6 +11,7 @@ local Maid = require("Maid")
 local Observable = require("Observable")
 local ValueBaseUtils = require("ValueBaseUtils")
 local RxValueBaseUtils = require("RxValueBaseUtils")
+local Brio = require("Brio")
 
 local EMPTY_FUNCTION = function() end
 
@@ -164,6 +165,50 @@ function ValueObject:Observe()
 	end)
 end
 
+--[=[
+	Observes the value as a brio. The condition defaults to truthy or nil.
+
+	@param condition function | nil -- optional
+	@return Observable<Brio<T>>
+]=]
+function ValueObject:ObserveBrio(condition)
+	assert(type(condition) == "function" or condition == nil, "Bad condition")
+
+	return Observable.new(function(sub)
+		if not self.Destroy then
+			warn("[ValueObject.observeValue] - Connecting to dead ValueObject")
+			-- No firing, we're dead
+			sub:Complete()
+			return
+		end
+
+		local maid = Maid.new()
+
+		local function handleNewValue(newValue, ...)
+			if not condition or condition(newValue) then
+				local brio = Brio.new(newValue, ...)
+				maid._current = brio
+				sub:Fire(brio)
+			else
+				maid._current = nil
+			end
+		end
+
+		maid:GiveTask(self.Changed:Connect(function(newValue, _, _, ...)
+			handleNewValue(newValue, ...)
+		end))
+
+		local args = rawget(self, "_lastEventContext")
+		if args then
+			handleNewValue(self.Value, table.unpack(args, 1, args.n))
+		else
+			handleNewValue(self.Value)
+		end
+
+		return maid
+	end)
+end
+
 --[=[
 	Allows you to set a value, and provide additional event context for the actual change.
 	For example, you might do.