binkap_parsely 1.0.0
binkap_parsely: ^1.0.0 copied to clipboard
A Flutter package for parsing links, emails, @mentions, hashtags, and phone numbers from text. Mask extracted elements with custom patterns and add tappable click behavior for seamless interactions.
Changelog #
All notable changes to Parsely will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
[Unreleased] #
1.0.0 - 2026-11-08 #
Breaking changes #
stripLinkSchemeandstripMentionPrefixdefault tofalse(display no longer strips link schemes or mention prefixes unless you opt in). Previously the combinedhumanize: truedefault stripped both.
Removed #
- Removed deprecated
ParselyOptions(humanize: …). Migrate:humanize: true→stripLinkScheme: true, stripMentionPrefix: true;humanize: false→stripLinkScheme: false, stripMentionPrefix: false. - Removed deprecated
parseHashTag/parseMentionTagoptions. UseparseHashtag/parseMention. - Removed deprecated
ParselyMask(matches:…, masks:…)class and everymask:parameter (Parsely,SelectableParsely,ParselyParser,EntityEngine,Parser). UseParselyMasks(exact: {…})or aParselyMaskBuilderfunction;ParselyMask.toMasks()no longer exists. - Removed deprecated
ParselyUtilsingleton. UseParselyHumanizehelpers (stripLinkScheme,stripMentionPrefix,apply). - Removed
lib/src/mask.dartandlib/src/util.dartexports from thebinkap_parselyandparserentrypoints.
Changed #
ParselyOptions.humanizefallback removed:stripLinkScheme/stripMentionPrefixare now plainboolflags (defaultfalse), not nullable.effectiveStripLinkScheme/effectiveStripMentionPrefixreturn them directly.ParselyOptions.copyWith/ equality /hashCode/toStringno longer referencehumanizeor the*Tagaliases.
0.1.0 - 2026-11-08 #
Added #
- Public API surface:
Parsely,SelectableParsely,ParselyOptions,ParselyElement,ParselyType,ParselyParser,ParselyLaunch,ParselyMasks,ParselyMaskBuilder,ParselyMaskBuilders,EntityRule,ParselyRegexes,ParselyHumanize(withstripLinkScheme/stripMentionPrefix). - New option names
parseHashtag/parseMentionand granular display flagsstripLinkScheme/stripMentionPrefix; legacyparseHashTag/parseMentionTagkept as deprecated. - Map-based masking:
ParselyMasks(exact: …, patterns: …, maskAll: …)and function formParselyMaskBuilder; legacyParselyMask(matches: …, masks: …)kept as deprecated withtoMasks()converter. - Headless extraction API
ParselyParser.extract/replace/contains/firstOfType. ParselyElementfieldsdisplayText,start,end,resolvedEnd, and launchableuri(https://,mailto:,tel:).- Per-type styling via
parsedStyles, per-type tap handlers viaonTapHandlers, entity gating viaenabledEntities, post-matchvalidator, and custom rules viacustomRules.
Changed #
- Overlap precedence fixed to
email > link > phone > hashtag > mentionwith deterministic, non-overlapping, in-order spans. - Minimum Flutter requirement raised to
>=3.22.0(real floor forTextScaler). - Dev dependency
flutter_lintsbumped from^3.0.0to^6.0.0; analyzer now enforcespublic_member_api_docsandprefer_final_locals.
Fixed #
- Fixed
ParselyOptionsleading-space typo inpubspec.yamldescription. - Fixed legacy
Parserstate leak by clearing matches/spans on everybuildInlineSpanscall (idempotent). - Fixed trailing-punctuation / bracket handling for links and emails, and phone / hashtag / mention boundary validation (no date / numeric-emoji false positives).
Documentation #
- README restructured: badges, TOC, getting started, full compilable example, API reference tables,
I want to…recipes, privacy & masking note, troubleshooting, migration guide, and out-of-scope section. CONTRIBUTING.mdcompleted (setup, checks, PR conventions, issue expectations, code of conduct, how to add a new entity type end-to-end).LICENSEyear/holder set toCopyright (c) 2026 Binkap S(MIT).
0.0.1 - 2026-11-08 #
- Initial Build and Release.
