Add type annotations to bitn modules

src/bitn/_compat.lua

@@ -1,6 +1,8 @@
+--- @diagnostic disable: duplicate-set-field
 --- @module "bitn._compat"
 --- Internal compatibility layer for bitwise operations.
 --- Provides feature detection and optimized primitives for use by bit16/bit32/bit64.
+--- @class bitn._compat
 local _compat = {}
 
 --------------------------------------------------------------------------------

src/bitn/bit16.lua

@@ -3,6 +3,7 @@
 --- This module provides a complete, version-agnostic implementation of 16-bit
 --- bitwise operations that works across Lua 5.1, 5.2, 5.3, 5.4, and LuaJIT.
 --- Uses native bit operations where available for optimal performance.
+--- @class bitn.bit16
 local bit16 = {}
 
 local _compat = require("bitn._compat")

src/bitn/bit32.lua

@@ -3,6 +3,7 @@
 --- This module provides a complete, version-agnostic implementation of 32-bit
 --- bitwise operations that works across Lua 5.1, 5.2, 5.3, 5.4, and LuaJIT.
 --- Uses native bit operations where available for optimal performance.
+--- @class bitn.bit32
 local bit32 = {}
 
 local _compat = require("bitn._compat")

src/bitn/bit64.lua

@@ -4,6 +4,7 @@
 --- where high is the upper 32 bits and low is the lower 32 bits.
 --- Works across Lua 5.1, 5.2, 5.3, 5.4, and LuaJIT.
 --- Uses native bit operations where available for optimal performance.
+--- @class bitn.bit64
 local bit64 = {}
 
 local bit32 = require("bitn.bit32")

src/bitn/init.lua

@@ -18,9 +18,13 @@
 --- -- 16-bit operations
 --- local shifted = bitn.bit16.lshift(1, 8)  -- 256
 ---
+--- @class bitn
 local bitn = {
+  --- @type bitn.bit16 16-bit bitwise operations
   bit16 = require("bitn.bit16"),
+  --- @type bitn.bit32 32-bit bitwise operations
   bit32 = require("bitn.bit32"),
+  --- @type bitn.bit64 64-bit bitwise operations
   bit64 = require("bitn.bit64"),
 }
 

src/bitn/utils/benchmark.lua

@@ -1,5 +1,6 @@
 --- @module "bitn.utils.benchmark"
 --- Common benchmarking utilities for performance testing
+--- @class bitn.utils.benchmark
 local benchmark = {}
 
 --- Run a benchmarked operation with warmup and timing

src/bitn/utils/init.lua

@@ -1,6 +1,8 @@
 --- @module "bitn.utils"
 --- Utility modules for bitn
+--- @class bitn.utils
 local utils = {
+  --- @type bitn.utils.benchmark Benchmarking utilities
   benchmark = require("bitn.utils.benchmark"),
 }