frosty 0.0.115 → 0.0.117

package/dist/internals/{sync-CeJllG9M.mjs → sync-DRp6Vg-9.mjs}

@@ -1,5 +1,6 @@
 import _ from 'lodash';
-import { e as equalDeps, r as reconciler } from './state-DgSrjGGU.mjs';
+import { jsx } from '../jsx-runtime.mjs';
+import { e as equalDeps, r as reconciler, a as createContext, b as useContext } from './state-k40d_k34.mjs';
 
 //
 //  index.ts
@@ -62,6 +63,48 @@ const _useMemo = (hook, factory, deps) => {
     return data;
 };
 
+//
+//  memo.ts
+//
+//  The MIT License
+//  Copyright (c) 2021 - 2025 O2ter Limited. All rights reserved.
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+//
+function useState(initialState) {
+    const { value, setValue } = _useMemo('useState', ({ node }) => {
+        const state = {
+            value: _.isFunction(initialState) ? initialState() : initialState,
+            setValue: (dispatch) => {
+                const oldValue = state.value;
+                const newValue = _.isFunction(dispatch) ? dispatch(oldValue) : dispatch;
+                if (oldValue === newValue)
+                    return;
+                state.value = newValue;
+                node?._setDirty();
+            },
+        };
+        return state;
+    }, null);
+    return [value, setValue];
+}
+
 //
 //  effect.ts
 //
