---@meta tty

---@alias tty.fdLike integer|file* A file descriptor number or a Lua file handle.

---

---Terminal helpers for checking TTY state and reading terminal dimensions.

---

---@class tty

local M = {}

---

---Check whether a file descriptor or Lua file handle is attached to a terminal.

---

---```lua

---local tty = require("tty")

---

---local is_stdout_tty = tty.isatty()

---local is_stderr_tty = tty.isatty(2)

---local is_file_tty = tty.isatty(io.stdout)

---```

---

---@param fd? tty.fdLike

---@return boolean is_tty

---@nodiscard

function M.isatty(fd) end

---

---Get the terminal size for stdout, or for a specific file descriptor or Lua file handle.

---

---```lua

---local tty = require("tty")

---

---local rows, cols = tty.size()

---print(("terminal: %dx%d"):format(cols, rows))

---```

---

---@param fd? tty.fdLike

---@return integer rows Number of terminal rows.

---@return integer cols Number of terminal columns.

---@nodiscard

function M.size(fd) end

return M