4coder/4coder_ui_helper.cpp

/*
 * Helpers for ui data structures.
 */

// TOP

typedef u32 View_Get_UI_Flags;
enum{
    ViewGetUIFlag_KeepDataAsIs = 0,
    ViewGetUIFlag_ClearData = 1,
};

static b32
view_get_ui_data(Application_Links *app, View_ID view_id, View_Get_UI_Flags flags, UI_Data **ui_data_out, Arena **ui_arena_out){
    b32 result = false;
    Managed_Scope scope = view_get_managed_scope(app, view_id);
    if (scope != 0){
        Managed_Object *ui_data_object_ptr = scope_attachment(app, scope, view_ui_data, Managed_Object);
        Managed_Object ui_data_object = *ui_data_object_ptr;
        if (ui_data_object == 0){
            Managed_Object new_ui_data_object = alloc_managed_memory_in_scope(app, scope, sizeof(UI_Storage), 1);
            
            Base_Allocator *allocator = managed_scope_allocator(app, scope);
            Arena arena_temp = make_arena(allocator, KB(8));
            Arena *arena = push_array(&arena_temp, Arena, 1);
            block_copy_struct(arena, &arena_temp);
            
            UI_Data *ui_data = push_array(arena, UI_Data, 1);
            UI_Storage storage = {};
            storage.data = ui_data;
            storage.arena = arena;
            storage.temp = begin_temp(arena);
            if (managed_object_store_data(app, new_ui_data_object, 0, 1, &storage)){
                *ui_data_object_ptr = new_ui_data_object;
                ui_data_object = new_ui_data_object;
            }
            
        }
        if (ui_data_object != 0){
            UI_Storage storage = {};
            if (managed_object_load_data(app, ui_data_object, 0, 1, &storage)){
                *ui_data_out = storage.data;
                *ui_arena_out = storage.arena;
                if ((flags & ViewGetUIFlag_ClearData) != 0){
                    end_temp(storage.temp);
                }
                result = true;
            }
        }
    }
    return(result);
}

static b32
view_clear_ui_data(Application_Links *app, View_ID view_id){
    b32 result = false;
    Managed_Scope scope = view_get_managed_scope(app, view_id);
    if (scope != 0){
        Managed_Object *ui_data_object_ptr = scope_attachment(app, scope, view_ui_data, Managed_Object);
        Managed_Object ui_data_object = *ui_data_object_ptr;
        if (ui_data_object != 0){
            UI_Storage storage = {};
            if (managed_object_load_data(app, ui_data_object, 0, 1, &storage)){
                Arena arena_temp = *storage.arena;
                linalloc_clear(&arena_temp);
                managed_object_free(app, ui_data_object);
                *ui_data_object_ptr = 0;
                result = true;
            }
        }
    }
    return(result);
}

////////////////////////////////

static UI_Item*
ui_list_add_item(Arena *arena, UI_List *list, UI_Item item){
    UI_Item *node = push_array(arena, UI_Item, 1);
    block_copy_struct(node, &item);
    zdll_push_back(list->first, list->last, node);
    list->count += 1;
    return(node);
}

static i32_Rect
ui__rect_union(i32_Rect a, i32_Rect b){
    if (b.x1 > b.x0 && b.y1 > b.y0){
        if (a.x0 > b.x0){
            a.x0 = b.x0;
        }
        if (a.x1 < b.x1){
            a.x1 = b.x1;
        }
        if (a.y0 > b.y0){
            a.y0 = b.y0;
        }
        if (a.y1 < b.y1){
            a.y1 = b.y1;
        }
    }
    return(a);
}

static void
ui_data_compute_bounding_boxes(UI_Data *ui_data){
    i32_Rect neg_inf_rect = {};
    neg_inf_rect.x0 = INT32_MAX;
    neg_inf_rect.y0 = INT32_MAX;
    neg_inf_rect.x1 = INT32_MIN;
    neg_inf_rect.y1 = INT32_MIN;
    for (u32 i = 0; i < UICoordinates_COUNT; ++i){
        ui_data->bounding_box[i] = neg_inf_rect;
    }
    for (UI_Item *item = ui_data->list.first;
         item != 0;
         item = item->next){
        if (item->coordinates >= UICoordinates_COUNT){
            item->coordinates = UICoordinates_ViewSpace;
        }
        Rect_i32 *box = &ui_data->bounding_box[item->coordinates];
        *box = ui__rect_union(*box, item->rect_outer);
    }
}

static void
ui_control_set_top(UI_Data *data, i32 top_y){
    data->bounding_box[UICoordinates_ViewSpace].y0 = top_y;
}

static void
ui_control_set_bottom(UI_Data *data, i32 bottom_y){
    data->bounding_box[UICoordinates_ViewSpace].y1 = bottom_y;
}

static UI_Item*
ui_control_get_mouse_hit(UI_Data *data, Vec2_f32 view_p, Vec2_f32 panel_p){
    UI_Item *result = 0;
    for (UI_Item *item = data->list.first; item != 0 && result == 0; item = item->next){
        Rect_f32 r = Rf32(item->rect_outer);
        switch (item->coordinates){
            case UICoordinates_ViewSpace:
            {
                if (rect_contains_point(r, view_p)){
                    result = item;
                }
            }break;
            case UICoordinates_PanelSpace:
            {
                if (rect_contains_point(r, panel_p)){
                    result = item;
                }
            }break;
        }
    }
    return(result);
}

////////////////////////////////

static void
view_set_vertical_focus_basic(Application_Links *app, View_ID view, f32 y_top, f32 y_bot){
    Rect_f32 buffer_region = view_get_buffer_region(app, view);
    Basic_Scroll scroll = view_get_basic_scroll(app, view);
    f32 view_height = rect_height(buffer_region);
    Interval_f32 view_y = If32(scroll.target.y, scroll.target.y + view_height);
    Interval_f32 acceptable_y = If32(lerp(view_y.min, 0.10f, view_y.max),
                                     lerp(view_y.min, 0.90f, view_y.max)); 
    f32 acceptable_height = range_size(acceptable_y);
    f32 skirt_height = acceptable_y.min - view_y.min;
    
    f32 height = y_bot - y_top;
    if (height > acceptable_height){
        scroll.target.y = y_top - skirt_height;
        view_set_basic_scroll(app, view, scroll);
    }
    else{
        if (y_top < acceptable_y.min){
            scroll.target.y = y_top - skirt_height;
            view_set_basic_scroll(app, view, scroll);
        }
        else if (y_bot > acceptable_y.max){
            scroll.target.y = y_bot + skirt_height - view_height;
            view_set_basic_scroll(app, view, scroll);
        }
    }
}

static Vec2_f32
panel_space_from_screen_space(Vec2_f32 p, Vec2_f32 file_region_p0){
    return(p - file_region_p0);
}

static Vec2_f32
get_mouse_position_in_panel_space(Mouse_State mouse, Vec2_f32 file_region_p0){
    return(panel_space_from_screen_space(V2f32(mouse.p), file_region_p0));
}

static Vec2_f32
get_mouse_position_in_panel_space(Application_Links *app, Vec2_f32 file_region_p0){
    return(get_mouse_position_in_panel_space(get_mouse_state(app), file_region_p0));
}

////////////////////////////////

// TODO(allen): VIEW_16_LIMIT
Lister_State global_lister_state_[16] = {};
Lister_State *global_lister_state = global_lister_state_ - 1;

static Lister_State*
view_get_lister_state(View_ID view){
    return(&global_lister_state[view]);
}

static i32
lister_standard_arena_size_round_up(i32 arena_size){
    if (arena_size < (64 << 10)){
        arena_size = (64 << 10);
    }
    else{
        arena_size += (4 << 10) - 1;
        arena_size -= arena_size%(4 << 10);
    }
    return(arena_size);
}

static void
init_lister_state(Application_Links *app, Lister_State *state, Heap *heap){
    state->initialized = true;
    state->hot_user_data = 0;
    state->item_index = 0;
    state->set_view_vertical_focus_to_item = false;
    state->item_count_after_filter = 0;
}

UI_QUIT_FUNCTION(lister_quit_function){
    Lister_State *state = view_get_lister_state(view);
    state->initialized = false;
    view_clear_ui_data(app, view);
}

static UI_Item
lister_get_clicked_item(Application_Links *app, View_ID view_id){
    UI_Item result = {};
    UI_Data *ui_data = 0;
    Arena *ui_arena = 0;
    if (view_get_ui_data(app, view_id, ViewGetUIFlag_KeepDataAsIs, &ui_data, &ui_arena)){
        Mouse_State mouse = get_mouse_state(app);
        Rect_f32 region = view_get_buffer_region(app, view_id);
        Vec2_f32 m_panel_space = get_mouse_position_in_panel_space(mouse, region.p0);
        Basic_Scroll scroll = view_get_basic_scroll(app, view_id);
        Vec2_f32 m_view_space = m_panel_space + scroll.position;
        UI_Item *clicked = ui_control_get_mouse_hit(ui_data, m_view_space, m_panel_space);
        if (clicked != 0){
            result = *clicked;
        }
    }
    return(result);
}

