preact/hooks/dist/hooks.js.map

Fast 3kb React-compatible Virtual DOM library.

{"version":3,"file":"hooks.js","sources":["../src/index.js"],"sourcesContent":["import { options } from 'preact';\n\n/** @type {number} */\nlet currentIndex;\n\n/** @type {import('./internal').Component} */\nlet currentComponent;\n\n/** @type {number} */\nlet currentHook = 0;\n\n/** @type {Array<import('./internal').Component>} */\nlet afterPaintEffects = [];\n\nlet oldBeforeRender = options._render;\nlet oldAfterDiff = options.diffed;\nlet oldCommit = options._commit;\nlet oldBeforeUnmount = options.unmount;\n\nconst RAF_TIMEOUT = 100;\nlet prevRaf;\n\noptions._render = vnode => {\n\tif (oldBeforeRender) oldBeforeRender(vnode);\n\n\tcurrentComponent = vnode._component;\n\tcurrentIndex = 0;\n\n\tif (currentComponent.__hooks) {\n\t\tcurrentComponent.__hooks._pendingEffects.forEach(invokeCleanup);\n\t\tcurrentComponent.__hooks._pendingEffects.forEach(invokeEffect);\n\t\tcurrentComponent.__hooks._pendingEffects = [];\n\t}\n};\n\noptions.diffed = vnode => {\n\tif (oldAfterDiff) oldAfterDiff(vnode);\n\n\tconst c = vnode._component;\n\tif (!c) return;\n\n\tconst hooks = c.__hooks;\n\tif (hooks) {\n\t\tif (hooks._pendingEffects.length) {\n\t\t\tafterPaint(afterPaintEffects.push(c));\n\t\t}\n\t}\n};\n\noptions._commit = (vnode, commitQueue) => {\n\tcommitQueue.some(component => {\n\t\ttry {\n\t\t\tcomponent._renderCallbacks.forEach(invokeCleanup);\n\t\t\tcomponent._renderCallbacks = component._renderCallbacks.filter(cb =>\n\t\t\t\tcb._value ? invokeEffect(cb) : true\n\t\t\t);\n\t\t} catch (e) {\n\t\t\tcommitQueue.some(c => {\n\t\t\t\tif (c._renderCallbacks) c._renderCallbacks = [];\n\t\t\t});\n\t\t\tcommitQueue = [];\n\t\t\toptions._catchError(e, component._vnode);\n\t\t}\n\t});\n\n\tif (oldCommit) oldCommit(vnode, commitQueue);\n};\n\noptions.unmount = vnode => {\n\tif (oldBeforeUnmount) oldBeforeUnmount(vnode);\n\n\tconst c = vnode._component;\n\tif (!c) return;\n\n\tconst hooks = c.__hooks;\n\tif (hooks) {\n\t\ttry {\n\t\t\thooks._list.forEach(hook => hook._cleanup && hook._cleanup());\n\t\t} catch (e) {\n\t\t\toptions._catchError(e, c._vnode);\n\t\t}\n\t}\n};\n\n/**\n * Get a hook's state from the currentComponent\n * @param {number} index The index of the hook to get\n * @param {number} type The index of the hook to get\n * @returns {import('./internal').HookState}\n */\nfunction getHookState(index, type) {\n\tif (options._hook) {\n\t\toptions._hook(currentComponent, index, currentHook || type);\n\t}\n\tcurrentHook = 0;\n\n\t// Largely inspired by:\n\t// * https://github.com/michael-klein/funcy.js/blob/f6be73468e6ec46b0ff5aa3cc4c9baf72a29025a/src/hooks/core_hooks.mjs\n\t// * https://github.com/michael-klein/funcy.js/blob/650beaa58c43c33a74820a3c98b3c7079cf2e333/src/renderer.mjs\n\t// Other implementations to look at:\n\t// * https://codesandbox.io/s/mnox05qp8\n\tconst hooks =\n\t\tcurrentComponent.__hooks ||\n\t\t(currentComponent.__hooks = {\n\t\t\t_list: [],\n\t\t\t_pendingEffects: []\n\t\t});\n\n\tif (index >= hooks._list.length) {\n\t\thooks._list.push({});\n\t}\n\treturn hooks._list[index];\n}\n\n/**\n * @param {import('./index').StateUpdater<any>} initialState\n */\nexport function useState(initialState) {\n\tcurrentHook = 1;\n\treturn useReducer(invokeOrReturn, initialState);\n}\n\n/**\n * @param {import('./index').Reducer<any, any>} reducer\n * @param {import('./index').StateUpdater<any>} initialState\n * @param {(initialState: any) => void} [init]\n * @returns {[ any, (state: any) => void ]}\n */\nexport function useReducer(reducer, initialState, init) {\n\t/** @type {import('./internal').ReducerHookState} */\n\tconst hookState = getHookState(currentIndex++, 2);\n\tif (!hookState._component) {\n\t\thookState._component = currentComponent;\n\n\t\thookState._value = [\n\t\t\t!init ? invokeOrReturn(undefined, initialState) : init(initialState),\n\n\t\t\taction => {\n\t\t\t\tconst nextValue = reducer(hookState._value[0], action);\n\t\t\t\tif (hookState._value[0] !== nextValue) {\n\t\t\t\t\thookState._value[0] = nextValue;\n\t\t\t\t\thookState._component.setState({});\n\t\t\t\t}\n\t\t\t}\n\t\t];\n\t}\n\n\treturn hookState._value;\n}\n\n/**\n * @param {import('./internal').Effect} callback\n * @param {any[]} args\n */\nexport function useEffect(callback, args) {\n\t/** @type {import('./internal').EffectHookState} */\n\tconst state = getHookState(currentIndex++, 3);\n\tif (!options._skipEffects && argsChanged(state._args, args)) {\n\t\tstate._value = callback;\n\t\tstate._args = args;\n\n\t\tcurrentComponent.__hooks._pendingEffects.push(state);\n\t}\n}\n\n/**\n * @param {import('./internal').Effect} callback\n * @param {any[]} args\n */\nexport function useLayoutEffect(callback, args) {\n\t/** @type {import('./internal').EffectHookState} */\n\tconst state = getHookState(currentIndex++, 4);\n\tif (!options._skipEffects && argsChanged(state._args, args)) {\n\t\tstate._value = callback;\n\t\tstate._args = args;\n\n\t\tcurrentComponent._renderCallbacks.push(state);\n\t}\n}\n\nexport function useRef(initialValue) {\n\tcurrentHook = 5;\n\treturn useMemo(() => ({ current: initialValue }), []);\n}\n\n/**\n * @param {object} ref\n * @param {() => object} createHandle\n * @param {any[]} args\n */\nexport function useImperativeHandle(ref, createHandle, args) {\n\tcurrentHook = 6;\n\tuseLayoutEffect(\n\t\t() => {\n\t\t\tif (typeof ref == 'function') ref(createHandle());\n\t\t\telse if (ref) ref.current = createHandle();\n\t\t},\n\t\targs == null ? args : args.concat(ref)\n\t);\n}\n\n/**\n * @param {() => any} factory\n * @param {any[]} args\n */\nexport function useMemo(factory, args) {\n\t/** @type {import('./internal').MemoHookState} */\n\tconst state = getHookState(currentIndex++, 7);\n\tif (argsChanged(state._args, args)) {\n\t\tstate._args = args;\n\t\tstate._factory = factory;\n\t\treturn (state._value = factory());\n\t}\n\n\treturn state._value;\n}\n\n/**\n * @param {() => void} callback\n * @param {any[]} args\n */\nexport function useCallback(callback, args) {\n\tcurrentHook = 8;\n\treturn useMemo(() => callback, args);\n}\n\n/**\n * @param {import('./internal').PreactContext} context\n */\nexport function useContext(context) {\n\tconst provider = currentComponent.context[context._id];\n\t// We could skip this call here, but than we'd not call\n\t// `options._hook`. We need to do that in order to make\n\t// the devtools aware of this hook.\n\tconst state = getHookState(currentIndex++, 9);\n\t// The devtools needs access to the context object to\n\t// be able to pull of the default value when no provider\n\t// is present in the tree.\n\tstate._context = context;\n\tif (!provider) return context._defaultValue;\n\t// This is probably not safe to convert to \"!\"\n\tif (state._value == null) {\n\t\tstate._value = true;\n\t\tprovider.sub(currentComponent);\n\t}\n\treturn provider.props.value;\n}\n\n/**\n * Display a custom label for a custom hook for the devtools panel\n * @type {<T>(value: T, cb?: (value: T) => string | number) => void}\n */\nexport function useDebugValue(value, formatter) {\n\tif (options.useDebugValue) {\n\t\toptions.useDebugValue(formatter ? formatter(value) : value);\n\t}\n}\n\nexport function useErrorBoundary(cb) {\n\tconst state = getHookState(currentIndex++, 10);\n\tconst errState = useState();\n\tstate._value = cb;\n\tif (!currentComponent.componentDidCatch) {\n\t\tcurrentComponent.componentDidCatch = err => {\n\t\t\tif (state._value) state._value(err);\n\t\t\terrState[1](err);\n\t\t};\n\t}\n\treturn [\n\t\terrState[0],\n\t\t() => {\n\t\t\terrState[1](undefined);\n\t\t}\n\t];\n}\n\n/**\n * After paint effects consumer.\n */\nfunction flushAfterPaintEffects() {\n\tafterPaintEffects.some(component => {\n\t\tif (component._parentDom) {\n\t\t\ttry {\n\t\t\t\tcomponent.__hooks._pendingEffects.forEach(invokeCleanup);\n\t\t\t\tcomponent.__hooks._pendingEffects.forEach(invokeEffect);\n\t\t\t\tcomponent.__hooks._pendingEffects = [];\n\t\t\t} catch (e) {\n\t\t\t\tcomponent.__hooks._pendingEffects = [];\n\t\t\t\toptions._catchError(e, component._vnode);\n\t\t\t\treturn true;\n\t\t\t}\n\t\t}\n\t});\n\tafterPaintEffects = [];\n}\n\n/**\n * Schedule a callback to be invoked after the browser has a chance to paint a new frame.\n * Do this by combining requestAnimationFrame (rAF) + setTimeout to invoke a callback after\n * the next browser frame.\n *\n * Also, schedule a timeout in parallel to the the rAF to ensure the callback is invoked\n * even if RAF doesn't fire (for example if the browser tab is not visible)\n *\n * @param {() => void} callback\n */\nfunction afterNextFrame(callback) {\n\tconst done = () => {\n\t\tclearTimeout(timeout);\n\t\tcancelAnimationFrame(raf);\n\t\tsetTimeout(callback);\n\t};\n\tconst timeout = setTimeout(done, RAF_TIMEOUT);\n\n\tlet raf;\n\tif (typeof window != 'undefined') {\n\t\traf = requestAnimationFrame(done);\n\t}\n}\n\n// Note: if someone used options.debounceRendering = requestAnimationFrame,\n// then effects will ALWAYS run on the NEXT frame instead of the current one, incurring a ~16ms delay.\n// Perhaps this is not such a big deal.\n/**\n * Schedule afterPaintEffects flush after the browser paints\n * @param {number} newQueueLength\n */\nfunction afterPaint(newQueueLength) {\n\tif (newQueueLength === 1 || prevRaf !== options.requestAnimationFrame) {\n\t\tprevRaf = options.requestAnimationFrame;\n\t\t(prevRaf || afterNextFrame)(flushAfterPaintEffects);\n\t}\n}\n\n/**\n * @param {import('./internal').EffectHookState} hook\n */\nfunction invokeCleanup(hook) {\n\tif (hook._cleanup) hook._cleanup();\n}\n\n/**\n * Invoke a Hook's effect\n * @param {import('./internal').EffectHookState} hook\n */\nfunction invokeEffect(hook) {\n\tconst result = hook._value();\n\tif (typeof result == 'function') hook._cleanup = result;\n}\n\n/**\n * @param {any[]} oldArgs\n * @param {any[]} newArgs\n */\nfunction argsChanged(oldArgs, newArgs) {\n\treturn !oldArgs || newArgs.some((arg, index) => arg !== oldArgs[index]);\n}\n\nfunction invokeOrReturn(arg, f) {\n\treturn typeof f == 'function' ? f(arg) : f;\n}\n"],"names":["currentIndex","currentComponent","prevRaf","currentHook","afterPaintEffects","oldBeforeRender","options","_render","oldAfterDiff","diffed","oldCommit","_commit","oldBeforeUnmount","unmount","getHookState","index","type","_hook","hooks","__hooks","_list","_pendingEffects","length","push","useState","initialState","useReducer","invokeOrReturn","reducer","init","hookState","_component","_value","undefined","action","nextValue","setState","useLayoutEffect","callback","args","state","_skipEffects","argsChanged","_args","_renderCallbacks","useMemo","factory","_factory","flushAfterPaintEffects","some","component","_parentDom","forEach","invokeCleanup","invokeEffect","e","_catchError","_vnode","hook","_cleanup","result","oldArgs","newArgs","arg","f","vnode","c","requestAnimationFrame","raf","done","clearTimeout","timeout","cancelAnimationFrame","setTimeout","window","commitQueue","filter","cb","initialValue","current","ref","createHandle","concat","context","provider","_id","_context","sub","props","value","_defaultValue","formatter","useDebugValue","errState","componentDidCatch","err"],"mappings":"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"}