moved zoom into base templates, fixed performance and memory issues

.luarc.json

@@ -0,0 +1,11 @@
+{
+    "$schema": "https://raw.githubusercontent.com/sumneko/vscode-lua/master/setting/schema.json",
+    "runtime.version": "LuaJIT",
+    "diagnostics.globals": [
+        "love"
+    ],
+    "workspace.library": [
+        "${3rd}/love2d/library"
+    ],
+    "workspace.checkThirdParty": false
+}

.vscode/extensions.json

@@ -0,0 +1,5 @@
+{
+  "recommendations":
+    ["tomblind.local-lua-debugger-vscode",
+    "sumneko.lua",]
+}

.vscode/launch.json

@@ -0,0 +1,28 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "type": "lua-local",
+      "request": "launch",
+      "name": "Debug",
+      "program": {
+        "command": "love"
+      },
+      "args": [
+        ".",
+        "debug"
+      ],
+    },
+    {
+      "type": "lua-local",
+      "request": "launch",
+      "name": "Release",
+      "program": {
+        "command": "love"
+      },
+      "args": [
+        ".",
+      ],
+    },
+  ]
+}

.vscode/tasks.json

@@ -0,0 +1,12 @@
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "Build with LÖVE-Build",
+      "type": "shell",
+      "command": "love-build", // Path to Love-build
+      "args": [".main.lua"],
+      "group": "build",
+    }
+  ]
+}

README.md

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

build.lua

@@ -0,0 +1,17 @@
+return {
+  -- basic settings:
+  name = 'Jeopardy', -- name of the game for your executable
+  developer = 'Ryan Ward', -- dev name used in metadata of the file
+  output = 'bin', -- output location for your game, defaults to $SAVE_DIRECTORY
+  version = '1.0.2', -- 'version' of your game, used to name the folder in output
+  love = '11.5', -- version of LÖVE to use, must match github releases
+  ignore = {'bin', 'love', 'server_test', '.gitignore', '.gitmodules', 'build.lua', 'login_dialog.yaml', 'package.bat', 'README.md'}, -- folders/files to ignore in your project
+  icon = 'assets/icon.png', -- 256x256px PNG icon for game, will be converted for you
+  
+  -- optional settings:
+  use32bit = false, -- set true to build windows 32-bit as well as 64-bit
+  identifier = 'net.ddns.epicknex.jeopardy', -- macos team identifier, defaults to game.developer.name
+  libs = {},
+  hooks = {},
+  platforms = {'windows', --[['macos', 'linux', 'steamdeck']]} -- set if you only want to build for a specific platform
+}

login_dialog.yaml

@@ -1,59 +0,0 @@
-# login_dialog.yaml
-type: frame
-x: 0
-y: 0
-scale-size: [0.4, 0.25]
-scale-pos:  [0.3, 0.2]
-color: "#1e1e2e"
-border-color: "#4a4a6a"
-roundness: 12
-
-children:
-  - type: label
-    text: "Sign In"
-    x: 0
-    y: 20
-    scale-size: [1.0, 0.0]
-    h: 48
-    align: center
-    font: 28
-    text-color: "#cdd6f4"
-
-  - type: textbox
-    x: 30
-    y: 90
-    scale-size: [0.85, 0.0]
-    h: 36
-    text: ""
-    color: "#313244"
-    border-color: "#6c7086"
-    text-color: "#cdd6f4"
-    font: 14
-    on-return: "focusPassword"
-
-  - type: textbox
-    x: 30
-    y: 140
-    scale-size: [0.85, 0.0]
-    h: 36
-    text: ""
-    color: "#313244"
-    border-color: "#6c7086"
-    text-color: "#cdd6f4"
-    font: 14
-    on-return: "submitLogin"
-
-  - type: button
-    text: "Log In"
-    align: "center"
-    fit-font: true
-    x: 30
-    y: 200
-    scale-size: [0.2, 0.0]
-    h: 40
-    color: "#89b4fa"
-    text-color: "#1e1e2e"
-    roundness: 8
-    on-pressed: "submitLogin"
-    on-enter: "highlightButton"
-    on-exit:  "unhighlightButton"

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,39 @@ gui:setHotKey({"f11"})(function()
 	love.window.setFullscreen(not fullscreen, "desktop")
 end)
 
