@kbach/react 0.2.3 → 0.2.4

package/dist/index.d.mts

@@ -142,14 +142,29 @@ declare function useTheme(): ThemeContextValue;
 
 interface ThemeProviderProps {
     children: ReactNode;
-    /** Default mode on first render. Falls back to persisted value, then 'system'. */
+    /** Initial mode. Falls back to persisted value, then 'system'. */
     defaultMode?: ThemeMode;
+    /**
+     * Explicit color scheme override for native with `defaultMode="system"`.
+     *
+     * On some Android devices the system scheme is not detected on startup
+     * (the `appearanceChanged` event only fires on *changes*, not on launch when
+     * the device was already dark). Pass `useColorScheme()` from `react-native`
+     * here to guarantee correct detection:
+     *
+     * ```tsx
+     * import { useColorScheme } from 'react-native';
+     * const scheme = useColorScheme();
+     * <ThemeProvider defaultMode="system" colorScheme={scheme}>…</ThemeProvider>
+     * ```
+     */
+    colorScheme?: 'light' | 'dark' | null;
     /** Override the config (useful for per-tree config). Defaults to global getConfig(). */
     config?: FrameworkConfig;
-    /** Disable persistence to localStorage / AsyncStorage */
+    /** Disable persistence to localStorage */
     disablePersistence?: boolean;
 }
-declare function ThemeProvider({ children, defaultMode, config: configOverride, disablePersistence, }: ThemeProviderProps): React__default.JSX.Element;
+declare function ThemeProvider({ children, defaultMode, colorScheme: colorSchemeProp, config: configOverride, disablePersistence, }: ThemeProviderProps): React__default.JSX.Element;
 
 type ToggleVariant = 'button' | 'switch' | 'icon-button';
 interface ThemeToggleProps {

package/dist/index.d.ts

@@ -142,14 +142,29 @@ declare function useTheme(): ThemeContextValue;
 
 interface ThemeProviderProps {
     children: ReactNode;
-    /** Default mode on first render. Falls back to persisted value, then 'system'. */
+    /** Initial mode. Falls back to persisted value, then 'system'. */
     defaultMode?: ThemeMode;
+    /**
+     * Explicit color scheme override for native with `defaultMode="system"`.
+     *
+     * On some Android devices the system scheme is not detected on startup
+     * (the `appearanceChanged` event only fires on *changes*, not on launch when
+     * the device was already dark). Pass `useColorScheme()` from `react-native`
+     * here to guarantee correct detection:
+     *
+     * ```tsx
+     * import { useColorScheme } from 'react-native';
+     * const scheme = useColorScheme();
+     * <ThemeProvider defaultMode="system" colorScheme={scheme}>…</ThemeProvider>
+     * ```
+     */
+    colorScheme?: 'light' | 'dark' | null;
     /** Override the config (useful for per-tree config). Defaults to global getConfig(). */
     config?: FrameworkConfig;
-    /** Disable persistence to localStorage / AsyncStorage */
+    /** Disable persistence to localStorage */
     disablePersistence?: boolean;
 }
-declare function ThemeProvider({ children, defaultMode, config: configOverride, disablePersistence, }: ThemeProviderProps): React__default.JSX.Element;
+declare function ThemeProvider({ children, defaultMode, colorScheme: colorSchemeProp, config: configOverride, disablePersistence, }: ThemeProviderProps): React__default.JSX.Element;
 
 type ToggleVariant = 'button' | 'switch' | 'icon-button';
 interface ThemeToggleProps {

package/dist/index.js

@@ -2098,13 +2098,16 @@ function applyWebTheme(resolvedMode, strategy) {
 function ThemeProvider({
   children,
   defaultMode = "system",
+  colorScheme: colorSchemeProp,
   config: configOverride,
   disablePersistence = false
 }) {
   const [resolvedConfig, setResolvedConfig] = (0, import_react2.useState)(
     () => configOverride ? buildConfig(configOverride) : getConfig()
   );
-  const nativeScheme = _useColorScheme?.();
+  const [nativeSchemeFallback, setNativeSchemeFallback] = (0, import_react2.useState)(null);
+  const hookScheme = _useColorScheme?.();
+  const nativeScheme = colorSchemeProp !== void 0 ? colorSchemeProp ?? null : hookScheme ?? nativeSchemeFallback;
   const [webScheme, setWebScheme] = (0, import_react2.useState)(() => {
     if (isWeb && typeof window !== "undefined") {
       return window.matchMedia?.("(prefers-color-scheme: dark)").matches ? "dark" : "light";
@@ -2129,6 +2132,18 @@ function ThemeProvider({
   const resolvedMode = mode === "system" ? systemScheme : mode;
   const isDark = resolvedMode === "dark";
   syncGlobalDarkMode(isDark);
+  (0, import_react2.useEffect)(() => {
+    if (isWeb) return;
+    try {
+      const { TurboModuleRegistry } = require("react-native");
+      const native = TurboModuleRegistry?.get?.("Appearance");
+      const scheme = native?.getColorScheme?.();
+      if (scheme === "dark" || scheme === "light") {
+        setNativeSchemeFallback(scheme);
+      }
+    } catch {
+    }
+  }, []);
   (0, import_react2.useEffect)(() => {
     applyWebTheme(resolvedMode, resolvedConfig.darkMode);
     setGlobalDarkMode(isDark);

package/dist/index.mjs

@@ -72,13 +72,16 @@ function applyWebTheme(resolvedMode, strategy) {
 function ThemeProvider({
   children,
   defaultMode = "system",
+  colorScheme: colorSchemeProp,
   config: configOverride,
   disablePersistence = false
 }) {
   const [resolvedConfig, setResolvedConfig] = useState(
     () => configOverride ? buildConfig(configOverride) : getConfig()
   );
-  const nativeScheme = _useColorScheme?.();
+  const [nativeSchemeFallback, setNativeSchemeFallback] = useState(null);
+  const hookScheme = _useColorScheme?.();
+  const nativeScheme = colorSchemeProp !== void 0 ? colorSchemeProp ?? null : hookScheme ?? nativeSchemeFallback;
   const [webScheme, setWebScheme] = useState(() => {
     if (isWeb && typeof window !== "undefined") {
       return window.matchMedia?.("(prefers-color-scheme: dark)").matches ? "dark" : "light";
@@ -103,6 +106,18 @@ function ThemeProvider({
   const resolvedMode = mode === "system" ? systemScheme : mode;
   const isDark = resolvedMode === "dark";
   syncGlobalDarkMode(isDark);
+  useEffect(() => {
+    if (isWeb) return;
+    try {
+      const { TurboModuleRegistry } = __require("react-native");
+      const native = TurboModuleRegistry?.get?.("Appearance");
+      const scheme = native?.getColorScheme?.();
+      if (scheme === "dark" || scheme === "light") {
+        setNativeSchemeFallback(scheme);
+      }
+    } catch {
+    }
+  }, []);
   useEffect(() => {
     applyWebTheme(resolvedMode, resolvedConfig.darkMode);
     setGlobalDarkMode(isDark);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kbach/react",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "React / React Native components and hooks for the Kbach framework",
   "source": "./src/index.ts",
   "main": "./dist/index.js",