@rbxts/app-forge 0.7.2-alpha.3 → 0.7.2-alpha.30

package/out/react/container.d.ts

@@ -1,10 +0,0 @@
-import type Types from "./types";
-export declare function AppContainer(props: Types.NameProps & Types.MainProps): import("@rbxts/react").ReactElement<{
-    key: string;
-    ZIndexBehavior: Enum.ZIndexBehavior.Sibling;
-    ResetOnSpawn: boolean;
-}, string | import("@rbxts/react").JSXElementConstructor<any>> | import("@rbxts/react").ReactElement<{
-    key: string;
-    BackgroundTransparency: number;
-    Size: UDim2;
-}, string | import("@rbxts/react").JSXElementConstructor<any>>;

package/out/react/container.luau

@@ -1,60 +0,0 @@
--- Compiled with roblox-ts v3.0.0
-local TS = _G[script]
--- Services
-local RunService = TS.import(script, TS.getModule(script, "@rbxts", "services")).RunService
--- Packages
-local createElement = TS.import(script, TS.getModule(script, "@rbxts", "react")).createElement
--- Types
--- Components
-local AppRegistry = TS.import(script, script.Parent, "decorator").AppRegistry
-local function createInstance(props)
-	local _binding = props
-	local name = _binding.name
-	local forge = _binding.forge
-	if not (name ~= "" and name) then
-		error("App name is required to create instance")
-	end
-	local appClass = AppRegistry[name]
-	if not appClass then
-		error(`App "{name}" not registered`)
-	end
-	if not (forge.loaded[name] ~= nil) then
-		local instance = appClass.constructor.new(props)
-		local Render = function()
-			return instance:render()
-		end
-		local _loaded = forge.loaded
-		local _arg1 = createElement(Render, {
-			key = "Main",
-		})
-		_loaded[name] = _arg1
-	end
-	return forge.loaded[name]
-end
-local function AppContainer(props)
-	local _binding = props
-	local name = _binding.name
-	if not (name ~= "" and name) then
-		error("App name is required in AppContainer")
-	end
-	local element = createInstance(props)
-	if not element then
-		error(`Failed to create instance for app "{name}"`)
-	end
-	if RunService:IsRunning() then
-		return createElement("ScreenGui", {
-			key = name,
-			ZIndexBehavior = Enum.ZIndexBehavior.Sibling,
-			ResetOnSpawn = false,
-		}, element)
-	else
-		return createElement("Frame", {
-			key = name,
-			BackgroundTransparency = 1,
-			Size = UDim2.fromScale(1, 1),
-		}, element)
-	end
-end
-return {
-	AppContainer = AppContainer,
-}

package/out/react/context.d.ts

@@ -1,7 +0,0 @@
-declare const Contexts: {
-    readonly App: import("@rbxts/react").Context<{
-        forge: import(".").default;
-        px: ReturnType<typeof import("@rbxts/loners-pretty-react-hooks").usePx>;
-    } | undefined>;
-};
-export default Contexts;

package/out/react/context.luau

@@ -1,12 +0,0 @@
--- Compiled with roblox-ts v3.0.0
-local TS = _G[script]
--- Packages
-local createContext = TS.import(script, TS.getModule(script, "@rbxts", "react")).createContext
--- Types
-local Contexts = {
-	App = createContext(nil),
-}
-local default = Contexts
-return {
-	default = default,
-}

package/out/react/decorator.d.ts

@@ -1,14 +0,0 @@
-import React from "@rbxts/react";
-import type Types from "./types";
-import type AppForge from ".";
-export declare const AppRegistry: Map<string, Types.AppRegistry>;
-export declare function App(props: Types.AppRegistryProps): <T extends new (props: Types.MainProps) => Args>(constructor: T) => T;
-export declare abstract class Args {
-    readonly forge: AppForge;
-    readonly props: Types.ClassProps;
-    readonly name: AppNames;
-    readonly bind: React.Binding<boolean>;
-    readonly state: Boolean;
-    constructor(props: Types.NameProps & Types.MainProps);
-    abstract render(): React.ReactNode;
-}

package/out/react/decorator.luau

@@ -1,51 +0,0 @@
--- Compiled with roblox-ts v3.0.0
-local TS = _G[script]
--- Services
--- Packages
-local usePx = TS.import(script, TS.getModule(script, "@rbxts", "loners-pretty-react-hooks").out).usePx
--- Types
-local AppRegistry = {}
-local function App(props)
-	return function(constructor)
-		local _name = props.name
-		if AppRegistry[_name] ~= nil then
-			error(`Duplicate registered App name "{props.name}"`)
-		end
-		local _name_1 = props.name
-		local _arg1 = {
-			constructor = constructor,
-			visible = props.visible,
-			rules = props.rules,
-		}
-		AppRegistry[_name_1] = _arg1
-		return constructor
-	end
-end
-local Args
-do
-	Args = {}
-	function Args:constructor(props)
-		local _binding = props
-		local target = _binding.target
-		local forge = _binding.forge
-		local name = _binding.name
-		if not (name ~= "" and name) then
-			error("App name is required in Args constructor")
-		end
-		local px = usePx(target)
-		self.forge = forge
-		local _object = table.clone(props.props)
-		setmetatable(_object, nil)
-		_object.px = px
-		_object.forge = forge
-		self.props = _object
-		self.name = name
-		self.bind = forge:getBind(name)
-		self.state = forge:getState(name)
-	end
-end
-return {
-	App = App,
-	AppRegistry = AppRegistry,
-	Args = Args,
-}

package/out/react/helpers.d.ts

@@ -1,6 +0,0 @@
-import React from "@rbxts/react";
-import type Types from "./types";
-import type AppForge from ".";
-export declare function createBinding(name: AppNames, forge: AppForge): void;
-export declare function createState(name: AppNames, forge: AppForge): void;
-export declare function Render(props: Types.NameProps & Types.MainProps): React.ReactNode;

package/out/react/helpers.luau

@@ -1,74 +0,0 @@
--- Compiled with roblox-ts v3.0.0
-local TS = _G[script]
--- Packages
-local _react = TS.import(script, TS.getModule(script, "@rbxts", "react"))
-local useBinding = _react.useBinding
-local useState = _react.useState
--- Types
--- Components
-local AppRegistry = TS.import(script, script.Parent, "decorator").AppRegistry
-local function createBinding(name, forge)
-	local _name = name
-	local app = AppRegistry[_name]
-	if not app then
-		error(`App "{name}" not registered`)
-	end
-	local _binds = forge.binds
-	local _name_1 = name
-	if _binds[_name_1] ~= nil then
-		return nil
-	end
-	local _condition = app.visible
-	if _condition == nil then
-		_condition = false
-	end
-	local binding = { useBinding(_condition) }
-	local _binds_1 = forge.binds
-	local _name_2 = name
-	_binds_1[_name_2] = binding
-end
-local function createState(name, forge)
-	local _name = name
-	local app = AppRegistry[_name]
-	if not app then
-		error(`App "{name}" not registered`)
-	end
-	local _states = forge.states
-	local _name_1 = name
-	if _states[_name_1] ~= nil then
-		return nil
-	end
-	local _condition = app.visible
-	if _condition == nil then
-		_condition = false
-	end
-	local state = { useState(_condition) }
-	local _states_1 = forge.states
-	local _name_2 = name
-	_states_1[_name_2] = state
-end
-local function Render(props)
-	local names = props.names
-	local name = props.name
-	local forge = props.forge
-	-- ▼ ReadonlyMap.forEach ▼
-	local _callback = function(_, name)
-		createBinding(name, forge)
-		createState(name, forge)
-	end
-	for _k, _v in AppRegistry do
-		_callback(_v, _k, AppRegistry)
-	end
-	-- ▲ ReadonlyMap.forEach ▲
-	if name ~= "" and name then
-		return forge:renderApp(props)
-	elseif names then
-		return forge:renderApps(props)
-	end
-	return forge:renderAll(props)
-end
-return {
-	createBinding = createBinding,
-	createState = createState,
-	Render = Render,
-}

package/out/react/hooks/useAppContext.d.ts

@@ -1,5 +0,0 @@
-declare const _default: () => {
-    forge: import("..").default;
-    px: ReturnType<typeof import("@rbxts/loners-pretty-react-hooks").usePx>;
-};
-export default _default;

package/out/react/hooks/useAppContext.luau

@@ -1,16 +0,0 @@
--- Compiled with roblox-ts v3.0.0
-local TS = _G[script]
--- Packages
-local useContext = TS.import(script, TS.getModule(script, "@rbxts", "react")).useContext
--- Components
-local Contexts = TS.import(script, script.Parent.Parent, "context").default
-local default = function()
-	local context = useContext(Contexts.App)
-	if not context then
-		error(`Failed to retrieve App Props for React {debug.traceback()}`)
-	end
-	return context
-end
-return {
-	default = default,
-}

package/out/react/hooks/usePx.d.ts