+local loadLog = log:child("load")
 local old = multi.error
 
-multi.error = function(...)
-    old(...)
-    os.exit()
+multi.error = function(self, err)
+    loadLog:error("Error: %s", err)
+    loadLog:error(debug.traceback())
+    love.quit()
 end
 
 function love.load()
+    loadLog:info("Starting Jeopardy Game")
+    loadLog:debug("Setting game identity to jeopardy")
+    for i,v in ipairs(color.listColors(showAllColors)) do
+        loadLog:debug("Indexed color %s",v)
+    end
     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 timer = require("utils")
+local fmt = require("utils/fmt")
+local timer = require("utils/utils")
 local multi, thread = require("multi"):init()
 local menu = require("gui.core.menus")
 
@@ -19,30 +19,10 @@ local playerList = {}
 local playerStaticList = {}
 local scoreboard = {}
 
--- Create a table to manage GUI elements
-local manage = {}
+local boardLog = log:child("board")
 
 -- Function to resize fonts for all managed elements
-local function resizeFonts()
-    -- Use multi-threading to improve performance
-    multi:newThread(function()
-        -- Introduce a small delay to avoid too many iterations at once
-        thread.skip(2)
-        -- Iterate over each element in the 'manage' table
-        for i = 1, #manage do
-            local elem = manage[i]
-
-            -- Check if the current element has a centerFont property
-            if elem.centerFont then
-                -- Adjust font size and re-center the text
-                elem:fitFont(nil, nil, {scale = 2/3})
-                elem:centerFont()
-            end
-        end
-    end)
-end
-
-gui.Events.OnResized(resizeFonts)
+boardLog:debug("Creating resize fonts handler")
 
 local completed_questions = 0
 local min_questions = 0
@@ -87,6 +67,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 +78,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 +140,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 +151,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 +177,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 +200,7 @@ function Menu(frame, path)
     end
 
     -- Start the processors now
+    boardLog:debug("Starting processors")
     boardUpdater.Start()
     qUpdater.Start()
     scoreUpdater.Start()
@@ -230,17 +216,8 @@ function Menu(frame, path)
     label.color = color.bg
     label.textColor = color.status_font
     label:setRoundness(20,20,60)
-
-    boardUpdater:newThread(function()
-        local test = function()
-            return label.text ~= ""
-        end
-        while true do
-            thread.hold(test)
-            label:centerFont()
-            label:fitFont(nil, nil, {scale = 2/3})
-        end
-    end)
+    label:scaleFont(2/3)
+    label:centerFont()
 
     local data = loader:new(path)
     board, question, dailydouble = qframe:newFrame(), qframe:newFrame(), qframe:newImageLabel("assets/images/double.jpg")
@@ -314,7 +291,8 @@ function Menu(frame, path)
             img:fullFrame()
         end
 
-        table.insert(manage,c)
+        c:scaleFont(.25)
+        c:centerFont()
         
         for tier = 1,tiers do
             local t = board:newTextButton("$" .. start + inc*(tier-1),0,0,0,0,(1/#index.categories)*(cat-1),1/(tiers+1)*tier,(1/#index.categories),1/(tiers+1))
@@ -329,20 +307,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 +331,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
@@ -399,19 +378,16 @@ function Menu(frame, path)
                     boardUpdater:newThread("QuestionUpdater",function()
                         while true do
                             template.update(dt)
-                            thread.yield()
+                            thread.sleep(.1)
                             if self.text == "" then return end
                         end
                     end)
                 end)
             end))
-            table.insert(manage,t)
+            t:centerFont()
+            t:scaleFont(.5)
         end
     end
-
-    resizeFonts()
-    resizeFonts()
-
     return background
 end
 
@@ -450,19 +426,33 @@ end
 
 function ScoreBoard(frame, x, y, w, h, sx, sy, sw, sh)
     -- Colors
