cluaupp 1.3.0 → 1.4.0

package/runtime/TopbarPlus/init.luau

@@ -1,8 +0,0 @@
---!strict
--- Cluaupp TopbarPlus — typed border. Public value is Icon.
-
-local Impl = require(script._impl)
-
-export type Icon = Impl.Icon
-
-return Impl

package/runtime/Twinkle/init.luau

@@ -1,157 +0,0 @@
---!strict
---[=[
-	@class Twinkle
-	UI motion without TweenService boilerplate: fade, slide, zoom, bounce, button styles.
-	Inspired by [Twinkle](https://devforum.roblox.com/t/twinkle-free-powerful-ui-animator-module/4512304).
-]=]
-local TweenService = game:GetService("TweenService")
-
-export type HoverType = "Lift" | "Bounce" | "Grow"
-export type PressType = "Shrink" | "Punch"
-export type TweenProps = {
-	BackgroundTransparency: number?,
-	TextTransparency: number?,
-	Position: UDim2?,
-	Size: UDim2?,
-}
-
-local Twinkle = {}
-
-local function tween(inst: Instance, info: TweenInfo, props: TweenProps): Tween
-	local t = TweenService:Create(inst, info, props)
-	t:Play()
-	return t
-end
-
-local function infoOf(speed: number?, style: Enum.EasingStyle?, dir: Enum.EasingDirection?): TweenInfo
-	return TweenInfo.new(speed or 0.25, style or Enum.EasingStyle.Quad, dir or Enum.EasingDirection.Out)
-end
-
---[=[
-	@within Twinkle
-	@param element GuiObject
-	@param show boolean
-	@param speed number?
-]=]
-function Twinkle.Fade(element: GuiObject, show: boolean, speed: number?)
-	element.Visible = true
-	tween(element, infoOf(speed), { BackgroundTransparency = if show then 0 else 1 })
-	if element:IsA("TextLabel") or element:IsA("TextButton") or element:IsA("TextBox") then
-		tween(element, infoOf(speed), { TextTransparency = if show then 0 else 1 })
-	end
-	if not show then
-		task.delay(speed or 0.25, function()
-			element.Visible = false
-		end)
-	end
-end
-
---[=[
-	@within Twinkle
-	@param element GuiObject
-	@param show boolean
-	@param speed number?
-]=]
-function Twinkle.FrameSlide(element: GuiObject, show: boolean, speed: number?)
-	local original = element.Position
-	if show then
-		element.Visible = true
-		element.Position = original + UDim2.fromOffset(0, 24)
-		tween(element, infoOf(speed), { Position = original, BackgroundTransparency = 0 })
-	else
-		tween(element, infoOf(speed), { Position = original + UDim2.fromOffset(0, 24), BackgroundTransparency = 1 })
-		task.delay(speed or 0.25, function()
-			element.Visible = false
-			element.Position = original
-		end)
-	end
-end
-
---[=[
-	@within Twinkle
-	@param element GuiObject
-	@param show boolean
-	@param speed number?
-]=]
-function Twinkle.FrameZoom(element: GuiObject, show: boolean, speed: number?)
-	local original = element.Size
-	if show then
-		element.Visible = true
-		element.Size = UDim2.new(original.X.Scale * 0.9, original.X.Offset, original.Y.Scale * 0.9, original.Y.Offset)
-		tween(element, infoOf(speed, Enum.EasingStyle.Back), { Size = original })
-	else
-		tween(element, infoOf(speed), {
-			Size = UDim2.new(original.X.Scale * 0.9, original.X.Offset, original.Y.Scale * 0.9, original.Y.Offset),
-		})
-		task.delay(speed or 0.25, function()
-			element.Visible = false
-			element.Size = original
-		end)
-	end
-end
-
---[=[
-	@within Twinkle
-	@param element GuiObject
-	@param speed number?
-	@param bouncePercent number?
-]=]
-function Twinkle.FrameBounce(element: GuiObject, speed: number?, bouncePercent: number?)
-	local original = element.Size
-	local percent = bouncePercent or 0.08
-	local bigger = UDim2.new(
-		original.X.Scale * (1 + percent),
-		original.X.Offset,
-		original.Y.Scale * (1 + percent),
-		original.Y.Offset
-	)
-	local t = tween(element, infoOf(speed or 0.12, Enum.EasingStyle.Quad, Enum.EasingDirection.Out), { Size = bigger })
-	t.Completed:Connect(function()
-		tween(element, infoOf(speed or 0.12, Enum.EasingStyle.Quad, Enum.EasingDirection.In), { Size = original })
-	end)
-end
-
---[=[
-	@within Twinkle
-	@param element GuiObject
-	@param hoverType string? -- Lift | Bounce | Grow
-	@param pressType string? -- Shrink | Punch
-	@param scalePercent number?
-]=]
-function Twinkle.SetButtonStyle(element: GuiObject, hoverType: HoverType?, pressType: PressType?, scalePercent: number?)
-	local original = element.Size
-	local originalPos = element.Position
-	local percent = scalePercent or 0.06
-	if element:IsA("GuiButton") then
-		element.MouseEnter:Connect(function()
-			if hoverType == "Lift" then
-				tween(element, infoOf(0.12), { Position = originalPos + UDim2.fromOffset(0, -4) })
-			else
-				Twinkle.FrameBounce(element, 0.1, percent)
-			end
-		end)
-		element.MouseLeave:Connect(function()
-			tween(element, infoOf(0.12), { Position = originalPos, Size = original })
-		end)
-		element.MouseButton1Down:Connect(function()
-			if pressType == "Punch" then
-				Twinkle.FrameBounce(element, 0.08, percent * 1.4)
-			else
-				local smaller = UDim2.new(
-					original.X.Scale * (1 - percent),
-					original.X.Offset,
-					original.Y.Scale * (1 - percent),
-					original.Y.Offset
-				)
-				tween(element, infoOf(0.08), { Size = smaller })
-			end
-		end)
-		element.MouseButton1Up:Connect(function()
-			tween(element, infoOf(0.1), { Size = original })
-		end)
-	end
-end
-
-export type Twinkle = typeof(Twinkle)
-
-return Twinkle

package/runtime/VfxUtil/init.luau

@@ -1,164 +0,0 @@
---!strict
---[=[
-	@class VfxUtil
-	Emit, play, stop, scale, and clone visual-effect templates (ParticleEmitter,
-	Beam, Trail, Sound, Animation). There was no public GitHub for
-	lucaschaibub/vfx-util; this is the full Cluaupp system.
-
-	```lua
-	VfxUtil.Emit(attachment, 12)
-	local clone = VfxUtil.CloneOnto(template, character.HumanoidRootPart)
-	VfxUtil.Play(clone)
-	task.delay(2, function()
-		VfxUtil.DestroyAfter(clone, 0.4)
-	end)
-	```
-]=]
-local Debris = game:GetService("Debris")
-
-local VfxUtil = {}
-
-export type EffectInstance = ParticleEmitter | Beam | Trail | Sound | Fire | Smoke | Sparkles
-
-local function isEffect(inst: Instance): boolean
-	return inst:IsA("ParticleEmitter")
-		or inst:IsA("Beam")
-		or inst:IsA("Trail")
-		or inst:IsA("Sound")
-		or inst:IsA("Fire")
-		or inst:IsA("Smoke")
-		or inst:IsA("Sparkles")
-end
-
-local function collect(root: Instance): { Instance }
-	local found = {}
-	if isEffect(root) then
-		table.insert(found, root)
-	end
-	for _, child in root:GetDescendants() do
-		if isEffect(child) then
-			table.insert(found, child)
-		end
-	end
-	return found
-end
-
---[=[
-	@within VfxUtil
-	@param root Instance -- Attachment, Part, or a folder of emitters
-	@param count number? -- particles to emit; default 8
-]=]
-function VfxUtil.Emit(root: Instance, count: number?)
-	local amount = count or 8
-	for _, inst in collect(root) do
-		if inst:IsA("ParticleEmitter") then
-			inst:Emit(amount)
-		elseif inst:IsA("Sound") then
-			inst:Play()
-		elseif inst:IsA("Beam") or inst:IsA("Trail") then
-			inst.Enabled = true
-		elseif inst:IsA("Fire") or inst:IsA("Smoke") or inst:IsA("Sparkles") then
-			inst.Enabled = true
-		end
-	end
-end
-
---[=[
-	@within VfxUtil
-	Enables looping emitters / beams / trails and plays sounds.
-]=]
-function VfxUtil.Play(root: Instance)
-	for _, inst in collect(root) do
-		if inst:IsA("ParticleEmitter") or inst:IsA("Beam") or inst:IsA("Trail") then
-			inst.Enabled = true
-		elseif inst:IsA("Sound") then
-			inst:Play()
-		elseif inst:IsA("Fire") or inst:IsA("Smoke") or inst:IsA("Sparkles") then
-			inst.Enabled = true
-		end
-	end
-end
-
---[=[
-	@within VfxUtil
-]=]
-function VfxUtil.Stop(root: Instance)
-	for _, inst in collect(root) do
-		if inst:IsA("ParticleEmitter") or inst:IsA("Beam") or inst:IsA("Trail") then
-			inst.Enabled = false
-		elseif inst:IsA("Sound") then
-			inst:Stop()
-		elseif inst:IsA("Fire") or inst:IsA("Smoke") or inst:IsA("Sparkles") then
-			inst.Enabled = false
-		end
-	end
-end
-
---[=[
-	@within VfxUtil
-	@param template Instance
-	@param parent Instance
-	@return Instance
-	Clones a VFX template onto `parent` (Attachment / BasePart / Model).
-]=]
-function VfxUtil.CloneOnto(template: Instance, parent: Instance): Instance
-	local clone = template:Clone()
-	if clone:IsA("Attachment") and parent:IsA("BasePart") then
-		clone.Parent = parent
-	elseif clone:IsA("BasePart") and parent:IsA("Model") then
-		clone.Parent = parent
-	else
-		clone.Parent = parent
-	end
-	return clone
-end
-
---[=[
-	@within VfxUtil
-	Scales NumberSequence / NumberRange particle sizes by `factor`.
-]=]
-function VfxUtil.Scale(root: Instance, factor: number)
-	for _, inst in collect(root) do
-		if inst:IsA("ParticleEmitter") then
-			local size = inst.Size
-			local keys = {}
-			for index, keypoint in size.Keypoints do
-				keys[index] = NumberSequenceKeypoint.new(keypoint.Time, keypoint.Value * factor, keypoint.Envelope * factor)
-			end
-			inst.Size = NumberSequence.new(keys)
-			local spread = inst.SpreadAngle
-			inst.SpreadAngle = Vector2.new(spread.X * factor, spread.Y * factor)
-		elseif inst:IsA("Sound") then
-			inst.PlaybackSpeed = math.clamp(inst.PlaybackSpeed * factor, 0.1, 4)
-		end
-	end
-end
-
---[=[
-	@within VfxUtil
-	Stops effects then destroys the instance after `lifetime` seconds.
-]=]
-function VfxUtil.DestroyAfter(root: Instance, lifetime: number?)
-	local delayTime = lifetime or 1
-	task.delay(delayTime * 0.6, function()
-		if root.Parent then
-			VfxUtil.Stop(root)
-		end
-	end)
-	Debris:AddItem(root, delayTime)
-end
-
---[=[
-	@within VfxUtil
-	One-shot: clone, emit, destroy.
-]=]
-function VfxUtil.Burst(template: Instance, parent: Instance, count: number?, lifetime: number?): Instance
-	local clone = VfxUtil.CloneOnto(template, parent)
-	VfxUtil.Emit(clone, count)
-	VfxUtil.DestroyAfter(clone, lifetime or 2)
-	return clone
-end
-
-export type VfxUtil = typeof(VfxUtil)
-
-return VfxUtil

package/templates/game/include/clpp/libs/chrono.clh

@@ -1,26 +0,0 @@
-#pragma once
-
-// Parihsz/Chrono — custom character replication, vendored into CluauppLibs.Chrono
-struct ChronoHolder {};
-struct ChronoEntity {};
-struct ChronoStats {};
-struct ChronoConfig {};
-struct ChronoReplicationRules {};
-struct ChronoEvents {};
-struct ChronoSnapshots {};
-struct ChronoServerClock {};
-struct ChronoPlayer {};
-
-namespace Chrono {
-	void Start();
-	void Start(ModuleScript config);
-	ChronoHolder Holder();
-	ChronoEntity Entity();
-	ChronoStats Stats();
-	ChronoConfig Config();
-	ChronoReplicationRules ReplicationRules();
-	ChronoEvents Events();
-	ChronoSnapshots Snapshots();
-	ChronoServerClock ServerClock();
-	ChronoPlayer Player();
-}

package/templates/game/include/clpp/libs/cmdr.clh

@@ -1,16 +0,0 @@
-#pragma once
-
-// evaera/Cmdr — vendored into CluauppLibs.Cmdr (server). Client: Cmdr.CmdrClient
-struct CmdrType {};
-struct CmdrCommand {};
-struct CmdrRegistry {};
-struct CmdrDispatcher {};
-
-namespace Cmdr {
-	void RegisterDefaultCommands();
-	void RegisterHook(string name, void (*callback)());
-	void RegisterType(string name, CmdrType typeDefinition);
-	void RegisterCommand(CmdrCommand commandDefinition);
-	CmdrRegistry Registry();
-	CmdrDispatcher Dispatcher();
-}

package/templates/game/include/clpp/libs/dataservice.clh

@@ -1,138 +0,0 @@
-#pragma once
-
-// KartzRbx/DataServiceV2 — https://github.com/KartzRbx/DataServiceV2
-// Runtime: CluauppLibs.DataService
-//
-// Real surface:
-//   DataService:Server / DataService:Client / DataService:Paths / DataService:Enum
-
-struct DataPath {};
-struct DataProfile {};
-
-struct DataBufferStats {
-	double Bytes;
-	double Messages;
-	double LastPacketBytes;
-	double LastUtilization;
-};
-
-struct OrderedListOptions {
-	string key;
-	string order;
-	int limit;
-};
-
-struct DataOrderList {
-	string Asc;
-	string Desc;
-};
-
-struct DataServiceEnum {
-	DataOrderList OrderList;
-};
-
-template <typename T>
-struct DataServiceOptions {
-	T Template;
-	string StoreName;
-	bool UseMock;
-	string KeyPrefix;
-	LuaArray<DataPath> Exclude;
-	bool StrictPaths;
-	bool AutoCreateMissingTables;
-};
-
-struct Data {
-	RBXScriptSignal Changed;
-	bool Destroyed;
-
-	template <typename T>
-	T Get();
-	template <typename T>
-	T Get(DataPath path);
-
-	template <typename T>
-	T GetPersisted();
-	template <typename T>
-	T GetPersisted(DataPath path);
-
-	template <typename T>
-	T GetTransient();
-	template <typename T>
-	T GetTransient(DataPath path);
-
-	bool HasTransient();
-	bool HasTransient(DataPath path);
-
-	template <typename T>
-	void Set(DataPath path, T value);
-	template <typename T>
-	void SetTransient(DataPath path, T value);
-
-	template <typename T>
-	T Update(DataPath path, T (*fn)(T current));
-	template <typename T>
-	T UpdateTransient(DataPath path, T (*fn)(T current));
-
-	void ClearTransient();
-	void ClearTransient(DataPath path);
-
-	template <typename T>
-	void ArrayInsert(DataPath path, T value);
-	template <typename T>
-	void ArrayInsert(DataPath path, T value, int index);
-	template <typename T>
-	void ArrayInsertTransient(DataPath path, T value);
-	template <typename T>
-	void ArrayInsertTransient(DataPath path, T value, int index);
-
-	template <typename T>
-	T ArrayRemove(DataPath path, int index);
-	template <typename T>
-	T ArrayRemoveTransient(DataPath path, int index);
-
-	template <typename V>
-	LuaArray<V> GetOrderedList(DataPath path, OrderedListOptions options);
-	template <typename V>
-	LuaArray<V> GetOrderedListWithPriority(DataPath path, string key);
-	template <typename V>
-	LuaArray<V> GetOrderedListWithPriority(DataPath path, string key, string order);
-
-	RBXScriptSignal GetChangedSignal(DataPath path);
-	RBXScriptSignal GetPathChangedSignal(DataPath path);
-	RBXScriptSignal GetIndexChangedSignal(DataPath path);
-	RBXScriptSignal GetArrayInsertedSignal(DataPath path);
-	RBXScriptSignal GetArrayRemovedSignal(DataPath path);
-
-	DataPath Typed(DataPath path);
-	void Destroy();
-};
-
-struct DataServiceServer {
-	DataPath Paths;
-	template <typename T>
-	DataServiceServer Init(DataServiceOptions<T> options);
-	Data WaitFor(Player player);
-	Data Get(Player player);
-	bool HasData(Player player);
-	DataProfile GetProfile(Player player);
-	DataBufferStats GetBufferStats();
-	DataBufferStats GetBufferStats(Player player);
-	void Destroy();
-};
-
-struct DataServiceClient {
-	DataPath Paths;
-	Data Init();
-	Data WaitForData();
-	Data Get();
-	DataBufferStats GetBufferStats();
-	void Destroy();
-};
-
-struct DataService {
-	static DataServiceServer Server;
-	static DataServiceClient Client;
-	static DataPath Paths;
-	static DataServiceEnum Enum;
-};

package/templates/game/include/clpp/libs/display.clh

@@ -1,12 +0,0 @@
-#pragma once
-
-// nightcycle/display — pretty-print Luau values (Rust Display-style).
-struct DisplayBuilder {};
-
-namespace Display {
-	DisplayBuilder builder();
-	string display(string value);
-	string display(double value);
-	string display(bool value);
-	string display(Instance value);
-}

package/templates/game/include/clpp/libs/ezvisual.clh

@@ -1,16 +0,0 @@
-#pragma once
-
-// arxkdev/ezVisualz — EasyVisuals, vendored into CluauppLibs.EzVisualz
-struct EzVisualz {
-	static EzVisualz new_(GuiObject target, string effectType);
-	static EzVisualz new_(GuiObject target, string effectType, double speed, double size);
-	void Play();
-	void Pause();
-	void Resume();
-	void Stop();
-	void Destroy();
-	GuiObject UIInstance;
-	double Speed;
-	double Size;
-	bool IsPaused;
-};

package/templates/game/include/clpp/libs/formatnumber.clh

@@ -1,14 +0,0 @@
-#pragma once
-
-// Blockzez/RobloxFormatNumber — vendored into CluauppLibs.FormatNumber
-struct FormatNumberMain {};
-struct FormatNumberSimple {};
-
-namespace FormatNumber {
-	string Abbreviate(double value);
-	string Abbreviate(double value, int digits);
-	string Comma(double value);
-	string Compact(double value);
-	FormatNumberMain Main();
-	FormatNumberSimple Simple();
-}

package/templates/game/include/clpp/libs/fusion.clh

@@ -1,41 +0,0 @@
-#pragma once
-
-// dphfox/Fusion 0.4 — vendored into CluauppLibs.Fusion
-struct FusionScope {};
-struct FusionState {};
-struct FusionKey {};
-struct FusionObserver {};
-struct FusionContextual {};
-
-namespace Fusion {
-	FusionScope scoped();
-	FusionKey New(string className);
-	template <typename T>
-	FusionState Value(T initial);
-	FusionState Computed(void (*callback)());
-	FusionObserver Observer(FusionState value);
-	template <typename T>
-	T peek(FusionState value);
-	FusionKey Hydrate(Instance instance);
-	FusionKey Children();
-	FusionKey Child();
-	FusionKey OnEvent(string eventName);
-	FusionKey OnChange(string propertyName);
-	FusionKey Out(string propertyName);
-	FusionKey Attribute(string name);
-	FusionKey AttributeChange(string name);
-	FusionKey AttributeOut(string name);
-	FusionKey Tag(string name);
-	FusionState Tween(FusionState value, TweenInfo tweenInfo);
-	FusionState Spring(FusionState value, double speed, double damping);
-	FusionState ForKeys(FusionState input, void (*processor)());
-	FusionState ForValues(FusionState input, void (*processor)());
-	FusionState ForPairs(FusionState input, void (*processor)());
-	void doCleanup(Instance task);
-	FusionScope deriveScope(FusionScope scope);
-	FusionScope innerScope(FusionScope scope);
-	void insert(FusionScope scope, Instance task);
-	template <typename T>
-	FusionContextual Contextual(T defaultValue);
-	void Safe(void (*callback)());
-}

package/templates/game/include/clpp/libs/iris.clh

@@ -1,40 +0,0 @@
-#pragma once
-
-// SirMallard/Iris — vendored into CluauppLibs.Iris
-struct IrisWidget {};
-struct IrisState {};
-
-namespace Iris {
-	void Init();
-	void Init(Instance parent);
-	void Shutdown();
-	void Connect(void (*callback)());
-	bool Window(string title);
-	void End();
-	void Text(string text);
-	bool Button(string label);
-	bool SmallButton(string label);
-	bool Checkbox(string label);
-	bool Checkbox(string label, bool* value);
-	IrisWidget InputNum(string label);
-	IrisWidget InputText(string label);
-	IrisWidget SliderNum(string label);
-	IrisWidget DragNum(string label);
-	bool Tree(string label);
-	bool CollapsingHeader(string label);
-	bool Combo(string label);
-	bool RadioButton(string label, bool value);
-	bool TabBar();
-	bool Tab(string label);
-	bool Table(int columns);
-	void SameLine();
-	void Separator();
-	void Indent();
-	void Unindent();
-	template <typename T>
-	IrisState State(T initial);
-	void PushConfig(IrisState style);
-	void PopConfig();
-	void ForceRefresh();
-	void Append(GuiObject instance);
-}

package/templates/game/include/clpp/libs/janitor.clh

@@ -1,38 +0,0 @@
-#pragma once
-
-// howmanysmall/Janitor — vendored into CluauppLibs.Janitor
-struct Janitor {
-	bool CurrentlyCleaning;
-	bool SuppressInstanceReDestroy;
-	bool UnsafeThreadCleanup;
-	Janitor();
-	template <typename T>
-	T Add(T object);
-	template <typename T>
-	T Add(T object, bool callDirectly);
-	template <typename T>
-	T Add(T object, string methodName);
-	template <typename T>
-	T Add(T object, string methodName, string index);
-	template <typename T>
-	T AddObject(T constructor);
-	template <typename P>
-	P AddPromise(P promise);
-	template <typename P>
-	P AddPromise(P promise, string index);
-	Janitor Remove(string index);
-	Janitor RemoveNoClean(string index);
-	Janitor RemoveList(string index);
-	Janitor RemoveListNoClean(string index);
-	template <typename T>
-	T Get(string index);
-	void GetAll();
-	void Cleanup();
-	void Destroy();
-	RBXScriptConnection LinkToInstance(Instance object);
-	RBXScriptConnection LinkToInstance(Instance object, bool allowMultiple);
-	Janitor LinkToInstances(Instance object);
-	static bool Is(Instance value);
-	static bool Is(string value);
-	static bool instanceof(Instance value);
-};

package/templates/game/include/clpp/libs/math.clh

@@ -1,14 +0,0 @@
-#pragma once
-
-namespace MathUtils {
-	double Lerp(double a, double b, double alpha);
-	double Map(double value, double inMin, double inMax, double outMin, double outMax);
-	double Clamp(double value, double min, double max);
-	double Round(double value);
-	double Round(double value, int digits);
-	double AngleDiff(double a, double b);
-	double LerpAngle(double a, double b, double alpha);
-	double Random(double min, double max);
-	int Weighted(LuaArray<double> weights);
-	Vector3 LerpVector(Vector3 a, Vector3 b, double alpha);
-}