@rbxts/hash 1.0.0

package/README.md

@@ -0,0 +1,6 @@
+# Package template
+
+[![CI Status](https://github.com/R-unic/package-template/actions/workflows/test.yml/badge.svg)](https://github.com/R-unic/package-template/actions/workflows)
+[![Coverage Status](https://coveralls.io/repos/github/R-unic/package-template/badge.svg?branch=master)](https://coveralls.io/github/R-unic/package-template)
+
+Package template for roblox-ts with rUnit testing, coverage tracking, and file structure already set up

package/out/index.d.ts

@@ -0,0 +1,9 @@
+export type Hash = number;
+export interface Hashable {
+    hashCode(): number;
+}
+export type HashableType = number | string | boolean | Hashable | undefined;
+export declare namespace Hash {
+    function of(hashable: HashableType): Hash;
+    function combine(...hashables: HashableType[]): Hash;
+}

package/out/init.luau

@@ -0,0 +1,111 @@
+-- Compiled with roblox-ts v3.0.0
+local _binding = bit32
+local lrotate = _binding.lrotate
+local band = _binding.band
+local bxor = _binding.bxor
+local rshift = _binding.rshift
+local lshift = _binding.lshift
+local extract = _binding.extract
+local PRIME1 = 0x9E3779B1
+local PRIME2 = 0x85EBCA77
+local PRIME3 = 0xC2B2AE3D
+local PRIME4 = 0x27D4EB2F
+local PRIME5 = 0x165667B1
+local MAX32 = 0xFFFFFFFF
+local Hash = {}
+do
+	local _container = Hash
+	local hashString
+	local function of(hashable)
+		local _hashable = hashable
+		local _exp = typeof(_hashable)
+		repeat
+			if _exp == "nil" then
+				return 0
+			end
+			if _exp == "boolean" then
+				return if hashable ~= 0 and hashable == hashable and hashable ~= "" and hashable then 1 else 0
+			end
+			if _exp == "number" then
+				return band(hashable, MAX32)
+			end
+			if _exp == "string" then
+				return hashString(hashable)
+			end
+			return hashable:hashCode()
+		until true
+	end
+	_container.of = of
+	local round, mixState, mul32, queueRound, mixFinal
+	local function combine(...)
+		local hashables = { ... }
+		local length = #hashables
+		local i = 0
+		local hash
+		if length >= 4 then
+			local v1 = PRIME1 + PRIME2
+			local v2 = PRIME2
+			local v3 = 0
+			local v4 = -PRIME1
+			while i + 3 <= length do
+				v1 = round(v1, of(hashables[i + 1]))
+				v2 = round(v2, of(hashables[i + 2]))
+				v3 = round(v3, of(hashables[i + 3]))
+				v4 = round(v4, of(hashables[i + 4]))
+				i += 4
+			end
+			hash = mixState(v1, v2, v3, v4)
+		else
+			hash = PRIME5
+		end
+		hash = band(hash + mul32(length, 4), MAX32)
+		while i <= length do
+			hash = queueRound(hash, of(hashables[i + 1]))
+			i += 1
+		end
+		return mixFinal(hash)
+	end
+	_container.combine = combine
+	function round(acc, input)
+		acc = band(acc + mul32(input, PRIME2), MAX32)
+		acc = lrotate(acc, 13)
+		acc = band(mul32(acc, PRIME1), MAX32)
+		return acc
+	end
+	function queueRound(hash, queuedValue)
+		hash = band(hash + mul32(queuedValue, PRIME3), MAX32)
+		hash = lrotate(hash, 17)
+		hash = band(mul32(hash, PRIME4), MAX32)
+		return hash
+	end
+	function mul32(a, b)
+		local aLo = extract(a, 0, 16)
+		local aHi = extract(a, 16, 16)
+		local bLo = extract(b, 0, 16)
+		local bHi = extract(b, 16, 16)
+		local lo = aLo * bLo
+		local mid = aHi * bLo + aLo * bHi
+		return band(lo + lshift(band(mid, 0xFFFF), 16), 0xFFFFFFFF)
+	end
+	function mixState(v1, v2, v3, v4)
+		return band(lrotate(v1, 1) + lrotate(v2, 7) + lrotate(v3, 12) + lrotate(v4, 18), MAX32)
+	end
+	function mixFinal(hash)
+		hash = bxor(hash, rshift(hash, 15))
+		hash = band(mul32(hash, PRIME2), MAX32)
+		hash = bxor(hash, rshift(hash, 13))
+		hash = band(mul32(hash, PRIME3), MAX32)
+		hash = bxor(hash, rshift(hash, 16))
+		return band(hash, MAX32)
+	end
+	function hashString(value)
+		local hash = 0
+		for i = 1, #value do
+			hash = band(mul32(hash, 31) + (string.byte(value, i)), MAX32)
+		end
+		return hash
+	end
+end
+return {
+	Hash = Hash,
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@rbxts/hash",
+  "version": "1.0.0",
+  "description": "A utility for generating hash codes for objects",
+  "author": "me",
+  "main": "out/init.lua",
+  "scripts": {
+    "setup-rokit": "rokit trust lune-org/lune && rokit trust rojo-rbx/rojo && rokit install",
+    "build": "npm run setup-rokit && rbxtsc ",
+    "dev": "npm run build -- -w",
+    "prepublishOnly": "npm test",
+    "test": "npm run build && npm run build -- -p tests && rojo build tests -o tests/test-environment.rbxl && lune run tests tests/test-environment.rbxl",
+    "coverage": "nyc report && lune run fix-lcov-paths"
+  },
+  "keywords": [
+    "roblox",
+    "rbxts"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/R-unic/hash.git"
+  },
+  "license": "ISC",
+  "types": "out/index.d.ts",
+  "files": [
+    "out",
+    "!**/*.tsbuildinfo"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@rbxts/compiler-types": "^3.0.0-types.0",
+    "@rbxts/types": "^1.0.918",
+    "nyc": "^17.1.0",
+    "roblox-ts": "=3.0.0",
+    "typescript": "=5.5.3"
+  }
+}