-    local C_BG_PANEL   = color.new("#1a1a2e")
-    local C_BG_HEADER  = color.new("#16213e")
-    local C_ACCENT     = color.new("#e94560")
-    local C_ROW_TOP    = color.new("#1c2641")
-    local C_ROW_NORM   = color.new("#121226")
-    local C_BORDER_TOP = color.new("#323c6e")
-    local C_BORDER_NRM = color.new("#1c1c37")
-    local C_BAR_EMPTY  = color.new("#232341")
-    local C_TEXT_MUTED = color.new("#786e96")
-    local C_WHITE      = color.new("#ffffff")
-    local C_GOLD       = color.new("#ffd700")
-    local C_SILVER     = color.new("#C0C0C0")
-    local C_BRONZE     = color.new("#cd7f32")
+    color.indexColor("scoreboard_panel_bg", "#1a1a2e")
+    color.indexColor("scoreboard_header_bg", "#16213e")
+    color.indexColor("scoreboard_accent_color", "#e94560")
+    color.indexColor("scoreboard_row_top_bg", "#1c2641")
+    color.indexColor("scoreboard_row_norm_bg", "#121226")
+    color.indexColor("scoreboard_border_top_color", "#323c6e")
+    color.indexColor("scoreboard_border_nrm_color", "#1c1c37")
+    color.indexColor("scoreboard_bar_empty_color", "#232341")
+    color.indexColor("scoreboard_text_muted_color", "#786e96")
+    color.indexColor("scoreboard_pure_white", "#ffffff")
+    color.indexColor("scoreboard_precious_gold", "#ffd700")
+    color.indexColor("scoreboard_precious_silver", "#C0C0C0")
+    color.indexColor("scoreboard_precious_bronze", "#cd7f32")
+
+    local C_BG_PANEL   = color.scoreboard_panel_bg
+    local C_BG_HEADER  = color.scoreboard_header_bg
+    local C_ACCENT     = color.scoreboard_accent_color
+    local C_ROW_TOP    = color.scoreboard_row_top_bg
+    local C_ROW_NORM   = color.scoreboard_row_norm_bg
+    local C_BORDER_TOP = color.scoreboard_border_top_color
+    local C_BORDER_NRM = color.scoreboard_border_nrm_color
+    local C_BAR_EMPTY  = color.scoreboard_bar_empty_color
+    local C_TEXT_MUTED = color.scoreboard_text_muted_color
+    local C_WHITE      = color.scoreboard_pure_white
+    local C_GOLD       = color.scoreboard_precious_gold
+    local C_SILVER     = color.scoreboard_precious_silver
+    local C_BRONZE     = color.scoreboard_precious_bronze
 
     -- Config stuff
     local LEADER_HEIGHT_SCALE = .06
@@ -498,30 +488,16 @@ function ScoreBoard(frame, x, y, w, h, sx, sy, sw, sh)
         textColor = C_TEXT_MUTED,
     }, headernum, headerplayer, headerscore)
 
-    local updateList = {header, headernum, headerplayer, headerscore}
-   
-    local function ScoreResize()
-        scoreUpdater:newThread(function()
-            thread.skip(2)
-
-            for _,object in pairs(updateList) do
-                object:fitFont(nil, nil, {scale = 5/6})
-                object:centerFont()
-            end
-
-            for _,object in pairs(playerList) do
-                if type(object) == "table" and object.Ref then
-                    for i, player in pairs(object.Ref) do
-                        if player:hasType(gui.TYPE_TEXT) then
-                            player:fitFont(nil, nil, {scale = 5/6})
-                            player:centerFont()
-                        end
-                    end
-                end
-            end
-        end)
-    end
+    local updateList = {headernum, headerplayer, headerscore}
     
+    header:centerFont()
+    header:scaleFont(2/3)
+
+    for _,object in pairs(updateList) do
+        object:fitFont(nil, nil, {scale = 5/6})
+        object:centerFont()
+    end
+
     function scoreboard:AddPlayer(name, score, icon)
         local player = {
             Name = name, 
@@ -537,13 +513,11 @@ function ScoreBoard(frame, x, y, w, h, sx, sy, sw, sh)
                     return tonumber(a.Score) > tonumber(b.Score)
                 end)
                 scoreboard:RenderPlayer(playerList)
