What problem does it solve?
Updating a reactive signals implementation by hand is error-prone, because algorithmic changes, optimizations, and bug fixes must be kept in lockstep between the upstream Preact JS implementation and the Dart preact_signals port.
Core Features & Use Cases
- Upstream submodule synchronization: Initializes and upgrades the pinned
third_party/preactjs_signals submodule to a specific tag/commit so the Dart port is based on the same core logic.
- Core change review & selective porting: Compares upstream core primitives and tests to identify algorithmic optimizations, bug fixes, and API contract changes, then ports only the relevant parts into Dart.
- Release-ready Dart updates: Aligns Dart package versioning and changelog entries with the upstream synced version, then verifies correctness by running the monorepo test and coverage workflow.
Quick Start
Ask the AI to produce a step-by-step plan to upgrade the pinned third_party/preactjs_signals submodule to a specified upstream tag, review the upstream core/test diffs, port the matching logic into packages/preact_signals, update pubspec.yaml and CHANGELOG.md, and run the full melos verification checklist.