// TQL — Table Query Language emit/apply. Round-trip entre State y Lua text.
// Ver docs/TQL.md.
#pragma once

#include "data_table_logic.h"
#include <string>
#include <vector>

namespace tql {

// Serializa el estado actual a un Lua chunk completo:
//   return { version, display, stages, columns, visualization_settings }
//
// `headers` y `types` describen las cols originales (size = orig_cols).
// Las derived cols se anaden automaticamente desde state.derived.
std::string emit(const data_table::State& state,
                 const std::vector<std::string>& headers,
                 const std::vector<data_table::ColumnType>& types);

// Parsea un Lua chunk TQL y rellena State. Mutates:
//   - stages (clears + reconstruye desde stages[] del TQL; stage 0 = Raw con
//     filters/expressions/sort; stages 1+ con filter/breakout/aggregation/sort)
//   - col_visible / col_order (desde columns[])
//   - color_rules (desde columns[].color_rules)
//   - stages[0].derived[].type (desde columns[].type para nombres derived)
//
// `cells/rows/orig_cols` necesarios para sample auto-detect de tipos en
// expressions (cuando la entry columns omite el type explicito).
bool apply(const std::string& lua_text,
           data_table::State& state,
           const std::vector<std::string>& headers,
           const std::vector<data_table::ColumnType>& types,
           const char* const* cells, int rows, int orig_cols,
           std::string* err);

// Helpers expuestos para tests.
std::string  lua_string_literal(const std::string& s);
std::string  color_to_hex(unsigned int c);
unsigned int hex_to_color(const std::string& s);
data_table::ColumnType column_type_from_string(const std::string& s);

} // namespace tql