#ifndef PSXRECOMP_WS_UI_GROUP_H
#define PSXRECOMP_WS_UI_GROUP_H

#include <stddef.h>
#include <stdint.h>

#ifdef __cplusplus
extern "C" {
#endif

#define WS_UI_GROUP_JOIN_GAP 24

/* Vertical slack, in scanlines, still counted as "stacked on" rather than
 * "somewhere else on screen". A readout drawn as a label directly above its
 * box leaves a one-pixel seam; the nearest thing that must NOT join is the
 * other end of the screen, ~200 scanlines away. */
#define WS_UI_GROUP_STACK_GAP 4

typedef struct {
    uint32_t key;
    int32_t x;
    int32_t width;
    /* Vertical extent, needed to tell "drawn on top of each other" (one visual
     * element) from "happens to share screen columns" (the top-left lap counter
     * and the bottom-left lap timer). Grouping only ever produces a HORIZONTAL
     * anchor, but deciding the grouping is a 2-D question. */
    int32_t y;
    int32_t height;
    int32_t anchor;
    /* Diagnostic only: index of the union-find representative this item
     * merged into, so an observer can tell "these two share an anchor because
     * they are one run" from "these two happen to land on the same third".
     * Anchor equality cannot distinguish those — there are only three anchor
     * values — and that distinction is the whole question when a HUD element
     * splits apart under the squash. Written by ws_ui_group_assign; never read
     * by the transform path. */
    uint32_t root;
} WsUiGroupItem;

/* Assign one anchor to each complete spatial run. Items with the same
 * texture/row key join when their horizontal intervals touch or are separated
 * by at most WS_UI_GROUP_JOIN_GAP pixels. This is intentionally a whole-frame
 * operation: animated text is coherent on its first frame, not one frame late.
 *
 * The anchor is the run's thirds anchor (left edge, centre, right edge), or
 * with in_place the run's own centre, so it keeps the position the stretched
 * 4:3 layout gives it. in_place is for HUD widgets whose GTE-projected parts
 * (never corrected) must stay registered with their flat quads. */
void ws_ui_group_assign(WsUiGroupItem *items, size_t count,
                        int32_t display_width, int dense_menu, int in_place);

int32_t ws_ui_anchor_for_bounds(int32_t x, int32_t width,
                                int32_t display_width);

#ifdef __cplusplus
}
#endif

#endif