added logging support

README.md

@@ -1 +1 @@
-# ascension-rebirth
+# jeopardy game

main.lua

@@ -1,7 +1,28 @@
+local logger = require("utils/logger")
+local lovehandler = require("utils/love_file_handler")
+
 multi,  thread = require("multi"):init({priority=true})
 multi.setClock(require("socket").gettime) -- When on linux os.clock doesn't reture actual seconds the program has elapsed for
 GLOBAL, THREAD = require("multi.integration.loveManager"):init()
 
+
+
+local fileHandler, logCtrl = lovehandler.new("logs/jeopardy.log", {
+    max_size   = 512 * 1024,  -- rotate at 512 KB
+    max_files  = 3,
+    buffered   = false,       -- write every line immediately (safest for games)
+})
+
+lovehandler.auto_flush_on_quit(logCtrl)
+
+log = logger.new("jeopardy", {
+  level    = logger.LEVELS.DEBUG,
+  handlers = {
+    logger.handlers.ConsoleHandler({ colours = true }),
+    fileHandler,
+  },
+})
+
 local gui    = require("gui")
 local color  = require("gui.core.color")
 local title  = require("menus.title")
@@ -23,25 +44,35 @@ gui:setHotKey({"f11"})(function()
 	love.window.setFullscreen(not fullscreen, "desktop")
 end)
 
+local loadLog = log:child("load")
 local old = multi.error
 
-multi.error = function(...)
+multi.error = function(self, err)
-    old(...)
+    loadLog:error("Error: %s", err)
-    os.exit()
+    love.quit()
 end
 
 function love.load()
+    loadLog:info("Starting Jeopardy Game")
+    loadLog:debug("Setting game identity to jeopardy")
     love.filesystem.setIdentity("jeopardy")
+    loadLog:trace("Creating save directory")
     success = love.filesystem.createDirectory("")
+    if not success then
+        loadLog:fatal("Unable to create save directory")
+        love.quit()
+    end
+    loadLog:trace("Creating save directory")
     gui:cacheImage({"assets/images/checked.png","assets/images/unchecked.png","assets/images/speaker.png"})
     gui:setAspectSize(1920, 1080)
     gui.aspect_ratio = true
-    
+    loadLog:debug("Creating main background image")
     local bg = gui:newImageLabel("assets/images/background.png")
     bg:fullFrame()
 
+    loadLog:debug("Init menu module")
     menu.init(bg)
-
+    loadLog:debug("Displaying title menu")
     title:visible(true)
 end
 

menus/board.lua

@@ -1,9 +1,9 @@
 local gui = require("gui")
 local color = require("gui.core.color")
-local loader = require("loader")
+local loader = require("utils/loader")
 local theme = require("gui.core.theme")
-local fmt = require("fmt")
+local fmt = require("utils/fmt")
-local timer = require("utils")
+local timer = require("utils/utils")
 local multi, thread = require("multi"):init()
 local menu = require("gui.core.menus")
 
@@ -22,7 +22,10 @@ local scoreboard = {}
 -- Create a table to manage GUI elements
 local manage = {}
 
+local boardLog = log:child("board")
+
 -- Function to resize fonts for all managed elements
