dominus-cli 0.2.1 → 0.5.0

package/plugin/src/Explorer.lua

@@ -209,7 +209,9 @@ function Explorer.searchScripts(query, maxResults)
 			end)
 
 			if not ok then
-				ok, source = pcall(function() return instance.Source end)
+				ok, source = pcall(function()
+					return instance.Source
+				end)
 			end
 
 			if ok and source then
@@ -248,4 +250,124 @@ function Explorer.searchScripts(query, maxResults)
 	return { results = results }
 end
 
+function Explorer.findReplaceScripts(spec)
+	local find = spec.find
+	local replace = spec.replace
+	local usePattern = spec.usePattern or false
+	local dryRun = spec.dryRun or false
+
+	if not find or find == "" then
+		return { success = false, error = "Missing 'find' parameter" }
+	end
+
+	local root = game
+	if spec.root and spec.root ~= "" then
+		root = Explorer.resolveInstance(spec.root)
+		if not root then
+			local ok, svc = pcall(function()
+				return game:GetService(spec.root)
+			end)
+			if ok then
+				root = svc
+			else
+				return { success = false, error = "Root not found: " .. spec.root }
+			end
+		end
+	end
+
+	local ChangeHistoryService = game:GetService("ChangeHistoryService")
+	local recording = nil
+	if not dryRun then
+		recording = ChangeHistoryService:TryBeginRecording("Dominus: Find/replace in scripts")
+	end
+
+	local modified = {}
+	local totalMatches = 0
+	local totalFiles = 0
+
+	local function processScript(instance)
+		if not SCRIPT_CLASSES[instance.ClassName] then
+			return
+		end
+
+		local ok, source = pcall(function()
+			return ScriptEditorService:GetEditorSource(instance)
+		end)
+		if not ok then
+			ok, source = pcall(function()
+				return instance.Source
+			end)
+		end
+		if not ok or not source then
+			return
+		end
+
+		local count = 0
+		if usePattern then
+			_, count = source:gsub(find, "")
+		else
+			_, count = source:gsub(find, "", nil)
+			-- plain text: count occurrences with plain find
+			count = 0
+			local startPos = 1
+			while true do
+				local foundPos = source:find(find, startPos, true)
+				if not foundPos then
+					break
+				end
+				count = count + 1
+				startPos = foundPos + #find
+			end
+		end
+
+		if count > 0 then
+			totalMatches = totalMatches + count
+			totalFiles = totalFiles + 1
+
+			local path = Explorer.getPath(instance)
+			table.insert(modified, { path = path, matches = count })
+
+			if not dryRun then
+				local newSource
+				if usePattern then
+					newSource = source:gsub(find, replace)
+				else
+					newSource =
+						source:gsub(find:gsub("([%(%)%.%%%+%-%*%?%[%]%^%$])", "%%%1"), replace:gsub("%%", "%%%%"))
+				end
+
+				pcall(function()
+					ScriptEditorService:UpdateSourceAsync(instance, function()
+						return newSource
+					end)
+				end)
+			end
+		end
+	end
+
+	local function walk(instance)
+		processScript(instance)
+		for _, child in instance:GetChildren() do
+			pcall(walk, child)
+		end
+	end
+
+	pcall(walk, root)
+
+	if recording then
+		if totalFiles > 0 then
+			ChangeHistoryService:FinishRecording(recording, Enum.FinishRecordingOperation.Commit)
+		else
+			ChangeHistoryService:FinishRecording(recording, Enum.FinishRecordingOperation.Cancel)
+		end
+	end
+
+	return {
+		success = true,
+		modified = modified,
+		totalMatches = totalMatches,
+		totalFiles = totalFiles,
+	}
+end
+
 return Explorer

package/plugin/src/Properties.lua

@@ -18,7 +18,9 @@ local IGNORED_PROPERTIES = {
 local typeCache = {}
 
 local function getPropertyTypeMap(className)
-	if typeCache[className] then return typeCache[className] end
+	if typeCache[className] then
+		return typeCache[className]
+	end
 
 	local typeMap = {}
 	local ok, props = pcall(function()
@@ -67,7 +69,8 @@ function Properties.get(path)
 	if ok then
 		properties = apiData
 	else
-		local commonProps = {"Name", "Position", "Size", "Color", "Material", "Transparency", "Anchored", "CanCollide"}
+		local commonProps =
+			{ "Name", "Position", "Size", "Color", "Material", "Transparency", "Anchored", "CanCollide" }
 		for _, propName in commonProps do
 			local valOk, val = pcall(function()
 				return instance[propName]
@@ -85,6 +88,80 @@ function Properties.get(path)
 	return { properties = properties }
 end
 
+function Properties.getDescendants(path)
+	local rootInstance = Explorer.resolveInstance(path)
+	if not rootInstance then
+		return { success = false, error = "Instance not found: " .. path }
+	end
+
+	local function getProps(instance)
+		local properties = {}
+
+		local ok, apiData = pcall(function()
+			local info = {}
+			local propData = ReflectionService:GetPropertiesOfClass(instance.ClassName)
+			for _, prop in propData do
+				if not IGNORED_PROPERTIES[prop.Name] then
+					local valueOk, value = pcall(function()
+						return instance[prop.Name]
+					end)
+					if valueOk then
+						table.insert(info, {
+							name = prop.Name,
+							value = tostring(value),
+							type = prop.ValueType and tostring(prop.ValueType) or typeof(value),
+							category = prop.Category or "Other",
+						})
+					end
+				end
+			end
+			return info
+		end)
+
+		if ok then
+			properties = apiData
+		else
+			local commonProps =
+				{ "Name", "Position", "Size", "Color", "Material", "Transparency", "Anchored", "CanCollide" }
+			for _, propName in commonProps do
+				local valOk, val = pcall(function()
+					return instance[propName]
+				end)
+				if valOk and val ~= nil then
+					table.insert(properties, {
+						name = propName,
+						value = tostring(val),
+						type = typeof(val),
+					})
+				end
+			end
+		end
+
+		return properties
+	end
+
+	local results = {}
+
+	-- Include the root instance itself
+	table.insert(results, {
+		name = rootInstance.Name,
+		className = rootInstance.ClassName,
+		path = Explorer.getPath(rootInstance),
+		properties = getProps(rootInstance),
+	})
+
+	for _, descendant in rootInstance:GetDescendants() do
+		table.insert(results, {
+			name = descendant.Name,
+			className = descendant.ClassName,
+			path = Explorer.getPath(descendant),
+			properties = getProps(descendant),
+		})
+	end
+
+	return { success = true, descendants = results }
+end
+
 --[[
 	Smart type coercion: converts JSON-friendly values into Roblox types.
 	Uses the expected property type from ReflectionService when available.
@@ -96,7 +173,9 @@ local function coerceValue(instance, key, value)
 
 	-- If we don't know the expected type, try reading the current value
 	if not expectedType then
-		local curOk, curVal = pcall(function() return instance[key] end)
+		local curOk, curVal = pcall(function()
+			return instance[key]
+		end)
 		if curOk and curVal ~= nil then
 			expectedType = typeof(curVal)
 		end
@@ -135,7 +214,9 @@ local function coerceValue(instance, key, value)
 		if type(value) == "string" then
 			-- "0.5, 0, 0.5, 0" format
 			local a, b, c, d = value:match("([%d%.%-]+)%s*,%s*([%d%.%-]+)%s*,%s*([%d%.%-]+)%s*,%s*([%d%.%-]+)")
-			if a then return UDim2.new(tonumber(a), tonumber(b), tonumber(c), tonumber(d)) end
+			if a then
+				return UDim2.new(tonumber(a), tonumber(b), tonumber(c), tonumber(d))
+			end
 		end
 	end
 
@@ -169,10 +250,7 @@ local function coerceValue(instance, key, value)
 	-- ═══════════════════════════════════════════
 	if expectedType == "Vector2" then
 		if type(value) == "table" then
-			return Vector2.new(
-				value.X or value.x or value[1] or 0,
-				value.Y or value.y or value[2] or 0
-			)
+			return Vector2.new(value.X or value.x or value[1] or 0, value.Y or value.y or value[2] or 0)
 		end
 	end
 
@@ -186,10 +264,14 @@ local function coerceValue(instance, key, value)
 			end
 			if value:match("^rgb") then
 				local r, g, b = value:match("(%d+)%D+(%d+)%D+(%d+)")
-				if r then return Color3.fromRGB(tonumber(r), tonumber(g), tonumber(b)) end
+				if r then
+					return Color3.fromRGB(tonumber(r), tonumber(g), tonumber(b))
+				end
 			end
 			local ok, bc = pcall(BrickColor.new, value)
-			if ok then return bc.Color end
+			if ok then
+				return bc.Color
+			end
 		end
 		if type(value) == "table" then
 			-- {R, G, B} 0-1 or {r, g, b}
@@ -198,7 +280,11 @@ local function coerceValue(instance, key, value)
 			end
 			-- {red, green, blue} 0-255
 			if value.red or value.Red then
-				return Color3.fromRGB(value.red or value.Red or 0, value.green or value.Green or 0, value.blue or value.Blue or 0)
+				return Color3.fromRGB(
+					value.red or value.Red or 0,
+					value.green or value.Green or 0,
+					value.blue or value.Blue or 0
+				)
 			end
 			-- Array [r, g, b]
 			if value[1] then
@@ -229,14 +315,19 @@ local function coerceValue(instance, key, value)
 		if type(value) == "table" then
 			if value.Position or value.position then
 				local pos = value.Position or value.position
-				local cf = CFrame.new(pos.x or pos.X or pos[1] or 0, pos.y or pos.Y or pos[2] or 0, pos.z or pos.Z or pos[3] or 0)
+				local cf = CFrame.new(
+					pos.x or pos.X or pos[1] or 0,
+					pos.y or pos.Y or pos[2] or 0,
+					pos.z or pos.Z or pos[3] or 0
+				)
 				if value.Rotation or value.rotation then
 					local rot = value.Rotation or value.rotation
-					cf = cf * CFrame.Angles(
-						math.rad(rot.x or rot.X or rot[1] or 0),
-						math.rad(rot.y or rot.Y or rot[2] or 0),
-						math.rad(rot.z or rot.Z or rot[3] or 0)
-					)
+					cf = cf
+						* CFrame.Angles(
+							math.rad(rot.x or rot.X or rot[1] or 0),
+							math.rad(rot.y or rot.Y or rot[2] or 0),
+							math.rad(rot.z or rot.Z or rot[3] or 0)
+						)
 				end
 				return cf
 			end
@@ -252,8 +343,12 @@ local function coerceValue(instance, key, value)
 	-- ═══════════════════════════════════════════
 	if expectedType == "Rect" then
 		if type(value) == "table" then
-			return Rect.new(value[1] or value.Min and value.Min[1] or 0, value[2] or value.Min and value.Min[2] or 0,
-				value[3] or value.Max and value.Max[1] or 0, value[4] or value.Max and value.Max[2] or 0)
+			return Rect.new(
+				value[1] or value.Min and value.Min[1] or 0,
+				value[2] or value.Min and value.Min[2] or 0,
+				value[3] or value.Max and value.Max[1] or 0,
+				value[4] or value.Max and value.Max[2] or 0
+			)
 		end
 	end
 
@@ -277,7 +372,14 @@ local function coerceValue(instance, key, value)
 			if value[1] and type(value[1]) == "table" then
 				local keypoints = {}
 				for _, kp in value do
-					table.insert(keypoints, NumberSequenceKeypoint.new(kp.Time or kp[1] or 0, kp.Value or kp[2] or 0, kp.Envelope or kp[3] or 0))
+					table.insert(
+						keypoints,
+						NumberSequenceKeypoint.new(
+							kp.Time or kp[1] or 0,
+							kp.Value or kp[2] or 0,
+							kp.Envelope or kp[3] or 0
+						)
+					)
 				end
 				return NumberSequence.new(keypoints)
 			end
@@ -300,7 +402,7 @@ local function coerceValue(instance, key, value)
 				for _, kp in value do
 					local color = Color3.new(1, 1, 1)
 					if kp.Color then
-						if type(kp.Color) == "string" and kp.Color:sub(1,1) == "#" then
+						if type(kp.Color) == "string" and kp.Color:sub(1, 1) == "#" then
 							color = Color3.fromHex(kp.Color)
 						elseif type(kp.Color) == "table" then
 							color = Color3.new(kp.Color[1] or 0, kp.Color[2] or 0, kp.Color[3] or 0)
@@ -322,10 +424,14 @@ local function coerceValue(instance, key, value)
 			local weight = Enum.FontWeight.Regular
 			local style = Enum.FontStyle.Normal
 			if value.Weight or value.weight then
-				pcall(function() weight = Enum.FontWeight[value.Weight or value.weight] end)
+				pcall(function()
+					weight = Enum.FontWeight[value.Weight or value.weight]
+				end)
 			end
 			if value.Style or value.style then
-				pcall(function() style = Enum.FontStyle[value.Style or value.style] end)
+				pcall(function()
+					style = Enum.FontStyle[value.Style or value.style]
+				end)
 			end
 			return Font.new(family, weight, style)
 		end
@@ -339,13 +445,17 @@ local function coerceValue(instance, key, value)
 	-- ═══════════════════════════════════════════
 	if type(value) == "string" then
 		local currentVal = nil
-		pcall(function() currentVal = instance[key] end)
+		pcall(function()
+			currentVal = instance[key]
+		end)
 		if typeof(currentVal) == "EnumItem" then
 			local enumType = tostring(currentVal.EnumType)
 			local enumOk, enumVal = pcall(function()
 				return Enum[enumType][value]
 			end)
-			if enumOk then return enumVal end
+			if enumOk then
+				return enumVal
+			end
 		end
 	end
 
@@ -356,8 +466,10 @@ local function coerceValue(instance, key, value)
 		-- UDim2 guess: has XScale/YScale keys
 		if value.XScale or value.xScale then
 			return UDim2.new(
-				value.XScale or value.xScale or 0, value.XOffset or value.xOffset or 0,
-				value.YScale or value.yScale or 0, value.YOffset or value.yOffset or 0
+				value.XScale or value.xScale or 0,
+				value.XOffset or value.xOffset or 0,
+				value.YScale or value.yScale or 0,
+				value.YOffset or value.yOffset or 0
 			)
 		end
 		-- Vector3 guess: 3 number elements or X/Y/Z keys
@@ -383,7 +495,9 @@ local function coerceValue(instance, key, value)
 			return Color3.fromHex(value)
 		end
 		local ok, bc = pcall(BrickColor.new, value)
-		if ok then return bc.Color end
+		if ok then
+			return bc.Color
+		end
 	end
 
 	if type(value) == "string" and key == "BrickColor" then
@@ -421,4 +535,75 @@ function Properties.set(path, propertiesToSet)
 	return { success = true, set = set }
 end
 
+function Properties.bulkSet(spec)
+	local ChangeHistoryService = game:GetService("ChangeHistoryService")
+	local recording = ChangeHistoryService:TryBeginRecording("Dominus: Bulk set properties")
+
+	local modified = 0
+	local errors = {}
+
+	if spec.targets and type(spec.targets) == "table" then
+		-- Explicit mode: array of {path, properties}
+		for _, target in ipairs(spec.targets) do
+			local instance = Explorer.resolveInstance(target.path)
+			if not instance then
+				table.insert(errors, "Not found: " .. tostring(target.path))
+			else
+				for key, value in target.properties do
+					local coerced = coerceValue(instance, key, value)
+					local ok, err = pcall(function()
+						instance[key] = coerced
+					end)
+					if not ok then
+						table.insert(errors, target.path .. "." .. key .. ": " .. tostring(err))
+					end
+				end
+				modified = modified + 1
+			end
+		end
+	elseif spec.root and spec.properties then
+		-- Filter mode: apply to all matching descendants
+		local root = Explorer.resolveInstance(spec.root)
+		if not root then
+			if recording then
+				ChangeHistoryService:FinishRecording(recording, Enum.FinishRecordingOperation.Cancel)
+			end
+			return { success = false, error = "Root not found: " .. tostring(spec.root) }
+		end
+
+		local function processInstance(inst)
+			if spec.className and inst.ClassName ~= spec.className then
+				return
+			end
+			for key, value in spec.properties do
+				local coerced = coerceValue(inst, key, value)
+				local ok, err = pcall(function()
+					inst[key] = coerced
+				end)
+				if not ok then
+					table.insert(errors, Explorer.getPath(inst) .. "." .. key .. ": " .. tostring(err))
+				end
+			end
+			modified = modified + 1
+		end
+
+		-- Include root itself if it matches
+		processInstance(root)
+		for _, desc in root:GetDescendants() do
+			processInstance(desc)
+		end
+	else
+		if recording then
+			ChangeHistoryService:FinishRecording(recording, Enum.FinishRecordingOperation.Cancel)
+		end
+		return { success = false, error = "Provide either 'targets' array or 'root' + 'properties'" }
+	end
+
+	if recording then
+		ChangeHistoryService:FinishRecording(recording, Enum.FinishRecordingOperation.Commit)
+	end
+
+	return { success = true, modified = modified, errors = errors }
+end
+
 return Properties