@@ -1,15 +0,0 @@
-/**
- * Scaled pixel unit helper.
- */
-export declare const px: ((value: number) => number) & {
-    scale: (value: number) => number;
-    even: (value: number) => number;
-    floor: (value: number) => number;
-    ceil: (value: number) => number;
-};
-/**
- * Initializes global px scaling.
- *
- * Should be called exactly once at app mount.
- */
-export declare function usePx(target?: GuiObject | Camera, baseResolution?: Vector2, minScale?: number): void;

package/out/react/hooks/usePx.luau

@@ -1,117 +0,0 @@
--- Compiled with roblox-ts v3.0.0
-local TS = _G[script]
--- Services
-local Workspace = TS.import(script, TS.getModule(script, "@rbxts", "services")).Workspace
--- React
-local useEffect = TS.import(script, TS.getModule(script, "@rbxts", "react")).useEffect
---* Default reference resolution for px calculations 
-local BASE_RESOLUTION = Vector2.new(1920, 1080)
---* Minimum allowed scale to prevent unreadable UI 
-local MIN_SCALE = 0.5
---[[
-	*
-	 * Interpolates between width- and height-based scaling.
-	 * 0 = width-driven, 1 = height-driven
-	 
-]]
-local DOMINANT_AXIS = 0.5
-local TARGET = Workspace.CurrentCamera
-local SCALE = 1
-local GLOBAL_INITIALIZED = false
---[[
-	*
-	 * Assigns a call signature to an object.
-	 
-]]
-local function callable(callback, object)
-	return setmetatable(object, {
-		__call = function(_, ...)
-			local args = { ... }
-			return callback(unpack(args))
-		end,
-	})
-end
---[[
-	*
-	 * Scaled pixel unit helper.
-	 
-]]
-local px = callable(function(value)
-	return math.round(value * SCALE)
-end, {
-	scale = function(value)
-		return value * SCALE
-	end,
-	even = function(value)
-		return math.round(value * SCALE * 0.5) * 2
-	end,
-	floor = function(value)
-		return math.floor(value * SCALE)
-	end,
-	ceil = function(value)
-		return math.ceil(value * SCALE)
-	end,
-})
---[[
-	*
-	 * Recalculates the current scale factor.
-	 
-]]
-local function calculateScale()
-	local target = TARGET
-	if not target then
-		return nil
-	end
-	local size = if target:IsA("Camera") then target.ViewportSize elseif target:IsA("GuiObject") then target.AbsoluteSize else nil
-	if not size then
-		return nil
-	end
-	if BASE_RESOLUTION.X <= 0 or BASE_RESOLUTION.Y <= 0 then
-		return nil
-	end
-	local width = math.log(size.X / BASE_RESOLUTION.X, 2)
-	local height = math.log(size.Y / BASE_RESOLUTION.Y, 2)
-	local centered = width + (height - width) * DOMINANT_AXIS
-	local scale = 2 ^ centered
-	SCALE = math.max(scale, MIN_SCALE)
-end
---[[
-	*
-	 * Initializes global px scaling.
-	 *
-	 * Should be called exactly once at app mount.
-	 
-]]
-local function usePx(target, baseResolution, minScale)
-	useEffect(function()
-		if GLOBAL_INITIALIZED then
-			warn("usePx() may only be called once globally")
-			return nil
-		end
-		GLOBAL_INITIALIZED = true
-		if baseResolution then
-			BASE_RESOLUTION = baseResolution
-		end
-		if minScale ~= nil then
-			MIN_SCALE = minScale
-		end
-		if target then
-			TARGET = target
-		end
-		local resolvedTarget = TARGET
-		if not resolvedTarget then
-			warn("usePx(): no valid target to observe")
-			return nil
-		end
-		local signal = if resolvedTarget:IsA("Camera") then resolvedTarget:GetPropertyChangedSignal("ViewportSize") else resolvedTarget:GetPropertyChangedSignal("AbsoluteSize")
-		local connection = signal:Connect(calculateScale)
-		calculateScale()
-		return function()
-			connection:Disconnect()
-		end
-	end, {})
-end
-return {
-	usePx = usePx,
-	px = px,
-}

package/out/react/index.d.ts