+boardLog:debug("Creating resize fonts handler")
 local function resizeFonts()
     -- Use multi-threading to improve performance
     multi:newThread(function()
@@ -87,6 +90,7 @@ end
 
 function applyDD()
     if not applied_dd and completed_questions > min_questions then
+        boardLog:debug("Creating double jeopardy questions: %d",dd_count)
         local dd = 0
         local dd_list = {}
         local dds = {pickFiltered(board.children, dd_count)}
@@ -97,13 +101,15 @@ function applyDD()
     end
 end
 
+local templateLog = log:child("template")
 function LoadTemplate(name, path)
+    boardLog:debug("Loading Template: %s", name)
     if love.filesystem.getInfo(path .."/templates/" .. name .. ".lua") then
         data = love.filesystem.read(path .."/templates/" .. name .. ".lua")
     elseif love.filesystem.getInfo("templates/" .. name .. ".lua") then
         data = love.filesystem.read("templates/" .. name .. ".lua")
     else
-        print("Error Loading Template: " .. name, path)
+        boardLog:error("Error Loading Template: %s", name)
         gui:newMessageBox({
             title    = "Error!",
             message  = "Unable to load template: " .. name,
@@ -157,7 +163,8 @@ function LoadTemplate(name, path)
         gui = gui,
         timer = timer,
         -- love stuff
-        newSource = love.audio.newSource
+        newSource = love.audio.newSource,
+        log = templateLog
     }
     
     env._G = env
@@ -167,6 +174,7 @@ function LoadTemplate(name, path)
 end
 
 local function manageCosmetics(frame, cosmetics)
+    boardLog:debug("Managing cosmetics")
     if cosmetics["bg-img"] then
         frame:setImage(cosmetics["bg-img"])
     else
@@ -192,9 +200,9 @@ local reset = boardUpdater:newConnection()
 local default_text = "Pick a Category"
 
 function Menu(frame, path)
+    boardLog:info("Building board")
     if path:match(".zip") then
         -- local basename = path:match("([^/\\]+)$")
-        print(path)
         local success = love.filesystem.mount(path, "quiz", true)
         if not success then
             gui:newMessageBox({
@@ -215,6 +223,7 @@ function Menu(frame, path)
     end
 
     -- Start the processors now
+    boardLog:debug("Starting processors")
     boardUpdater.Start()
     qUpdater.Start()
     scoreUpdater.Start()
@@ -329,20 +338,21 @@ function Menu(frame, path)
                 if dd_enabled then
                     applyDD() -- check and run DD if conditions meet
                 end
-                if index.categories[cat].questions == nil then fmt.Printf("Question not defined: File: %v Category: %v - %v\n",path,index.categories[cat].name,start + inc*(tier-1)) return end
+                if index.categories[cat].questions == nil then boardLog:info("Question not defined: File: %s Category: %s - %s\n",path,index.categories[cat].name,start + inc*(tier-1)) return end
                 local globals = index.categories[cat].global
                 if not globals then
                     globals = {}
                 end
                 local q = index.categories[cat].questions[self.index]
                 if not q then return end
-                label.text = t.category .. ": " .. t.price
+                label.text = t.category .. " - " .. t.price
+                boardLog:debug("Displaying question for: %s - %s", t.category, t.price)
                 local mt = debug.getmetatable(q)
                 if mt then
                     mt.__metatable = nil
                 end
                 setmetatable(q, {__index = globals})
-                if q == nil then fmt.Printf("Question contains no data: File: %v Category: %v Tier: %v\n",path,index.categories[cat].name,start + inc*(tier-1)) return end
+                if q == nil then boardLog:info("Question contains no data: File: %s Category: %s Tier: %s\n",path,index.categories[cat].name,start + inc*(tier-1)) return end
                 if q.cosmetics then
                     manageCosmetics(frame, q.cosmetics)
                 end
@@ -352,7 +362,7 @@ function Menu(frame, path)
                 local player = GetActivePlayer()
                 local tm
                 local stop
-                fmt.Printf("--------------------\nQuestion: %v \nAnswer: %v\n--------------------\n",q["title"],q["answer"])
+                boardLog:info("Question: '%s' Answer: '%s'",q["title"],q["answer"])
                 local mul = 1
                 boardUpdater:newThread(function()
                     if self.isDouble then

menus/title.lua

@@ -7,12 +7,15 @@ local APP_VERSION = love.filesystem.read("version.txt")
 
 local board = require("menus.board")
 
+local titleLog = log:child("title")
+
 function Menu(frame)
     local background = frame:newImageLabel("assets/images/background.jpg")
     background:fullFrame()
     local title = background:newTextLabel("Jeopardy",0,0,0,0,0,.1,1,.25)
     title:setFont("assets/fonts/gyparody.ttf",300)
 
+    titleLog:debug("Setting title shader")
     title:setShader(gui.SHADERS.vignette,{
         intensity = .5,
         smoothness = .8
@@ -23,6 +26,7 @@ function Menu(frame)
     title.textColor = color.title_font
     title.drawBorder = false
 
+    titleLog:debug("Creating font thread")
     proc:newThread(function()
         local function enabled()
             return background.visible
@@ -64,17 +68,20 @@ function Menu(frame)
     },play,settings,quit)
 
     play:OnReleased(function()
+        titleLog:debug("Play button pressed")
         if love.filesystem.getInfo("quiz") then
             menu.getMenu("board"):visible(true, "quiz")
             return
         else
             gui:newFilePicker("File picker test",nil, {".zip"}, function(file)
+                titleLog:info("File picked: %s", file)
                 menu.getMenu("board"):visible(true, file:gsub("\\","/"):gsub(love.filesystem.getSaveDirectory(),""):sub(2,-1))
             end)
         end
     end)
 
     quit:OnReleased(function()
+        titleLog:debug("Quit button pressed")
         local f = frame:newFrame()
         f:fullFrame()
         f.visibility = .8

package.bat

@@ -5,7 +5,7 @@ for /f "usebackq delims=" %%i in ("version.txt") do (
 )
 
 :done
-"C:\Program Files\7-Zip\7z.exe" a -tzip game.love templates version.txt assets multi\integration\loveManager multi\integration\sharedExtensions multi\init.lua gui menus conf.lua fmt.lua loader.lua main.lua utils.lua yaml.lua
+"C:\Program Files\7-Zip\7z.exe" a -tzip game.love templates version.txt assets multi\integration\loveManager multi\integration\sharedExtensions multi\init.lua utils gui menus conf.lua main.lua
 rd /s /q "bin\%userInput%"
 if not exist "bin\%userInput%" mkdir "bin\%userInput%"
 copy /b love\love.exe + game.love "bin\%userInput%\Jeopardy.exe"

test_logger.lua

@@ -0,0 +1,197 @@
+--- test_logger.lua — Demonstrates and tests all logger.lua features
+
+-- Adjust path if needed
+package.path = "./?.lua;" .. package.path
+local Logger = require("utils/logger")
+
+local PASS = 0
+local FAIL = 0
+
+local function test(label, cond)
+  if cond then
+    print(string.format("  [PASS] %s", label))
+    PASS = PASS + 1
+  else
+    io.stderr:write(string.format("  [FAIL] %s\n", label))
+    FAIL = FAIL + 1
+  end
+end
+
+print("━━━ logger.lua test suite ━━━\n")
+
+-- ── 1. Basic levels ────────────────────────────────────────────────────────
+print("▶ 1. Basic level output (INFO+)")
+do
+  local handler, get, clear = Logger.handlers.MemoryHandler()
+  local log = Logger.new("basic", { level = Logger.LEVELS.INFO, handlers = { handler } })
+
+  log:trace("should be filtered")
+  log:debug("should be filtered")
+  log:info("hello %s", "world")
+  log:warn("disk %d%%", 90)
+  log:error("boom")
+  log:fatal("catastrophe")
+
+  local records = get()
+  test("TRACE filtered",        records[1].level == Logger.LEVELS.INFO)
+  test("INFO captured",         records[1].message == "hello world")
+  test("WARN captured",         records[2].message == "disk 90%")
+  test("ERROR captured",        records[3].level   == Logger.LEVELS.ERROR)
+  test("FATAL captured",        records[4].level   == Logger.LEVELS.FATAL)
+  test("exactly 4 records",     #records == 4)
+end
+
+-- ── 2. Level filtering ─────────────────────────────────────────────────────
+print("\n▶ 2. Dynamic level changes")
+do
+  local handler, get = Logger.handlers.MemoryHandler()
+  local log = Logger.new("dyn", { handlers = { handler } })
+
+  log:set_level(Logger.LEVELS.DEBUG)
+  log:debug("visible")
+  log:set_level(Logger.LEVELS.ERROR)
+  log:info("invisible")
+  log:error("visible again")
+
+  local records = get()
+  test("DEBUG visible at DEBUG level",   records[1].message == "visible")
+  test("INFO invisible at ERROR level",  records[2].message == "visible again")
+  test("total 2 records",                #records == 2)
+end
+
+-- ── 3. is_enabled ──────────────────────────────────────────────────────────
+print("\n▶ 3. is_enabled()")
+do
+  local log = Logger.new("enabled", { level = Logger.LEVELS.WARN })
+  test("WARN enabled",  log:is_enabled(Logger.LEVELS.WARN))
+  test("INFO disabled", not log:is_enabled(Logger.LEVELS.INFO))
+  test("ERROR enabled", log:is_enabled(Logger.LEVELS.ERROR))
+end
+
+-- ── 4. Custom format ───────────────────────────────────────────────────────
+print("\n▶ 4. Custom format string")
+do
+  local handler, get = Logger.handlers.MemoryHandler()
+  local log = Logger.new("fmt", {
+    format   = "{level}|{name}|{message}",
+    handlers = { handler },
+  })
+  log:info("hi")
+  local f = get()[1].formatted
+  test("contains level",   f:find("INFO")  ~= nil)
+  test("contains name",    f:find("fmt")   ~= nil)
+  test("contains message", f:find("hi")    ~= nil)
+  test("pipe separator",   f:find("|")     ~= nil)
+end
+
+-- ── 5. Filters ─────────────────────────────────────────────────────────────
+print("\n▶ 5. Custom filter")
+do
+  local handler, get = Logger.handlers.MemoryHandler()
+  local log = Logger.new("filter", { level = Logger.LEVELS.DEBUG, handlers = { handler } })
+
+  -- only pass records whose message contains "keep"
+  log:add_filter(function(rec) return rec.message:find("keep") ~= nil end)
+
+  log:info("drop this")
+  log:info("keep this")
+  log:warn("also drop")
+  log:debug("keep me too")
+
+  local records = get()
+  test("only 'keep' records pass", #records == 2)
+  test("first kept record",        records[1].message == "keep this")
+  test("second kept record",       records[2].message == "keep me too")
+end
+
+-- ── 6. Multiple handlers ───────────────────────────────────────────────────
+print("\n▶ 6. Multiple handlers")
+do
+  local h1, get1 = Logger.handlers.MemoryHandler()
+  local h2, get2 = Logger.handlers.MemoryHandler()
+  local log = Logger.new("multi", { handlers = { h1 } })
+  log:add_handler(h2)
+
+  log:info("broadcast")
+
+  test("handler1 received", #get1() == 1)
+  test("handler2 received", #get2() == 1)
+  test("same message",      get1()[1].message == get2()[1].message)
+end
+
+-- ── 7. Child loggers ───────────────────────────────────────────────────────
+print("\n▶ 7. Child loggers")
+do
+  local handler, get = Logger.handlers.MemoryHandler()
+  local parent = Logger.new("app", { handlers = { handler } })
+  local child  = parent:child("db")
+
+  parent:info("parent message")
+  child:info("child message")
+
+  local records = get()
+  test("parent name",  records[1].name == "app")
+  test("child name",   records[2].name == "app.db")
+  test("child shares handler", #records == 2)
+end
+
+-- ── 8. Logger.get() registry ──────────────────────────────────────────────
+print("\n▶ 8. Logger.get() registry")
+do
+  local a = Logger.get("svc.auth")
+  local b = Logger.get("svc.auth")
+  test("same instance returned", a == b)
+
+  local c = Logger.get("svc.payments")
+  test("different names differ", a ~= c)
+end
+
+-- ── 9. Format with no args ────────────────────────────────────────────────
+print("\n▶ 9. Message with no format args")
+do
+  local handler, get = Logger.handlers.MemoryHandler()
+  local log = Logger.new("noargs", { handlers = { handler } })
+  log:info("plain string, no args")
+  test("plain string works", get()[1].message == "plain string, no args")
+end
+
+-- ── 10. FileHandler ───────────────────────────────────────────────────────
+print("\n▶ 10. FileHandler")
+do
+  local path = "test_logger_output.log"
+  os.remove(path)
+
+  local fh = Logger.handlers.FileHandler({ path = path })
+  local log = Logger.new("file", { handlers = { fh } })
+  log:info("written to file")
+  log:warn("second line")
+
+  local f = io.open(path)
+  local content = f and f:read("*a") or ""
+  if f then f:close() end
+
+  test("file created",        content ~= "")
+  test("INFO line present",   content:find("written to file") ~= nil)
+  test("WARN line present",   content:find("second line")     ~= nil)
+  test("two newlines",        select(2, content:gsub("\n","")) == 2)
+end
+
+-- ── 11. Console handler (visual) ──────────────────────────────────────────
+print("\n▶ 11. ConsoleHandler — visual check (colours enabled)")
+do
+  local log = Logger.new("visual", {
+    level    = Logger.LEVELS.TRACE,
+    handlers = { Logger.handlers.ConsoleHandler({ colours = true }) },
+  })
+  log:trace("trace message")
+  log:debug("debug message")
+  log:info ("info message")
+  log:warn ("warn message")
+  log:error("error message")
+  log:fatal("fatal message")
+  test("no crash", true)
+end
+
+-- ── Summary ────────────────────────────────────────────────────────────────
+print(string.format("\n━━━ Results: %d passed, %d failed ━━━", PASS, FAIL))
+if FAIL > 0 then os.exit(1) end

test_logger_output.log

@@ -0,0 +1,2 @@
+[2026-06-08 19:40:49] [INFO ] [file] written to file
+[2026-06-08 19:40:49] [WARN ] [file] second line

utils.lua

@@ -1,245 +0,0 @@
--- local gui = require("gui")
--- local color = require("gui.core.color")
--- local transition = require("gui.core.transitions")
--- local multi = require("multi"):init()
--- local timer = transition.glide(3.5,1.5,5)
-
--- local function startTimer(opt)
---     local default = {
---         duration = 30,
---         autoText = true,
---         autoColor = true,
---         autoCleanup = true,
---         startColor = color.green,
---         textColor = color.black,
---         warnColor = color.yellow,
---         timeColor = color.red,
---         finegrained = false,
---         visibility = 1
---     }
-
---     if type(opt) == "number" then
---         local d = opt
---         opt = default
---         opt.duration = d
---     elseif type(opt) ~= "table" then
---         opt = default
---     elseif type(opt) == "table" then
---         for i,v in pairs(opt) do
---             default[i] = v
---         end
---         opt = default
---     end
-
---     local timeRemaining = opt.duration or 30
-    
---     transition.glide:SetFPS(60)
---     local handle = timer(3.5, 1.5, timeRemaining)
---     local tpie = gui:newFrame():makeArc("pie",-200, 0, 100,1 ,0 ,0 ,1.5*math.pi, 3.5*math.pi, 360)
---     local tlabel = tpie:newTextLabel("")
---     tlabel.textColor = opt.textColor
---     tlabel.align = gui.ALIGN_CENTER
---     tlabel:fullFrame()
---     tlabel.visibility = 0
---     tpie.color = opt.startColor
---     tpie.visibility = opt.visibility
-
---     local tm, num
---     local func = function(p,t)
---         if num ~= timeRemaining-math.floor(t) then
---             num = timeRemaining-math.floor(t)
---         end
-
---         if opt.autoColor then
---             tpie.color = opt.startColor
---             if num <= timeRemaining/3 then
---                 tpie.color = opt.timeColor
---             elseif num <= timeRemaining/2 then
---                 tpie.color = opt.warnColor
---             end
---         end
-
---         tpie:makeArc("pie", -200, 0, 100, 1, 0, 0, 1.5 * math.pi, p * math.pi, 360)
-        
---         if opt.autoText then
---             tlabel.text = num
---             tlabel:fitFont(nil, nil, {scale=1/2})
---             tlabel:centerFont()
---         end
-
---         if num == 0 then
---             thread:newThread("Pie Timer",function()
---                 thread.yield()
---                 if opt.autoText then
---                     tlabel.text = "Time"
---                     tlabel:fitFont(nil, nil, {scale=1/2})
---                     tlabel:centerFont()
---                 end
---                 tpie:makeArc("pie", -200, 0, 100, 1, 0, 0, 1.5 * math.pi, 3.5 * math.pi, 360)
---                 tm.OnStop:Fire(tm)
---                 if opt.autoCleanup then
---                     tm:Cleanup()
---                 end
---                 tm.OnTime:Destroy()
---                 tm.OnStop:Destroy()
---             end)
---         end
-
---         return tm, num, t
---     end
- 
---     tm = {
---         Duration = timeRemaining,
---         Cleanup = function() handle:Kill() tpie:destroy() tm.Cleanup = function() end end,
---         SetText = function(str) tlabel.text = str end,
---         SetColor = function(c) tpie.color = c end,
---         OnStop = multi:newConnection()
---     }
-
---     if opt.finegrained then
---         tm.OnTime = func % handle.OnStep
---     else
---         tm.OnTime = function(self, sec, t) return math.floor(t) == t, self, sec end / (func % handle.OnStep)
---     end
-
---     return tm
--- end
-
--- return {
---     startTimer = startTimer
--- }
-
-local gui = require("gui")
-local color = require("gui.core.color")
-local multi, thread = require("multi"):init()
-
-local function startTimer(opt)
-    local default = {
-        duration = 30,
-        autoText = true,
-        autoColor = true,
-        autoCleanup = false,
-        startColor = color.green,
-        textColor = color.black,
-        warnColor = color.yellow,
-        timeColor = color.red,
-        finegrained = false,
-        visibility = 1
-    }
-
-    if type(opt) == "number" then
-        local d = opt
-        opt = default
-        opt.duration = d
-    elseif type(opt) ~= "table" then
-        opt = default
-    else
-        for i, v in pairs(opt) do
-            default[i] = v
-        end
-        opt = default
-    end
-
-    local timeRemaining = opt.duration or 30
-
-    local tpie = gui:newFrame():makeArc("pie", -200, 0, 100, 1, 0, 0, 1.5*math.pi, 3.5*math.pi, 360)
-    local tlabel = tpie:newTextLabel("")
-    tlabel.textColor = opt.textColor
-    tlabel.align = gui.ALIGN_CENTER
-    tlabel:fullFrame()
-    tlabel.visibility = 0
-    tpie.color = opt.startColor
-    tpie.visibility = opt.visibility
-
-    local tm
-    local stopped = false
-    local onTimeConn = multi:newConnection()
-    local onStopConn = multi:newConnection()
-
-    local function cleanup()
-        if stopped then return end
-        stopped = true
-        if onTimeConn and not onTimeConn.destroyed then
-            onTimeConn:Destroy()
-        end
-        if not tpie.destroyed then
-            tpie:destroy()
-        end
-    end
-
-    local timerThread = thread:newThread("Pie Timer", function()
-        local startTime = love.timer.getTime()
-        local lastSecond = timeRemaining
-
-        while not stopped do
-            thread.sleep(1/60)
-
-            local now = love.timer.getTime()
-            local elapsed = now - startTime
-            local t = math.min(elapsed, timeRemaining)
-            local num = timeRemaining - math.floor(t)
-            local p = 3.5 - (t / timeRemaining) * 2
-
-            if opt.autoColor then
-                tpie.color = opt.startColor
-                if num <= timeRemaining / 3 then
-                    tpie.color = opt.timeColor
-                elseif num <= timeRemaining / 2 then
-                    tpie.color = opt.warnColor
-                end
-            end
-
-            tpie:makeArc("pie", -200, 0, 100, 1, 0, 0, 1.5*math.pi, p*math.pi, 360)
-
-            if opt.autoText then
-                tlabel.text = num
-                tlabel:fitFont(nil, nil, {scale=1/2})
-                tlabel:centerFont()
-            end
-
-            if opt.finegrained then
-                onTimeConn:Fire(tm, num, t)
-            elseif num < lastSecond then
-                -- crossed a second boundary
-                lastSecond = num
-                onTimeConn:Fire(tm, num, t)
-            end
-
-            if elapsed >= timeRemaining then
-                break
-            end
-        end
-
-        -- Timer finished
-        if stopped then return end
-
-        if opt.autoText then
-            tlabel.text = "Time"
-            tlabel:fitFont(nil, nil, {scale=1/2})
-            tlabel:centerFont()
-        end
-        tpie:makeArc("pie", -200, 0, 100, 1, 0, 0, 1.5*math.pi, 3.5*math.pi, 360)
-
-        local onStop = onStopConn
-        cleanup()
-        onStop:Fire(tm)
-    end)
-
-    tm = {
-        Duration = timeRemaining,
-        OnTime = onTimeConn,
-        OnStop = onStopConn,
-        SetText = function(str) tlabel.text = str end,
-        SetColor = function(c) tpie.color = c end,
-        Cleanup = function()
-            timerThread:Kill()
-            cleanup()
-        end,
-    }
-
-    return tm
-end
-
-return {
-    startTimer = startTimer
-}

utils/loader.lua

@@ -1,36 +1,41 @@
-local yaml  = require("yaml")
+local yaml  = require("utils/yaml")
-local loader = {}
+local loader = {}
-loader.__index = loader
+loader.__index = loader
-
+
-function loader:new(path_or_file)
+local loaderLog = log:child("loader")
-    local c = {}
+
-    setmetatable(c, loader)
+function loader:new(path_or_file)
-    c.source = path_or_file
+    local c = {}
-    local file = love.filesystem.read(path_or_file .. "/index.yml")
+    setmetatable(c, loader)
-    if not file then 
+    c.source = path_or_file
-        error("Unable to load file: ".. path_or_file .."/index.yml")
+    local file = love.filesystem.read(path_or_file .. "/index.yml")
-    end
+    
-    c.index = yaml.parse(file)
+    if not file then 
-    for i,v in pairs(c.index.categories) do
+        loaderLog:error("Unable to load file: %s/index.yml", path_or_file)
-        local link = love.filesystem.read(path_or_file .. "/" .. v.name .. ".yml")
+    end
-        if not link then
+
-            print("Error! Cannot find file: " .. path_or_file .."/" .. v.name .. ".yml")
+    c.index = yaml.parse(file)
-        else
+
-            local category = yaml.parse(link)
+    for i,v in pairs(c.index.categories) do
-            c.index.categories[i].questions = category.questions
+        local link = love.filesystem.read(path_or_file .. "/" .. v.name .. ".yml")
-            c.index.categories[i].global = category.global or {}
+        if not link then
-            c.index.categories[i].cosmetics = category.cosmetics or {}
+            loaderLog:error("Error! Cannot find file: %s/%s.yml", path_or_file,v.name)
-        end
+        else
-    end
+            local category = yaml.parse(link)
-    return c
+            c.index.categories[i].questions = category.questions
-end
+            c.index.categories[i].global = category.global or {}
-
+            c.index.categories[i].cosmetics = category.cosmetics or {}
-function loader:getCategories()
+        end
-    return self.index.categories
+    end
-end
+    return c
-
+end
-function loader:getSettings()
+
-    return self.index.settings
+function loader:getCategories()
-end
+    return self.index.categories
-
+end
+
+function loader:getSettings()
+    return self.index.settings
+end
+
 return loader

utils/logger.lua

@@ -0,0 +1,300 @@
+--- logger.lua — A feature-rich logging library for Lua
+-- Supports log levels, multiple handlers, formatting, and filtering.
+--
+-- Usage:
+--   local Logger = require("logger")
+--   local log = Logger.new("MyApp")
+--   log:info("Server started on port %d", 8080)
+--   log:warn("Disk usage at %d%%", 92)
+--   log:error("Connection refused: %s", err)
+
+local Logger = {}
+Logger.__index = Logger
+
+-- ── Level definitions ──────────────────────────────────────────────────────
+
+Logger.LEVELS = {
+  TRACE = 1,
+  DEBUG = 2,
+  INFO  = 3,
+  WARN  = 4,
+  ERROR = 5,
+  FATAL = 6,
+  OFF   = 7,   -- disable all output
+}
+
+-- Reverse map: number → name
+local LEVEL_NAMES = {}
+for name, val in pairs(Logger.LEVELS) do
+  LEVEL_NAMES[val] = name
+end
+
+-- ANSI colour codes (used by the ConsoleHandler when colours are enabled)
+local COLOURS = {
+  [1] = "\27[36m",   -- TRACE  cyan
+  [2] = "\27[34m",   -- DEBUG  blue
+  [3] = "\27[32m",   -- INFO   green
+  [4] = "\27[33m",   -- WARN   yellow
+  [5] = "\27[31m",   -- ERROR  red
+  [6] = "\27[35m",   -- FATAL  magenta
+  RESET = "\27[0m",
+}
+
+-- ── Utility helpers ────────────────────────────────────────────────────────
+
+--- Returns an ISO-8601-style timestamp: "2025-06-08 14:32:01"
+local function timestamp()
+  return os.date("%Y-%m-%d %H:%M:%S")
+end
+
+--- Safe string formatting — falls back gracefully when fmt is not a string
+local function safe_format(fmt, ...)
+  if select("#", ...) == 0 then
+    return tostring(fmt)
+  end
+  local ok, result = pcall(string.format, tostring(fmt), ...)
+  return ok and result or (tostring(fmt) .. " " .. table.concat({...}, " "))
+end
+
+--- Pads or truncates a string to a fixed width
+local function pad(s, width)
+  s = tostring(s)
+  if #s >= width then return s:sub(1, width) end
+  return s .. string.rep(" ", width - #s)
+end
+
+-- ── Built-in Handlers ──────────────────────────────────────────────────────
+
+--- ConsoleHandler — writes to stdout (or stderr for ERROR+)
+-- Options:
+--   colours  (bool, default true)  — enable ANSI colours
+--   stderr   (bool, default false) — always write to stderr
+local function ConsoleHandler(opts)
+  opts = opts or {}
+  local use_colour = (opts.colours ~= false)
+  local force_stderr = opts.stderr or false
+
+  return function(record)
+    local line = record.formatted
+    if use_colour then
+      local c = COLOURS[record.level] or ""
+      line = c .. line .. COLOURS.RESET
+    end
+    local dest = (force_stderr or record.level >= Logger.LEVELS.ERROR) and io.stderr or io.stdout
+    dest:write(line .. "\n")
+    dest:flush()
+  end
+end
+
+--- FileHandler — appends log records to a file
+-- Options:
+--   path     (string, required) — path to the log file
+--   max_size (number, optional) — rotate when file exceeds this many bytes
+--   max_files(number, optional) — keep this many rotated files (default 5)
+local function FileHandler(opts)
+  assert(opts and opts.path, "FileHandler requires opts.path")
+  local path      = opts.path
+  local max_size  = opts.max_size   -- nil = never rotate
+  local max_files = opts.max_files or 5
+  local file
+
+  local function open_file()
+    file = assert(io.open(path, "a"), "Cannot open log file: " .. path)
+  end
+
+  local function rotate()
+    if file then file:close(); file = nil end
+    -- shift old files: .4 → .5, .3 → .4, …, .1 → .2, base → .1
+    for i = max_files - 1, 1, -1 do
+      os.rename(path .. "." .. i, path .. "." .. (i + 1))
+    end
+    os.rename(path, path .. ".1")
+    open_file()
+  end
+
+  open_file()
+
+  return function(record)
+    if not file then open_file() end
+    file:write(record.formatted .. "\n")
+    file:flush()
+    if max_size then
+      local pos = file:seek("cur")
+      if pos and pos >= max_size then rotate() end
+    end
+  end
+end
+
+--- MemoryHandler — stores records in a Lua table (useful for testing)
+-- Returns handler, get_records() function
+local function MemoryHandler(opts)
+  opts = opts or {}
+  local limit = opts.limit or 10000
+  local records = {}
+
+  local handler = function(record)
+    if #records >= limit then table.remove(records, 1) end
+    table.insert(records, record)
+  end
+
+  local function get_records() return records end
+  local function clear() records = {} end
+
+  return handler, get_records, clear
+end
+
+-- Expose built-ins
+Logger.handlers = {
+  ConsoleHandler = ConsoleHandler,
+  FileHandler    = FileHandler,
+  MemoryHandler  = MemoryHandler,
+}
+
+-- ── Formatter ─────────────────────────────────────────────────────────────
+-- Tokens in the format string:
+--   {time}    — timestamp
+--   {level}   — padded level name (5 chars)
+--   {name}    — logger name
+--   {message} — the log message
+
+local DEFAULT_FORMAT = "[{time}] [{level}] [{name}] {message}"
+
+local function escape_replacement(s)
+  -- In Lua's gsub, '%' in the replacement string is special; escape it.
+  return (s:gsub("%%", "%%%%"))
+end
+
+local function apply_format(fmt, record)
+  return (fmt
+    :gsub("{time}",    escape_replacement(record.time))
+    :gsub("{level}",   escape_replacement(pad(record.level_name, 5)))
+    :gsub("{name}",    escape_replacement(record.name))
+    :gsub("{message}", escape_replacement(record.message)))
+end
+
+-- ── Logger constructor ─────────────────────────────────────────────────────
+
+--- Create a new logger instance.
+-- @param name    string   — logger name shown in output
+-- @param opts    table    — optional configuration:
+--   level    (number)  — minimum level, default INFO
+--   format   (string)  — format string, default DEFAULT_FORMAT
+--   handlers (table)   — list of handler functions; defaults to ConsoleHandler
+function Logger.new(name, opts)
+  opts = opts or {}
+  local self = setmetatable({}, Logger)
+  self.name      = name or "root"
+  self.level     = opts.level   or Logger.LEVELS.INFO
+  self.format    = opts.format  or DEFAULT_FORMAT
+  self._handlers = opts.handlers or { ConsoleHandler() }
+  self._filters  = {}   -- list of predicate functions
+  return self
+end
+
+-- ── Configuration API ──────────────────────────────────────────────────────
+
+--- Set the minimum log level (Logger.LEVELS.*)
+function Logger:set_level(level)
+  assert(type(level) == "number", "level must be a number from Logger.LEVELS")
+  self.level = level
+  return self
+end
+
+--- Add a handler function
+function Logger:add_handler(handler)
+  table.insert(self._handlers, handler)
+  return self
+end
+
+--- Remove all handlers and replace with the given ones
+function Logger:set_handlers(handlers)
+  self._handlers = handlers
+  return self
+end
+
+--- Add a filter predicate — a function(record) → bool
+-- If ANY filter returns false the record is dropped.
+function Logger:add_filter(fn)
+  table.insert(self._filters, fn)
+  return self
+end
+
+--- Set the output format string
+function Logger:set_format(fmt)
+  self.format = fmt
+  return self
+end
+
+-- ── Core emit logic ────────────────────────────────────────────────────────
+
+function Logger:_emit(level, fmt, ...)
+  if level < self.level then return end
+
+  local record = {
+    time       = timestamp(),
+    level      = level,
+    level_name = LEVEL_NAMES[level] or ("LVL" .. level),
+    name       = self.name,
+    message    = safe_format(fmt, ...),
+  }
+  record.formatted = apply_format(self.format, record)
+
+  -- run filters
+  for _, filter in ipairs(self._filters) do
+    if not filter(record) then return end
+  end
+
+  -- dispatch to handlers
+  for _, handler in ipairs(self._handlers) do
+    local ok, err = pcall(handler, record)
+    if not ok then
+      io.stderr:write("[logger] handler error: " .. tostring(err) .. "\n")
+    end
+  end
+end
+
+-- ── Convenience level methods ──────────────────────────────────────────────
+
+function Logger:trace(fmt, ...) self:_emit(Logger.LEVELS.TRACE, fmt, ...) end
+function Logger:debug(fmt, ...) self:_emit(Logger.LEVELS.DEBUG, fmt, ...) end
+function Logger:info (fmt, ...) self:_emit(Logger.LEVELS.INFO,  fmt, ...) end
+function Logger:warn (fmt, ...) self:_emit(Logger.LEVELS.WARN,  fmt, ...) end
+function Logger:error(fmt, ...) self:_emit(Logger.LEVELS.ERROR, fmt, ...) end
+function Logger:fatal(fmt, ...) self:_emit(Logger.LEVELS.FATAL, fmt, ...) end
+
+--- Log at a given numeric level
+function Logger:log(level, fmt, ...)
+  self:_emit(level, fmt, ...)
+end
+
+--- Returns true if the given level would be emitted
+function Logger:is_enabled(level)
+  return level >= self.level
+end
+
+-- ── Child loggers ──────────────────────────────────────────────────────────
+
+--- Create a child logger that inherits handlers/format but has its own name.
+function Logger:child(name, opts)
+  opts = opts or {}
+  return Logger.new(self.name .. "." .. name, {
+    level    = opts.level   or self.level,
+    format   = opts.format  or self.format,
+    handlers = opts.handlers or self._handlers,
+  })
+end
+
+-- ── Module-level root logger ───────────────────────────────────────────────
+
+Logger._root = Logger.new("root")
+
+--- Get / lazily create a named logger backed by the root's handlers.
+local _registry = {}
+function Logger.get(name)
+  if not _registry[name] then
+    _registry[name] = Logger._root:child(name)
+  end
+  return _registry[name]
+end
+
+return Logger

utils/love_file_handler.lua

@@ -0,0 +1,222 @@
+--- love_file_handler.lua — LÖVE2D file handler for logger.lua
+--
+-- Uses love.filesystem to write logs into LÖVE's save directory, which works
+-- correctly on every platform LÖVE supports (Windows, macOS, Linux, Android).
+--
+-- Requires:
+--   logger.lua     in the same directory (or on package.path)
+--   LÖVE2D 11.x+   (love.filesystem must be available)
+--
+-- Usage inside main.lua / conf.lua:
+--
+--   local Logger      = require("logger")
+--   local LoveHandler = require("love_file_handler")
+--
+--   local log = Logger.new("game", {
+--     handlers = {
+--       Logger.handlers.ConsoleHandler(),          -- print() fallback
+--       LoveHandler.new("logs/game.log"),          -- love.filesystem
+--     },
+--   })
+--
+--   function love.load()
+--     log:info("Game started — LÖVE %s", love.getVersion())
+--   end
+
+-- ── Sanity check ──────────────────────────────────────────────────────────
+
+assert(love and love.filesystem,
+  "love_file_handler requires the LÖVE2D runtime (love.filesystem)")
+
+-- ── Module table ──────────────────────────────────────────────────────────
+
+local LoveHandler = {}
+
+-- ── Helpers ───────────────────────────────────────────────────────────────
+
+--- Ensure every directory component in `path` exists.
+-- love.filesystem.createDirectory is recursive on LÖVE 11+.
+local function ensure_dir(path)
+  local dir = path:match("^(.*)/[^/]+$")
+  if dir and dir ~= "" then
+    love.filesystem.createDirectory(dir)
+  end
+end
+
+--- Return current file size in bytes, or 0 on error / missing file.
+local function file_size(path)
+  local info = love.filesystem.getInfo(path)
+  return info and info.size or 0
+end
+
+--- Shift rotated files: .4→.5, .3→.4, …, base→.1
+local function rotate(path, max_files)
+  for i = max_files - 1, 1, -1 do
+    local src  = path .. "." .. i
+    local dest = path .. "." .. (i + 1)
+    if love.filesystem.getInfo(src) then
+      -- love.filesystem has no rename; copy + delete
+      local data = love.filesystem.read(src)
+      if data then
+        love.filesystem.write(dest, data)
+        love.filesystem.remove(src)
+      end
+    end
+  end
+  -- move base → .1
+  if love.filesystem.getInfo(path) then
+    local data = love.filesystem.read(path)
+    if data then
+      love.filesystem.write(path .. ".1", data)
+      love.filesystem.remove(path)
+    end
+  end
+end
+
+-- ── Constructor ───────────────────────────────────────────────────────────
+
+--- Create a new LÖVE2D file handler.
+--
+-- @param path      string   Path inside the LÖVE save directory.
+--                           Subdirectories are created automatically.
+--                           Default: "logs/game.log"
+--
+-- @param opts      table    Optional settings:
+--   max_size   (number)  Rotate when the log file reaches this many bytes.
+--                        Default: 1 MB (1 048 576). Set to 0 to disable.
+--   max_files  (number)  How many rotated files to keep. Default: 5.
+--   buffered   (bool)    Accumulate lines in memory and flush in batches.
+--                        Reduces I/O overhead on mobile / web exports.
+--                        Default: false.
+--   flush_size (number)  Lines to buffer before auto-flushing (buffered mode).
+--                        Default: 20.
+--   on_error   (func)    Called with (err_string) on any I/O error.
+--                        Default: prints a warning to love.graphics console.
+--
+-- @return  handler, control_table
+--   handler        — function accepted by Logger:add_handler()
+--   control        — table with :flush(), :close(), :path(), :size() methods
+function LoveHandler.new(path, opts)
+  path = path or "logs/game.log"
+  opts = opts or {}
+
+  local max_size   = (opts.max_size  == nil) and (1024 * 1024) or opts.max_size
+  local max_files  = opts.max_files  or 5
+  local buffered   = opts.buffered   or false
+  local flush_size = opts.flush_size or 20
+  local on_error   = opts.on_error   or function(err)
+    if love.graphics and love.graphics.print then
+      print("[love_file_handler] I/O error: " .. tostring(err))
+    end
+  end
+
+  -- State
+  local buffer   = {}   -- pending lines (buffered mode)
+  local closed   = false
+
+  ensure_dir(path)
+
+  -- ── Internal write ────────────────────────────────────────────────────
+
+  local function raw_write(lines)
+    if #lines == 0 then return end
+    local text = table.concat(lines, "\n") .. "\n"
+
+    -- Rotate if needed
+    if max_size and max_size > 0 and file_size(path) + #text >= max_size then
+      rotate(path, max_files)
+    end
+
+    -- Append
+    local ok, err = love.filesystem.append(path, text)
+    if not ok then
+      on_error(tostring(err))
+    end
+  end
+
+  -- ── Public control table ──────────────────────────────────────────────
+
+  local control = {}
+
+  --- Flush buffered lines to disk immediately.
+  function control:flush()
+    if #buffer > 0 then
+      raw_write(buffer)
+      buffer = {}
+    end
+  end
+
+  --- Close the handler (flushes first). After close() the handler is a no-op.
+  function control:close()
+    self:flush()
+    closed = true
+  end
+
+  --- Full path as seen by love.filesystem.
+  function control:path()
+    return path
+  end
+
+  --- Real filesystem path to the save directory file (for external tools).
+  function control:real_path()
+    local save_dir = love.filesystem.getSaveDirectory()
+    return save_dir .. "/" .. path
+  end
+
+  --- Current log file size in bytes.
+  function control:size()
+    return file_size(path)
+  end
+
+  --- List rotated files that exist (e.g. {"logs/game.log.1", ...})
+  function control:rotated_files()
+    local result = {}
+    for i = 1, max_files do
+      local p = path .. "." .. i
+      if love.filesystem.getInfo(p) then
+        table.insert(result, p)
+      end
+    end
+    return result
+  end
+
+  --- Read the entire current log file as a string (nil on error).
+  function control:read()
+    self:flush()
+    return love.filesystem.read(path)
+  end
+
+  -- ── Handler function ──────────────────────────────────────────────────
+
+  local function handler(record)
+    if closed then return end
+
+    if buffered then
+      table.insert(buffer, record.formatted)
+      if #buffer >= flush_size then
+        raw_write(buffer)
+        buffer = {}
+      end
+    else
+      raw_write({ record.formatted })
+    end
+  end
+
+  return handler, control
+end
+
+-- ── Convenience: hook love.quit to flush ──────────────────────────────────
+
+--- Wrap love.quit so a control table's flush() is called automatically.
+-- Call once per handler after Logger.new(); safe to call multiple times.
+--
+-- @param control   The control table returned by LoveHandler.new()
+function LoveHandler.auto_flush_on_quit(control)
+  local original_quit = love.quit or function() end
+  love.quit = function()
+    control:flush()
+    return original_quit()
+  end
+end
+
+return LoveHandler

utils/utils.lua

@@ -0,0 +1,134 @@
+local gui = require("gui")
+local color = require("gui.core.color")
+local multi, thread = require("multi"):init()
+
+local function startTimer(opt)
+    local default = {
+        duration = 30,
+        autoText = true,
+        autoColor = true,
+        autoCleanup = false,
+        startColor = color.green,
+        textColor = color.black,
+        warnColor = color.yellow,
+        timeColor = color.red,
+        finegrained = false,
+        visibility = 1
+    }
+
+    if type(opt) == "number" then
+        local d = opt
+        opt = default
+        opt.duration = d
+    elseif type(opt) ~= "table" then
+        opt = default
+    else
+        for i, v in pairs(opt) do
+            default[i] = v
+        end
+        opt = default
+    end
+
+    local timeRemaining = opt.duration or 30
+
+    local tpie = gui:newFrame():makeArc("pie", -200, 0, 100, 1, 0, 0, 1.5*math.pi, 3.5*math.pi, 360)
+    local tlabel = tpie:newTextLabel("")
+    tlabel.textColor = opt.textColor
+    tlabel.align = gui.ALIGN_CENTER
+    tlabel:fullFrame()
+    tlabel.visibility = 0
+    tpie.color = opt.startColor
+    tpie.visibility = opt.visibility
+
+    local tm
+    local stopped = false
+    local onTimeConn = multi:newConnection()
+    local onStopConn = multi:newConnection()
+
+    local function cleanup()
+        if stopped then return end
+        stopped = true
+        if onTimeConn and not onTimeConn.destroyed then
+            onTimeConn:Destroy()
+        end
+        if not tpie.destroyed then
+            tpie:destroy()
+        end
+    end
+
+    local timerThread = thread:newThread("Pie Timer", function()
+        local startTime = love.timer.getTime()
+        local lastSecond = timeRemaining
+
+        while not stopped do
+            thread.sleep(1/60)
+
+            local now = love.timer.getTime()
+            local elapsed = now - startTime
+            local t = math.min(elapsed, timeRemaining)
+            local num = timeRemaining - math.floor(t)
+            local p = 3.5 - (t / timeRemaining) * 2
+
+            if opt.autoColor then
+                tpie.color = opt.startColor
+                if num <= timeRemaining / 3 then
+                    tpie.color = opt.timeColor
+                elseif num <= timeRemaining / 2 then
+                    tpie.color = opt.warnColor
+                end
+            end
+
+            tpie:makeArc("pie", -200, 0, 100, 1, 0, 0, 1.5*math.pi, p*math.pi, 360)
+
+            if opt.autoText then
+                tlabel.text = num
+                tlabel:fitFont(nil, nil, {scale=1/2})
+                tlabel:centerFont()
+            end
+
+            if opt.finegrained then
+                onTimeConn:Fire(tm, num, t)
+            elseif num < lastSecond then
+                -- crossed a second boundary
+                lastSecond = num
+                onTimeConn:Fire(tm, num, t)
+            end
+
+            if elapsed >= timeRemaining then
+                break
+            end
+        end
+
+        -- Timer finished
+        if stopped then return end
+
+        if opt.autoText then
+            tlabel.text = "Time"
+            tlabel:fitFont(nil, nil, {scale=1/2})
+            tlabel:centerFont()
+        end
+        tpie:makeArc("pie", -200, 0, 100, 1, 0, 0, 1.5*math.pi, 3.5*math.pi, 360)
+
+        local onStop = onStopConn
+        cleanup()
+        onStop:Fire(tm)
+    end)
+
+    tm = {
+        Duration = timeRemaining,
+        OnTime = onTimeConn,
+        OnStop = onStopConn,
+        SetText = function(str) tlabel.text = str end,
+        SetColor = function(c) tpie.color = c end,
+        Cleanup = function()
+            timerThread:Kill()
+            cleanup()
+        end,
+    }
+
+    return tm
+end
+
+return {
+    startTimer = startTimer
+}

version.txt

@@ -1 +1 @@
-1.0.1
+1.0.2