@idealyst/theme 1.2.74 → 1.2.76

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@idealyst/theme",
-  "version": "1.2.74",
+  "version": "1.2.76",
   "description": "Theming system for Idealyst Framework",
   "readme": "README.md",
   "main": "src/index.ts",

package/src/colorScheme.ts

@@ -0,0 +1,53 @@
+import { UnistylesRuntime } from 'react-native-unistyles';
+
+/**
+ * Color scheme preference type.
+ */
+export type ColorScheme = 'light' | 'dark';
+
+/**
+ * Get the current system/device color scheme preference.
+ *
+ * @returns 'light', 'dark', or null if not available
+ *
+ * @example
+ * ```typescript
+ * const scheme = getColorScheme();
+ * if (scheme) {
+ *   console.log(scheme); // 'dark'
+ * }
+ * ```
+ */
+export function getColorScheme(): ColorScheme | null {
+    const scheme = UnistylesRuntime.colorScheme;
+    if (scheme === 'light' || scheme === 'dark') {
+        return scheme;
+    }
+    return null;
+}
+
+/**
+ * Theme settings controller - wraps Unistyles runtime for theme management.
+ */
+export const ThemeSettings = {
+    /**
+     * Set the active theme by name with content color scheme.
+     *
+     * @param themeName - The theme name to activate
+     * @param contentColor - The content color scheme ('light' or 'dark')
+     * @param animated - Whether to animate the status bar transition (default: false)
+     *
+     * @example
+     * ```typescript
+     * ThemeSettings.setTheme('darkBlue', 'dark');
+     * ThemeSettings.setTheme('light', 'light', true); // animated
+     * ```
+     */
+    setTheme(themeName: string, contentColor: ColorScheme, animated: boolean = false): void {
+        UnistylesRuntime.setTheme(themeName as any);
+        UnistylesRuntime.setRootViewBackgroundColor(
+            contentColor === 'dark' ? '#000000' : '#ffffff'
+        );
+        UnistylesRuntime.statusBar.setStyle(contentColor === 'dark' ? 'light' : 'dark', animated);
+    },
+};

package/src/index.ts

@@ -25,6 +25,9 @@ export * from './responsive';
 export * from './breakpoints';
 export * from './useResponsiveStyle';
 
+// Color scheme utilities
+export * from './colorScheme';
+
 // Style props hook (platform-specific via .native.ts)
 export { useStyleProps, type StyleProps } from './useStyleProps';