From af1d84cac7b4588c99d55186c4d28837ee632b3d Mon Sep 17 00:00:00 2001
From: RodrigoDornelles <rodrigo@dornelles.me>
Date: Tue, 16 Jul 2024 10:15:29 -0300
Subject: [PATCH 01/12] chore: optmize std.math.max

---
 src/lib/common/math.lua | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/lib/common/math.lua b/src/lib/common/math.lua
index 6f982fb..9f25e05 100644
--- a/src/lib/common/math.lua
+++ b/src/lib/common/math.lua
@@ -69,7 +69,7 @@ local function max(...)
     local value = nil
     local max_value = nil
     
-    if #args == 1 and type(args[1]) == "table" then
+    if #args == 1 then
         args = args[1]
     end
 

From d1015d08b52f4fc8249d94c45ea6fc729a0bb475 Mon Sep 17 00:00:00 2001
From: RodrigoDornelles <rodrigo@dornelles.me>
Date: Tue, 16 Jul 2024 10:15:58 -0300
Subject: [PATCH 02/12] fix: correction in fps_show ginga

---
 src/lib/ginga/main.lua | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/lib/ginga/main.lua b/src/lib/ginga/main.lua
index 2e7015f..b5d4600 100644
--- a/src/lib/ginga/main.lua
+++ b/src/lib/ginga/main.lua
@@ -154,7 +154,7 @@ local function setup(evt)
     game.width=w
     game.height=h
     game.fps_max = application.config and application.config.fps_max or 100
-    game.fps_show = application.config and application.config.fps_max or 0
+    game.fps_show = application.config and application.config.fps_show or 0
     fps_obj.drop_time = application.config and application.config.fps_time or 1
     fps_obj.drop_count = application.config and application.config.fps_drop or 2
     application.callbacks.init(std, game)

From db338553f5289c6ee187c2915c6cde0f4227df8d Mon Sep 17 00:00:00 2001
From: RodrigoDornelles <rodrigo@dornelles.me>
Date: Tue, 16 Jul 2024 10:18:49 -0300
Subject: [PATCH 03/12] chore: rename core ginga_html5 to html5_ginga #15

---
 src/cli/main.lua                              | 4 ++--
 src/lib/{ginga_html5 => html5_ginga}/main.ncl | 0
 2 files changed, 2 insertions(+), 2 deletions(-)
 rename src/lib/{ginga_html5 => html5_ginga}/main.ncl (100%)

diff --git a/src/cli/main.lua b/src/cli/main.lua
index 108375f..b4134a0 100644
--- a/src/cli/main.lua
+++ b/src/cli/main.lua
@@ -30,11 +30,11 @@ local core_list = {
             'src/lib/ginga/main.ncl'
         }
     },
