levit_dart_core

Purpose & Scope

levit_dart_core is the composition layer that integrates:

• levit_scope for dependency injection and lifecycle ownership.
• levit_reactive for state propagation and derivation.

This package is responsible for:

• Levit: a unified facade over DI, reactive batching, and middleware registration.
• LevitController: lifecycle-aware application logic units.
• LevitStore / LevitAsyncStore: reusable scoped state factories.

This package does not include:

• Flutter widgets and widget-tree bindings (use levit_flutter_core or levit_flutter).
• Higher-level utility mixins for tasks/loops (use levit_dart).

Conceptual Overview

levit_dart_core formalizes ownership semantics between state and lifecycle:

• A LevitScope owns registrations and deterministic teardown.
• A LevitController owns its auto-disposed resources.
• A LevitStore is a portable state definition that resolves per scope.

The package preserves explicit scoping and avoids hidden global behavior.

Getting Started

dependencies:
  levit_dart_core: ^latest

import 'package:levit_dart_core/levit_dart_core.dart';

class CounterController extends LevitController {
  final count = 0.lx;

  void increment() => count(count() + 1);

  @override
  void onInit() {
    super.onInit();
    autoDispose(count);
  }
}

void main() {
  final scope = Levit.createScope('app');

  scope.run(() {
    Levit.put(() => CounterController());
    Levit.find<CounterController>().increment();
  });

  scope.dispose();
}

Design Principles

• Explicit ownership: scopes own registrations; controllers own cleanup.
• Deterministic lifecycle: setup and teardown order is predictable.
• Composition over abstraction leakage: Levit exposes scope and reactive APIs directly.
• Pure Dart portability: usable in shared logic, servers, and CLIs.