virtual_keypad 0.4.0

A customizable virtual on-screen keyboard for Flutter with TextField integration. Supports multiple layouts, themes, and works on all platforms.

0.4.0

Added

• VirtualKeypadStandaloneScope — New widget that restricts a standalone-mode keyboard to only respond to text fields within its subtree. Useful for apps like Widgetbook where multiple widget previews are shown simultaneously.
• VirtualKeypadStandaloneScope.maybeOf(context) static method to look up the nearest scope.
• Scope-aware focus handling in VirtualKeypad — the keyboard now hides when focus moves to a text field outside its scope.
• Tests for VirtualKeypadStandaloneScope (maybeOf null case, ancestor lookup, sibling scope isolation).

Fixed

• Dart formatting applied consistently across all example files to satisfy CI checks.

---

0.3.1

• Re-release of 0.3.0 (publish fix)

---

0.3.0

Added

• Standalone mode — VirtualKeypad(standalone: true) works with any standard Flutter TextField or TextFormField without requiring VirtualKeypadScope or VirtualKeypadTextField. The keyboard intercepts Flutter's text input system and routes key presses to whichever field has focus.
• StandaloneInputControl — exported TextInputControl implementation that powers standalone mode.
• Auto-detects TextInputType from the focused field and adapts keyboard layout accordingly.
• French (AZERTY) keyboard — full text, email, URL, number, and phone layouts ('fr').
• inputAction parameter on VirtualKeypad — override the enter/done key action label directly.
• Smart enter key — shows action label (Done, Go, Search, Send, Next) for non-multiline keyboards; shows return icon for multiline.
• onKeyPressedWithText callback — fires with (VirtualKey key, String? text), where text is the actual inserted character (respecting shift/caps), or null for action keys.
• Standalone mode example screen in the example app.
• French language added to the language switching example.

---

0.2.1

Improved

• Optimized package topics for better pub.dev discoverability
• Added preview GIFs to README

---

0.2.0

Added

• Key press preview popup - Native-style key preview bubble appears above typed key
• Premium example app with 9 fully designed demo screens
• Preview GIFs in README

Improved

• Redesigned example app UI for all screens with gradient themes and animations
• Simplified and restructured documentation for clarity
• Reorganized project assets

---

0.1.1

Fixed

• Physical keyboard handling - Virtual keyboard now correctly hides when allowPhysicalKeyboard: true
• Layout persistence on close - Keyboard maintains its layout during close animation instead of resetting to default
• Selection handling - insertText() and deleteBackward() now properly handle text selections

Added

• selectAll() method to VirtualKeypadController for selecting all text
• Stricter lint rules for better code quality
• Comprehensive documentation in doc/ folder
  • API Reference
  • Custom Layouts Guide
  • Adding Languages Guide
  • Theming Guide

Improved

• Enhanced VirtualKeypadController selection awareness
• Better scope state management for physical keyboard mode
• Professional README with cleaner structure

---

0.1.0

Initial Release

• VirtualKeypadScope - Manages keyboard-to-textfield connections
• VirtualKeypadTextField - Text field with virtual keyboard integration
• VirtualKeypad - Customizable on-screen keyboard widget
• VirtualKeypadController - Controller with text manipulation methods
• VirtualKeypadTheme - Light, dark, and custom themes
• Multiple keyboard types: text, email, URL, number, phone
• Multi-language support: English (QWERTY) and Bengali (বাংলা)
• Input-type-aware layouts that adapt automatically
• Cross-platform support (mobile, web, desktop)