jolt_setup 3.2.0-dev.0

jolt_setup: ^3.2.0-dev.0 copied to clipboard

• FEAT(setup): useReset hook for reset-setup. (50111813)
• FEAT: devtools. (a243e172)

useReset Hook #

The useReset hook provides a runtime mechanism to reset and re-run the setup function, similar to hot reload but triggered programmatically. This is useful when you need to completely reinitialize all hooks and state in response to external changes.

Why is it needed?

In some scenarios, you may need to completely reset the widget's setup rather than just updating individual hooks:

1. External state changes: When external state (like a global configuration or theme) changes, you may want to reinitialize all hooks with the new state
2. Dynamic reconfiguration: When the widget needs to be reconfigured based on runtime conditions
3. State synchronization: When you need to ensure all hooks are recreated to match a new state snapshot

Usage:

The useReset hook provides four methods: useReset() for manual reset, useReset.listen() to listen to Listenable changes, useReset.watch() to watch reactive signal changes, and useReset.select() to watch selected value changes.

When reset is triggered, the setup function is completely re-run:

• All existing hooks are unmounted in reverse order
• All effects and cleanup functions are disposed
• All hook state is cleared
• The setup function is re-executed to create new hooks
• New hooks are mounted

This ensures a clean slate for the widget's reactive state.

• REFACTOR: implement fine-grained hot reload for partial hooks. (53226b34)

• REFACTOR: use annotation to mark hook functions instead of naming convention check. (f25bdad9)
• FIX(jolt_setup): fix hook state not being reused during hot reload. (84de46b8)
• FEAT(jolt_setup): pass new hook config to reassemble during hot reload. (c9aa7ff6)

• FIX(jolt_setup): provide clean Props interface. (e5234541)

• REFACTOR: extract setup functionality to separate package and optimize hooks. (cb9c4705)

• REFACTOR: rename lifecycle hook methods for consistency. (25a6567e)
• REFACTOR: replace abstract hook creators with final implementations. (87314ba2)
• PERF: optimize listenable implementation with peek and code refactor. (b36ec5d5)
• FEAT: add hooks withPrevious for computed values. (6c3c3b04)

• Graduate package to a stable release. See pre-releases prior to this version for changelog entries.

• PERF: improve base interface. (58b0e706)
• FIX: add test coverage. (b3e7bca7)
• FIX(jolt_flutter): fix useSignal.async function signature and implementation. (5bfdb1e0)
• FEAT: add FlutterEffect for frame-end scheduling. (9caccf58)

• FIX(jolt_flutter): prevent duplicate scheduled rebuilds. (59d535df)
• FIX(jolt_flutter): fix provider update logic and add .value constructor. (88177013)
• FEAT: add call helpers, useInherited hook, drop extra rebuild. (69263dd1)

Note: This release has breaking changes.

• BREAKING FEAT(jolt_flutter): add SetupMixin. (50487f6c)

• REFACTOR(jolt_flutter,jolt_hooks): unify hook calling style for better extensibility. (fc27ba2e)
• REFACTOR(setup): restructure hook system with improved lifecycle management. (9fa92a97)
• FIX: adapt PropsReadonlyNode to CustomReactiveNode. (5470aa67)

• REFACTOR(jolt_flutter): refactor SetupWidget hook system architecture. (db32a9a3)
• REFACTOR: restructure public API exports. (d3716988)

New features:

• New library:

  • Added setup.dart library, exporting SetupWidget, SetupBuilder, and corresponding hooks

• REFACTOR: rename setup widget. (c7f5fb71)

• REFACTOR: extract hooks into separate jolt_flutter_hooks package. (e12adb35)

• REFACTOR(setup): improve reactive tracking. (70bffa24)

• REFACTOR(setup): consolidate hooks exports. (4f4dcf70)

• REFACTOR(core): optimize reactive system core and improve code quality. (444957b6)

• REFACTOR: restructure core interfaces and implementation classes. (e552ab33)

• FEAT: implement Setup Widget with type-based hook hot reload. (e71cf18c)

• FEAT: add onChangedDependencies() hook. (00a540bf)

• DOCS(jolt_flutter): update api documents. (48b51351)

• FIX: prevent rebuild on disposed widgets, extract shared effect builder. (6cc45681)

• Update a dependency to the latest release.

• REFACTOR(jolt_flutter): optimize widgets dependency tracking and rebuild logic for better performance. (52ebbeee)

• FEAT(jolt): add value parameter support to JoltProvider. (e7b4faac)

Note: This release has breaking changes.

• REFACTOR: simplify EffectScope API, add detach parameter. (eed8cc1a)
• FIX(jolt_flutter): remove redundant dependency. (942c61a2)
• FEAT(jolt): allow watcher to receive null as old value when called immediately. (b101c68e)
• DOCS: improve code documentation. (c152870a)
• BREAKING REFACTOR: remove JoltResource, add JoltProvider, refactor JoltSelector. (a91e0860)

• chore: update dependencies

• chore: use melos for monorepo management
• feat: add mutual conversion between ValueListenable/ValueNotifier and signal

• docs: update README
• chore: bump minimum required jolt version to 0.0.5

• chore: update dependencies

• fix: effect scope context

• chore: update dependencies

• fix: some bugs
• refactor: value notifier extension

• Initial version.