Widget Class Reference

Detailed Description

Representation of a single GUI widget node in the hierarchical GUI tree.

Fields correspond closely to the JSON schema and remain deliberately generic
to support multiple backend frameworks (PyQt6, Tkinter, Panel).

Semantics:
    type           : Widget category (e.g. "Label", "Button", "Entry").
    label          : Human-readable text displayed near the widget.
    defaultvalue   : Initial value shown before user modification.
    widgetvariable : Internal variable name bound to the widget state.
    action         : Callback name (buttons / run triggers).
    children       : Nested child widgets (recursive tree structure).
    layout         : Layout hint (grid, row, column, absolute, panel grid).
    style          : Optional frontend styling hint (class, css tag, etc.).
    hint           : Tooltip or contextual help text.
    flag           : CLI flag mapped to this widget in the generated GUI.
    file_path      : Single file input path (if applicable).
    files_glob     : Pattern for multi-file selection / dynamic panels.
    height,width   : Pixel dimensions (absolute backends).
    x,y            : Absolute pixel coordinates (Qt / Tk absolute layout mode).
    col_start/...  : Grid coordinates for Panel-based layouts.

Notes:
    • Unknown JSON fields are intentionally dropped upstream to maintain API stability.
    • This object is strictly an in-memory model — not a visual widget instance.