easy_state_m 1.2.2

Easy State Framework is a lightweight, high-performance, strongly-typed state management micro-framework for Flutter.

1.2.2

Breaking Changes

• EasyScope — default constructor removed. Use the explicit named constructors that declare lifecycle ownership:
  • EasyScope<T>.build(create: ..., builder: (ctx, controller) => ...) — the scope owns the controller (calls initialize() / dispose()).
  • EasyScope<T>.share(value: ..., builder: (ctx, controller) => ...) — the scope wraps an externally managed controller and never disposes it. Replaces the former EasyScope.value.
• EasyScopeProvide — default constructor removed. Same .build / .share split as EasyScope:
  • EasyScopeProvide<T>.build(create: () => T()) (was the unnamed ctor).
  • EasyScopeProvide<T>.share(value: existing) (was EasyScopeProvide.value).
• EasyScope — child parameter removed. All scopes now consume the unified two-argument EasyScopeBuilder<T> of the form (BuildContext context, T controller) => Widget. When you do not need the controller directly (e.g. inside EasyMultiScope adapters), use builder: (_, _) => myChild instead of the old child: parameter.

Improvements

• Added the EasyScopeBuilder<T> typedef and exposed it as the public signature for both EasyScope.build and EasyScope.share.
• EasyScope doc-comments and error hints now point at the new .build / .share constructors.
• Example app rewritten: PageA → PageB demo shows the recommended pattern of re-injecting a controller across a Navigator barrier with EasyScope<T>.share so that the destination page can resolve it with EasyScope.of<T>(context) without taking it through a widget constructor.

Migration

// Before (1.2.1)
EasyScope<CounterController>(
  create: () => CounterController(),
  builder: (context, controller) => CounterView(),
);

EasyScope<AuthController>.value(
  value: authController,
  child: const ProfilePage(),
);

EasyMultiScope(entries: [
  EasyScopeProvide(create: () => CartController()),
  EasyScopeProvide.value(value: authController),
]);

// After (1.2.2)
EasyScope<CounterController>.build(
  create: () => CounterController(),
  builder: (context, controller) => CounterView(),
);

EasyScope<AuthController>.share(
  value: authController,
  builder: (_, _) => const ProfilePage(),
);

EasyMultiScope(entries: [
  EasyScopeProvide<CartController>.build(create: () => CartController()),
  EasyScopeProvide<AuthController>.share(value: authController),
]);

1.2.1

• Fix compatibility: replace Dart 3 record type (String, void Function(dynamic)) with private class _ChannelEntry to support Dart 2.17+.
• Update SDK constraint from ^3.11.0 to >=2.17.0 <4.0.0 (Flutter >= 3.0.0).
• Fix example pubspec: rename dependency key easy_state → easy_state_m to match the package name, and update all import paths accordingly.

1.2.0

Breaking Changes

• Removed EasyEvent, EasyEventBinding, EasyEventBus, and EasyBusRegistry. The event-driven cross-controller API has been replaced by a typed channel system (see below).
• Renamed MultiEasyScope → EasyMultiScope for naming consistency with the rest of the API.
• EasyScopeBinding replaced by EasyScopeProvide / EasyScopeProvide.value.

New Features

• Typed channel bus — zero-coupling cross-controller messaging.

  • EasyChannelBinding<T> — declarative, type-safe channel subscription. Declare subscriptions by overriding EasyController.channelBindings.
  • EasyController.emit<C>(channel, data) — sends a message to all instances of controller type C that have registered a binding for channel. Annotated @protected; only callable from within EasyController subclasses.
  • EasyChannelBus — public abstract interface for the channel bus, enabling clean test doubles via EasyChannel.override(mock).
  • EasyChannel — global registry with override() and reset() for testing.
  • Channel names are automatically namespaced by the target controller's runtimeType, so the same channel name in different controllers never collides.

• _RefreshNotifier — allocation-free hot path. Replaced List.of() defensive copies with an iteration-depth counter and null-mark strategy (modelled after Flutter's ChangeNotifier). The common path — no structural changes during notification — is now fully allocation-free. Compaction runs once after the outermost notify returns, and reentrant refresh() calls are handled correctly via a depth counter.

• _ChannelBus.emit — index-based iteration. Replaced List.of(handlers) with a length-snapshot loop, eliminating one temporary list allocation per dispatch.

Improvements

• EasyChannelBinding constructor asserts that the type parameter T is not dynamic, catching type-erasure bugs at construction time in debug mode.
• EasyController.emit<C> asserts that C is not the base EasyController type, preventing silent no-op dispatches caused by a missing generic argument.
• EasyScope.of<T> documentation updated with an async-safety pattern: store the controller reference before any await to avoid accessing an invalidated BuildContext.
• Full English API documentation on all public classes and members (pub.dev standard).
• Updated README.md with architecture diagram, data-flow table, performance notes, and complete bilingual (English / 中文) usage guide.

1.0.2

• Add Support Files.

1.1.0

• Add MultiEasyScope
• Update README.md

1.0.0

• Initial release of Easy State.
• Added EasyController and EasyScope for O(1) dependency injection.
• Added EasyEvent and _EasyEventBus for multi-way data synchronization.
• Added EasyConsumer for granular local UI rebuilds.
• Implemented strict architectural guardrails and assertions.