static f32
lister_get_text_field_height(f32 line_height){
    return(line_height);
}

static f32
lister_get_block_height(f32 line_height, b32 is_theme_list){
    f32 block_height = 0;
    if (is_theme_list){
        block_height = line_height*3 + 6;
    }
    else{
        block_height = line_height*2;
    }
    return(block_height);
}

static void
lister_update_ui(Application_Links *app, View_ID view, Lister_State *state){
    b32 is_theme_list = state->lister.data.theme_list;
    
    Rect_f32 screen_rect = view_get_screen_rect(app, view);
    
    Face_ID face_id = get_face_id(app, 0);
    Face_Metrics metrics = get_face_metrics(app, face_id);
    
    Basic_Scroll scroll = view_get_basic_scroll(app, view);
    
    f32 x0 = 0;
    f32 x1 = (rect_width(screen_rect));
    f32 line_height = metrics.line_height;
    f32 block_height = lister_get_block_height(line_height, is_theme_list);
    f32 text_field_height = lister_get_text_field_height(metrics.line_height);
    
    Scratch_Block scratch(app, Scratch_Share);
    
    Rect_f32 region = view_get_buffer_region(app, view);
    Vec2_f32 view_m = get_mouse_position_in_panel_space(app, region.p0);
    view_m += scroll.position;
    
    f32 y_pos = text_field_height;
    
    state->raw_item_index = -1;
    
    i32 node_count = state->lister.data.options.count;
    Lister_Node_Ptr_Array exact_matches = {};
    exact_matches.node_ptrs = push_array(scratch, Lister_Node*, 1);
    Lister_Node_Ptr_Array before_extension_matches = {};
    before_extension_matches.node_ptrs = push_array(scratch, Lister_Node*, node_count);
    Lister_Node_Ptr_Array substring_matches = {};
    substring_matches.node_ptrs = push_array(scratch, Lister_Node*, node_count);
    
    {
        Temp_Memory temp = begin_temp(scratch);
        String_Const_u8 key = state->lister.data.key_string.string;
        key = push_string_copy(scratch, key);
        string_mod_replace_character(key, '_', '*');
        string_mod_replace_character(key, ' ', '*');
        
        List_String_Const_u8 absolutes = {};
        string_list_push(scratch, &absolutes, string_u8_litexpr(""));
        List_String_Const_u8 splits = string_split(scratch, key, (u8*)"*", 1);
        b32 has_wildcard = (splits.node_count > 1);
        string_list_push(&absolutes, &splits);
        string_list_push(scratch, &absolutes, string_u8_litexpr(""));
        
        for (Lister_Node *node = state->lister.data.options.first;
             node != 0;
             node = node->next){
            String_Const_u8 node_string = node->string;
            
            if (key.size == 0 || string_wildcard_match_insensitive(absolutes, node_string)){
                if (string_match_insensitive(node_string, key) && exact_matches.count == 0){
                    exact_matches.node_ptrs[exact_matches.count++] = node;
                }
                else if (!has_wildcard &&
                         string_match_insensitive(string_prefix(node_string, key.size), key) &&
                         node->string.size > key.size &&
                         node->string.str[key.size] == '.'){
                    before_extension_matches.node_ptrs[before_extension_matches.count++] = node;
                }
                else{
                    substring_matches.node_ptrs[substring_matches.count++] = node;
                }
            }
        }
        
        end_temp(temp);
    }
    
    Lister_Node_Ptr_Array node_ptr_arrays[] = {
        exact_matches,
        before_extension_matches,
        substring_matches,
    };
    
    UI_Data *ui_data = 0;
    Arena *ui_arena = 0;
    if (view_get_ui_data(app, view, ViewGetUIFlag_ClearData, &ui_data, &ui_arena)){
        block_zero_struct(ui_data);
        
        UI_Item *highlighted_item = 0;
        UI_Item *hot_item = 0;
        UI_Item *hovered_item = 0;
        i32 item_index_counter = 0;
        for (i32 array_index = 0; array_index < ArrayCount(node_ptr_arrays); array_index += 1){
            Lister_Node_Ptr_Array node_ptr_array = node_ptr_arrays[array_index];
            for (i32 node_index = 0; node_index < node_ptr_array.count; node_index += 1){
                Lister_Node *node = node_ptr_array.node_ptrs[node_index];
                
                Rect_f32 item_rect = Rf32(x0, y_pos, x1, y_pos + block_height);
                y_pos = item_rect.y1;
                
                UI_Item item = {};
                item.activation_level = UIActivation_None;
                item.coordinates = UICoordinates_ViewSpace;
                item.rect_outer = Ri32(item_rect);
                item.inner_margin = 3;
                
                if (!is_theme_list){
                    Fancy_String_List list = {};
                    push_fancy_string (ui_arena, &list, fancy_id(Stag_Default), node->string);
                    push_fancy_stringf(ui_arena, &list, fancy_id(Stag_Default), " ");
                    push_fancy_string (ui_arena, &list, fancy_id(Stag_Pop2   ), node->status);
                    item.lines[0] = list;
                    item.line_count = 1;
                }
                else{
                    //i32 style_index = node->index;
                    
                    String_Const_u8 name = string_u8_litexpr("name");
                    item.lines[0] = fancy_string_list_single(push_fancy_string(ui_arena, fancy_id(Stag_Default), name));
                    
                    Fancy_String_List list = {};
                    push_fancy_stringf(ui_arena, &list, fancy_id(Stag_Keyword     ), "if ");
                    push_fancy_stringf(ui_arena, &list, fancy_id(Stag_Default     ), "(x < ");
                    push_fancy_stringf(ui_arena, &list, fancy_id(Stag_Int_Constant), "0");
                    push_fancy_stringf(ui_arena, &list, fancy_id(Stag_Default     ), ") { x = ");
                    push_fancy_stringf(ui_arena, &list, fancy_id(Stag_Int_Constant), "0");
                    push_fancy_stringf(ui_arena, &list, fancy_id(Stag_Default     ), "; } ");
                    push_fancy_stringf(ui_arena, &list, fancy_id(Stag_Comment     ), "// comment");
                    item.lines[1] = list;
                    
                    item.line_count = 2;
                }
                
                item.user_data = node->user_data;
                
                UI_Item *item_ptr = ui_list_add_item(ui_arena, &ui_data->list, item);
                if (rect_contains_point(item_rect, view_m)){
                    hovered_item = item_ptr;
                }
                if (state->item_index == item_index_counter){
                    highlighted_item = item_ptr;
                    state->raw_item_index = node->raw_index;
                }
                item_index_counter += 1;
                if (node->user_data == state->hot_user_data && hot_item != 0){
                    hot_item = item_ptr;
                }
            }
        }
        state->item_count_after_filter = item_index_counter;
        
        if (hovered_item != 0){
            hovered_item->activation_level = UIActivation_Hover;
        }
        if (hot_item != 0){
            if (hot_item == hovered_item){
                hot_item->activation_level = UIActivation_Active;
            }
            else{
                hot_item->activation_level = UIActivation_Hover;
            }
        }
        if (highlighted_item != 0){
            highlighted_item->activation_level = UIActivation_Active;
        }
        
        if (state->set_view_vertical_focus_to_item){
            if (highlighted_item != 0){
                view_set_vertical_focus_basic(app, view,
                                              (f32)highlighted_item->rect_outer.y0,
                                              (f32)highlighted_item->rect_outer.y1);
            }
            state->set_view_vertical_focus_to_item = false;
        }
        
        {
            // TODO(allen): switch to float
            i32_Rect item_rect = {};
            item_rect.x0 = (i32)x0;
            item_rect.y0 = 0;
            item_rect.x1 = (i32)x1;
            item_rect.y1 = item_rect.y0 + (i32)text_field_height;
            y_pos = (f32)item_rect.y1;
            
            UI_Item item = {};
            item.activation_level = UIActivation_Active;
            item.coordinates = UICoordinates_PanelSpace;
            item.rect_outer = item_rect;
            item.inner_margin = 0;
            {
                Fancy_String_List list = {};
                push_fancy_string (ui_arena, &list, fancy_id(Stag_Pop1   ), state->lister.data.query.string);
                push_fancy_stringf(ui_arena, &list, fancy_id(Stag_Pop1   ), " ");
                push_fancy_string (ui_arena, &list, fancy_id(Stag_Default), state->lister.data.text_field.string);
                item.lines[0] = list;
                item.line_count = 1;
            }
            item.user_data = 0;
            
            
            ui_list_add_item(ui_arena, &ui_data->list, item);
        }
        
        ui_data_compute_bounding_boxes(ui_data);
        
        // TODO(allen): what to do with control now?
        //UI_Control control = ui_list_to_ui_control(scratch, &list);
        view_set_quit_ui_handler(app, view, lister_quit_function);
    }
}

