feat: allow user to disable auto theme changing with a prop

src/index.test.tsx

@@ -1115,7 +1115,7 @@ describe("<DashProvider>", () => {
     });
 
     expect(styles.tokens.light.colors.primary).toBe("red");
-    expect((styles.themes.light as any).colors.primary).toBe('red');
+    expect((styles.themes.light as any).colors.primary).toBe("red");
   });
 
   it("should set a default theme", () => {
@@ -1258,6 +1258,32 @@ describe("<DashProvider>", () => {
     expect(onThemeChange).not.toBeCalled();
   });
 
+  it("should not react to useColorScheme changes if disableAutoThemeChange", () => {
+    const { DashProvider } = createStyles(stylesConfig);
+    const onThemeChange = jest.fn();
+    jest.spyOn(RN.Appearance, "addChangeListener");
+    const listeners: any[] = [];
+    // @ts-expect-error
+    RN.Appearance.addChangeListener.mockImplementation((listener) => {
+      listeners.push(listener);
+    });
+
+    render(
+      <DashProvider
+        defaultTheme="light"
+        disableAutoThemeChange
+        onThemeChange={onThemeChange}
+      />
+    );
+
+    colorScheme = "dark";
+    act(() => {
+      listeners.forEach((listener) => listener(colorScheme));
+    });
+
+    expect(onThemeChange).not.toBeCalled();
+  });
+
   it("should not react to useColorScheme changes if themes are non-standard", () => {
     const { DashProvider } = createStyles({
       ...stylesConfig,

src/index.tsx

@@ -339,11 +339,13 @@ export function createStyles<
       theme: controlledTheme,
       defaultTheme,
       onThemeChange,
+      disableAutoThemeChange,
       children,
     }: {
       defaultTheme?: typeof currentTheme;
       theme?: typeof currentTheme;
       onThemeChange?: (theme: typeof currentTheme) => void;
+      disableAutoThemeChange?: boolean;
       children?: React.ReactNode;
     }) {
       const colorScheme = RN.useColorScheme();
@@ -387,7 +389,8 @@ export function createStyles<
           !controlledTheme &&
           colorScheme &&
           colorScheme !== theme &&
-          isAutoThemeable
+          isAutoThemeable &&
+          !disableAutoThemeChange
         ) {
           currentTheme = colorScheme as keyof T;
           setTheme(currentTheme);