Skip to content

Conversation

@v-ein
Copy link
Collaborator

@v-ein v-ein commented Jan 5, 2026


name: Pull Request
about: Create a pull request to help us improve
title: Better Item Registry tool
assignees: ''


Description:
This PR improves the existing Item Registry tool in a number of ways:

  • Lets you search the item in the GUI by entering its UUID or tag, or simply by clicking on it ("Pick...").
    • The former is convenient when you get an exception that mentions item UUID or if you find out UUID while debugging and want to check item properties at the time.
    • The latter does not work within some containers - it's not easy to detect the hovered/clicked item within the GUI at the time the Item Registry tool is being rendered. I hope to improve this in future.
  • Also lets you find the currently focused item.
  • Shows item rect in the GUI when the item is hovered in the tree. Might not work properly for some items - e.g. table columns will get a weird rect; nesting item in a container sometimes might also affect this, but in general it works in most cases. The rect is red for items that don't support rectMin and rectMax (often containers like windows) and yellow for regular items.
  • Displays the number of top-level items (e.g. windows, themes) in every category.
  • Highlights item labels and tags in the tree with a different color - easier to see the "actionable" and important items (as opposed to those used purely for layout purposes).
  • For themes, item registries, and fonts, shows the number of items they're bound to. Also makes orphaned (non-bound) items dimmed in the tree.
  • Window size has been increased, and vertical separator between left/right panes is now movable.
  • Item properties in the left pane have been re-grouped, and extra properties have been added, including info about bindings (themes / item registries / fonts) and some other stuff.
    • You can even dynamically edit colors and styles within your own theme.
  • A number of small UI improvements like double-clicking items in the widget tree, expanding the tree to selected item, less visual clutter in the tree, etc.

Here's a comparison against the old version, made at some moment during development (i.e. it's not the final version of the tool); the window title shows whether it's new or old version:

compare-item-registry-window

And here's what the final version looks like:

item-registry-tool

Another small change that this PR brings is that show_tool brings the tool window to front (for all tool windows) - this is useful when you're trying to show a tool that's already visible but buried under other windows.

Concerning Areas:
None.

@v-ein v-ein requested a review from hoffstadt January 5, 2026 18:34
@hoffstadt hoffstadt merged commit 406fd1b into hoffstadt:master Jan 9, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants