Référence API · React

@oriatheme/react

Connectez un magasin externe d'exécution à React avec un fournisseur et des hooks ; pas de deuxième machine à états.

Forfait et environnement

Fournisseur de navigateur pour React 18.2 ou 19 ; le module lui-même peut être importé en toute sécurité via SSR.

bash

pnpm add @oriatheme/presets @oriatheme/runtime-dom @oriatheme/react

bash

npm install @oriatheme/presets @oriatheme/runtime-dom @oriatheme/react

bash

yarn add @oriatheme/presets @oriatheme/runtime-dom @oriatheme/react

bash

bun add @oriatheme/presets @oriatheme/runtime-dom @oriatheme/react

Utilisez le gestionnaire de packages et le fichier de verrouillage déjà choisis par le projet consommateur. Les exemples utilisent uniquement les exportations racine du package ; n'effectuez pas d'importation approfondie à partir de modèles src, dist ou de registre.

Exports

Exporter	Signature	Descriptif
`OriaThemeProvider`	`({ config, runtime?, children }: OriaThemeProviderProps) => ReactElement`	Démarre un runtime détenu ou utilise le runtime fourni pour les descendants.
`useOriaTheme`	`() => { snapshot, runtime, setTheme, setAppearance }`	Lit l’instantané d’exécution immuable complet et les actions liées.
`useThemeSnapshot`	`<T>(selector, isEqual?) => T`	Sélectionne une tranche d’instantané tout en préservant des références égales.

tsx

import { OriaThemeProvider, useOriaTheme } from "@oriatheme/react";

function Controls() {
  const { setAppearance, setTheme } = useOriaTheme();
  return <button onClick={() => setTheme("oria-ocean")}>Ocean</button>;
}

Types et limites importants

OriaThemeProviderProps accepte un OriaThemeConfig ou un OriaThemeRuntime externe. Montez le fournisseur uniquement sur le client ; pour Next first paint, affichez d'abord les variables par défaut validées et un script Bootstrap.