alien_signals 1.0.0

alien_signals: ^1.0.0 copied to clipboard

Status: Released (2025-01-15)

🎉 First Stable Release!

After months of development and multiple beta releases, we're excited to announce the first stable version of Alien Signals for Dart! This release brings a mature, high-performance reactive signal library to the Dart ecosystem.

🚀 What's New in 1.0.0 #

• Stable API: All APIs are now stable and ready for production use
• Better Dart Integration: Redesigned API that feels natural in Dart
• Enhanced Performance: Optimized reactive system with cycle-based dependency tracking
• Comprehensive Documentation: Complete API documentation and examples
• Production Ready: Battle-tested through beta releases and community feedback

📋 Key Features #

• Lightweight & Fast: The lightest signal library for Dart with excellent performance
• Simple API: Easy-to-use signal(), computed(), and effect() functions
• TypeScript Origins: Based on the excellent stackblitz/alien-signals
• Effect Scopes: Manage groups of effects with effectScope()
• Batch Updates: Control reactivity with startBatch() and endBatch()

🎯 Getting Started #

import 'package:alien_signals/alien_signals.dart';

void main() {
  // Create a signal
  final count = signal(0);

  // Create a computed value
  final doubled = computed((_) => count.value * 2);

  // Create an effect
  effect(() {
    print('Count: ${count.value}, Doubled: ${doubled.value}');
  });

  // Update the signal
  count.value++; // Prints: Count: 1, Doubled: 2
}

🔧 Migration from Beta #

If you're upgrading from a beta version, please see our Migration Guide for detailed instructions.

🙏 Acknowledgments #

Special thanks to the StackBlitz team for creating the original alien-signals library and to our community for feedback during the beta period.

Status: Released(2025-09-30)

• FIX: remove assertion in effectOper

Status: Released(2025-09-30)

• FEATURE: Add preset_developer.dart, the basics of exporting Preset

Status: Released(2025-09-29)

• Have good auto-imports, avoid auto-importing src
• Effect/EffectScope's call() is renamed to dispose()

Status: Released(2025-09-29)

System #

• BREAKING CHANGE: sync alien-signal 3.0.0 version
• BREAKING CHANGE: link add a third version count param
• BREAKING CHANGE: remove startTracking and endTracking API

Preset

• BREAKING CHANGE: remove deprecated system.dart entry point export
• BREAKING CHANGE: migrate batchDepth to getBatchDepth()
• BREAKING CHANGE: rename getCurrentSub/setCurrentSub to getActiveSub/setActiveSub
• BREAKING CHANGE: remove getCurrentScope/getCurrentScope, using getActiveScope/setActiveScope
• BREAKING CHANGE: remove signal/computed call(), using .value property
• FEATURE: add Signal,WritableSignal,Computed,Effect abstract interface

Status: Released (2025-09-28)

• Deprecate library entry point of package:alien_signals/system.dart

• perf(system): Move dirty flag declaration outside loop

Sync upstream alien-signals^v2.0.7

• system: Optimize isValidLink implementation
• system: Optimize reactive system dirty flag propagation loop
• system: Refactor reactive system dependency traversal logic
• system: Use explicit nullable types for Link variables
• system: Optimize reactive system flag checking logic
• system: Simplify recursive dependency check

• fix: Introduce per-cycle version to dedupe dependency links

• fix: Remove non-contiguous dep check

• pref: refactor: queue effects in linked effects list
• pref: Add pragma annotations for inlining to startTracking
• BREAKING CHANGE: Remove pauseTracking and resumeTracking
• BREAKING CHANGE: Remove ReactiveFlags, change flags to int type

• perf: Replace magic number with bitwise operation for clarity

• perf: Optimize computed values by using final result value in bit marks calculation (reduces unnecessary computations)
• docs: Add code comments to public API for better documentation

• pref: Add prefer-inline pragmas to core reactive methods. (Thx #17 at @Kypsis)

• refactor: simplifying unlink sub in effect cleanup
• refactor: update pauseTracking and resumeTracking to use setCurrentSub
• refactor(preset): change queuedEffects to map like JS Array
• refactor: remove generic type from effect, effectScope
• refactor: more accurate unwatched handling
• fix: invalidate parent effect when executing effectScope
• test: update untrack tests
• test: use setCurrentSub instead of pauseTracking

NOTE: Sync upstream v2.0.4 version.

Major Changes #

• Sync with upstream alien-signal v2.0.1
• Complete package restructuring and reorganization
• Remove workspace structure in favor of a single package repository

Features #

• Implement improved reactive system architecture
• Add comprehensive signal management capabilities
  • Add signal() function for creating reactive state
  • Add computed() function for derived state
  • Add effect() function for side effects
  • Add effectScope() for managing groups of effects
• Add batch processing with startBatch() and endBatch()
• Add tracking control with pauseTracking() and resumeTracking()

Development #

• Lower minimum Dart SDK requirement to ^3.6.0 (from ^3.7.0)
• Add extensive test suite for reactivity features
• Remove separate packages in favor of a single focused package
• Update CI workflow for multi-SDK testing
• Add comprehensive examples showing signal features

Documentation #

• Expanded example code to demonstrate more signal features