-    ginga_html5={
+    html5_ginga={
         src='src/lib/html5/main.lua',
         post_exe='ginga dist/main.ncl -s '..screen,
         extras={
-            'src/lib/ginga_html5/main.ncl',
+            'src/lib/html5_ginga/main.ncl',
             'src/lib/html5/index.html',
             'src/lib/html5/index.html',
             'src/lib/html5/engine.js',
diff --git a/src/lib/ginga_html5/main.ncl b/src/lib/html5_ginga/main.ncl
similarity index 100%
rename from src/lib/ginga_html5/main.ncl
rename to src/lib/html5_ginga/main.ncl

From a91e9cec0faa6a5964550b3e21f8a12a98dd7d83 Mon Sep 17 00:00:00 2001
From: RodrigoDornelles <rodrigo@dornelles.me>
Date: Tue, 16 Jul 2024 10:34:40 -0300
Subject: [PATCH 04/12] docs: upgrade plataform support list

---
 SUPPORT.md | 40 ++++++++++++++++------------------------
 1 file changed, 16 insertions(+), 24 deletions(-)

diff --git a/SUPPORT.md b/SUPPORT.md
index e97b055..4dd5e12 100644
--- a/SUPPORT.md
+++ b/SUPPORT.md
@@ -1,27 +1,19 @@
 Platform Support List
 =====================
 
-Tier 1
-------
-
- - [X] [Ginga](https://github.com/TeleMidia/ginga)
- - [X] [Love2D](https://github.com/love2d/love)
- - [X] REPL
-
-Tier 2
-------
-
- - [ ] Browser
-
-Tier 3
-------
-
- - [ ] Curses
- - [ ] Console
-
-Mayable ???
----
-
- - Roblox
- - GameBoyAdvance
- - ESP32
+| core           | tier   | native | url |
+| :------------- | :----: | :----: | :-- |
+| ginga          | tier 1 | yes    | <https://github.com/TeleMidia/ginga>
+| love           | tier 1 | nos    | <https://github.com/love2d/love>
+| repl           | tier 1 | yes    |
+| curses         | tier ? | yes    |
+| html5          | tier 2 | no     |
+| html5_webos    | tier 2 | no     |
+| html5_tizen    | tier 2 | no     |
+| html5_ginga    | tier ? | no     |
+| esp32          | tier ? | yes    |
+| roblox         | tier ? | no     |
+| arkos          | tier ? | yes    |
+| odroid         | tier ? | yes    |
+| raylib         | tier ? | no     |
+| gameboyadvance | tier ? | yes    |

From 273f5e475801d1a3e1c83572fefafe1271ea80a1 Mon Sep 17 00:00:00 2001
From: RodrigoDornelles <rodrigo@dornelles.me>
Date: Wed, 17 Jul 2024 11:47:19 -0300
Subject: [PATCH 05/12] feat: add core htm5_webos and command meta

---
 src/cli/main.lua                 |  38 +++++++++++
 src/cli/meta.lua                 | 104 +++++++++++++++++++++++++++++++
 src/lib/html5/index.html         |   2 +-
 src/lib/html5_webos/appinfo.json |   9 +++
 src/lib/html5_webos/icon.png     | Bin 0 -> 8572 bytes
 src/object/application.lua       |   2 +
 6 files changed, 154 insertions(+), 1 deletion(-)
 create mode 100644 src/cli/meta.lua
 create mode 100644 src/lib/html5_webos/appinfo.json
 create mode 100644 src/lib/html5_webos/icon.png

diff --git a/src/cli/main.lua b/src/cli/main.lua
index b4134a0..ae385bb 100644
--- a/src/cli/main.lua
+++ b/src/cli/main.lua
@@ -1,5 +1,6 @@
 local os = require('os')
 local zeebo_args = require('src/shared/args')
+local zeebo_meta = require('src/cli/meta')
 local zeebo_fs = require('src/cli/fs')
 
 --! @cond
@@ -30,9 +31,26 @@ local core_list = {
             'src/lib/ginga/main.ncl'
         }
     },
+    html5_webos={
+        src='src/lib/html5/main.lua',
+        post_exe='webos24 $(pwd)/dist',
+        pipeline={
+            zeebo_meta.late(game):file(dist..'index.html'):file(dist..'appinfo.json'):pipe()
+        },
+        extras={
+            'src/lib/html5_webos/appinfo.json',
+            'src/lib/html5_webos/icon.png',
+            'src/lib/html5/index.html',
+            'src/lib/html5/index.html',
+            'src/lib/html5/engine.js',
+        }
+    },
     html5_ginga={
         src='src/lib/html5/main.lua',
         post_exe='ginga dist/main.ncl -s '..screen,
+        pipeline={
+            zeebo_meta.late(game):file(dist..'index.html'):pipe()
+        },
         extras={
             'src/lib/html5_ginga/main.ncl',
             'src/lib/html5/index.html',
@@ -42,6 +60,9 @@ local core_list = {
     },
     html5={
         src='src/lib/html5/main.lua',
+        pipeline={
+            zeebo_meta.late(game):file(dist..'index.html'):pipe()
+        },
         extras={
             'src/lib/html5/index.html',
             'src/lib/html5/engine.js'
@@ -57,6 +78,11 @@ if command == 'run' then
     os.exit(os.execute(core_list[core].exe) and 0 or 1)
 elseif command == 'clear' then
     zeebo_fs.clear(dist)
+elseif command == 'meta' then
+    if core == 'ginga' then
+        core = '{{title}} {{version}}'
+    end
+    zeebo_meta.current(game):stdout(core):run()
 elseif command == 'bundler' then
     local path, file = game:match("(.-)([^/\\]+)$")
     zeebo_fs.bundler(path, file, dist..file)
@@ -116,6 +142,18 @@ elseif command == 'build' then
         zeebo_fs.clear(dist..bundler)
     end
 
+    -- post process
+    if core.pipeline then
+        local index = 1
+        while index <= #core.pipeline do
+            local eval = core.pipeline[index]
+            while type(eval) == 'function' do
+                eval = eval()
+            end
+            index = index + 1
+        end
+    end
+
     if run then
         if not core.post_exe then
             print('this core cannot be runned after build!')
diff --git a/src/cli/meta.lua b/src/cli/meta.lua
new file mode 100644
index 0000000..db86fbd
--- /dev/null
+++ b/src/cli/meta.lua
@@ -0,0 +1,104 @@
+local application_default = require('src/object/application')
+
+local function replace(src, meta, default)
+    if src and #src > 0 then
+        return (src
+            :gsub('{{id}}', meta.id or default.id)
+            :gsub('{{title}}', meta.title or default.title)
+            :gsub('{{company}}', meta.title or default.company)
+            :gsub('{{version}}', meta.version or default.version)
+            :gsub('{{description}}', meta.description or default.description)
+        )
+    end
+    return ''
+end
+
+local function file(self, file)
+    local file_copy = string.format("%s", file)
+    self.pipeline[#self.pipeline + 1] = function()
+        if not self.loaded then return self end
+
+        local file_meta = io.open(file_copy, 'r')
+        local file_temp = io.open(file_copy..'.tmp', 'w')
+
+        repeat
+            local line = file_meta:read()
+            file_temp:write(replace(line, self.meta, application_default.meta), '\n')
+        until not line
+
+        file_meta:close()
+        file_temp:close()
+
+        os.remove(file_copy)
+        os.rename(file_copy..'.tmp', file_copy) 
+    end
+    return self
+end
+
+local function stdout(self, format)
+    local format_copy = string.format("%s", format)
+    if format_copy == 'json' then
+        format_copy = '{"id":"{{id}}","title":"{{title}}","company":"{{company}}",'
+        format_copy = format_copy..'"version":"{{version}}","description":"{{description}}"}'
+    end
+    self.pipeline[#self.pipeline + 1] = function()
+        if not self.loaded then return self end
+        print(replace(format_copy, self.meta, application_default.meta))
+    end
+    return self
+end
+
+local function pipe(self)
+    return function()
+        self:run()
+    end
+end
+
+local function run(self)
+    local index = 1
+    while index <= #self.pipeline do
+        self.pipeline[index]()
+        index = index + 1
+    end
+    return self
+end
+
+local function current(game, application)
+    local metadata = game and #game > 0 and dofile(game)
+
+    if not application then
+        application = {
+            meta = application_default.meta,
+            pipeline={},
+            file=file,
+            stdout=stdout,
+            pipe=pipe,
+            run=run
+        }
+    end
+
+    if metadata then
+        application.loaded = true
+        application.meta = metadata.meta
+    end
+
+    return application
+end
+
+local function late(game)
+    local game_copy = string.format("%s", game)
+    local application = current()
+    local eval = application.run
+    application.run = function()
+        current(game_copy, application)
+        eval(application)
+    end
+    return application
+end
+
+local P = {
+    current = current,
+    late = late
+}
+
+return P
diff --git a/src/lib/html5/index.html b/src/lib/html5/index.html
index e84cca2..b79c9e9 100644
--- a/src/lib/html5/index.html
+++ b/src/lib/html5/index.html
@@ -1,7 +1,7 @@
 <!DOCTYPE html>
 <html lang="en">
   <head>
-    <title>Lua Engine</title>
+    <title>{{title}} - {{version}}</title>
     <link rel="icon" type="image/x-icon" href="favicon.ico">
     <meta name="theme-color" content="#000000"/>
     <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0">
diff --git a/src/lib/html5_webos/appinfo.json b/src/lib/html5_webos/appinfo.json
new file mode 100644
index 0000000..2979134
--- /dev/null
+++ b/src/lib/html5_webos/appinfo.json
@@ -0,0 +1,9 @@
+{
+    "id": "{{id}}",
+    "version": "{{version}}",
+    "vendor": "{{company}}",
+    "type": "web",
+    "main": "index.html",
+    "title": "{{title}}",
+    "icon": "icon.png"
+}
diff --git a/src/lib/html5_webos/icon.png b/src/lib/html5_webos/icon.png
new file mode 100644
index 0000000000000000000000000000000000000000..c1742ede0e2d5bcff3b46d234e58806b588c2fc0
GIT binary patch
literal 8572
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
CuaWNn

literal 0
HcmV?d00001

diff --git a/src/object/application.lua b/src/object/application.lua
index 9dda146..aa43836 100644
--- a/src/object/application.lua
+++ b/src/object/application.lua
@@ -4,7 +4,9 @@
 
 local P = {
     meta={
+        id='',
         title='',
+        company='',
         description='',
         version=''
     },

From 245967c52daa8339bad0d8f40a95b6b2e7f1bc27 Mon Sep 17 00:00:00 2001
From: RodrigoDornelles <rodrigo@dornelles.me>
Date: Wed, 17 Jul 2024 12:08:24 -0300
Subject: [PATCH 06/12] chore: small improves in repo

---
 .gitattributes           | 4 ++++
 .gitignore               | 3 ++-
 src/cli/main.lua         | 2 +-
 src/cli/meta.lua         | 2 +-
 src/lib/html5/index.html | 6 ++++++
 5 files changed, 14 insertions(+), 3 deletions(-)
 create mode 100644 .gitattributes

diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000..6146740
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,4 @@
+*.html linguist-generated
+*.css linguist-generated
+*.sh linguist-generated
+*.bat linguist-generated
diff --git a/.gitignore b/.gitignore
index 4f1656b..8831805 100644
--- a/.gitignore
+++ b/.gitignore
@@ -2,4 +2,5 @@ luacov.*
 vendor/
 dist/
 html/
-latex/
\ No newline at end of file
+latex/
+.out
\ No newline at end of file
diff --git a/src/cli/main.lua b/src/cli/main.lua
index ae385bb..0267816 100644
--- a/src/cli/main.lua
+++ b/src/cli/main.lua
@@ -157,7 +157,7 @@ elseif command == 'build' then
     if run then
         if not core.post_exe then
             print('this core cannot be runned after build!')
-            exit(1)
+            os.exit(1)
         end
         os.exit(os.execute(core.post_exe) and 0 or 1)
     end
diff --git a/src/cli/meta.lua b/src/cli/meta.lua
index db86fbd..7883bcf 100644
--- a/src/cli/meta.lua
+++ b/src/cli/meta.lua
@@ -5,7 +5,7 @@ local function replace(src, meta, default)
         return (src
             :gsub('{{id}}', meta.id or default.id)
             :gsub('{{title}}', meta.title or default.title)
-            :gsub('{{company}}', meta.title or default.company)
+            :gsub('{{company}}', meta.company or default.company)
             :gsub('{{version}}', meta.version or default.version)
             :gsub('{{description}}', meta.description or default.description)
         )
diff --git a/src/lib/html5/index.html b/src/lib/html5/index.html
index b79c9e9..8773e80 100644
--- a/src/lib/html5/index.html
+++ b/src/lib/html5/index.html
@@ -4,6 +4,12 @@
     <title>{{title}} - {{version}}</title>
     <link rel="icon" type="image/x-icon" href="favicon.ico">
     <meta name="theme-color" content="#000000"/>
+    <meta name="description" content="{{description}}"/>
+    <meta property="og:type" content="website" />
+    <meta property="og:title" content="{{title}}" />
+    <meta property="og:description" content="{{description}}"/>
+    <meta property="twitter:title" content="{{title}}" />
+    <meta property="twitter:description" content="{{description}}" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0">
     <style>
         *, *::after, *::before {

From 2888b5b69ebdcd246859e7356ca0db1b0ce91d8f Mon Sep 17 00:00:00 2001
From: RodrigoDornelles <rodrigo@dornelles.me>
Date: Wed, 17 Jul 2024 16:46:37 -0300
Subject: [PATCH 07/12] docs: std math

---
 src/lib/common/math.lua | 203 ++++++++++++++++++++++++++++++++++------
 1 file changed, 173 insertions(+), 30 deletions(-)

diff --git a/src/lib/common/math.lua b/src/lib/common/math.lua
index 9f25e05..de6cb10 100644
--- a/src/lib/common/math.lua
+++ b/src/lib/common/math.lua
@@ -3,6 +3,30 @@
 --! @defgroup math
 --! @{
 
+--! @short abs module
+--! @par Equation
+--! @f$ |value| @f$
+--! @param[in] value
+--! @return number
+local function abs(value)
+    if value < 0 then
+        return -value
+    end
+    return value
+end
+
+--! @short clamp
+--! @par Equation
+--! @f$
+--! \begin{cases} 
+--! value\_min, & \text{if } value \gt value\_min \\
+--! value\_max, & \text{if } value \lt value\_max \\
+--! value, & \text{if } value\_min \lt value \lt value\_max 
+--! \end{cases}
+--! @f$
+--! @param[in] value The value to clamp.
+--! @param[in] value_min The minimum value that value can be clamped to.
+--! @param[in] value_max The maximum value that value can be clamped to.
 local function clamp(value, value_min, value_max)
     if value < value_min then
         return value_min
@@ -13,6 +37,56 @@ local function clamp(value, value_min, value_max)
     end
 end
 
+--! @short clamp
+--! @note similar to @ref clamp but cyclical.
+--! @par Equation
+--! @f$
+--! (value - value\_min) \mod (value\_max - value\_min + 1) + value\_min
+--! @f$
+--! @param[in] value The value to clamp.
+--! @param[in] value_min The minimum value that value can be clamped to.
+--! @param[in] value_max The maximum value that value can be clamped to.
+local function clamp2(value, value_min, value_max)
+    return (value - value_min) % (value_max - value_min + 1) + value_min
+end
+
+--! @short periodic cycle
+--! @par Equation
+--! @f$
+--! \begin{cases} 
+--! \frac{passed \mod duration}{duration}, & \text{if } (passed \mod duration \neq 0) \\
+--! \frac{passed \mod (2 \times duration)}{duration}, & \text{if } (passed \mod duration = 0)
+--! \end{cases}
+--! @f$
+--! @param[in] passed
+--! @param[in] duration
+--! @retval 0 start of period
+--! @retval 0.5 middle of period
+--! @retval 1 end of period
+--! @par Example
+--! @code
+--! local anim = std.math.cycle(game.millis, 1000) * 5
+--! std.draw.text(x, y + anim, 'hello!')
+--! @endcode
+local function cycle(passed, duration)
+    local endtime = (passed) % duration
+    return ((endtime == 0 and (passed % (duration * 2)) or endtime)) / duration
+end
+
+--! @short direction
+--! @par Equation
+--! @f$
+--! \begin{cases}
+--! -1, & \text{if } |value| \gt \alpha \land value \lt 0 \\
+--! 1, & \text{if } |value| \gt \alpha \land value \gt 0 \\
+--! 0, & \text{if } |value| \leq \alpha
+--! \end{cases}
+--! @f$
+--! @param[in] value
+--! @param[in] alpha @c default=0
+--! @retval -1 less than alpha
+--! @retval 0 when in alpha
+--! @retval 1 greater than alpha
 local function dir(value, alpha)
     alpha = alpha or 0
     if value < -alpha then
@@ -24,45 +98,67 @@ local function dir(value, alpha)
     end
 end
 
+--! @brief euclidean distance
+--! @par Equation
+--! @f$
+--! \sqrt{(x_2 - x_1)^2 + (y_2 - y_1)^2}
+--! @f$
+--! @param[in] x1 The x coordinate of the first point.
+--! @param[in] y1 The y coordinate of the first point.
+--! @param[in] x2 The x coordinate of the second point.
+--! @param[in] y2 The y coordinate of the second point.
+--! @return distance between the two points (x1, y1) and (x2, y2).
 local function dis(x1,y1,x2,y2)
     return ((x2 - x1) ^ 2 + (y2 - y1) ^ 2) ^ 0.5
 end
 
-local function abs(value)
-    if value < 0 then
-        return -value
-    end
-    return value
-end
-
-local function saw(value)
-    if value < 0.25 then
-        return value * 4
-    elseif value < 0.50 then
-        return 1 - ((value - 0.25) * 4)
-    elseif value < 0.75 then
-        return ((value - 0.50) * 4) * (-1)
-    end
-    return ((value - 0.75) * 4) - 1
+--! @brief quadratic distance
+--! @note this is an optimization of @ref dis but it cannot be used to calculate collisions.
+--! @par Equation
+--! @f$
+--! (x_2 - x_1)^2 + (y_2 - y_1)^2
+--! @f$
+--! @param[in] x1 The x coordinate of the first point.
+--! @param[in] y1 The y coordinate of the first point.
+--! @param[in] x2 The x coordinate of the second point.
+--! @param[in] y2 The y coordinate of the second point.
+--! @return distance between the two points (x1, y1) and (x2, y2).
+local function dis2(x1,y1,x2,y2)
+    return (x2 - x1) ^ 2 + (y2 - y1) ^ 2
 end
 
+--! @brief linear interpolation
+--! @par Equation
+--! @f$
+--! a + \alpha \cdot (b - a)
+--! @f$
+--! @param[in] a The starting value
+--! @param[in] b The ending value
+--! @param[in] alpha The interpolation parameter, typically in the range [0, 1].
+--! @return The interpolated value between 'a' and 'b' based on 'alpha'.
 local function lerp(a, b, alpha)
     return a + alpha * ( b - a )
 end 
 
+--! @brief re-maps
+--! @li <https://www.arduino.cc/reference/en/language/functions/math/map>
+--!
+--! @par Equation
+--! @f$
+--! (value - in\_min) \cdot \frac{(out\_max - out\_min)}{(in\_max - in\_min)} + out\_min
+--! @f$
+--! @param[in] value The value to be mapped from the input range to the output range.
+--! @param[in] in_min The minimum value of the input range.
+--! @param[in] in_max The maximum value of the input range.
+--! @param[in] out_min The minimum value of the output range.
+--! @param[in] out_max The maximum value of the output range.
+--! @return The mapped value in the output range corresponding to 'value' in the input range.
 local function map(value, in_min, in_max, out_min, out_max)
     return (value - in_min) * (out_max - out_min) / (in_max - in_min) + out_min
 end
 
-local function clamp2(value, value_min, value_max)
-    return (value - value_min) % (value_max - value_min + 1) + value_min
-end
-
-local function cycle(passed, duration)
-    local endtime = (passed) % duration
-    return ((endtime == 0 and (passed % (duration * 2)) or endtime)) / duration
-end
-
+--! @shor maximum
+--! @todo document this
 local function max(...)
     local args = {...}
     local index = 1
@@ -84,20 +180,67 @@ local function max(...)
     return max_value
 end
 
+--! @short minimum
+--! @todo document this
+local function min(...)
+    local args = {...}
+    local index = 1
+    local value = nil
+    local min_value = nil
+    
+    if #args == 1 then
+        args = args[1]
+    end
+
+    while index <= #args do
+        value = args[index]
+        if min_value == nil or value < min_value then
+            min_value = value
+        end
+        index = index + 1
+    end
+
+    return min_value
+end
+
+--! @brief sawtooth
+--! @todo document this
+--! @par Equation
+--! @f$
+--! \begin{cases}
+--! value \times 4, & \text{if } 0 \leq value < 0.25 \\
+--! 1 - ((value - 0.25) \times 4), & \text{if } 0.25 \leq value < 0.50 \\
+--! ((value - 0.50) \times 4) \times (-1), & \text{if } 0.50 \leq value < 0.75 \\
+--! ((value - 0.75) \times 4) - 1, & \text{if } 0.75 \leq value \leq 1 \\
+--! \end{cases}
+--! @f$
+local function saw(value)
+    if value < 0.25 then
+        return value * 4
+    elseif value < 0.50 then
+        return 1 - ((value - 0.25) * 4)
+    elseif value < 0.75 then
+        return ((value - 0.50) * 4) * (-1)
+    end
+    return ((value - 0.75) * 4) - 1
+end
+
 --! @}
 --! @}
 
 local P = {
-    cycle=cycle,
+    abs=abs,
     clamp=clamp,
     clamp2=clamp2,
+    cycle=cycle,
+    dir=dir,
+    dis=dis,
+    dis2=dis2,
     lerp=lerp,
-    abs=abs,
     map=map,
-    dis=dis,
-    saw=saw,
     max=max,
-    dir=dir
+    min=min,
+    saw=saw
 }
 
 return P;

From 2328c6df46943d1ea03e9b218d9e07a8756babc4 Mon Sep 17 00:00:00 2001
From: RodrigoDornelles <rodrigo@dornelles.me>
Date: Wed, 17 Jul 2024 16:47:30 -0300
Subject: [PATCH 08/12] docs: fix support in doxygen

---
 SUPPORT.md | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/SUPPORT.md b/SUPPORT.md
index 4dd5e12..c0c0bd3 100644
--- a/SUPPORT.md
+++ b/SUPPORT.md
@@ -5,15 +5,15 @@ Platform Support List
 | :------------- | :----: | :----: | :-- |
 | ginga          | tier 1 | yes    | <https://github.com/TeleMidia/ginga>
 | love           | tier 1 | nos    | <https://github.com/love2d/love>
-| repl           | tier 1 | yes    |
-| curses         | tier ? | yes    |
-| html5          | tier 2 | no     |
-| html5_webos    | tier 2 | no     |
-| html5_tizen    | tier 2 | no     |
-| html5_ginga    | tier ? | no     |
-| esp32          | tier ? | yes    |
-| roblox         | tier ? | no     |
-| arkos          | tier ? | yes    |
-| odroid         | tier ? | yes    |
-| raylib         | tier ? | no     |
-| gameboyadvance | tier ? | yes    |
+| repl           | tier 1 | yes    | |
+| curses         | tier ? | yes    | |
+| html5          | tier 2 | no     | |
+| html5_webos    | tier 2 | no     | |
+| html5_tizen    | tier 2 | no     | |
+| html5_ginga    | tier ? | no     | |
+| esp32          | tier ? | yes    | |
+| roblox         | tier ? | no     | |
+| arkos          | tier ? | yes    | |
+| odroid         | tier ? | yes    | |
+| raylib         | tier ? | no     | |
+| gameboyadvance | tier ? | yes    | |

From a503bf7bc14403646befa242188afdec76b21eb7 Mon Sep 17 00:00:00 2001
From: RodrigoDornelles <rodrigo@dornelles.me>
Date: Wed, 17 Jul 2024 20:45:56 -0300
Subject: [PATCH 09/12] tests: improve command test-self

---
 src/cli/fs.lua   | 16 ++++++++++++++++
 src/cli/main.lua |  9 +++++++--
 2 files changed, 23 insertions(+), 2 deletions(-)

diff --git a/src/cli/fs.lua b/src/cli/fs.lua
index 5617f2a..ab324e3 100644
--- a/src/cli/fs.lua
+++ b/src/cli/fs.lua
@@ -1,3 +1,18 @@
+local function ls(src_path)
+    local ls_cmd = io.popen('ls -1 '..src_path)
+    local ls_files = {}
+
+    if ls_cmd then
+        repeat
+            local line = ls_cmd:read()
+            ls_files[#ls_files + 1] = line
+        until not line
+        ls_cmd:close()
+    end
+
+    return ls_files
+end
+
 local function clear(src_path)
     if os.execute('rm --version > /dev/null 2> /dev//null') then
         os.execute('mkdir -p '..src_path)
@@ -195,6 +210,7 @@ local function bundler(src_path, src_file, dest_file)
 end
 
 local P = {
+    ls = ls,
     move = move,
     moveLua = moveLua,
     bundler = bundler,
diff --git a/src/cli/main.lua b/src/cli/main.lua
index 0267816..07bef12 100644
--- a/src/cli/main.lua
+++ b/src/cli/main.lua
@@ -88,8 +88,13 @@ elseif command == 'bundler' then
     zeebo_fs.bundler(path, file, dist..file)
 elseif command == 'test-self' then
     coverage = coverage and '-lluacov' or ''
-    local ok = os.execute('lua '..coverage..' ./tests/test_lib_common_math.lua')
-    local ok = ok and os.execute('lua '..coverage..' ./tests/test_shared_args.lua')
+    local files = zeebo_fs.ls('./tests')
+    local index = 1
+    local ok = true
+    while index <= #files do
+        ok = ok and os.execute('lua '..coverage..' ./tests/'..files[index])
+        index = index + 1
+    end
     if #coverage > 0 then
         os.execute('luacov src')
     end

From 6a6bc43d679f8c3555ddef6c2b65ab6a81bb448a Mon Sep 17 00:00:00 2001
From: RodrigoDornelles <rodrigo@dornelles.me>
Date: Wed, 17 Jul 2024 21:19:36 -0300
Subject: [PATCH 10/12] tests: print coverage test-self

---
 src/cli/main.lua | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/cli/main.lua b/src/cli/main.lua
index 07bef12..f155cb2 100644
--- a/src/cli/main.lua
+++ b/src/cli/main.lua
@@ -97,6 +97,7 @@ elseif command == 'test-self' then
     end
     if #coverage > 0 then
         os.execute('luacov src')
+        os.execute('tail -n '..tostring(#files + 5)..' luacov.report.out')
     end
     if not ok then
         os.exit(1)

From 0719f396c513ed86a628bba32736dce5c866026d Mon Sep 17 00:00:00 2001
From: RodrigoDornelles <rodrigo@dornelles.me>
Date: Wed, 17 Jul 2024 21:22:36 -0300
Subject: [PATCH 11/12] tests: math min dist2

---
 tests/test_lib_common_math.lua | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/tests/test_lib_common_math.lua b/tests/test_lib_common_math.lua
index 3f02fcc..65863d0 100644
--- a/tests/test_lib_common_math.lua
+++ b/tests/test_lib_common_math.lua
@@ -17,6 +17,10 @@ function test_dis()
     luaunit.assertEquals(zeebo_math.dis(0, 0, 3, 4), 5)
 end
 
+function test_dis2()
+    luaunit.assertEquals(zeebo_math.dis2(0, 0, 3, 4), 25)
+end
+
 function test_abs()
     luaunit.assertEquals(zeebo_math.abs(-5), 5)
     luaunit.assertEquals(zeebo_math.abs(10), 10)
@@ -51,6 +55,13 @@ function test_cycle()
     luaunit.assertEquals(zeebo_math.cycle(15, 10), 0.5)
 end
 
+function test_min()
+    luaunit.assertEquals(zeebo_math.min(1, 2, 3, 4, 5), 1)
+    luaunit.assertEquals(zeebo_math.min(10, -5, 3, 0), -5)
+    luaunit.assertEquals(zeebo_math.min(-1, -2, -3), -3)
+    luaunit.assertEquals(zeebo_math.min({1, 2, 3, 4, 5}), 1)
+end
+
 function test_max()
     luaunit.assertEquals(zeebo_math.max(1, 2, 3, 4, 5), 5)
     luaunit.assertEquals(zeebo_math.max(10, -5, 3, 0), 10)

From ec5afc43de4490393f4343261adb7d0b7393905c Mon Sep 17 00:00:00 2001
From: RodrigoDornelles <rodrigo@dornelles.me>
Date: Wed, 17 Jul 2024 21:28:23 -0300
Subject: [PATCH 12/12] style: text smell

---
 src/lib/common/math.lua | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/lib/common/math.lua b/src/lib/common/math.lua
index de6cb10..3b4818c 100644
--- a/src/lib/common/math.lua
+++ b/src/lib/common/math.lua
@@ -157,7 +157,7 @@ local function map(value, in_min, in_max, out_min, out_max)
     return (value - in_min) * (out_max - out_min) / (in_max - in_min) + out_min
 end
 
---! @shor maximum
+--! @short maximum
 --! @todo document this
 local function max(...)
     local args = {...}