class_name EditorCore
extends RefCounted
## Shared, data-native editor core (docs/architecture/editor.md §7.1).
##
## Both the in-game editor UI (`scripts/editor/ui/in_game_editor.gd`) and,
## per the doc's §6.2/§7.3, any future thin dev-plugin surface are meant to
## sit on top of this single object. It never touches `Control` nodes,
## HTTP, or the live scene tree -- it only knows about the chunk model,
## undo/redo, selection, and tools. It owns:
##
##   - `model`     (ChunkEditorModel)     the chunk being edited
##   - `undo_redo` (EditorUndoRedoStack)  command-pattern history
##   - `selection` (SelectionManager)     selected object id
##   - `tools`     (ToolRegistry)         brush / object_place / select /
##                                        erase / transform
##   - `catalog`   (EditorObjectCatalog, optional) palette source consumed
##                                        by `object_place`
##
## Every mutating public method here (`paint_tile`, `erase_tile`,
## `place_object`, `delete_object`, `move_object`, `rotate_object`,
## `scale_object`, `select_object`) is a thin wrapper around `use_tool()` --
## it goes through `ToolRegistry`, never straight at `ChunkEditorModel`.
## This is the seam this task's verification bar cares about: UI code and
## tests mutate the chunk exactly the same way, so a test that calls
## `core.move_object(...)` is exercising the same code path a player's
## drag-in-the-viewport would.
##
## Persisting the edited chunk to the backend is explicitly **out of
## scope** here (a sibling task owns the batch-PUT/conflict-handling save
## path per world_persistence_impl.md) -- `model.encode_binary()` is as far
## as this class goes.

var model: ChunkEditorModel
var undo_redo: EditorUndoRedoStack
var selection: SelectionManager
var tools: ToolRegistry
var catalog: EditorObjectCatalog = null


func _init(p_model: ChunkEditorModel, p_catalog: EditorObjectCatalog = null) -> void:
	model = p_model
	catalog = p_catalog
	undo_redo = EditorUndoRedoStack.new()
	selection = SelectionManager.new()
	tools = ToolRegistry.new()
	tools.register_tool(BrushTool.new())
	tools.register_tool(ObjectPlaceTool.new())
	tools.register_tool(SelectTool.new())
	tools.register_tool(EraseTool.new())
	tools.register_tool(TransformTool.new())
	tools.set_active_tool("select")


## Route an action through the named tool. This is the single choke point
## every mutation (and every convenience wrapper below) goes through.
func use_tool(tool_id: String, args: Dictionary) -> Variant:
	var tool: EditorTool = tools.get_tool(tool_id)
	if tool == null:
		push_error("EditorCore: unknown tool '%s'" % tool_id)
		return null
	return tool.apply(self, args)


# ───────── convenience wrappers (all route through use_tool/ToolRegistry) ─────────

func paint_tile(layer_idx: int, x: int, y: int, tile_id: int, z: int = 0) -> bool:
	return bool(use_tool("brush", {"layer": layer_idx, "x": x, "y": y, "z": z, "tile_id": tile_id}))


func erase_tile(layer_idx: int, x: int, y: int, z: int = 0) -> bool:
	return bool(use_tool("erase", {"layer": layer_idx, "x": x, "y": y, "z": z}))


func place_object(catalog_id: String, position: Vector3,
		rotation: Vector4 = Vector4(0, 0, 0, 1), scale: Vector3 = Vector3.ONE) -> String:
	var result: Variant = use_tool("object_place", {
		"catalog_id": catalog_id,
		"position": position,
		"rotation": rotation,
		"scale": scale,
	})
	return result if result is String else ""


func delete_object(object_id: String) -> bool:
	return bool(use_tool("erase", {"object_id": object_id}))


func move_object(object_id: String, position: Vector3) -> bool:
	return bool(use_tool("transform", {"object_id": object_id, "op": "move", "value": position}))


func rotate_object(object_id: String, rotation: Vector4) -> bool:
	return bool(use_tool("transform", {"object_id": object_id, "op": "rotate", "value": rotation}))


func scale_object(object_id: String, scale: Vector3) -> bool:
	return bool(use_tool("transform", {"object_id": object_id, "op": "scale", "value": scale}))


func select_object(object_id: String) -> bool:
	return bool(use_tool("select", {"object_id": object_id}))


func clear_selection() -> void:
	use_tool("select", {})


func undo() -> bool:
	return undo_redo.undo()


func redo() -> bool:
	return undo_redo.redo()