插件API参考

interface Window {
  Blinko: {
    // 核心API
    api: typeof api;              // TRPC API客户端
    eventBus: typeof eventBus;    // 事件系统
    i18n: typeof i18n;           // 国际化
    version: string;             // Blinko版本
    toast: ToastPlugin;          // 提示通知
    
    // 存储访问
    store: {
      StorageState: typeof StorageState;
      PromiseState: typeof PromiseState;
      PromisePageState: typeof PromisePageState;
      blinkoStore: BlinkoStore;
      baseStore: BaseStore;
      hubStore: HubStore;
      resourceStore: ResourceStore;
    };
    
    // 实用函数
    globalRefresh: () => void;    // 刷新应用
  } & PluginApiStore;  // 插件API方法
}

type ToolbarIcon = {
  name: string;          // 图标的唯一标识符
  icon: string;          // 图标名称或URL
  tooltip: string;       // 悬停时显示的工具提示文本
  content: () => HTMLElement;  // 点击时显示的内容
  placement?: 'top' | 'bottom' | 'left' | 'right';  // 工具提示位置
  maxWidth?: number;     // 内容的最大宽度
};

// 使用示例
window.Blinko.addToolBarIcon({
  name: 'my-custom-tool',
  icon: 'settings',
  tooltip: 'My Custom Tool',
  content: () => {
    const div = document.createElement('div');
    div.innerHTML = 'Custom tool content';
    return div;
  },
  placement: 'bottom',
  maxWidth: 300
});

type RightClickMenu = {
  name: string;          // 菜单项的唯一标识符
  label: string;         // 显示文本
  icon?: string;         // 可选图标
  onClick: (note: Note) => void;  // 点击处理器
  disabled?: boolean;    // 菜单项是否禁用
};

// 使用示例
window.Blinko.addRightClickMenu({
  name: 'my-menu-item',
  label: 'My Custom Action',
  icon: 'star',
  onClick: (note) => {
    console.log('Clicked on note:', note);
  }
});

type DialogOptions = {
  title: string;         // 对话框标题
  content: () => HTMLElement;  // 对话框内容
};

// 使用示例
window.Blinko.showDialog({
  title: 'My Custom Dialog',
  content: () => {
    const div = document.createElement('div');
    div.innerHTML = 'Custom dialog content';
    return div;
  }
});

// 关闭对话框
window.Blinko.closeDialog();

// 添加自定义AI写作提示
window.Blinko.addAiWritePrompt(
  'My Custom Prompt',    // 名称
  'Write about...',      // 提示文本
  'magic-wand'           // 可选图标
);