Universal Hooks

This library aims to provide a common interface for React-like hooks to plug into. Simply plug in an implementation and your hooks are reusable across different implementations.

Usage

There are two ways to plug in an implementation. You can supply a module at runtime or you can replace Universal Hooks at compile time.

Provide an implementation at runtime

1// Set an implementation for the hooks
2setImplementation(haunted)
3// OR
4setImplementation(React)
5// OR
6setImplementation(Preact)
7
8// Use the hooks like normal
9function useCounter() {
10    const [counter, setCounter] = useState(0);
11
12    const increment = () => setCounter((c) => c + 1)
13    const decrement = () => setCounter((c) => c - 1)
14
15    return {counter, increment, decrement}
16}

Provide an implementation via bundlers

Rollup, Webpack and other bundlers allow compile-time replacement of implementations.

E.g. with the Rollup alias plugin https://github.com/rollup/plugins/tree/master/packages/alias

To swap in React

1entries: [
2  { find: '@saasquatch/universal-hooks', replacement: 'React' },
3];

To swap in Haunted

1entries: [
2  { find: '@saasquatch/universal-hooks', replacement: 'haunted' },
3];

API

Most common hooks are supported, except for useContext.

• useState
• useMemo
• useCallback
• useEffect
• useReducer
• useRef