util.lua

require 'gimmick.lib.fp'

---@generic T
---@param a T
---@param b T
---@param x number
---@return T
function mix(a, b, x)
  return a + (b - a) * x
end

---@param n number
---@return number
function round(n)
  return math.floor(n + 0.5)
end

---@param x number
---@return number
function sign(x)
  if x < 0 then return -1 end
  if x > 0 then return 1 end
  return 0
end

---@param x number
---@return number
function signStrict(x)
  if x < 0 then return -1 end
  return 1
end

---@param x number
---@param a number
---@param b number
---@return number
function clamp(x, a, b)
  return math.max(math.min(x, math.max(a, b)), math.min(a, b))
end

---@param o any
---@param r number?
---@return string
function fullDump(o, r, forceFull)
  if type(o) == 'table' and (not r or r > 0) then
    local s = '{'
    local first = true
    for k, v in pairs(o) do
      if not first then
        s = s .. ', '
      end
      local nr = nil
      if r then
        nr = r - 1
      end
      if type(k) ~= 'number' or forceFull then
        s = s .. tostring(k) .. ' = ' .. fullDump(v, nr)
      else
        s = s .. fullDump(v, nr)
      end
      first = false
    end
    return s .. '}'
  elseif type(o) == 'string' then
    return '"' .. o .. '"'
  else
    return tostring(o)
  end
end

---@param x number
---@return number
function pingpong(x)
  return math.abs(x % 2 - 1)
end

---@param x number
---@param snap number
---@return number
function snap(x, snap)
  return math.floor(x / snap + 0.5) * snap
end

---@param inputstr string
---@param sep string
---@return string[]
function split(inputstr, sep)
  if sep == nil then
    sep = "%s"
  end
  local t = {}; i = 1
  for str in string.gmatch(inputstr, "([^" .. sep .. "]+)") do
    t[i] = str
    i = i + 1
  end
  return t
end

---@param str string
---@param len number
---@param char string
function lpad(str, len, char)
  if char == nil then char = ' ' end
  return string.rep(char, len - #str) .. str
end

function escapeLuaPattern(str)
  return string.gsub(str, '([%^%$%(%)%.%[%]%*%+%-%?%%])', '%%%1')
end

function replace(s, oldValue, newValue)
  local str = string.gsub(s, escapeLuaPattern(oldValue), newValue)
  return str
end

function startsWith(str, sub)
  return string.sub(str, 1, string.len(sub)) == sub
end

function endsWith(str, sub)
  return string.sub(str, -string.len(sub)) == sub
end

local whitespaces = { ' ', '\n', '\r' }

---@param str string
function trimLeft(str)
  while includes(whitespaces, string.sub(str, 1, 1)) do
    str = string.sub(str, 2)
  end
  return str
end

---@param str string
function trimRight(str)
  while includes(whitespaces, string.sub(str, -1, -1)) do
    str = string.sub(str, 1, -2)
  end
  return str
end

---@param str string
function trim(str)
  return trimRight(trimLeft(str))
end

---@generic T table<any>
---@param tab T
---@return T
function deepcopy(tab)
  local new = {}
  for k, v in pairs(tab) do
    if type(v) == 'table' then
      local mt = getmetatable(v)
      new[k] = deepcopy(v)
      if mt then
        setmetatable(new[k], deepcopy(mt))
      end
    else
      new[k] = v
    end
  end
  return new
end

function slice(tbl, s, e)
  s = s or 0
  e = e or #tbl
  local pos, new = 1, {}

  for i = s, e do
    new[pos] = tbl[i]
    pos = pos + 1
  end

  return new
end

---@param tab any[]
---@param elem any
function includes(tab, elem)
  if not tab then error('bad argument #1 (expected table, got nil)', 2) end
  for _, v in pairs(tab) do
    if elem == v then return true end
  end
  return false
end

-- prefers tab1 with type mismatches; prefers tab2 with value mismatches
function mergeTable(tab1, tab2)
  local tab = {}
  for k, v1 in pairs(tab1) do
    local v2 = tab2[k]
    if type(v1) ~= type(v2) then
      tab[k] = v1
    else
      if type(v1) == 'table' then
        tab[k] = mergeTable(v1, v2)
      else
        tab[k] = v2
      end
    end
  end
  return tab
end

-- always prefers tab2 unless it is nil
function mergeTableLenient(tab1, tab2)
  local tab = {}
  for k, v in pairs(tab1) do
    tab[k] = v
  end
  for k, v in pairs(tab2) do
    if type(v) == 'table' then
      if tab[k] ~= nil and not getmetatable(v) then
        tab[k] = mergeTableLenient(tab[k], v)
      else
        tab[k] = v
      end
    elseif v ~= nil then
      tab[k] = v
    end
  end
  return tab
end

---@generic T
---@param t table<T, unknown>
---@return T[]
function keys(t)
  local tab = {}
  for k, v in pairs(t) do
    table.insert(tab, k)
  end
  return tab
end

function countKeys(t)
  local n = 0
  for _ in pairs(t) do
    n = n + 1
  end
  return n
end

---@return string
function getActorType(actor)
  local _, _, type = string.find(tostring(actor), '(%a+)%s.*')
  return type
end

---@param actor Actor | ActorFrame
---@param hideChildren boolean?
---@param depth number?
function actorToString(actor, hideChildren, depth)
  depth = depth or 0

  local name = 'Layer'

  local type = getActorType(actor)

  local str = {
    '<', name,
  }

  local values = {
    Type = type,
    Name = actor:GetName(),
    Shader = actor:GetShader() and tostring(actor:GetShader()),
    Text = actor.GetText and actor:GetText()
  }

  for k, v in pairs(values) do
    if v ~= '' then
      table.insert(str, ' ')
      table.insert(str, k)
      table.insert(str, '="')
      table.insert(str, v)
      table.insert(str, '"')
    end
  end

  if (not hideChildren) and actor.GetChildren and type ~= 'ActorFrameTexture' then
    table.insert(str, '><children>\n')
    for _, child in ipairs(actor:GetChildren()) do
      table.insert(str, string.rep('  ', (depth + 1)) .. actorToString(child, hideChildren, depth + 1) .. '\n')
    end
    table.insert(str, string.rep('  ', depth) .. '</children></' .. name .. '>')
  else
    table.insert(str, '/>')
  end

  return table.concat(str, '')
end

-- Recursively seraches for an actor with `name`
---@param actor Actor | ActorFrame
---@param name string
function getRecursive(actor, name)
  if actor.GetName and actor:GetName() == name then
    return actor
  end
  if actor.GetChildren then
    for _, child in ipairs(actor:GetChildren()) do
      local res = getRecursive(child, name)
      if res then return res end
    end
  end
end

function copy(tab)
  return { unpack(tab) }
end
function copyPairs(tab)
  local q = {}
  for k, v in pairs(tab) do
    q[k] = v
  end
  return q
end

function stripMeta(tab)
  local new = {}
  for k, v in pairs(tab) do
    if not (type(k) == 'string' and string.sub(k, 1, 2) == '__') then
      new[k] = v
    end
  end
  return new
end

---@enum TokenType
TokenType = {
  Plain = 1,
  Value = 2,
  Parens = 3,
  Ref = 4,
  Collapsed = 5,
  String = 6,
  Number = 7,
}

---@alias PrettyConfig { maxDepth: number?, maxWidth: number? }

---@param o any
---@param config PrettyConfig?
---@return { [1]: string, type: TokenType }[]
function prettyColored(o, config, depth, indent, seen)
  depth = depth or 0
  indent = indent or 0
  config = config or {}
  if depth > (config.maxDepth or 3) then
    return {{ '...', type = TokenType.Collapsed }}
  end
  seen = seen and copyPairs(seen) or {}
  --print(depth, countKeys(seen))
  local maxWidth = config.maxWidth or 40

  if type(o) == 'userdata' then
    if seen[o] then return {{ '(circular)', type = TokenType.Collapsed }} end
    seen[o] = true

    if o.x then -- actor
      local type = getActorType(o)
      --local str = type .. '[' .. o:GetName() .. ']'
      local str = {
        { type, type = TokenType.Plain },
        { '[', type = TokenType.Parens },
        { o.GetName and o:GetName() or '', type = TokenType.Value },
        { ']', type = TokenType.Parens }
      }

      if type == 'BitmapText' then
        table.insert(str, { ': ', type = TokenType.Parens })
        for _, p in ipairs(prettyColored(o:GetText(), config, depth, indent + 1, seen)) do
          table.insert(str, p)
        end
      elseif o.GetChildren then
        table.insert(str, { ': ', type = TokenType.Parens })
        local children = o:GetChildren()
        for _, p in ipairs(prettyColored(children, config, depth, indent, seen)) do
          table.insert(str, p)
        end
      end

      return str
    else
      local str = {
        { tostring(o), type = TokenType.Ref },
        { ': ', type = TokenType.Parens },
      }
      for _, p in ipairs(prettyColored(stripMeta(getmetatable(o)), config, depth, indent, seen)) do
        table.insert(str, p)
      end
      return str
    end
  elseif type(o) == 'table' then
    if seen[o] then return { { '(circular)', type = TokenType.Collapsed } } end
    seen[o] = true

    local str = {}
    local linebreaks = false
    local strWidth = 0

    local shownKeys = {}
    for i, v in ipairs(o) do
      shownKeys[i] = true
      local s = prettyColored(v, config, depth, indent + 1, seen)
      local sWidth = 0
      local hasNewline = false
      for _, p in ipairs(s) do
        sWidth = sWidth + #p[1]
        if string.find(p[1], '\n') then
          hasNewline = true
        end
      end
      strWidth = strWidth + sWidth

      --if hasNewline or (strWidth + (indent + 1) * 2) > maxWidth then
      --  linebreaks = true
      --  table.insert(str, { '\n' .. string.rep('  ', indent + 1), type = TokenType.Plain })
      --  strWidth = 0
      --end

      for _, p in ipairs(s) do
        table.insert(str, p)
      end
      table.insert(str, { ', ', type = TokenType.Plain })
      strWidth = strWidth + 2

      -- todo temporary until i figure out why tables break otherwise
      linebreaks = true
      table.insert(str, { '\n' .. string.rep('  ', indent + 1), type = TokenType.Plain })
      strWidth = 0
    end
    for k, v in pairs(o) do
      if not shownKeys[k] then
        if type(k) == 'string' and string.find(k, '^[a-zA-Z_][a-zA-Z0-9_]*$') then
          table.insert(str, { k, type = TokenType.Plain })
          strWidth = strWidth + #k
        else
          table.insert(str, { '[', type = TokenType.Plain })
          strWidth = strWidth + 1
          for _, p in ipairs(prettyColored(k, config, depth, indent + 1, seen)) do
            table.insert(str, p)
            strWidth = strWidth + #p[1]
          end
          table.insert(str, { ']', type = TokenType.Plain })
          strWidth = strWidth + 1
        end
        table.insert(str, {' = ', type = TokenType.Plain })
        strWidth = strWidth + 3
        local s = prettyColored(v, config, depth, indent + 1, seen)

        for _, p in ipairs(s) do
          table.insert(str, p)
          strWidth = strWidth + #p[1]
        end

        table.insert(str, { ', ', type = TokenType.Plain })
        strWidth = strWidth + 2

        linebreaks = true
        table.insert(str, { '\n' .. string.rep('  ', indent + 1), type = TokenType.Plain })
        strWidth = 0
      end
    end

    -- remove trailing comma
    local p = table.remove(str, #str)
    if p then
      strWidth = strWidth - #p[1]
    end

    if linebreaks then
      -- remove trailing newline
      local p = table.remove(str, #str)
      if p then
        strWidth = strWidth - #p[1]
      end

      if string.sub(str[1][1], 1, 1) ~= '\n' then
        table.insert(str, 1, { '\n' .. string.rep('  ', indent + 1), type = TokenType.Plain })
      end
      table.insert(str, { '\n' .. string.rep('  ', indent), type = TokenType.Plain })
      table.insert(str, { '}', type = TokenType.Parens })
    else
      table.insert(str, { '}', type = TokenType.Parens })
    end

    table.insert(str, 1, { '{', type = TokenType.Parens })

    return str
  elseif type(o) == 'string' then
    return {{ string.gsub(string.gsub(string.format('%q', o), '\\\n', '\\n'), '\t', '\\t'), type = TokenType.String }}
    --if string.find(o, '\n') then
    --  return '[[' .. string.gsub(o, '\\', '\\\\') .. ']]'
    --else
    --  return '"' .. string.gsub(string.gsub(o, '\\', '\\\\'), '"', '\\"') .. '"'
    --end
  elseif type(o) == 'nil' then
    return {{ 'nil', type = TokenType.Value }}
  elseif type(o) == 'number' then
    return {{ tostring(o), type = TokenType.Number }}
  elseif type(o) == 'function' or type(o) == 'userdata' then
    return {{ tostring(o), type = TokenType.Ref }}
  else
    return {{ tostring(o), type = TokenType.Value }}
  end
end

function pretty(...)
  local tab = prettyColored(unpack(arg))
  local res = {}
  for _, token in ipairs(tab) do
    table.insert(res, token[1])
  end
  return table.concat(res, '')
end

function ot_enough_memory()
  function crash(depth)
    local init = '\27\76\117\97\81\0\1\4\4\4\8\0\7\0\0\0\61\115\116' ..
        '\100\105\110\0\1\0\0\0\1\0\0\0\0\0\0\2\2\0\0\0\36' ..
        '\0\0\0\30\0\128\0\0\0\0\0\1\0\0\0\0\0\0\0\1\0\0\0' ..
        '\1\0\0\0\0\0\0\2'
    local mid = '\1\0\0\0\30\0\128\0\0\0\0\0\0\0\0\0\1\0\0\0\1\0\0\0\0'
    local fin = '\0\0\0\0\0\0\0\2\0\0\0\1\0\0\0\1\0\0\0\1\0\0\0\2\0' ..
        '\0\0\97\0\1\0\0\0\1\0\0\0\0\0\0\0'
    local lch = '\2\0\0\0\36\0\0\0\30\0\128\0\0\0\0\0\1\0\0\0\0\0\0' ..
        '\0\1\0\0\0\1\0\0\0\0\0\0\2'
    local rch = '\0\0\0\0\0\0\0\2\0\0\0\1\0\0\0\1\0\0\0\1\0\0\0\2\0' ..
        '\0\0\97\0\1\0\0\0\1'
    for i = 1, depth do lch, rch = lch .. lch, rch .. rch end
    loadstring(init .. lch .. mid .. rch .. fin)
  end

  for i = 1, 25 do
    crash(i)
  end
end

---@generic T
---@param table T[]
---@param value T
---Returns index of entry
---@return number?
function search(table, value)
  for i = 1, #table do
    if table[i] == value then return i end
  end
end

---@param screen string
function delayedSetScreen(screen)
  GAMESTATE:DelayedGameCommand('screen,' .. screen)
end

---Gets Contents of a Folder within the theme
---@param path string
---@param clean_extensions? boolean
---@return table
function getFolderContents(path, clean_extensions)
  --TODO: Make it not require an ending slash
  --Give the entire Theme folder if no arguments
  if not path then path = '' end

  local files = {}

  for base in string.gfind(gimmick.package.search, '[^;]+') do
    local paths = { GAMESTATE:GetFileStructure(base .. path) }
    for _, v in ipairs(paths) do
      if clean_extensions then
        local clean = string.betterfind(v, '^(.+)%.')
        if clean then v = clean end
      end
      table.insert(files, v)
    end
  end

  return files
end

---@param str string
---@param pattern string
function findAndRemove(str, pattern)
  local start, pend = string.find(str, pattern)
  if start and pend then
    return string.sub(str, 1, start - 1) .. string.sub(str, pend + 1)
  end
  return str
end

function casePattern(s)
  local pattern = {}
  for i = 1, string.len(s) do
    local c = string.sub(s, i, i)
    table.insert(pattern, '[' .. string.lower(c) .. string.upper(c) .. ']')
  end
  return table.concat(pattern, '')
end

-- Turns a formratted filename with hints into just the basename
-- eg. Bold 2x6 (res 512x504) -> Bold
function stripFilename(filename)
  -- res hints
  filename = findAndRemove(filename, '%([^\\)]-res %d+x%d+.-%)')
  filename = findAndRemove(filename, '%([^\\)]-doubleres.-%)')

  -- hint strings
  filename = findAndRemove(filename, casePattern('32bpp'))
  filename = findAndRemove(filename, casePattern('16bpp'))
  filename = findAndRemove(filename, casePattern('dither'))
  filename = findAndRemove(filename, casePattern('stretch'))
  filename = findAndRemove(filename, casePattern('mipmaps'))
  filename = findAndRemove(filename, casePattern('nomipmaps'))
  filename = findAndRemove(filename, casePattern('grayscale'))
  filename = findAndRemove(filename, casePattern('alphamap'))

  -- frame dimensions
  filename = findAndRemove(filename, '%d+x%d+')

  return trimRight(filename)
end

---@param ctx Context
---@param items Actor[]
function flexbox(ctx, conf, items)
  local af = ctx:ActorFrame()
  local config = conf or {
    halign = 0.5,
    valign = 0.5,
    width = 100,
    height = 300,
  }
  print(pretty(config))

  for index, item in ipairs(items) do
    ctx:addChild(af, item)
    item:halign(config['halign'])
    item:valign(config['valign'])
    item:xy(
      config['width'] * (config['halign'] - 0.5),
      (config['height'] / #items) * (index - #items / 2 - 0.5)
    )
  end

  af:SetDrawFunction(function()
    for _, item in ipairs(items) do
      item:Draw()
    end
  end)

  return af
end

---This purely exists to reduce the returns to 1
---@param s string
---@param pattern string
---@return string|nil
string.betterfind = function(s, pattern)
  local _, _, result = string.find(s, pattern)
  return result
end



function filter(table, callback)
  local res = {}
  for key, value in pairs(table) do
    if callback(value) then
      res[key] = value
    end
  end
  return res
end

---@param secs number
---@return string
function formatTime(secs)
  return string.format('%02d:%02d', math.floor(secs / 60), math.ceil(secs % 60))
end

-- Introduces entropy into the universe
function introduceEntropyIntoUniverse()
  table.insert({}, {})
  collectgarbage()
end

---@generic K
---@param tab table<K, number>
---@return K
function pickWeighted(tab)
  local sum = 0
  for _, v in pairs(tab) do
    sum = sum + v
  end
  local roll = math.random() * sum
  for k, v in pairs(tab) do
    roll = roll - v
    if roll <= 0 then return k end
  end
  return nil
end