🎉 First Alpha Release #

Wind v1.0.0-alpha.1 marks the first public preview of the complete architectural rewrite. This release focuses on code quality, CI/CD infrastructure, and ensuring a solid foundation for the v1 stable release.

✨ What's Included #

Core Widgets:

• WDiv - Utility-first container with flex, grid, and overflow support
• WText - Typography widget with cascading text styles
• WInput / WFormInput - Form inputs with validation and state styling
• WButton - Interactive button with loading states
• WCheckbox / WFormCheckbox - Checkbox with custom styling
• WSelect / WFormSelect / WFormMultiSelect - Dropdown with search and tagging
• WDatePicker / WFormDatePicker - Calendar-based date picker
• WPopover - Overlay positioning system
• WIcon, WImage, WSvg, WSpacer - Media and spacing utilities
• WAnchor - State management for hover/focus/custom states
• WKeyboardActions - iOS keyboard toolbar management

Utility Classes:

• Layout: flex, grid, wrap, flex-row, flex-col, gap-*
• Sizing: w-*, h-*, min-*, max-*, w-1/2, aspect-*, w-[200px]
• Spacing: p-*, px-*, py-*, m-*, mx-*, my-*
• Typography: text-*, font-*, uppercase, underline, truncate
• Colors: bg-*, text-*, border-* with /50 opacity modifiers
• Effects: shadow-*, opacity-*, ring-*, rounded-*
• Transitions: duration-*, ease-*, animate-*
• States: hover:, focus:, disabled:, loading:, custom states
• Responsive: sm:, md:, lg:, xl:, 2xl:
• Platform: ios:, android:, web:, mobile:
• Dark Mode: dark: prefix for all utilities

Theme System:

• WindTheme / WindThemeData - Customizable design tokens
• Runtime theme toggling with reactive updates
• Default Tailwind-compatible color palette
• Typography, spacing, and sizing scales

🔧 Code Quality & Infrastructure #

• Zero Analyzer Issues: Full compliance with flutter_lints 5.0.0
• 835 Tests Passing: Comprehensive test coverage across all widgets and parsers
• CI/CD Ready: Automated publishing via GitHub Actions with OIDC
• Flutter 3.29+ Support: Using latest stable APIs (toARGB32())
• Clean Code Standards: No custom linter exceptions, proper formatting

🐛 Bug Fixes #

• Fixed hover state test timing issues with addPostFrameCallback
• Resolved deprecated .value usage by migrating to .toARGB32()
• Fixed curly braces in flow control structures
• Replaced unnecessary Container with SizedBox for whitespace
• Updated .where() type checks to use .whereType<T>()

📦 Dependencies #

• flutter_svg: ^2.0.0 - SVG rendering support
• keyboard_actions: ^4.2.1 - iOS keyboard management
• flutter_lints: ^5.0.0 - Code quality enforcement

⚠️ Breaking Changes from v0 #

This is a complete rewrite. Migration from v0 requires updating all widget names and class syntax. See README.md for the new API.

📚 Documentation #

• Full widget documentation: wind.fluttersdk.com
• AI agent integration guides: docs/claude/
• Example application included in /example

🚀 What's Next #

This alpha release is feature-complete for core functionality. Upcoming releases will focus on:

• Community feedback and bug fixes
• Performance optimizations
• Additional widgets (WFormTextArea, WSlider, etc.)
• Enhanced documentation and examples
• Stable v1.0.0 release

✨ New Features #

WKeyboardActions Widget

• Added: New WKeyboardActions widget for iOS keyboard management.
• Problem Solved: iOS numeric keyboards lack a "Done" button, making it impossible to dismiss the keyboard.
• Solution: Wraps form content with a keyboard toolbar showing Done button and optional field navigation.
• Package: Integrated keyboard_actions package (v4.2.1).

Usage:

class MyForm extends StatefulWidget {
  @override
  State<MyForm> createState() => _MyFormState();
}

class _MyFormState extends State<MyForm> {
  final _amountFocus = FocusNode();
  final _quantityFocus = FocusNode();

  @override
  void dispose() {
    _amountFocus.dispose();
    _quantityFocus.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return WKeyboardActions(
      focusNodes: [_amountFocus, _quantityFocus],
      toolbarClassName: 'bg-gray-100 dark:bg-gray-800',
      child: Column(
        children: [
          WFormInput(
            focusNode: _amountFocus,
            label: 'Amount',
            type: InputType.number, // Done button appears!
          ),
          WFormInput(
            focusNode: _quantityFocus,
            label: 'Quantity',
            type: InputType.number,
          ),
        ],
      ),
    );
  }
}