-                ScoreResize()
             end,
         }
         table.insert(playerList, player)
         table.insert(playerStaticList, player)
         scoreboard:RenderPlayer(playerList)
-        ScoreResize()
         return player
     end
 
@@ -562,14 +536,7 @@ function ScoreBoard(frame, x, y, w, h, sx, sy, sw, sh)
     remove_player:setFont(20)
     remove_player.align = gui.ALIGN_CENTER
     local embededWatch = {remove_player}
-    scoreUpdater:newThread(function()
-        while true do
-            thread.sleep(.01)
-            for i,v in pairs(embededWatch) do
-                v:centerFont()
-            end
-        end
-    end)
+    remove_player:centerFont()
 
     local function embedTextEdit(reference, default, but_text, callback)
         reference.color = C_BORDER_NRM
@@ -589,10 +556,9 @@ function ScoreBoard(frame, x, y, w, h, sx, sy, sw, sh)
         end)
         gui.apply({
             setFont = {20},
-            align = gui.ALIGN_CENTER
+            align = gui.ALIGN_CENTER,
+            centerFont = {},
         },textbox,button,reference)
-        table.insert(embededWatch,textbox)
-        table.insert(embededWatch,button)
     end
 
     remove_player.color = color.new("#a13a3a")
@@ -694,7 +660,9 @@ function ScoreBoard(frame, x, y, w, h, sx, sy, sw, sh)
                 gui.apply({
                     visibility = 0,
                     drawBorder = false,
-                    textColor = MapColor(index)
+                    textColor = MapColor(index),
+                    scaleFont = {5/6},
+                    centerFont = {}
                 },playernum, playerName, playerScore, playerIcon, playerLine)
 
                 player.Ref = {playerName, playerScore, playernum, playerIcon, playerLine, Frame = playerFrame}
@@ -702,8 +670,6 @@ function ScoreBoard(frame, x, y, w, h, sx, sy, sw, sh)
         end
     end
 
-    gui.Events.OnResized(ScoreResize)
-    ScoreResize()
     return scoreboard
 end
 

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
@@ -22,16 +25,9 @@ function Menu(frame)
     title.visibility = 0
     title.textColor = color.title_font
     title.drawBorder = false
+    title:centerFont()
 
-    proc:newThread(function()
-        local function enabled()
-            return background.visible
-        end
-        while true do
-            thread.hold(enabled)
-            title:centerFont()
-        end
-    end)
+    titleLog:debug("Creating font thread")
 
     local items = 0
     local MenuOption = function(str)
@@ -39,13 +35,10 @@ function Menu(frame)
         local text = item:newTextLabel(str)
         text:fullFrame()
         text.align = gui.ALIGN_CENTER
-        thread:newThread(function()
-            thread.skip(2)
-            text:fitFont(nil,nil,{scale = 1/2})
-            text:centerFont()
-            text.visibility = 0
-            text.textColor = color.new("#24269a")
-        end)
+        text:scaleFont(.4)
+        text:centerFont()
+        text.visibility = 0
+        text.textColor = color.new("#24269a")
         items = items + 1
         return item, text
     end
