docs(mods): generate API docs (#15)

Co-authored-by: haithium <128622475+haithium@users.noreply.github.com>

Author: github-actions[bot]

docs/src/mods/api/date.md

@@ -568,9 +568,9 @@ print(d:weekday(-7)) --> 2026-03-23 00:00:00
 ```
 
 The getter returns a number in the range `0..6`, relative to the current
-[`mods.calendar.firstweekday`](/modules/calendar#fn-firstweekday). Passing an
-integer returns a shifted copy in the same locale-relative week space, with
-negative and overflow values moving into previous or next weeks.
+`mods.calendar.firstweekday`. Passing an integer returns a shifted copy in the
+same locale-relative week space, with negative and overflow values moving into
+previous or next weeks.
 
 <a id="fn-weeks-in-year"></a>
 
@@ -876,8 +876,7 @@ Return `true` when the value is a duration created by `date.duration(...)`.
 
 **Return**:
 
-- `isDuration` (`boolean`): Whether the value is a
-  [`mods.Duration`](/modules/duration).
+- `isDuration` (`boolean`): Whether the value is a `mods.Duration`.
 
 **Example**:
 

docs/src/mods/api/keyword.md

@@ -19,10 +19,10 @@ kw.isidentifier("hello_world") --> true
 
 **Collections**:
 
-| Function                 | Description                                            |
-| ------------------------ | ------------------------------------------------------ |
-| [`kwlist()`](#fn-kwlist) | Return Lua keywords as a [`mods.List`](/modules/list). |
-| [`kwset()`](#fn-kwset)   | Return Lua keywords as a [`mods.Set`](/modules/set).   |
+| Function                 | Description                           |
+| ------------------------ | ------------------------------------- |
+| [`kwlist()`](#fn-kwlist) | Return Lua keywords as a `mods.List`. |
+| [`kwset()`](#fn-kwset)   | Return Lua keywords as a `mods.Set`.  |
 
 **Normalization**:
 
@@ -43,7 +43,7 @@ kw.isidentifier("hello_world") --> true
 
 #### `kwlist()`
 
-Return Lua keywords as a [`mods.List`](/modules/list).
+Return Lua keywords as a `mods.List`.
 
 **Return**:
 
@@ -60,7 +60,7 @@ kw.kwlist():contains("global") --> true -- Lua 5.5+
 
 #### `kwset()`
 
-Return Lua keywords as a [`mods.Set`](/modules/set).
+Return Lua keywords as a `mods.Set`.
 
 **Return**:
 

docs/src/mods/api/ntpath.md

@@ -19,8 +19,7 @@ print(ntpath.splitdrive([[C:\Users\me]]))     --> "C:", [[\Users\me]]
 print(ntpath.isreserved([[C:\Temp\CON.txt]])) --> true
 ```
 
-> ✨ Same API as [`mods.path`](/modules/path), but with Windows/NT path
-> semantics.
+> ✨ Same API as `mods.path`, but with Windows/NT path semantics.
 
 ## Functions
 

docs/src/mods/api/path.md

@@ -693,9 +693,8 @@ path.normcase("/A/B") --> "\\a\\b"
 
 > [!NOTE]
 >
-> On POSIX semantics this returns the input unchanged. Use
-> [`mods.ntpath`](/modules/ntpath) to force Windows-style case folding and
-> separator normalization.
+> On POSIX semantics this returns the input unchanged. Use `mods.ntpath` to
+> force Windows-style case folding and separator normalization.
 
 <a id="fn-normpath"></a>
 

docs/src/mods/api/posixpath.md

@@ -19,4 +19,4 @@ print(posixpath.splitext("archive.tar.gz"))        --> "archive.tar", ".gz"
 print(posixpath.relpath("/usr/local/bin", "/usr")) --> "local/bin"
 ```
 
-> ✨ Same API as [`mods.path`](/modules/path), but with POSIX path semantics.
+> ✨ Same API as `mods.path`, but with POSIX path semantics.

docs/src/mods/api/str.md

@@ -377,7 +377,7 @@ s = format_map("hi {name}", { name = "bob" }) --> "hi bob"
 > [!NOTE]
 >
 > `format_map` is a lightweight `{key}` replacement helper. For richer
-> templating, use [`mods.template`](/modules/template).
+> templating, use `mods.template`.
 
 ### Layout
 

docs/src/mods/api/utils.md

@@ -32,11 +32,11 @@ print(utils.quote('hello "world"')) --> 'hello "world"'
 
 **Validation**:
 
-| Function                                                            | Description                                                                                        |
-| ------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
-| [`assert_arg(argn, v, validator?, optional?, lv?)`](#fn-assert-arg) | Assert argument value using [`mods.validate`](/modules/validate) and raise a Lua error on failure. |
-| [`validate(name, v, validator?, optional?, msg?)`](#fn-validate)    | Validate a value using [`mods.validate`](/modules/validate) and raise a Lua error on failure.      |
-| [`validate(path, v, validator?, optional?, msg?)`](#fn-validate)    | Validate a value using [`mods.validate`](/modules/validate) and raise a Lua error on failure.      |
+| Function                                                            | Description                                                                   |
+| ------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
+| [`assert_arg(argn, v, validator?, optional?, lv?)`](#fn-assert-arg) | Assert argument value using `mods.validate` and raise a Lua error on failure. |
+| [`validate(name, v, validator?, optional?, msg?)`](#fn-validate)    | Validate a value using `mods.validate` and raise a Lua error on failure.      |
+| [`validate(path, v, validator?, optional?, msg?)`](#fn-validate)    | Validate a value using `mods.validate` and raise a Lua error on failure.      |
 
 ### Formatting
 
@@ -148,8 +148,7 @@ print(stringify({ a = 1 }))
 
 #### `assert_arg(argn, v, validator?, optional?, lv?)`
 
-Assert argument value using [`mods.validate`](/modules/validate) and raise a Lua
-error on failure.
+Assert argument value using `mods.validate` and raise a Lua error on failure.
 
 **Parameters**:
 
@@ -183,17 +182,15 @@ utils.assert_arg(3, "x", "number", false, "need {{expected}}, got {{got}}")
 
 #### `validate(name, v, validator?, optional?, msg?)`
 
-Validate a value using [`mods.validate`](/modules/validate) and raise a Lua
-error on failure.
+Validate a value using `mods.validate` and raise a Lua error on failure.
 
 **Parameters**:
 
 - `name` (`string`): Name for the error prefix.
 - `v` (`any`): Value to validate.
 - `validator?` (`modsValidatorName`): Validator name (defaults to `"truthy"`).
 - `optional?` (`boolean`): Skip errors when `v` is `nil` (defaults to `false`).
-- `msg?` (`string`): Optional override template passed to
-  [`mods.validate`](/modules/validate).
+- `msg?` (`string`): Optional override template passed to `mods.validate`.
 
 **Return**:
 
@@ -212,17 +209,15 @@ utils.validate("count", "x", "number")
 
 #### `validate(path, v, validator?, optional?, msg?)`
 
-Validate a value using [`mods.validate`](/modules/validate) and raise a Lua
-error on failure.
+Validate a value using `mods.validate` and raise a Lua error on failure.
 
 **Parameters**:
 
 - `path` (`table`): Path parts for the error name.
 - `v` (`any`): Value to validate.
 - `validator?` (`modsValidatorName`): Validator name (defaults to `"truthy"`).
 - `optional?` (`boolean`): Skip errors when `v` is `nil` (defaults to `false`).
-- `msg?` (`string`): Optional override template passed to
-  [`mods.validate`](/modules/validate).
+- `msg?` (`string`): Optional override template passed to `mods.validate`.
 
 **Return**:
 
@@ -238,5 +233,4 @@ utils.validate({ "ctx", "users", 1, "name" }, 123, "string")
 
 > [!NOTE]
 >
-> On failure, `path` is rendered with
-> [`mods.utils.keypath`](/modules/utils#fn-keypath).
+> On failure, `path` is rendered with `mods.utils.keypath`.