feat: replace next-themes with a custom ThemeProvider

To be honest, next-themes was working fine. However since I use a theme
provider for Prism code blocks, some code is duplicated between this
app and the library. So I prefer to use a custom Provider without the
options I don't need.

15 files changed, 332 insertions, 0 deletions

diff --git a/src/utils/constants.ts b/src/utils/constants.ts
index 62acca5..0c64f3a 100644
--- a/src/utils/constants.ts
+++ b/src/utils/constants.ts
@@ -34,4 +34,5 @@ export const ROUTES = {
 export const STORAGE_KEY = {
   ACKEE: 'ackee-tracking',
   MOTION: 'reduced-motion',
+  THEME: 'theme',
 } as const;
diff --git a/src/utils/helpers/index.ts b/src/utils/helpers/index.ts
index b2a4534..14487e6 100644
--- a/src/utils/helpers/index.ts
+++ b/src/utils/helpers/index.ts
@@ -4,3 +4,4 @@ export * from './pages';
 export * from './rss';
 export * from './schema-org';
 export * from './strings';
+export * from './themes';
diff --git a/src/utils/helpers/themes.ts b/src/utils/helpers/themes.ts
new file mode 100644
index 0000000..8ef3a19
--- /dev/null
+++ b/src/utils/helpers/themes.ts
@@ -0,0 +1,18 @@
+/**
+ * Check if the user prefers dark color scheme.
+ *
+ * @returns {boolean|undefined} True if `prefers-color-scheme` is set to `dark`.
+ */
+export const prefersDarkScheme = (): boolean | undefined => {
+  if (typeof window === 'undefined') return undefined;
+
+  return window.matchMedia('(prefers-color-scheme: dark)').matches;
+};
+
+/**
+ * Retrieve the theme to use depending on the user system theme.
+ */
+export const getThemeFromSystem = () => {
+  if (prefersDarkScheme()) return 'dark';
+  return 'light';
+};
diff --git a/src/utils/hooks/index.ts b/src/utils/hooks/index.ts
index 606c259..4372ca0 100644
--- a/src/utils/hooks/index.ts
+++ b/src/utils/hooks/index.ts
@@ -10,6 +10,7 @@ export * from './use-headings-tree';
 export * from './use-input-autofocus';
 export * from './use-is-mounted';
 export * from './use-local-storage';
+export * from './use-match-media';
 export * from './use-mutation-observer';
 export * from './use-on-click-outside';
 export * from './use-pagination';
@@ -22,3 +23,5 @@ export * from './use-route-change';
 export * from './use-scroll-position';
 export * from './use-settings';
 export * from './use-state-change';
+export * from './use-system-color-scheme';
+export * from './use-theme';
diff --git a/src/utils/hooks/use-match-media/index.ts b/src/utils/hooks/use-match-media/index.ts
new file mode 100644
index 0000000..7d79e64
--- /dev/null
+++ b/src/utils/hooks/use-match-media/index.ts
@@ -0,0 +1 @@
+export * from './use-match-media';
diff --git a/src/utils/hooks/use-match-media/use-match-media.ts b/src/utils/hooks/use-match-media/use-match-media.ts
new file mode 100644
index 0000000..50ac038
--- /dev/null
+++ b/src/utils/hooks/use-match-media/use-match-media.ts
@@ -0,0 +1,17 @@
+import { useEffect } from 'react';
+
+export type UseMatchMediaCallback = (ev: MediaQueryListEvent) => void;
+
+/**
+ * React hook to watch for media changes based on the given query.
+ *
+ * @param {string} query - A media query.
+ * @param {UseMatchMediaCallback} cb - A callback function to execute on change.
+ */
+export const useMatchMedia = (query: string, cb: UseMatchMediaCallback) => {
+  useEffect(() => {
+    window.matchMedia(query).addEventListener('change', cb);
+
+    return () => window.matchMedia(query).removeEventListener('change', cb);
+  }, [cb, query]);
+};
diff --git a/src/utils/hooks/use-system-color-scheme/index.ts b/src/utils/hooks/use-system-color-scheme/index.ts
new file mode 100644
index 0000000..78d1665
--- /dev/null
+++ b/src/utils/hooks/use-system-color-scheme/index.ts
@@ -0,0 +1 @@
+export * from './use-system-color-scheme';
diff --git a/src/utils/hooks/use-system-color-scheme/use-system-color-scheme.ts b/src/utils/hooks/use-system-color-scheme/use-system-color-scheme.ts
new file mode 100644
index 0000000..1956f32
--- /dev/null
+++ b/src/utils/hooks/use-system-color-scheme/use-system-color-scheme.ts
@@ -0,0 +1,24 @@
+import { useCallback, useState } from 'react';
+import { getThemeFromSystem } from '../../helpers';
+import { useMatchMedia } from '../use-match-media';
+
+export type SystemColorScheme = 'dark' | 'light';
+
+/**
+ * React hook to retrieve the system color scheme based on user preferences,
+ * and to watch for changes.
+ *
+ * @returns {SystemColorScheme} The system color scheme
+ */
+export const useSystemColorScheme = () => {
+  const [colorScheme, setColorScheme] =
+    useState<SystemColorScheme>(getThemeFromSystem);
+
+  const updateColorScheme = useCallback(() => {
+    setColorScheme(getThemeFromSystem);
+  }, []);
+
+  useMatchMedia('(prefers-color-scheme: dark)', updateColorScheme);
+
+  return colorScheme;
+};
diff --git a/src/utils/hooks/use-theme/index.ts b/src/utils/hooks/use-theme/index.ts
new file mode 100644
index 0000000..4e8fc4a
--- /dev/null
+++ b/src/utils/hooks/use-theme/index.ts
@@ -0,0 +1 @@
+export * from './use-theme';
diff --git a/src/utils/hooks/use-theme/use-theme.test.tsx b/src/utils/hooks/use-theme/use-theme.test.tsx
new file mode 100644
index 0000000..feaabfa
--- /dev/null
+++ b/src/utils/hooks/use-theme/use-theme.test.tsx
@@ -0,0 +1,82 @@
+import { describe, expect, it } from '@jest/globals';
+import { act, renderHook } from '@testing-library/react';
+import type { FC, ReactNode } from 'react';
+import { ThemeProvider, type ThemeProviderProps } from '../../providers';
+import { useTheme } from './use-theme';
+
+const createWrapper = (
+  Wrapper: FC<ThemeProviderProps>,
+  config: ThemeProviderProps
+) =>
+  function CreatedWrapper({ children }: { children: ReactNode }) {
+    return <Wrapper {...config}>{children}</Wrapper>;
+  };
+
+describe('useTheme', () => {
+  it('should return the default value without provider and prevent update', () => {
+    const defaultTheme = 'system';
+    const { result } = renderHook(() => useTheme());
+
+    expect(result.current.theme).toBe(defaultTheme);
+
+    act(() => result.current.setTheme('dark'));
+
+    expect(result.current.theme).toBe(defaultTheme);
+  });
+
+  it('can update the value', () => {
+    const defaultTheme = 'dark';
+
+    const { result } = renderHook(() => useTheme(), {
+      wrapper: createWrapper(ThemeProvider, {
+        attribute: 'magnam',
+        defaultTheme,
+        storageKey: 'repellat',
+      }),
+    });
+
+    expect(result.current.theme).toBe(defaultTheme);
+
+    const newTheme = 'light';
+
+    act(() => result.current.setTheme(newTheme));
+
+    expect(result.current.theme).toBe(newTheme);
+  });
+
+  it('can toggle the theme from dark to light', () => {
+    const defaultTheme = 'dark';
+
+    const { result } = renderHook(() => useTheme(), {
+      wrapper: createWrapper(ThemeProvider, {
+        attribute: 'voluptatibus',
+        defaultTheme,
+        storageKey: 'qui',
+      }),
+    });
+
+    expect(result.current.theme).toBe(defaultTheme);
+
+    act(() => result.current.toggleTheme());
+
+    expect(result.current.theme).toBe('light');
+  });
+
+  it('can toggle the theme from light to dark', () => {
+    const defaultTheme = 'light';
+
+    const { result } = renderHook(() => useTheme(), {
+      wrapper: createWrapper(ThemeProvider, {
+        attribute: 'sed',
+        defaultTheme,
+        storageKey: 'ut',
+      }),
+    });
+
+    expect(result.current.theme).toBe(defaultTheme);
+
+    act(() => result.current.toggleTheme());
+
+    expect(result.current.theme).toBe('dark');
+  });
+});
diff --git a/src/utils/hooks/use-theme/use-theme.ts b/src/utils/hooks/use-theme/use-theme.ts
new file mode 100644
index 0000000..0605d8b
--- /dev/null
+++ b/src/utils/hooks/use-theme/use-theme.ts
@@ -0,0 +1,15 @@
+import { useCallback, useContext } from 'react';
+import { ThemeContext } from '../../providers';
+
+export const useTheme = () => {
+  const { resolvedTheme, theme, setTheme } = useContext(ThemeContext);
+
+  const toggleTheme = useCallback(() => {
+    setTheme(() => {
+      if (resolvedTheme === 'dark') return 'light';
+      return 'dark';
+    });
+  }, [resolvedTheme, setTheme]);
+
+  return { resolvedTheme, setTheme, theme, toggleTheme };
+};
diff --git a/src/utils/providers/index.ts b/src/utils/providers/index.ts
index a01200a..90dca15 100644
--- a/src/utils/providers/index.ts
+++ b/src/utils/providers/index.ts
@@ -1,3 +1,4 @@
 export * from './ackee-provider';
 export * from './motion-provider';
 export * from './prism-theme';
+export * from './theme-provider';
diff --git a/src/utils/providers/theme-provider/index.ts b/src/utils/providers/theme-provider/index.ts
new file mode 100644
index 0000000..3df4bde
--- /dev/null
+++ b/src/utils/providers/theme-provider/index.ts
@@ -0,0 +1 @@
+export * from './theme-provider';
diff --git a/src/utils/providers/theme-provider/theme-provider.test.tsx b/src/utils/providers/theme-provider/theme-provider.test.tsx
new file mode 100644
index 0000000..59a72cc
--- /dev/null
+++ b/src/utils/providers/theme-provider/theme-provider.test.tsx
@@ -0,0 +1,78 @@
+import { describe, expect, it } from '@jest/globals';
+import { render, screen as rtlScreen } from '@testing-library/react';
+import { type FC, useContext } from 'react';
+import { getThemeFromSystem } from '../../helpers';
+import { ThemeContext, ThemeProvider } from './theme-provider';
+
+const bodyPrefix = 'Current theme is:';
+
+const ComponentTest: FC = () => {
+  const { theme } = useContext(ThemeContext);
+
+  return (
+    <div>
+      {bodyPrefix} {theme}
+    </div>
+  );
+};
+
+describe('ThemeProvider', () => {
+  it('uses the default value when the provider is not used', () => {
+    const defaultValue = 'system';
+
+    render(<ComponentTest />);
+
+    expect(rtlScreen.getByText(new RegExp(bodyPrefix))).toHaveTextContent(
+      `${bodyPrefix} ${defaultValue}`
+    );
+  });
+
+  it('provides the given value to its children and set a matching attribute', () => {
+    const attribute = 'iure';
+    const theme = 'dark';
+
+    const { baseElement } = render(
+      <ThemeProvider
+        attribute={attribute}
+        defaultTheme={theme}
+        storageKey="dolores"
+      >
+        <ComponentTest />
+      </ThemeProvider>
+    );
+
+    expect(rtlScreen.getByText(new RegExp(bodyPrefix))).toHaveTextContent(
+      `${bodyPrefix} ${theme}`
+    );
+    expect(baseElement.parentElement?.getAttribute(`data-${attribute}`)).toBe(
+      theme
+    );
+    expect(baseElement.parentElement).toHaveStyle(`color-scheme: ${theme};`);
+  });
+
+  it('can resolve the preferred theme from user system settings', () => {
+    const attribute = 'qui';
+    const defaultTheme = 'system';
+    const resolvedTheme = getThemeFromSystem();
+
+    const { baseElement } = render(
+      <ThemeProvider
+        attribute={attribute}
+        defaultTheme={defaultTheme}
+        storageKey="modi"
+      >
+        <ComponentTest />
+      </ThemeProvider>
+    );
+
+    expect(rtlScreen.getByText(new RegExp(bodyPrefix))).toHaveTextContent(
+      `${bodyPrefix} ${defaultTheme}`
+    );
+    expect(baseElement.parentElement?.getAttribute(`data-${attribute}`)).toBe(
+      resolvedTheme
+    );
+    expect(baseElement.parentElement).toHaveStyle(
+      `color-scheme: ${resolvedTheme};`
+    );
+  });
+});
diff --git a/src/utils/providers/theme-provider/theme-provider.tsx b/src/utils/providers/theme-provider/theme-provider.tsx
new file mode 100644
index 0000000..b743a7f
--- /dev/null
+++ b/src/utils/providers/theme-provider/theme-provider.tsx
@@ -0,0 +1,88 @@
+import {
+  type Dispatch,
+  type FC,
+  type ReactNode,
+  type SetStateAction,
+  createContext,
+  useMemo,
+  useEffect,
+} from 'react';
+import { getDataAttributeFrom, getThemeFromSystem } from '../../helpers';
+import { useLocalStorage, useSystemColorScheme } from '../../hooks';
+
+const validThemes = ['dark', 'light', 'system'] as const;
+
+type Theme = (typeof validThemes)[number];
+
+type ThemeContextProps = {
+  resolvedTheme: Exclude<Theme, 'system'>;
+  setTheme: Dispatch<SetStateAction<Theme>>;
+  theme: Theme;
+};
+
+export const ThemeContext = createContext<ThemeContextProps>({
+  resolvedTheme: getThemeFromSystem(),
+  setTheme: (value) => value,
+  theme: 'system',
+});
+
+const validator = (value: unknown): value is Theme =>
+  typeof value === 'string' &&
+  (validThemes as readonly string[]).includes(value);
+
+export type ThemeProviderProps = {
+  /**
+   * The attribute name to append to document root.
+   */
+  attribute: string;
+  /**
+   * The provider children.
+   */
+  children?: ReactNode;
+  /**
+   * The default theme.
+   *
+   * @default 'system'
+   */
+  defaultTheme?: Theme;
+  /**
+   * The key to use in local storage.
+   */
+  storageKey: string;
+};
+
+export const ThemeProvider: FC<ThemeProviderProps> = ({
+  attribute,
+  children,
+  defaultTheme = 'system',
+  storageKey,
+}) => {
+  const [theme, setTheme] = useLocalStorage(
+    storageKey,
+    defaultTheme,
+    validator
+  );
+  const userColorScheme = useSystemColorScheme();
+  const resolvedTheme: Exclude<Theme, 'system'> =
+    theme === 'system' ? userColorScheme : theme;
+  const dataAttribute = getDataAttributeFrom(attribute);
+
+  useEffect(() => {
+    if (typeof window !== 'undefined') {
+      document.documentElement.setAttribute(dataAttribute, `${resolvedTheme}`);
+      document.documentElement.style.colorScheme = resolvedTheme;
+    }
+
+    return () => {
+      document.documentElement.removeAttribute(dataAttribute);
+    };
+  }, [dataAttribute, resolvedTheme]);
+
+  const value = useMemo(() => {
+    return { resolvedTheme, setTheme, theme };
+  }, [resolvedTheme, setTheme, theme]);
+
+  return (
+    <ThemeContext.Provider value={value}>{children}</ThemeContext.Provider>
+  );
+};