refactor(web): adopt modular Vue architecture and isolate bearer sessions

web/src/common/plugin-api/index.d.ts

@@ -0,0 +1,89 @@
+import type { Extension } from '@codemirror/state'
+import type { MarkdownExtension } from '@lezer/markdown'
+
+export type Cleanup = () => void
+export type AsyncCleanup = () => void | Promise<void>
+export type Awaitable<T> = T | Promise<T>
+export type JSONValue = null | boolean | number | string | JSONValue[] | { [key: string]: JSONValue }
+
+export interface PluginManifest {
+  id: string
+  name: string
+  version: string
+  apiVersion: 1
+}
+
+export interface HostModules {
+  readonly '@codemirror/state': typeof import('@codemirror/state')
+  readonly '@codemirror/view': typeof import('@codemirror/view')
+  readonly '@codemirror/language': typeof import('@codemirror/language')
+  readonly '@codemirror/commands': typeof import('@codemirror/commands')
+  readonly '@lezer/common': typeof import('@lezer/common')
+  readonly '@lezer/markdown': typeof import('@lezer/markdown')
+  readonly '@lezer/highlight': typeof import('@lezer/highlight')
+}
+
+export interface PluginCommand {
+  id: string
+  title: string
+  /** 保留声明兼容；默认不绑定，请用户在设置中添加快捷键。 */
+  keys?: string[]
+  when?: () => boolean
+  run: () => Awaitable<void>
+}
+
+export interface MountContext {
+  container: HTMLElement
+  signal: AbortSignal
+}
+
+export interface PluginView {
+  id: string
+  title: string
+  mount: (context: MountContext) => Awaitable<void | AsyncCleanup>
+}
+
+export type CodeBlockRenderer = (context: MountContext & {
+  source: string
+  language: string
+  path: string
+  colorMode: 'light' | 'dark'
+}) => Awaitable<void | AsyncCleanup>
+
+export interface VaultEvents {
+  changed: { path: string, rev: string }
+  moved: { from: string, path: string }
+  deleted: { path: string }
+  resync: undefined
+}
+
+export interface PluginVault {
+  list: () => Promise<Array<{ path: string, dir: boolean, size: number, mtime: number }>>
+  read: (path: string) => Promise<{ content: string, rev: string }>
+  write: (path: string, content: string, options: { ifMatch: string } | { create: true }) => Promise<{ rev: string }>
+  on: <K extends keyof VaultEvents>(event: K, callback: (value: VaultEvents[K]) => Awaitable<void>) => Cleanup
+}
+
+export interface PluginWorkspace {
+  getActiveNote: () => { path: string, content: string, rev: string, dirty: boolean } | null
+  openNote: (path: string) => Promise<void>
+}
+
+export interface PluginAPI {
+  readonly manifest: Readonly<PluginManifest>
+  readonly signal: AbortSignal
+  readonly modules: HostModules
+  addCommand: (command: PluginCommand) => Cleanup
+  registerEditorExtension: (extension: Extension) => Cleanup
+  registerMarkdownSyntax: (extension: MarkdownExtension) => Cleanup
+  registerCodeBlockRenderer: (language: string, render: CodeBlockRenderer) => Cleanup
+  addSidebarView: (view: PluginView) => Cleanup
+  addSettingTab: (view: PluginView) => Cleanup
+  registerCleanup: (cleanup: AsyncCleanup) => Cleanup
+  readonly vault: PluginVault
+  readonly workspace: PluginWorkspace
+  readonly data: { load: () => Promise<JSONValue>, save: (value: JSONValue) => Promise<void> }
+  notice: (message: string) => void
+}
+
+export default function activate(api: PluginAPI): Awaitable<void | AsyncCleanup>