gdharness 1.3.59 → 1.3.61

package/build/godot/operations/gdscript_analysis.gd

@@ -180,7 +180,7 @@ func _members(
 			own.last = i - 1
 			return own
 
-		# An odd count opens a string that runs on; an even one is a string that closed on the line
+		# An odd count opens a string that runs on. An even one is a string that closed on the line
 		# it opened on. Toggling on any count lost `const HELP := """Usage"""`, and everything after
 		# it up to the next triple quote, with the state inverted from there to the end of the file.
 		# The line that opens one is still read: it can be the declaration the string belongs to.
@@ -359,7 +359,7 @@ func _mark_virtuals(functions: Array[Dictionary], extends_name: String, from_pat
 
 # The native class at the top of this script's chain, or empty when the chain does not reach one.
 #
-# A base named by a script is followed; a base that is neither a script nor a class the engine knows
+# A base named by a script is followed. A base that is neither a script nor a class the engine knows
 # leaves nothing to ask, and then no function is called virtual rather than every underscore being
 # guessed at.
 func _native_ancestor(base: String, from_path: String) -> String:
@@ -388,7 +388,7 @@ func _native_ancestor(base: String, from_path: String) -> String:
 # `res://` path or as a `class_name` in the project's class list, and a script whose base is neither
 # has no ancestor to read, which the answer says by leaving `inherits_from` short rather than by
 # refusing. Each entry carries `inherited_from`, so a caller can tell a member the script declares
-# from one it is given; a name a script overrides appears twice, at both lines, on purpose.
+# from one it is given. A name a script overrides appears twice, at both lines, on purpose.
 func _add_inherited(answer: Dictionary, seen: Array[String]) -> void:
 	var inherits_from: Array[String] = []
 	var base: String = str(answer.get("extends", ""))
@@ -634,7 +634,7 @@ func _parse_variable(line: String, line_num: int) -> Dictionary:
 		"is_static": GdhPatterns.without_annotations(line).begins_with("static "),
 		"line": line_num,
 	}
-	# Only := types a variable by its value; one written with = alone holds any type.
+	# Only := types a variable by its value. One written with = alone holds any type.
 	var walrus: bool = (
 		"=" in var_text and var_text.split("=", true, 1)[0].strip_edges().ends_with(":")
 	)
@@ -677,7 +677,7 @@ func _parse_function(line: String, line_num: int, annotated: String = "") -> Dic
 		"name": name,
 		"params": params,
 		"return_type": return_type,
-		# Filled in after the whole file is read, once the base is known; see `_mark_virtuals`.
+		# Filled in after the whole file is read, once the base is known. See `_mark_virtuals`.
 		"is_virtual": false,
 		"is_static": is_static,
 		# Said rather than left to be inferred: an abstract method has no body, so a caller that
@@ -857,7 +857,7 @@ static func _based_on_paths(extends_name: String, inner_classes: Array) -> Array
 	return paths
 
 
-## The text of [param literal], a string literal as written; empty for anything else.
+## The text of [param literal], a string literal as written. Empty for anything else.
 static func _unquoted(literal: String) -> String:
 	var text: String = literal.strip_edges()
 	if text.length() >= 2 and text[0] in ["\"", "'"] and text[-1] == text[0]:

package/build/godot/operations/gdscript_authoring.gd

@@ -138,7 +138,7 @@ func create_gdscript(params: Dictionary) -> Dictionary:
 
 
 ## The uid in the .uid file beside [param path], written first when there is none, as the editor
-## writes it for a script it makes; empty when it could not be written. A sidecar already there is
+## writes it for a script it makes. Empty when it could not be written. A sidecar already there is
 ## the one the engine reads the script's uid from, so it is kept.
 static func _uid_beside(path: String) -> String:
 	var sidecar: String = path + ".uid"
@@ -232,7 +232,7 @@ func modify_gdscript(params: Dictionary) -> Dictionary:
 		var refusal: String = "Nothing was changed: " + "; ".join(problems)
 		if _redeclares(modifications, declared):
 			refusal += (
-				". modify only adds members; to change one the script declares already,"
+				". modify only adds members. To change one the script declares already,"
 				+ " edit its lines in the file"
 			)
 		return _log.failure(refusal)
@@ -290,7 +290,7 @@ func modify_gdscript(params: Dictionary) -> Dictionary:
 	OS.remove_logger(caught)
 	var parses: bool = _parses(made)
 	# The names checked above are the script's own, and a member the base class declares, or a body
-	# that does not compile, is found only by the engine; a script left broken by an addition breaks
+	# that does not compile, is found only by the engine. A script left broken by an addition breaks
 	# every scene that uses it, so it goes back as it was. One already broken is written, as the
 	# addition can be what mends it.
 	if parsed_before and not parses:
@@ -335,7 +335,7 @@ static func _reasons(raised: Array[Dictionary], path: String) -> String:
 
 # Why a script with [param named] as its class_name and extending [param base] cannot be written,
 # or "". A class_name another script holds does not compile ("hides a global script class"), and nor
-# does a base no class answers to; both were written and answered as made. Classes are read off the
+# does a base no class answers to. Both were written and answered as made. Classes are read off the
 # scripts as well as the class list, which a fresh clone has not written yet.
 static func _header_refusal(named: String, base: String) -> String:
 	var declared: Dictionary = _declared_classes()
@@ -366,7 +366,7 @@ static func _header_refusal(named: String, base: String) -> String:
 		close = GdhRead.nearest(base, ClassDB.get_class_list())
 	if close.is_empty():
 		return said + "."
-	return said + "; the nearest %s %s." % ["is" if close.size() == 1 else "are", ", ".join(close)]
+	return said + ". The nearest %s %s." % ["is" if close.size() == 1 else "are", ", ".join(close)]
 
 
 ## Why [param template] cannot be written on [param base], or "". Each template's code calls
@@ -427,7 +427,7 @@ static func _declared_classes() -> Dictionary:
 # Every reason [param modifications] cannot be made as asked, each naming the entry by position.
 #
 # A name the script already declares is one of them, as is one the call adds twice. GDScript gives a
-# class one namespace for its members, so a second `maximum` does not parse; and the engine reports
+# class one namespace for its members, so a second `maximum` does not parse, and the engine reports
 # only the first error it meets, so a second `func damage` behind it was written with nothing said.
 static func _modification_problems(modifications: Array, declared: Dictionary) -> Array[String]:
 	var problems: Array[String] = []
@@ -541,7 +541,7 @@ static func _insert(
 # Whether the engine accepts [param script], parsed under this project's own warning settings: a
 # script that does not load is one the caller wants to hear about now, and the reason is on stderr,
 # which comes back with the answer. A script that fails to parse still loads, as one that cannot be
-# instantiated; an abstract one that parses can be, on 4.7.
+# instantiated. An abstract one that parses can be, on 4.7.
 static func _parses(script: Script) -> bool:
 	return script != null and script.can_instantiate()
 
@@ -583,7 +583,7 @@ func _add_constant(lines: Array[String], mod: Dictionary, placed: Array[Dictiona
 			break
 	after = _past_class_doc(lines, after)
 	# Set apart from the header or the signals above and from what follows, as the style guide lays
-	# out its groups; one below the constants already there joins them.
+	# out its groups. One below the constants already there joins them.
 	var block: Array[String] = [const_line]
 	var above: String = lines[after - 1].strip_edges() if after > 0 else ""
 	var below: String = lines[after].strip_edges() if after < lines.size() else ""
@@ -620,7 +620,7 @@ func _add_variable(lines: Array[String], mod: Dictionary, placed: Array[Dictiona
 
 	# Every declaration this writes carries a type, so it parses in a project that treats an
 	# untyped or an inferred declaration as an error, which is the strictest setting Godot has.
-	# A value with no type gets the type the value evaluates to; a value nothing can evaluate
+	# A value with no type gets the type the value evaluates to. A value nothing can evaluate
 	# here, and a declaration with neither, are spelled out as Variant.
 	if not var_type.is_empty():
 		var_line += ": " + var_type
@@ -767,7 +767,7 @@ func _variable_insertion_point(lines: Array[String]) -> int:
 		# Annotations off first. `@abstract class_name X` is one line in Godot 4.5 and later, and
 		# unstripped it matches nothing here, so the header is only found when some other line
 		# carries it. A script whose whole header is that one line leaves `after_header` at 0 and
-		# takes the new line above the `class_name`, where it does not parse; one that declares
+		# takes the new line above the `class_name`, where it does not parse. One that declares
 		# `extends` first takes it between the two, which does not parse either. Stripping also
 		# turns `@export var x` into `var x`, which is why the annotation names are gone below.
 		var line: String = GdhPatterns.without_annotations(lines[i])
@@ -886,7 +886,7 @@ signal state_changed(old_state: String, new_state: String)
 
 var current_state: String = ""
 ## State objects by name. A state may define enter(), exit(), process(delta) and
-## physics_process(delta); whichever it has are called.
+## physics_process(delta). Whichever it has are called.
 var states: Dictionary = {}
 
 

package/build/godot/operations/godot_operations.gd

@@ -4,7 +4,7 @@ extends SceneTree
 # The command line the server runs is
 # `godot --headless --path <project> --script <this> <operation> @file:<params.json> <answer.json>`,
 # and the one JSON object written to the answer file is the answer. Everything an operation does
-# lives in a sibling module; this file is the command table and the wire format.
+# lives in a sibling module. This file is the command table and the wire format.
 #
 # A file rather than a line on stdout, because the project's autoloads run after `_init` and print
 # into the same stream: an autoload printing a dictionary in `_process` was the last JSON line out

package/build/godot/operations/import_pipeline.gd

@@ -4,8 +4,8 @@ const GdhRead = preload("reading.gd")
 const GdhSerialisation = preload("serialisation.gd")
 const GdhFileWalk = preload("file_walk.gd")
 const GdhLog = preload("logger.gd")
-## What the engine imports with no tool outside it, for finding what has not been imported yet;
-## everything imported already is found by its sidecar whatever its extension.
+## What the engine imports with no tool outside it, for finding what has not been imported yet.
+## Everything imported already is found by its sidecar whatever its extension.
 const IMPORTABLE_EXTENSIONS: Array[String] = [
 	"png",
 	"jpg",
@@ -95,7 +95,7 @@ func get_import_status(params: Dictionary) -> Dictionary:
 		if not full_path.begins_with("res://"):
 			full_path = "res://" + full_path
 
-		# missing_source is a sidecar whose source has gone; with neither, the path names nothing
+		# missing_source is a sidecar whose source has gone. With neither, the path names nothing
 		# the engine ever imported, and answering it as a lost source sent a caller to restore a
 		# file.
 		if (
@@ -300,7 +300,7 @@ static func _as_option(given: Variant, held: Variant) -> Variant:
 ## written as {"1818847073": 0.0}. The importer hands that to FontFile.opentype_feature_overrides,
 ## which keys features by their tag as an int, so the call reported success and the font kept its
 ## ligatures. A key is an int where the importer keys the option by OpenType tags, or where every
-## key the option holds already is one; a value is an int where every value held is, or for a tag.
+## key the option holds already is one. A value is an int where every value held is, or for a tag.
 ## Answers the dictionary under value, or why it cannot be written under refused.
 static func _keyed_as_option(
 	name: String, given: Dictionary, held: Variant, importer: String
@@ -421,7 +421,7 @@ func _import_status_of(resource_path: String, import_file_path: String) -> Dicti
 	# The checks are the ones EditorFileSystem::_test_for_reimport makes, in its order, so a
 	# resource reads as needing an import when the editor's next scan would import it. The
 	# importer's own two cannot be asked here, where no importer is loaded, so they are made from
-	# what was measured of the built-in ones; an importer a plugin adds is judged by its files
+	# what was measured of the built-in ones. An importer a plugin adds is judged by its files
 	# alone.
 	var sidecar: ConfigFile = ConfigFile.new()
 	var stale: Dictionary = (
@@ -497,7 +497,7 @@ func _never_imported(resource_path: String) -> String:
 			+ extension
 			+ " files through Blender, which it finds through the editor setting "
 			+ BLENDER_SETTING
-			+ ". An editor with it set imports them on its scan; an import pass with it unset "
+			+ ". An editor with it set imports them on its scan. An import pass with it unset "
 			+ "stops at the first one and imports nothing, and setting "
 			+ BLENDER_ENABLED
 			+ " to false has the engine leave them unimported"
@@ -508,7 +508,7 @@ func _never_imported(resource_path: String) -> String:
 	return (
 		"no importer built into the engine takes ."
 		+ extension
-		+ " files; one added by a plugin or an extension is known only to the editor, whose scan "
+		+ " files. One added by a plugin or an extension is known only to the editor, whose scan "
 		+ "imports them"
 	)
 
@@ -706,7 +706,7 @@ static func _md5_of_all(paths: Array[String]) -> String:
 
 
 ## The md5 of each resource's sidecar as the editor last imported it, keyed by path, from the cache
-## the editor writes under .godot/editor; empty when there is no cache or it cannot be read.
+## the editor writes under .godot/editor. Empty when there is no cache or it cannot be read.
 func _imported_sidecar_md5s() -> Dictionary:
 	if _sidecar_md5s != null:
 		return _sidecar_md5s
@@ -716,7 +716,7 @@ func _imported_sidecar_md5s() -> Dictionary:
 	var file: FileAccess = null if cache.is_empty() else FileAccess.open(cache, FileAccess.READ)
 	if file == null:
 		return found
-	# The first line is the import settings version; then a "::<dir>::<time>" line opens each
+	# The first line is the import settings version, then a "::<dir>::<time>" line opens each
 	# directory, and each file line is nine fields split by "::", the last holding the file's
 	# dependencies, which may contain the splitter. The eighth field is "<>"-separated, with the
 	# sidecar's md5 sixth.
@@ -765,12 +765,12 @@ static func _path_of(entry: String) -> String:
 	return entry if at < 0 else entry.substr(at + 2)
 
 
-## Every path [param resource_path] depends on, through the resources it depends on in turn; a set,
+## Every path [param resource_path] depends on, through the resources it depends on in turn. A set,
 ## keyed by path.
 static func _depended_on(resource_path: String) -> Dictionary[String, bool]:
 	var found: Dictionary[String, bool] = {}
 	var pending: Array[String] = [resource_path]
-	# Every path is followed once, which ends the walk and survives a cycle; a cap or a list of
+	# Every path is followed once, which ends the walk and survives a cycle. A cap or a list of
 	# extensions would leave out a material behind a long chain or in a saved .mesh.
 	while not pending.is_empty():
 		var next: String = pending.pop_back()
@@ -787,7 +787,7 @@ static func _shaped_by_a_script(sidecar: ConfigFile) -> bool:
 	return not str(sidecar.get_value("params", "import_script/path", "")).is_empty()
 
 
-## The files an import wrote, from its sidecar's [code]dest_files[/code]; empty when it lists none.
+## The files an import wrote, from its sidecar's [code]dest_files[/code]. Empty when it lists none.
 static func _outputs_of(sidecar: ConfigFile) -> Array[String]:
 	var outputs: Array[String] = []
 	var listed: Variant = sidecar.get_value("deps", "dest_files", [])

package/build/godot/operations/input_actions.gd

@@ -235,7 +235,7 @@ func add_input_action(params: Dictionary) -> Dictionary:
 
 	_log.info("Adding input action: " + action_name)
 	# The editor's Input Map refuses these, since project.godot keys an action by its name and
-	# the characters below are its own syntax there; a name holding one is written escaped and
+	# the characters below are its own syntax there. A name holding one is written escaped and
 	# reads back as a name nobody typed.
 	for index: int in action_name.length():
 		var code: int = action_name.unicode_at(index)
@@ -299,7 +299,7 @@ func add_input_action(params: Dictionary) -> Dictionary:
 		answer["old_deadzone"] = old_deadzone
 
 	# Through ProjectSettings so the file is saved the way the editor saves it, header and
-	# every other line kept; a ConfigFile of project.godot drops the comments on the way out.
+	# every other line kept. A ConfigFile of project.godot drops the comments on the way out.
 	ProjectSettings.set_setting(setting, action)
 	var err: Error = GdhProjectFile.save([setting])
 	if err != OK:
@@ -423,7 +423,7 @@ func remove_input_action(params: Dictionary) -> Dictionary:
 # The value project.godot stores for one input action.
 #
 # It has to be a Dictionary holding real InputEvent objects. The engine writes those as the
-# unquoted expression it parses back into an action; hand it the same thing as assembled
+# unquoted expression it parses back into an action. Hand it the same thing as assembled
 # text and it writes a quoted, escaped string, which loads as a String and leaves InputMap
 # with no action at all while add_input_action still reports the events it was given.
 func build_input_action(deadzone: float, events: Array) -> Dictionary:

package/build/godot/operations/logger.gd

@@ -1,6 +1,6 @@
 extends RefCounted
 
-# Everything printed is diagnostics; the answer goes to a file. The server reads `[ERROR]` lines as
+# Everything printed is diagnostics. The answer goes to a file. The server reads `[ERROR]` lines as
 # the operation's own errors, and the prefixes let a human read the rest without parsing it.
 #
 # Every module preloads this as `GdhLog`. `Logger` is a native class from Godot 4.5 on, and a

package/build/godot/operations/plugins.gd

@@ -135,7 +135,7 @@ static func _why_not_loaded(plugin_cfg_path: String) -> String:
 	var script_path: String = plugin_cfg_path.get_base_dir().path_join(script_name)
 	if not FileAccess.file_exists(script_path):
 		return "%s does not exist, so the editor will not enable the plugin." % script_path
-	# Loaded only to learn whether the editor could; what the engine says of a script that does not
+	# Loaded only to learn whether the editor could. What the engine says of a script that does not
 	# parse is about a file the answer does not describe.
 	printerr(GdhLog.ASIDE)
 	var script: Script = ResourceLoader.load(
@@ -189,7 +189,7 @@ func disable_plugin(params: Dictionary) -> Dictionary:
 # folder names, because the list is written back whole: reading names off a pattern for
 # `res://addons/<name>/plugin.cfg` dropped a plugin one folder down, and the next enable or disable
 # wrote the list without it, disabling a plugin nobody named. The editor stores the engine
-# expression PackedStringArray(...), which loads as that type; the String form is what an older
+# expression PackedStringArray(...), which loads as that type. The String form is what an older
 # hand-edited file can carry.
 func _enabled_paths() -> Array[String]:
 	var paths: Array[String] = []

package/build/godot/operations/project_config.gd

@@ -174,7 +174,7 @@ func set_project_setting(params: Dictionary) -> Dictionary:
 			% [setting_path, "setting is" if near.size() == 1 else "settings are", ", ".join(near)]
 		)
 	# Written as given, since a file can be made after the setting names it, as an import makes a
-	# translation; said, since until then the engine complains of it on every boot.
+	# translation. Said, since until then the engine complains of it on every boot.
 	var missing: Array[String] = _missing_files(final_value)
 	if not missing.is_empty():
 		answer["missing_files"] = missing
@@ -190,7 +190,7 @@ func set_project_setting(params: Dictionary) -> Dictionary:
 		var made: Array[String] = _translations_made_by(missing)
 		if not made.is_empty():
 			said += (
-				"; project_import reimport makes the translation files from " + ", ".join(made)
+				". project_import reimport makes the translation files from " + ", ".join(made)
 			)
 		answer["note"] = (str(answer["note"]) + " " if answer.has("note") else "") + said + "."
 	ProjectSettings.set_setting(setting_path, final_value)
@@ -289,7 +289,7 @@ func unset_project_setting(params: Dictionary) -> Dictionary:
 		var near: PackedStringArray = PackedStringArray() if held else _settings_near(setting_path)
 		if not near.is_empty():
 			answer["note"] += (
-				" Nor does the engine declare it; the nearest %s %s."
+				" Nor does the engine declare it. The nearest %s %s."
 				% ["setting is" if near.size() == 1 else "settings are", ", ".join(near)]
 			)
 		return _with_what_holds(answer, setting_path)
@@ -415,7 +415,7 @@ func add_autoload(params: Dictionary) -> Dictionary:
 				(
 					"An autoload cannot be added disabled: Godot loads every autoload in the list "
 					+ "at every start. global: false keeps its name out of the global scope and "
-					+ "still loads it; remove_autoload is what stops it loading"
+					+ "still loads it. remove_autoload is what stops it loading"
 				)
 			)
 		)
@@ -443,7 +443,7 @@ func add_autoload(params: Dictionary) -> Dictionary:
 	var was_updated: bool = ProjectSettings.has_setting(setting)
 
 	# An asterisk in front of the path makes the autoload's name a global variable, the editor's
-	# "Global Variable" column. Without it the node still comes up under the root; only the name
+	# "Global Variable" column. Without it the node still comes up under the root. Only the name
 	# stops resolving.
 	var entry: String = ("*" if global else "") + path
 	if was_updated and str(ProjectSettings.get_setting(setting)) == entry:
@@ -455,7 +455,7 @@ func add_autoload(params: Dictionary) -> Dictionary:
 			"action": "unchanged",
 			"saved": false,
 		}
-	# The editor's Add replaces an entry of the same name too; said here, since the replaced script
+	# The editor's Add replaces an entry of the same name too. Said here, since the replaced script
 	# is no longer loaded and nothing else in the answer names it.
 	var held: String = str(ProjectSettings.get_setting(setting)) if was_updated else ""
 	ProjectSettings.set_setting(setting, entry)
@@ -484,7 +484,7 @@ func add_autoload(params: Dictionary) -> Dictionary:
 static func _not_an_autoload(path: String) -> String:
 	var refused: String = "%s is %s, and an autoload is a scene or a script extending Node"
 	if not ResourceLoader.exists(path):
-		return (refused + "; nothing was written.") % [path, "a file Godot does not load"]
+		return (refused + ". Nothing was written.") % [path, "a file Godot does not load"]
 	var loaded: Resource = load(path)
 	if loaded is PackedScene:
 		return ""
@@ -492,7 +492,7 @@ static func _not_an_autoload(path: String) -> String:
 		var kind: String = "nothing Godot could load"
 		if loaded != null:
 			kind = "a " + loaded.get_class()
-		return (refused + "; nothing was written.") % [path, kind]
+		return (refused + ". Nothing was written.") % [path, kind]
 	var script: Script = loaded
 	if not script.can_instantiate():
 		return ""
@@ -502,7 +502,7 @@ static func _not_an_autoload(path: String) -> String:
 	return (
 		(
 			"%s extends %s, which is not a Node, and Godot instantiates an autoload under the root "
-			+ "as a node, so every start of the game would fail to load it; nothing was written."
+			+ "as a node, so every start of the game would fail to load it. Nothing was written."
 		)
 		% [path, base]
 	)
@@ -530,7 +530,7 @@ static func _autoload_name_refusal(name: String) -> String:
 		return ""
 	return (
 		(
-			"%s cannot name an autoload: %s. Nothing was written; the editor's Autoload tab "
+			"%s cannot name an autoload: %s. Nothing was written. The editor's Autoload tab "
 			+ "refuses it too."
 		)
 		% [JSON.stringify(name), reason]
@@ -569,7 +569,7 @@ func list_autoloads(_params: Dictionary) -> Dictionary:
 		var value: String = str(ProjectSettings.get_setting(setting))
 		var path: String = value.trim_prefix("*")
 
-		# Enabled whatever the asterisk says, because every autoload listed is loaded; the asterisk
+		# Enabled whatever the asterisk says, because every autoload listed is loaded. The asterisk
 		# is whether its name is a global variable.
 		var autoload_info: Dictionary = {
 			"name": setting.trim_prefix("autoload/"),

package/build/godot/operations/project_validation.gd

@@ -264,7 +264,7 @@ func validate_project(params: Dictionary) -> Dictionary:
 		)
 
 	# A connection whose method or signal is not there loads without a word and fails only once the
-	# game runs, on every emission or not at all; the references check sees files, not members.
+	# game runs, on every emission or not at all. The references check sees files, not members.
 	checks_performed.append("connections")
 	for entry: Dictionary in GdhSceneConnections.new(_log).broken():
 		warnings.append(

package/build/godot/operations/property_paths.gd

@@ -75,7 +75,7 @@ static func _stepped(target: Object, name: String, at: int) -> Array:
 
 
 ## The refusal for [param name], which [param target] does not declare, when a step of it indexes a
-## list [param target] holds and names no resource in it; or "".
+## list [param target] holds and names no resource in it, or "".
 static func unlisted(target: Object, name: String) -> String:
 	var at: int = name.find("/")
 	while at > 0:
@@ -163,7 +163,7 @@ static func held_at(target: Object, property: String) -> Resource:
 ## only once the element exists, so a TileSet with no physics layer had no
 ## physics_layer_0/collision_layer to write. A list the engine declares as an array grows through
 ## the method named after its elements, add_physics_layer for physics_layer_, given the indices of
-## the lists around it; a list counted by a property, as a tile's polygons are by polygons_count,
+## the lists around it. A list counted by a property, as a tile's polygons are by polygons_count,
 ## grows by raising the count.
 static func grow(target: Object, name: String, called: String) -> String:
 	var steps: PackedStringArray = name.split("/")
@@ -255,7 +255,7 @@ static func class_called(target: Object) -> String:
 
 
 ## The refusal for [param name], which [param target] does not declare, when it runs through a
-## resource saved in a file other than [param home], the one [param target] is saved in; or "". The
+## resource saved in a file other than [param home], the one [param target] is saved in, or "". The
 ## write belongs in that file, since this one would be saved and that one left as it was: through a
 ## TileMapLayer's tile_set kept in a file of its own, or through the mesh of an instance's editable
 ## child, which is built into the scene the instance comes from.

package/build/godot/operations/property_values.gd

@@ -20,7 +20,7 @@ const GdhRead = preload("reading.gd")
 const GdhSame = preload("same_values.gd")
 const GdhSerialisation = preload("serialisation.gd")
 const GdhShapes = preload("value_shapes.gd")
-# The data types a Theme names its items by, as in "Button/colors/font_color", and what each holds.
+# The data types a Theme names its items by, as in `Button/colors/font_color`, and what each holds.
 const THEME_ITEMS: Dictionary[String, Array] = {
 	"colors": [TYPE_COLOR, ""],
 	"constants": [TYPE_INT, ""],
@@ -40,6 +40,7 @@ const HEADINGS: int = PROPERTY_USAGE_CATEGORY | PROPERTY_USAGE_GROUP | PROPERTY_
 ## Control's layout_mode values, which the engine does not expose as constants.
 const LAYOUT_MODE_POSITION: int = 0
 const LAYOUT_MODE_ANCHORS: int = 1
+const LAYOUT_MODE_UNCONTROLLED: int = 3
 ## What a container sets on each child it lays out, beside the anchors and offsets.
 const PLACED_BY_A_CONTAINER: Array[String] = ["position", "size", "global_position"]
 
@@ -74,7 +75,7 @@ var _names_no_node: Dictionary = {}
 ##
 ## Three separate questions, asked in order, because a caller may say what it means in three
 ## ways: a dictionary that names its own type, a dictionary shaped like the type the property
-## declares, or a bare array positional for a vector. Each is its own function; asking all three
+## declares, or a bare array positional for a vector. Each is its own function. Asking all three
 ## in one was twenty-four exits deep and impossible to follow.
 ##
 ## [param elements] is what a typed Array or Dictionary holds, as [method GdhDeclared.elements_of]
@@ -215,8 +216,8 @@ func write_all(target: Object, properties: Dictionary) -> String:
 	var written_at: Dictionary[String, int] = {}
 	var writes: int = 0
 	# Which other property's write last changed each one already written, by name. A Gradient keeps
-	# one offset for each colour, so offsets given after colors cut them back, and the refusal said
-	# only that the engine had changed the colours.
+	# one offset for each colour, so offsets given after `colors` cut them back, and the refusal
+	# said only that the engine had changed the colours.
 	var undone_by: Dictionary[String, String] = {}
 	# A refusal of one of several leaves the others unwritten too, which a refusal naming only the
 	# one it refused left a caller to guess.
@@ -349,7 +350,7 @@ func _note_undone(
 ## sizes its children and the scene keeps none of that for them, so their anchors, offsets, position
 ## and size are refused with what a child does set. A control in Position mode ignores an anchor
 ## preset, and the inspector offers anchors only in Anchors mode, so writing one puts it there
-## first, as picking a preset in the editor does; alsoChanged then names layout_mode.
+## first, as picking a preset in the editor does, and alsoChanged then names layout_mode.
 func _laid_out(control: Control, name: String) -> String:
 	var base: String = name.get_slice(":", 0)
 	var anchoring: bool = base == "anchors_preset" or base.begins_with("anchor_")
@@ -366,8 +367,14 @@ func _laid_out(control: Control, name: String) -> String:
 			)
 			% [control.name, parent.name, parent.get_class(), base]
 		)
-	if anchoring and GdhRead.as_int(control.get("layout_mode")) == LAYOUT_MODE_POSITION:
+	var mode: int = GdhRead.as_int(control.get("layout_mode"))
+	if anchoring and mode == LAYOUT_MODE_POSITION:
 		control.set("layout_mode", LAYOUT_MODE_ANCHORS)
+	# A scene's root reads as Uncontrolled but keeps the Position mode it was made with until it
+	# enters a tree, and the engine ignores a preset in that stored mode, so full rect read back as
+	# top left on every root a headless edit wrote.
+	elif anchoring and mode == LAYOUT_MODE_UNCONTROLLED:
+		control.set("layout_mode", LAYOUT_MODE_UNCONTROLLED)
 	return ""
 
 
@@ -447,7 +454,7 @@ func _write(target: Object, key: String, value: Variant) -> void:
 
 
 ## The declaration the last step of [param path] would have, typed as the component it reaches, so
-## a fraction for an integer vector's axis is refused as one for an int property is; or
+## a fraction for an integer vector's axis is refused as one for an int property is, or
 ## {"refused": why} for the first step that is not there.
 func _component_slot(target: Object, path: String) -> Dictionary:
 	var steps: PackedStringArray = path.split(":")
@@ -487,7 +494,7 @@ func _component_slot(target: Object, path: String) -> Dictionary:
 			return {
 				"refused":
 				(
-					"%s.%s is %s, so it has no %s; it has %s."
+					"%s.%s is %s, so it has no %s. It has %s."
 					% [owner, walked, sort, step, ", ".join(has)]
 				),
 			}
@@ -562,7 +569,7 @@ func value_for(target: Object, declared: Dictionary, raw: Variant) -> Array:
 
 
 ## A property holding a Node is given the node the path leads to from [param target], as the
-## editor's inspector gives it; the scene is saved with the path. A res:// path could never name a
+## editor's inspector gives it. The scene is saved with the path. A res:// path could never name a
 ## node, so the remedy a caller is given is a node path.
 func _node_reference(target: Object, property: String, raw: Variant) -> Array:
 	if raw == null:
@@ -739,7 +746,7 @@ func colour_from(raw: Variant, named: String) -> Array:
 		(
 			(
 				'%s is {"r": .., "g": .., "b": .., "a": ..} from 0 to 1, a optional, or an html '
-				+ 'code such as "#ff8000" or "#ff800080"; %s is neither.'
+				+ 'code such as "#ff8000" or "#ff800080". %s is neither.'
 			)
 			% [named, JSON.stringify(raw)]
 		),
@@ -891,7 +898,7 @@ func _parse_resource_tag(value: Dictionary) -> Array:
 		)
 		return [true, null]
 	# A plain Resource with a script or values of its own, as a read answers one built into a scene,
-	# is one to build; taken as nothing, writing such a read back cleared the property.
+	# is one to build. Taken as nothing, writing such a read back cleared the property.
 	if value.size() > 1:
 		return _parse_new_resource("Resource", value)
 	return [true, null]