static Lister_Prealloced_String
lister_prealloced(String_Const_u8 string){
    Lister_Prealloced_String result = {};
    result.string = string;
    return(result);
}

static void
lister_first_init(Application_Links *app, Lister *lister, void *user_data, i32 user_data_size){
	if (lister->arena == 0) {
		lister->arena = reserve_arena(app, KB(16));
	}
	else{
		linalloc_clear(lister->arena);
	}
	block_zero_struct(&lister->data);
    lister->data.query = Su8(lister->data.query_space, 0, sizeof(lister->data.query_space));
    lister->data.text_field = Su8(lister->data.text_field_space, 0, sizeof(lister->data.text_field_space));
    lister->data.key_string = Su8(lister->data.key_string_space, 0, sizeof(lister->data.key_string_space));
    lister->data.user_data = push_array(lister->arena, char, user_data_size);
    lister->data.user_data_size = user_data_size;
    if (user_data != 0){
        block_copy(lister->data.user_data, user_data, user_data_size);
    }
}

static void
lister_begin_new_item_set(Application_Links *app, Lister *lister){
    linalloc_clear(lister->arena);
    block_zero_struct(&lister->data.options);
}

static void*
lister_add_item(Lister *lister, Lister_Prealloced_String string, Lister_Prealloced_String status,
                void *user_data, umem extra_space){
    void *base_memory = push_array(lister->arena, u8, sizeof(Lister_Node) + extra_space);
    Lister_Node *node = (Lister_Node*)base_memory;
    node->string = string.string;
    node->status = status.string;
    node->user_data = user_data;
    node->raw_index = lister->data.options.count;
    zdll_push_back(lister->data.options.first, lister->data.options.last, node);
    lister->data.options.count += 1;
    void *result = (node + 1);
    return(result);
}

