@xz-summer/summer-types 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 夏至
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,75 @@
+# @xz-summer/summer-types
+
+TypeScript type definitions for Summer plugin development.
+
+> 📖 [中文文档](./README.md)
+
+## Installation
+
+```bash
+npm install @xz-summer/summer-types --save-dev
+# or
+pnpm add @xz-summer/summer-types -D
+```
+
+## Usage
+
+```typescript
+import type { PluginContext, SettingItem, LifecycleHook } from '@xz-summer/summer-types'
+
+export default class MyPlugin {
+  ctx!: PluginContext
+  manifest!: PluginManifest
+  
+  async onLoad(): Promise<void> {
+    // Full TypeScript support for your plugin
+    this.ctx.settings.register([
+      {
+        key: 'myOption',
+        label: 'My Option',
+        type: 'boolean',
+        default: true
+      }
+    ])
+  }
+  
+  onUnload(): void {
+    // Cleanup
+  }
+}
+```
+
+## Available Types
+
+### Core Types
+- `PluginContext` - Plugin context with all available APIs
+- `PluginManifest` - Plugin manifest definition
+- `SummerPlugin` - Base plugin class (for reference)
+
+### Lifecycle Types
+- `LifecycleHook` - All available lifecycle hooks
+- `LifecycleHandler` - Lifecycle handler function type
+
+### Settings Types
+- `SettingItem` - Setting item definition
+- `SettingType` - Available setting types
+- `SettingOption` - Setting option for select type
+- `SettingRegisterOptions` - Options for registering settings
+
+### API Types
+- `EventAPI` - Event system API
+- `SlotAPI` - UI slot system API
+- `StorageAPI` - Storage API
+- `CommandAPI` - Command API
+- `SettingsAPI` - Settings API
+- `ServiceAPI` - Service API
+- `EditorAPI` - Editor API
+- `LifecycleAPI` - Lifecycle API
+
+## Documentation
+
+For full documentation, visit: [Summer Plugin Development Guide](https://gitee.com/xiazhi926459/summer)
+
+## License
+
+MIT

package/README.md

@@ -0,0 +1,75 @@
+# @xz-summer/summer-types
+
+Summer 插件开发 TypeScript 类型定义包。
+
+> 📖 [English Documentation](./README.en.md)
+
+## 安装
+
+```bash
+npm install @xz-summer/summer-types --save-dev
+# 或
+pnpm add @xz-summer/summer-types -D
+```
+
+## 使用
+
+```typescript
+import type { PluginContext, SettingItem, LifecycleHook } from '@xz-summer/summer-types'
+
+export default class MyPlugin {
+  ctx!: PluginContext
+  manifest!: PluginManifest
+  
+  async onLoad(): Promise<void> {
+    // 完整的 TypeScript 类型支持
+    this.ctx.settings.register([
+      {
+        key: 'myOption',
+        label: '我的选项',
+        type: 'boolean',
+        default: true
+      }
+    ])
+  }
+  
+  onUnload(): void {
+    // 清理资源
+  }
+}
+```
+
+## 可用类型
+
+### 核心类型
+- `PluginContext` - 插件上下文，包含所有可用 API
+- `PluginManifest` - 插件清单定义
+- `SummerPlugin` - 插件基类（参考用）
+
+### 生命周期类型
+- `LifecycleHook` - 所有可用的生命周期钩子
+- `LifecycleHandler` - 生命周期处理函数类型
+
+### 设置类型
+- `SettingItem` - 设置项定义
+- `SettingType` - 可用的设置类型
+- `SettingOption` - 选择类型的选项
+- `SettingRegisterOptions` - 注册设置的选项
+
+### API 类型
+- `EventAPI` - 事件系统 API
+- `SlotAPI` - UI 插槽系统 API
+- `StorageAPI` - 存储 API
+- `CommandAPI` - 命令 API
+- `SettingsAPI` - 设置 API
+- `ServiceAPI` - 服务 API
+- `EditorAPI` - 编辑器 API
+- `LifecycleAPI` - 生命周期 API
+
+## 文档
+
+完整文档请访问：[Summer 插件开发指南](https://gitee.com/xiazhi926459/summer)
+
+## 许可证
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @xz-summer/summer-types
+ *
+ * TypeScript type definitions for Summer plugin development
+ */
+export type { LifecycleHook, LifecycleHandler } from './lifecycle';
+export type { SettingType, SettingOption, SettingItem, SettingRegisterOptions, CustomSettingsPage, SettingsTab } from './settings';
+export { PluginPriority, PluginType } from './plugin';
+export type { Permission, PluginManifest, ViewMode, SlotName, SlotRegisterOptions, SlotContentType, TabConfig, TabContext, EventAPI, SlotAPI, TabAPI, StorageAPI, CommandAPI, SettingsAPI, ServiceAPI, EditorConfigAPI, EditorAPI, LifecycleAPI, AppContext, EditorConfigContext, EditorReadyContext, PluginContext, ISummerPlugin } from './plugin';
+/**
+ * Milkdown 核心依赖已包含在 @xz-summer/summer-types 的 dependencies 中
+ *
+ * 插件开发者可以直接从各自的包导入需要的类型和功能：
+ *
+ * @example
+ * ```typescript
+ * import { emoji } from '@milkdown/plugin-emoji'
+ * import type { Editor } from '@milkdown/core'
+ * ```
+ *
+ * 由于 TypeScript 的类型解析机制，只要 dependencies 中包含了这些包，
+ * 插件开发者就能获得完整的类型提示，无需在此处重新导出。
+ */
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAGlE,YAAY,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACX,sBAAsB,EACtB,kBAAkB,EAClB,WAAW,EACZ,MAAM,YAAY,CAAA;AAGnB,OAAO,EACL,cAAc,EACd,UAAU,EACX,MAAM,UAAU,CAAA;AAEjB,YAAY,EACV,UAAU,EACV,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,mBAAmB,EACnB,eAAe,EACf,SAAS,EACT,UAAU,EACV,QAAQ,EACR,OAAO,EACP,MAAM,EACN,UAAU,EACV,UAAU,EACV,WAAW,EACX,UAAU,EACV,eAAe,EACf,SAAS,EACT,YAAY,EACZ,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACd,MAAM,UAAU,CAAA;AAEjB;;;;;;;;;;;;;GAaG"}

package/dist/index.js

@@ -0,0 +1,22 @@
+/**
+ * @xz-summer/summer-types
+ *
+ * TypeScript type definitions for Summer plugin development
+ */
+// 导出插件类型
+export { PluginPriority, PluginType } from './plugin';
+/**
+ * Milkdown 核心依赖已包含在 @xz-summer/summer-types 的 dependencies 中
+ *
+ * 插件开发者可以直接从各自的包导入需要的类型和功能：
+ *
+ * @example
+ * ```typescript
+ * import { emoji } from '@milkdown/plugin-emoji'
+ * import type { Editor } from '@milkdown/core'
+ * ```
+ *
+ * 由于 TypeScript 的类型解析机制，只要 dependencies 中包含了这些包，
+ * 插件开发者就能获得完整的类型提示，无需在此处重新导出。
+ */
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH,SAAS;AACT,OAAO,EACL,cAAc,EACd,UAAU,EACX,MAAM,UAAU,CAAA;AA4BjB;;;;;;;;;;;;;GAaG"}

package/dist/lifecycle.d.ts

@@ -0,0 +1,140 @@
+/**
+ * 生命周期系统类型定义
+ *
+ * 定义 Summer 应用的完整生命周期钩子
+ */
+/**
+ * 生命周期钩子类型
+ *
+ * 包含应用级、Editor 级和插件级的所有生命周期钩子
+ */
+export type LifecycleHook = 
+/**
+ * 应用初始化前
+ *
+ * 触发时机：应用启动时，最早的钩子
+ * 典型用途：设置全局配置、初始化外部服务连接、加载必需的资源
+ * 注意：此时其他插件尚未加载，不要依赖其他插件的功能
+ */
+'app:beforeInit'
+/**
+ * 应用初始化中
+ *
+ * 触发时机：核心插件（Theme、Layout）加载时
+ * 典型用途：注册核心服务、设置基础配置、初始化核心功能
+ * 注意：此时核心插件正在加载，可以访问部分核心服务
+ */
+ | 'app:init'
+/**
+ * 应用初始化后
+ *
+ * 触发时机：核心插件加载完成后，功能插件加载前
+ * 典型用途：访问核心服务（Theme、Layout 等）、注册依赖核心功能的组件
+ * 注意：此时核心插件已就绪，但功能插件尚未加载
+ */
+ | 'app:afterInit'
+/**
+ * 应用就绪前
+ *
+ * 触发时机：功能插件加载时，应用完全就绪前
+ * 典型用途：最后的准备工作、检查依赖是否满足、预加载资源
+ * 注意：此时大部分插件已加载，即将进入就绪状态
+ */
+ | 'app:beforeReady'
+/**
+ * 应用就绪
+ *
+ * 触发时机：所有插件加载完成，应用完全就绪
+ * 典型用途：启动后台任务、显示欢迎界面、开始监控和统计、恢复上次会话
+ * 注意：此时应用已完全就绪，所有功能都可用
+ */
+ | 'app:ready'
+/**
+ * 应用销毁前
+ *
+ * 触发时机：应用关闭前，资源清理前
+ * 典型用途：保存用户数据、保存应用状态、清理临时文件、断开外部连接、停止后台任务
+ * 注意：这是保存数据的最后机会，务必完成所有保存操作
+ */
+ | 'app:beforeDestroy'
+/**
+ * 应用销毁中
+ *
+ * 触发时机：应用销毁过程中，即将完全关闭
+ * 典型用途：最终的资源释放、清理全局状态、记录关闭日志
+ * 注意：此时应用即将关闭，只做必要的清理工作
+ */
+ | 'app:destroy'
+/**
+ * Editor 创建前
+ *
+ * 触发时机：Editor 实例创建前
+ * 典型用途：注册 Milkdown 配置（editorCore.config()）、注册 Milkdown 插件（editorCore.use()）
+ * 注意：这是唯一可以调用 editorCore.use() 和 editorCore.config() 的时机
+ */
+ | 'editor:beforeCreate'
+/**
+ * Editor 创建后
+ *
+ * 触发时机：Editor 实例已创建，但可能还在初始化
+ * 典型用途：访问 Editor 实例、设置 Editor 监听器、初始化与 Editor 相关的状态
+ * 注意：Editor 可能还在初始化，某些操作可能不稳定
+ */
+ | 'editor:created'
+/**
+ * Editor 就绪
+ *
+ * 触发时机：Editor 完全就绪，可以安全操作
+ * 典型用途：操作 Editor 内容、执行 Editor 命令、设置光标位置、加载文档内容
+ * 注意：这是操作 Editor 的推荐时机
+ */
+ | 'editor:ready'
+/**
+ * Editor 销毁前
+ *
+ * 触发时机：Editor 即将销毁
+ * 典型用途：保存编辑器状态、保存文档内容、清理 Editor 相关资源、取消 Editor 监听器
+ * 注意：这是访问 Editor 的最后机会
+ */
+ | 'editor:beforeDestroy'
+/**
+ * Editor 已销毁
+ *
+ * 触发时机：Editor 已销毁
+ * 典型用途：最终的编辑器相关清理、重置编辑器相关状态
+ * 注意：此时 Editor 已不可用
+ */
+ | 'editor:destroyed'
+/**
+ * 插件加载前
+ *
+ * 触发时机：插件即将加载
+ * 典型用途：插件加载前的准备工作
+ */
+ | 'plugin:beforeLoad'
+/**
+ * 插件已加载
+ *
+ * 触发时机：插件已成功加载
+ * 典型用途：通知其他插件某个插件已加载
+ */
+ | 'plugin:loaded'
+/**
+ * 插件卸载前
+ *
+ * 触发时机：插件即将卸载
+ * 典型用途：插件卸载前的清理工作
+ */
+ | 'plugin:beforeUnload'
+/**
+ * 插件已卸载
+ *
+ * 触发时机：插件已卸载
+ * 典型用途：通知其他插件某个插件已卸载
+ */
+ | 'plugin:unloaded';
+/**
+ * 生命周期钩子处理函数
+ */
+export type LifecycleHandler = (context?: any) => void | Promise<void>;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,MAAM,MAAM,aAAa;AAGvB;;;;;;GAMG;AACD,gBAAgB;AAElB;;;;;;GAMG;GACD,UAAU;AAEZ;;;;;;GAMG;GACD,eAAe;AAEjB;;;;;;GAMG;GACD,iBAAiB;AAEnB;;;;;;GAMG;GACD,WAAW;AAEb;;;;;;GAMG;GACD,mBAAmB;AAErB;;;;;;GAMG;GACD,aAAa;AAIf;;;;;;GAMG;GACD,qBAAqB;AAEvB;;;;;;GAMG;GACD,gBAAgB;AAElB;;;;;;GAMG;GACD,cAAc;AAEhB;;;;;;GAMG;GACD,sBAAsB;AAExB;;;;;;GAMG;GACD,kBAAkB;AAIpB;;;;;GAKG;GACD,mBAAmB;AAErB;;;;;GAKG;GACD,eAAe;AAEjB;;;;;GAKG;GACD,qBAAqB;AAEvB;;;;;GAKG;GACD,iBAAiB,CAAA;AAErB;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA"}

package/dist/lifecycle.js

@@ -0,0 +1,7 @@
+/**
+ * 生命周期系统类型定义
+ *
+ * 定义 Summer 应用的完整生命周期钩子
+ */
+export {};
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/plugin.d.ts

@@ -0,0 +1,436 @@
+/**
+ * 插件系统类型定义
+ */
+import type { LifecycleHook } from './lifecycle';
+import type { SettingItem, SettingRegisterOptions, CustomSettingsPage, SettingsTab } from './settings';
+import type { Component } from 'vue';
+/** 插件优先级 */
+export declare enum PluginPriority {
+    SYSTEM = 0,
+    CORE = 100,
+    UI = 200,
+    FEATURE = 300,
+    USER = 1000
+}
+/** 插件类型 */
+export declare enum PluginType {
+    CORE = "core",// 核心插件，不可卸载
+    UI = "ui",// UI 插件，可卸载
+    FEATURE = "feature",// 功能插件，可卸载
+    EXTENSION = "extension"
+}
+/** 权限类型 */
+export type Permission = 'editor' | 'editor:syntax' | 'ui:toolbar' | 'ui:sidebar' | 'ui:statusbar' | 'ui:modal' | 'ui:layout' | 'theme' | 'commands' | 'storage' | 'fs' | 'fs:read' | 'fs:write' | 'network' | 'ai';
+/** 插件清单 */
+export interface PluginManifest {
+    id: string;
+    name: string;
+    version: string;
+    description?: string;
+    author?: string;
+    homepage?: string;
+    repository?: string;
+    license?: string;
+    main?: string;
+    styles?: string;
+    type?: PluginType;
+    unloadable?: boolean;
+    requiresRestart?: boolean;
+    priority?: PluginPriority;
+    permissions?: Permission[];
+    dependencies?: Record<string, string>;
+    minAppVersion?: string;
+}
+/** 编辑器视图模式 */
+export type ViewMode = 'preview' | 'source' | 'split';
+/** 插槽名称 */
+export type SlotName = 'root' | 'titlebar-left' | 'titlebar-center' | 'titlebar-right' | 'toolbar-left' | 'toolbar-center' | 'toolbar-right' | 'sidebar-left' | 'sidebar-right' | 'editor-left' | 'editor' | 'editor-right' | 'editor-toolbar' | 'panel-bottom' | 'statusbar-left' | 'statusbar-right' | 'modal';
+/** 插槽注册选项 */
+export interface SlotRegisterOptions {
+    id?: string;
+    order?: number;
+    props?: Record<string, any>;
+    /** 独占模式：替换而非追加 */
+    exclusive?: boolean;
+}
+/** 插槽内容类型 - 支持多种框架 */
+export type SlotContentType = Component | HTMLElement | string | (() => HTMLElement) | {
+    render: () => HTMLElement;
+};
+/** Tab 配置 */
+export interface TabConfig {
+    /** Tab ID（不含插件前缀） */
+    id: string;
+    /** Tab 标题 */
+    label: string;
+    /** Tab 图标 */
+    icon?: string;
+    /** Tab 组件（工厂函数，接收 TabContext） */
+    component: (ctx: TabContext) => Component;
+    /** 排序权重 */
+    order?: number;
+    /** 是否默认激活 */
+    defaultActive?: boolean;
+}
+/**
+ * Tab 上下文 - 组件通过此上下文访问 API
+ *
+ * 提供统一的 API 访问方式，避免直接使用全局函数
+ */
+export interface TabContext {
+    /** 服务 API */
+    services: ServiceAPI;
+    /** 事件 API */
+    events: EventAPI;
+    /** 插槽 API */
+    slots: SlotAPI;
+    /** 便捷方法：获取服务 */
+    getService<T>(serviceId: string): T | undefined;
+    /** 便捷方法：发送事件 */
+    emit(event: string, payload?: any): void;
+    /** 便捷方法：监听事件（返回取消监听函数） */
+    on(event: string, handler: (payload: any) => void): () => void;
+}
+/** 事件 API */
+export interface EventAPI {
+    emit(event: string, payload?: any): void;
+    on(event: string, handler: (payload: any) => void): () => void;
+    once(event: string, handler: (payload: any) => void): () => void;
+}
+/** 插槽 API */
+export interface SlotAPI {
+    register(slot: SlotName, content: SlotContentType, options?: SlotRegisterOptions): void;
+    unregister(slot: SlotName, componentId: string): void;
+}
+/** Tab API */
+export interface TabAPI {
+    /**
+     * 注册侧边栏 Tab
+     */
+    register(config: TabConfig): void;
+    /**
+     * 取消注册 Tab
+     */
+    unregister(tabId: string): void;
+}
+/** 存储 API */
+export interface StorageAPI {
+    get<T>(key: string, defaultValue?: T): Promise<T>;
+    set<T>(key: string, value: T): Promise<void>;
+    delete(key: string): Promise<void>;
+}
+/** 命令 API */
+export interface CommandAPI {
+    register(id: string, options: {
+        name: string;
+        shortcut?: string;
+        handler: () => void;
+    }): void;
+    execute(id: string): void;
+}
+/** 设置 API */
+export interface SettingsAPI {
+    /**
+     * 注册设置项
+     */
+    register(items: SettingItem[], options?: SettingRegisterOptions): void;
+    /**
+     * 获取设置值
+     */
+    get<T>(key: string): T;
+    /**
+     * 设置值
+     */
+    set<T>(key: string, value: T): void;
+    /**
+     * 获取所有设置值
+     */
+    getAll(): Record<string, any>;
+    /**
+     * 获取设置项定义
+     */
+    getItems(): SettingItem[];
+    /**
+     * 重置设置项
+     */
+    reset(key: string): void;
+    /**
+     * 重置所有设置
+     */
+    resetAll(): void;
+    /**
+     * 监听设置变更
+     */
+    onChange(key: string, handler: (value: any) => void): () => void;
+    /**
+     * 注册自定义设置页面
+     */
+    registerCustomPage(page: CustomSettingsPage): void;
+    /**
+     * 注册自定义标签页
+     */
+    registerTab(tab: Omit<SettingsTab, 'pluginId'>): void;
+}
+/** 服务 API */
+export interface ServiceAPI {
+    /** 注册服务 */
+    register<T>(serviceId: string, service: T): void;
+    /** 获取服务（可能为 undefined） */
+    get<T>(serviceId: string): T | undefined;
+    /** 等待服务就绪 */
+    waitFor<T>(serviceId: string): Promise<T>;
+    /** 检查服务是否存在 */
+    has(serviceId: string): boolean;
+    /** 取消注册服务 */
+    unregister(serviceId: string): void;
+}
+/** Editor 配置 API（仅在 onBeforeEditorCreate 阶段可用） */
+export interface EditorConfigAPI {
+    /**
+     * 注册 Milkdown 配置
+     */
+    config(configFn: (ctx: any) => void): void;
+    /**
+     * 注册 Milkdown 插件
+     */
+    use(plugin: any): void;
+    /**
+     * 配置 Crepe 选项
+     */
+    configureCrepe(options: any): void;
+    /**
+     * 添加 CodeMirror 扩展
+     */
+    addCodeMirrorExtension(extension: any): void;
+}
+/** Editor 完整 API（Editor 创建后可用） */
+export interface EditorAPI extends EditorConfigAPI {
+    /**
+     * 获取 Milkdown Editor 实例
+     */
+    getMilkdown(): any;
+    /**
+     * 获取 Milkdown 内容
+     */
+    getMilkdownContent(): string;
+    /**
+     * 设置 Milkdown 内容
+     */
+    setMilkdownContent(content: string): void;
+    /**
+     * 获取 CodeMirror EditorView 实例
+     */
+    getCodeMirror(): any;
+    /**
+     * 获取 CodeMirror 内容
+     */
+    getCodeMirrorContent(): string;
+    /**
+     * 设置 CodeMirror 内容
+     */
+    setCodeMirrorContent(content: string): void;
+    /**
+     * 检查 Milkdown 是否就绪
+     */
+    isMilkdownReady(): boolean;
+    /**
+     * 检查 CodeMirror 是否就绪
+     */
+    isCodeMirrorReady(): boolean;
+    /**
+     * 检查两个编辑器是否都就绪
+     */
+    isReady(): boolean;
+    /**
+     * 等待就绪
+     */
+    waitForReady(): Promise<any>;
+    /**
+     * 获取 Editor 实例（向后兼容，等同于 getMilkdown）
+     */
+    getEditor(): any;
+    /**
+     * 获取内容（默认从 Milkdown）
+     */
+    getContent(): string;
+    /**
+     * 设置内容（默认到 Milkdown）
+     */
+    setContent(content: string): void;
+    /**
+     * 监听内容变化
+     */
+    onContentChange(handler: (content: string) => void): () => void;
+    /**
+     * 启用双向同步（split 模式）
+     */
+    enableSync(): void;
+    /**
+     * 禁用双向同步（preview/source 模式）
+     */
+    disableSync(): void;
+    /**
+     * 设置焦点编辑器
+     */
+    setFocus(editor: 'milkdown' | 'codemirror' | null): void;
+    /**
+     * 获取当前焦点编辑器
+     */
+    getFocus(): 'milkdown' | 'codemirror' | null;
+}
+/** 生命周期 API */
+export interface LifecycleAPI {
+    /**
+     * 注册生命周期钩子
+     */
+    on(hook: LifecycleHook, handler: (context?: any) => void | Promise<void>): () => void;
+    /**
+     * 注册一次性钩子
+     */
+    once(hook: LifecycleHook, handler: (context?: any) => void | Promise<void>): void;
+}
+/**
+ * 基础应用上下文 - 应用初始化阶段
+ *
+ * 可访问：事件、存储、设置、插槽、命令、服务
+ */
+export interface AppContext {
+    /** 事件 API */
+    events: EventAPI;
+    /** 插槽 API */
+    slots: SlotAPI;
+    /** Tab API */
+    tabs: TabAPI;
+    /** 存储 API */
+    storage: StorageAPI;
+    /** 命令 API */
+    commands: CommandAPI;
+    /** 设置 API */
+    settings: SettingsAPI;
+    /** 服务 API */
+    services: ServiceAPI;
+    /** 生命周期 API */
+    lifecycle: LifecycleAPI;
+    /** 插件清单 */
+    manifest: PluginManifest;
+}
+/**
+ * Editor 配置上下文 - Editor 创建前
+ *
+ * 可访问：AppContext + Editor 配置 API
+ */
+export interface EditorConfigContext extends AppContext {
+    /** Editor 配置 API */
+    editor: EditorConfigAPI;
+}
+/**
+ * Editor 就绪上下文 - Editor 创建后
+ *
+ * 可访问：AppContext + 完整 Editor API
+ */
+export interface EditorReadyContext extends AppContext {
+    /** Editor 完整 API */
+    editor: EditorAPI;
+}
+/** 插件上下文（向后兼容，已废弃，请使用 AppContext/EditorConfigContext/EditorReadyContext） */
+export interface PluginContext extends EditorReadyContext {
+}
+/**
+ * Summer 插件接口
+ *
+ * 定义插件必须实现的契约
+ *
+ * 生命周期钩子通过参数类型明确可访问的资源：
+ * - AppContext: 应用级资源（events, storage, settings 等）
+ * - EditorConfigContext: AppContext + Editor 配置 API（use, config）
+ * - EditorReadyContext: AppContext + 完整 Editor API（getEditor, getContent 等）
+ */
+export interface ISummerPlugin {
+    /** 插件 ID */
+    readonly id?: string;
+    /** 插件清单 */
+    manifest?: PluginManifest;
+    /**
+     * 插件加载时调用
+     *
+     * @param ctx - 应用上下文（通过参数传递）
+     */
+    onLoad(ctx: AppContext): void | Promise<void>;
+    /**
+     * 插件卸载时调用
+     *
+     * @param ctx - 应用上下文
+     */
+    onUnload(ctx: AppContext): void;
+    /**
+     * 应用初始化前调用（最早的钩子）
+     */
+    onBeforeInit?(ctx: AppContext): void | Promise<void>;
+    /**
+     * 应用初始化中调用（核心插件加载时）
+     */
+    onInit?(ctx: AppContext): void | Promise<void>;
+    /**
+     * 应用初始化后调用（核心插件已加载）
+     */
+    onAfterInit?(ctx: AppContext): void | Promise<void>;
+    /**
+     * 应用就绪前调用（功能插件加载时）
+     */
+    onBeforeReady?(ctx: AppContext): void | Promise<void>;
+    /**
+     * 应用就绪后调用（所有插件已加载）
+     */
+    onReady?(ctx: AppContext): void | Promise<void>;
+    /**
+     * 应用销毁前调用（保存状态）
+     */
+    onBeforeDestroy?(ctx: AppContext): void | Promise<void>;
+    /**
+     * 应用销毁中调用（最后的清理）
+     */
+    onDestroy?(ctx: AppContext): void | Promise<void>;
+    /**
+     * Editor 创建前调用
+     *
+     * 此阶段可以：
+     * - 注册 Milkdown 插件 (ctx.editor.use)
+     * - 注册 Milkdown 配置 (ctx.editor.config)
+     *
+     * @param ctx - Editor 配置上下文
+     */
+    onBeforeEditorCreate?(ctx: EditorConfigContext): void | Promise<void>;
+    /**
+     * Editor 创建后调用
+     *
+     * 此阶段可以：
+     * - 访问 Editor 实例 (ctx.editor.getEditor)
+     * - 获取/设置内容 (ctx.editor.getContent/setContent)
+     *
+     * @param ctx - Editor 就绪上下文
+     */
+    onEditorCreated?(ctx: EditorReadyContext): void | Promise<void>;
+    /**
+     * Editor 就绪后调用
+     *
+     * 此阶段可以：
+     * - 访问 Editor 实例
+     * - 监听内容变化 (ctx.editor.onContentChange)
+     *
+     * @param ctx - Editor 就绪上下文
+     */
+    onEditorReady?(ctx: EditorReadyContext): void | Promise<void>;
+    /**
+     * Editor 销毁前调用
+     *
+     * @param ctx - Editor 就绪上下文
+     */
+    onBeforeEditorDestroy?(ctx: EditorReadyContext): void | Promise<void>;
+    /**
+     * Editor 已销毁后调用
+     *
+     * @param ctx - 应用上下文
+     */
+    onEditorDestroyed?(ctx: AppContext): void | Promise<void>;
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"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"}

package/dist/plugin.js

@@ -0,0 +1,21 @@
+/**
+ * 插件系统类型定义
+ */
+/** 插件优先级 */
+export var PluginPriority;
+(function (PluginPriority) {
+    PluginPriority[PluginPriority["SYSTEM"] = 0] = "SYSTEM";
+    PluginPriority[PluginPriority["CORE"] = 100] = "CORE";
+    PluginPriority[PluginPriority["UI"] = 200] = "UI";
+    PluginPriority[PluginPriority["FEATURE"] = 300] = "FEATURE";
+    PluginPriority[PluginPriority["USER"] = 1000] = "USER";
+})(PluginPriority || (PluginPriority = {}));
+/** 插件类型 */
+export var PluginType;
+(function (PluginType) {
+    PluginType["CORE"] = "core";
+    PluginType["UI"] = "ui";
+    PluginType["FEATURE"] = "feature";
+    PluginType["EXTENSION"] = "extension"; // 扩展插件，可卸载
+})(PluginType || (PluginType = {}));
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,YAAY;AACZ,MAAM,CAAN,IAAY,cAMX;AAND,WAAY,cAAc;IACxB,uDAAU,CAAA;IACV,qDAAU,CAAA;IACV,iDAAQ,CAAA;IACR,2DAAa,CAAA;IACb,sDAAW,CAAA;AACb,CAAC,EANW,cAAc,KAAd,cAAc,QAMzB;AAED,WAAW;AACX,MAAM,CAAN,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,2BAAa,CAAA;IACb,uBAAS,CAAA;IACT,iCAAmB,CAAA;IACnB,qCAAuB,CAAA,CAAE,WAAW;AACtC,CAAC,EALW,UAAU,KAAV,UAAU,QAKrB"}

package/dist/settings.d.ts

@@ -0,0 +1,101 @@
+/**
+ * 设置系统类型定义
+ */
+/**
+ * 设置类型
+ */
+export type SettingType = 'boolean' | 'number' | 'string' | 'select' | 'textarea' | 'file' | 'color' | 'slider' | 'hotkey' | 'custom';
+/**
+ * 选项定义
+ */
+export interface SettingOption {
+    /** 显示标签 */
+    label: string;
+    /** 选项值 */
+    value: any;
+    /** 描述信息 */
+    description?: string;
+}
+/**
+ * 设置项定义
+ */
+export interface SettingItem {
+    /** 设置键 */
+    key: string;
+    /** 显示标签 */
+    label: string;
+    /** 设置类型 */
+    type: SettingType;
+    /** 默认值 */
+    default: any;
+    /** 描述信息 */
+    description?: string;
+    /** 最小值（number 类型） */
+    min?: number;
+    /** 最大值（number 类型） */
+    max?: number;
+    /** 步长（number 类型） */
+    step?: number;
+    /** 选项列表（select 类型） */
+    options?: SettingOption[];
+    /** 占位符（string/textarea 类型） */
+    placeholder?: string;
+    /** 正则表达式验证（string 类型） */
+    pattern?: string;
+    /** 是否必填 */
+    required?: boolean;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 显示顺序 */
+    order?: number;
+    /** 自定义组件（custom 类型） */
+    component?: any;
+    /** 自定义组件属性 */
+    componentProps?: Record<string, any>;
+}
+/**
+ * 设置注册选项
+ */
+export interface SettingRegisterOptions {
+    /** 分类名称（默认使用插件名称） */
+    category?: string;
+    /** 分类图标 */
+    icon?: string;
+    /** 显示顺序 */
+    order?: number;
+}
+/**
+ * 自定义设置页面
+ */
+export interface CustomSettingsPage {
+    /** 页面 ID */
+    id: string;
+    /** 显示标签 */
+    label: string;
+    /** 图标 */
+    icon?: string;
+    /** 自定义组件 */
+    component: any;
+    /** 显示顺序 */
+    order?: number;
+    /** 所属分类 */
+    category?: string;
+}
+/**
+ * 设置标签页
+ */
+export interface SettingsTab {
+    /** 标签 ID */
+    id: string;
+    /** 显示标签 */
+    label: string;
+    /** 图标 */
+    icon?: string;
+    /** 标签组件 */
+    component: any;
+    /** 显示顺序 */
+    order?: number;
+    /** 插件 ID */
+    pluginId: string;
+}
+//# sourceMappingURL=settings.d.ts.map

package/dist/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,MAAM,GACN,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,QAAQ,CAAA;AAEZ;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW;IACX,KAAK,EAAE,MAAM,CAAA;IAEb,UAAU;IACV,KAAK,EAAE,GAAG,CAAA;IAEV,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU;IACV,GAAG,EAAE,MAAM,CAAA;IAEX,WAAW;IACX,KAAK,EAAE,MAAM,CAAA;IAEb,WAAW;IACX,IAAI,EAAE,WAAW,CAAA;IAEjB,UAAU;IACV,OAAO,EAAE,GAAG,CAAA;IAEZ,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,qBAAqB;IACrB,GAAG,CAAC,EAAE,MAAM,CAAA;IAEZ,qBAAqB;IACrB,GAAG,CAAC,EAAE,MAAM,CAAA;IAEZ,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb,sBAAsB;IACtB,OAAO,CAAC,EAAE,aAAa,EAAE,CAAA;IAEzB,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB,WAAW;IACX,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB,WAAW;IACX,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd,uBAAuB;IACvB,SAAS,CAAC,EAAE,GAAG,CAAA;IAEf,cAAc;IACd,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,YAAY;IACZ,EAAE,EAAE,MAAM,CAAA;IAEV,WAAW;IACX,KAAK,EAAE,MAAM,CAAA;IAEb,SAAS;IACT,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb,YAAY;IACZ,SAAS,EAAE,GAAG,CAAA;IAEd,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd,WAAW;IACX,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,YAAY;IACZ,EAAE,EAAE,MAAM,CAAA;IAEV,WAAW;IACX,KAAK,EAAE,MAAM,CAAA;IAEb,SAAS;IACT,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb,WAAW;IACX,SAAS,EAAE,GAAG,CAAA;IAEd,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd,YAAY;IACZ,QAAQ,EAAE,MAAM,CAAA;CACjB"}

package/dist/settings.js

@@ -0,0 +1,5 @@
+/**
+ * 设置系统类型定义
+ */
+export {};
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@xz-summer/summer-types",
+  "version": "1.0.0",
+  "description": "TypeScript type definitions for Summer plugin development | Summer 插件开发 TypeScript 类型定义",
+  "keywords": [
+    "summer",
+    "plugin",
+    "types",
+    "typescript",
+    "milkdown"
+  ],
+  "author": {
+    "name": "夏至",
+    "email": "1378511152@qq.com",
+    "url": "https://gitee.com/xiazhi926459"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://gitee.com/xiazhi926459/summer.git",
+    "directory": "npm-packages/summer-types"
+  },
+  "homepage": "https://gitee.com/xiazhi926459/summer/tree/master/npm-packages/summer-types",
+  "bugs": {
+    "url": "https://gitee.com/xiazhi926459/summer/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@milkdown/core": "^7.18.0",
+    "@milkdown/ctx": "^7.18.0",
+    "@milkdown/crepe": "^7.18.0",
+    "@milkdown/preset-commonmark": "^7.18.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "vue": "^3.5.13"
+  },
+  "peerDependenciesMeta": {
+    "vue": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch"
+  }
+}