Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

5.5 KB
Raw Blame
import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, type ReactNode } from 'react';
import { Appearance, StyleSheet, useColorScheme } from 'react-native';
import { palettes, type ThemeColors, type ThemeMode } from './tokens';
import {
  readThemePreference,
  resolveThemeMode,
  saveThemePreference,
  type ThemePreference,
} from './themePreferenceStore';

interface ThemeValue {
  mode: ThemeMode;
  colors: ThemeColors;
  /** 用户的显示模式偏好(含 'system');子树覆盖(ThemeOverrideProvider)不改变它。 */
  preference: ThemePreference;
  /** 已保存的偏好是否已读回;启动遮罩等它就绪后再释放,避免先按系统外观闪一下。 */
  preferenceReady: boolean;
  /**
   * 设置显示模式偏好:立即切换并同步原生外观,返回的 Promise 在持久化失败时 reject,
   * 调用方据此提示「未保存」(本次会话仍按新选择显示)。
   */
  setPreference: (next: ThemePreference) => Promise<void>;
}

const ThemeContext = createContext<ThemeValue>({
  mode: 'light',
  colors: palettes.light,
  preference: 'system',
  preferenceReady: true,
  setPreference: async () => undefined,
});

/**
 * 让系统绘制的部分(原生菜单 / 面板 / 键盘 / 状态栏 / 玻璃材质)与 Cindy 色板同一模式:
 * 'system' 还原为 unspecified,浅色 / 深色强制对应外观。只改 JS 调用,不动原生配置。
 * 强制期间 useColorScheme 读到的是被强制的外观;还原后下一次渲染即读回系统值。
 */
function applyNativeScheme(preference: ThemePreference): void {
  Appearance.setColorScheme(preference === 'system' ? 'unspecified' : preference);
}

/**
 * 按显示模式偏好(默认跟随系统)向下提供当前主题色板。挂在 SafeAreaProvider 内、其它业务
 * Provider 之上。偏好读出是异步的:读回前按系统外观渲染,StartupSplashOverlay 以
 * `preferenceReady` 为释放条件之一,保证遮罩淡出时已是用户选择的模式。
 */
export function ThemeProvider({ children }: { children: ReactNode }) {
  const systemScheme = useColorScheme();
  const [preference, setPreferenceState] = useState<ThemePreference>('system');
  const [preferenceReady, setPreferenceReady] = useState(false);
  // 用户已手动选择过时置位:挂载期的异步读回不得覆盖更晚的手动选择。
  const userChoseRef = useRef(false);

  useEffect(() => {
    let cancelled = false;
    void readThemePreference().then((stored) => {
      if (cancelled) return;
      if (!userChoseRef.current && stored !== 'system') {
        applyNativeScheme(stored);
        setPreferenceState(stored);
      }
      setPreferenceReady(true);
    });
    return () => {
      cancelled = true;
    };
  }, []);

  const setPreference = useCallback((next: ThemePreference) => {
    userChoseRef.current = true;
    applyNativeScheme(next);
    setPreferenceState(next);
    return saveThemePreference(next);
  }, []);

  const mode = resolveThemeMode(preference, systemScheme);
  const value = useMemo<ThemeValue>(
    () => ({ mode, colors: palettes[mode], preference, preferenceReady, setPreference }),
    [mode, preference, preferenceReady, setPreference],
  );
  return <ThemeContext.Provider value={value}>{children}</ThemeContext.Provider>;
}

/** 读取当前主题(mode + 色板)。用于 JSX 内联色:lucide `color=`、ActivityIndicator、placeholderTextColor 等。 */
export function useTheme(): ThemeValue {
  return useContext(ThemeContext);
}

/**
 * 子树级主题覆盖。为「登录首启亮色门」(DESIGN.md §16.5 主题跟随:首次打开
 * Cindy → 亮色登录;第二次起跟随)提供作用域强制 mode 的通道——只覆盖包裹的
 * 子树(登录界面),不影响全局 ThemeProvider 与其它界面。mode 传 null 时透传
 * 外层主题(等价不覆盖)。
 */
export function ThemeOverrideProvider({
  mode,
  children,
}: {
  mode: ThemeMode | null;
  children: ReactNode;
}) {
  const parent = useContext(ThemeContext);
  const value = useMemo<ThemeValue>(
    () => (mode == null ? parent : { ...parent, mode, colors: palettes[mode] }),
    [mode, parent],
  );
  return <ThemeContext.Provider value={value}>{children}</ThemeContext.Provider>;
}

type StyleFactory<T> = (colors: ThemeColors) => T;

/**
 * 按 scheme 记忆化的 StyleSheet 工厂缓存。
 *
 * 模块级 `WeakMap<makeStyles, { light?, dark? }>` 保证每个 `makeStyles` 工厂**每种模式只编译一次** sheet
 * (整个 app 生命周期),组件 re-render 只做缓存查找——热路径(MessageRenderer 每条消息渲染、长列表)
 * 零 StyleSheet 分配。WeakMap 让热重载 / 卸载模块的工厂可被 GC。
 */
const sheetCache = new WeakMap<StyleFactory<unknown>, Partial<Record<ThemeMode, unknown>>>();

/**
 * 把"随主题变化的 StyleSheet"接入组件。
 *
 * @param make 一个 `(colors) => StyleSheet.create({...})` 工厂。
 *   ⚠️ **必须是模块级常量**(身份稳定),不要在组件体内内联定义——否则 WeakMap 缓存每次都 miss,
 *   退化成每帧新建 sheet,拖垮热路径。
 */
export function useThemedStyles<T extends StyleSheet.NamedStyles<T>>(make: StyleFactory<T>): T {
  const { mode, colors } = useTheme();
  return useMemo(() => {
    const factory = make as StyleFactory<unknown>;
    let byMode = sheetCache.get(factory);
    if (!byMode) {
      byMode = {};
      sheetCache.set(factory, byMode);
    }
    if (!byMode[mode]) {
      byMode[mode] = StyleSheet.create(make(colors));
    }
    return byMode[mode] as T;
  }, [make, mode, colors]);
}