import type { OsdkThemeContextValue } from "./types.js";
/**
* Read the active OSDK theme and update it imperatively.
*
* Must be called from a descendant of `<OsdkThemeProvider>`; throws otherwise.
*
* @returns
* - `theme` — the requested mode (`"light" | "dark" | "system"`).
* - `resolvedTheme` — the concrete theme on the DOM (`"light" | "dark"`).
*   When `theme === "system"`, this tracks `prefers-color-scheme` and
*   updates as the OS preference changes.
* - `setTheme(next)` — update the mode. In controlled mode this only
*   invokes the provider's `onThemeChanged`; the consumer must re-render
*   the provider with the new value.
*/
export declare function useOsdkTheme(): OsdkThemeContextValue;
