Update docs, add Editor script: Create Druid GUI Script, add simple using widgets example

druid/editor_scripts/create_druid_gui_script.lua

@@ -0,0 +1,144 @@
+local M = {}
+
+local function to_camel_case(snake_str)
+	local components = {}
+	for component in snake_str:gmatch("[^_]+") do
+		table.insert(components, component:sub(1, 1):upper() .. component:sub(2))
+	end
+	return table.concat(components, "")
+end
+
+
+function M.create_druid_gui_script(selection)
+	local gui_filepath = editor.get(selection, "path")
+	local filename = gui_filepath:match("([^/]+)%.gui$")
+	print("Create Druid GUI Script for", gui_filepath)
+
+	local absolute_project_path = editor.external_file_attributes(".").path
+	local widget_resource_path = gui_filepath:gsub("%.gui$", ".gui_script")
+	local new_widget_absolute_path = absolute_project_path .. widget_resource_path
+
+	local widget_name = to_camel_case(filename)
+	local widget_type = filename
+
+	-- Check if file already exists
+	local f = io.open(new_widget_absolute_path, "r")
+	if f then
+		f:close()
+		print("Widget file already exists at " .. new_widget_absolute_path)
+		print("Creation aborted to prevent overwriting")
+		return
+	end
+
+	-- Get template path from preferences
+	local template_path = editor.prefs.get("druid.gui_script_template_path")
+
+	-- Get template content using the path from preferences
+	local template_content = editor.get(template_path, "text")
+	if not template_content then
+		print("Error: Could not load template from", template_path)
+		print("Check the template path in [Druid] Settings")
+		return
+	end
+
+	-- Replace template variables
+	template_content = template_content:gsub("{COMPONENT_NAME}", widget_name)
+	template_content = template_content:gsub("{COMPONENT_TYPE}", widget_type)
+
+	-- Write file
+	local file, err = io.open(new_widget_absolute_path, "w")
+	if not file then
+		print("Error creating widget file:", err)
+		return
+	end
+	file:write(template_content)
+	file:close()
+
+	print("Widget created at " .. widget_resource_path)
+
+	M.link_gui_script(selection, widget_resource_path)
+end
+
+
+---Links a GUI script to a GUI file by updating the script property
+---@param selection string The GUI resource to modify
+---@param widget_resource_path string The path to the GUI script to link
+function M.link_gui_script(selection, widget_resource_path)
+	local defold_parser = require("druid.editor_scripts.defold_parser.defold_parser")
+	local system = require("druid.editor_scripts.defold_parser.system.system")
+
+	local gui_filepath = editor.get(selection, "path")
+	print("Linking GUI script to", gui_filepath)
+
+	-- Get the absolute path to the file
+	local absolute_project_path = editor.external_file_attributes(".").path
+	if not absolute_project_path:match("[\\/]$") then
+		absolute_project_path = absolute_project_path .. "/"
+	end
+	local clean_gui_path = gui_filepath
+	if clean_gui_path:sub(1, 1) == "/" then
+		clean_gui_path = clean_gui_path:sub(2)
+	end
+	local gui_absolute_path = absolute_project_path .. clean_gui_path
+
+	-- Create a backup
+	local backup_path = gui_absolute_path .. ".backup"
+	print("Creating backup at:", backup_path)
+
+	-- Read and write backup
+	local content, err_read = system.read_file(gui_absolute_path)
+	if not content then
+		print("Error reading original file for backup:", err_read)
+		return
+	end
+
+	local success, err_write = system.write_file(backup_path, content)
+	if not success then
+		print("Error creating backup file:", err_write)
+		return
+	end
+
+	-- Parse the GUI file
+	print("Parsing GUI file...")
+	local gui_data = defold_parser.load_from_file(gui_absolute_path)
+	if not gui_data then
+		print("Error: Failed to parse GUI file")
+		return
+	end
+
+	-- Update the script property
+	print("Setting script property to:", widget_resource_path)
+	gui_data.script = widget_resource_path
+
+	-- Write the updated GUI file
+	print("Writing updated GUI file...")
+	local save_success = defold_parser.save_to_file(gui_absolute_path, gui_data)
+
+	if not save_success then
+		print("Error: Failed to save GUI file")
+		print("Attempting to restore from backup...")
+
+		-- Restore from backup on failure
+		local backup_content, backup_err_read = system.read_file(backup_path)
+		if not backup_content then
+			print("Error reading backup file:", backup_err_read)
+			return
+		end
+
+		local restore_success, restore_err_write = system.write_file(gui_absolute_path, backup_content)
+		if not restore_success then
+			print("Critical: Failed to restore from backup:", restore_err_write)
+			return
+		end
+
+		print("Restored successfully from backup")
+		return
+	end
+
+	-- Remove backup on success
+	os.remove(backup_path)
+	print("Successfully linked GUI script to:", gui_filepath)
+end
+
+
+return M

druid/editor_scripts/druid.editor_script

@@ -1,11 +1,12 @@
 local assign_layers = require("druid.editor_scripts.assign_layers")
 local create_druid_widget = require("druid.editor_scripts.create_druid_widget")
+local create_druid_gui_script = require("druid.editor_scripts.create_druid_gui_script")
 local druid_settings = require("druid.editor_scripts.druid_settings")
 
 local M = {}
 
 local DEFAULT_WIDGET_TEMPLATE_PATH = "/druid/templates/widget_full.lua.template"
-
+local DEFAULT_GUI_SCRIPT_TEMPLATE_PATH = "/druid/templates/druid.gui_script.template"
 
 ---Define preferences schema
 function M.get_prefs_schema()
@@ -13,6 +14,10 @@ function M.get_prefs_schema()
 		["druid.widget_template_path"] = editor.prefs.schema.string({
 			default = DEFAULT_WIDGET_TEMPLATE_PATH,
 			scope = editor.prefs.SCOPE.PROJECT
+		}),
+		["druid.gui_script_template_path"] = editor.prefs.schema.string({
+			default = DEFAULT_GUI_SCRIPT_TEMPLATE_PATH,
+			scope = editor.prefs.SCOPE.PROJECT
 		})
 	}
 end
@@ -47,6 +52,19 @@ function M.get_commands()
 			end
 		},
 
+		{
+			label = "[Druid] Create Druid GUI Script",
+			locations = { "Edit", "Assets" },
+			query = { selection = {type = "resource", cardinality = "one"} },
+			active = function(opts)
+				local path = editor.get(opts.selection, "path")
+				return path:match("%.gui$") ~= nil
+			end,
+			run = function(opts)
+				return create_druid_gui_script.create_druid_gui_script(opts.selection)
+			end
+		},
+
 		{
 			label = "[Druid] Settings",
 			locations = { "Edit" },

druid/editor_scripts/druid_settings.lua

@@ -6,8 +6,6 @@ function M.open_settings()
 
 	local dialog_component = editor.ui.component(function(props)
 		local template_path, set_template_path = editor.ui.use_state(editor.prefs.get("druid.widget_template_path"))
-
-		-- Check if the template path is valid
 		local path_valid = editor.ui.use_memo(function(path)
 			-- Use resource_exists to check if the resource exists
 			local exists = false
@@ -19,6 +17,16 @@ function M.open_settings()
 			return exists
 		end, template_path)
 
+		local gui_script_template_path, set_gui_script_template_path = editor.ui.use_state(editor.prefs.get("druid.gui_script_template_path"))
+		local gui_script_template_path_valid = editor.ui.use_memo(function(path)
+			local exists = false
+			pcall(function()
+				local content = editor.get(path, "text")
+				exists = content ~= nil
+			end)
+			return exists
+		end, gui_script_template_path)
+
 		return editor.ui.dialog({
 			title = "Druid Settings",
 			content = editor.ui.vertical({
@@ -39,6 +47,20 @@ function M.open_settings()
 						color = editor.ui.COLOR.WARNING
 					}) or nil,
 
+					editor.ui.label({
+						text = "GUI Script Template Path:"
+					}),
+					editor.ui.resource_field({
+						value = gui_script_template_path,
+						on_value_changed = set_gui_script_template_path,
+						extensions = {"lua", "template"},
+						padding = editor.ui.PADDING.SMALL
+					}),
+					not gui_script_template_path_valid and editor.ui.label({
+						text = "Warning: Path not found!",
+						color = editor.ui.COLOR.WARNING
+					}) or nil,
+
 					-- Links section title
 					editor.ui.label({
 						text = "Documentation:",