refactor(YRV3): refactor businesses into objects

- Refactored businesses into state-aware objects.
- Moved Nightclub from the safes tab into its own tab
- Added business hubs (nightclub cargo) with production triggers.
- Simplified YRV3 UI to prevent crashes.

closes YimMenu-Lua#85

Author: xesdoog

SSV2/includes/backend.lua

@@ -1,4 +1,11 @@
----@diagnostic disable: lowercase-global
+-- Copyright (C) 2026 SAMURAI (xesdoog) & Contributors.
+-- This file is part of Samurai's Scripts.
+--
+-- Permission is hereby granted to copy, modify, and redistribute
+-- this code as long as you respect these conditions:
+--	* Credit the owner and contributors.
+--	* Provide a copy of or a link to the original license (GPL-3.0 or later); see LICENSE.md or <https://www.gnu.org/licenses/>.
+
 
 local PreviewService = require("includes.services.PreviewService")
 local function ClearPreview()

SSV2/includes/classes/Mutex.lua

@@ -1,3 +1,12 @@
+-- Copyright (C) 2026 SAMURAI (xesdoog) & Contributors.
+-- This file is part of Samurai's Scripts.
+--
+-- Permission is hereby granted to copy, modify, and redistribute
+-- this code as long as you respect these conditions:
+--	* Credit the owner and contributors.
+--	* Provide a copy of or a link to the original license (GPL-3.0 or later); see LICENSE.md or <https://www.gnu.org/licenses/>.
+
+
 --------------------------------------
 -- Class: Mutex
 --------------------------------------

SSV2/includes/classes/Pair.lua

@@ -1,3 +1,15 @@
+-- Copyright (C) 2026 SAMURAI (xesdoog) & Contributors.
+-- This file is part of Samurai's Scripts.
+--
+-- Permission is hereby granted to copy, modify, and redistribute
+-- this code as long as you respect these conditions:
+--	* Credit the owner and contributors.
+--	* Provide a copy of or a link to the original license (GPL-3.0 or later); see LICENSE.md or <https://www.gnu.org/licenses/>.
+
+
+--------------------------------------
+-- Class: Pair
+--------------------------------------
 ---@class Pair<K, V> : { first: K, second: V }
 Pair = {}
 Pair.__index = Pair

SSV2/includes/classes/Range.lua

@@ -1,4 +1,11 @@
----@diagnostic disable: param-type-mismatch
+-- Copyright (C) 2026 SAMURAI (xesdoog) & Contributors.
+-- This file is part of Samurai's Scripts.
+--
+-- Permission is hereby granted to copy, modify, and redistribute
+-- this code as long as you respect these conditions:
+--	* Credit the owner and contributors.
+--	* Provide a copy of or a link to the original license (GPL-3.0 or later); see LICENSE.md or <https://www.gnu.org/licenses/>.
+
 
 --------------------------------------
 -- Class: Range
@@ -12,6 +19,7 @@
 ---@overload fun(from: number, to: number, step?: number): Range
 Range = {}
 Range.__index = Range
+---@diagnostic disable-next-line
 setmetatable(Range, {
 	__call = function(_, from, to, step)
 		return Range.new(from, to, step)
@@ -31,17 +39,14 @@ function Range.new(from, to, step)
 		m_min = from,
 		m_max = to,
 		m_step = step,
+		---@diagnostic disable-next-line
 	}, Range)
 end
 
 ---@param value number
 ---@return boolean
 function Range:Contains(value)
-	if (self.m_step > 0) then
-		return value >= self.m_min and value <= self.m_max -- or math.inrange(value, self.m_min, self.m_max)
-	else
-		return value <= self.m_min and value >= self.m_max
-	end
+	return value >= self.m_min and value <= self.m_max -- or math.isinrange(value, self.m_min, self.m_max)
 end
 
 ---@return fun(): number Iterator

SSV2/includes/classes/Rect.lua

@@ -1,11 +1,22 @@
----@diagnostic disable: param-type-mismatch
+-- Copyright (C) 2026 SAMURAI (xesdoog) & Contributors.
+-- This file is part of Samurai's Scripts.
+--
+-- Permission is hereby granted to copy, modify, and redistribute
+-- this code as long as you respect these conditions:
+--	* Credit the owner and contributors.
+--	* Provide a copy of or a link to the original license (GPL-3.0 or later); see LICENSE.md or <https://www.gnu.org/licenses/>.
 
