gdharness 1.2.12 → 1.2.14

package/build/cli.js

@@ -11005,7 +11005,7 @@ var init_tool_definitions = __esm(() => {
     {
       name: "project_settings",
       title: "Project settings",
-      description: "Reads or writes project.godot: settings, autoloads, the main scene, input actions, plugins and audio buses. A write with an editor open on the project is handed to the editor, which takes the settings the write changed or names from the file (named under editorAdopted), including a setting the file already held, since the editor can hold another value after the file was put back, or reloads the bus layout, so it answers the new values and does not save the old ones back over them. editorNote is an editor that could not take the write, one on an addon from before this, which still holds the old values until editor_launch restart. An enabled plugin's code still loads on the editor's next start.",
+      description: "Reads or writes project.godot: settings, autoloads, the main scene, input actions, plugins and audio buses. A write with an editor open on the project is handed to the editor, which takes the settings the write changed or names from the file (named under editorAdopted), including a setting the file already held, since the editor can hold another value after the file was put back, or reloads the bus layout, so it answers the new values and does not save the old ones back over them. editorNote is an editor that could not take the write, one on an addon from before this, which still holds the old values until editor_launch restart. An enabled plugin's code still loads on the editor's next start. set answers old_value and new_value, with was_new true when project.godot did not set the setting before, and was_default true when what it held was the engine's own default, which old_value then is.",
       parameters: {
         projectPath: PROJECT_PATH,
         setting: { type: "string", description: 'Setting path, such as "display/window/size/viewport_width".' },
@@ -11708,7 +11708,7 @@ var init_tool_definitions = __esm(() => {
         },
         check: {
           effect: "additive",
-          summary: "boot headless, quit after a few frames, and report the verdict",
+          summary: "boot headless, quit after a few frames, and report the verdict. booted is that verdict rather than whether the game came up: true only for a run that quit on its own within timeoutMs, exited 0 and printed no error, so a game that reached _ready and then raised an error answers false. hung is a run killed at timeoutMs, and errors and warnings count what it printed, which comes back under entries with repeats folded together",
           requires: ["projectPath"]
         },
         wait: {
@@ -12175,7 +12175,7 @@ var init_tool_definitions = __esm(() => {
       operations: {
         click: {
           effect: "additive",
-          summary: `press and release on a Control, a frame apart, and answer with what was under the pointer and what became of the control: in_tree, removed or freed. The control is named by nodePath, or by says with the words on it, found under nodePath when both are given, and the answer then says under found which match it was. Words that are part of a RichTextLabel are pressed where they are drawn rather than at the label's middle, so a link among them is the one pressed: found.pressedOn says "the words", or "the middle of the label" with a note saying why they could not be placed, and on a rich label link_pressed says whether the press reached a link, with link_meta giving the meta the label reports clicked, an empty one included. A control out of sight inside a ScrollContainer is scrolled to first, each container out from it a frame after the one inside, and scrolled_into_view says whether a scroll value changed. A button in toggle mode, a CheckBox or CheckButton included, answers pressed with before and after, its button_pressed either side of the click: the same value twice is a click the game undid, and after is null when the click freed it. A disabled button, and a control that does not process (the game paused, say), are refused: the pointer reaches them and the press does nothing. A 3D node is clicked where it is drawn, and landed then says the interface did not swallow the press: no control under the pointer stopped it, a control letting the pointer pass included, and every viewport on the way out from the room had the pointer over what shows the room`,
+          summary: `press and release on a Control, a frame apart, and answer with what was under the pointer and what became of the control: in_tree, removed or freed. The control is named by nodePath, or by says with the words on it, found under nodePath when both are given, and the answer then says under found which match it was. Words that are part of a RichTextLabel are pressed where they are drawn rather than at the label's middle, so a link among them is the one pressed: found.pressedOn says "the words", or "the middle of the label" with a note saying why they could not be placed, and on a rich label link_pressed says whether the press reached a link, with link_meta giving the meta the label reports clicked, an empty one included. A control out of sight inside a ScrollContainer is scrolled to first, each container out from it a frame after the one inside, and scrolled_into_view says whether a scroll value changed. A button in toggle mode, a CheckBox or CheckButton included, answers pressed with before and after, its button_pressed either side of the click: the same value twice is a click the game undid, and after is null when the click freed it. A disabled button, and a control that does not process (the game paused, say), are refused: the pointer reaches them and the press does nothing. So is a control whose pointer a mouse_behavior_recursive set to disabled on it or above it has turned off, naming where it was set; by says, one the pointer can reach is picked over it. A 3D node is clicked where it is drawn, and landed then says the interface did not swallow the press: no control under the pointer stopped it, a control letting the pointer pass included, and every viewport on the way out from the room had the pointer over what shows the room`,
           requires: []
         },
         choose: {

package/build/godot/addons/gdharness_runtime/runtime_input.gd

@@ -570,12 +570,24 @@ func click(params: Dictionary) -> Dictionary:
 ## The last two answered landed, since the pointer reaches the control, while the press did nothing,
 ## measured on 4.7.2: a disabled button keeps its mouse filter and ignores the press, and a control
 ## that does not process while the game is paused is hovered and never handed the event.
+## A control whose pointer a `mouse_behavior_recursive` above it has turned off is passed through to
+## what is underneath, which answered `landed: false` with nothing saying why.
 func _takes_no_click(control: Control, node_path: String) -> String:
 	if not control.is_visible_in_tree():
 		return "%s is not visible%s, so nothing can click it" % [node_path, Targets.why_hidden(control)]
 	var button: BaseButton = control as BaseButton
 	if button != null and button.disabled:
 		return "%s is disabled, so clicking it presses nothing" % node_path
+	var turned_off: Control = Targets.pointer_turned_off_by(control)
+	if turned_off != null:
+		var on: String = "itself" if turned_off == control else str(turned_off.get_path())
+		return (
+			(
+				"%s takes no pointer input, since mouse_behavior_recursive is disabled on %s,"
+				+ " so clicking it presses nothing"
+			)
+			% [node_path, on]
+		)
 	if not control.can_process():
 		var why: String = _why_it_does_not_process(control, node_path)
 		var over: Node = Targets.drawn_over(control)

package/build/godot/addons/gdharness_runtime/runtime_targets.gd

@@ -12,6 +12,11 @@ const Words = preload("runtime_words.gd")
 ## How many of the controls saying the same words a refusal names, with the index for each.
 const LISTED_CANDIDATES: int = 10
 
+## What a match's rank is made of, one bit each, the highest deciding first.
+const TAKES_POINTER: int = 4
+const ENABLED_BUTTON: int = 2
+const WHOLE: int = 1
+
 
 ## The control a click by [param wanted] words presses, found under [param root_path] in the tree
 ## [param root] heads, or the refusal saying why there is none or which of several:
@@ -238,9 +243,12 @@ static func control_saying(root: Node, root_path: String, wanted: String, which:
 		found["partOf"] = _shortened(lines[index])
 	if which == null and targets.size() > 1:
 		var others: String = (
-			"the other one on screen %s" % _passed_over(ranks[0], true)
+			"the other one on screen %s" % _passed_over(ranks[0], ranks.slice(1), true)
 			if targets.size() == 2
-			else "the other %d on screen %s" % [targets.size() - 1, _passed_over(ranks[0], false)]
+			else (
+				"the other %d on screen %s"
+				% [targets.size() - 1, _passed_over(ranks[0], ranks.slice(1), false)]
+			)
 		)
 		found["picked"] = "%s; %s" % [_described(1, ranks[0], wanted, under), others]
 	if covered > 0:
@@ -248,13 +256,43 @@ static func control_saying(root: Node, root_path: String, wanted: String, which:
 	return {"path": str(targets[index].get_path()), "found": found}
 
 
-## How good a match [param target] is for a click: an enabled button over anything else, and then
-## the whole of its words over a part of them. A disabled button ranks with what is not a button,
-## since a click on it presses nothing: counted as a button, one tied with an enabled button saying
-## the same words and the click was refused as not clear.
+## How good a match [param target] is for a click: a control the pointer can reach over one it
+## cannot, then an enabled button over anything else, and then the whole of its words over a part
+## of them. A disabled button ranks with what is not a button, since a click on it presses nothing:
+## counted as a button, one tied with an enabled button saying the same words and the click was
+## refused as not clear. A card on its way out turning the pointer off for itself and everything in
+## it tied the same way, its Post button against the next card's.
 static func _rank(target: Control, whole: bool) -> int:
 	var button: BaseButton = target as BaseButton
-	return (2 if button != null and not button.disabled else 0) + (1 if whole else 0)
+	var reached: bool = pointer_turned_off_by(target) == null
+	return (
+		(TAKES_POINTER if reached else 0)
+		+ (ENABLED_BUTTON if reached and button != null and not button.disabled else 0)
+		+ (WHOLE if whole else 0)
+	)
+
+
+## The control whose `mouse_behavior_recursive` keeps the pointer from [param control], itself or
+## the nearest above it setting one, or null when nothing does.
+##
+## Turned off on a control, it takes the pointer from everything under it without touching their
+## `mouse_filter` or a button's `disabled`, so neither says the press will do nothing. Read from the
+## engine's own answer, the filter with that override applied, rather than by walking the setting:
+## a control below can turn it back on, and the setting stops at a parent that is not a Control.
+## A control that ignores the pointer of its own accord, as a label does, is not turned off.
+static func pointer_turned_off_by(control: Control) -> Control:
+	if (
+		control.mouse_filter == Control.MOUSE_FILTER_IGNORE
+		or control.get_mouse_filter_with_override() != Control.MOUSE_FILTER_IGNORE
+	):
+		return null
+	var deciding: Control = control
+	while (
+		deciding.mouse_behavior_recursive == Control.MOUSE_BEHAVIOR_INHERITED
+		and deciding.get_parent() is Control
+	):
+		deciding = deciding.get_parent()
+	return deciding
 
 
 ## Whether one of [param wanted]'s alternatives is the whole of [param said], or the whole of one of
@@ -307,31 +345,43 @@ static func _in_a_word(code: int) -> bool:
 
 ## [param count] matches of [param rank], as the start of a sentence.
 static func _described(count: int, rank: int, wanted: String, under: String) -> String:
-	var what: String = "button" if rank >= 2 else "control"
+	var what: String = "button" if rank & ENABLED_BUTTON else "control"
 	var how: String = '"%s"' % wanted
 	var plain: bool = true
 	for words: String in Says.alternatives(wanted):
 		plain = plain and Says.is_plain(words)
 	if plain:
-		how = ('exactly "%s"' if rank % 2 == 1 else '"%s" as part of more') % wanted
+		how = ('exactly "%s"' if rank & WHOLE else '"%s" as part of more') % wanted
 	if count == 1:
 		return "the one %s on screen%s saying %s" % [what, under, how]
 	return "%d %ss on screen%s say %s" % [count, what, under, how]
 
 
-## Why the matches below [param rank] were passed over, said of one of them when [param one]. As
-## what the code knows, which is whether a control is an enabled button: a card taking clicks in its
-## own `gui_input` is not one, and calling it something that cannot be pressed was a guess.
-static func _passed_over(rank: int, one: bool) -> String:
-	var says: String = "says" if one else "say"
-	var is_not: String = "is not an enabled button" if one else "are not enabled buttons"
-	match rank:
-		3:
-			return "%s or %s it as part of more" % [is_not, says]
-		2:
-			return is_not
-		_:
-			return "%s it as part of more" % says
+## Why the matches ranked [param others] were passed over for the one ranked [param best], said of
+## one of them when [param one]: each way the best is better that one of them is not. As what the
+## code knows, which is whether a control is an enabled button: a card taking clicks in its own
+## `gui_input` is not one, and calling it something that cannot be pressed was a guess.
+static func _passed_over(best: int, others: Array[int], one: bool) -> String:
+	var lacking: int = 0
+	for rank: int in others:
+		var short: int = best & ~rank
+		# One the pointer cannot reach is never ranked a button, so that is the whole of why.
+		if short & TAKES_POINTER:
+			short &= ~ENABLED_BUTTON
+		lacking |= short
+	var reasons: Array[String] = []
+	if lacking & TAKES_POINTER:
+		reasons.append("takes no pointer input" if one else "take no pointer input")
+	if lacking & ENABLED_BUTTON:
+		reasons.append("is not an enabled button" if one else "are not enabled buttons")
+	if lacking & WHOLE:
+		reasons.append("says it as part of more" if one else "say it as part of more")
+	# Ranked level with the best, a match was passed over for having the words only inside longer ones.
+	if reasons.is_empty():
+		return "says it only inside a longer word" if one else "say it only inside longer words"
+	if reasons.size() == 1:
+		return reasons[0]
+	return "%s or %s" % [", ".join(reasons.slice(0, -1)), reasons[-1]]
 
 
 ## What to add to a refusal that found nothing on screen, when words matched controls out of sight.

package/build/godot/operations/classdb_queries.gd

@@ -283,6 +283,7 @@ func _methods_of(class_name_str: String, include_inherited: bool) -> Array[Dicti
 				{
 					"name": a.get("name", ""),
 					"type": a.get("type", 0),
+					"type_name": _type_name(a, "Variant"),
 					"class_name": a.get("class_name", ""),
 					"hint_string": a.get("hint_string", "")
 				}
@@ -293,7 +294,11 @@ func _methods_of(class_name_str: String, include_inherited: bool) -> Array[Dicti
 				"name": m.get("name", ""),
 				"args": args,
 				"return":
-				{"type": return_info.get("type", 0), "class_name": return_info.get("class_name", "")},
+				{
+					"type": return_info.get("type", 0),
+					"type_name": _type_name(return_info, "void"),
+					"class_name": return_info.get("class_name", "")
+				},
 				"flags": m.get("flags", 0),
 				"default_args": m.get("default_args", [])
 			}
@@ -302,6 +307,20 @@ func _methods_of(class_name_str: String, include_inherited: bool) -> Array[Dicti
 	return methods
 
 
+# What [param info]'s type is called: its class for an object of one, and otherwise the engine's own
+# name for the type, beside the number the engine reports, which reads as nothing without its enum.
+# Nil is a value that can be anything when the usage says so, and [param nil_name] otherwise: void
+# for what a method returns, and Variant for an argument or property with no type.
+static func _type_name(info: Dictionary, nil_name: String) -> String:
+	var type: int = Read.as_int(info.get("type", 0))
+	var named: String = str(info.get("class_name", ""))
+	if type == TYPE_OBJECT and not named.is_empty():
+		return named
+	if type == TYPE_NIL:
+		return "Variant" if Read.as_int(info.get("usage", 0)) & PROPERTY_USAGE_NIL_IS_VARIANT else nil_name
+	return type_string(type)
+
+
 func _properties_of(class_name_str: String, include_inherited: bool) -> Array[Dictionary]:
 	var properties: Array[Dictionary] = []
 
@@ -314,6 +333,7 @@ func _properties_of(class_name_str: String, include_inherited: bool) -> Array[Di
 			{
 				"name": p.get("name", ""),
 				"type": p.get("type", 0),
+				"type_name": _type_name(p, "Variant"),
 				"class_name": p.get("class_name", ""),
 				"hint": p.get("hint", 0),
 				"hint_string": p.get("hint_string", ""),
@@ -332,7 +352,12 @@ func _signals_of(class_name_str: String, include_inherited: bool) -> Array[Dicti
 		var declared_args: Array = s.get("args", [])
 		for a: Dictionary in declared_args:
 			sig_args.append(
-				{"name": a.get("name", ""), "type": a.get("type", 0), "class_name": a.get("class_name", "")}
+				{
+					"name": a.get("name", ""),
+					"type": a.get("type", 0),
+					"type_name": _type_name(a, "Variant"),
+					"class_name": a.get("class_name", "")
+				}
 			)
 		signals.append({"name": s.get("name", ""), "args": sig_args})
 

package/build/godot/operations/import_pipeline.gd

@@ -103,7 +103,16 @@ func get_import_status(params: Dictionary) -> Dictionary:
 
 			_tally(summary, status)
 
-	return {"resources": resources, "summary": summary}
+	var answer: Dictionary = {"resources": resources, "summary": summary}
+	# A total of none reads as a walk that found nothing when the project is full of scripts and
+	# scenes, which the engine loads as they are and never imports.
+	if resource_path.is_empty() and summary["total"] == 0:
+		answer["note"] = (
+			"Nothing in this project is imported: the engine imports images, audio, fonts, models and"
+			+ " the like, found by extension or by a .import sidecar beside them, and loads scripts and"
+			+ " scenes as they are."
+		)
+	return answer
 
 
 # Get import options for a resource

package/build/godot/operations/project_config.gd

@@ -94,6 +94,11 @@ func set_project_setting(params: Dictionary) -> Dictionary:
 	var had_value: bool = ProjectSettings.has_setting(setting_path)
 	if had_value:
 		old_value = ProjectSettings.get_setting(setting_path)
+	# A setting the engine registers is there with its default whether or not project.godot sets it,
+	# so has_setting alone called the description of a project that had never set one an old value.
+	# At its default, the file does not set it: the engine drops a key at its default when it saves.
+	var default_value: Variant = ProjectSettings.property_get_revert(setting_path)
+	var was_default: bool = had_value and default_value != null and old_value == default_value
 
 	var final_value: Variant = _values.deserialize_value(value)
 	var wanted: int = _wanted_type(setting_path, old_value if had_value else null)
@@ -116,7 +121,8 @@ func set_project_setting(params: Dictionary) -> Dictionary:
 		"setting_path": setting_path,
 		"old_value": _values.serialize_value(old_value) if had_value else null,
 		"new_value": _values.serialize_value(final_value),
-		"was_new": not had_value,
+		"was_new": not had_value or was_default,
+		"was_default": was_default,
 		"saved": true,
 	}
 

package/build/godot/operations/project_diagnostics.gd

@@ -30,16 +30,9 @@ func get_project_health(params: Dictionary) -> Dictionary:
 		if not FileAccess.file_exists("res://project.godot"):
 			details.append("Missing project.godot file")
 			deductions += 30
-
-		var recommended_dirs: Array[String] = ["res://scenes", "res://scripts", "res://assets"]
-		var missing_dirs: Array[String] = []
-		for dir: String in recommended_dirs:
-			if not DirAccess.dir_exists_absolute(ProjectSettings.globalize_path(dir)):
-				missing_dirs.append(dir)
-
-		if missing_dirs.size() > 0:
-			details.append("Consider organizing with directories: " + ", ".join(missing_dirs))
-			deductions += 2 * missing_dirs.size()
+		# No layout is asked for. A project without res://scenes, res://scripts and res://assets
+		# failed this check and lost points, while Godot's own guidance is to keep a scene's files
+		# together by feature, so the check failed projects for following the engine's advice.
 
 		checks["structure"] = {"name": "Project Structure", "passed": details.is_empty(), "details": details}
 
@@ -74,7 +67,6 @@ func get_project_health(params: Dictionary) -> Dictionary:
 
 		var script_files: Array[String] = _files.find_files("res://", ".gd")
 		var todo_count: int = 0
-		var empty_functions: int = 0
 
 		for script_path: String in script_files:
 			var file: FileAccess = FileAccess.open(script_path, FileAccess.READ)
@@ -84,16 +76,12 @@ func get_project_health(params: Dictionary) -> Dictionary:
 
 				if "# TODO" in content or "# FIXME" in content:
 					todo_count += 1
-				if "pass # " in content or content.ends_with("pass\n"):
-					empty_functions += 1
 
+		# Work noted for later, which no script fails on, so said rather than failed. A count of
+		# "empty functions" read off a script ending in `pass` went with it: a virtual left for an
+		# override to fill ends that way and is exactly right.
 		if todo_count > 0:
-			details.append(str(todo_count) + " scripts have TODO/FIXME comments")
-			deductions += todo_count
-
-		if empty_functions > 0:
-			details.append(str(empty_functions) + " scripts may have empty functions")
-			deductions += empty_functions
+			recommendations.append("%d scripts have TODO or FIXME comments to look at" % todo_count)
 
 		checks["scripts"] = {
 			"name": "Scripts",
@@ -136,10 +124,6 @@ func get_project_health(params: Dictionary) -> Dictionary:
 			details.append("No project name set")
 			deductions += 2
 
-		if not FileAccess.file_exists("res://export_presets.cfg"):
-			details.append("No export presets configured")
-			deductions += 3
-
 		checks["config"] = {"name": "Configuration", "passed": details.is_empty(), "details": details}
 
 	var score: int = maxi(0, 100 - deductions)
@@ -156,11 +140,11 @@ func get_project_health(params: Dictionary) -> Dictionary:
 	else:
 		grade = "F"
 
-	if deductions > 0:
-		if score < 70:
-			recommendations.append("Address critical issues to improve project stability")
-		if not FileAccess.file_exists("res://export_presets.cfg"):
-			recommendations.append("Configure export presets for your target platforms")
+	if score < 70:
+		recommendations.append("Address critical issues to improve project stability")
+	# A project still being made has no presets yet, which is no fault in it.
+	if "config" in check_categories and not FileAccess.file_exists("res://export_presets.cfg"):
+		recommendations.append("No export presets are configured: add them before exporting")
 
 	# Every detail costs points, so each is an issue; `issues` was always empty beside them, and a
 	# category said passed next to the failure it had just found.

package/build/index.js

@@ -33895,7 +33895,7 @@ var TOOL_SPECS = [
   {
     name: "project_settings",
     title: "Project settings",
-    description: "Reads or writes project.godot: settings, autoloads, the main scene, input actions, plugins and audio buses. A write with an editor open on the project is handed to the editor, which takes the settings the write changed or names from the file (named under editorAdopted), including a setting the file already held, since the editor can hold another value after the file was put back, or reloads the bus layout, so it answers the new values and does not save the old ones back over them. editorNote is an editor that could not take the write, one on an addon from before this, which still holds the old values until editor_launch restart. An enabled plugin's code still loads on the editor's next start.",
+    description: "Reads or writes project.godot: settings, autoloads, the main scene, input actions, plugins and audio buses. A write with an editor open on the project is handed to the editor, which takes the settings the write changed or names from the file (named under editorAdopted), including a setting the file already held, since the editor can hold another value after the file was put back, or reloads the bus layout, so it answers the new values and does not save the old ones back over them. editorNote is an editor that could not take the write, one on an addon from before this, which still holds the old values until editor_launch restart. An enabled plugin's code still loads on the editor's next start. set answers old_value and new_value, with was_new true when project.godot did not set the setting before, and was_default true when what it held was the engine's own default, which old_value then is.",
     parameters: {
       projectPath: PROJECT_PATH2,
       setting: { type: "string", description: 'Setting path, such as "display/window/size/viewport_width".' },
@@ -34598,7 +34598,7 @@ var TOOL_SPECS = [
       },
       check: {
         effect: "additive",
-        summary: "boot headless, quit after a few frames, and report the verdict",
+        summary: "boot headless, quit after a few frames, and report the verdict. booted is that verdict rather than whether the game came up: true only for a run that quit on its own within timeoutMs, exited 0 and printed no error, so a game that reached _ready and then raised an error answers false. hung is a run killed at timeoutMs, and errors and warnings count what it printed, which comes back under entries with repeats folded together",
         requires: ["projectPath"]
       },
       wait: {
@@ -35065,7 +35065,7 @@ var TOOL_SPECS = [
     operations: {
       click: {
         effect: "additive",
-        summary: `press and release on a Control, a frame apart, and answer with what was under the pointer and what became of the control: in_tree, removed or freed. The control is named by nodePath, or by says with the words on it, found under nodePath when both are given, and the answer then says under found which match it was. Words that are part of a RichTextLabel are pressed where they are drawn rather than at the label's middle, so a link among them is the one pressed: found.pressedOn says "the words", or "the middle of the label" with a note saying why they could not be placed, and on a rich label link_pressed says whether the press reached a link, with link_meta giving the meta the label reports clicked, an empty one included. A control out of sight inside a ScrollContainer is scrolled to first, each container out from it a frame after the one inside, and scrolled_into_view says whether a scroll value changed. A button in toggle mode, a CheckBox or CheckButton included, answers pressed with before and after, its button_pressed either side of the click: the same value twice is a click the game undid, and after is null when the click freed it. A disabled button, and a control that does not process (the game paused, say), are refused: the pointer reaches them and the press does nothing. A 3D node is clicked where it is drawn, and landed then says the interface did not swallow the press: no control under the pointer stopped it, a control letting the pointer pass included, and every viewport on the way out from the room had the pointer over what shows the room`,
+        summary: `press and release on a Control, a frame apart, and answer with what was under the pointer and what became of the control: in_tree, removed or freed. The control is named by nodePath, or by says with the words on it, found under nodePath when both are given, and the answer then says under found which match it was. Words that are part of a RichTextLabel are pressed where they are drawn rather than at the label's middle, so a link among them is the one pressed: found.pressedOn says "the words", or "the middle of the label" with a note saying why they could not be placed, and on a rich label link_pressed says whether the press reached a link, with link_meta giving the meta the label reports clicked, an empty one included. A control out of sight inside a ScrollContainer is scrolled to first, each container out from it a frame after the one inside, and scrolled_into_view says whether a scroll value changed. A button in toggle mode, a CheckBox or CheckButton included, answers pressed with before and after, its button_pressed either side of the click: the same value twice is a click the game undid, and after is null when the click freed it. A disabled button, and a control that does not process (the game paused, say), are refused: the pointer reaches them and the press does nothing. So is a control whose pointer a mouse_behavior_recursive set to disabled on it or above it has turned off, naming where it was set; by says, one the pointer can reach is picked over it. A 3D node is clicked where it is drawn, and landed then says the interface did not swallow the press: no control under the pointer stopped it, a control letting the pointer pass included, and every viewport on the way out from the room had the pointer over what shows the room`,
         requires: []
       },
       choose: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gdharness",
-  "version": "1.2.12",
+  "version": "1.2.14",
   "mcpName": "io.github.Aureliolo/gdharness",
   "description": "A harness for driving a Godot 4 project from an agent: editor addons, a runtime bridge into the running game, an MCP server in front of them, and a CLI that installs and diagnoses the Godot side.",
   "type": "module",