@@ -64,17 +57,21 @@ 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()
+    quit:OnReleased(function(self, x, y)
+        print("Quit Pressed",x,y,self:getAbsolutes())
+        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"

templates/imageword.lua

@@ -11,6 +11,7 @@ local function index(window, q, callback)
     label.textColor = color.white
     label.color = color.new("#363ac8")
     label.borderColor = color.new("#363ac8")
+    label:scaleFont(.075)
 
     if not q.imageA or q.imageA == "" then
         error("Missing 'imageA' field for question!")
@@ -49,7 +50,8 @@ local function index(window, q, callback)
     }, imageHolder, plusLabel, imageHolder2)
 
     window.apply({
-        fitFont={},
+        scaleFont={.7},
+        centerFont={},
         align=window.ALIGN_CENTER,
         OnReleased=function(self)
             if self.text == "Skip" then
@@ -62,7 +64,7 @@ local function index(window, q, callback)
 end
 
 local function update(dt)
-    label:fitFont()
+
 end
 
 return {

templates/multiplechoice.lua

@@ -23,7 +23,10 @@ local function index(window, q, callback)
     label.textColor = color.white
     label.color = color.new("#363ac8")
     label:setFont(50)
-    choices = window:newFrame(noOf(0,.3,1,.7))
+    label:centerFont()
+    label:scaleFont(2/3)
+
+    local choices = window:newFrame(noOf(0,.3,1,.7))
     choices.color = color.new("#363ac8")
     
     function choices:newChoice(choice, i)
@@ -52,9 +55,8 @@ local function index(window, q, callback)
         choiceText.textColor = color.white
         -- choiceText.align = window.ALIGN_CENTER
         choiceText:setFont(40)
-        table.insert(choiceList,choiceText)
+        choiceText:centerFont()
         table.insert(allBoxes,box)
-
     end
 
     for i,choice in pairs(q.choices) do
@@ -84,16 +86,7 @@ local function index(window, q, callback)
 end
 
 local function update(dt) -- time in seconds that has passed since
-    -- label:fitFont()
-    label:centerFont()
-    for _, obj in pairs(choiceList) do
-        obj:centerFont()
-        -- obj:fitFont(nil, nil, {scale = 2/3})
-    end
-    confirm:fitFont(nil, nil, {scale = 2/3})
-    confirm:centerFont()
-    -- print(box.parent:getAbsolutes())
-    -- print(box:getAbsolutes())
+
 end
 
 return {

templates/one-image.lua

@@ -16,6 +16,8 @@ local function index(window, q, callback)
     label.align = ALIGN_CENTER
     label.textColor = color.white
     label.color = color.new("#363ac8")
+    label:scaleFont(.5)
+    label:centerFont()
     if not q.image or q.image == "" then
         error("Missing 'image' field for question!")
     end
@@ -31,7 +33,8 @@ local function index(window, q, callback)
     local skip = window:newTextButton("Skip",0,-100,0,100,.25,1,.5)
     skip.color = color.new("#5d5d5d")
     window.apply({
-        fitFont={},
+        scaleFont={.7},
+        centerFont={},
         align=window.ALIGN_CENTER,
         OnReleased=function(self)
             if self.text == "Skip" then
@@ -47,7 +50,6 @@ local function update(dt) -- time in seconds that has passed since
     _,_,w,h = imageHolder.parent:getAbsolutes()
     local x,y,w,h = imageHolder:GetSizeAdjustedToAspectRatio(w,h)
     imageHolder:setDualDim(w,h,x,y)
-    label:fitFont()
 end
 
 return {

templates/whatis.lua

@@ -14,6 +14,8 @@ local function index(window, q, callback)
     label:fullFrame()
     label.textColor = color.white
     label.color = color.new("#363ac8")
+    label:centerFont()
+    label:scaleFont(.075)
     local correct = window:newTextButton("Correct",0,-200,0,100,0,1,.5)
     correct.color = color.new("#52b11b")
     local wrong = window:newTextButton("Wrong",0,-200,0,100,.5,1,.5)
@@ -21,7 +23,8 @@ local function index(window, q, callback)
     local skip = window:newTextButton("Skip",0,-100,0,100,.25,1,.5)
     skip.color = color.new("#5d5d5d")
     gui.apply({
-        fitFont={},
+        scaleFont={.7},
+        centerFont={},
         align=gui.ALIGN_CENTER,
         OnReleased=function(self)
             if self.text == "Skip" then
@@ -31,11 +34,10 @@ local function index(window, q, callback)
             callback(self.text == "Correct")
         end,
     },correct,wrong,skip)
-    label:setFont(60)
 end
 
 local function update(dt) -- time in seconds that has passed since
-    label:centerFont()
+    
 end
 
 return {

templates/whatvideo.lua

@@ -21,6 +21,8 @@ local function index(window, q, callback)
     label.align = ALIGN_CENTER
     label.textColor = color.white
     label.color = color.new("#363ac8")
+    label:centerFont()
+    label:scaleFont(.5)
     local holder = frame:newFrame(-300, -200, 600, 400, .5, .5)
     holder:centerX(true)
     holder:centerY(true)
@@ -38,7 +40,8 @@ local function index(window, q, callback)
     local skip = window:newTextButton("Skip",0,-100,0,100,.25,1,.5)
     skip.color = color.new("#5d5d5d")
     window.apply({
-        fitFont={},
+        scaleFont={.7},
+        centerFont={},
         align=window.ALIGN_CENTER,
         OnReleased=function(self)
             video:stop()
@@ -52,8 +55,7 @@ local function index(window, q, callback)
 end
 
 local function update(dt) -- time in seconds that has passed since
-    label:fitFont()
-    label:centerFont()
+    
 end
 
 return {

templates/zoom.lua

@@ -0,0 +1,98 @@
+--[[ Constants
+    * (all lua builtins that don't allow io/executing code)
+    color (interface)
+    gui (interface)
+    multi (interface bound to a processor) no thread module
+
+    callback true/false correct/wrong
+]]
+local label
+local imageHolder
+
+local function index(window, q, callback)
+    frame = window:newFrame(0,0,0,-200,0,.2,1,.8)
+    frame.visibility = 0
+    label = window:newTextLabel("     " ..q.title.. "     ",0,0,0,0,0,0,1,.2)
+    label.align = ALIGN_CENTER
+    label.textColor = color.white
+    label.color = color.new("#363ac8")
+    label:scaleFont(.5)
+    label:centerFont()
+	local errors = {}
+	
+	if type(q.zoom) ~= "string" and q.zoom ~= "" then
+		table.insert(errors, "Missing 'zoom' fiels for queston! Should be a path to an image.")
+	end
+	
+    if type(q.minzoom) ~= "string" and q.minzoom ~= "" then
+        table.insert(errors, "Missing 'minzoom' field for question! Should be a path to an image.")
+    end
+	
+	if type(q.fullimage) ~= "string" and q.fullimage ~= "" then
+        table.insert(errors, "Missing 'fullimage' field for question! Should be a path to an image.")
+    end
+	
+	local zooms = {q.zoom, q.minzoom, q.fullimage}
+	print(q.fullimage)
+	local index = 1
+	local mul = 1
+	
+    imageHolder = frame:newImageLabel(q.zoom)
+    imageHolder:setAspectSize(imageHolder.imageWidth,imageHolder.imageHeight)
+    imageHolder:centerX(true)
+    imageHolder:centerY(true)
+    imageHolder:setDualDim(0,0,imageHolder.imageWidth,imageHolder.imageHeight)
+	
+	imageHolder:OnEnter(function(self)
+		self:setShader(gui.SHADERS.glow)
+	end)
+	
+	imageHolder:OnExit(function(self)
+		self:setShader()
+	end)
+	
+	imageHolder:shaderTime(true)
+	
+	imageHolder:OnReleased(function()
+		index = index + 1
+		print(index)
+		if index == 2 then
+			mul = .5
+		elseif index == 3 then
+			mul = .25
+		else
+			index = 3
+		end
+		imageHolder:setImage(zooms[index])
+	end)
+	
+    local correct = window:newTextButton("Correct",0,-200,0,100,0,1,.5)
+    correct.color = color.new("#52b11b")
+    local wrong = window:newTextButton("Wrong",0,-200,0,100,.5,1,.5)
+    wrong.color = color.new("#bd2626")
+    local skip = window:newTextButton("Skip",0,-100,0,100,.25,1,.5)
+    skip.color = color.new("#5d5d5d")
+    window.apply({
+        scaleFont={.7},
+        centerFont={},
+        align=window.ALIGN_CENTER,
+        OnReleased=function(self)
+            if self.text == "Skip" then
+                callback()
+                return
+            end
+            callback(self.text == "Correct", mul)
+        end,
+    },correct,wrong,skip)
+end
+
+local function update(dt) -- time in seconds that has passed since
+    _,_,w,h = imageHolder.parent:getAbsolutes()
+    local x,y,w,h = imageHolder:GetSizeAdjustedToAspectRatio(w,h)
+    imageHolder:setDualDim(w,h,x,y)
+end
+
+return {
+    index = index,
+    update = update
+}

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