dialog: replace opts.focus with control-level focus field

Move initial focus specification from opts.focus (string name) to a
per-control 'focus' field (integer). This allows specifying both which
control receives focus and the sub-item index within group controls
(button/radio). Deprecated opts.focus now shows a warning message.

🤖 Generated with [Qoder][https://qoder.com]

Author: skywind3000

DIALOG.md

@@ -350,12 +350,18 @@ Hotkeys are globally active when focus is **not** on an input. When an input is
 | `Up` | Move focus backward (vertical intuition); in vertical radio, moves cursor within items first |
 | `Down` | Move focus forward (vertical intuition); in vertical radio, moves cursor within items first |
 
-Initial focus defaults to the first focusable control. Use `opts.focus` to specify initial focus:
+Initial focus defaults to the first focusable control. Use the control-level `focus` field to specify initial focus:
 
 ```vim
-let result = quickui#dialog#open(items, {'focus': 'email'})
+let items = [
+    \ {'type': 'input', 'name': 'email', 'prompt': 'Email:'},
+    \ {'type': 'button', 'items': [' &OK ', ' &Cancel '], 'focus': 1},
+    \ ]
+let result = quickui#dialog#open(items)
 ```
 
+The `focus` field is an integer. For button/radio, it specifies the sub-item index (which button or radio item gets cursor). For other controls, the value is ignored — just having the field means "start focus here".
+
 ## Layout Rules
 
 ### Vertical Stacking

autoload/quickui/dialog.vim

@@ -1771,19 +1771,31 @@ function! quickui#dialog#open(items, ...) abort
 	" -- build focus list --
 	call s:build_focus_list(hwnd)
 
-	" -- initial focus --
+	" -- deprecated opts.focus warning --
 	if has_key(opts, 'focus')
-		let focus_name = opts.focus
-		let fi = 0
-		for entry in hwnd.focus_list
-			if has_key(entry.control, 'name') && entry.control.name ==# focus_name
-				let hwnd.focus_index = fi
-				break
-			endif
-			let fi += 1
-		endfor
+		echohl WarningMsg
+		echomsg 'quickui#dialog: opts.focus is deprecated, use control-level "focus" field instead'
+		echohl None
 	endif
 
+	" -- initial focus from control-level 'focus' field --
+	let fi = 0
+	for entry in hwnd.focus_list
+		let item = a:items[entry.control.index]
+		if has_key(item, 'focus')
+			let hwnd.focus_index = fi
+			let ctrl = entry.control
+			let fv = item.focus
+			if ctrl.type ==# 'button' && fv >= 0 && fv < len(ctrl.parsed)
+				let ctrl.value = fv
+			elseif ctrl.type ==# 'radio' && fv >= 0 && fv < len(ctrl.items)
+				let ctrl.cursor = fv
+			endif
+			break
+		endif
+		let fi += 1
+	endfor
+
 	" -- select all for initially focused input --
 	if len(hwnd.focus_list) > 0
 		let fc = hwnd.focus_list[hwnd.focus_index].control

docs/dialog.md

@@ -216,7 +216,8 @@ quickui#dialog#open(items, opts)
   +-- s:calc_width() -> hwnd.w
   +-- s:calc_layout() -> prompt alignment, alignment inflation width check, line_start, content_h
   +-- s:build_focus_list() -> focus_list
-  +-- opts.focus -> set initial focus
+  +-- control-level 'focus' field -> set initial focus + sub-index
+  +-- deprecated opts.focus -> warning message
   +-- initial focus is input -> s:input_select_all() to select all content
   +-- s:build_keymap() -> keymap (with conflict detection)
   +-- compute hwnd.sep_char (obtain horizontal line character from border style)

test/test_dialog.vim

@@ -28,6 +28,22 @@ function! Test_dialog_basic()
 endfunc
 
 
+"----------------------------------------------------------------------
+" focus test: control-level focus field
+"----------------------------------------------------------------------
+function! Test_dialog_focus()
+	let items = [
+		\ {'type': 'input', 'name': 'user', 'prompt': 'User:',
+		\  'value': 'admin'},
+		\ {'type': 'input', 'name': 'pass', 'prompt': 'Pass:'},
+		\ {'type': 'button', 'name': 'confirm',
+		\  'items': [' &Login ', ' &Cancel '], 'focus': 0},
+		\ ]
+	let result = quickui#dialog#open(items, {'title': 'Focus Test'})
+	echo result
+endfunc
+
+
 "----------------------------------------------------------------------
 " multi button rows test
 "----------------------------------------------------------------------
@@ -141,7 +157,7 @@ function! Test_dialog_project_form()
 	let items = [
 		\ {'type': 'label', 'text': 'Create New Project:'},
 		\ {'type': 'input', 'name': 'project_name', 'prompt': 'Project:',
-		\  'value': 'my-app'},
+		\  'value': 'my-app', 'focus': 0},
 		\ {'type': 'input', 'name': 'email', 'prompt': 'Email:',
 		\  'value': 'dev@example.com'},
 		\ {'type': 'dropdown', 'name': 'language', 'prompt': 'Language:',
@@ -158,8 +174,7 @@ function! Test_dialog_project_form()
 		\  'items': [' &Create ', '  Cancel  ']},
 		\ ]
 	let opts = {'title': 'New Project', 'w': 50,
-		\ 'validator': function('s:validate_project'),
-		\ 'focus': 'project_name'}
+		\ 'validator': function('s:validate_project')}
 	let result = quickui#dialog#open(items, opts)
 	if result.button_index >= 0
 		echo 'Project:  ' . result.project_name