docs: sync gathered documentation from tty (#26)

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

Author: github-actions[bot]

docs/src/tty/index.md

@@ -0,0 +1,38 @@
+# tty
+
+[![LuaRocks](https://img.shields.io/luarocks/v/BlueLua/tty?color=blue&style=flat-square)](https://luarocks.org/modules/BlueLua/tty)
+![Lua Versions](https://img.shields.io/badge/lua-5.1%20%7C%205.2%20%7C%205.3%20%7C%205.4%20%7C%205.5%20%7C%20LuaJIT-blue?style=flat-square)
+![Platform](https://img.shields.io/badge/platform-linux%20%7C%20macos%20%7C%20windows-blue?style=flat-square)
+[![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](https://github.com/BlueLua/tty/blob/main/LICENSE)
+
+`tty` provides lightweight, cross-platform C-backed Lua bindings for terminal
+detection and terminal size inspection.
+
+## ✨ Features
+
+- **TTY Verification**: Check if a Lua file handle (like `io.stdout`,
+  `io.stdin`), standard stream, or raw file descriptor is interactive.
+- **Window Dimension Query**: Retrieve the current width (columns) and height
+  (rows) of the active terminal dynamically.
+- **Multiple Lua Versions**: Compatible with LuaJIT, Lua 5.1, 5.2, 5.3, 5.4, and
+  5.5.
+
+## 📦 Installation
+
+```sh
+luarocks install tty
+```
+
+## 🚀 Usage
+
+```lua
+local tty = require "tty"
+
+-- Check if standard output is a TTY
+if tty.isatty(io.stdout) then
+  local rows, cols = tty.size()
+  print(string.format("Terminal size: %dx%d", cols, rows))
+else
+  print("Output is redirected")
+end
+```