Props:

• focusNodes: List of FocusNodes for inputs needing keyboard actions
• platform: Target platform ('ios', 'android', 'all') - default 'all'
• nextFocus: Enable up/down navigation between fields - default true
• toolbarClassName: Wind className for toolbar styling (supports bg-*, dark:bg-*)
• closeWidgetBuilder: Custom close button builder

Re-exports:

• keyboard_actions package is re-exported for advanced usage

---

✨ New Features #

Named Max-Width Sizes

• Added: Tailwind-compatible named max-width values for max-w-* classes.
• Classes: max-w-xs (320px), max-w-sm (384px), max-w-md (448px), max-w-lg (512px), max-w-xl (576px), max-w-2xl (672px), max-w-3xl (768px), max-w-4xl (896px), max-w-5xl (1024px), max-w-6xl (1152px), max-w-7xl (1280px), max-w-prose (1040px).
• Usage: WDiv(className: "max-w-sm p-4 bg-white rounded-lg", ...).

Border-0 Support

• Added: border-0 now correctly removes borders.
• Added: Shade-less border colors now work: border-white, border-black, border-transparent.

🐛 Bug Fixes #

WDiv Max-Width Constraint Override

• Fixed: max-w-sm and other max-width constraints were being overridden by explicit width values.
• Behavior: Max-width constraints now take precedence over width when explicitly set.
• Impact: Cards with max-w-sm now correctly constrain to 384px instead of expanding to full width.

---

🐛 Bug Fixes #

WDiv Fractional Sizing in Scroll Contexts

• Fixed: w-full/h-full now works correctly inside scroll views (overflow-auto).
• Behavior: Uses LayoutBuilder to detect unbounded constraints and applies MediaQuery.of(context).size for full-size factors instead of FractionallySizedBox.
• Impact: Enables proper Tailwind-to-Flutter conversion where scrollable containers wrap full-viewport content with flex centering.

Flex Centering with Full Size

• Fixed: justify-center and items-center now work correctly with h-full/w-full and min-h-full/min-w-full.
• Behavior: Column with h-full, min-h-full, or explicit height now uses MainAxisSize.max instead of .min, allowing vertical centering to work.
• Impact: flex flex-col items-center justify-center h-full or min-h-full now properly centers content like Tailwind.

Background Fill with Full Size

• Fixed: bg-* colors now properly fill entire parent area when combined with w-full/h-full.
• Behavior: Container uses width: double.infinity and height: double.infinity when full-size is requested.
• Impact: w-full h-full bg-slate-950 now fills the entire viewport with the background color.

✨ New Features #

Tailwind v4 Color Shades

• Added: 950 shade for all color palettes.
• Colors: All 22 colors now have 950 shade (slate, gray, zinc, neutral, stone, red, orange, amber, yellow, lime, green, emerald, teal, cyan, sky, blue, indigo, violet, purple, fuchsia, pink, rose).
• Examples: bg-slate-950, text-indigo-950, border-red-950, etc.

Space Utilities

• Added: space-x-* and space-y-* utilities for spacing between children.
• Usage: space-y-6 adds vertical gap of 24px (6 × 4) between children.
• Implementation: Internally mapped to gap-x and gap-y for Flutter compatibility.

---

✨ New Features #

WPopover Widget

• Overlay System: Flexible popover for dropdowns, menus, and tooltips.
• Alignment: 6 supported positions (bottomLeft, bottomCenter, bottomRight, etc.).
• Styling: Full Wind className support for overlay container.
• Interaction: triggerBuilder and contentBuilder for maximum flexibility.
• Auto-Close: Built-in tap-outside handling via TapRegion.

---

✨ New Features #

Extended Widget Suite

• WSelect: Powerful dropdown with single/multi-select, search, pagination (infinite scroll), tagging (onCreateOption), and full custom builders.
• WCheckbox: Utility-first checkbox with checked: state styling and custom icon support.
• WImage: Network/Asset image wrapper with object-fit, aspect-ratio, and rounded utilities. Supports asset:// schema.
• WSvg: SVG rendering with fill-, stroke- coloring and parent style inheritance.
• WIcon: Tailwind-styled Icon wrapper that honors parent text styles (text-{color}, text-{size}).

Animation System (Explicit)

• Animation Utilities: animate-spin, animate-pulse, animate-bounce, animate-ping.
• WindAnimationWrapper: Integrated wrapper that handles explicit animations automatically.
• Widget Integration: WDiv, WIcon, WText (via WDiv wrapper) support animation classes.

