Skip to content

docs: clarify per-handler event transformer semantics (#3248)#4819

Open
champ96k wants to merge 1 commit into
felangel:masterfrom
champ96k:docs/transformer-semantics
Open

docs: clarify per-handler event transformer semantics (#3248)#4819
champ96k wants to merge 1 commit into
felangel:masterfrom
champ96k:docs/transformer-semantics

Conversation

@champ96k

@champ96k champ96k commented May 27, 2026

Copy link
Copy Markdown

Status

READY

Breaking Changes

NO

Description

Each registered event handler operates on its own independent stream pipeline. Different handlers with different transformers do not affect each other's execution.

Changes

  • Add Per-Handler Event Transformers section to bloc-concepts.mdx explaining each on<E>() call creates an independent subscription that filters the shared event stream by type and applies its own transformer, with a Dart example showing two handlers with different transformers on the same Bloc.
  • Clarify doc comments in all bloc_concurrency transformers (sequential, restartable, droppable, concurrent) that their guarantees apply per-handler, not across handlers.
  • Clarify that "no event handler overlap" refers to the specific handler using the transformer, not other handlers registered on the same Bloc.

Related Issues

Part of #3248

Type of Change

  • ✨ New feature
  • 🛠️ Bug fix
  • ❌ Breaking change
  • 🧹 Code refactor
  • ✅ Build configuration change
  • 📝 Documentation
  • 🗑️ Chore

Each registered event handler operates on its own independent stream
pipeline. Different handlers with different transformers do not affect
each other's execution.

- Add 'Per-Handler Event Transformers' section to bloc-concepts.mdx
- Clarify doc comments in all bloc_concurrency transformers
- Clarify that 'no event handler overlap' refers to the specific
  handler using the transformer, not other handlers on the same Bloc

Part of felangel#3248
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant