gdharness 1.3.39 → 1.3.41

package/build/godot/addons/gdharness_editor/animation_reads.gd

@@ -125,15 +125,16 @@ static func no_animation(player: AnimationPlayer, called: String, animation_name
 
 static func _summary(anim: Animation) -> Dictionary:
 	return {
-		"length": anim.length,
+		"length": held_seconds(anim.length),
 		"loopMode": LOOP_MODE_NAMES.get(anim.loop_mode, str(anim.loop_mode)),
-		"step": anim.step,
+		"step": held_seconds(anim.step),
 	}
 
 
-## [param seconds], a key's time, as the shortest decimal holding the same 32-bit float. A scene keeps
-## key times as 32-bit floats, so a key put at 0.7 read back as 0.699999988079071.
-static func key_time(seconds: float) -> float:
+## [param seconds], a key's time or an animation's length or step, as the shortest decimal holding
+## the same 32-bit float. An animation keeps all three as 32-bit floats, so a key put at 0.7 read
+## back as 0.699999988079071 and a step of 0.1 as 0.100000001490116.
+static func held_seconds(seconds: float) -> float:
 	var held: float = PackedFloat32Array([seconds])[0]
 	for places: int in range(0, 10):
 		var shorter: float = String.num(held, places).to_float()
@@ -159,7 +160,7 @@ static func _track(anim: Animation, track: int, values: GdhSerialisation) -> Dic
 	var keyframes: Array[Dictionary] = []
 	var methods: Dictionary = {}
 	for key: int in anim.track_get_key_count(track):
-		var keyframe: Dictionary = {"time": key_time(anim.track_get_key_time(track, key))}
+		var keyframe: Dictionary = {"time": held_seconds(anim.track_get_key_time(track, key))}
 		if kind == Animation.TYPE_METHOD:
 			var method: String = str(anim.method_track_get_name(track, key))
 			methods[method] = true

package/build/godot/addons/gdharness_editor/file_reads.gd

@@ -11,6 +11,7 @@ extends RefCounted
 ## initialisers run, and a resource with a script is made with it.
 
 const GdhRead = preload("reading.gd")
+const GdhFileWalk = preload("file_walk.gd")
 const GdhSame = preload("same_values.gd")
 const GdhSerialisation = preload("serialisation.gd")
 const GdhShapes = preload("value_shapes.gd")
@@ -487,7 +488,7 @@ static func _stored(type: String, given: Dictionary, include_defaults: bool) ->
 static func resource(res_path: String, include_defaults: bool) -> Dictionary:
 	var file: String = res_path.get_slice("::", 0)
 	if not FileAccess.file_exists(file):
-		return {"ok": false, "error": "No resource at " + file}
+		return {"ok": false, "error": GdhFileWalk.new().with_nearest_files("No resource at " + file, file)}
 	var whole: Resource = ResourceLoader.load(file, "", ResourceLoader.CACHE_MODE_IGNORE)
 	if whole == null:
 		return {"ok": false, "error": "%s did not load as a resource." % file}

package/build/godot/addons/gdharness_editor/file_walk.gd

@@ -35,8 +35,24 @@ static func missing_reason(path: String) -> String:
 
 ## [param said], the refusal for [param path], a res:// path nothing is at, with the files of its
 ## extension whose names are nearest its own, or every one when there are few and none is near, so
-## the caller has a path to send instead.
+## the caller has a path to send instead. Files of the same name beside it come first, since a
+## misspelt extension has no file of its own extension to be near.
 func with_nearest_files(said: String, path: String) -> String:
+	# One the refusal names is the file it refuses, as a script given for a scene is. Word by word,
+	# since res://brain.gd is inside res://brain.gdd.
+	var named: Array[String] = []
+	for word: String in said.replace("\n", " ").replace(",", " ").replace(";", " ").split(" ", false):
+		named.append(word.rstrip(".:"))
+	var namesakes: Array[String] = []
+	for file: String in _namesakes(path):
+		if not file in named:
+			namesakes.append(file)
+	if not namesakes.is_empty():
+		var alone: bool = namesakes.size() == 1
+		return (
+			"%s. The %s of that name beside it %s %s."
+			% [said, "file" if alone else "files", "is" if alone else "are", ", ".join(namesakes)]
+		)
 	var extension: String = path.get_extension()
 	if extension.is_empty():
 		return said
@@ -65,6 +81,22 @@ func with_nearest_files(said: String, path: String) -> String:
 	return "%s. None of the project's %d .%s files is named like it." % [said, files.size(), extension]
 
 
+# The files in [param path]'s folder named as it is with another extension, leaving out the import
+# and uid files the engine keeps beside a file, which are named after the whole file name.
+static func _namesakes(path: String) -> Array[String]:
+	var found: Array[String] = []
+	var folder: String = path.get_base_dir()
+	if not DirAccess.dir_exists_absolute(folder):
+		return found
+	var stem: String = path.get_file().get_basename()
+	var files: PackedStringArray = DirAccess.get_files_at(folder)
+	files.sort()
+	for file: String in files:
+		if file.get_basename() == stem and file != path.get_file():
+			found.append(folder.path_join(file))
+	return found
+
+
 # A directory the engine steps over, marker file and all.
 func is_stepped_over(path: String) -> bool:
 	return FileAccess.file_exists(path + ".gdignore")

package/build/godot/addons/gdharness_editor/property_values.gd

@@ -383,19 +383,16 @@ func _readable(value: Variant, relative_to: Node) -> Variant:
 	return _values.serialize_value(value)
 
 
-## What [param target] stores, by name, but its script and the properties in [param leave]. A list
-## or a map is copied, since a setter can change the one it holds in place.
+## What [param target] stores, by name, but its script and the properties in [param leave], in the
+## names a read answers with: a Curve's points as point_0/position and the rest rather than the _data
+## list every point write changes. A list or a map is copied, since a setter can change the one it
+## holds in place.
 func _stored(target: Object, leave: Dictionary) -> Dictionary:
 	var held: Dictionary = {}
-	for entry: Dictionary in target.get_property_list():
+	for entry: Dictionary in GdhShapes.read_properties(target):
 		var name: String = str(entry["name"])
 		var usage: int = GdhRead.as_int(entry["usage"])
-		if (
-			usage & PROPERTY_USAGE_STORAGE == 0
-			or usage & HEADINGS != 0
-			or name == "script"
-			or leave.has(name)
-		):
+		if usage & HEADINGS != 0 or name == "script" or leave.has(name):
 			continue
 		var value: Variant = target.get(name)
 		if value is Array:

package/build/godot/addons/gdharness_editor/tools/animation_tools.gd

@@ -320,7 +320,10 @@ func create_animation(args: Dictionary) -> Dictionary:
 			return "%s would not be in the scene when it loads." % animation_name
 		return ""
 	var answer: Dictionary = {
-		"ok": true, "animationName": animation_name, "length": anim.length, "loopMode": loop_mode_name
+		"ok": true,
+		"animationName": animation_name,
+		"length": GdhAnimationReads.held_seconds(anim.length),
+		"loopMode": loop_mode_name
 	}
 	if library[2]:
 		answer["libraryMade"] = animation_name.get_slice("/", 0) if animation_name.contains("/") else ""
@@ -477,9 +480,9 @@ func set_animation(args: Dictionary) -> Dictionary:
 	var answer: Dictionary = {
 		"ok": true,
 		"animationName": animation_name,
-		"length": anim.length,
+		"length": GdhAnimationReads.held_seconds(anim.length),
 		"loopMode": GdhAnimationReads.LOOP_MODE_NAMES.get(anim.loop_mode, str(anim.loop_mode)),
-		"step": anim.step,
+		"step": GdhAnimationReads.held_seconds(anim.step),
 	}
 	var past: String = _past_length(anim, animation_name)
 	if not past.is_empty():

package/build/godot/addons/gdharness_editor/tools/animation_tracks.gd

@@ -444,7 +444,7 @@ static func _keys_at(anim: Animation, calling: Array, times: Array) -> Array:
 			if pair[1] >= 0 and key != pair[1]:
 				continue
 			var time: float = anim.track_get_key_time(index, key)
-			var _listed: bool = held.append(str(GdhAnimationReads.key_time(time)))
+			var _listed: bool = held.append(str(GdhAnimationReads.held_seconds(time)))
 			for given: float in times:
 				if GdhAnimationReads.same_time(time, given):
 					at.append([index, key])

package/build/godot/addons/gdharness_editor/tools/scene_tools.gd

@@ -142,7 +142,6 @@ func _create_of_a_class(args: Dictionary) -> Dictionary:
 
 	if scene_path.is_empty():
 		return {"ok": false, "error": "Missing scenePath"}
-	var asked_type: String = root_node_type
 	var made: Dictionary = GdhSceneFile.made_as(
 		root_node_type,
 		"" if script_path.is_empty() else GdhSceneFile.res_path(project_path, script_path),
@@ -200,13 +199,20 @@ func _create_of_a_class(args: Dictionary) -> Dictionary:
 	if not folder.is_empty():
 		root.free()
 		return {"ok": false, "error": folder}
+	# Read before the write, which frees the root.
+	var root_class: Dictionary = GdhSceneFile.class_of(root)
 	var written: Dictionary = scene.write()
 	if not written.is_empty():
 		return written
 
 	var answer: Dictionary = {
-		"ok": true, "scenePath": scene_path, "rootNodeType": asked_type, "rootNodeName": root_node_name
+		"ok": true,
+		"scenePath": scene_path,
+		"rootNodeType": root_class["nodeType"],
+		"rootNodeName": root_node_name
 	}
+	if root_class.has("scriptClass"):
+		answer["scriptClass"] = root_class["scriptClass"]
 	if not script_path.is_empty():
 		answer["script"] = script_path
 	if not had_folder:
@@ -241,7 +247,6 @@ func add_node(args: Dictionary) -> Dictionary:
 
 	if node_name.is_empty():
 		return {"ok": false, "error": "Missing nodeName"}
-	var asked_type: String = node_type
 	var class_script: Script = null
 	if not node_type.is_empty() and not ClassDB.class_exists(node_type):
 		var declared: Dictionary = GdhSceneFile.script_class(node_type, "Node")
@@ -301,13 +306,9 @@ func add_node(args: Dictionary) -> Dictionary:
 
 	var new_path: String = scene.path_of(new_node)
 	# Read before the write, which frees the scene it was added to.
-	var answer: Dictionary = {
-		"ok": true,
-		"nodeName": node_name,
-		"nodeType": asked_type if class_script != null else new_node.get_class(),
-		"nodePath": new_path,
-		"index": new_node.get_index(),
-	}
+	var answer: Dictionary = {"ok": true, "nodeName": node_name}
+	answer.merge(GdhSceneFile.class_of(new_node))
+	answer.merge({"nodePath": new_path, "index": new_node.get_index()})
 	if not properties.is_empty():
 		var held: Dictionary = {}
 		for key: Variant in properties:

package/build/godot/addons/gdharness_editor/tools/signal_tools.gd

@@ -10,6 +10,9 @@ const GdhSerialisation = preload("../serialisation.gd")
 
 ## What every emission meets when a connection cannot call its method.
 const FAILS: String = ", so every emission fails to call it."
+## The engine's CONNECT_INHERITED, which GDScript is not given: on a connection an instanced or
+## inherited scene makes, as a scene holding one loads it.
+const CONNECT_INHERITED: int = 32
 ## The names Object.ConnectFlags gives each bit. The number alone left a reader guessing that 2 is
 ## the persistence every connection in a saved scene carries.
 const CONNECT_FLAG_NAMES: Dictionary[int, String] = {
@@ -18,9 +21,7 @@ const CONNECT_FLAG_NAMES: Dictionary[int, String] = {
 	Object.CONNECT_ONE_SHOT: "one_shot",
 	Object.CONNECT_REFERENCE_COUNTED: "reference_counted",
 	Object.CONNECT_APPEND_SOURCE_OBJECT: "append_source_object",
-	# The engine's CONNECT_INHERITED, which GDScript is not given: on a connection an instanced scene
-	# makes inside itself, as a scene holding one loads it.
-	32: "inherited",
+	CONNECT_INHERITED: "inherited",
 }
 ## The flags a caller may give: the engine's own CONNECT_INHERITED marks a connection an instanced
 ## scene makes, and is never one a scene makes for itself.
@@ -295,7 +296,9 @@ static func _misfit(source: Node, signal_name: String, callable: Callable, flags
 			break
 	if flags & Object.CONNECT_APPEND_SOURCE_OBJECT:
 		passed.append({"name": "source", "type": TYPE_OBJECT, "class_name": source.get_class()})
-	passed = passed.slice(0, maxi(passed.size() - callable.get_unbound_arguments_count(), 0))
+	var emitted: int = passed.size()
+	var unbound: int = callable.get_unbound_arguments_count()
+	passed = passed.slice(0, maxi(emitted - unbound, 0))
 	var from_signal: int = passed.size()
 	for bound: Variant in callable.get_bound_arguments():
 		var bound_class: String = ""
@@ -303,43 +306,58 @@ static func _misfit(source: Node, signal_name: String, callable: Callable, flags
 			var object: Object = bound
 			bound_class = object.get_class()
 		passed.append({"name": "bound", "type": typeof(bound), "class_name": bound_class})
+	var binds: int = passed.size() - from_signal
+
+	# What the method is called with, said in the parts that make it: an answer counting the bound
+	# arguments among the signal's said the signal passed more than it declares.
+	var called: String = "%s passes %s" % [signal_name, _count(emitted)]
+	if unbound > 0 or binds > 0:
+		var changed: Array[String] = []
+		if unbound > 0:
+			changed.append("unbinds %d" % unbound)
+		if binds > 0:
+			changed.append("binds %d" % binds)
+		called += (
+			" and the connection %s, so %s is called with %s, and"
+			% [" and ".join(PackedStringArray(changed)), method, _count(passed.size())]
+		)
+	else:
+		called += ", and " + method
 
 	var parameters: Array = taken.get("args", [])
 	var defaults: Array = taken.get("default_args", [])
 	var needed: int = parameters.size() - defaults.size()
 	if passed.size() < needed:
-		return "%s passes %s, and %s needs %d%s" % [signal_name, _count(passed.size()), method, needed, FAILS]
+		return "%s needs %d%s" % [called, needed, FAILS]
 	if passed.size() > parameters.size():
 		var most: String = "none" if parameters.is_empty() else "at most %d" % parameters.size()
 		# Said with the misfit, since unbinds is what a connection to a method wanting less is for, and
-		# only when the extra arguments are the signal's: a bound one is not dropped by unbinding.
+		# only when the extra arguments are the signal's: a scene's connection unbinds the arguments
+		# the signal passes before it adds the bound ones, so a bound one is never dropped.
 		var extra: int = passed.size() - parameters.size()
 		var remedy: String = (
 			(
-				" Connected with unbinds %d, the last %s the signal passes %s left out."
-				% [
-					extra + callable.get_unbound_arguments_count(),
-					"argument" if extra == 1 else "%d arguments" % extra,
-					"is" if extra == 1 else "are",
-				]
+				" Connect it with unbinds %d to leave out the last %s the signal passes."
+				% [extra + unbound, "argument" if extra == 1 else "%d arguments" % extra]
 			)
 			if extra <= from_signal
 			else ""
 		)
-		return (
-			"%s passes %s, and %s takes %s%s%s"
-			% [signal_name, _count(passed.size()), method, most, FAILS, remedy]
-		)
+		return "%s takes %s%s%s" % [called, most, FAILS, remedy]
 	for at: int in passed.size():
 		var given: Dictionary = passed[at]
 		var parameter: Dictionary = parameters[at]
 		if not _unrelated(given, parameter):
 			continue
+		var whose: String = (
+			"%s passes argument %d" % [signal_name, at + 1]
+			if at < from_signal
+			else "the connection binds argument %d" % (at + 1)
+		)
 		return (
-			"%s passes argument %d as %s, and %s takes it as %s: %s%s"
+			"%s as %s, and %s takes it as %s: %s%s"
 			% [
-				signal_name,
-				at + 1,
+				whose,
 				_type_named(given),
 				method,
 				str(parameter.get("name", "")),
@@ -380,6 +398,25 @@ static func _type_named(declared: Dictionary) -> String:
 	return type_string(type)
 
 
+## The scene that makes the connection [param source] holds with [param flags], as a path, or "" for
+## one this scene makes. The engine marks such a connection inherited as the scene holding it loads:
+## from an instance, the scene instanced, and from the root of an inherited scene, the one it
+## inherits.
+static func _made_in(scene: GdhSceneFile, source: Node, flags: int) -> String:
+	if not flags & CONNECT_INHERITED:
+		return ""
+	if source != scene.root and not source.scene_file_path.is_empty():
+		return source.scene_file_path
+	var holder: Node = source if source == scene.root else source.owner
+	while holder != null and holder != scene.root and holder.scene_file_path.is_empty():
+		holder = holder.owner
+	if holder != null and holder != scene.root:
+		return holder.scene_file_path
+	var packed: PackedScene = load(scene.path) as PackedScene
+	var base: SceneState = packed.get_state().get_base_scene_state() if packed != null else null
+	return base.get_path() if base != null else "a scene this one inherits"
+
+
 static func _count(arguments: int) -> String:
 	if arguments == 0:
 		return "no arguments"
@@ -428,6 +465,21 @@ func disconnect_signal(args: Dictionary) -> Dictionary:
 				% [scene_path, said_from, signal_name, said_to, method_name]
 			)
 		)
+	var made_in: String = _made_in(scene, source, GdhRead.as_int(held["flags"]))
+	if not made_in.is_empty():
+		var named_from: String = str(source.name) if source == scene.root else from
+		var named_to: String = str(target.name) if target == scene.root else to
+		var made_by: String = (
+			"The connection from %s.%s to %s.%s is made by %s"
+			% [named_from, signal_name, named_to, method_name, made_in]
+		)
+		return scene.refuse(
+			(
+				made_by
+				+ ", and this scene saves nothing about it: disconnect it there, which changes every"
+				+ " scene using it."
+			)
+		)
 	var callable: Callable = held["callable"]
 	source.disconnect(signal_name, callable)
 
@@ -498,6 +550,9 @@ func list_connections(args: Dictionary) -> Dictionary:
 				if target_obj is Node:
 					target_path = str(root.get_path_to(target_obj as Node))
 					editable = editable and scene.foreign(target_obj as Node).is_empty()
+				# A connection an instanced scene makes on its own root sits on a node this scene owns,
+				# so the ends alone read it as one this scene could change.
+				var made_in: String = _made_in(scene, node, flags)
 				var listed: Dictionary = {
 					"sourceNodePath": path,
 					"signalName": signal_name,
@@ -505,11 +560,11 @@ func list_connections(args: Dictionary) -> Dictionary:
 					"methodName": str(callable.get_method()),
 					"flags": flags,
 					"flagNames": flag_names(flags),
-					# False for a connection an instanced scene makes inside itself, which only that
-					# scene can change.
-					"editable": editable,
+					"editable": editable and made_in.is_empty(),
 					"methodFound": target_obj != null and target_obj.has_method(callable.get_method()),
 				}
+				if not made_in.is_empty():
+					listed["madeIn"] = made_in
 				var bound: Dictionary = {
 					"binds": callable.get_bound_arguments(),
 					"unbinds": callable.get_unbound_arguments_count(),

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

@@ -61,9 +61,11 @@ func _init(host: Node, values: GdhValues) -> void:
 ## pointer when the game is on one.
 ##
 ## For the root window the engine asks Windows where the pointer is, and GetCursorPos refuses a
-## process on a desktop that is not in use: measured on one of gdharness's own, it answered false
-## with access denied and left the point unwritten. The engine does not check, so a game driven
-## there read get_mouse_position() as x 836852416 after a motion to 1310, 314. Nothing here can
+## process on a desktop that is not in use: on one of gdharness's own it answers false and leaves the
+## point unwritten, with access denied in the user's window station and with
+## ERROR_REQUIRES_INTERACTIVE_WINDOWSTATION in the one gdharness's desktop is in. The engine does
+## not check, so a game driven there read get_mouse_position() as x 836852416 after a motion to
+## 1310, 314. Nothing here can
 ## put a pointer on that desktop: Windows moves one only on the desktop in use, and making this one
 ## that would take the screen. What reads the injected event is right, tooltips included, since the
 ## engine places a tooltip from the motion that reached the control.

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

@@ -112,11 +112,15 @@ static func field_before(focused: Control) -> Dictionary:
 ## Whether [param focused], read as [param before], stopped being edited, as a [LineEdit] does when
 ## it is submitted: it keeps the focus and drops every key after, so a caller reading only the focus
 ## typed next into nothing.
-static func ended_editing(focused: Control, before: Dictionary) -> bool:
+##
+## [param focused] is a Variant because the key can free it, as Escape closing the panel a field is
+## on does, and a parameter typed Control refuses a freed object before the check here can run.
+static func ended_editing(focused: Variant, before: Dictionary) -> bool:
 	var was: bool = before.get("editing", false)
 	if not was or not is_instance_valid(focused):
 		return false
-	var field: LineEdit = focused as LineEdit
+	var held: Object = focused
+	var field: LineEdit = held as LineEdit
 	return field != null and not field.is_editing()
 
 
@@ -124,15 +128,18 @@ static func ended_editing(focused: Control, before: Dictionary) -> bool:
 ## typed_into and holds where its text changed, and editing_ended where it stopped being edited. A
 ## field being edited takes a printable key as typing and keeps it from the game's _unhandled_input,
 ## so Space into a name field pressed no jump, and an answer naming only the focus did not say why.
-static func field_noted(said: Dictionary, focused: Control, before: Dictionary) -> Dictionary:
+## A Variant for the reason [method ended_editing] gives.
+static func field_noted(said: Dictionary, focused: Variant, before: Dictionary) -> Dictionary:
 	if before.is_empty() or not is_instance_valid(focused):
 		return said
-	var field: LineEdit = focused as LineEdit
-	var now: String = field.text if field != null else (focused as TextEdit).text
+	var held: Object = focused
+	var control: Control = held as Control
+	var field: LineEdit = control as LineEdit
+	var now: String = field.text if field != null else (control as TextEdit).text
 	if now != before["text"]:
-		said["typed_into"] = str(focused.get_path())
-		said["holds"] = _what_it_holds(focused)
-	if ended_editing(focused, before):
+		said["typed_into"] = str(control.get_path())
+		said["holds"] = _what_it_holds(control)
+	if ended_editing(control, before):
 		said["editing_ended"] = true
 	return said
 

package/build/godot/operations/animation_reads.gd

@@ -125,15 +125,16 @@ static func no_animation(player: AnimationPlayer, called: String, animation_name
 
 static func _summary(anim: Animation) -> Dictionary:
 	return {
-		"length": anim.length,
+		"length": held_seconds(anim.length),
 		"loopMode": LOOP_MODE_NAMES.get(anim.loop_mode, str(anim.loop_mode)),
-		"step": anim.step,
+		"step": held_seconds(anim.step),
 	}
 
 
-## [param seconds], a key's time, as the shortest decimal holding the same 32-bit float. A scene keeps
-## key times as 32-bit floats, so a key put at 0.7 read back as 0.699999988079071.
-static func key_time(seconds: float) -> float:
+## [param seconds], a key's time or an animation's length or step, as the shortest decimal holding
+## the same 32-bit float. An animation keeps all three as 32-bit floats, so a key put at 0.7 read
+## back as 0.699999988079071 and a step of 0.1 as 0.100000001490116.
+static func held_seconds(seconds: float) -> float:
 	var held: float = PackedFloat32Array([seconds])[0]
 	for places: int in range(0, 10):
 		var shorter: float = String.num(held, places).to_float()
@@ -159,7 +160,7 @@ static func _track(anim: Animation, track: int, values: GdhSerialisation) -> Dic
 	var keyframes: Array[Dictionary] = []
 	var methods: Dictionary = {}
 	for key: int in anim.track_get_key_count(track):
-		var keyframe: Dictionary = {"time": key_time(anim.track_get_key_time(track, key))}
+		var keyframe: Dictionary = {"time": held_seconds(anim.track_get_key_time(track, key))}
 		if kind == Animation.TYPE_METHOD:
 			var method: String = str(anim.method_track_get_name(track, key))
 			methods[method] = true

package/build/godot/operations/dependencies.gd

@@ -428,7 +428,10 @@ func _declared_class_name(path: String) -> String:
 func _usage_files(kinds: Array) -> Array[String]:
 	var found: Array[String] = []
 	for kind: Variant in kinds:
-		match str(kind):
+		# As project_search reads an extension: ".tscn" searched no file, and the answer said
+		# nothing used a script its scene attaches.
+		var named: String = str(kind).trim_prefix(".").to_lower()
+		match named:
 			"godot":
 				found.append("res://project.godot")
 			"cfg":
@@ -436,7 +439,7 @@ func _usage_files(kinds: Array) -> Array[String]:
 				if FileAccess.file_exists("res://export_presets.cfg"):
 					found.append("res://export_presets.cfg")
 			_:
-				found.append_array(_files.find_files("res://", "." + str(kind)))
+				found.append_array(_files.find_files("res://", "." + named))
 	return found
 
 

package/build/godot/operations/file_reads.gd

@@ -11,6 +11,7 @@ extends RefCounted
 ## initialisers run, and a resource with a script is made with it.
 
 const GdhRead = preload("reading.gd")
+const GdhFileWalk = preload("file_walk.gd")
 const GdhSame = preload("same_values.gd")
 const GdhSerialisation = preload("serialisation.gd")
 const GdhShapes = preload("value_shapes.gd")
@@ -487,7 +488,7 @@ static func _stored(type: String, given: Dictionary, include_defaults: bool) ->
 static func resource(res_path: String, include_defaults: bool) -> Dictionary:
 	var file: String = res_path.get_slice("::", 0)
 	if not FileAccess.file_exists(file):
-		return {"ok": false, "error": "No resource at " + file}
+		return {"ok": false, "error": GdhFileWalk.new().with_nearest_files("No resource at " + file, file)}
 	var whole: Resource = ResourceLoader.load(file, "", ResourceLoader.CACHE_MODE_IGNORE)
 	if whole == null:
 		return {"ok": false, "error": "%s did not load as a resource." % file}

package/build/godot/operations/file_walk.gd

@@ -35,8 +35,24 @@ static func missing_reason(path: String) -> String:
 
 ## [param said], the refusal for [param path], a res:// path nothing is at, with the files of its
 ## extension whose names are nearest its own, or every one when there are few and none is near, so
-## the caller has a path to send instead.
+## the caller has a path to send instead. Files of the same name beside it come first, since a
+## misspelt extension has no file of its own extension to be near.
 func with_nearest_files(said: String, path: String) -> String:
+	# One the refusal names is the file it refuses, as a script given for a scene is. Word by word,
+	# since res://brain.gd is inside res://brain.gdd.
+	var named: Array[String] = []
+	for word: String in said.replace("\n", " ").replace(",", " ").replace(";", " ").split(" ", false):
+		named.append(word.rstrip(".:"))
+	var namesakes: Array[String] = []
+	for file: String in _namesakes(path):
+		if not file in named:
+			namesakes.append(file)
+	if not namesakes.is_empty():
+		var alone: bool = namesakes.size() == 1
+		return (
+			"%s. The %s of that name beside it %s %s."
+			% [said, "file" if alone else "files", "is" if alone else "are", ", ".join(namesakes)]
+		)
 	var extension: String = path.get_extension()
 	if extension.is_empty():
 		return said
@@ -65,6 +81,22 @@ func with_nearest_files(said: String, path: String) -> String:
 	return "%s. None of the project's %d .%s files is named like it." % [said, files.size(), extension]
 
 
+# The files in [param path]'s folder named as it is with another extension, leaving out the import
+# and uid files the engine keeps beside a file, which are named after the whole file name.
+static func _namesakes(path: String) -> Array[String]:
+	var found: Array[String] = []
+	var folder: String = path.get_base_dir()
+	if not DirAccess.dir_exists_absolute(folder):
+		return found
+	var stem: String = path.get_file().get_basename()
+	var files: PackedStringArray = DirAccess.get_files_at(folder)
+	files.sort()
+	for file: String in files:
+		if file.get_basename() == stem and file != path.get_file():
+			found.append(folder.path_join(file))
+	return found
+
+
 # A directory the engine steps over, marker file and all.
 func is_stepped_over(path: String) -> bool:
 	return FileAccess.file_exists(path + ".gdignore")

package/build/godot/operations/gdscript_authoring.gd

@@ -404,6 +404,14 @@ static func _modification_problems(modifications: Array, declared: Dictionary) -
 			)
 		if mod_type == "add_constant" and str(fields.get("defaultValue", "")).is_empty():
 			problems.append(which + " is a constant with no defaultValue, and a constant needs a value")
+		if (
+			not str(fields.get("exportHint", "")).is_empty()
+			and fields.has("isExport")
+			and not GdhRead.as_bool(fields["isExport"])
+		):
+			problems.append(
+				which + " has an exportHint and isExport false, and a hint is written only on an export"
+			)
 		if mod_name.is_empty():
 			problems.append(which + " has no name")
 			continue
@@ -527,8 +535,9 @@ func _add_variable(lines: Array[String], mod: Dictionary, placed: Array[Dictiona
 	var var_name: String = str(mod.get("name", ""))
 	var var_type: String = str(mod.get("varType", ""))
 	var default_value: String = str(mod.get("defaultValue", ""))
-	var is_export: bool = GdhRead.as_bool(mod.get("isExport", false))
 	var export_hint: String = str(mod.get("exportHint", ""))
+	# A hint can only mean an export, so a hint given alone writes one.
+	var is_export: bool = GdhRead.as_bool(mod.get("isExport", not export_hint.is_empty()))
 	var is_onready: bool = GdhRead.as_bool(mod.get("isOnready", false))
 
 	var var_line: String = ""

package/build/godot/operations/import_pipeline.gd

@@ -408,7 +408,7 @@ func _import_status_of(resource_path: String, import_file_path: String) -> Dicti
 # Why [param resource_path] has no import file, with what to do about it where anything can be done.
 func _no_sidecar(resource_path: String) -> String:
 	if not FileAccess.file_exists(resource_path):
-		return resource_path + " is not on disk"
+		return GdhFileWalk.new().with_nearest_files(resource_path + " is not on disk", resource_path)
 	var never: String = _never_imported(resource_path)
 	if not never.is_empty():
 		return resource_path + " has no import options: " + never