@rbxts/uiblox 0.1.53 → 0.2.0-alpha.1

package/out/ui/packages/select/components/Select.luau

@@ -0,0 +1,455 @@
+-- Compiled with roblox-ts v3.0.0
+local TS = _G[script]
+local _react = TS.import(script, TS.getModule(script, "@rbxts", "react"))
+local React = _react
+local useEffect = _react.useEffect
+local useRef = _react.useRef
+local useState = _react.useState
+local _services = TS.import(script, TS.getModule(script, "@rbxts", "services"))
+local GuiService = _services.GuiService
+local UserInputService = _services.UserInputService
+local useReducedMotion = TS.import(script, script.Parent.Parent.Parent.Parent.Parent, "hooks").useReducedMotion
+local _theme = TS.import(script, script.Parent.Parent.Parent.Parent.Parent, "theme")
+local controlMetrics = _theme.controlMetrics
+local cx = _theme.cx
+local useTheme = _theme.useTheme
+local canActivate = TS.import(script, script.Parent.Parent.Parent, "button", "components", "activation").canActivate
+local spinnerPixels = TS.import(script, script.Parent.Parent.Parent, "button", "components", "buttonLook").spinnerPixels
+local CircularProgress = TS.import(script, script.Parent.Parent.Parent, "circularProgress").CircularProgress
+local Input = TS.import(script, script.Parent.Parent.Parent, "input").Input
+local playProperty = TS.import(script, script.Parent.Parent.Parent, "motion").playProperty
+local Popup = TS.import(script, script.Parent.Parent.Parent, "popup").Popup
+local Shadow = TS.import(script, script.Parent.Parent.Parent, "shadow").Shadow
+local VirtualList = TS.import(script, script.Parent.Parent.Parent, "virtualList").VirtualList
+local useSelectStyles = TS.import(script, script.Parent, "Select.styles").default
+local optionLabel = TS.import(script, script.Parent, "optionLabel").optionLabel
+local _selectFilter = TS.import(script, script.Parent, "selectFilter")
+local filterChoices = _selectFilter.filterChoices
+local usesSelectSearch = _selectFilter.usesSelectSearch
+local canFocusGui = TS.import(script, script.Parent, "selectFocus").canFocusGui
+local _selectGroups = TS.import(script, script.Parent, "selectGroups")
+local groupRows = _selectGroups.groupRows
+local rowForOption = _selectGroups.rowForOption
+local shouldHandleSelectKey = TS.import(script, script.Parent, "selectKey").shouldHandleSelectKey
+local menuHold = TS.import(script, script.Parent, "selectMotion").menuHold
+local _selectMulti = TS.import(script, script.Parent, "selectMulti")
+local includesChoice = _selectMulti.includesChoice
+local selectionLabel = _selectMulti.selectionLabel
+local typeaheadChoice = TS.import(script, script.Parent, "selectTypeahead").typeaheadChoice
+local stepChoice = TS.import(script, script.Parent, "stepChoice").stepChoice
+local function Select(props)
+	local _binding = props
+	local value = _binding.value
+	local values = _binding.values
+	local options = _binding.options
+	local onChange = _binding.onChange
+	local disabled = _binding.disabled
+	local loading = _binding.loading
+	if loading == nil then
+		loading = false
+	end
+	local placeholder = _binding.placeholder
+	if placeholder == nil then
+		placeholder = ""
+	end
+	local searchable = _binding.searchable
+	local reducedProp = _binding.reducedMotion
+	local size = _binding.size
+	local className = _binding.className
+	local sx = _binding.sx
+	local id = _binding.id
+	local ref = _binding.ref
+	local reducedMotion = useReducedMotion(reducedProp)
+	local styles = useSelectStyles({
+		size = size,
+	})
+	local _binding_1 = useTheme()
+	local theme = _binding_1.theme
+	local row = controlMetrics(theme.density, size).height
+	local active = canActivate(disabled, loading)
+	local anchor, setAnchor = useState()
+	local open, setOpen = useState(false)
+	local held, setHeld = useState(false)
+	local focused, setFocused = useState(false)
+	local highlight, setHighlight = useState(-1)
+	local query, setQuery = useState("")
+	local recent = useRef()
+	local typed = useRef()
+	local onKeyRef = useRef()
+	local listRef = useRef()
+	local menuRef = useRef()
+	-- ▼ ReadonlyArray.find ▼
+	local _callback = function(option)
+		return option.value == value
+	end
+	local _result
+	for _i, _v in options do
+		if _callback(_v, _i - 1, options) == true then
+			_result = _v
+			break
+		end
+	end
+	-- ▲ ReadonlyArray.find ▲
+	local current = _result
+	local shown = open and active
+	local search = usesSelectSearch(#options, searchable)
+	local filtered = filterChoices(options, query)
+	local rows = groupRows(filtered)
+	local menuHeight = math.min(#rows * row, theme.spacing.calc(16)) + (if search then row else 0)
+	local close = function()
+		setOpen(false)
+		setQuery("")
+		if canFocusGui(anchor) then
+			GuiService.SelectedObject = anchor
+		end
+	end
+	local openMenu = function()
+		setQuery("")
+		-- ▼ ReadonlyArray.findIndex ▼
+		local _callback_1 = function(option)
+			return option.value == value and not option.disabled
+		end
+		local _result_1 = -1
+		for _i, _v in options do
+			if _callback_1(_v, _i - 1, options) == true then
+				_result_1 = _i - 1
+				break
+			end
+		end
+		-- ▲ ReadonlyArray.findIndex ▲
+		local index = _result_1
+		setHighlight(if index >= 0 then index else stepChoice(options, -1, 1))
+		setOpen(true)
+	end
+	local choose = function(index, fromPointer)
+		if fromPointer == nil then
+			fromPointer = false
+		end
+		local _condition = fromPointer
+		if _condition then
+			local _result_1 = listRef.current
+			if _result_1 ~= nil then
+				_result_1 = _result_1.suppressClick()
+			end
+			_condition = _result_1
+		end
+		if _condition then
+			return nil
+		end
+		local choice = filtered[index + 1]
+		if choice == nil or choice.disabled then
+			return nil
+		end
+		if values == nil then
+			close()
+			if choice.value ~= value then
+				onChange(choice.value)
+			end
+			return nil
+		end
+		onChange(choice.value)
+	end
+	local onKey = function(input, fromControl)
+		local now = os.clock()
+		if shown and (input.KeyCode == Enum.KeyCode.Escape or input.KeyCode == Enum.KeyCode.ButtonB) then
+			close()
+			return nil
+		end
+		if not shouldHandleSelectKey(shown, focused, fromControl, UserInputService:GetFocusedTextBox() ~= nil, input.KeyCode.Name, now, recent.current) then
+			return nil
+		end
+		recent.current = {
+			key = input.KeyCode.Name,
+			at = now,
+		}
+		local key = input.KeyCode
+		if not shown then
+			if active and key == Enum.KeyCode.Down then
+				openMenu()
+			end
+		elseif key == Enum.KeyCode.Up then
+			setHighlight(stepChoice(filtered, highlight, -1))
+		elseif key == Enum.KeyCode.Down then
+			setHighlight(stepChoice(filtered, highlight, 1))
+		elseif key == Enum.KeyCode.Return or key == Enum.KeyCode.KeypadEnter then
+			choose(highlight)
+		elseif #key.Name == 1 then
+			local letter = string.lower(key.Name)
+			local previous = typed.current
+			local text = if previous ~= nil and now - previous.at < 0.5 then `{previous.text}{letter}` else letter
+			typed.current = {
+				text = text,
+				at = now,
+			}
+			setHighlight(typeaheadChoice(filtered, highlight, text))
+		end
+	end
+	onKeyRef.current = onKey
+	useEffect(function()
+		if not shown and not focused then
+			return nil
+		end
+		local connection = UserInputService.InputBegan:Connect(function(input)
+			local _result_1 = onKeyRef.current
+			if _result_1 ~= nil then
+				_result_1 = _result_1(input, false)
+			end
+			return _result_1
+		end)
+		return function()
+			return connection:Disconnect()
+		end
+	end, { shown, focused })
+	useEffect(function()
+		if not shown or not anchor then
+			return nil
+		end
+		return function()
+			if canFocusGui(anchor) then
+				GuiService.SelectedObject = anchor
+			end
+		end
+	end, { shown, anchor })
+	useEffect(function()
+		if not shown or highlight < 0 then
+			return nil
+		end
+		local _result_1 = listRef.current
+		if _result_1 ~= nil then
+			_result_1.ensureVisible(rowForOption(rows, highlight))
+		end
+	end, { shown, highlight })
+	useEffect(function()
+		if shown then
+			setHeld(true)
+		end
+	end, { shown })
+	useEffect(function()
+		if loading and open then
+			setOpen(false)
+			setQuery("")
+		end
+	end, { loading, open })
+	useEffect(function()
+		local menu = menuRef.current
+		if not menu or not held then
+			return nil
+		end
+		local stop = playProperty(menu, {
+			GroupTransparency = if shown then 0 else 1,
+		}, 0.12, reducedMotion)
+		local seconds = menuHold(shown, reducedMotion)
+		if seconds == 0 then
+			if not shown then
+				setHeld(false)
+			end
+			return stop
+		end
+		local wait = task.delay(seconds, function()
+			return setHeld(false)
+		end)
+		return function()
+			stop()
+			task.cancel(wait)
+		end
+	end, { shown, held, reducedMotion })
+	local _attributes = {}
+	local _condition = id
+	if not (_condition ~= 0 and _condition == _condition and _condition ~= "" and _condition) then
+		_condition = "Select"
+	end
+	_attributes.key = _condition
+	_attributes.ref = ref
+	for _k, _v in styles.root do
+		_attributes[_k] = _v
+	end
+	if className then
+		for _k, _v in className do
+			_attributes[_k] = _v
+		end
+	end
+	if sx then
+		for _k, _v in sx do
+			_attributes[_k] = _v
+		end
+	end
+	local _attributes_1 = {
+		key = "Trigger",
+		ref = setAnchor,
+	}
+	for _k, _v in cx(styles.trigger, current == nil and styles.placeholder, not active and {
+		TextTransparency = 0.5,
+	}) do
+		_attributes_1[_k] = _v
+	end
+	local _result_1
+	if values ~= nil then
+		_result_1 = selectionLabel(options, values, placeholder)
+	else
+		local _result_2 = current
+		if _result_2 ~= nil then
+			_result_2 = _result_2.label
+		end
+		local _condition_1 = _result_2
+		if _condition_1 == nil then
+			_condition_1 = placeholder
+		end
+		_result_1 = _condition_1
+	end
+	_attributes_1.Text = _result_1
+	_attributes_1.Active = active
+	_attributes_1.Selectable = active
+	_attributes_1.Event = {
+		Activated = function()
+			if shown then
+				close()
+			elseif active then
+				openMenu()
+			end
+		end,
+		SelectionGained = function()
+			return setFocused(true)
+		end,
+		SelectionLost = function()
+			return setFocused(false)
+		end,
+		InputBegan = function(_, input)
+			return onKey(input, true)
+		end,
+	}
+	local _attributes_2 = table.clone(cx(styles.padding, loading and {
+		PaddingRight = UDim.new(0, theme.padding.calc(1.5) + spinnerPixels(size) + theme.padding.calc(1)),
+	}))
+	setmetatable(_attributes_2, nil)
+	local _exp = React.createElement("uipadding", _attributes_2)
+	local _attributes_3 = table.clone(styles.corner)
+	setmetatable(_attributes_3, nil)
+	local _exp_1 = React.createElement("uicorner", _attributes_3)
+	local _attributes_4 = table.clone(cx(styles.stroke, focused and styles.focusStroke))
+	setmetatable(_attributes_4, nil)
+	local _exp_2 = React.createElement("textbutton", _attributes_1, _exp, _exp_1, React.createElement("uistroke", _attributes_4), loading and (React.createElement(CircularProgress, {
+		size = spinnerPixels(size),
+		thickness = 2,
+		color = theme.palette.text.secondary,
+		reducedMotion = reducedMotion,
+		className = {
+			AnchorPoint = Vector2.new(1, 0.5),
+			Position = UDim2.new(1, -theme.padding.calc(1), 0.5, 0),
+		},
+	})))
+	local _condition_1 = (shown or held)
+	if _condition_1 then
+		local _attributes_5 = {
+			key = "Menu",
+		}
+		for _k, _v in styles.menu do
+			_attributes_5[_k] = _v
+		end
+		local _exp_3 = React.createElement(Shadow)
+		local _attributes_6 = table.clone(styles.corner)
+		setmetatable(_attributes_6, nil)
+		local _exp_4 = React.createElement("uicorner", _attributes_6)
+		local _attributes_7 = table.clone(styles.stroke)
+		setmetatable(_attributes_7, nil)
+		local _exp_5 = React.createElement("uistroke", _attributes_7)
+		local _exp_6 = React.createElement("uilistlayout", {
+			FillDirection = Enum.FillDirection.Vertical,
+			SortOrder = Enum.SortOrder.LayoutOrder,
+		})
+		local _condition_2 = search
+		if _condition_2 then
+			local _attributes_8 = {
+				key = "Search",
+			}
+			for _k, _v in styles.search do
+				_attributes_8[_k] = _v
+			end
+			_attributes_8.LayoutOrder = 1
+			_condition_2 = (React.createElement("frame", _attributes_8, React.createElement(Input, {
+				text = query,
+				placeholder = "Search",
+				width = UDim.new(1, 0),
+				onInput = function(text)
+					setQuery(text)
+					setHighlight(0)
+				end,
+			})))
+		end
+		_condition_1 = (React.createElement(Popup, {
+			anchor = anchor,
+			preferredHeight = menuHeight,
+			onDismiss = close,
+			onInput = function(input)
+				return onKey(input, true)
+			end,
+		}, React.createElement("canvasgroup", {
+			ref = menuRef,
+			Size = UDim2.fromScale(1, 1),
+			BackgroundTransparency = 1,
+			GroupTransparency = 1,
+		}, React.createElement("frame", _attributes_5, _exp_3, _exp_4, _exp_5, _exp_6, _condition_2, React.createElement("frame", {
+			key = "ListHost",
+			Size = UDim2.new(1, 0, 1, if search then -row else 0),
+			BackgroundTransparency = 1,
+			LayoutOrder = 2,
+		}, React.createElement(VirtualList, {
+			key = "Options",
+			items = rows,
+			getKey = function(row, index)
+				return `{row.kind}-{row.label}-{index}`
+			end,
+			itemHeight = row,
+			listRef = listRef,
+			className = styles.list,
+			renderItem = function(row)
+				if row.kind == "header" then
+					local _attributes_8 = table.clone(styles.group)
+					setmetatable(_attributes_8, nil)
+					_attributes_8.Text = row.label
+					local _attributes_9 = table.clone(styles.padding)
+					setmetatable(_attributes_9, nil)
+					return React.createElement("textlabel", _attributes_8, React.createElement("uipadding", _attributes_9))
+				end
+				local index = row.optionIndex
+				local picked = if values ~= nil then includesChoice(values, filtered[index + 1].value) else filtered[index + 1].value == value
+				local _attributes_8 = {
+					ref = function(button)
+						if button and index == highlight and canFocusGui(button) then
+							GuiService.SelectedObject = button
+						end
+					end,
+				}
+				for _k, _v in cx(styles.option, picked and styles.selected, index == highlight and styles.highlighted, row.disabled == true and styles.disabledOption) do
+					_attributes_8[_k] = _v
+				end
+				_attributes_8.Text = optionLabel(row.label, picked)
+				_attributes_8.Active = row.disabled ~= true
+				_attributes_8.Selectable = row.disabled ~= true
+				_attributes_8.Event = {
+					Activated = function()
+						return choose(index, true)
+					end,
+					MouseEnter = function()
+						if row.disabled ~= true then
+							setHighlight(index)
+						end
+					end,
+					SelectionGained = function()
+						return setHighlight(index)
+					end,
+					InputBegan = function(_, input)
+						return onKey(input, true)
+					end,
+				}
+				local _attributes_9 = table.clone(styles.padding)
+				setmetatable(_attributes_9, nil)
+				return React.createElement("textbutton", _attributes_8, React.createElement("uipadding", _attributes_9))
+			end,
+		}))))))
+	end
+	return React.createElement("frame", _attributes, _exp_2, _condition_1)
+end
+local default = Select
+return {
+	default = default,
+}

package/out/ui/packages/select/components/Select.styles.d.ts

@@ -0,0 +1,6 @@
+import { ControlSize } from "../../../../theme/index";
+export interface SelectStyleProps {
+    size?: ControlSize;
+}
+declare const useSelectStyles: (props: SelectStyleProps) => import("../../../../theme/index").ClassNameMap<string>;
+export default useSelectStyles;

package/out/ui/packages/select/components/Select.styles.luau

@@ -0,0 +1,104 @@
+-- Compiled with roblox-ts v3.0.0
+local TS = _G[script]
+local _theme = TS.import(script, script.Parent.Parent.Parent.Parent.Parent, "theme")
+local controlMetrics = _theme.controlMetrics
+local createStyles = _theme.createStyles
+local componentStyles = _theme.componentStyles
+local useSelectStyles = componentStyles("Select", function(theme, _param)
+	local size = _param.size
+	local metrics = controlMetrics(theme.density, size)
+	return createStyles({
+		root = {
+			Size = UDim2.fromOffset(theme.spacing.calc(12), metrics.height),
+			BackgroundTransparency = 1,
+			BorderSizePixel = 0,
+		},
+		trigger = {
+			Size = UDim2.fromScale(1, 1),
+			BackgroundColor3 = theme.palette.surface.input,
+			BorderSizePixel = 0,
+			AutoButtonColor = false,
+			TextColor3 = theme.palette.text.primary,
+			Font = theme.typography.fontFamilies.default,
+			TextSize = metrics.font,
+			TextXAlignment = Enum.TextXAlignment.Left,
+			TextTruncate = Enum.TextTruncate.AtEnd,
+		},
+		placeholder = {
+			TextColor3 = theme.palette.text.secondary,
+		},
+		padding = {
+			PaddingLeft = UDim.new(0, theme.padding.calc(1.5)),
+			PaddingRight = UDim.new(0, theme.padding.calc(1.5)),
+		},
+		menu = {
+			Size = UDim2.fromScale(1, 1),
+			BackgroundColor3 = theme.palette.surface.elevated,
+			BorderSizePixel = 0,
+			ZIndex = 20001,
+		},
+		search = {
+			Size = UDim2.new(1, 0, 0, metrics.height),
+			BackgroundTransparency = 1,
+			ZIndex = 20002,
+		},
+		list = {
+			Size = UDim2.fromScale(1, 1),
+			BackgroundColor3 = theme.palette.surface.elevated,
+			BorderSizePixel = 0,
+			ScrollBarThickness = theme.padding.default,
+			ScrollBarImageColor3 = theme.palette.text.secondary,
+			ScrollingDirection = Enum.ScrollingDirection.Y,
+			ZIndex = 20001,
+		},
+		option = {
+			Size = UDim2.fromScale(1, 1),
+			BackgroundColor3 = theme.palette.action.hover,
+			BackgroundTransparency = 1,
+			BorderSizePixel = 0,
+			AutoButtonColor = false,
+			TextColor3 = theme.palette.text.primary,
+			Font = theme.typography.fontFamilies.default,
+			TextSize = metrics.font,
+			TextXAlignment = Enum.TextXAlignment.Left,
+			TextTruncate = Enum.TextTruncate.AtEnd,
+			ZIndex = 20002,
+		},
+		highlighted = {
+			BackgroundTransparency = 0,
+		},
+		selected = {
+			BackgroundColor3 = theme.palette.action.selected,
+			BackgroundTransparency = 0,
+		},
+		group = {
+			Size = UDim2.fromScale(1, 1),
+			BackgroundTransparency = 1,
+			BorderSizePixel = 0,
+			TextColor3 = theme.palette.text.secondary,
+			Font = theme.typography.fontFamilies.default,
+			TextSize = metrics.font,
+			TextXAlignment = Enum.TextXAlignment.Left,
+			ZIndex = 20002,
+		},
+		disabledOption = {
+			TextTransparency = 0.5,
+		},
+		corner = {
+			CornerRadius = UDim.new(0, theme.shape.borderRadius),
+		},
+		stroke = {
+			Color = theme.palette.border,
+			ApplyStrokeMode = Enum.ApplyStrokeMode.Border,
+		},
+		focusStroke = {
+			Color = theme.palette.focus,
+			Thickness = 2,
+			ApplyStrokeMode = Enum.ApplyStrokeMode.Border,
+		},
+	})
+end)
+local default = useSelectStyles
+return {
+	default = default,
+}

package/out/ui/packages/select/components/optionLabel.d.ts

@@ -0,0 +1 @@
+export declare function optionLabel(label: string, picked: boolean): string;

package/out/ui/packages/select/components/optionLabel.luau

@@ -0,0 +1,7 @@
+-- Compiled with roblox-ts v3.0.0
+local function optionLabel(label, picked)
+	return if picked then `✓ {label}` else label
+end
+return {
+	optionLabel = optionLabel,
+}

package/out/ui/packages/select/components/selectFilter.d.ts

@@ -0,0 +1,4 @@
+export declare function filterChoices<T extends {
+    label: string;
+}>(options: T[], query: string): T[];
+export declare function usesSelectSearch(count: number, searchable?: boolean): boolean;

package/out/ui/packages/select/components/selectFilter.luau

@@ -0,0 +1,27 @@
+-- Compiled with roblox-ts v3.0.0
+local function filterChoices(options, query)
+	if #query == 0 then
+		return options
+	end
+	local needle = string.lower(query)
+	local matched = {}
+	for _, option in options do
+		if (string.find(string.lower(option.label), needle, 1, true)) ~= nil then
+			table.insert(matched, option)
+		end
+	end
+	return matched
+end
+local function usesSelectSearch(count, searchable)
+	if searchable == false then
+		return false
+	end
+	if searchable == true then
+		return true
+	end
+	return count > 8
+end
+return {
+	filterChoices = filterChoices,
+	usesSelectSearch = usesSelectSearch,
+}

package/out/ui/packages/select/components/selectFocus.d.ts

@@ -0,0 +1,4 @@
+export declare function canFocusGui(object?: {
+    Parent?: unknown;
+    FindFirstAncestorWhichIsA?(className: string): unknown;
+}): boolean;

package/out/ui/packages/select/components/selectFocus.luau

@@ -0,0 +1,16 @@
+-- Compiled with roblox-ts v3.0.0
+local function canFocusGui(object)
+	local _condition = object ~= nil and object.Parent ~= nil
+	if _condition then
+		local _self = object
+		local _result = _self.FindFirstAncestorWhichIsA
+		if _result ~= nil then
+			_result = _result(_self, "PlayerGui")
+		end
+		_condition = _result ~= nil
+	end
+	return _condition
+end
+return {
+	canFocusGui = canFocusGui,
+}

package/out/ui/packages/select/components/selectGroups.d.ts

@@ -0,0 +1,18 @@
+export interface GroupedChoice {
+    label: string;
+    disabled?: boolean;
+    group?: string;
+}
+export interface SelectHeaderRow {
+    kind: "header";
+    label: string;
+}
+export interface SelectOptionRow {
+    kind: "option";
+    label: string;
+    optionIndex: number;
+    disabled?: boolean;
+}
+export type SelectRow = SelectHeaderRow | SelectOptionRow;
+export declare function groupRows(options: GroupedChoice[]): SelectRow[];
+export declare function rowForOption(rows: SelectRow[], optionIndex: number): number;

package/out/ui/packages/select/components/selectGroups.luau

@@ -0,0 +1,38 @@
+-- Compiled with roblox-ts v3.0.0
+local function groupRows(options)
+	local rows = {}
+	local current = ""
+	for index = 0, #options - 1 do
+		local option = options[index + 1]
+		local group = option.group
+		if group ~= nil and group ~= current then
+			current = group
+			local _arg0 = {
+				kind = "header",
+				label = group,
+			}
+			table.insert(rows, _arg0)
+		end
+		local _arg0 = {
+			kind = "option",
+			label = option.label,
+			optionIndex = index,
+			disabled = option.disabled,
+		}
+		table.insert(rows, _arg0)
+	end
+	return rows
+end
+local function rowForOption(rows, optionIndex)
+	for index = 0, #rows - 1 do
+		local row = rows[index + 1]
+		if row.kind == "option" and row.optionIndex == optionIndex then
+			return index
+		end
+	end
+	return 0
+end
+return {
+	groupRows = groupRows,
+	rowForOption = rowForOption,
+}

package/out/ui/packages/select/components/selectKey.d.ts

@@ -0,0 +1,4 @@
+export declare function shouldHandleSelectKey(open: boolean, focused: boolean, fromControl: boolean, textboxFocused: boolean, key: string, now: number, previous?: {
+    key: string;
+    at: number;
+}): boolean;