hyprland keybinds overview sometimes has wrong categories, no description or even misses bindings

[robertwidfen]

I have some bindings for "Windows" written as lua-functions - some did show up correctly by dms ipc keybinds toggle hyprland in the "Window" category, some instead in "Other", some not at all. Some showed the right description - some just function.

The Category Logic did not help me to understand why. It says "Binds are automatically categorized based on their dispatcher" and lists them, but this did not match what I was seeing.

Finally I found out that my issue is fixed by:

1. Using a function that contains "window" in its name fixes the category.
2. Description must be in same line as the hl.bind( to show up correctly.
3. Use one line instead of multiple one makes missing ones to show up. Unfortunately I have to disable format-on-save in my editor for this.

-- instead of 
hl.bind("SUPER + F", hl.dsp.layout("colresize 1.0"), 
        { description = "Toggle maximize column" })
-- use
local function window_maximize_column()
	hl.dispatch(hl.dsp.layout("colresize 1.0"))
end
hl.bind("SUPER + F", window_maximize_column, { description = "Toggle maximize column" })

[purian23]

Thanks for the discussion, feel free to open an issue in the future as two of these were parser bugs and are fixed on master branch recently (4927ef5) and will be shipping in the next release.

• hl.bind(...) calls wrapped across several lines are now joined, so they no longer go missing and a description on a continuation line is picked up. Format-on-save can stay on.

On categories: binds whose action is a Lua function (named or inline) are now categorized from their description, not the function name. A description mentioning e.g. "window", "resize", "move" or "focus" lands in Window, "workspace" in Workspace, and so on. We'll document that in the Category Logic section.