%s?") then
+ local quote = {}
+ while index <= #lines and lines[index]:match("^%s*>%s?") do
+ table.insert(quote, trim(lines[index]:gsub("^%s*>%s?", "")))
+ index = index + 1
+ end
+ table.insert(blocks, { Type = "Quote", Value = table.concat(quote, "\n") })
+ elseif line:match("^%s*[-*+]%s+") or line:match("^%s*%d+[%.%)]%s+") then
+ local ordered = line:match("^%s*%d+[%.%)]%s+") ~= nil
+ local items = {}
+ while index <= #lines do
+ local indent, marker, item
+ if ordered then
+ indent, marker, item = lines[index]:match("^(%s*)(%d+)[%.%)]%s+(.+)$")
+ else
+ indent, item = lines[index]:match("^(%s*)[-*+]%s+(.+)$")
+ end
+ if not item then break end
+ local taskState, taskValue = item:match("^%[([xX ])%]%s*(.*)$")
+ table.insert(items, {
+ Value = taskValue or item,
+ Level = math.floor(#(indent or "") / 2),
+ Checked = taskState and taskState:lower() == "x" or nil,
+ })
+ index = index + 1
+ end
+ table.insert(blocks, { Type = "List", Ordered = ordered, Items = items })
+ elseif line:find("|", 1, true) and isTableDivider(lines[index + 1] or "") then
+ local header = parseTableRow(line)
+ local alignments = parseTableAlignments(lines[index + 1])
+ local rows = {}
+ index = index + 2
+ while index <= #lines and lines[index]:find("|", 1, true) and trim(lines[index]) ~= "" do
+ table.insert(rows, parseTableRow(lines[index]))
+ index = index + 1
+ end
+ table.insert(blocks, { Type = "Table", Header = header, Rows = rows, Alignments = alignments })
+ else
+ local paragraph = { trim(line) }
+ index = index + 1
+ while index <= #lines and trim(lines[index]) ~= "" and not isBlockStart(lines, index) do
+ table.insert(paragraph, trim(lines[index]))
+ index = index + 1
+ end
+ table.insert(blocks, { Type = "Paragraph", Value = table.concat(paragraph, "\n") })
+ end
+ end
+ end
+
+ return blocks
+end
+
+local function makeText(parent, text, options)
+ options = options or {}
+ return New("TextLabel", {
+ Parent = parent,
+ Size = UDim2.new(1, 0, 0, 0),
+ AutomaticSize = "Y",
+ BackgroundTransparency = 1,
+ Text = inline(text),
+ TextWrapped = true,
+ TextXAlignment = options.Alignment or "Left",
+ TextYAlignment = options.VerticalAlignment or "Top",
+ TextSize = options.Size or 16,
+ TextTransparency = options.Transparency or 0,
+ LineHeight = options.LineHeight or 1.2,
+ FontFace = Font.new(Creator.Font, options.Weight or Enum.FontWeight.Medium),
+ ThemeTag = { TextColor3 = options.Theme or "Text" },
+ })
+end
+
+local function makeCard(parent, config, options)
+ options = options or {}
+ local card = Creator.NewRoundFrame(config.Radius or config.Window.ElementConfig.UICorner, "Squircle", {
+ Parent = parent,
+ Size = UDim2.new(1, 0, 0, options.Height or 0),
+ AutomaticSize = options.Height and "None" or "Y",
+ ImageTransparency = options.Transparency or 0.94,
+ ThemeTag = { ImageColor3 = options.Theme or "Text" },
+ })
+ return card
+end
+
+local function setRowCorners(row, radius, top, bottom)
+ local corner = New("UICorner", {
+ Parent = row,
+ CornerRadius = UDim.new(0, radius),
+ })
+ pcall(function()
+ corner.TopLeftRadius = top and UDim.new(0, radius) or UDim.new(0, 0)
+ corner.TopRightRadius = top and UDim.new(0, radius) or UDim.new(0, 0)
+ corner.BottomLeftRadius = bottom and UDim.new(0, radius) or UDim.new(0, 0)
+ corner.BottomRightRadius = bottom and UDim.new(0, radius) or UDim.new(0, 0)
+ end)
+end
+
+local function renderTable(parent, block, config)
+ local minimumCellWidth = config.TableCellWidth or 110
+ local cellPadding = config.TableCellPadding or 16
+ local textAlignment = config.TableTextAlignment
+ local columns = #block.Header
+ local rowHeight = config.TableRowHeight or 40
+ local contentHeight = (#block.Rows + 1) * rowHeight
+ local height = math.min(contentHeight, config.TableMaxHeight or 240)
+ local card = makeCard(parent, config, { Height = height + 2, Transparency = 0.965 })
+ local scroller = New("ScrollingFrame", {
+ Parent = card,
+ Size = UDim2.new(1, -2, 1, -2),
+ Position = UDim2.new(0, 1, 0, 1),
+ CanvasSize = UDim2.new(0, columns * minimumCellWidth, 0, height),
+ ScrollingDirection = "XY",
+ ElasticBehavior = "Never",
+ ScrollBarThickness = 3,
+ BackgroundTransparency = 1,
+ })
+ local holder = New("Frame", {
+ Parent = scroller,
+ Size = UDim2.new(0, columns * minimumCellWidth, 0, contentHeight),
+ BackgroundTransparency = 1,
+ })
+ New("UIListLayout", { Parent = holder, FillDirection = "Vertical", Padding = UDim.new(0, 1) })
+ local cells = {}
+
+ local function addRow(values, isHeader, isLast)
+ local row = New("Frame", {
+ Parent = holder,
+ Size = UDim2.new(1, 0, 0, rowHeight - 1),
+ BackgroundTransparency = isHeader and 0.86 or 0.95,
+ ThemeTag = { BackgroundColor3 = isHeader and "Primary" or "Text" },
+ })
+ setRowCorners(row, math.max((config.Radius or config.Window.ElementConfig.UICorner) - 3, 0), isHeader, isLast)
+ New("UIListLayout", { Parent = row, FillDirection = "Horizontal", Padding = UDim.new(0, 1) })
+ for column = 1, columns do
+ local label = makeText(row, values[column] or "", {
+ Size = 14,
+ Weight = isHeader and Enum.FontWeight.SemiBold or Enum.FontWeight.Medium,
+ Transparency = isHeader and 0 or 0.22,
+ Alignment = textAlignment or block.Alignments[column] or "Left",
+ VerticalAlignment = "Center",
+ })
+ label.Size = UDim2.new(0, minimumCellWidth - 1, 1, 0)
+ label.AutomaticSize = "None"
+ New("UIPadding", {
+ Parent = label,
+ PaddingLeft = UDim.new(0, cellPadding), PaddingRight = UDim.new(0, cellPadding),
+ PaddingTop = UDim.new(0, 5), PaddingBottom = UDim.new(0, 5),
+ })
+ table.insert(cells, label)
+ end
+ end
+
+ addRow(block.Header, true, #block.Rows == 0)
+ for rowIndex, row in next, block.Rows do addRow(row, false, rowIndex == #block.Rows) end
+
+ local function updateWidth()
+ local availableWidth = scroller.AbsoluteSize.X
+ if availableWidth <= 0 then return end
+
+ local tableWidth = math.max(availableWidth, columns * minimumCellWidth)
+ local cellWidth = math.floor(tableWidth / columns)
+ holder.Size = UDim2.new(0, tableWidth, 0, contentHeight)
+ scroller.CanvasSize = UDim2.new(0, tableWidth, 0, contentHeight)
+ for _, label in next, cells do
+ label.Size = UDim2.new(0, cellWidth - 1, 1, 0)
+ end
+ end
+
+ Creator.AddSignal(scroller:GetPropertyChangedSignal("AbsoluteSize"), updateWidth)
+ task.defer(updateWidth)
+ return card
+end
+
+function Element:New(config)
+ local markdown = {
+ __type = "Markdown",
+ Content = config.Content or config.Markdown or "",
+ Elements = {},
+ Locked = config.Locked or false,
+ }
+ local root = New("Frame", {
+ Parent = config.Parent,
+ Size = UDim2.new(1, 0, 0, 0),
+ AutomaticSize = "Y",
+ BackgroundTransparency = 1,
+ })
+ New("UIListLayout", { Parent = root, FillDirection = "Vertical", Padding = UDim.new(0, config.Gap or 10) })
+ markdown.ElementFrame = root
+
+ local function render(content)
+ root:ClearAllChildren()
+ New("UIListLayout", { Parent = root, FillDirection = "Vertical", Padding = UDim.new(0, config.Gap or 10) })
+ markdown.Elements = {}
+ for _, block in next, parse(content) do
+ local object
+ if block.Type == "Heading" then
+ object = makeText(root, block.Value, {
+ Size = ({ 28, 23, 20, 18, 17, 16 })[math.min(block.Level, 6)],
+ Weight = Enum.FontWeight.Bold,
+ })
+ elseif block.Type == "Paragraph" then
+ object = makeText(root, block.Value, { Transparency = 0.16 })
+ elseif block.Type == "Divider" then
+ object = New("Frame", { Parent = root, Size = UDim2.new(1, 0, 0, 1), BackgroundTransparency = 0.78, ThemeTag = { BackgroundColor3 = "Text" } })
+ elseif block.Type == "Quote" then
+ object = makeCard(root, config, { Transparency = 0.955 })
+ New("UIPadding", { Parent = object, PaddingLeft = UDim.new(0, 16), PaddingRight = UDim.new(0, 12), PaddingTop = UDim.new(0, 10), PaddingBottom = UDim.new(0, 10) })
+ New("Frame", { Parent = object, Size = UDim2.new(0, 3, 1, -16), Position = UDim2.new(0, 7, 0, 8), BackgroundTransparency = 0, ThemeTag = { BackgroundColor3 = "Primary" } }, { New("UICorner", { CornerRadius = UDim.new(1, 0) }) })
+ makeText(object, block.Value, { Transparency = 0.12, LineHeight = 1.25 })
+ elseif block.Type == "List" then
+ object = New("Frame", { Parent = root, Size = UDim2.new(1, 0, 0, 0), AutomaticSize = "Y", BackgroundTransparency = 1 })
+ New("UIListLayout", { Parent = object, FillDirection = "Vertical", Padding = UDim.new(0, 5) })
+ for itemIndex, item in next, block.Items do
+ local prefix = string.rep(" ", item.Level or 0)
+ if item.Checked ~= nil then
+ prefix ..= item.Checked and "☑ " or "☐ "
+ else
+ prefix ..= block.Ordered and (itemIndex .. ". ") or "• "
+ end
+ makeText(object, prefix .. item.Value, { Transparency = 0.16 })
+ end
+ elseif block.Type == "Code" then
+ local code = CodeComponent.New({ Title = block.Language ~= "" and block.Language or nil, Code = block.Value, CodeSize = 15, CanCopied = true }, config.Window, root, nil, config.UIScale)
+ object = code.CodeFrame
+ elseif block.Type == "Table" then
+ object = renderTable(root, block, config)
+ elseif block.Type == "Image" then
+ object = makeCard(root, config, { Transparency = 0.965 })
+ New("UIListLayout", { Parent = object, FillDirection = "Vertical", Padding = UDim.new(0, 8) })
+ New("UIPadding", { Parent = object, PaddingTop = UDim.new(0, 7), PaddingBottom = UDim.new(0, 9), PaddingLeft = UDim.new(0, 7), PaddingRight = UDim.new(0, 7) })
+ local image = Creator.Image(block.Source, block.Alt, math.max((config.Radius or config.Window.ElementConfig.UICorner) - 4, 0), config.Window.Folder, "Markdown", false)
+ image.Parent = object
+ image.Size = UDim2.new(1, 0, 0, config.ImageHeight or 220)
+ if block.Alt ~= "" then
+ local caption = makeText(object, block.Alt, { Size = 13, Transparency = 0.38 })
+ New("UIPadding", { Parent = caption, PaddingLeft = UDim.new(0, 3), PaddingRight = UDim.new(0, 3) })
+ end
+ elseif block.Type == "Video" then
+ local _, video = VideoElement:New({
+ Parent = root, Window = config.Window, Video = block.Source,
+ AspectRatio = config.VideoAspectRatio or "16:9", Autoplay = block.Autoplay,
+ Loop = block.Looped, Muted = block.Muted, Volume = config.VideoVolume or 0,
+ Height = config.VideoHeight or 220,
+ })
+ object = video.ElementFrame
+ end
+ if object then table.insert(markdown.Elements, object) end
+ end
+ end
+
+ function markdown:SetContent(content)
+ markdown.Content = content or ""
+ render(markdown.Content)
+ return markdown
+ end
+ function markdown:Set(content) return markdown:SetContent(content) end
+ function markdown:Destroy() root:Destroy() end
+
+ render(markdown.Content)
+ return markdown.__type, markdown
+end
+
+return Element
diff --git a/src/elements/Video.lua b/src/elements/Video.lua
index 29a6d42a..094bc622 100644
--- a/src/elements/Video.lua
+++ b/src/elements/Video.lua
@@ -1,93 +1,65 @@
---- VideoFrame is not working with custom video on exploits
-
local Creator = require("../modules/Creator")
local New = Creator.New
local Element = {}
-local function ParseAspectRatio(aspectRatio)
- if type(aspectRatio) == "string" then
- local width, height = aspectRatio:match("(%d+):(%d+)")
- if width and height then
- return tonumber(width) / tonumber(height)
- end
- elseif type(aspectRatio) == "number" then
- return aspectRatio
- end
- return nil
+local function getAspectRatio(value)
+ if type(value) == "number" then return value end
+ local width, height = tostring(value or "16:9"):match("(%d+):(%d+)")
+ return width and tonumber(width) / tonumber(height) or (16 / 9)
end
+local function resolveVideo(source, folder, callback, forceExtension)
+ if not source:find("^https?://") then callback(source) return end
+ task.spawn(function()
+ local extension = forceExtension or source:lower():match("%.([a-z0-9]+)[%?&]?") or "webm"
+ local fileName = "WindUI/" .. (folder or "Temp") .. "/assets/.Video-" .. Creator.SanitizeFilename(source) .. "." .. extension
+ if not (isfile and isfile(fileName)) then
+ local success, response = pcall(function()
+ return Creator.Request and Creator.Request({ Url = source, Method = "GET" }).Body or game:HttpGet(source)
+ end)
+ if not success or not response then warn("[ WindUI.Video ] Failed to download video: " .. tostring(response)) return end
+ if writefile then writefile(fileName, response) end
+ end
+ local success, asset = pcall(getcustomasset, fileName)
+ if success then callback(asset) else warn("[ WindUI.Video ] Failed to load custom asset: " .. tostring(asset)) end
+ end)
+end
-function Element:New(Config)
- local VideoModule = {
- __type = "Video",
- Video = Config.Video or "",
- AspectRatio = Config.AspectRatio or "16:9",
- Radius = Config.Radius or Config.Window.ElementConfig.UICorner,
- }
-
- local MainVideo
-
- if VideoModule.Video then
- local BGVideo
- if string.find(VideoModule.Video, "http") then
- local videoPath = Config.Window.Folder .. "/assets/." .. Creator.SanitizeFilename(VideoModule.Video) .. ".webm"
- if not isfile(videoPath) then
- local success, result = pcall(function()
- local response = Creator.Request({Url = VideoModule.Video, Method="GET", Headers = { ["User-Agent"] = "Roblox/Exploit" }})
- writefile(videoPath, response.Body)
- end)
- if not success then
- warn("[ Window.Background ] Failed to download video: " .. tostring(result))
- return
- end
- end
-
- local success, customAsset = pcall(function()
- return getcustomasset(videoPath)
- end)
- if not success then
- warn("[ Window.Background ] Failed to load custom asset: " .. tostring(customAsset))
- end
- BGVideo = customAsset
- else
- BGVideo = VideoModule.Video
- end
-
- MainVideo = New("VideoFrame", {
- BackgroundTransparency = 1,
- Size = UDim2.new(1,0,1,0),
- Video = BGVideo,
- Looped = false,
- Volume = 0,
- Parent = Config.Parent
- }, {
- New("UICorner", {
- CornerRadius = UDim.new(0,VideoModule.Radius)
- }),
- })
- MainVideo:Play()
-
-
- local aspectRatio = ParseAspectRatio(VideoModule.AspectRatio)
- local aspectRatioConstraint = nil
-
- if aspectRatio then
- aspectRatioConstraint = New("UIAspectRatioConstraint", {
- Parent = MainVideo,
- AspectRatio = aspectRatio,
- AspectType = "ScaleWithParentSize",
- DominantAxis = "Width"
- })
- end
- end
-
-
- function VideoModule:Destroy()
- if MainVideo then MainVideo:Destroy() end
- end
-
- return VideoModule.__type, VideoModule
+function Element:New(config)
+ local video = { __type = "Video", Source = config.Video or config.Source or "", ElementFrame = nil }
+ local isGif = video.Source:lower():match("%.gif[%?&]?") ~= nil
+ local radius = config.Radius or config.Window.ElementConfig.UICorner
+ local cardTransparency = config.Window.Background and math.max(config.Window.BackgroundElementTransparency or 0, 0.9) or 0.965
+ local card = Creator.NewRoundFrame(radius, "Squircle", {
+ Parent = config.Parent, Size = UDim2.new(1, 0, 0, config.Height or 220), ImageTransparency = cardTransparency,
+ ThemeTag = { ImageColor3 = "Text" },
+ })
+ local frame = New(isGif and "ImageLabel" or "VideoFrame", {
+ Parent = card, Size = UDim2.new(1, -10, 1, -10), Position = UDim2.new(0, 5, 0, 5), BackgroundTransparency = 1,
+ Looped = not isGif and config.Loop == true or nil, Volume = not isGif and (config.Muted ~= false and 0 or (config.Volume or 1)) or nil,
+ ScaleType = isGif and "Crop" or nil,
+ })
+ New("UICorner", { Parent = frame, CornerRadius = UDim.new(0, math.max(radius - 4, 0)) })
+ video.ElementFrame = card
+ video.UIElements = { Main = card, Video = frame }
+ local assetSource = video.Source
+ if isGif and assetSource:find("discordapp%.net") then
+ assetSource = assetSource .. (assetSource:find("?", 1, true) and "&" or "?") .. "format=png"
+ end
+ resolveVideo(assetSource, config.Window.Folder, function(asset)
+ if not frame.Parent then return end
+ if isGif then
+ frame.Image = asset
+ else
+ frame.Video = asset
+ if config.Autoplay ~= false then frame:Play() end
+ end
+ end, isGif and "png" or nil)
+ function video:Play() if not isGif then frame:Play() end end
+ function video:Pause() if not isGif then frame:Pause() end end
+ function video:Destroy() card:Destroy() end
+ return video.__type, video
end
-return Element
\ No newline at end of file
+return Element
diff --git a/src/modules/Creator.lua b/src/modules/Creator.lua
index 073eeeab..905c9966 100644
--- a/src/modules/Creator.lua
+++ b/src/modules/Creator.lua
@@ -794,7 +794,10 @@ function Creator.Image(Img, Name, Corner, Folder, Type, IsThemeTag, Themed, Them
local assetSuccess, asset = pcall(getcustomasset, FileName)
if assetSuccess then
- ImageFrame.ImageLabel.Image = asset
+ local ImageLabel = ImageFrame:FindFirstChild("ImageLabel")
+ if ImageLabel then
+ ImageLabel.Image = asset
+ end
else
warn(
string.format(
@@ -820,7 +823,10 @@ function Creator.Image(Img, Name, Corner, Folder, Type, IsThemeTag, Themed, Them
elseif Img == "" then
ImageFrame.Visible = false
else
- ImageFrame.ImageLabel.Image = Img
+ local ImageLabel = ImageFrame:FindFirstChild("ImageLabel")
+ if ImageLabel then
+ ImageLabel.Image = Img
+ end
end
return ImageFrame
diff --git a/src/modules/Persistence.lua b/src/modules/Persistence.lua
new file mode 100644
index 00000000..27278008
--- /dev/null
+++ b/src/modules/Persistence.lua
@@ -0,0 +1,77 @@
+local HttpService = game:GetService("HttpService")
+
+local Persistence = {}
+
+local function ensureFolder(path)
+ if not isfolder or not makefolder then return false, "Filesystem API is unavailable" end
+ if not isfolder(path) then makefolder(path) end
+ return true
+end
+
+local function encodeValue(value)
+ local valueType = typeof(value)
+ if valueType == "Color3" then
+ return { __winduiType = "Color3", value = value:ToHex() }
+ end
+ if valueType == "string" or valueType == "number" or valueType == "boolean" then
+ return value
+ end
+ if valueType == "table" then
+ local result = {}
+ for key, child in next, value do
+ if typeof(key) == "string" or typeof(key) == "number" then
+ local encoded = encodeValue(child)
+ if encoded ~= nil then result[key] = encoded end
+ end
+ end
+ return result
+ end
+ return nil
+end
+
+local function decodeValue(value)
+ if typeof(value) ~= "table" then return value end
+ if value.__winduiType == "Color3" and typeof(value.value) == "string" then
+ return Color3.fromHex(value.value)
+ end
+ local result = {}
+ for key, child in next, value do
+ if key ~= "__winduiType" then result[key] = decodeValue(child) end
+ end
+ return result
+end
+
+function Persistence.WriteJson(path, value)
+ if not writefile then return false, "Filesystem API is unavailable" end
+ local ok, encoded = pcall(function() return HttpService:JSONEncode(encodeValue(value)) end)
+ if not ok then return false, tostring(encoded) end
+ local wrote, err = pcall(writefile, path, encoded)
+ if not wrote then return false, tostring(err) end
+ return true
+end
+
+function Persistence.ReadJson(path)
+ if not isfile or not readfile then return false, "Filesystem API is unavailable" end
+ if not isfile(path) then return false, "File does not exist" end
+ local ok, decoded = pcall(function() return HttpService:JSONDecode(readfile(path)) end)
+ if not ok then return false, tostring(decoded) end
+ return true, decodeValue(decoded)
+end
+
+function Persistence.ListJson(path)
+ if not listfiles then return {} end
+ local ok = ensureFolder(path)
+ if not ok then return {} end
+ local files = {}
+ for _, file in next, listfiles(path) do
+ if file:sub(-5) == ".json" then table.insert(files, file) end
+ end
+ table.sort(files)
+ return files
+end
+
+function Persistence.EnsureFolder(path)
+ return ensureFolder(path)
+end
+
+return Persistence
diff --git a/tests/FeatureShowcase.lua b/tests/FeatureShowcase.lua
new file mode 100644
index 00000000..6b44a1c5
--- /dev/null
+++ b/tests/FeatureShowcase.lua
@@ -0,0 +1,327 @@
+local WindUI = require("../src/Init")
+
+local BackgroundImage = "https://a.storyblok.com/f/178900/1000x563/f3bbac17df/wistoria-wand-and-sword-elfaria-trailer-screen.jpg/m/filters:quality(95)format(webp)"
+
+local Window = WindUI:CreateWindow({
+ Title = "WindUI Feature Showcase",
+ Author = "Markdown, media and mobile UI",
+ Folder = "WindUI_Feature_Showcase",
+ Size = UDim2.fromOffset(760, 560),
+ Background = BackgroundImage,
+ BackgroundImageTransparency = 0,
+ BackgroundOverlayTransparency = 0.5,
+ SidebarBackgroundTransparency = 0.22,
+ Mobile = {
+ SideBarWidth = 250,
+ Padding = 8,
+ Gap = 8,
+ },
+})
+
+local ShowcasePlugin = WindUI:GetPlugin("Showcase Tools") or WindUI:AddPlugin({
+ Name = "Showcase Tools",
+ Version = "1.0.0",
+ Init = function(api)
+ api.ShowcasePluginLoaded = true
+ end,
+})
+
+local Overview = Window:Tab({ Title = "Overview", Icon = "layout-dashboard" })
+Overview:Paragraph({
+ Title = "Complete feature preview",
+ Desc = "The window background is dimmed, while the mobile sidebar uses its own animated surface.",
+})
+Overview:Button({
+ Title = "Open command palette",
+ Icon = "search",
+ Callback = function()
+ Window:OpenCommandPalette()
+ end,
+})
+
+local ElementsTab = Window:Tab({ Title = "Elements", Icon = "blocks" })
+ElementsTab:Paragraph({ Title = "Core controls", Desc = "Every common interactive element is available in this test." })
+ElementsTab:Button({ Title = "Button", Desc = "Callback test", Icon = "mouse-pointer-click", Callback = function() print("[WindUI/Showcase] button pressed") end })
+ElementsTab:Toggle({ Title = "Toggle", Desc = "Boolean state", Value = true, Flag = "showcase_toggle" })
+ElementsTab:Slider({
+ Title = "Slider",
+ Value = { Min = 0, Max = 100, Default = 42 },
+ Step = 1,
+ Flag = "showcase_slider",
+})
+ElementsTab:ProgressBar({ Title = "Progress bar", Value = { Min = 0, Max = 100, Default = 68 } })
+ElementsTab:Input({ Title = "Input", Desc = "Text value", Value = "WindUI", Placeholder = "Enter text", Flag = "showcase_input" })
+ElementsTab:Dropdown({ Title = "Dropdown", Values = { "Dark", "Light", "Rose" }, Value = "Dark", Flag = "showcase_dropdown" })
+ElementsTab:Keybind({ Title = "Keybind", Value = "K", Flag = "showcase_keybind" })
+ElementsTab:Colorpicker({ Title = "Colorpicker", Default = Color3.fromHex("#8B5CF6"), Flag = "showcase_color" })
+ElementsTab:Divider()
+ElementsTab:Code({ Title = "Code", Code = "print('WindUI showcase')", CodeSize = 14 })
+ElementsTab:Space({ Columns = 1 })
+
+local LayoutSection = ElementsTab:Section({
+ Title = "Layout elements",
+ Desc = "Section, stacks and grouped controls are rendered here.",
+ Icon = "layout-panel-top",
+ Box = true,
+ Opened = true,
+})
+local Actions = LayoutSection:HStack({ AutoSpace = true })
+Actions:Button({ Title = "Left action", Icon = "chevron-left", Callback = function() end })
+Actions:Button({ Title = "Right action", Icon = "chevron-right", Callback = function() end })
+local Vertical = LayoutSection:VStack()
+Vertical:Paragraph({ Title = "VStack", Desc = "Vertical content keeps the regular responsive width." })
+local Group = LayoutSection:Group()
+Group:Toggle({ Title = "Grouped toggle", Value = false })
+Group:Button({ Title = "Grouped button", Callback = function() end })
+
+local ViewportPart = Instance.new("Part")
+ViewportPart.Name = "ShowcasePart"
+ViewportPart.Size = Vector3.new(4, 4, 4)
+ViewportPart.Color = Color3.fromHex("#8B5CF6")
+ViewportPart.Material = Enum.Material.Neon
+ElementsTab:Viewport({ Object = ViewportPart, Height = 150, Interactive = true })
+ElementsTab:Image({ Image = "https://raw.githubusercontent.com/Footagesus/WindUI/main/docs/banner-dark.png", AspectRatio = "16:9" })
+ElementsTab:Video({ Video = "rbxassetid://5608384572", Height = 160, Autoplay = false })
+Overview:Button({
+ Title = "Toggle sidebar",
+ Desc = "Works on desktop and mobile",
+ Icon = "panel-left",
+ Callback = function()
+ Window:ToggleSidebar()
+ end,
+})
+
+local MarkdownTab = Window:Tab({ Title = "Markdown", Icon = "file-text" })
+MarkdownTab:Markdown({
+ ImageHeight = 190,
+ Content = [[
+# WindUI Markdown
+
+Native **bold**, _italic_, ~~strikethrough~~ and `inline code`.
+
+> Tables, images and responsive layout use WindUI surfaces.
+
+| Feature | Status |
+|:--|--:|
+| Markdown | Ready |
+| HTML-lite | Ready |
+| Mobile sidebar | Ready |
+
+
+]],
+})
+
+local HtmlTab = Window:Tab({ Title = "HTML", Icon = "code-xml" })
+HtmlTab:HTML({
+ ImageHeight = 190,
+ Content = [[
+HTML-lite
+HTML is converted into WindUI-native blocks with theme-aware styling.
+| Renderer | Available |
|---|
| Image | Yes |
| Video block | Yes |
+
+]],
+})
+
+local function getThemeNames()
+ local names = {}
+ for name in next, WindUI:GetThemes() do table.insert(names, name) end
+ table.sort(names)
+ return names
+end
+
+local ThemeTab = Window:Tab({ Title = "Theme", Icon = "palette" })
+ThemeTab:Paragraph({ Title = "Theme workspace", Desc = "Select, create, tune and apply themes without leaving the window." })
+ThemeTab:Dropdown({
+ Title = "Active theme",
+ Values = getThemeNames(),
+ Value = WindUI:GetCurrentTheme(),
+ Callback = function(name)
+ WindUI:SetTheme(name)
+ print("[WindUI/Showcase] applied theme " .. tostring(name))
+ end,
+})
+ThemeTab:Colorpicker({
+ Title = "Active accent",
+ Default = Color3.fromHex("#8B5CF6"),
+ Callback = function(color)
+ WindUI:EditTheme(WindUI:GetCurrentTheme(), { Primary = color, Slider = color })
+ end,
+})
+ThemeTab:Slider({
+ Title = "Element background opacity",
+ Desc = "Keeps the window image visible behind every surface.",
+ Value = { Min = 0, Max = 100, Default = math.floor((Window.BackgroundElementTransparency or 0) * 100) },
+ Callback = function(value)
+ Window.BackgroundElementTransparency = value / 100
+ Window:ApplyBackgroundElementTransparency()
+ end,
+})
+local ThemeActions = ThemeTab:HStack({ AutoSpace = true })
+ThemeActions:Button({
+ Title = "Create violet",
+ Icon = "sparkles",
+ Callback = function()
+ if not WindUI:GetThemes()["Showcase Violet"] then
+ WindUI:CreateTheme("Showcase Violet", WindUI:GetCurrentTheme())
+ end
+ WindUI:EditTheme("Showcase Violet", { Primary = Color3.fromHex("#8B5CF6"), Slider = Color3.fromHex("#8B5CF6") })
+ WindUI:SetTheme("Showcase Violet")
+ end,
+})
+ThemeActions:Button({ Title = "Restore Dark", Icon = "moon", Callback = function() WindUI:SetTheme("Dark") end })
+ThemeTab:Button({
+ Title = "Save active theme",
+ Desc = "Writes the active theme to WindUI/themes.",
+ Icon = "download",
+ Callback = function()
+ local ok, err = WindUI:SaveTheme()
+ print("[WindUI/Showcase] theme save", ok, err)
+ end,
+})
+
+local ProfilesTab = Window:Tab({ Title = "Profiles", Icon = "folder-cog" })
+ProfilesTab:Paragraph({ Title = "Profile workspace", Desc = "Create, select, save, load and rename stored profiles." })
+local profileName = "showcase"
+local ProfileStatus = ProfilesTab:Paragraph({ Title = "No profile selected", Desc = "Use a profile action below." })
+local ProfileTable = ProfilesTab:Markdown({ Content = "## Stored profiles\n\n| Profile | Current |\n|:--|:--:|\n| Loading | — |", TableRowHeight = 34, TableMaxHeight = 150 })
+local function refreshProfileTable()
+ local manager = Window.ConfigManager
+ if not manager then return end
+ local rows = { "## Stored profiles", "", "| Profile | Current |", "|:--|:--:|" }
+ for _, name in next, manager:ListProfiles() do
+ table.insert(rows, "| " .. name:gsub("|", "/") .. " | " .. (manager:GetCurrentProfile() == name and "Yes" or "") .. " |")
+ end
+ ProfileTable:SetContent(table.concat(rows, "\n"))
+end
+ProfilesTab:Input({ Title = "Profile name", Value = profileName, Placeholder = "profile name", Callback = function(value) profileName = value end })
+local ProfileActions = ProfilesTab:HStack({ AutoSpace = true })
+ProfileActions:Button({
+ Title = "Create / select",
+ Icon = "folder-plus",
+ Callback = function()
+ local manager = Window.ConfigManager
+ if not manager then return end
+ local profile = manager:GetConfig(profileName) or manager:CreateProfile(profileName) or manager:SelectProfile(profileName)
+ if profile then ProfileStatus:SetTitle("Selected: " .. profileName) refreshProfileTable() end
+ end,
+})
+ProfileActions:Button({
+ Title = "Save",
+ Icon = "save",
+ Callback = function()
+ local manager = Window.ConfigManager
+ if not manager then return end
+ local profile = manager:GetConfig(profileName) or manager:CreateProfile(profileName)
+ if profile then
+ profile:Set("lastOpened", os.time())
+ manager:SaveProfile(profileName)
+ ProfileStatus:SetTitle("Saved: " .. profileName)
+ refreshProfileTable()
+ end
+ end,
+})
+local ProfileLoadActions = ProfilesTab:HStack({ AutoSpace = true })
+ProfileLoadActions:Button({ Title = "Load", Icon = "folder-open", Callback = function() local manager = Window.ConfigManager if manager then manager:LoadProfile(profileName) ProfileStatus:SetTitle("Loaded: " .. profileName) end end })
+ProfileLoadActions:Button({ Title = "Rename to showcase-v2", Icon = "pencil", Callback = function() local manager = Window.ConfigManager if manager and manager:RenameProfile(profileName, "showcase-v2") then profileName = "showcase-v2" ProfileStatus:SetTitle("Renamed: showcase-v2") end end })
+ProfilesTab:Button({ Title = "Set selected as autoload", Icon = "power", Callback = function() local manager = Window.ConfigManager if manager then manager:SetProfileAutoLoad(profileName, true) ProfileStatus:SetTitle("Autoload: " .. profileName) end end })
+refreshProfileTable()
+
+local PluginsTab = Window:Tab({ Title = "Plugins", Icon = "puzzle" })
+PluginsTab:Paragraph({ Title = "Plugin workspace", Desc = "Plugins can initialize, expose their own state and clean up when removed." })
+local PluginStatus = PluginsTab:Paragraph({ Title = ShowcasePlugin.Name .. " " .. ShowcasePlugin.Version, Desc = "Registered and initialized." })
+local PluginTable = PluginsTab:Markdown({
+ Content = "## Installed plugins\n\n| Plugin | Version | Status |\n|:--|:--|:--|\n| Loading | — | — |",
+ TableRowHeight = 34,
+ TableMaxHeight = 180,
+ TableCellWidth = 130,
+})
+local function refreshPluginTable()
+ local rows = { "## Installed plugins", "", "| Plugin | Version | Status |", "|:--|:--|:--|" }
+ for _, plugin in next, WindUI:ListPlugins() do
+ local safeName = plugin.Name:gsub("|", "/")
+ table.insert(rows, "| " .. safeName .. " | " .. tostring(plugin.Version or "0.0.0") .. " | " .. (plugin.Enabled and "Enabled" or "Disabled") .. " |")
+ end
+ PluginTable:SetContent(table.concat(rows, "\n"))
+end
+local pluginName = "Showcase Utility"
+PluginsTab:Input({ Title = "Plugin name", Value = pluginName, Placeholder = "plugin name", Callback = function(value) pluginName = value end })
+local PluginActions = PluginsTab:HStack({ AutoSpace = true })
+PluginActions:Button({
+ Title = "Install plugin",
+ Icon = "plus",
+ Callback = function()
+ if not WindUI:GetPlugin(pluginName) then
+ WindUI:AddPlugin({ Name = pluginName, Version = "1.0.0", Init = function(api) api.ShowcaseUtilityReady = true end })
+ end
+ PluginStatus:SetTitle("Installed: " .. pluginName)
+ refreshPluginTable()
+ end,
+})
+PluginActions:Button({
+ Title = "Remove plugin",
+ Icon = "trash-2",
+ Callback = function()
+ local removed = WindUI:RemovePlugin(pluginName)
+ PluginStatus:SetTitle(removed and ("Removed: " .. pluginName) or ("Not found: " .. pluginName))
+ refreshPluginTable()
+ end,
+})
+local PluginStateActions = PluginsTab:HStack({ AutoSpace = true })
+PluginStateActions:Button({
+ Title = "Enable selected",
+ Icon = "circle-play",
+ Callback = function()
+ local plugin = WindUI:EnablePlugin(pluginName)
+ PluginStatus:SetTitle(plugin and ("Enabled: " .. pluginName) or ("Not found: " .. pluginName))
+ refreshPluginTable()
+ end,
+})
+PluginStateActions:Button({
+ Title = "Disable selected",
+ Icon = "circle-pause",
+ Callback = function()
+ local plugin = WindUI:DisablePlugin(pluginName)
+ PluginStatus:SetTitle(plugin and ("Disabled: " .. pluginName) or ("Not found: " .. pluginName))
+ refreshPluginTable()
+ end,
+})
+local PluginStorageActions = PluginsTab:HStack({ AutoSpace = true })
+PluginStorageActions:Button({ Title = "Save state", Icon = "save", Callback = function() local ok, err = WindUI:SavePluginState() PluginStatus:SetTitle(ok and "Plugin state saved" or ("Save failed: " .. tostring(err))) end })
+PluginStorageActions:Button({ Title = "Load disk plugins", Icon = "folder-input", Callback = function() local loaded, errors = WindUI:LoadPlugins() PluginStatus:SetTitle("Loaded " .. tostring(#loaded) .. ", errors " .. tostring(#errors)) refreshPluginTable() end })
+PluginsTab:Button({
+ Title = "Refresh plugin table",
+ Desc = "Refreshes the installed plugin list and verifies its registry state.",
+ Icon = "shield-check",
+ Callback = function()
+ assert(WindUI:GetPlugin("Showcase Tools") == ShowcasePlugin, "Plugin registry failed")
+ local count = 0
+ for _ in next, WindUI:GetPlugins() do count += 1 end
+ PluginStatus:SetTitle("Registry verified: " .. tostring(count) .. " plugin(s)")
+ refreshPluginTable()
+ print("[WindUI/Showcase] plugin registry passed")
+ end,
+})
+refreshPluginTable()
+
+Window:ThemeEditor({
+ Title = "Theme editor",
+ Theme = WindUI:GetCurrentTheme(),
+})
+
+assert(WindUI:GetPlugin("Showcase Tools") == ShowcasePlugin, "Showcase plugin was not registered")
+assert(WindUI.ShowcasePluginLoaded, "Showcase plugin did not initialize")
+local DisposablePlugin = WindUI:AddPlugin({ Name = "Disposable Showcase Plugin" })
+assert(WindUI:GetPlugins()[DisposablePlugin.Name] == DisposablePlugin, "Plugin list did not include the new plugin")
+assert(#WindUI:ListPlugins() >= 2, "Plugin list did not return registered plugins")
+assert(WindUI:DisablePlugin(DisposablePlugin.Name), "Plugin was not disabled")
+assert(not DisposablePlugin.Enabled, "Disabled plugin is still enabled")
+assert(WindUI:EnablePlugin(DisposablePlugin.Name), "Plugin was not re-enabled")
+assert(DisposablePlugin.Enabled, "Re-enabled plugin is still disabled")
+assert(WindUI:RemovePlugin(DisposablePlugin.Name), "Plugin was not removed")
+assert(WindUI:GetPlugin(DisposablePlugin.Name) == nil, "Removed plugin is still registered")
+assert(Window:SetSidebarOpen(false) == false, "Sidebar did not close")
+assert(Window:SetSidebarOpen(true) == true, "Sidebar did not reopen")
+Window:ApplyBackgroundElementTransparency()
+print("[WindUI/Showcase] full feature test opened")
+
+return Window
diff --git a/tests/Markdown.lua b/tests/Markdown.lua
new file mode 100644
index 00000000..e9be8722
--- /dev/null
+++ b/tests/Markdown.lua
@@ -0,0 +1,62 @@
+local WindUI = require("../src/Init")
+
+local Window = WindUI:CreateWindow({
+ Title = "Markdown Test",
+ Folder = "WindUI_Markdown_Test",
+})
+
+local Tab = Window:Tab({ Title = "Markdown", Icon = "file-text" })
+
+local Markdown = Tab:Markdown({
+ Content = [[
+# WindUI Markdown Full Test
+
+## Headings
+### Heading level 3
+#### Heading level 4
+
+Полный **rich content**, _italic_, ~~strikethrough~~, `inline code` и [link](https://github.com/Footagesus/WindUI).
+
+> Markdown теперь рендерится нативными Roblox-компонентами.
+
+---
+
+- Unordered item
+- Another **formatted** item
+
+1. Ordered item
+2. Second item
+
+| Возможность | Mobile | Статус |
+|:--|:--:|--:|
+| Markdown | Да | Ready |
+| Images | Да | Ready |
+| Video | Скоро | WIP |
+
+```lua
+local Page = Tab:Markdown({
+ Content = "# Hello"
+})
+```
+
+
+]],
+})
+
+assert(#Markdown.Elements == 12, "Expected every Markdown block to render")
+assert(Markdown.Elements[1]:IsA("TextLabel"), "Heading must render as text")
+assert(Markdown.Elements[6]:IsA("ImageLabel"), "Quote must render as a WindUI card")
+assert(Markdown.Elements[10]:IsA("ImageLabel"), "Table must render as a WindUI card")
+assert(Markdown.Elements[12]:IsA("ImageLabel"), "Image must render inside a WindUI card")
+
+Markdown:SetContent([[# Updated
+
+> Re-render passed
+
+| A | B |
+|---|---|
+| 1 | 2 |
+
+- Final item]])
+
+assert(#Markdown.Elements == 4, "SetContent must replace the old content")
diff --git a/tests/Regression.lua b/tests/Regression.lua
new file mode 100644
index 00000000..975d6e19
--- /dev/null
+++ b/tests/Regression.lua
@@ -0,0 +1,77 @@
+local WindUI = require("../src/Init")
+
+local Window = WindUI:CreateWindow({
+ Title = "WindUI Regression",
+ Folder = "WindUI_Regression",
+ Background = "https://raw.githubusercontent.com/Footagesus/WindUI/main/docs/banner-dark.png",
+ BackgroundOverlayTransparency = 0.55,
+ BackgroundElementTransparency = 0.2,
+ Mobile = { Force = true, SideBarWidth = 250, Padding = 8, Gap = 8 },
+})
+
+local Tab = Window:Tab({ Title = "Regression", Icon = "flask-conical" })
+local Markdown = Tab:Markdown({
+ Content = [[
+# Regression
+
+- [x] Markdown renderer
+ - Nested list item
+- [ ] Video asset upload
+
+| Area | State |
+|:--|:--:|
+| Mobile sidebar | Ready |
+]],
+})
+assert(#Markdown.Elements == 3, "Markdown task-list regression failed")
+
+assert(Window:SetMobileNavigation(true) == true, "Mobile sidebar did not open")
+assert(Window:SetMobileNavigation(false) == false, "Mobile sidebar did not close")
+
+local Plugin = WindUI:AddPlugin({
+ Name = "Regression Plugin",
+ Version = "1.0.0",
+ AutoStart = false,
+ Init = function(api) api.RegressionPluginStarted = true end,
+ Destroy = function(api) api.RegressionPluginStopped = true end,
+})
+assert(not Plugin.Enabled, "AutoStart false plugin started")
+assert(WindUI:EnablePlugin(Plugin.Name), "Plugin enable failed")
+assert(Plugin.Enabled and WindUI.RegressionPluginStarted, "Plugin init did not run")
+assert(WindUI:DisablePlugin(Plugin.Name), "Plugin disable failed")
+assert(not Plugin.Enabled and WindUI.RegressionPluginStopped, "Plugin destroy did not run")
+assert(WindUI:RemovePlugin(Plugin.Name), "Plugin remove failed")
+
+if writefile and readfile and isfile and isfolder and makefolder then
+ local root = "WindUI/.codex-regression"
+ local themesPath = root .. "/themes"
+ local pluginsPath = root .. "/plugins"
+ if not isfolder("WindUI") then makefolder("WindUI") end
+ if not isfolder(root) then makefolder(root) end
+
+ local theme = WindUI:CreateTheme("Regression Theme", "Dark")
+ WindUI:EditTheme(theme.Name, { Primary = Color3.fromHex("#14B8A6") })
+ assert(WindUI:SaveTheme(theme.Name, themesPath), "Theme save failed")
+ assert(WindUI:LoadTheme(themesPath .. "/Regression Theme.json"), "Theme load failed")
+
+ if not isfolder(pluginsPath) then makefolder(pluginsPath) end
+ writefile(pluginsPath .. "/manifest.lua", [[
+return {
+ Name = "Disk Regression Plugin",
+ Version = "1.0.0",
+ Init = function(api) api.DiskPluginLoaded = true end,
+}
+]])
+ local loaded, errors = WindUI:LoadPlugins(pluginsPath)
+ assert(#errors == 0 and #loaded == 1, "Disk plugin loader failed")
+ assert(WindUI.DiskPluginLoaded, "Disk plugin did not initialize")
+ assert(WindUI:SavePluginState(pluginsPath), "Plugin state save failed")
+ if delfile then
+ delfile(themesPath .. "/Regression Theme.json")
+ delfile(pluginsPath .. "/manifest.lua")
+ delfile(pluginsPath .. "/state.json")
+ end
+end
+
+print("[WindUI/Regression] desktop/mobile, markdown, persistence and plugin loader passed")
+return Window