@@ -216,6 +259,124 @@ function useCallback(callback, deps) {
  */
 const useMemo = (factory, deps) => _useMemo('useMemo', () => factory(), deps);
 
+//
+//  storage.ts
+//
+//  The MIT License
+//  Copyright (c) 2021 - 2025 O2ter Limited. All rights reserved.
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+//
+const storage = new WeakMap();
+/**
+ * Returns a persistent storage Map associated with the current renderer instance.
+ * This hook allows components to store and retrieve values that persist across renders,
+ * scoped to the renderer. Must be called within a render function.
+ *
+ * @throws Error if called outside of a render function.
+ * @returns {Map<any, any>} The storage map for the current renderer.
+ */
+const useRendererStorage = (persist = true) => {
+    const state = reconciler.currentHookState;
+    if (!state)
+        throw Error('useRendererStorage must be used within a render function.');
+    if (!persist)
+        return state.renderer.renderStorage;
+    const found = storage.get(state.renderer);
+    const store = found ?? new Map();
+    if (!found)
+        storage.set(state.renderer, store);
+    return store;
+};
+
+const defaultStorageKey = Symbol();
+const Context = createContext();
+/**
+ * A context provider component for managing asynchronous resource errors.
+ *
+ * This component provides a shared context for tracking errors encountered during
+ * asynchronous operations. It allows child components to access and manage these errors
+ * using the `useResourceErrors` hook.
+ *
+ * ### Usage:
+ * Wrap your application or specific parts of it with this component to enable error tracking:
+ *
+ * ```tsx
+ * <ResourceErrors>
+ *   <YourComponent />
+ * </ResourceErrors>
+ * ```
+ *
+ * @param children - The child components that will have access to the error context.
+ *
+ * @returns A context provider that wraps the provided children.
+ */
+const ResourceErrors = ({ children }) => {
+    const [errors, setErrors] = useState([]);
+    const value = useMemo(() => ({ errors, setErrors }), [errors, setErrors]);
+    return (jsx(Context, { value: value, children: children }));
+};
+const useErrorContext = () => {
+    const value = useContext(Context);
+    if (value)
+        return value;
+    const storage = useRendererStorage();
+    const found = storage.get(defaultStorageKey);
+    if (found)
+        return found;
+    const store = {
+        errors: [],
+        setErrors: (values) => {
+            store.errors = _.isFunction(values) ? values(store.errors) : values;
+        },
+    };
+    storage.set(defaultStorageKey, store);
+    return store;
+};
+/**
+ * A hook to access the list of asynchronous resource errors.
+ *
+ * This hook allows components to retrieve the current list of errors being tracked
+ * in the `ResourceErrors` context. It must be used within a component that is
+ * a descendant of the `ResourceErrors` provider.
+ *
+ * ### Usage:
+ * ```tsx
+ * import { useEffect, useResourceErrors } from 'frosty';
+ *
+ * const errors = useResourceErrors();
+ *
+ * useEffect(() => {
+ *   errors.forEach(({ token, error, refresh }) => {
+ *     console.error(`Error [${token}]:`, error);
+ *     // Optionally call refresh() to retry the operation
+ *   });
+ * }, [errors]);
+ * ```
+ *
+ * @returns The list of errors currently being tracked in the context. Each error includes:
+ * - `token`: A unique identifier for the error.
+ * - `error`: The error object or message.
+ * - `refresh`: A function to retry the operation that caused the error.
+ */
+const useResourceErrors = () => useErrorContext().errors;
+
 //
 //  sync.ts
 //
@@ -288,5 +449,5 @@ const useSyncExternalStore = (subscribe, getSnapshot, getServerSnapshot) => {
     return getSnapshot();
 };
 
-export { _useMemo as _, useEffect as a, useCallback as b, useSyncExternalStore as c, _useEffect as d, useMemo as u };
-//# sourceMappingURL=sync-CeJllG9M.mjs.map
+export { ResourceErrors as R, _useMemo as _, useEffect as a, useCallback as b, useErrorContext as c, useSyncExternalStore as d, _useEffect as e, useMemo as f, useRendererStorage as g, useResourceErrors as h, useState as u };
+//# sourceMappingURL=sync-DRp6Vg-9.mjs.map

package/dist/internals/sync-DRp6Vg-9.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-DRp6Vg-9.mjs","sources":["../../../src/core/reconciler/hooks.ts","../../../src/core/hooks/state.ts","../../../src/core/hooks/effect.ts","../../../src/core/hooks/callback.ts","../../../src/core/hooks/memo.ts","../../../src/core/hooks/storage.ts","../../../src/core/hooks/misc/resource/error.tsx","../../../src/core/hooks/sync.ts"],"sourcesContent":["//\n//  index.ts\n//\n//  The MIT License\n//  Copyright (c) 2021 - 2025 O2ter Limited. All rights reserved.\n//\n//  Permission is hereby granted, free of charge, to any person obtaining a copy\n//  of this software and associated documentation files (the \"Software\"), to deal\n//  in the Software without restriction, including without limitation the rights\n//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n//  copies of the Software, and to permit persons to whom the Software is\n//  furnished to do so, subject to the following conditions:\n//\n//  The above copyright notice and this permission notice shall be included in\n//  all copies or substantial portions of the Software.\n//\n//  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n//  THE SOFTWARE.\n//\n\nimport _ from 'lodash';\nimport { reconciler } from './state';\nimport { equalDeps } from './utils';\n\nconst _useHookState = (hook: string) => {\n  const state = reconciler.currentHookState;\n  if (!state) throw Error(`${hook} must be used within a render function.`);\n  const { prevState, state: newState } = state;\n  if (prevState && prevState[newState.length]?.hook !== hook) {\n    console.warn([\n      `Hook \"${hook}\" is called conditionally.`,\n      'Hooks must be called in the exact same order in every component render.',\n      'Did you accidentally call a hook after an early return?'\n    ].join(' '));\n  }\n  return state;\n};\n\nexport const _useEffect = (\n  hook: string,\n  effect: (state: ReturnType<typeof _useHookState>) => () => void,\n  deps?: any\n) => {\n  const state = _useHookState(hook);\n  const { state: newState } = state;\n  newState.push({\n    mount: () => effect(state),\n    deps,\n    hook,\n  });\n};\n\nexport const _useMemo = <T>(\n  hook: string,\n  factory: (state: ReturnType<typeof _useHookState>) => T,\n  deps?: any\n): T => {\n  const state = _useHookState(hook);\n  const { prevState, state: newState } = state;\n  const idx = newState.length;\n  const changed = prevState?.[idx]?.hook !== hook || !equalDeps(prevState[idx].deps, deps);\n  const data = changed ? factory(state) : prevState[idx].data;\n  newState.push({\n    deps,\n    hook,\n    data\n  });\n  return data;\n};\n","//\n//  memo.ts\n//\n//  The MIT License\n//  Copyright (c) 2021 - 2025 O2ter Limited. All rights reserved.\n//\n//  Permission is hereby granted, free of charge, to any person obtaining a copy\n//  of this software and associated documentation files (the \"Software\"), to deal\n//  in the Software without restriction, including without limitation the rights\n//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n//  copies of the Software, and to permit persons to whom the Software is\n//  furnished to do so, subject to the following conditions:\n//\n//  The above copyright notice and this permission notice shall be included in\n//  all copies or substantial portions of the Software.\n//\n//  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n//  THE SOFTWARE.\n//\n\nimport _ from 'lodash';\nimport { _useMemo } from '../reconciler/hooks';\nimport { SetStateAction } from '../types/common';\n\n/**\n * A hook function for managing state within a custom framework or library.\n *\n * @template T - The type of the state value.\n * @param - The initial state value or a function that returns the initial state.\n * @returns - A tuple containing the current state value and a function to update the state.\n *\n * The `useState` function provides a way to manage stateful values. It returns the current state\n * and a setter function that can update the state. The setter function accepts either a new value\n * or a function that receives the current state and returns the updated state.\n *\n * Example:\n * ```typescript\n * const [count, setCount] = useState(0);\n * setCount(5); // Updates the state to 5\n * setCount(prev => prev + 1); // Updates the state to the previous value + 1\n * ```\n */\nexport function useState<T>(initialState: T | (() => T)): [T, (dispatch: SetStateAction<T>) => void];\nexport function useState<T = undefined>(): [T | undefined, (dispatch: SetStateAction<T | undefined>) => void];\n\nexport function useState(initialState?: any) {\n  const { value, setValue } = _useMemo('useState', ({ node }) => {\n    const state = {\n      value: _.isFunction(initialState) ? initialState() : initialState,\n      setValue: (dispatch: SetStateAction<any>) => {\n        const oldValue = state.value;\n        const newValue = _.isFunction(dispatch) ? dispatch(oldValue) : dispatch;\n        if (oldValue === newValue) return;\n        state.value = newValue;\n        node?._setDirty();\n      },\n    };\n    return state;\n  }, null);\n  return [value, setValue];\n}\n","//\n//  effect.ts\n//\n//  The MIT License\n//  Copyright (c) 2021 - 2025 O2ter Limited. All rights reserved.\n//\n//  Permission is hereby granted, free of charge, to any person obtaining a copy\n//  of this software and associated documentation files (the \"Software\"), to deal\n//  in the Software without restriction, including without limitation the rights\n//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n//  copies of the Software, and to permit persons to whom the Software is\n//  furnished to do so, subject to the following conditions:\n//\n//  The above copyright notice and this permission notice shall be included in\n//  all copies or substantial portions of the Software.\n//\n//  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n//  THE SOFTWARE.\n//\n\nimport _ from 'lodash';\nimport { Awaitable } from '@o2ter/utils-js';\nimport { _useEffect } from '../reconciler/hooks';\n\n/**\n * A hook that manages side effects with support for an `AbortSignal`.\n * It ensures proper cleanup logic and handles asynchronous operations effectively.\n *\n * @param effect - \n *   A function that receives an `AbortSignal` and performs side effects. \n *   It can optionally return a cleanup function or a promise that resolves to a cleanup function.\n *\n * @param deps - \n *   An optional dependencies that determines when the effect should be re-executed.\n *\n * @example\n * useEffect((signal) => {\n  *   fetch('/api/data', { signal })\n *     .then(response => response.json())\n *     .then(data => console.log(data))\n *     .catch(err => {\n *       if (err.name === 'AbortError') {\n *         console.log('Fetch aborted');\n *       } else {\n *         console.error(err);\n *       }\n *     });\n *   \n *   return () => {\n *     console.log('Cleanup logic here');\n *   };\n * }, []);\n */\nexport const useEffect = (\n  effect: (\n    signal: AbortSignal,\n  ) => Awaitable<void | (() => Awaitable<void>)>,\n  deps?: any,\n) => _useEffect('useEffect', () => {\n  const abort = new AbortController();\n  try {\n    const destructor = effect(abort.signal);\n    return () => {\n      abort.abort();\n      (async () => {\n        try {\n          const _destructor = await destructor;\n          if (_.isFunction(_destructor)) _destructor();\n        } catch (e) {\n          console.error(e);\n        }\n      })();\n    };\n  } catch (e) {\n    console.error(e);\n    return () => abort.abort();\n  }\n}, deps);","//\n//  memo.ts\n//\n//  The MIT License\n//  Copyright (c) 2021 - 2025 O2ter Limited. All rights reserved.\n//\n//  Permission is hereby granted, free of charge, to any person obtaining a copy\n//  of this software and associated documentation files (the \"Software\"), to deal\n//  in the Software without restriction, including without limitation the rights\n//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n//  copies of the Software, and to permit persons to whom the Software is\n//  furnished to do so, subject to the following conditions:\n//\n//  The above copyright notice and this permission notice shall be included in\n//  all copies or substantial portions of the Software.\n//\n//  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n//  THE SOFTWARE.\n//\n\nimport _ from 'lodash';\nimport { _useMemo } from '../reconciler/hooks';\n\n/**\n * A hook that memoizes a callback function, ensuring that it only changes\n * if its dependencies change. This is useful for optimizing performance by preventing\n * unnecessary re-creations of functions.\n *\n * @template T - The type of the callback function.\n * @param callback - The callback function to be memoized.\n * @param deps - An optional dependencies. If provided, the callback\n *               will only be updated when one of these dependencies changes.\n *               If not provided, the callback will remain stable.\n * @returns - A stable version of the callback function that will not change unless\n *            its dependencies change.\n *\n * @example\n * const memoizedCallback = useCallback(() => {\n *   console.log('This function is memoized!');\n * }, [dependency]);\n */\n\nexport function useCallback<T extends (...args: any) => any>(\n  callback: T,\n  deps?: any\n): T;\n\nexport function useCallback<T extends ((...args: any) => any) | _.Falsey>(\n  callback: T,\n  deps?: any\n): T;\n\nexport function useCallback<T extends ((...args: any) => any) | _.Falsey>(\n  callback: T,\n  deps?: any\n): T {\n  if (!_.isUndefined(deps)) return _useMemo('useCallback', () => callback, deps);\n  const store = _useMemo('useCallback', () => {\n    const store = {\n      current: callback,\n      stable: function (this: any, ...args: any) {\n        if (_.isFunction(store.current))\n          return store.current.call(this, ...args);\n      },\n    };\n    return store;\n  }, null);\n  if (_.isFunction(callback)) store.current = callback;\n  return callback && (store.stable as T);\n}\n","//\n//  memo.ts\n//\n//  The MIT License\n//  Copyright (c) 2021 - 2025 O2ter Limited. All rights reserved.\n//\n//  Permission is hereby granted, free of charge, to any person obtaining a copy\n//  of this software and associated documentation files (the \"Software\"), to deal\n//  in the Software without restriction, including without limitation the rights\n//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n//  copies of the Software, and to permit persons to whom the Software is\n//  furnished to do so, subject to the following conditions:\n//\n//  The above copyright notice and this permission notice shall be included in\n//  all copies or substantial portions of the Software.\n//\n//  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n//  THE SOFTWARE.\n//\n\nimport _ from 'lodash';\nimport { _useMemo } from '../reconciler/hooks';\n\n/**\n * A utility function that memoizes the result of a factory function.\n * \n * @template T The type of the value returned by the factory function.\n * @param factory A function that produces a value to be memoized.\n * @param deps An optional dependency array. The memoized value is recalculated \n *             only when the dependencies change.\n * @returns The memoized value produced by the factory function.\n */\nexport const useMemo = <T>(\n  factory: () => T,\n  deps?: any,\n) => _useMemo('useMemo', () => factory(), deps);\n","//\n//  storage.ts\n//\n//  The MIT License\n//  Copyright (c) 2021 - 2025 O2ter Limited. All rights reserved.\n//\n//  Permission is hereby granted, free of charge, to any person obtaining a copy\n//  of this software and associated documentation files (the \"Software\"), to deal\n//  in the Software without restriction, including without limitation the rights\n//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n//  copies of the Software, and to permit persons to whom the Software is\n//  furnished to do so, subject to the following conditions:\n//\n//  The above copyright notice and this permission notice shall be included in\n//  all copies or substantial portions of the Software.\n//\n//  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n//  THE SOFTWARE.\n//\n\nimport _ from 'lodash';\nimport { reconciler } from '../reconciler/state';\n\nconst storage = new WeakMap<any, Map<any, any>>();\n\n/**\n * Returns a persistent storage Map associated with the current renderer instance.\n * This hook allows components to store and retrieve values that persist across renders,\n * scoped to the renderer. Must be called within a render function.\n *\n * @throws Error if called outside of a render function.\n * @returns {Map<any, any>} The storage map for the current renderer.\n */\nexport const useRendererStorage = (\n  persist = true\n) => {\n  const state = reconciler.currentHookState;\n  if (!state) throw Error('useRendererStorage must be used within a render function.');\n  if (!persist) return state.renderer.renderStorage;\n  const found = storage.get(state.renderer);\n  const store = found ?? new Map<any, any>();\n  if (!found) storage.set(state.renderer, store);\n  return store;\n};\n","//\n//  error.ts\n//\n//  The MIT License\n//  Copyright (c) 2021 - 2025 O2ter Limited. All rights reserved.\n//\n//  Permission is hereby granted, free of charge, to any person obtaining a copy\n//  of this software and associated documentation files (the \"Software\"), to deal\n//  in the Software without restriction, including without limitation the rights\n//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n//  copies of the Software, and to permit persons to whom the Software is\n//  furnished to do so, subject to the following conditions:\n//\n//  The above copyright notice and this permission notice shall be included in\n//  all copies or substantial portions of the Software.\n//\n//  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n//  THE SOFTWARE.\n//\n\nimport _ from 'lodash';\nimport { Awaitable } from '@o2ter/utils-js';\nimport { ComponentType, PropsWithChildren, SetStateAction } from '../../../types/common';\nimport { createContext } from '../../context';\nimport { useContext } from '../../context';\nimport { useState } from '../../state';\nimport { useMemo } from '../../memo';\nimport { useRendererStorage } from '../../storage';\n\ntype Errors = {\n  token: string;\n  error: any;\n  refresh: () => Awaitable<void>;\n  refreshing: boolean;\n  loading: boolean;\n}[];\n\ntype ContextValue = {\n  errors: Errors;\n  setErrors: (values: SetStateAction<Errors>) => void;\n};\n\nconst defaultStorageKey = Symbol();\nconst Context = createContext<ContextValue>();\n\n/**\n * A context provider component for managing asynchronous resource errors.\n * \n * This component provides a shared context for tracking errors encountered during\n * asynchronous operations. It allows child components to access and manage these errors\n * using the `useResourceErrors` hook.\n * \n * ### Usage:\n * Wrap your application or specific parts of it with this component to enable error tracking:\n * \n * ```tsx\n * <ResourceErrors>\n *   <YourComponent />\n * </ResourceErrors>\n * ```\n * \n * @param children - The child components that will have access to the error context.\n * \n * @returns A context provider that wraps the provided children.\n */\nexport const ResourceErrors: ComponentType<PropsWithChildren<{}>> = ({\n  children\n}) => {\n  const [errors, setErrors] = useState<Errors>([]);\n  const value = useMemo(() => ({ errors, setErrors }), [errors, setErrors]);\n  return (\n    <Context value={value}>{children}</Context>\n  );\n}\n\nexport const useErrorContext = () => {\n  const value = useContext(Context);\n  if (value) return value;\n  const storage = useRendererStorage();\n  const found = storage.get(defaultStorageKey);\n  if (found) return found as ContextValue;\n  const store: ContextValue = {\n    errors: [],\n    setErrors: (values: SetStateAction<Errors>) => {\n      store.errors = _.isFunction(values) ? values(store.errors) : values;\n    },\n  };\n  storage.set(defaultStorageKey, store);\n  return store;\n};\n\n/**\n * A hook to access the list of asynchronous resource errors.\n * \n * This hook allows components to retrieve the current list of errors being tracked\n * in the `ResourceErrors` context. It must be used within a component that is\n * a descendant of the `ResourceErrors` provider.\n * \n * ### Usage:\n * ```tsx\n * import { useEffect, useResourceErrors } from 'frosty';\n * \n * const errors = useResourceErrors();\n * \n * useEffect(() => {\n *   errors.forEach(({ token, error, refresh }) => {\n *     console.error(`Error [${token}]:`, error);\n *     // Optionally call refresh() to retry the operation\n *   });\n * }, [errors]);\n * ```\n * \n * @returns The list of errors currently being tracked in the context. Each error includes:\n * - `token`: A unique identifier for the error.\n * - `error`: The error object or message.\n * - `refresh`: A function to retry the operation that caused the error.\n */\nexport const useResourceErrors = () => useErrorContext().errors;\n","//\n//  sync.ts\n//\n//  The MIT License\n//  Copyright (c) 2021 - 2025 O2ter Limited. All rights reserved.\n//\n//  Permission is hereby granted, free of charge, to any person obtaining a copy\n//  of this software and associated documentation files (the \"Software\"), to deal\n//  in the Software without restriction, including without limitation the rights\n//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n//  copies of the Software, and to permit persons to whom the Software is\n//  furnished to do so, subject to the following conditions:\n//\n//  The above copyright notice and this permission notice shall be included in\n//  all copies or substantial portions of the Software.\n//\n//  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n//  THE SOFTWARE.\n//\n\nimport _ from 'lodash';\nimport { Awaitable } from '@o2ter/utils-js';\nimport { _useEffect } from '../reconciler/hooks';\nimport { reconciler } from '../reconciler/state';\n\n/**\n * A hook utility for synchronizing with an external store.\n *\n * @template Snapshot - The type of the snapshot returned by the store.\n * @param subscribe - A function that sets up a subscription to the external store.\n *   - `onStoreChange`: A callback to invoke when the store changes.\n *   - `signal`: An `AbortSignal` to handle cleanup when the subscription is no longer needed.\n *   - Returns an optional cleanup function or a promise resolving to one.\n * @param getSnapshot - A function that retrieves the current snapshot of the store.\n * @param getServerSnapshot - (Optional) A function that retrieves the snapshot of the store\n *   in a server environment.\n * @returns The current snapshot of the store.\n *\n * @throws Will throw an error if used outside of a valid render context.\n */\nexport const useSyncExternalStore = <Snapshot>(\n  subscribe: (\n    onStoreChange: () => void,\n    signal: AbortSignal,\n  ) => Awaitable<void | (() => Awaitable<void>)>,\n  getSnapshot: () => Snapshot,\n  getServerSnapshot?: () => Snapshot,\n) => {\n  const state = reconciler.currentHookState;\n  if (!state) throw Error('useSyncExternalStore must be used within a render function.');\n  _useEffect('useSyncExternalStore', ({ node }) => {\n    const abort = new AbortController();\n    try {\n      const destructor = subscribe(() => { node?._setDirty(); }, abort.signal);\n      return () => {\n        abort.abort();\n        (async () => {\n          try {\n            const _destructor = await destructor;\n            if (_.isFunction(_destructor)) _destructor();\n          } catch (e) {\n            console.error(e);\n          }\n        })();\n      };\n    } catch (e) {\n      console.error(e);\n      return () => abort.abort();\n    }\n  }, null);\n  if (getServerSnapshot && state.renderer._server) {\n    return getServerSnapshot();\n  }\n  return getSnapshot();\n};"],"names":["_jsx"],"mappings":"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"}

package/dist/server-dom.d.mts

@@ -1,11 +1,11 @@
 import { JSDOM } from 'jsdom';
 export * from 'jsdom';
-import { _ as _DOMRenderer } from './internals/renderer-CJV68U2U.mjs';
+import { _ as _DOMRenderer } from './internals/renderer-DRuOiuKj.mjs';
 import './internals/common-CpEB3ieX.mjs';
 import '@o2ter/utils-js';
 import 'lodash';
 import 'csstype';
-import './internals/renderer-JDjL_fNZ.mjs';
+import './internals/renderer-D5Ti33Dm.mjs';
 
 declare class ServerDOMRenderer extends _DOMRenderer {
     constructor(dom?: JSDOM);

package/dist/server-dom.d.ts

@@ -1,11 +1,11 @@
 import { JSDOM } from 'jsdom';
 export * from 'jsdom';
-import { _ as _DOMRenderer } from './internals/renderer-Bnsr3mNZ.js';
+import { _ as _DOMRenderer } from './internals/renderer-BGklQuhL.js';
 import './internals/common-CpEB3ieX.js';
 import '@o2ter/utils-js';
 import 'lodash';
 import 'csstype';
-import './internals/renderer-CtvkpyUB.js';
+import './internals/renderer-_DLTEPZN.js';
 
 declare class ServerDOMRenderer extends _DOMRenderer {
     constructor(dom?: JSDOM);

package/dist/server-dom.js

@@ -1,10 +1,10 @@
 'use strict';
 
 var jsdom = require('jsdom');
-var renderer = require('./internals/renderer-DINmR7Fc.js');
+var renderer = require('./internals/renderer-Bm-PTZwX.js');
 require('lodash');
 require('myers.js');
-require('./internals/renderer-Dv-IAwBn.js');
+require('./internals/renderer-BCXo_tVK.js');
 require('./internals/state-C9_fGuhZ.js');
 require('./internals/runtime-57ivQprw.js');
 require('nextick');

package/dist/server-dom.mjs

@@ -1,10 +1,10 @@
 import { JSDOM } from 'jsdom';
 export * from 'jsdom';
-import { _ as _DOMRenderer } from './internals/renderer-B2hPQcF0.mjs';
+import { _ as _DOMRenderer } from './internals/renderer-Be-LIw4p.mjs';
 import 'lodash';
 import 'myers.js';
-import './internals/renderer-DNuaMgXi.mjs';
-import './internals/state-DgSrjGGU.mjs';
+import './internals/renderer-oGiv2WIb.mjs';
+import './internals/state-k40d_k34.mjs';
 import './internals/runtime-Dp4_akLf.mjs';
 import 'nextick';
 import 'postcss';

package/dist/web.d.mts

@@ -1,10 +1,10 @@
 import { S as SetStateAction, R as RefObject } from './internals/common-CpEB3ieX.mjs';
 import * as jsdom from 'jsdom';
-export { D as DOMNativeNode, _ as _DOMRenderer } from './internals/renderer-CJV68U2U.mjs';
+export { D as DOMNativeNode, _ as _DOMRenderer } from './internals/renderer-DRuOiuKj.mjs';
 import '@o2ter/utils-js';
 import 'lodash';
 import 'csstype';
-import './internals/renderer-JDjL_fNZ.mjs';
+import './internals/renderer-D5Ti33Dm.mjs';
 
 /**
  * Hook to access the current document object in a web renderer.

package/dist/web.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"web.d.mts","sources":["../src/web/document.ts","../src/web/location.ts","../src/web/observer.ts","../src/web/online.ts","../src/web/server.ts","../src/web/storage.ts","../src/web/visibility.ts","../src/web/window.ts"],"sourcesContent":["//\n//  document.ts\n//\n//  The MIT License\n//  Copyright (c) 2021 - 2025 O2ter Limited. All rights reserved.\n//\n//  Permission is hereby granted, free of charge, to any person obtaining a copy\n//  of this software and associated documentation files (the \"Software\"), to deal\n//  in the Software without restriction, including without limitation the rights\n//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n//  copies of the Software, and to permit persons to whom the Software is\n//  furnished to do so, subject to the following conditions:\n//\n//  The above copyright notice and this permission notice shall be included in\n//  all copies or substantial portions of the Software.\n//\n//  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n//  THE SOFTWARE.\n//\n\nimport _ from 'lodash';\nimport { reconciler } from '../core/reconciler/state';\nimport { _DOMRenderer } from '../renderer/common';\n\n/**\n * Hook to access the current document object in a web renderer.\n * \n * @returns The current document object.\n * @throws Error if used outside of a render function or with an unsupported renderer.\n */\nexport const useDocument = () => {\n  const state = reconciler.currentHookState;\n  if (!state) throw Error('useDocument must be used within a render function.');\n  if (state.renderer instanceof _DOMRenderer) {\n    return state.renderer.document;\n  } else {\n    throw Error('Unsupported renderer.');\n  }\n}","//\n//  location.ts\n//\n//  The MIT License\n//  Copyright (c) 2021 - 2025 O2ter Limited. All rights reserved.\n//\n//  Permission is hereby granted, free of charge, to any person obtaining a copy\n//  of this software and associated documentation files (the \"Software\"), to deal\n//  in the Software without restriction, including without limitation the rights\n//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n//  copies of the Software, and to permit persons to whom the Software is\n//  furnished to do so, subject to the following conditions:\n//\n//  The above copyright notice and this permission notice shall be included in\n//  all copies or substantial portions of the Software.\n//\n//  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n//  THE SOFTWARE.\n//\n\nimport _ from 'lodash';\nimport { useMemo } from '../core/hooks/memo';\nimport { useCallback } from '../core/hooks/callback';\nimport { useSyncExternalStore } from '../core/hooks/sync';\nimport { EventEmitter } from '../core/reconciler/events';\nimport { SetStateAction } from '../core/types/common';\nimport { useWindow } from './window';\n\nconst emitters = new WeakMap<Document, EventEmitter>();\nconst emitterFor = (document: Document) => {\n  if (!emitters.has(document)) emitters.set(document, new EventEmitter());\n  return emitters.get(document)!;\n}\n\n/**\n * A hook that provides the current browser location and methods to manipulate the browser history.\n *\n * @returns An object with the following properties and methods:\n * - `hash`: The fragment identifier of the URL.\n * - `host`: The hostname and port number.\n * - `hostname`: The domain name.\n * - `href`: The full URL.\n * - `origin`: The protocol, hostname, and port.\n * - `pathname`: The path of the URL.\n * - `port`: The port number.\n * - `protocol`: The protocol scheme.\n * - `search`: The query string.\n * - `state`: The current state object associated with the history entry.\n * - `back()`: Navigates to the previous entry in the history stack.\n * - `forward()`: Navigates to the next entry in the history stack.\n * - `pushState(data, url)`: Pushes a new entry onto the history stack.\n * - `replaceState(data, url)`: Replaces the current history entry.\n *\n * The hook subscribes to changes in the browser's history and location, causing components to re-render when navigation occurs.\n *\n * @example\n * const location = useLocation();\n * console.log(location.pathname); // e.g., \"/about\"\n * location.pushState({ some: 'state' }, '/new-path');\n */\nexport const useLocation = () => {\n  const window = useWindow();\n  const emitter = emitterFor(window.document);\n  const result = (history?: History) => ({\n    ..._.pick(window.document.location, 'hash', 'host', 'hostname', 'href', 'origin', 'pathname', 'port', 'protocol', 'search'),\n    state: history?.state ?? null,\n    back: () => {\n      history?.back();\n    },\n    forward: () => {\n      history?.forward();\n      emitter.emit('change');\n    },\n    pushState: (data: any, url?: string | URL | null) => {\n      history?.pushState(data, '', url);\n      emitter.emit('change');\n    },\n    replaceState: (data: any, url?: string | URL | null) => {\n      history?.replaceState(data, '', url);\n      emitter.emit('change');\n    },\n  });\n  return useSyncExternalStore((onStoreChange) => {\n    window.addEventListener('popstate', onStoreChange);\n    const event = emitter.register('change', onStoreChange);\n    return () => {\n      window.removeEventListener('popstate', onStoreChange);\n      event.remove();\n    }\n  }, () => result(window.history));\n}\n\n/**\n * A hook for reading and updating the URL's query string (search parameters).\n *\n * @returns A tuple:\n *   - The first element is a `URLSearchParams` instance representing the current query string.\n *   - The second element is a function to update the search parameters, which accepts any valid\n *     `URLSearchParams` initializer (string, array, or object).\n *\n * Updating the search parameters will push a new history entry and update the URL in the address bar.\n *\n * @example\n * const [searchParams, setSearchParams] = useSearchParams();\n * const page = searchParams.get('page');\n * setSearchParams({ page: '2', filter: 'active' });\n */\nexport const useSearchParams = () => {\n  const location = useLocation();\n  const searchParams = useMemo(() => new URLSearchParams(location.search), [location.search]);\n  type URLSearchParamsInit = ConstructorParameters<typeof URLSearchParams>[0];\n  const setSearchParams = useCallback((\n    dispatch: SetStateAction<URLSearchParamsInit, URLSearchParams>,\n    config?: {\n      replace?: boolean;\n    },\n  ) => {\n    const params = _.isFunction(dispatch) ? dispatch(new URLSearchParams(location.search)) : dispatch;\n    const newParams = new URLSearchParams(params);\n    if (config?.replace === false) {\n      location.pushState(location.state, `?${newParams.toString()}`);\n    } else {\n      location.replaceState(location.state, `?${newParams.toString()}`);\n    }\n  });\n  return [searchParams, setSearchParams] as const;\n}\n","//\n//  observer.ts\n//\n//  The MIT License\n//  Copyright (c) 2021 - 2025 O2ter Limited. All rights reserved.\n//\n//  Permission is hereby granted, free of charge, to any person obtaining a copy\n//  of this software and associated documentation files (the \"Software\"), to deal\n//  in the Software without restriction, including without limitation the rights\n//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n//  copies of the Software, and to permit persons to whom the Software is\n//  furnished to do so, subject to the following conditions:\n//\n//  The above copyright notice and this permission notice shall be included in\n//  all copies or substantial portions of the Software.\n//\n//  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n//  THE SOFTWARE.\n//\n\nimport _ from 'lodash';\nimport { useEffect } from '../core/hooks/effect';\nimport { useCallback } from '../core/hooks/callback';\nimport { RefObject } from '../core/types/common';\n\ninterface _Observer<T> {\n  observe(target: Element, options?: T): void;\n  unobserve(target: Element): void;\n}\n\nconst createObserver = <E extends { target: Element; }, T>(\n  constructor: new (callback: (entries: E[]) => void) => _Observer<T>\n) => {\n  const listeners = new WeakMap<Element, ((entry: E) => void)[]>();\n  const observer = new constructor((entries) => {\n    for (const entry of entries) {\n      for (const listener of listeners.get(entry.target) ?? []) {\n        (async () => {\n          try {\n            await listener(entry);\n          } catch (e) {\n            console.error(e);\n          }\n        })();\n      }\n    }\n  });\n  return {\n    observe: (target: Element, callback: (entry: E) => void, options?: T) => {\n      observer.observe(target, options);\n      listeners.set(target, [...listeners.get(target) ?? [], callback]);\n    },\n    unobserve: (target: Element, callback: (entry: E) => void) => {\n      const list = _.filter(listeners.get(target), x => x !== callback);\n      listeners.set(target, list);\n      if (_.isEmpty(list)) observer.unobserve?.(target);\n    },\n  };\n};\n\nconst observer = typeof window === 'undefined' ? undefined : {\n  resize: createObserver(ResizeObserver),\n  intersection: createObserver(IntersectionObserver),\n};\n\n/**\n * A hook that sets up a ResizeObserver on the given target element.\n * \n * @param target - The target element or a ref object containing the target element.\n * @param callback - The callback function to be called when the target element is resized.\n * @param options - Optional ResizeObserverOptions to configure the observer.\n */\nexport const useResizeObserver = (\n  target: RefObject<Element | null | undefined> | Element | null | undefined,\n  callback: (entry: ResizeObserverEntry) => void,\n  options?: ResizeObserverOptions,\n) => {\n  const _callback = useCallback(callback);\n  useEffect(() => {\n    const _target = target && 'current' in target ? target.current : target;\n    if (!observer || !_target) return;\n    observer.resize.observe(_target, _callback, options);\n    return () => observer.resize.unobserve(_target, _callback);\n  }, [target]);\n}\n\n/**\n * A hook that sets up an IntersectionObserver on the given target element.\n * \n * @param target - The target element or a ref object containing the target element.\n * @param callback - The callback function to be called when the target element's intersection changes.\n */\nexport const useIntersectionObserver = (\n  target: RefObject<Element | null | undefined> | Element | null | undefined,\n  callback: (entry: IntersectionObserverEntry) => void,\n) => {\n  const _callback = useCallback(callback);\n  useEffect(() => {\n    const _target = target && 'current' in target ? target.current : target;\n    if (!observer || !_target) return;\n    observer.intersection.observe(_target, _callback);\n    return () => observer.intersection.unobserve(_target, _callback);\n  }, [target]);\n}\n\n/**\n * A hook that sets up a MutationObserver on the given target node.\n * \n * @param target - The target node or a ref object containing the target node.\n * @param callback - The callback function to be called when mutations are observed.\n * @param options - Optional MutationObserverInit to configure the observer.\n */\nexport const useMutationObserver = (\n  target: RefObject<Node | null | undefined> | Node | null | undefined,\n  callback: MutationCallback,\n  options?: MutationObserverInit,\n) => {\n  const _callback = useCallback(callback);\n  useEffect(() => {\n    const _target = target && 'current' in target ? target.current : target;\n    if (typeof window === 'undefined' || !_target) return;\n    const observer = new MutationObserver(_callback);\n    observer.observe(_target, options);\n    return () => observer.disconnect();\n  }, [target]);\n}\n\n/**\n * A hook that sets up a PerformanceObserver with the given callback and options.\n * \n * @param callback - The callback function to be called when performance entries are observed.\n * @param options - Optional PerformanceObserverInit to configure the observer.\n */\nexport const usePerformanceObserver = (\n  callback: PerformanceObserverCallback,\n  options?: PerformanceObserverInit,\n) => {\n  const _callback = useCallback(callback);\n  useEffect(() => {\n    if (typeof window === 'undefined') return;\n    const observer = new PerformanceObserver(_callback);\n    observer.observe(options);\n    return () => observer.disconnect();\n  }, []);\n}\n","//\n//  online.ts\n//\n//  The MIT License\n//  Copyright (c) 2021 - 2025 O2ter Limited. All rights reserved.\n//\n//  Permission is hereby granted, free of charge, to any person obtaining a copy\n//  of this software and associated documentation files (the \"Software\"), to deal\n//  in the Software without restriction, including without limitation the rights\n//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n//  copies of the Software, and to permit persons to whom the Software is\n//  furnished to do so, subject to the following conditions:\n//\n//  The above copyright notice and this permission notice shall be included in\n//  all copies or substantial portions of the Software.\n//\n//  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n//  THE SOFTWARE.\n//\n\nimport _ from 'lodash';\nimport { useSyncExternalStore } from '../core/hooks/sync';\n\n/**\n * A hook that returns the current online status of the browser.\n * It listens to the 'online' and 'offline' events to update the status.\n * \n * @returns A boolean indicating whether the browser is online.\n */\nexport const useOnline = () => useSyncExternalStore((onStoreChange) => {\n  window.addEventListener('offline', onStoreChange);\n  window.addEventListener('online', onStoreChange);\n  return () => {\n    window.removeEventListener('offline', onStoreChange);\n    window.removeEventListener('online', onStoreChange);\n  };\n}, () => navigator.onLine, () => false);","//\n//  server.ts\n//\n//  The MIT License\n//  Copyright (c) 2021 - 2025 O2ter Limited. All rights reserved.\n//\n//  Permission is hereby granted, free of charge, to any person obtaining a copy\n//  of this software and associated documentation files (the \"Software\"), to deal\n//  in the Software without restriction, including without limitation the rights\n//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n//  copies of the Software, and to permit persons to whom the Software is\n//  furnished to do so, subject to the following conditions:\n//\n//  The above copyright notice and this permission notice shall be included in\n//  all copies or substantial portions of the Software.\n//\n//  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n//  THE SOFTWARE.\n//\n\nimport _ from 'lodash';\nimport { reconciler } from '../core/reconciler/state';\nimport { _DOMRenderer } from '../renderer/common';\nimport { decompress } from '../renderer/minify/decompress';\n\nconst decodedSsrData = new WeakMap<Document, any>();\n\n/**\n * A hook to manage server-side resources in a web renderer.\n * It allows tracking and retrieving resources identified by a key.\n * \n * @param key - The unique key for the resource.\n * @param resource - An optional function that returns the resource string when called on the server side.\n * @returns The resource string if available, otherwise undefined.\n * @throws Error if used outside of a render function or with an unsupported renderer.\n */\nexport const useServerResource = (key: string, resource?: () => string): string | undefined => {\n  const state = reconciler.currentHookState;\n  if (!state) throw Error('useServerResource must be used within a render function.');\n  if (state.renderer instanceof _DOMRenderer) {\n    if (state.renderer._server) {\n      const data = resource?.();\n      if (!_.isString(data)) throw Error('Invalid return type of resource');\n      state.renderer._tracked_server_resource.set(key, data);\n      return data;\n    } else {\n      const cached = decodedSsrData.get(state.renderer.document);\n      if (!_.isNil(cached)) return cached[key];\n      const ssrData = state.renderer.document.querySelector('script[data-frosty-ssr-data]');\n      if (ssrData instanceof HTMLElement) {\n        try {\n          const decoded = JSON.parse(decompress(ssrData.innerText.trim()));\n          decodedSsrData.set(state.renderer.document, decoded);\n          return decoded[key];\n        } catch (e) {\n          console.error(e);\n          decodedSsrData.set(state.renderer.document, {});\n        }\n        ssrData.remove();\n      } else {\n        decodedSsrData.set(state.renderer.document, {});\n      }\n    }\n  } else {\n    throw Error('Unsupported renderer.');\n  }\n}\n","//\n//  storage.ts\n//\n//  The MIT License\n//  Copyright (c) 2021 - 2025 O2ter Limited. All rights reserved.\n//\n//  Permission is hereby granted, free of charge, to any person obtaining a copy\n//  of this software and associated documentation files (the \"Software\"), to deal\n//  in the Software without restriction, including without limitation the rights\n//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n//  copies of the Software, and to permit persons to whom the Software is\n//  furnished to do so, subject to the following conditions:\n//\n//  The above copyright notice and this permission notice shall be included in\n//  all copies or substantial portions of the Software.\n//\n//  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n//  THE SOFTWARE.\n//\n\nimport _ from 'lodash';\nimport { useSyncExternalStore } from '../core/hooks/sync';\nimport { useCallback } from '../core/hooks/callback';\nimport { SetStateAction } from '../core/types/common';\nimport { EventEmitter } from '../core/reconciler/events';\n\nconst emitters = new WeakMap<Storage, EventEmitter>();\nconst emitterFor = (storage: Storage) => {\n  if (!emitters.has(storage)) emitters.set(storage, new EventEmitter());\n  return emitters.get(storage)!;\n}\n\nconst _useStorage = (\n  storage: () => Storage,\n  key: string,\n  initialValue?: string | null\n) => {\n  const state = useSyncExternalStore((onStoreChange) => {\n    const _storage = storage();\n    const emitter = emitterFor(_storage);\n    const callback = (ev: StorageEvent) => { \n      if (!ev.storageArea || ev.storageArea === _storage) onStoreChange();\n    };\n    window.addEventListener('storage', callback);\n    const event = emitter.register('change', onStoreChange);\n    return () => {\n      window.removeEventListener('storage', callback);\n      event.remove();\n    }\n  }, () => storage().getItem(key), () => undefined);\n  const setState = useCallback((v: SetStateAction<string | null | undefined>) => {\n    try {\n      const _storage = storage();\n      const newValue = _.isFunction(v) ? v(state) : v;\n      if (_.isNil(newValue)) {\n        _storage.removeItem(key);\n      } else {\n        _storage.setItem(key, newValue);\n      }\n      const emitter = emitterFor(_storage);\n      emitter.emit('change');\n    } catch (e) {\n      console.error(e);\n    }\n  }, [key]);\n  return [state ?? initialValue ?? null, setState] as const;\n}\n\n/**\n * A hook to manage a value in localStorage.\n * It provides a stateful value and a function to update it.\n * \n * @param key - The key in localStorage to manage.\n * @param initialValue - An optional initial value if the key does not exist in localStorage.\n * @returns A tuple containing the current value and a function to update it.\n */\nexport const useLocalStorage = (\n  key: string,\n  initialValue?: string | null\n) => _useStorage(() => window.localStorage, key, initialValue);\n\n/** \n * A hook to manage a value in sessionStorage.\n * It provides a stateful value and a function to update it.\n * \n * @param key - The key in sessionStorage to manage.\n * @param initialValue - An optional initial value if the key does not exist in sessionStorage.\n * @returns A tuple containing the current value and a function to update it.\n */\nexport const useSessionStorage = (\n  key: string,\n  initialValue?: string | null\n) => _useStorage(() => window.sessionStorage, key, initialValue);\n","//\n//  visibility.ts\n//\n//  The MIT License\n//  Copyright (c) 2021 - 2025 O2ter Limited. All rights reserved.\n//\n//  Permission is hereby granted, free of charge, to any person obtaining a copy\n//  of this software and associated documentation files (the \"Software\"), to deal\n//  in the Software without restriction, including without limitation the rights\n//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n//  copies of the Software, and to permit persons to whom the Software is\n//  furnished to do so, subject to the following conditions:\n//\n//  The above copyright notice and this permission notice shall be included in\n//  all copies or substantial portions of the Software.\n//\n//  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n//  THE SOFTWARE.\n//\n\nimport _ from 'lodash';\nimport { useSyncExternalStore } from '../core/hooks/sync';\nimport { useDocument } from './document';\n\n/**\n * A hook to get the current visibility state of the document.\n * It listens to the 'visibilitychange' event to update the state.\n * \n * @returns A string indicating the current visibility state: 'active', 'inactive', 'background', or 'unknown'.\n */\nexport const useVisibility = () => {\n  const document = useDocument();\n  return useSyncExternalStore((onStoreChange) => {\n    document.addEventListener('visibilitychange', onStoreChange);\n    return () => {\n      document.removeEventListener('visibilitychange', onStoreChange);\n    }\n  }, () => {\n    if (document.hasFocus()) {\n      return 'active' as const;\n    } else if (document.visibilityState === 'visible') {\n      return 'inactive' as const;\n    } else {\n      return 'background' as const;\n    }\n  }, () => 'unknown' as const);\n}\n","//\n//  window.ts\n//\n//  The MIT License\n//  Copyright (c) 2021 - 2025 O2ter Limited. All rights reserved.\n//\n//  Permission is hereby granted, free of charge, to any person obtaining a copy\n//  of this software and associated documentation files (the \"Software\"), to deal\n//  in the Software without restriction, including without limitation the rights\n//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n//  copies of the Software, and to permit persons to whom the Software is\n//  furnished to do so, subject to the following conditions:\n//\n//  The above copyright notice and this permission notice shall be included in\n//  all copies or substantial portions of the Software.\n//\n//  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n//  THE SOFTWARE.\n//\n\nimport _ from 'lodash';\nimport { useSyncExternalStore } from '../core/hooks/sync';\nimport { uniqueId } from '../core/utils';\nimport { reconciler } from '../core/reconciler/state';\nimport { _DOMRenderer } from '../renderer/common';\n\n/**\n * Hook to access the current window object in a web renderer.\n * \n * @returns The current window object.\n * @throws Error if used outside of a render function or with an unsupported renderer.\n */\nexport const useWindow = () => {\n  const state = reconciler.currentHookState;\n  if (!state) throw Error('useWindow must be used within a render function.');\n  if (state.renderer instanceof _DOMRenderer) {\n    return state.renderer.window;\n  } else {\n    throw Error('Unsupported renderer.');\n  }\n}\n\nconst emptyInsets = { top: 0, left: 0, right: 0, bottom: 0 };\nconst safeAreaInsets = (window: ReturnType<typeof useWindow>) => {\n  let support;\n  if (!('CSS' in window) || !_.isFunction(window.CSS.supports)) {\n    return emptyInsets;\n  }\n  if (window.CSS.supports('top: env(safe-area-inset-top)')) {\n    support = 'env'\n  } else if (window.CSS.supports('top: constant(safe-area-inset-top)')) {\n    support = 'constant'\n  } else {\n    return emptyInsets;\n  }\n  const id = uniqueId();\n  const style = document.createElement('style');\n  style.textContent = `:root {\n    --${id}-top: ${support}(safe-area-inset-top);\n    --${id}-left: ${support}(safe-area-inset-left);\n    --${id}-right: ${support}(safe-area-inset-right);\n    --${id}-bottom: ${support}(safe-area-inset-bottom);\n  }`;\n  document.head.appendChild(style);\n  const computedStyle = getComputedStyle(document.documentElement);\n  const insets = {\n    top: computedStyle.getPropertyValue(`--${id}-top`),\n    left: computedStyle.getPropertyValue(`--${id}-left`),\n    right: computedStyle.getPropertyValue(`--${id}-right`),\n    bottom: computedStyle.getPropertyValue(`--${id}-bottom`),\n  };\n  style.remove();\n  return _.mapValues(insets, v => parseFloat(v));\n}\n\n/**\n * A hook that provides various metrics of the window object.\n * It listens to the 'resize' event to update the metrics.\n * \n * @returns An object containing safe area insets, device pixel ratio, outer and inner dimensions of the window.\n */\nexport const useWindowMetrics = () => {\n  const window = useWindow();\n  return useSyncExternalStore((onStoreChange) => {\n    window.addEventListener('resize', onStoreChange);\n    return () => {\n      window.removeEventListener('resize', onStoreChange);\n    };\n  }, () => ({\n    safeAreaInsets: safeAreaInsets(window),\n    devicePixelRatio: window.devicePixelRatio,\n    outerWidth: window.outerWidth,\n    outerHeight: window.outerHeight,\n    innerWidth: window.innerWidth,\n    innerHeight: window.innerHeight,\n  }));\n}\n\n/** \n * A hook that provides metrics of the visual viewport.\n * It listens to the 'resize' event of the visual viewport to update the metrics.\n * \n * @returns An object containing width, height, and scale of the visual viewport.\n */\nexport const useVisualViewportMetrics = () => {\n  const { visualViewport } = useWindow();\n  return useSyncExternalStore((onStoreChange) => {\n    visualViewport?.addEventListener('resize', onStoreChange);\n    return () => {\n      visualViewport?.removeEventListener('resize', onStoreChange);\n    };\n  }, () => visualViewport && ({\n    width: visualViewport.width,\n    height: visualViewport.height,\n    scale: visualViewport.scale,\n  }));\n}\n\n/**\n * A hook that provides the current scroll position of the window.\n * It listens to the 'scroll' event to update the position.\n * \n * @returns An object containing scrollX and scrollY values.\n */\nexport const useWindowScroll = () => {\n  const window = useWindow();\n  return useSyncExternalStore((onStoreChange) => {\n    window.addEventListener('scroll', onStoreChange);\n    return () => {\n      window.removeEventListener('scroll', onStoreChange);\n    };\n  }, () => ({\n    scrollX: window.scrollX,\n    scrollY: window.scrollY,\n  }));\n}\n\nconst colorSchemeDarkCache = new WeakMap<ReturnType<typeof useWindow>, MediaQueryList | undefined>();\n\n/**\n * A hook that detects the user's preferred color scheme (light or dark).\n * It listens to changes in the '(prefers-color-scheme: dark)' media query.\n * \n * @returns A string indicating the current color scheme: 'light' or 'dark'.\n */\nexport const useColorScheme = () => {\n  const window = useWindow();\n  if (!colorSchemeDarkCache.has(window)) colorSchemeDarkCache.set(window, window.matchMedia?.('(prefers-color-scheme: dark)'));\n  const colorSchemeDark = colorSchemeDarkCache.get(window);\n  return useSyncExternalStore((onStoreChange) => {\n    colorSchemeDark?.addEventListener('change', onStoreChange);\n    return () => {\n      colorSchemeDark?.removeEventListener('change', onStoreChange);\n    };\n  }, () => colorSchemeDark?.matches ? 'dark' : 'light');\n}\n"],"names":[],"mappings":";;;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,WAAA,QAAA,QAAA;;ACLP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,WAAA;AACP;AACA;AACA;AACA,0CAAA,GAAA;AACA,6CAAA,GAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,eAAA,kBAAA,eAAA,aAAA,cAAA,uBAAA,MAAA,mBAAA,eAAA,cAAA,eAAA;AACP;AACA;;AC3DA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,iBAAA,WAAA,SAAA,CAAA,OAAA,uBAAA,OAAA,uCAAA,mBAAA,qBAAA,qBAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,uBAAA,WAAA,SAAA,CAAA,OAAA,uBAAA,OAAA,uCAAA,yBAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,mBAAA,WAAA,SAAA,CAAA,IAAA,uBAAA,IAAA,+BAAA,gBAAA,YAAA,oBAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,sBAAA,aAAA,2BAAA,YAAA,uBAAA;;AC9BP;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,SAAA;;ACNP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,iBAAA;;ACRP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,eAAA,8EAAA,cAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,iBAAA,8EAAA,cAAA;;AClBP;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,aAAA;;ACNP;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,SAAA,QAAA,MAAA,GAAwC,KAAe,CAAA,SAAA;AAC9D;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,gBAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,wBAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,eAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,cAAA;;;;"}
+{"version":3,"file":"web.d.mts","sources":["../src/web/document.ts","../src/web/location.ts","../src/web/observer.ts","../src/web/online.ts","../src/web/server.ts","../src/web/storage.ts","../src/web/visibility.ts","../src/web/window.ts"],"sourcesContent":["//\n//  document.ts\n//\n//  The MIT License\n//  Copyright (c) 2021 - 2025 O2ter Limited. All rights reserved.\n//\n//  Permission is hereby granted, free of charge, to any person obtaining a copy\n//  of this software and associated documentation files (the \"Software\"), to deal\n//  in the Software without restriction, including without limitation the rights\n//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n//  copies of the Software, and to permit persons to whom the Software is\n//  furnished to do so, subject to the following conditions:\n//\n//  The above copyright notice and this permission notice shall be included in\n//  all copies or substantial portions of the Software.\n//\n//  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n//  THE SOFTWARE.\n//\n\nimport _ from 'lodash';\nimport { reconciler } from '../core/reconciler/state';\nimport { _DOMRenderer } from '../renderer/common';\n\n/**\n * Hook to access the current document object in a web renderer.\n * \n * @returns The current document object.\n * @throws Error if used outside of a render function or with an unsupported renderer.\n */\nexport const useDocument = () => {\n  const state = reconciler.currentHookState;\n  if (!state) throw Error('useDocument must be used within a render function.');\n  if (state.renderer instanceof _DOMRenderer) {\n    return state.renderer.document;\n  } else {\n    throw Error('Unsupported renderer.');\n  }\n}","//\n//  location.ts\n//\n//  The MIT License\n//  Copyright (c) 2021 - 2025 O2ter Limited. All rights reserved.\n//\n//  Permission is hereby granted, free of charge, to any person obtaining a copy\n//  of this software and associated documentation files (the \"Software\"), to deal\n//  in the Software without restriction, including without limitation the rights\n//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n//  copies of the Software, and to permit persons to whom the Software is\n//  furnished to do so, subject to the following conditions:\n//\n//  The above copyright notice and this permission notice shall be included in\n//  all copies or substantial portions of the Software.\n//\n//  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n//  THE SOFTWARE.\n//\n\nimport _ from 'lodash';\nimport { useMemo } from '../core/hooks/memo';\nimport { useCallback } from '../core/hooks/callback';\nimport { useSyncExternalStore } from '../core/hooks/sync';\nimport { EventEmitter } from '../core/reconciler/events';\nimport { SetStateAction } from '../core/types/common';\nimport { useWindow } from './window';\n\nconst emitters = new WeakMap<Document, EventEmitter>();\nconst emitterFor = (document: Document) => {\n  if (!emitters.has(document)) emitters.set(document, new EventEmitter());\n  return emitters.get(document)!;\n}\n\n/**\n * A hook that provides the current browser location and methods to manipulate the browser history.\n *\n * @returns An object with the following properties and methods:\n * - `hash`: The fragment identifier of the URL.\n * - `host`: The hostname and port number.\n * - `hostname`: The domain name.\n * - `href`: The full URL.\n * - `origin`: The protocol, hostname, and port.\n * - `pathname`: The path of the URL.\n * - `port`: The port number.\n * - `protocol`: The protocol scheme.\n * - `search`: The query string.\n * - `state`: The current state object associated with the history entry.\n * - `back()`: Navigates to the previous entry in the history stack.\n * - `forward()`: Navigates to the next entry in the history stack.\n * - `pushState(data, url)`: Pushes a new entry onto the history stack.\n * - `replaceState(data, url)`: Replaces the current history entry.\n *\n * The hook subscribes to changes in the browser's history and location, causing components to re-render when navigation occurs.\n *\n * @example\n * const location = useLocation();\n * console.log(location.pathname); // e.g., \"/about\"\n * location.pushState({ some: 'state' }, '/new-path');\n */\nexport const useLocation = () => {\n  const window = useWindow();\n  const emitter = emitterFor(window.document);\n  const result = (history?: History) => ({\n    ..._.pick(window.document.location, 'hash', 'host', 'hostname', 'href', 'origin', 'pathname', 'port', 'protocol', 'search'),\n    state: history?.state ?? null,\n    back: () => {\n      history?.back();\n    },\n    forward: () => {\n      history?.forward();\n      emitter.emit('change');\n    },\n    pushState: (data: any, url?: string | URL | null) => {\n      history?.pushState(data, '', url);\n      emitter.emit('change');\n    },\n    replaceState: (data: any, url?: string | URL | null) => {\n      history?.replaceState(data, '', url);\n      emitter.emit('change');\n    },\n  });\n  return useSyncExternalStore((onStoreChange) => {\n    window.addEventListener('popstate', onStoreChange);\n    const event = emitter.register('change', onStoreChange);\n    return () => {\n      window.removeEventListener('popstate', onStoreChange);\n      event.remove();\n    }\n  }, () => result(window.history));\n}\n\n/**\n * A hook for reading and updating the URL's query string (search parameters).\n *\n * @returns A tuple:\n *   - The first element is a `URLSearchParams` instance representing the current query string.\n *   - The second element is a function to update the search parameters, which accepts any valid\n *     `URLSearchParams` initializer (string, array, or object).\n *\n * Updating the search parameters will push a new history entry and update the URL in the address bar.\n *\n * @example\n * const [searchParams, setSearchParams] = useSearchParams();\n * const page = searchParams.get('page');\n * setSearchParams({ page: '2', filter: 'active' });\n */\nexport const useSearchParams = () => {\n  const location = useLocation();\n  const searchParams = useMemo(() => new URLSearchParams(location.search), [location.search]);\n  type URLSearchParamsInit = ConstructorParameters<typeof URLSearchParams>[0];\n  const setSearchParams = useCallback((\n    dispatch: SetStateAction<URLSearchParamsInit, URLSearchParams>,\n    config?: {\n      replace?: boolean;\n    },\n  ) => {\n    const params = _.isFunction(dispatch) ? dispatch(new URLSearchParams(location.search)) : dispatch;\n    const newParams = new URLSearchParams(params);\n    if (config?.replace === false) {\n      location.pushState(location.state, `?${newParams.toString()}`);\n    } else {\n      location.replaceState(location.state, `?${newParams.toString()}`);\n    }\n  });\n  return [searchParams, setSearchParams] as const;\n}\n","//\n//  observer.ts\n//\n//  The MIT License\n//  Copyright (c) 2021 - 2025 O2ter Limited. All rights reserved.\n//\n//  Permission is hereby granted, free of charge, to any person obtaining a copy\n//  of this software and associated documentation files (the \"Software\"), to deal\n//  in the Software without restriction, including without limitation the rights\n//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n//  copies of the Software, and to permit persons to whom the Software is\n//  furnished to do so, subject to the following conditions:\n//\n//  The above copyright notice and this permission notice shall be included in\n//  all copies or substantial portions of the Software.\n//\n//  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n//  THE SOFTWARE.\n//\n\nimport _ from 'lodash';\nimport { useEffect } from '../core/hooks/effect';\nimport { useCallback } from '../core/hooks/callback';\nimport { RefObject } from '../core/types/common';\n\ninterface _Observer<T> {\n  observe(target: Element, options?: T): void;\n  unobserve(target: Element): void;\n}\n\nconst createObserver = <E extends { target: Element; }, T>(\n  constructor: new (callback: (entries: E[]) => void) => _Observer<T>\n) => {\n  const listeners = new WeakMap<Element, ((entry: E) => void)[]>();\n  const observer = new constructor((entries) => {\n    for (const entry of entries) {\n      for (const listener of listeners.get(entry.target) ?? []) {\n        (async () => {\n          try {\n            await listener(entry);\n          } catch (e) {\n            console.error(e);\n          }\n        })();\n      }\n    }\n  });\n  return {\n    observe: (target: Element, callback: (entry: E) => void, options?: T) => {\n      observer.observe(target, options);\n      listeners.set(target, [...listeners.get(target) ?? [], callback]);\n    },\n    unobserve: (target: Element, callback: (entry: E) => void) => {\n      const list = _.filter(listeners.get(target), x => x !== callback);\n      listeners.set(target, list);\n      if (_.isEmpty(list)) observer.unobserve?.(target);\n    },\n  };\n};\n\nconst observer = typeof window === 'undefined' ? undefined : {\n  resize: createObserver(ResizeObserver),\n  intersection: createObserver(IntersectionObserver),\n};\n\n/**\n * A hook that sets up a ResizeObserver on the given target element.\n * \n * @param target - The target element or a ref object containing the target element.\n * @param callback - The callback function to be called when the target element is resized.\n * @param options - Optional ResizeObserverOptions to configure the observer.\n */\nexport const useResizeObserver = (\n  target: RefObject<Element | null | undefined> | Element | null | undefined,\n  callback: (entry: ResizeObserverEntry) => void,\n  options?: ResizeObserverOptions,\n) => {\n  const _callback = useCallback(callback);\n  useEffect(() => {\n    const _target = target && 'current' in target ? target.current : target;\n    if (!observer || !_target) return;\n    observer.resize.observe(_target, _callback, options);\n    return () => observer.resize.unobserve(_target, _callback);\n  }, [target]);\n}\n\n/**\n * A hook that sets up an IntersectionObserver on the given target element.\n * \n * @param target - The target element or a ref object containing the target element.\n * @param callback - The callback function to be called when the target element's intersection changes.\n */\nexport const useIntersectionObserver = (\n  target: RefObject<Element | null | undefined> | Element | null | undefined,\n  callback: (entry: IntersectionObserverEntry) => void,\n) => {\n  const _callback = useCallback(callback);\n  useEffect(() => {\n    const _target = target && 'current' in target ? target.current : target;\n    if (!observer || !_target) return;\n    observer.intersection.observe(_target, _callback);\n    return () => observer.intersection.unobserve(_target, _callback);\n  }, [target]);\n}\n\n/**\n * A hook that sets up a MutationObserver on the given target node.\n * \n * @param target - The target node or a ref object containing the target node.\n * @param callback - The callback function to be called when mutations are observed.\n * @param options - Optional MutationObserverInit to configure the observer.\n */\nexport const useMutationObserver = (\n  target: RefObject<Node | null | undefined> | Node | null | undefined,\n  callback: MutationCallback,\n  options?: MutationObserverInit,\n) => {\n  const _callback = useCallback(callback);\n  useEffect(() => {\n    const _target = target && 'current' in target ? target.current : target;\n    if (typeof window === 'undefined' || !_target) return;\n    const observer = new MutationObserver(_callback);\n    observer.observe(_target, options);\n    return () => observer.disconnect();\n  }, [target]);\n}\n\n/**\n * A hook that sets up a PerformanceObserver with the given callback and options.\n * \n * @param callback - The callback function to be called when performance entries are observed.\n * @param options - Optional PerformanceObserverInit to configure the observer.\n */\nexport const usePerformanceObserver = (\n  callback: PerformanceObserverCallback,\n  options?: PerformanceObserverInit,\n) => {\n  const _callback = useCallback(callback);\n  useEffect(() => {\n    if (typeof window === 'undefined') return;\n    const observer = new PerformanceObserver(_callback);\n    observer.observe(options);\n    return () => observer.disconnect();\n  }, []);\n}\n","//\n//  online.ts\n//\n//  The MIT License\n//  Copyright (c) 2021 - 2025 O2ter Limited. All rights reserved.\n//\n//  Permission is hereby granted, free of charge, to any person obtaining a copy\n//  of this software and associated documentation files (the \"Software\"), to deal\n//  in the Software without restriction, including without limitation the rights\n//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n//  copies of the Software, and to permit persons to whom the Software is\n//  furnished to do so, subject to the following conditions:\n//\n//  The above copyright notice and this permission notice shall be included in\n//  all copies or substantial portions of the Software.\n//\n//  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n//  THE SOFTWARE.\n//\n\nimport _ from 'lodash';\nimport { _useSharedSyncExternalStore } from './utils';\n\n/**\n * A hook that returns the current online status of the browser.\n * It listens to the 'online' and 'offline' events to update the status.\n * \n * @returns A boolean indicating whether the browser is online.\n */\nexport const useOnline = () => _useSharedSyncExternalStore(\n  'useOnline',\n  (onStoreChange) => {\n    window.addEventListener('offline', onStoreChange);\n    window.addEventListener('online', onStoreChange);\n    return () => {\n      window.removeEventListener('offline', onStoreChange);\n      window.removeEventListener('online', onStoreChange);\n    };\n  }, () => navigator.onLine, () => false\n);","//\n//  server.ts\n//\n//  The MIT License\n//  Copyright (c) 2021 - 2025 O2ter Limited. All rights reserved.\n//\n//  Permission is hereby granted, free of charge, to any person obtaining a copy\n//  of this software and associated documentation files (the \"Software\"), to deal\n//  in the Software without restriction, including without limitation the rights\n//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n//  copies of the Software, and to permit persons to whom the Software is\n//  furnished to do so, subject to the following conditions:\n//\n//  The above copyright notice and this permission notice shall be included in\n//  all copies or substantial portions of the Software.\n//\n//  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n//  THE SOFTWARE.\n//\n\nimport _ from 'lodash';\nimport { reconciler } from '../core/reconciler/state';\nimport { _DOMRenderer } from '../renderer/common';\nimport { decompress } from '../renderer/minify/decompress';\n\nconst decodedSsrData = new WeakMap<Document, any>();\n\n/**\n * A hook to manage server-side resources in a web renderer.\n * It allows tracking and retrieving resources identified by a key.\n * \n * @param key - The unique key for the resource.\n * @param resource - An optional function that returns the resource string when called on the server side.\n * @returns The resource string if available, otherwise undefined.\n * @throws Error if used outside of a render function or with an unsupported renderer.\n */\nexport const useServerResource = (key: string, resource?: () => string): string | undefined => {\n  const state = reconciler.currentHookState;\n  if (!state) throw Error('useServerResource must be used within a render function.');\n  if (state.renderer instanceof _DOMRenderer) {\n    if (state.renderer._server) {\n      const data = resource?.();\n      if (!_.isString(data)) throw Error('Invalid return type of resource');\n      state.renderer._tracked_server_resource.set(key, data);\n      return data;\n    } else {\n      const cached = decodedSsrData.get(state.renderer.document);\n      if (!_.isNil(cached)) return cached[key];\n      const ssrData = state.renderer.document.querySelector('script[data-frosty-ssr-data]');\n      if (ssrData instanceof HTMLElement) {\n        try {\n          const decoded = JSON.parse(decompress(ssrData.innerText.trim()));\n          decodedSsrData.set(state.renderer.document, decoded);\n          return decoded[key];\n        } catch (e) {\n          console.error(e);\n          decodedSsrData.set(state.renderer.document, {});\n        }\n        ssrData.remove();\n      } else {\n        decodedSsrData.set(state.renderer.document, {});\n      }\n    }\n  } else {\n    throw Error('Unsupported renderer.');\n  }\n}\n","//\n//  storage.ts\n//\n//  The MIT License\n//  Copyright (c) 2021 - 2025 O2ter Limited. All rights reserved.\n//\n//  Permission is hereby granted, free of charge, to any person obtaining a copy\n//  of this software and associated documentation files (the \"Software\"), to deal\n//  in the Software without restriction, including without limitation the rights\n//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n//  copies of the Software, and to permit persons to whom the Software is\n//  furnished to do so, subject to the following conditions:\n//\n//  The above copyright notice and this permission notice shall be included in\n//  all copies or substantial portions of the Software.\n//\n//  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n//  THE SOFTWARE.\n//\n\nimport _ from 'lodash';\nimport { useSyncExternalStore } from '../core/hooks/sync';\nimport { useCallback } from '../core/hooks/callback';\nimport { SetStateAction } from '../core/types/common';\nimport { EventEmitter } from '../core/reconciler/events';\n\nconst emitters = new WeakMap<Storage, EventEmitter>();\nconst emitterFor = (storage: Storage) => {\n  if (!emitters.has(storage)) emitters.set(storage, new EventEmitter());\n  return emitters.get(storage)!;\n}\n\nconst _useStorage = (\n  storage: () => Storage,\n  key: string,\n  initialValue?: string | null\n) => {\n  const state = useSyncExternalStore((onStoreChange) => {\n    const _storage = storage();\n    const emitter = emitterFor(_storage);\n    const callback = (ev: StorageEvent) => { \n      if (!ev.storageArea || ev.storageArea === _storage) onStoreChange();\n    };\n    window.addEventListener('storage', callback);\n    const event = emitter.register('change', onStoreChange);\n    return () => {\n      window.removeEventListener('storage', callback);\n      event.remove();\n    }\n  }, () => storage().getItem(key), () => undefined);\n  const setState = useCallback((v: SetStateAction<string | null | undefined>) => {\n    try {\n      const _storage = storage();\n      const newValue = _.isFunction(v) ? v(state) : v;\n      if (_.isNil(newValue)) {\n        _storage.removeItem(key);\n      } else {\n        _storage.setItem(key, newValue);\n      }\n      const emitter = emitterFor(_storage);\n      emitter.emit('change');\n    } catch (e) {\n      console.error(e);\n    }\n  }, [key]);\n  return [state ?? initialValue ?? null, setState] as const;\n}\n\n/**\n * A hook to manage a value in localStorage.\n * It provides a stateful value and a function to update it.\n * \n * @param key - The key in localStorage to manage.\n * @param initialValue - An optional initial value if the key does not exist in localStorage.\n * @returns A tuple containing the current value and a function to update it.\n */\nexport const useLocalStorage = (\n  key: string,\n  initialValue?: string | null\n) => _useStorage(() => window.localStorage, key, initialValue);\n\n/** \n * A hook to manage a value in sessionStorage.\n * It provides a stateful value and a function to update it.\n * \n * @param key - The key in sessionStorage to manage.\n * @param initialValue - An optional initial value if the key does not exist in sessionStorage.\n * @returns A tuple containing the current value and a function to update it.\n */\nexport const useSessionStorage = (\n  key: string,\n  initialValue?: string | null\n) => _useStorage(() => window.sessionStorage, key, initialValue);\n","//\n//  visibility.ts\n//\n//  The MIT License\n//  Copyright (c) 2021 - 2025 O2ter Limited. All rights reserved.\n//\n//  Permission is hereby granted, free of charge, to any person obtaining a copy\n//  of this software and associated documentation files (the \"Software\"), to deal\n//  in the Software without restriction, including without limitation the rights\n//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n//  copies of the Software, and to permit persons to whom the Software is\n//  furnished to do so, subject to the following conditions:\n//\n//  The above copyright notice and this permission notice shall be included in\n//  all copies or substantial portions of the Software.\n//\n//  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n//  THE SOFTWARE.\n//\n\nimport _ from 'lodash';\nimport { useDocument } from './document';\nimport { _useSharedSyncExternalStore } from './utils';\n\n/**\n * A hook to get the current visibility state of the document.\n * It listens to the 'visibilitychange' event to update the state.\n * \n * @returns A string indicating the current visibility state: 'active', 'inactive', 'background', or 'unknown'.\n */\nexport const useVisibility = () => {\n  const document = useDocument();\n  return _useSharedSyncExternalStore(\n    'useVisibility',\n    (onStoreChange) => {\n      document.addEventListener('visibilitychange', onStoreChange);\n      return () => {\n        document.removeEventListener('visibilitychange', onStoreChange);\n      }\n    },\n    () => {\n      if (document.hasFocus()) {\n        return 'active' as const;\n      } else if (document.visibilityState === 'visible') {\n        return 'inactive' as const;\n      } else {\n        return 'background' as const;\n      }\n    }, () => 'unknown' as const\n  );\n}\n","//\n//  window.ts\n//\n//  The MIT License\n//  Copyright (c) 2021 - 2025 O2ter Limited. All rights reserved.\n//\n//  Permission is hereby granted, free of charge, to any person obtaining a copy\n//  of this software and associated documentation files (the \"Software\"), to deal\n//  in the Software without restriction, including without limitation the rights\n//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n//  copies of the Software, and to permit persons to whom the Software is\n//  furnished to do so, subject to the following conditions:\n//\n//  The above copyright notice and this permission notice shall be included in\n//  all copies or substantial portions of the Software.\n//\n//  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n//  THE SOFTWARE.\n//\n\nimport _ from 'lodash';\nimport { uniqueId } from '../core/utils';\nimport { reconciler } from '../core/reconciler/state';\nimport { _DOMRenderer } from '../renderer/common';\nimport { _useSharedSyncExternalStore } from './utils';\n\n/**\n * Hook to access the current window object in a web renderer.\n * \n * @returns The current window object.\n * @throws Error if used outside of a render function or with an unsupported renderer.\n */\nexport const useWindow = () => {\n  const state = reconciler.currentHookState;\n  if (!state) throw Error('useWindow must be used within a render function.');\n  if (state.renderer instanceof _DOMRenderer) {\n    return state.renderer.window;\n  } else {\n    throw Error('Unsupported renderer.');\n  }\n}\n\nconst emptyInsets = { top: 0, left: 0, right: 0, bottom: 0 };\nconst safeAreaInsets = (window: ReturnType<typeof useWindow>) => {\n  let support;\n  if (!('CSS' in window) || !_.isFunction(window.CSS.supports)) {\n    return emptyInsets;\n  }\n  if (window.CSS.supports('top: env(safe-area-inset-top)')) {\n    support = 'env'\n  } else if (window.CSS.supports('top: constant(safe-area-inset-top)')) {\n    support = 'constant'\n  } else {\n    return emptyInsets;\n  }\n  const id = uniqueId();\n  const style = document.createElement('style');\n  style.textContent = `:root {\n    --${id}-top: ${support}(safe-area-inset-top);\n    --${id}-left: ${support}(safe-area-inset-left);\n    --${id}-right: ${support}(safe-area-inset-right);\n    --${id}-bottom: ${support}(safe-area-inset-bottom);\n  }`;\n  document.head.appendChild(style);\n  const computedStyle = getComputedStyle(document.documentElement);\n  const insets = {\n    top: computedStyle.getPropertyValue(`--${id}-top`),\n    left: computedStyle.getPropertyValue(`--${id}-left`),\n    right: computedStyle.getPropertyValue(`--${id}-right`),\n    bottom: computedStyle.getPropertyValue(`--${id}-bottom`),\n  };\n  style.remove();\n  return _.mapValues(insets, v => parseFloat(v));\n}\n\n/**\n * A hook that provides various metrics of the window object.\n * It listens to the 'resize' event to update the metrics.\n * \n * @returns An object containing safe area insets, device pixel ratio, outer and inner dimensions of the window.\n */\nexport const useWindowMetrics = () => {\n  const window = useWindow();\n  return _useSharedSyncExternalStore(\n    'useWindowMetrics',\n    (onStoreChange) => {\n      window.addEventListener('resize', onStoreChange);\n      return () => {\n        window.removeEventListener('resize', onStoreChange);\n      };\n    },\n    () => ({\n      safeAreaInsets: safeAreaInsets(window),\n      devicePixelRatio: window.devicePixelRatio,\n      outerWidth: window.outerWidth,\n      outerHeight: window.outerHeight,\n      innerWidth: window.innerWidth,\n      innerHeight: window.innerHeight,\n    })\n  );\n};\n\n/** \n * A hook that provides metrics of the visual viewport.\n * It listens to the 'resize' event of the visual viewport to update the metrics.\n * \n * @returns An object containing width, height, and scale of the visual viewport.\n */\nexport const useVisualViewportMetrics = () => {\n  const { visualViewport } = useWindow();\n  return _useSharedSyncExternalStore(\n    'useVisualViewportMetrics',\n    (onStoreChange) => {\n      visualViewport?.addEventListener('resize', onStoreChange);\n      return () => {\n        visualViewport?.removeEventListener('resize', onStoreChange);\n      };\n    }, () => visualViewport && ({\n      width: visualViewport.width,\n      height: visualViewport.height,\n      scale: visualViewport.scale,\n    })\n  );\n};\n\n/**\n * A hook that provides the current scroll position of the window.\n * It listens to the 'scroll' event to update the position.\n * \n * @returns An object containing scrollX and scrollY values.\n */\nexport const useWindowScroll = () => {\n  const window = useWindow();\n  return _useSharedSyncExternalStore(\n    'useWindowScroll',\n    (onStoreChange) => {\n      window.addEventListener('scroll', onStoreChange);\n      return () => {\n        window.removeEventListener('scroll', onStoreChange);\n      };\n    }, () => ({\n      scrollX: window.scrollX,\n      scrollY: window.scrollY,\n    })\n  );\n};\n\nconst colorSchemeDarkCache = new WeakMap<ReturnType<typeof useWindow>, MediaQueryList | undefined>();\n\n/**\n * A hook that detects the user's preferred color scheme (light or dark).\n * It listens to changes in the '(prefers-color-scheme: dark)' media query.\n * \n * @returns A string indicating the current color scheme: 'light' or 'dark'.\n */\nexport const useColorScheme = () => {\n  const window = useWindow();\n  if (!colorSchemeDarkCache.has(window)) colorSchemeDarkCache.set(window, window.matchMedia?.('(prefers-color-scheme: dark)'));\n  const colorSchemeDark = colorSchemeDarkCache.get(window);\n  return _useSharedSyncExternalStore(\n    'useColorScheme',\n    (onStoreChange) => {\n      colorSchemeDark?.addEventListener('change', onStoreChange);\n      return () => {\n        colorSchemeDark?.removeEventListener('change', onStoreChange);\n      };\n    }, () => colorSchemeDark?.matches ? 'dark' : 'light'\n  );\n};\n"],"names":[],"mappings":";;;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,WAAA,QAAA,QAAA;;ACLP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,WAAA;AACP;AACA;AACA;AACA,0CAAA,GAAA;AACA,6CAAA,GAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,eAAA,kBAAA,eAAA,aAAA,cAAA,uBAAA,MAAA,mBAAA,eAAA,cAAA,eAAA;AACP;AACA;;AC3DA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,iBAAA,WAAA,SAAA,CAAA,OAAA,uBAAA,OAAA,uCAAA,mBAAA,qBAAA,qBAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,uBAAA,WAAA,SAAA,CAAA,OAAA,uBAAA,OAAA,uCAAA,yBAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,mBAAA,WAAA,SAAA,CAAA,IAAA,uBAAA,IAAA,+BAAA,gBAAA,YAAA,oBAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,sBAAA,aAAA,2BAAA,YAAA,uBAAA;;AC9BP;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,SAAA;;ACNP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,iBAAA;;ACRP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,eAAA,8EAAA,cAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,iBAAA,8EAAA,cAAA;;AClBP;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,aAAA;;ACNP;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,SAAA,QAAA,MAAA,GAAwC,KAAe,CAAA,SAAA;AAC9D;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,gBAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,wBAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,eAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,cAAA;;;;"}

package/dist/web.d.ts

@@ -1,10 +1,10 @@
 import { S as SetStateAction, R as RefObject } from './internals/common-CpEB3ieX.js';
 import * as jsdom from 'jsdom';
-export { D as DOMNativeNode, _ as _DOMRenderer } from './internals/renderer-Bnsr3mNZ.js';
+export { D as DOMNativeNode, _ as _DOMRenderer } from './internals/renderer-BGklQuhL.js';
 import '@o2ter/utils-js';
 import 'lodash';
 import 'csstype';
-import './internals/renderer-CtvkpyUB.js';
+import './internals/renderer-_DLTEPZN.js';
 
 /**
  * Hook to access the current document object in a web renderer.