PixelUI Framework - Early Alpha Release

PixelUI is a comprehensive UI framework for CC: Tweaked that provides a widget-based approach to building graphical interfaces. This is an early alpha release intended for testing and feedback from the community.

Overview

PixelUI aims to simplify GUI development in ComputerCraft by offering a familiar widget system with event handling, theming, and layout management. While functional, this early version may contain bugs and the API is subject to change.

Available Widgets

Basic Widgets

• Label - Text display with alignment options
• Button - Clickable buttons with borders and click effects
• TextBox - Text input with cursor, scrolling, and password masking
• CheckBox - Boolean toggle with visual feedback
• Slider - Value selection with draggable handle
• ProgressBar - Progress indication with intermediate/indeterminate mode
• ToggleSwitch - Modern on/off switch with status display

Input & Selection

• RadioButton - Grouped single-selection options
• ComboBox - Dropdown selection lists
• NumericUpDown - Numeric input with increment/decrement buttons
• PasswordBox - Secure text input with character masking
• ColorPicker - Color selection with grid layout and preview

Layout & Organization

• Container - Layout management with scrolling support
• GroupBox - Visual grouping with title and border
• TabControl - Multi-page interface with tab headers
• Grid - Cell-based widget positioning
• Spacer - Invisible spacing element
• Window - Draggable windows with title bars

Data Display

• ListView - Scrollable item lists with selection
• TreeView - Hierarchical data display with expand/collapse
• Breadcrumb - Navigation path display
• Canvas - Custom drawing surface with pixel manipulation

Feedback & Interaction

• MsgBox - Modal message dialogs with multiple button options
• Modal - Generic modal dialog container
• ContextMenu - Right-click context menus
• LoadingIndicator - Progress indication with multiple animation styles
• Spinner - Loading animations with various visual styles
• ScrollBar - Scrolling controls for containers (WIP)

Core Features

Animation System

• Smooth property transitions with easing functions
• Support for linear, quadratic in/out, and custom easing
• Configurable duration, delay, and completion callbacks

Theming Support

• Comprehensive color theming system
• Built-in default theme with customization options
• Theme inheritance for consistent styling

Event Handling

• Mouse click, drag, and scroll events
• Keyboard input with focus management
• Widget-specific event callbacks

Layout Management

• Absolute, vertical, and horizontal layouts
• Smart margin calculation and auto-spacing
• Scrollable containers with automatic scrollbars

Advanced Features

• Drag and drop support for widgets
• Word wrapping for text content
• Clipping and bounds checking
• Z-index layering system

Known Limitations

• This is an early alpha - expect bugs and API changes
• Limited documentation and examples
• Performance may not be optimized for complex UIs
• Some advanced features may be incomplete

Basic Usage

local PixelUI = require("pixelui")

PixelUI.init()

local button = PixelUI.button({
    x = 10, y = 5,
    text = "Click Me",
    onClick = function()
        print("Button clicked!")
    end
})

PixelUI.run()