• FIX: suppress semantic hint and focused state when disabled (#427).
• FIX: reorder inputFormatters so user formatters run before length limit.
• FIX: reorder inputFormatters so user formatters run before length limit.
• FEAT: add semanticHintBuilder for customizable accessibility hints.
• FEAT: add custom input formatters demo.
• FEAT: add mainAxisSize property for flexible sizing.
• FEAT: add custom input formatters demo.

2026-02-22

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• pin_code_fields - v9.2.0
• pin_code_fields_liquid_glass - v0.1.0-dev.2

• FIX: suppress semantic hint and focused state when disabled (#427).
• FIX: reorder inputFormatters so user formatters run before length limit.
• FIX: reorder inputFormatters so user formatters run before length limit.
• FEAT: add semanticHintBuilder for customizable accessibility hints.
• FEAT: add custom input formatters demo.
• FEAT: add mainAxisSize property for flexible sizing.
• FEAT: add custom input formatters demo.

• FEAT: add semanticHintBuilder parameter for customizable accessibility hints.
  • Enables localization of screen reader hints to different languages
  • Supports custom terminology (e.g., "characters" instead of "digits")
  • Allows static hints for context-specific guidance
  • Maintains backward compatibility with default English hints
  • Fixes #424

Features ✨

• Theme Extension: Added MaterialPinThemeExtension for embedding MaterialPinTheme in ThemeData
  • Register a default PIN theme at the app level using ThemeData.extensions
  • Access the theme anywhere with Theme.of(context).materialPinTheme
  • Supports light/dark theme configurations
  • MaterialPinField automatically uses the global theme when no explicit theme is provided
  • Added example demo showing app-wide theming usage
• MaterialPinFormField: New Material Design form field with built-in Form validation
  • Combines MaterialPinField styling with FormField capabilities (validator, onSaved, autovalidateMode)
  • Dual error states: controller errors trigger shake animation, form validation shows error text below the field
  • Theme resolution from widget prop, ThemeData extension, or default
  • reset() clears both text and controller error state

Bug Fixes 🐛

• PinInputFormField: Added missing parameters that exist in PinInput — onClipboardFound, clipboardValidator, onLongPress, onTapOutside, mouseCursor, semanticLabel

Documentation 📚

• Updated README with "App-Wide Theming" section
• Added code examples for theme extension setup and usage

Breaking Changes ⚠️

This is a complete rewrite with a new headless architecture. Migration required.

• New Headless Architecture: The package now provides both a headless core (PinInput) and a Material Design implementation (MaterialPinField)
• Unified Controller: PinInputController replaces separate TextEditingController, FocusNode, and errorAnimationController
• Theme System: New MaterialPinTheme with automatic ColorScheme resolution
• Renamed Parameters: See migration guide below

Features ✨

• Headless Core: Build completely custom PIN UIs with PinInput and PinCellData
• Material Design Ready: Use MaterialPinField for beautiful, ready-to-use PIN fields
• PinInputController: Single controller for text, focus, and error state management
  • setText(), clear(), text - Text control
  • triggerError(), clearError(), hasError - Error control
  • requestFocus(), unfocus(), hasFocus - Focus control
• Improved Animations: Scale, fade, slide, and none animation types
• All Cell Shapes: Outlined, filled, underlined, and circle
• Text Gradient: Apply gradients to PIN text via MaterialPinTheme.textGradient
• Custom Obscuring Widget: Use any widget for obscuring with obscuringWidget
• Form Integration: PinInputFormField for form validation
• SMS Autofill: Full autofill support with enableAutofill and autofillHints
• Haptic Feedback: Configurable haptic feedback types
• Accessibility (Semantics): Full screen reader support with semanticLabel parameter
  • Announces field purpose (e.g., "6-digit PIN code field")
  • Provides hints about remaining digits
  • Masks values when obscured for privacy
  • Exposes enabled/focused states
• cursorAlignment: Position custom cursor widgets within cells (e.g., underscore at bottom)
• onClipboardFound: Callback when clipboard contains valid PIN-like content on focus
• onTapOutside: Callback when user taps outside the field
• errorText & errorBuilder: Custom error display below the PIN field
• followingFillColor & followingBorderColor: Style for cells after the focused cell
• completeFillColor, completeBorderColor & completeTextStyle: Style when all cells are filled

Bug Fixes 🐛

• iOS App Hang fix: All Clipboard.getData calls are now guarded with a 500 ms timeout so a stalled native clipboard never blocks the UI thread
• Focus-triggered clipboard probe deferred: _checkClipboard() dispatched via addPostFrameCallback instead of running synchronously inside the focus listener
• Long-press paste deferred: Default context menu no longer triggers an eager clipboard read; clipboard data is read only after the user explicitly taps Paste
• Centralised safe clipboard helper: All clipboard reads go through _safeClipboardRead() with try/catch + .timeout()
• Focus on complete: Last cell now shows focused state when PIN is complete and field is focused
• Cursor alignment: Fixed custom cursor positioning - removed internal Center widget that was overriding alignment
• Web input: Fixed text input not working on web by adjusting invisible text field configuration
• Controller notifications: Fixed PinInputController not notifying listeners on focus/text changes

Example App 📱

• Added comprehensive use case demos (OTP verification, PIN setup, PIN login, payment confirmation, invite codes, app lock screen)
• Added feature demos for all customization options
• Added interactive Playground for real-time customization of all options

Documentation 📚

• Updated README with demo GIFs showcasing all features
• Added static screenshots for pub.dev gallery

Migration Guide

Parameter Renames

Basic Migration

Before (v8.x):

PinCodeTextField(
  appContext: context,
  length: 6,
  controller: textController,
  focusNode: focusNode,
  pinTheme: PinTheme(
    shape: PinCodeFieldShape.box,
    activeColor: Colors.blue,
  ),
  onChanged: (value) {},
  onCompleted: (value) {},
)

After (v9.0):

final pinController = PinInputController();

MaterialPinField(
  length: 6,
  pinController: pinController,
  theme: MaterialPinTheme(
    shape: MaterialPinShape.outlined,
    focusedBorderColor: Colors.blue,
  ),
  onChanged: (value) {},
  onCompleted: (value) {},
)

Error Handling Migration

Before:

final errorController = StreamController<ErrorAnimationType>();
errorController.add(ErrorAnimationType.shake);

After:

final pinController = PinInputController();
pinController.triggerError();  // Triggers shake + sets error state
pinController.clearError();    // Clears error state

AutovalidateMode.disabled will not add extra space below the pin cells
Added new attributes errorBorderColor, readOnly, textGradient and scrollPadding

• Much requested feature placeholder has been added hintCharacter
• hintStyle has been added to customize the hint TextStyle

Features ✨

• Added AutofillContextAction, default is AutofillContextAction.commit

Breaking changes ⚠️

• Migrated to null-safety.
• Minimum Flutter version is set to 1.22.0

Fixes 🐛

• Fixed default text value not showing, #153

Features ✨

• Added haptic feedback enum HapticFeedbackTypes { heavy, light, medium, selection, vibrate, }
• Added animated obscure widget support obscuringWidget and blinkWhenObscuring

Fixes 🐛

• Fixed bug related to TextStyle not given.
• Fixed bug related to setState is being called after disposal.

Added fallback color when the cursor color fails to retrive and fixed deprecated List constructors.

Fixed read-only warning when field is not enabled & cursor animation now only triggers if showCursor = true

Features ✨

• Added Cursor
  `
  /// Whether to show cursor or not
  final bool showCursor;

  /// The color of the cursor, default to Theme.of(context).accentColor
  final Color cursorColor;

  /// width of the cursor, default to 2
  final double cursorWidth;

  /// Height of the cursor, default to FontSize + 8;
  final double cursorHeight;
  `

• Added boxhShadows

Breaking changes ⚠️

• autoValidate changed according to the new version of Flutter
• Minimum Flutter version is set to 1.22.0

Fixes 🐛

• typo fixes

[5.1.0]

Features ✨

• Added errorAnimationDuration to customize Error animation duration.
• Added enablePinAutofill to enable or disable the auto-fill feature.

Breaking changes ⚠️

• Chagned textInputType to more familiar keyboardType to change they keyboard type

Fixes 🐛

• Fixed rootNavigator issue for paste dialogs, #101

Features ✨

• Added onSave, onTap callbacks.
• Added PastedTextStyle.
• Added iOS autofill added wtih Flutter version 1.20.0

Breaking changes ⚠️

• Must provide context in the appContext parameter.
• Minimum Flutter version is set to 1.20.0

Fixes 🐛

• Reopen keyboard onTap on the cells #92, thanks to https://github.com/YaroslavGS for the suggestion

Features ✨
Added support for flutter-web
Breaking changes ⚠️
Replaced internal automatic OS selection for dialog styles, you can select which style you want by configuring with the DialogConfig