number_editing_controller 2.1.0

A TextEditingController that formats numbers, decimals, and currencies as you type with locale support.

2.1.0

New features

• Mutable formatting options. All formatting parameters (locale, groupSeparator, allowNegative, and type-specific options) are now mutable with getters and setters. Changing any option automatically reformats the current value.
• NumberEditingTextController is now an interface backed by three concrete subclasses: CurrencyEditingController, DecimalEditingController, and IntegerEditingController. Existing factory constructors (.currency(), .decimal(), .integer()) continue to work and return the appropriate subclass.
• CurrencyEditingController mutable options: currencyName, currencySymbol, decimalSeparator.
• DecimalEditingController mutable options: minimalFractionDigits, maximumFractionDigits, decimalSeparator.
• showCurrencySymbol option on CurrencyEditingController. Set to false to hide the currency symbol and its separator from formatted text, useful when the symbol is displayed as a prefix/suffix widget outside the text field.
• resolvedCurrencySymbol read-only property on CurrencyEditingController. Returns the actual symbol used for formatting, resolved from the currency code and locale.
• currencySymbolPosition read-only property on CurrencyEditingController. Returns CurrencySymbolPosition.prefix or .suffix based on the current locale.
• CurrencySymbolPosition enum exported from the public API.

Bug fixes

• Fixed dead/unreachable code in RealPart.format().
• Fixed StaticPart.format() returning 0 instead of null for its numeric value.
• Added bounds clamping for toStringAsFixed() to prevent crash when maximumFractionDigits exceeds 20.

Improvements

• Expanded test suite from 114 to 192 tests covering mutable options, subclass behavior, currency symbol visibility, and symbol position.
• Updated README with runtime option examples, class hierarchy table, known limitations, and animated demos.
• Updated example app with currency picker, locale switcher, negative toggle, and external currency symbol placement tabs.

2.0.0

Breaking changes

• Moved implementation files from lib/parsed_number_format/ to lib/src/. Only NumberEditingTextController is exported from the public API.
• Renamed internal FormatResult in parts.dart to PartFormatResult to avoid naming collision.
• Removed unused CurrencySignPart class (replaced by StaticPart).
• Removed unused PartLength class hierarchy and length getters on format parts.
• Updated minimum SDK constraints to Dart >=3.3.0 and Flutter >=3.19.0.

Bug fixes

• Fixed negative decimal numbers producing incorrect values when typed (e.g. -5.14 was parsed as -4.86).
• Fixed crash (RangeError) when a group separator appeared at the start of input.
• Fixed crash (UnsupportedError) when setting number to NaN or Infinity.
• Fixed incorrect grouping for negative numbers with 6+ digits when typed (e.g. -100000 was formatted as -,100,000).
• Fixed currency symbol duplication when typing a character before a leading currency symbol.

Improvements

• Added repository and topics fields to pubspec.yaml for better pub.dev discoverability.
• Improved package description.
• Added library directive with documentation to the barrel export file.
• Added dartdoc comments to all public classes and members.
• Improved and corrected existing doc comments (grammar, terminology).
• Made internal locale utility functions private.
• Replaced custom String.repeat extension with Dart's built-in * operator.
• Replaced list-based isDigit check with a code unit comparison.
• Added dispose() calls in all example app controllers.
• Removed default Flutter counter test from the example app.
• Removed FVM dependency from CI workflows.
• Simplified GitHub Actions workflows.
• Rewrote README with usage examples, configuration tables, and parameter documentation.
• Expanded test suite from 11 to 114 tests covering formatting, locales, edge cases, caret positions, and bug regressions.

1.4.0

• Updated dependencies and flutter version

1.3.1

• Updated library layout

1.3.0

• Fixed documentation
• Updated flutter
• Updated dependencies

1.2.1

• Updated docs

1.2.0

• Added an optional currencySymbol parameter

1.1.0

• Added a flag to allow only unsigned input

1.0.2

• Fixed a bug with zero-input deletion

1.0.1

• Updated docs

1.0.0

• Initial release