first commit

apps/docs/providers/public-settings-provider.tsx

@@ -0,0 +1,80 @@
+'use client';
+
+import { createContext, useCallback, useContext, useEffect, useMemo, useState } from 'react';
+import { fetchPublicSettingsClient, getDefaultProjectName, getDefaultProjectTagline } from '@/lib/api';
+import { mergePublicSettings, readCachedPublicSettings, writeCachedPublicSettings } from '@/lib/public-settings-cache';
+
+interface PublicSettingsContextValue {
+  projectName: string;
+  projectTagline: string;
+  isLoading: boolean;
+  refreshPublicSettings: () => Promise<void>;
+}
+
+const PublicSettingsContext = createContext<PublicSettingsContextValue>({
+  projectName: getDefaultProjectName(),
+  projectTagline: getDefaultProjectTagline(),
+  isLoading: true,
+  refreshPublicSettings: async () => undefined
+});
+
+export function PublicSettingsProvider({
+  children,
+  initialSettings
+}: {
+  children: React.ReactNode;
+  initialSettings: Record<string, string>;
+}) {
+  const [settings, setSettings] = useState<Record<string, string>>(() =>
+    mergePublicSettings(readCachedPublicSettings(), initialSettings)
+  );
+  const [isLoading, setIsLoading] = useState(true);
+
+  const refreshPublicSettings = useCallback(async () => {
+    try {
+      const next = await fetchPublicSettingsClient();
+      setSettings((current) => mergePublicSettings(current, next));
+      writeCachedPublicSettings(next);
+    } catch {
+      // Оставляем последние известные значения (кэш или SSR).
+    } finally {
+      setIsLoading(false);
+    }
+  }, []);
+
+  useEffect(() => {
+    const cached = readCachedPublicSettings();
+    if (Object.keys(cached).length > 0) {
+      setSettings((current) => mergePublicSettings(cached, initialSettings, current));
+    }
+  }, [initialSettings]);
+
+  useEffect(() => {
+    void refreshPublicSettings();
+    const onFocus = () => void refreshPublicSettings();
+    window.addEventListener('focus', onFocus);
+    return () => window.removeEventListener('focus', onFocus);
+  }, [refreshPublicSettings]);
+
+  useEffect(() => {
+    if (settings.PROJECT_NAME) {
+      document.title = `Документация — ${settings.PROJECT_NAME}`;
+    }
+  }, [settings.PROJECT_NAME]);
+
+  const value = useMemo(
+    () => ({
+      projectName: settings.PROJECT_NAME || getDefaultProjectName(),
+      projectTagline: settings.PROJECT_TAGLINE || getDefaultProjectTagline(),
+      isLoading,
+      refreshPublicSettings
+    }),
+    [isLoading, refreshPublicSettings, settings.PROJECT_NAME, settings.PROJECT_TAGLINE]
+  );
+
+  return <PublicSettingsContext.Provider value={value}>{children}</PublicSettingsContext.Provider>;
+}
+
+export function usePublicSettings() {
+  return useContext(PublicSettingsContext);
+}

apps/docs/providers/theme-provider.tsx

@@ -0,0 +1,51 @@
+'use client';
+
+import { createContext, useContext, useEffect, useMemo, useState } from 'react';
+
+type Theme = 'light' | 'dark' | 'system';
+
+interface ThemeContextValue {
+  theme: Theme;
+  resolvedTheme: 'light' | 'dark';
+  setTheme: (theme: Theme) => void;
+}
+
+const ThemeContext = createContext<ThemeContextValue | null>(null);
+
+export function ThemeProvider({ children }: { children: React.ReactNode }) {
+  const [theme, setThemeState] = useState<Theme>('system');
+  const [resolvedTheme, setResolvedTheme] = useState<'light' | 'dark'>('light');
+
+  useEffect(() => {
+    const stored = localStorage.getItem('docs-theme') as Theme | null;
+    if (stored) setThemeState(stored);
+  }, []);
+
+  useEffect(() => {
+    const root = document.documentElement;
+    const media = window.matchMedia('(prefers-color-scheme: dark)');
+    const apply = () => {
+      const next = theme === 'system' ? (media.matches ? 'dark' : 'light') : theme;
+      setResolvedTheme(next);
+      root.classList.toggle('dark', next === 'dark');
+    };
+    apply();
+    media.addEventListener('change', apply);
+    return () => media.removeEventListener('change', apply);
+  }, [theme]);
+
+  const setTheme = (next: Theme) => {
+    setThemeState(next);
+    localStorage.setItem('docs-theme', next);
+  };
+
+  const value = useMemo(() => ({ theme, resolvedTheme, setTheme }), [theme, resolvedTheme]);
+
+  return <ThemeContext.Provider value={value}>{children}</ThemeContext.Provider>;
+}
+
+export function useTheme() {
+  const ctx = useContext(ThemeContext);
+  if (!ctx) throw new Error('useTheme must be used within ThemeProvider');
+  return ctx;
+}