static void*
lister_add_item(Lister *lister, Lister_Prealloced_String string, String_Const_u8 status,
                void *user_data, umem  extra_space){
    return(lister_add_item(lister, string, lister_prealloced(push_string_copy(lister->arena, status)),
                           user_data, extra_space));
}

static void*
lister_add_item(Lister *lister, String_Const_u8 string, Lister_Prealloced_String status,
                void *user_data, umem extra_space){
    return(lister_add_item(lister, lister_prealloced(push_string_copy(lister->arena, string)), status,
                           user_data, extra_space));
}

static void*
lister_add_item(Lister *lister, String_Const_u8 string, String_Const_u8 status, void *user_data, umem extra_space){
    return(lister_add_item(lister,
                           lister_prealloced(push_string_copy(lister->arena, string)),
                           lister_prealloced(push_string_copy(lister->arena, status)),
                           user_data, extra_space));
}

static void*
lister_add_theme_item(Lister *lister,
                      Lister_Prealloced_String string, i32 index,
                      void *user_data, i32 extra_space){
    Lister_Node *node = push_array(lister->arena, Lister_Node, 1);
    node->string = string.string;
    node->index = index;
    node->user_data = user_data;
    node->raw_index = lister->data.options.count;
    zdll_push_back(lister->data.options.first, lister->data.options.last, node);
    lister->data.options.count += 1;
    void *result = push_array(lister->arena, char, extra_space);
    push_align(lister->arena, 8);
    return(result);
}

static void*
lister_add_theme_item(Lister *lister, String_Const_u8 string, i32 index,
                      void *user_data, i32 extra_space){
    return(lister_add_theme_item(lister, lister_prealloced(push_string_copy(lister->arena, string)), index,
                                 user_data, extra_space));
}

static void*
lister_get_user_data(Lister_Data *lister_data, i32 index){
    void *result = 0;
    if (0 <= index && index < lister_data->options.count){
        i32 counter = 0;
        for (Lister_Node *node = lister_data->options.first;
             node != 0;
             node = node->next, counter += 1){
            if (counter == index){
                result = node->user_data;
                break;
            }
        }
    }
    return(result);
}