Implicit Animations (Transitions)

• Duration: duration-{ms} enables implicit animations on properties.
• Easing: ease-linear, ease-in, ease-out, ease-in-out curves.
• Animated Widgets: Automatically swaps to AnimatedContainer, AnimatedOpacity, AnimatedAlign (via explicit toggle pattern) when duration is present.

🐛 Bug Fixes & Improvements #

• Opacity Parsing: Enhanced /[0.2] arbitrary syntax support to handle fractional doubles (0.0-1.0) correctly.
• Revert: Removed implicit alignment animation (align-* on containers) to avoid layout conflicts. Alignment animation should be done explicitly via AnimatedAlign.

---

✨ New Features #

WInput Widget (Form Input)

• React-Style Binding: value + onChanged props for controlled state management.
• Input Types: text, password, email, number, multiline via InputType enum.
• Tailwind Styling: className for input, placeholderClassName for placeholder text.
• Focus Ring Support: focus:ring-2 focus:ring-blue-500 and similar classes work.
• Custom States: Use states: {'error'} with error:border-red-500 for validation.
• Keyboard Actions: textInputAction, onSubmitted, onEditingComplete, onTap, onTapOutside.
• Text Customization: textCapitalization, autocorrect, enableSuggestions props.

Ring Parser Enhancements

• Theme-Configurable Widths: ringWidths and ringOffsets in WindThemeData.
• Custom Ring Values: ring-custom looks up from theme config.
• Opacity Parsing: Verified and tested /opacity syntax works for all ring colors.

📦 New Example Pages #

• /forms/input_basic - Basic input types demonstration.
• /forms/input_styled - Styled inputs with Tailwind classes.
• /forms/input_states - Focus, disabled, and error state examples.

🐛 Bug Fixes #

• Fixed deprecated Color.value usage in tests (replaced with toARGB32()).

---

✨ New Features #

State System Refactor

• Unified State Handling: Removed boolean flags (isHovering, etc.) in favor of activeStates (Set<String>).
• Custom States: Support for arbitrary states like loading:, selected:, error:.
• Extensible Prefixes: Any string can act as a state prefix (e.g., loading:bg-gray-400).

Color Opacity Support

• Opacity Modifier: Support for /50 syntax on all color utilities.
• Classes: bg-{color}/{opacity}, text-{color}/{opacity}, border-{color}/{opacity}, ring-{color}/{opacity}, shadow-{color}/{opacity}.
• Examples: bg-blue-500/50, text-red-500/75, ring-green-500/[0.3].

Ring Utilities

• Ring Width: ring, ring-0 to ring-8.
• Ring Color: ring-{color}, ring-{color}/{opacity}.
• Ring Offset: ring-offset-2, ring-offset-{color}.
• Ring Inset: ring-inset.
• Theme Configuration: WindThemeData.ringColor to set default ring color.

Shadow Improvements

• Shadow Opacity: Support for opacity modifiers in shadow colors (shadow-blue-500/50).

---

✨ New Features #

Typography & Font Family

• Font Family Utilities: font-sans, font-serif, font-mono
• Arbitrary Font Families: font-[Roboto], font-[Inter, sans-serif]
• Default Font Application: Automatically applies font-sans to all text (configurable via WindThemeData.applyDefaultFontFamily)
• Theme Customization: Define custom font families in WindThemeData.fontFamilies

Sizing & Layout

• Aspect Ratio: aspect-square, aspect-video, aspect-auto, aspect-[4/3]
• Z-Index: z-0 to z-50, z-auto, z-[100]
• Overflow: overflow-auto, overflow-hidden, overflow-visible, overflow-scroll, overflow-x/y-*

Effects & Borders

• Opacity: opacity-0 to opacity-100, opacity-[0.37]
• Rings: ring, ring-2, ring-red-500, ring-offset-2 (Focus rings equivalents)

Transitions & Animations

• Duration: duration-75/100/150/200/300/500/700/1000, duration-[ms]
• Timing Function: ease-linear, ease-in, ease-out, ease-in-out
• AnimatedContainer Integration: WDiv automatically uses AnimatedContainer when duration-* is set

Developer Experience (DX)

• Helper Functions: wColor, wSpacing, wScreen, wFontSize, wFontWeight
• BuildContext Extensions: context.windTheme, context.windColors, context.wColorExt(...)
• WindStyle Parsing: wStyle(context, '...') helper to programmatically parse styles

🐛 Bug Fixes #

