Element prop re-added

FlexLove.lua

@@ -24,7 +24,6 @@ local Theme = req("flexlove.Theme")
 local RoundedRect = req("flexlove.RoundedRect")
 local NineSlice = req("flexlove.NineSlice")
 local utils = req("flexlove.utils")
-local constants = req("flexlove.constants")
 local Units = req("flexlove.Units")
 local Animation = req("flexlove.Animation")
 local GuiState = req("flexlove.GuiState")
@@ -34,7 +33,6 @@ local Element = req("flexlove.Element")
 
 -- Extract from utils
 local enums = utils.enums
-local getModifiers = utils.getModifiers
 
 local Positioning, FlexDirection, JustifyContent, AlignContent, AlignItems, TextAlign, AlignSelf, JustifySelf, FlexWrap =
   enums.Positioning,

flexlove/Element.lua

@@ -16,10 +16,9 @@ local Blur = req("Blur")
 local ImageRenderer = req("ImageRenderer")
 local NineSlice = req("NineSlice")
 local RoundedRect = req("RoundedRect")
-local Animation = req("Animation")
+--local Animation = req("Animation")
 local ImageCache = req("ImageCache")
 local utils = req("utils")
-local constants = req("constants")
 local Grid = req("Grid")
 local InputEvent = req("InputEvent")
 

flexlove/constants.lua

@@ -1,18 +0,0 @@
--- Text size preset mappings (in vh units for auto-scaling)
-local TEXT_SIZE_PRESETS = {
-  ["2xs"] = 0.75, -- 0.75vh
-  xxs = 0.75, -- 0.75vh
-  xs = 1.25, -- 1.25vh
-  sm = 1.75, -- 1.75vh
-  md = 2.25, -- 2.25vh (default)
-  lg = 2.75, -- 2.75vh
-  xl = 3.5, -- 3.5vh
-  xxl = 4.5, -- 4.5vh
-  ["2xl"] = 4.5, -- 4.5vh
-  ["3xl"] = 5.0, -- 5vh
-  ["4xl"] = 7.0, -- 7vh
-}
-
-return {
-  TEXT_SIZE_PRESETS = TEXT_SIZE_PRESETS
-}

flexlove/utils.lua