static void
lister_call_refresh_handler(Application_Links *app, Lister *lister){
    if (lister->data.handlers.refresh != 0){
        lister->data.handlers.refresh(app, lister);
    }
}

static void
lister_default(Application_Links *app, Heap *heap, View_ID view, Lister_State *state, Lister_Activation_Code code){
    switch (code){
        case ListerActivation_Finished:
        {
            view_end_ui_mode(app, view);
            state->initialized = false;
            linalloc_clear(state->lister.arena);
        }break;
        
        case ListerActivation_Continue:
        {
            view_begin_ui_mode(app, view);
        }break;
        
        case ListerActivation_ContinueAndRefresh:
        {
            view_begin_ui_mode(app, view);
            state->item_index = 0;
            lister_call_refresh_handler(app, &state->lister);
            lister_update_ui(app, view, state);
        }break;
    }
}

static void
lister_call_activate_handler(Application_Links *app, Heap *heap, View_ID view, Lister_State *state, void *user_data, b32 activated_by_mouse){
    Lister_Data *lister = &state->lister.data;
    if (lister->handlers.activate != 0){
        lister->handlers.activate(app, heap, view, state, lister->text_field.string, user_data, activated_by_mouse);
    }
    else{
        lister_default(app, heap, view, state, ListerActivation_Finished);
    }
}

static void
lister_set_string(String_Const_u8 string, String_u8 *target){
    target->size = 0;
    string_append(target, string);
}
static void
lister_append_string(String_Const_u8 string, String_u8 *target){
    string_append(target, string);
}

static void
lister_set_query(Lister_Data *lister, String_Const_u8 string){
    lister_set_string(string, &lister->query);
}
static void
lister_set_query(Lister_Data *lister, char *string){
    lister_set_string(SCu8(string), &lister->query);
}
static void
lister_set_text_field(Lister_Data *lister, String_Const_u8 string){
    lister_set_string(string, &lister->text_field);
}
static void
lister_set_text_field(Lister_Data *lister, char *string){
    lister_set_string(SCu8(string), &lister->text_field);
}
static void
lister_set_key(Lister_Data *lister, String_Const_u8 string){
    lister_set_string(string, &lister->key_string);
}
static void
lister_set_key(Lister_Data *lister, char *string){
    lister_set_string(SCu8(string), &lister->key_string);
}

static void
lister_set_query(Lister *lister, String_Const_u8 string){
    lister_set_query(&lister->data, string);
}
static void
lister_set_query(Lister *lister, char *string){
    lister_set_query(&lister->data, string);
}
static void
lister_set_text_field(Lister *lister, String_Const_u8 string){
    lister_set_text_field(&lister->data, string);
}
static void
lister_set_text_field(Lister *lister, char *string){
    lister_set_text_field(&lister->data, string);
}
static void
lister_set_key(Lister *lister, String_Const_u8 string){
    lister_set_key(&lister->data, string);
}
static void
lister_set_key(Lister *lister, char *string){
    lister_set_key(&lister->data, string);
}

static void
lister_append_query(Lister_Data *lister, String_Const_u8 string){
    lister_append_string(string, &lister->query);
}
static void
lister_append_query(Lister_Data *lister, char *string){
    lister_append_string(SCu8(string), &lister->query);
}
static void
lister_append_text_field(Lister_Data *lister, String_Const_u8 string){
    lister_append_string(string, &lister->text_field);
}
static void
lister_append_text_field(Lister_Data *lister, char *string){
    lister_append_string(SCu8(string), &lister->text_field);
}
static void
lister_append_key(Lister_Data *lister, String_Const_u8 string){
    lister_append_string(string, &lister->key_string);
}
static void
lister_append_key(Lister_Data *lister, char *string){
    lister_append_string(SCu8(string), &lister->key_string);
}

static void
lister_append_query(Lister *lister, String_Const_u8 string){
    lister_append_query(&lister->data, string);
}
static void
lister_append_query(Lister *lister, char *string){
    lister_append_query(&lister->data, string);
}
static void
lister_append_text_field(Lister *lister, String_Const_u8 string){
    lister_append_text_field(&lister->data, string);
}
static void
lister_append_text_field(Lister *lister, char *string){
    lister_append_text_field(&lister->data, string);
}
static void
lister_append_key(Lister *lister, String_Const_u8 string){
    lister_append_key(&lister->data, string);
}
static void
lister_append_key(Lister *lister, char *string){
    lister_append_key(&lister->data, string);
}

// BOTTOM