React API Reference

Complete API reference for @tokiforge/react.

ThemeProvider

React component that provides theme context to all child components.

Props

interface ThemeProviderProps {
  config: ThemeConfig;
  selector?: string;
  prefix?: string;
  defaultTheme?: string;
  children: React.ReactNode;
}

Example

<ThemeProvider 
  config={themeConfig}
  selector=":root"
  prefix="hf"
  defaultTheme="light"
>
  <App />
</ThemeProvider>

useTheme

React hook to access theme context.

Returns

interface ThemeContextValue {
  theme: string;
  tokens: DesignTokens;
  setTheme: (themeName: string) => void;
  nextTheme: () => void;
  availableThemes: string[];
  runtime: ThemeRuntime;
}

Example

function Component() {
  const { theme, tokens, setTheme } = useTheme();
  
  return (
    <button onClick={() => setTheme('dark')}>
      Current: {theme}
    </button>
  );
}

Types

All types are exported from @tokiforge/core. See Core API for details.

Examples

See React Example for complete usage examples.