数据库 Hooks

import { useDatabaseInit } from '@linch-tech/desktop-core';

function App() {
  const { isReady, error } = useDatabaseInit();

  if (error) {
    return <div>数据库初始化失败: {error.message}</div>;
  }

  if (!isReady) {
    return <div>正在初始化数据库...</div>;
  }

  return <MainApp />;
}

interface UseDatabaseInit {
  isReady: boolean;   // 数据库是否就绪
  error: Error | null; // 初始化错误
}

useDatabaseInit(options?: DatabaseInitOptions)

interface DatabaseInitOptions {
  name?: string;           // 数据库名（默认 'app.db'）
  migrations?: Migration[]; // 迁移列表
}

import { useSetting } from '@linch-tech/desktop-core';

function SettingsPage() {
  const { value, setValue, isLoading, error } = useSetting<string>('theme', {
    defaultValue: 'light',
  });

  if (isLoading) return <div>加载中...</div>;

  return (
    <select
      value={value ?? 'light'}
      onChange={(e) => setValue(e.target.value)}
    >
      <option value="light">浅色</option>
      <option value="dark">深色</option>
    </select>
  );
}

interface UseSettingReturn<T> {
  value: T | null;                    // 当前值
  setValue: (value: T) => Promise<void>; // 更新值
  isLoading: boolean;                 // 是否加载中
  error: Error | null;                // 错误信息
}

useSetting<T>(key: string, options?: UseSettingOptions<T>)

interface UseSettingOptions<T> {
  defaultValue?: T;  // 默认值
}

// 布尔值设置
const { value: notifications, setValue: setNotifications } = useSetting<boolean>(
  'notifications',
  { defaultValue: true }
);

// JSON 对象设置
interface UserPreferences {
  fontSize: number;
  sidebarOpen: boolean;
}

const { value: prefs, setValue: setPrefs } = useSetting<UserPreferences>(
  'preferences',
  { defaultValue: { fontSize: 14, sidebarOpen: true } }
);

import { useAppState } from '@linch-tech/desktop-core';

function Sidebar() {
  const { state: isOpen, setState: setIsOpen, isLoading } = useAppState<boolean>(
    'sidebarOpen',
    true
  );

  if (isLoading) return null;

  return (
    <aside style={{ width: isOpen ? 200 : 50 }}>
      <button onClick={() => setIsOpen(!isOpen)}>
        {isOpen ? '收起' : '展开'}
      </button>
    </aside>
  );
}

interface UseAppStateReturn<T> {
  state: T | null;                     // 当前状态
  setState: (value: T) => Promise<void>; // 更新状态
  isLoading: boolean;                  // 是否加载中
}

useAppState<T>(key: string, defaultValue?: T)

-- settings 表
INSERT INTO settings (key, value) VALUES ('theme', '"dark"');

-- app_state 表
INSERT INTO app_state (key, value) VALUES ('sidebarOpen', 'true');