flutter_password_input 0.4.0

A customizable password text field widget with Caps Lock detection, visibility toggle, force English input mode, and comprehensive theming support.

0.4.0

BREAKING

• Rename PasswordFieldWarning to PasswordFieldStatus — update all references in prefix/suffix builders and switch expressions
• PasswordFieldWidgetBuilder parameter renamed from warning to status

feat

• Add PasswordFieldStatus.checked and PasswordFieldStatus.unchecked — builders receive these states when isChecked is true/false
• Add isChecked (bool?) to PasswordTextField — null applies no checked styling, true/false changes border color accordingly; not intended to be used with hasCustomError
• Add checkedBorderColor to PasswordTextFieldTheme (falls back to Colors.green)
• Add uncheckedBorderColor to PasswordTextFieldTheme (falls back to errorBorderColor)

---

0.3.4

feat

• Add PasswordFieldWarning.disabled — prefix/suffix builders now receive disabled state when enabled: false
• Add disabledBorderColor to PasswordTextFieldTheme for customizable disabled border color (falls back to borderColor with 50% opacity)
• Add disabledTextStyle to PasswordTextFieldTheme for customizable disabled text style (falls back to textStyle)
• Visibility toggle button is now properly disabled when enabled: false

---

0.3.3

deps

• Upgrade flutter_ime from ^2.1.1 to ^2.1.3 (fix Caps Lock detection miss after app switch)

---

0.3.2

fix

• Fix hasCustomError state being lost when focus leaves and returns to the field

---

0.3.1

deps

• Upgrade just_tooltip from ^0.2.1 to ^0.2.3 (bug fix)

---

0.3.0

BREAKING

• Replace prefixWidget with prefixWidgetBuilder (PasswordFieldWidgetBuilder?) — builder receives (BuildContext, PasswordFieldWarning) so icons can react to warning state
• Replace suffixWidget with suffixWidgetBuilder (PasswordFieldWidgetBuilder?) — same builder signature

feat

• Add PasswordFieldWarning enum (none, capsLock, pasteBlocked, customError) representing the active warning
• Add PasswordFieldWidgetBuilder typedef for prefix/suffix builders
• Border and floating-label color now uses last-triggered warning semantics instead of fixed priority
• When an active warning turns off, the field falls back to the next still-active warning via _resolveActiveWarning()

---

0.2.2

feat

• Add direction and alignment to WarningTooltipTheme for theme-level tooltip positioning (overrides per-warning alignment when set)
• Add waitDuration to WarningTooltipTheme for delayed tooltip appearance
• Add showDuration to WarningTooltipTheme for auto-hiding tooltips after a set time
• Re-export TooltipDirection and TooltipAlignment enums for direct use

---

0.2.1

feat

• Add prefixIconConstraints and suffixIconConstraints to PasswordTextField for controlling icon size

---

0.2.0

feat

• Add hasCustomError to PasswordTextField for external error state control (default: false)
  • Changes border color and floating label color when active
  • Works in both focused and unfocused states
• Add customErrorBorderColor to PasswordTextFieldTheme (falls back to errorBorderColor)

---

0.1.8

fix

• Fix tooltip alternating issue when both CapsLock and paste warnings are active at the same position
• Paste tooltip now takes priority over CapsLock tooltip; CapsLock tooltip restores after paste warning expires

feat

• Paste tooltip animation replays on repeated Ctrl+V press
• Ignore key repeat events when holding Ctrl+V (only triggers once per key press)

---

0.1.7

feat

• Add tooltip animation parameters to WarningTooltipTheme:
  • animation: Animation style (none, fade, scale, slide, fadeScale, fadeSlide, rotation)
  • animationCurve: Custom easing curve
  • fadeBegin: Starting opacity for fade animations
  • scaleBegin: Starting scale for scale animations
  • slideOffset: Slide distance ratio for slide animations
  • rotationBegin: Starting rotation for rotation animations
• Re-export TooltipAnimation enum for direct use

deps

• Upgrade just_tooltip from ^0.2.0 to ^0.2.1

---

0.1.6

feat

• Add interactive option to WarningTooltipTheme to control whether tooltip stays visible on hover (default: true)

deps

• Upgrade just_tooltip from ^0.1.7 to ^0.2.0
• Migrate tooltip styling parameters to new JustTooltipTheme API (breaking change in just_tooltip 0.2.0)

---

0.1.5

feat

• Add WarningDisplayMode enum (message, tooltip) to switch warning display between inline text and tooltip
• Add warningDisplayMode to PasswordTextField (default: message)
• Tooltip mode uses just_tooltip package with per-warning independent positioning via capsLockWarningAlignment and pasteWarningAlignment
• Add WarningTooltipTheme class for full tooltip styling customization:
  • backgroundColor, borderRadius, padding, elevation, boxShadow
  • borderColor, borderWidth
  • textStyle, offset, crossAxisOffset, screenMargin
  • animationDuration
  • showArrow, arrowBaseWidth, arrowLength, arrowPositionRatio
• Add tooltipTheme to PasswordTextFieldTheme
• Paste warning now hides when focus is lost (consistent with Caps Lock warning behavior)

deps

• Add just_tooltip: ^0.1.7

---

0.1.4

feat

• Add WarningAlignment enum with 6 positions (topLeft, topCenter, topRight, bottomLeft, bottomCenter, bottomRight)
• Add capsLockWarningAlignment and pasteWarningAlignment to PasswordTextField (default: bottomLeft)
• Add pasteWarningBorderColor to PasswordTextFieldTheme for independent paste warning border/text color (falls back to errorBorderColor)
• Paste warning now changes border color and floating label color

---

0.1.3

feat

• Add paste warning message when paste is blocked (disablePaste: true)
  • showPasteWarning: Whether to show warning (default: true)
  • pasteWarningText: Custom warning message (default: 'Paste is disabled')
  • pasteWarningDuration: Auto-hide duration (default: 3 seconds)
  • onPasteBlocked: Callback when paste attempt is blocked
  • Warning auto-hides when user starts typing
• Add pasteWarningStyle to PasswordTextFieldTheme

---

0.1.2

feat

• Add disablePaste option to block paste functionality (default: false)
  • Blocks both keyboard shortcuts (Ctrl+V/Cmd+V) and context menu paste

---

0.1.1

feat

• Add forceEnglishInput option to force English keyboard input when focused (default: true)
  • Windows: Disables IME when focused, re-enables when unfocused
  • macOS: Switches to English keyboard and maintains it while focused
• Add ExcludeFocus wrapper to visibility toggle button to prevent focus stealing

chore

• Add macOS platform support to example app
• Update flutter_ime dependency version

---

0.1.0

feat

• Add PasswordTextField widget with obscured text input
• Add Caps Lock detection using flutter_ime package (Windows, macOS supported)
• Add password visibility toggle button
• Add prefixWidget and suffixWidget support
• Add PasswordTextFieldTheme for comprehensive styling customization
• Add merge() and copyWith() methods for theme manipulation
• Add interactive playground example app

docs

• Add detailed English documentation for all public APIs