@@ -1,44 +0,0 @@
-import React from "@rbxts/react";
-import type Types from "./types";
-type Binding = [React.Binding<boolean>, (T: boolean) => void];
-type State = [boolean, React.Dispatch<React.SetStateAction<boolean>>];
-export default class AppForge {
-    loaded: Map<string, React.Element<any, string | React.JSXElementConstructor<any>>>;
-    binds: Map<string, Binding>;
-    states: Map<string, State>;
-    private rulesManager;
-    getBind(name: AppNames): React.Binding<boolean>;
-    getState(name: AppNames): boolean;
-    set(name: AppNames, value: boolean): void;
-    open(name: AppNames): void;
-    close(name: AppNames): void;
-    toggle(name: AppNames): void;
-    renderApp(props: Types.NameProps & Types.MainProps): React.ReactElement<{
-        key: string;
-        ZIndexBehavior: Enum.ZIndexBehavior.Sibling;
-        ResetOnSpawn: boolean;
-    }, string | React.JSXElementConstructor<any>> | React.ReactElement<{
-        key: string;
-        BackgroundTransparency: number;
-        Size: UDim2;
-    }, string | React.JSXElementConstructor<any>>;
-    renderApps(props: Types.NameProps & Types.MainProps): (React.ReactElement<{
-        key: string;
-        ZIndexBehavior: Enum.ZIndexBehavior.Sibling;
-        ResetOnSpawn: boolean;
-    }, string | React.JSXElementConstructor<any>> | React.ReactElement<{
-        key: string;
-        BackgroundTransparency: number;
-        Size: UDim2;
-    }, string | React.JSXElementConstructor<any>>)[];
-    renderAll(props: Types.MainProps): (React.ReactElement<{
-        key: string;
-        ZIndexBehavior: Enum.ZIndexBehavior.Sibling;
-        ResetOnSpawn: boolean;
-    }, string | React.JSXElementConstructor<any>> | React.ReactElement<{
-        key: string;
-        BackgroundTransparency: number;
-        Size: UDim2;
-    }, string | React.JSXElementConstructor<any>>)[];
-}
-export {};

package/out/react/init.luau

@@ -1,123 +0,0 @@
--- Compiled with roblox-ts v3.0.0
-local TS = _G[script]
--- Packages
--- Types
--- Components
-local AppContainer = TS.import(script, script, "container").AppContainer
-local AppRegistry = TS.import(script, script, "decorator").AppRegistry
--- Classes
-local RulesManager = TS.import(script, script, "rules").default
--- Helpers
-local _helpers = TS.import(script, script, "helpers")
-local createBinding = _helpers.createBinding
-local createState = _helpers.createState
-local AppForge
-do
-	AppForge = setmetatable({}, {
-		__tostring = function()
-			return "AppForge"
-		end,
-	})
-	AppForge.__index = AppForge
-	function AppForge.new(...)
-		local self = setmetatable({}, AppForge)
-		return self:constructor(...) or self
-	end
-	function AppForge:constructor()
-		self.loaded = {}
-		self.binds = {}
-		self.states = {}
-		self.rulesManager = RulesManager.new(self)
-	end
-	function AppForge:getBind(name)
-		local _binds = self.binds
-		local _name = name
-		if not (_binds[_name] ~= nil) then
-			createBinding(name, self)
-		end
-		local _binds_1 = self.binds
-		local _name_1 = name
-		return _binds_1[_name_1][1]
-	end
-	function AppForge:getState(name)
-		local _states = self.states
-		local _name = name
-		if not (_states[_name] ~= nil) then
-			createState(name, self)
-		end
-		local _states_1 = self.states
-		local _name_1 = name
-		return _states_1[_name_1][1]
-	end
-	function AppForge:set(name, value)
-		self.rulesManager:applyRules(name)
-		local _binds = self.binds
-		local _name = name
-		local _binding = _binds[_name]
-		local _b = _binding[1]
-		local setBinding = _binding[2]
-		local _states = self.states
-		local _name_1 = name
-		local _binding_1 = _states[_name_1]
-		local _s = _binding_1[1]
-		local setState = _binding_1[2]
-		if not setBinding then
-			createBinding(name, self)
-		end
-		setBinding(value)
-		setState(value)
-	end
-	function AppForge:open(name)
-		self:set(name, true)
-	end
-	function AppForge:close(name)
-		self:set(name, false)
-	end
-	function AppForge:toggle(name)
-		self:set(name, not self:getState(name))
-	end
-	function AppForge:renderApp(props)
-		return AppContainer(props)
-	end
-	function AppForge:renderApps(props)
-		local names = props.names
-		if names then
-			-- ▼ ReadonlyArray.map ▼
-			local _newValue = table.create(#names)
-			local _callback = function(name)
-				local _self = self
-				local _object = table.clone(props)
-				setmetatable(_object, nil)
-				_object.name = name
-				_object.names = nil
-				return _self:renderApp(_object)
-			end
-			for _k, _v in names do
-				_newValue[_k] = _callback(_v, _k - 1, names)
-			end
-			-- ▲ ReadonlyArray.map ▲
-			return _newValue
-		end
-		error("No app names provided to renderApps")
-	end
-	function AppForge:renderAll(props)
-		local names = {}
-		-- ▼ ReadonlyMap.forEach ▼
-		local _callback = function(_, name)
-			local _name = name
-			table.insert(names, _name)
-		end
-		for _k, _v in AppRegistry do
-			_callback(_v, _k, AppRegistry)
-		end
-		-- ▲ ReadonlyMap.forEach ▲
-		local _self = self
-		local _object = table.clone(props)
-		setmetatable(_object, nil)
-		_object.names = names
-		return _self:renderApps(_object)
-	end
-end
-return {
-	default = AppForge,
-}

package/out/react/rules/index.d.ts

@@ -1,6 +0,0 @@
-import type AppForge from "..";
-export default class RulesManager {
-    private forge;
-    constructor(forge: AppForge);
-    applyRules(name: AppNames): void;
-}

package/out/react/rules/init.luau

@@ -1,27 +0,0 @@
--- Compiled with roblox-ts v3.0.0
-local TS = _G[script]
--- Types
--- Rules
-local ParentRule = TS.import(script, script, "parent").default
-local RulesManager
-do
-	RulesManager = setmetatable({}, {
-		__tostring = function()
-			return "RulesManager"
-		end,
-	})
-	RulesManager.__index = RulesManager
-	function RulesManager.new(...)
-		local self = setmetatable({}, RulesManager)
-		return self:constructor(...) or self
-	end
-	function RulesManager:constructor(forge)
-		self.forge = forge
-	end
-	function RulesManager:applyRules(name)
-		ParentRule(name, self.forge)
-	end
-end
-return {
-	default = RulesManager,
-}

package/out/react/rules/parent.luau

@@ -1,42 +0,0 @@
--- Compiled with roblox-ts v3.0.0
-local TS = _G[script]
--- Types
--- Components
-local AppRegistry = TS.import(script, script.Parent.Parent, "decorator").AppRegistry
-local function ParentRule(entry, forge)
-	local children = {}
-	-- ▼ ReadonlyMap.forEach ▼
-	local _callback = function(app, name)
-		local rules = app.rules
-		if not rules then
-			return nil
-		end
-		local _condition = rules.parent
-		if _condition ~= "" and _condition then
-			_condition = rules.parent == entry
-		end
-		if _condition ~= "" and _condition then
-			local _binds = forge.binds
-			local _entry = entry
-			if not _binds[_entry] then
-				local _name = name
-				table.insert(children, _name)
-			end
-		end
-	end
-	for _k, _v in AppRegistry do
-		_callback(_v, _k, AppRegistry)
-	end
-	-- ▲ ReadonlyMap.forEach ▲
-	-- ▼ ReadonlyArray.forEach ▼
-	local _callback_1 = function(name)
-		return forge:close(name)
-	end
-	for _k, _v in children do
-		_callback_1(_v, _k - 1, children)
-	end
-	-- ▲ ReadonlyArray.forEach ▲
-end
-return {
-	default = ParentRule,
-}

package/out/react/types.d.ts

@@ -1,44 +0,0 @@
-// Types
-import type { Args } from "./decorator";
-import type AppForge from ".";
-
-declare namespace Types {
-	type AppRegistryProps = {
-		name: AppNames;
-		visible?: boolean;
-		rules?: Rules.All;
-	};
-
-	type NameProps =
-		| { name?: AppNames; names?: undefined }
-		| { names?: AppNames[]; name?: undefined };
-
-	type MainProps = {
-		props: AppProps;
-		forge: AppForge;
-		target?: GuiObject | Camera;
-	};
-
-	type ClassProps = AppProps & {
-		forge: AppForge;
-		px: ReturnType<typeof import("@rbxts/loners-pretty-react-hooks").usePx>;
-	};
-
-	type AppRegistry = {
-		constructor: new (props: MainProps) => Args;
-		visible?: boolean;
-		rules?: Rules.All;
-	};
-
-	namespace Rules {
-		type All = {
-			parent?: AppNames;
-		};
-	}
-}
-
-export type MainProps = Types.MainProps;
-export type NameProps = Types.NameProps;
-export type ClassProps = Types.ClassProps;
-
-export default Types;