@@ -1,3 +1,96 @@
+local TEXT_SIZE_PRESETS = {
+  ["2xs"] = 0.75, -- 0.75vh
+  xxs = 0.75, -- 0.75vh
+  xs = 1.25, -- 1.25vh
+  sm = 1.75, -- 1.75vh
+  md = 2.25, -- 2.25vh (default)
+  lg = 2.75, -- 2.75vh
+  xl = 3.5, -- 3.5vh
+  xxl = 4.5, -- 4.5vh
+  ["2xl"] = 4.5, -- 4.5vh
+  ["3xl"] = 5.0, -- 5vh
+  ["4xl"] = 7.0, -- 7vh
+}
+---@class ElementProps
+---@field id string?
+---@field parent Element? -- Parent element for hierarchical structure
+---@field x number|string? -- X coordinate of the element (default: 0)
+---@field y number|string? -- Y coordinate of the element (default: 0)
+---@field z number? -- Z-index for layering (default: 0)
+---@field width number|string? -- Width of the element (default: calculated automatically)
+---@field height number|string? -- Height of the element (default: calculated automatically)
+---@field top number|string? -- Offset from top edge (CSS-style positioning)
+---@field right number|string? -- Offset from right edge (CSS-style positioning)
+---@field bottom number|string? -- Offset from bottom edge (CSS-style positioning)
+---@field left number|string? -- Offset from left edge (CSS-style positioning)
+---@field border Border? -- Border configuration for the element
+---@field borderColor Color? -- Color of the border (default: black)
+---@field opacity number?
+---@field backgroundColor Color? -- Background color (default: transparent)
+---@field cornerRadius number|{topLeft:number?, topRight:number?, bottomLeft:number?, bottomRight:number?}? -- Corner radius: number (all corners) or table for individual corners (default: 0)
+---@field gap number|string? -- Space between children elements (default: 10)
+---@field padding {top:number|string?, right:number|string?, bottom:number|string?, left:number|string?, horizontal: number|string?, vertical:number|string?}? -- Padding around children (default: {top=0, right=0, bottom=0, left=0})
+---@field margin {top:number|string?, right:number|string?, bottom:number|string?, left:number|string?, horizontal: number|string?, vertical:number|string?}? -- Margin around children (default: {top=0, right=0, bottom=0, left=0})
+---@field text string? -- Text content to display (default: nil)
+---@field titleColor Color? -- Color of the text content (default: black)
+---@field textAlign TextAlign? -- Alignment of the text content (default: START)
+---@field textColor Color? -- Color of the text content (default: black)
+---@field textSize number|string? -- Font size: number (px), string with units ("2vh", "10%"), or preset ("xxs"|"xs"|"sm"|"md"|"lg"|"xl"|"xxl"|"3xl"|"4xl") (default: "md")
+---@field minTextSize number?
+---@field maxTextSize number?
+---@field fontFamily string? -- Font family name from theme or path to font file (default: theme default or system default)
+---@field autoScaleText boolean? -- Whether text should auto-scale with window size (default: true)
+---@field positioning Positioning? -- Layout positioning mode (default: RELATIVE)
+---@field flexDirection FlexDirection? -- Direction of flex layout (default: HORIZONTAL)
+---@field justifyContent JustifyContent? -- Alignment of items along main axis (default: FLEX_START)
+---@field alignItems AlignItems? -- Alignment of items along cross axis (default: STRETCH)
+---@field alignContent AlignContent? -- Alignment of lines in multi-line flex containers (default: STRETCH)
+---@field flexWrap FlexWrap? -- Whether children wrap to multiple lines (default: NOWRAP)
+---@field justifySelf JustifySelf? -- Alignment of the item itself along main axis (default: AUTO)
+---@field alignSelf AlignSelf? -- Alignment of the item itself along cross axis (default: AUTO)
+---@field callback fun(element:Element, event:InputEvent)? -- Callback function for interaction events
+---@field transform table? -- Transform properties for animations and styling
+---@field transition table? -- Transition settings for animations
+---@field gridRows number? -- Number of rows in the grid (default: 1)
+---@field gridColumns number? -- Number of columns in the grid (default: 1)
+---@field columnGap number|string? -- Gap between grid columns
+---@field rowGap number|string? -- Gap between grid rows
+---@field theme string? -- Theme name to use (e.g., "space", "dark"). Defaults to theme from Gui.init()
+---@field themeComponent string? -- Theme component to use (e.g., "panel", "button", "input"). If nil, no theme is applied
+---@field disabled boolean? -- Whether the element is disabled (default: false)
+---@field active boolean? -- Whether the element is active/focused (for inputs, default: false)
+---@field disableHighlight boolean? -- Whether to disable the pressed state highlight overlay (default: false)
+---@field contentAutoSizingMultiplier {width:number?, height:number?}? -- Multiplier for auto-sized content dimensions (default: sourced from theme)
+---@field scaleCorners number? -- Scale multiplier for 9-slice corners/edges. E.g., 2 = 2x size (overrides theme setting)
+---@field scalingAlgorithm "nearest"|"bilinear"? -- Scaling algorithm for 9-slice corners: "nearest" (sharp/pixelated) or "bilinear" (smooth) (overrides theme setting)
+---@field contentBlur {intensity:number, quality:number}? -- Blur the element's content including children (intensity: 0-100, quality: 1-10, default: nil)
+---@field backdropBlur {intensity:number, quality:number}? -- Blur content behind the element (intensity: 0-100, quality: 1-10, default: nil)
+---@field editable boolean? -- Whether the element is editable (default: false)
+---@field multiline boolean? -- Whether the element supports multiple lines (default: false)
+---@field textWrap boolean|"word"|"char"? -- Text wrapping mode (default: false for single-line, "word" for multi-line)
+---@field maxLines number? -- Maximum number of lines (default: nil)
+---@field maxLength number? -- Maximum text length in characters (default: nil)
+---@field placeholder string? -- Placeholder text when empty (default: nil)
+---@field passwordMode boolean? -- Whether to display text as password (default: false)
+---@field inputType "text"|"number"|"email"|"url"? -- Input type for validation (default: "text")
+---@field textOverflow "clip"|"ellipsis"|"scroll"? -- Text overflow behavior (default: "clip")
+---@field scrollable boolean? -- Whether text is scrollable (default: false for single-line, true for multi-line)
+---@field autoGrow boolean? -- Whether element auto-grows with text (default: false)
+---@field selectOnFocus boolean? -- Whether to select all text on focus (default: false)
+---@field cursorColor Color? -- Cursor color (default: nil, uses textColor)
+---@field selectionColor Color? -- Selection background color (default: nil, uses theme or default)
+---@field cursorBlinkRate number? -- Cursor blink rate in seconds (default: 0.5)
+---@field overflow "visible"|"hidden"|"scroll"|"auto"? -- Overflow behavior (default: "visible")
+---@field overflowX "visible"|"hidden"|"scroll"|"auto"? -- X-axis overflow (overrides overflow)
+---@field overflowY "visible"|"hidden"|"scroll"|"auto"? -- Y-axis overflow (overrides overflow)
+---@field scrollbarWidth number? -- Width of scrollbar track in pixels (default: 12)
+---@field scrollbarColor Color? -- Scrollbar thumb color
+---@field scrollbarTrackColor Color? -- Scrollbar track color
+---@field scrollbarRadius number? -- Corner radius for scrollbar (default: 6)
+---@field scrollbarPadding number? -- Padding between scrollbar and edge (default: 2)
+---@field scrollSpeed number? -- Pixels per wheel notch (default: 20)
+local ElementProps = {}
+
 local enums = {
   ---@enum TextAlign
   TextAlign = { START = "start", CENTER = "center", END = "end", JUSTIFY = "justify" },
@@ -105,7 +198,6 @@ local function resolveTextSizePreset(sizeValue)
   return nil, nil
 end
 
-
 --- Auto-detect the base path where FlexLove is located
 ---@return string filesystemPath
 local function getFlexLoveBasePath()
@@ -192,4 +284,5 @@ return {
   FONT_CACHE = FONT_CACHE,
   resolveTextSizePreset = resolveTextSizePreset,
   getModifiers = getModifiers,
+  TEXT_SIZE_PRESETS = TEXT_SIZE_PRESETS,
 }