• Fixed font-weight parsing interfering with font-family classes
• Fixed padding being applied outside Container instead of inside (Tailwind behavior)
• Fixed various documentation examples

---

[1.0.0-alpha.1] - 2025-12-24 #

🚀 Major Release - Complete Architectural Rewrite #

This release represents a complete rewrite of the Wind framework with a new architecture inspired by TailwindCSS and Laravel Artisan philosophies.

⚠️ Breaking Changes #

• Removed all v0 widgets: WCard, WFlex, WFlexible, WContainer, WGap are no longer available
• New widget system: Use WDiv, WText, WAnchor instead
• Theme API changed: WindTheme.toThemeData() replaced with WindTheme widget wrapper
• Class name syntax updated: Some utility class names have been standardized

✨ New Features #

New Widget System

• WDiv: The fundamental building block - dynamically builds Column, Row, GridView, or Wrap based on display type
• WText: Specialized typography widget with full text utility support
• WAnchor: Interactive wrapper for hover, focus, and disabled state management

New Parsing Engine

• WindParser: Central parser with static caching for optimized performance
• WindStyle: Immutable style data object containing all resolved properties
• WindContext: Context object with theme, screen size, platform, and state information

Specialist Parsers (8 Total)

• DisplayParser: block, flex, grid, wrap, hidden
• BackgroundParser: Colors, images, gradients, positioning, repeat
• BorderParser: Border width, color, style, and radius utilities
• TextParser: Colors, sizes, weights, alignment, decoration, transform, clamp
• SizingParser: Width, height, min/max constraints, fractions
• PaddingParser: All padding variants (p-, px-, py-, pt-, etc.)
• MarginParser: All margin variants (m-, mx-, my-, mt-, etc.)
• FlexboxGridParser: Flex direction, justify, align, gap, grid columns

Border & Rounded Utilities

• Border width: border, border-0, border-2, border-4, border-8
• Directional borders: border-t, border-r, border-b, border-l
• Border colors: border-{color}-{shade}, border-[#hex]
• Border radius: rounded, rounded-sm/md/lg/xl/2xl/3xl/full/none
• Directional radius: rounded-t/r/b/l/tl/tr/bl/br
• Theme customization: borderWidths, borderRadius in WindThemeData

State-Based Styling

• hover: - Styles applied on hover (requires WAnchor)
• focus: - Styles applied on focus (requires WAnchor)
• disabled: - Styles applied when disabled (requires WAnchor)

Platform Prefixes

• ios:, android:, web:, macos:, windows:, linux:, mobile:

Responsive Breakpoints

• sm: (640px), md: (768px), lg: (1024px), xl: (1280px), 2xl: (1536px)

Dark Mode Support

• dark: prefix for dark-mode-only styles
• Automatic color inversion via WindThemeData.brightness

CSS-Like Text Inheritance

• Text styles cascade from parent WDiv to child WText via DefaultTextStyle

🛠 Technical Improvements #

• Immutable Styles: WindStyle is @immutable with proper == and hashCode
• Static Caching: Parsed styles are cached by compound key for performance
• "Last Class Wins": Conflicting classes resolved by taking the last one
• Intelligent Composition: Widgets only wrap with decorators when needed

📦 New Theme Defaults #

• Colors: Full Tailwind color palette (slate, gray, red, orange, amber, yellow, lime, green, emerald, teal, cyan, sky, blue, indigo, violet, purple, fuchsia, pink, rose)
• Font Sizes: xs, sm, base, lg, xl, 2xl, 3xl, 4xl, 5xl, 6xl
• Font Weights: thin, extralight, light, normal, medium, semibold, bold, extrabold, black
• Tracking: tighter, tight, normal, wide, wider, widest
• Leading: tight, snug, normal, relaxed, loose

🐛 Bug Fixes #

• Fixed getSpacing('full') to return double.infinity (#3)

📚 Documentation #

• Complete system instruction for AI assistants
• Comprehensive test suite (212 tests passing)

---

• Updated platform_info dependency to ^5.0.0 for improved platform detection.

Added #

• Display Control (hide, show) utility classes
• DisplayParser for handling display-related utilities
• New example page for display utilities

Changed #

• Improved debug logging for widgets
• WFlexible.child is now nullable
• WContainer wraps with ClipRRect when borderRadius is specified

Fixed #

• Alignment mapping for alignment-left and alignment-right
• Text alignment handling

• Added Github workflow for publishing package to pub.dev
• Updated README.md with installation and usage instructions
• Added example application

• Initial release