+
+--------------------------------------
+-- Class: Rect
+--------------------------------------
 ---@class Rect
 ---@field min vec2
 ---@field max vec2
 ---@overload fun(min: vec2, max: vec2) : Rect
 Rect = {}
 Rect.__index = Rect
+---@diagnostic disable-next-line
 setmetatable(Rect, {
 	__call = function(_, ...)
 		return Rect.new(...)
@@ -16,6 +27,7 @@ setmetatable(Rect, {
 ---@param max vec2
 ---@return Rect
 function Rect.new(min, max)
+	---@diagnostic disable-next-line
 	return setmetatable({ min = min, max = max }, Rect)
 end
 

SSV2/includes/classes/Set.lua

@@ -1,3 +1,15 @@
+-- Copyright (C) 2026 SAMURAI (xesdoog) & Contributors.
+-- This file is part of Samurai's Scripts.
+--
+-- Permission is hereby granted to copy, modify, and redistribute
+-- this code as long as you respect these conditions:
+--	* Credit the owner and contributors.
+--	* Provide a copy of or a link to the original license (GPL-3.0 or later); see LICENSE.md or <https://www.gnu.org/licenses/>.
+
+
+--------------------------------------
+-- Class: Set
+--------------------------------------
 ---@generic T
 ---@class Set<T> : { [T]: true }
 ---@field protected m_data table<anyval, true>

SSV2/includes/classes/Vector2.lua

@@ -1,3 +1,12 @@
+-- Copyright (C) 2026 SAMURAI (xesdoog) & Contributors.
+-- This file is part of Samurai's Scripts.
+--
+-- Permission is hereby granted to copy, modify, and redistribute
+-- this code as long as you respect these conditions:
+--	* Credit the owner and contributors.
+--	* Provide a copy of or a link to the original license (GPL-3.0 or later); see LICENSE.md or <https://www.gnu.org/licenses/>.
+
+
 ---@diagnostic disable: unknown-operator
 
 --------------------------------------

SSV2/includes/classes/Vector3.lua

@@ -1,3 +1,12 @@
+-- Copyright (C) 2026 SAMURAI (xesdoog) & Contributors.
+-- This file is part of Samurai's Scripts.
+--
+-- Permission is hereby granted to copy, modify, and redistribute
+-- this code as long as you respect these conditions:
+--	* Credit the owner and contributors.
+--	* Provide a copy of or a link to the original license (GPL-3.0 or later); see LICENSE.md or <https://www.gnu.org/licenses/>.
+
+
 ---@diagnostic disable: unknown-operator
 
 --------------------------------------

SSV2/includes/classes/Vector4.lua

@@ -1,3 +1,12 @@
+-- Copyright (C) 2026 SAMURAI (xesdoog) & Contributors.
+-- This file is part of Samurai's Scripts.
+--
+-- Permission is hereby granted to copy, modify, and redistribute
+-- this code as long as you respect these conditions:
+--	* Credit the owner and contributors.
+--	* Provide a copy of or a link to the original license (GPL-3.0 or later); see LICENSE.md or <https://www.gnu.org/licenses/>.
+
+
 ---@diagnostic disable: unknown-operator
 
 --------------------------------------

SSV2/includes/classes/gta/CBaseSubHandlingData.lua

@@ -1,3 +1,12 @@
+-- Copyright (C) 2026 SAMURAI (xesdoog) & Contributors.
+-- This file is part of Samurai's Scripts.
+--
+-- Permission is hereby granted to copy, modify, and redistribute
+-- this code as long as you respect these conditions:
+--	* Credit the owner and contributors.
+--	* Provide a copy of or a link to the original license (GPL-3.0 or later); see LICENSE.md or <https://www.gnu.org/licenses/>.
+
+
 ---@class CBaseSubHandlingData
 ---@field protected m_ptr pointer
 ---@field protected m_handling_type pointer<int32_t> -- 0x00C8