flutter_hooks

Merge branch 'master' of https://github.com/rrousselGit/flutter_hooks

flutter_hooks : 0.21.1-pre.3 -> 0.21.1-pre.4

flutter_hooks : 0.21.1-pre.2 -> 0.21.1-pre.3

flutter_hooks : 0.21.1-pre.1 -> 0.21.1-pre.2

flutter_hooks : 0.21.1-pre.0 -> 0.21.1

• Bump minimum Flutter SDK to 3.21.0-13.0.pre.4

flutter_hooks : 0.20.5 -> 0.21.0

flutter_hooks : 0.20.4 -> 0.20.5

• Added useDebounced (thanks to @itisnajim)
• Removed @visibleForTesting on HookMixin

• Added useExpansionTileController (thanks to @droidbg)
• Added useMaterialStatesController (thanks to @AdamHavlicek)

• Fixed key matching algorithm incorrectly not checking all keys if a 0 or a NaN is present (thanks to @AlexDochioiu)

• useListenableSelector now supports null listeners (thanks to @JWo1F)

• Breaking: keys comparison has changed under the following conditions:
  • Change from double.nan to double.nan preserves the state.
  • Change from 0.0 to -0.0 or vice versa does NOT preserve the state.
• Added useOnStreamChange (thanks to @jezsung)

• Added useSearchController (thanks to @snapsl)
• Keys on useCallback are now optional, to match useMemoized (thanks to @jezsung)
• Update usePlatformBrightness to stop relying on deprecated code

• Added korean translation (thanks to @sejun2)
• Add useFocusScopeNode hook (thanks to @iamsahilsonawane)

• Added useListenableSelector, similar to useListenable, for listening to a Listenable but rebuilding the widget only if a certain data has changed (thanks to @ronnieeeeee)
• Added useAutomaticKeepAlive (thanks to @DevNico)
• Added usePlatformBrightness and useOnPlatformBrightnessChange to interact with platform Brightness (thanks to @AhmedLSayed9)

Update links to the repository

Upgrade to Flutter 3.0.0

Added onKeyEvent to useFocusNode (thanks to @kdelorey)

• Allow null in useListenable

Improved the documentation (thanks to @Renni771)

• Added useTransformationController, to create a TransformationController (thanks to @shrouxm)
• Added useAppLifecycleState and useOnAppLifecycleStateChange to interact with AppLifecycleState (thanks to @francipvb)

• Breaking: useRef now receive an initial value as parameter. To migrate, you can change:

  ObjectRef<int> ref = useRef<int>();
  

  to:

  ObjectRef<int?> ref = useRef<int?>(null);
  

• Updated useStream/useFuture to match the behavior of StreamBuilder/FutureBuilder regarding initial values.

• Added a reverseDuration parameter to useAnimationController

• useFuture/useStream's AsynsSnapshot now correctly expose the StackTrace when there is an error.
• added useRef and useCallback, similar to the React equivalents.
• initialData of useStream and useFuture is now optional.

Stable null-safety release

Migrated flutter_hooks to null-safety (special thanks to @DevNico for the help!)

• Added usePageController to create a PageController

• Increased the minimum version of the Flutter SDK required to match changes on useFocusNode

  The minimum required is now 1.20.0 (the stable channel is at 1.20.4)

• added all FocusNode parameters to useFocusNode
• Fixed a bug where on hot-reload, a HookWidget could potentially not rebuild
• Allow hooks to integrate with the devtool using the Diagnosticable API, and implement it for all built-in hooks.

• useIsMounted now returns a function instead of a callable class.

• Added useIsMounted to determine whether a widget was destroyed or not (thanks to @davidmartos96)

• Added useScrollController to create a ScrollController
• added useTabController to create a TabController (thanks to @Albert221)

Breaking change:

• Removed HookState.didBuild. If you still need it, use addPostFrameCallback or Future.microtask.

Non-breaking changes:

• Fix a bug where the order in which hooks are disposed is incorrect.

• It is now allowed to rebuild a HookWidget with more/less hooks than previously. Example:

  Widget build(context) {
    useSomething();
    if (condition) {
      return Container();
    }
    useSomething()
    return Container();
  }
  

• Deprecated Hook.use in favor of a new short-hand use. Before:

  Hook.use(MyHook());
  

  After:

  use(MyHook());
  

Breaking change:

• The order in which hooks are disposed has been reversed.

  Consider:

  useSomething();
  useSomethingElse();
  

  Before, the useSomething was disposed before useSomethingElse. Now, useSomethingElse is disposed before the useSomething.

  The reason for this change is for cases like:

  // Creates an AnimationController
  final animationController = useAnimationController();
  // Immediately listen to the AnimationController
  useListenable(animationController);
  

  Before, when the widget was disposed, this caused an exception as useListenable unsubscribed to the AnimationController after its dispose method was called.

Non-breaking changes:

• Added a way for hooks to potentially abort a widget rebuild.
• Added StatefulHookWidget, a StatefulWidget that can use hooks inside its build method.

• Added a deactivate life-cycle to HookState

Added useFocusNode

• Fixed link to "Existing hooks" in README.md.

• Added useTextEditingController, thanks to simolus3!

• Added useReassemble hook, thanks to @SahandAkbarzadeh

• Make hooks compatible with newer flutter stable version 1.7.8-hotfix.2.

• Make hooks compatible with newer flutter version. (see https://groups.google.com/forum/#!topic/flutter-announce/hp1RNIgej38)

• NEW: usePrevious, a hook that returns the previous argument is received.
• NEW: it is now impossible to call inheritFromWidgetOfExactType inside initHook of hooks. This forces authors to handle value updates.
• FIX: use List<Object> instead of List<dynamic> for keys. This fixes implicit-dynamic rule mistakenly reporting errors.
• NEW: Hooks are now visible on HookElement through debugHooks in development, for testing purposes.
• NEW: If a widget throws on the first build or after a hot-reload, next rebuilds can still add/edit hooks until one build finishes entirely.
• NEW: new life-cycle available on HookState: didBuild. This life-cycle is called synchronously right after build method of HookWidget finished.
• NEW: new reassemble life-cycle on HookState. It is equivalent to State.reassemble of statefulwidgets.
• NEW: useStream and useFuture now have an optional preserveState flag. This toggle how these hooks behave when changing the stream/future: If true (default) they keep the previous value, else they reset to initialState.

• NEW: useValueNotifier, which creates a ValueNotifier similarly to useState. But without listening it. This can be useful to have a more granular rebuild when combined to useValueListenable.
• NEW: useContext, which exposes the BuildContext of the currently building HookWidget.

• Made all existing hooks as static functions, and removed HookContext. The migration is as followed:

Widget build(HookContext context) {
    final state = context.useState(0);
}

becomes:

Widget build(BuildContext context) {
    final state = useState(0);
}

• Introduced keys for hooks and applied them to hooks where it makes sense.
• Added useReducer for complex state. It is similar to useState but is being managed by a Reducer and can only be changed by dispatching an action.
• fixes a bug where hot-reload without using hooks thrown an exception

• useMemoized callback doesn't take the previous value anymore (to match React API) Use useValueChanged instead.
• Introduced useEffect and useStreamController
• fixed a bug where hot-reload while reordering/adding hooks did not work properly
• improved readme

Added a few common hooks:

• useStream
• useFuture
• useAnimationController
• useSingleTickerProvider
• useListenable
• useValueListenable
• useAnimation