@slidejs/runner 0.1.0

package/.turbo/turbo-build.log

@@ -0,0 +1,19 @@
+
+> @slidejs/runner@0.1.0 build /Volumes/ORICO/ws/prj/slidejs/slidejs/packages/@slidejs/runner
+> vite build
+
+vite v5.4.21 building for production...
+transforming...
+✓ 3 modules transformed.
+rendering chunks...
+
+[vite:dts] Start generate declaration files...
+computing gzip size...
+dist/index.js  6.44 kB │ gzip: 2.33 kB │ map: 14.50 kB
+[vite:dts] Start rollup declaration files...
+Analysis will use the bundled TypeScript version 5.4.2
+*** The target project appears to use TypeScript 5.9.3 which is newer than the bundled compiler engine; consider upgrading API Extractor.
+[vite:dts] Declaration files built in 2123ms.
+
+dist/index.cjs  3.85 kB │ gzip: 1.32 kB │ map: 13.56 kB
+✓ built in 2.24s

package/.turbo/turbo-test.log

@@ -0,0 +1,14 @@
+
+> @slidejs/runner@0.1.0 test /Volumes/ORICO/ws/prj/slidejs/slidejs/packages/@slidejs/runner
+> vitest run
+
+
+ RUN  v1.6.1 /Volumes/ORICO/ws/prj/slidejs/slidejs/packages/@slidejs/runner
+
+ ✓ src/__tests__/runner.test.ts  (28 tests) 73ms
+
+ Test Files  1 passed (1)
+      Tests  28 passed (28)
+   Start at  20:49:56
+   Duration  2.42s (transform 100ms, setup 0ms, collect 134ms, tests 73ms, environment 685ms, prepare 175ms)
+

package/.turbo/turbo-typecheck.log

@@ -0,0 +1,4 @@
+
+> @slidejs/runner@0.1.0 typecheck /Volumes/ORICO/ws/prj/slidejs/slidejs/packages/@slidejs/runner
+> tsc --noEmit
+

package/dist/index.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("@slidejs/core");class r extends Error{constructor(e,t){super(e),this.code=t,this.name="SlideRunnerError",Object.setPrototypeOf(this,r.prototype)}}class o{constructor(e){if(this.slides=[],this.currentIndex=0,this.isInitialized=!1,!e.adapter)throw new r("Adapter is required","MISSING_ADAPTER");this.adapter=e.adapter,this.plugins=e.plugins??[],this.container=this.resolveContainer(e.container),this.adapterOptions=e.adapterOptions,this.setupAdapterEventListeners()}async run(e,t){try{const i=new a.SlideEngine(e);this.slides=i.generate(t),await this.executePluginHook("beforeRender",this.slides),this.isInitialized||(await this.adapter.initialize(this.container,this.adapterOptions),this.isInitialized=!0),await this.adapter.render(this.slides),await this.executePluginHook("afterRender",this.slides),this.currentIndex=0}catch(i){const s=i instanceof Error?i.message:String(i);throw new r(`Failed to run slides: ${s}`,"RUN_FAILED")}}async renderSlides(e){try{this.slides=e,await this.executePluginHook("beforeRender",this.slides),this.isInitialized||(await this.adapter.initialize(this.container,this.adapterOptions),this.isInitialized=!0),await this.adapter.render(this.slides),await this.executePluginHook("afterRender",this.slides),this.currentIndex=0}catch(t){const i=t instanceof Error?t.message:String(t);throw new r(`Failed to render slides: ${i}`,"RENDER_FAILED")}}navigateTo(e){if(e<0||e>=this.slides.length)throw new r(`Invalid slide index: ${e}. Valid range: 0-${this.slides.length-1}`,"INVALID_INDEX");const t=this.currentIndex,i=e;this.executePluginHook("beforeSlideChange",t,i).then(()=>{this.adapter.navigateTo(e),this.currentIndex=e,this.executePluginHook("afterSlideChange",t,i).catch(s=>{console.error("Plugin afterSlideChange hook failed:",s)})})}play(){if(this.slides.length===0)throw new r("No slides to play. Call run() or renderSlides() first.","NO_SLIDES");if(!this.isInitialized)throw new r("Adapter not initialized. Call run() or renderSlides() first.","NOT_INITIALIZED");this.navigateTo(0)}getCurrentIndex(){return this.adapter.getCurrentIndex()}getTotalSlides(){return this.adapter.getTotalSlides()}async updateSlide(e,t){if(!this.adapter.updateSlide)throw new r(`Adapter "${this.adapter.name}" does not support updateSlide`,"UNSUPPORTED_OPERATION");if(e<0||e>=this.slides.length)throw new r(`Invalid slide index: ${e}. Valid range: 0-${this.slides.length-1}`,"INVALID_INDEX");try{this.slides[e]=t,await this.adapter.updateSlide(e,t)}catch(i){const s=i instanceof Error?i.message:String(i);throw new r(`Failed to update slide: ${s}`,"UPDATE_FAILED")}}async refresh(){try{await this.adapter.render(this.slides)}catch(e){const t=e instanceof Error?e.message:String(e);throw new r(`Failed to refresh slides: ${t}`,"REFRESH_FAILED")}}async destroy(){try{await this.adapter.destroy(),this.slides=[],this.currentIndex=0,this.isInitialized=!1}catch(e){const t=e instanceof Error?e.message:String(e);throw new r(`Failed to destroy runner: ${t}`,"DESTROY_FAILED")}}on(e,t){this.adapter.on(e,t)}off(e,t){this.adapter.off(e,t)}resolveContainer(e){if(typeof e=="string"){const t=document.querySelector(e);if(!t)throw new r(`Container element not found: ${e}`,"CONTAINER_NOT_FOUND");return t}if(!(e instanceof HTMLElement))throw new r("Container must be an HTMLElement or a valid selector","INVALID_CONTAINER");return e}async executePluginHook(e,...t){for(const i of this.plugins){const s=i[e];if(typeof s=="function")try{await s.apply(i,t)}catch(n){console.error(`Plugin "${i.name}" ${String(e)} hook failed:`,n)}}}setupAdapterEventListeners(){this.adapter.on("slideChanged",e=>{typeof e=="object"&&e!==null&&"index"in e&&(this.currentIndex=e.index)})}}exports.SlideRunner=o;exports.SlideRunnerError=r;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/errors.ts","../src/runner.ts"],"sourcesContent":["/**\n * @slidejs/runner - 错误处理\n *\n * 定义 SlideRunner 相关的错误类\n */\n\n/**\n * SlideRunner 错误类\n */\nexport class SlideRunnerError extends Error {\n  /**\n   * @param message - 错误消息\n   * @param code - 错误代码（可选）\n   */\n  constructor(message: string, public code?: string) {\n    super(message);\n    this.name = 'SlideRunnerError';\n    // 保持正确的原型链\n    Object.setPrototypeOf(this, SlideRunnerError.prototype);\n  }\n}\n","/**\n * @slidejs/runner - SlideRunner 核心类\n *\n * 提供幻灯片运行时的核心功能，包括适配器管理、插件系统和生命周期控制\n */\n\nimport type { SlideDSL, SlideDefinition } from '@slidejs/core';\nimport { SlideEngine } from '@slidejs/core';\nimport type { SlideContext } from '@slidejs/context';\nimport type {\n  SlideAdapter,\n  SlideRunnerConfig,\n  SlideRunnerPlugin,\n  AdapterEvent,\n  EventHandler,\n  AdapterOptions,\n} from './types';\nimport { SlideRunnerError } from './errors';\n\n/**\n * SlideRunner 核心类\n *\n * 负责协调 SlideEngine、SlideAdapter 和插件系统，提供完整的幻灯片运行时环境\n */\nexport class SlideRunner<TContext extends SlideContext = SlideContext> {\n  private adapter: SlideAdapter;\n  private plugins: SlideRunnerPlugin[];\n  private container: HTMLElement;\n  private adapterOptions?: AdapterOptions;\n  private slides: SlideDefinition[] = [];\n  private currentIndex = 0;\n  private isInitialized = false;\n\n  /**\n   * 创建 SlideRunner 实例\n   *\n   * @param config - SlideRunner 配置\n   * @throws {SlideRunnerError} 如果配置无效\n   */\n  constructor(config: SlideRunnerConfig) {\n    // 验证配置\n    if (!config.adapter) {\n      throw new SlideRunnerError('Adapter is required', 'MISSING_ADAPTER');\n    }\n\n    this.adapter = config.adapter;\n    this.plugins = config.plugins ?? [];\n    this.container = this.resolveContainer(config.container);\n    this.adapterOptions = config.adapterOptions;\n\n    // 设置适配器事件监听\n    this.setupAdapterEventListeners();\n  }\n\n  /**\n   * 运行幻灯片演示\n   *\n   * 完整流程：\n   * 1. 使用 SlideEngine 生成幻灯片\n   * 2. 执行 beforeRender 插件钩子\n   * 3. 初始化适配器\n   * 4. 渲染幻灯片\n   * 5. 执行 afterRender 插件钩子\n   *\n   * @param dsl - Slide DSL 对象\n   * @param context - 幻灯片上下文数据\n   */\n  async run(dsl: SlideDSL<TContext>, context: TContext): Promise<void> {\n    try {\n      // 1. 使用 SlideEngine 生成幻灯片\n      const engine = new SlideEngine(dsl);\n      this.slides = engine.generate(context);\n\n      // 2. 执行 beforeRender 插件钩子\n      await this.executePluginHook('beforeRender', this.slides);\n\n      // 3. 初始化适配器（如果尚未初始化）\n      if (!this.isInitialized) {\n        await this.adapter.initialize(this.container, this.adapterOptions);\n        this.isInitialized = true;\n      }\n\n      // 4. 渲染幻灯片\n      await this.adapter.render(this.slides);\n\n      // 5. 执行 afterRender 插件钩子\n      await this.executePluginHook('afterRender', this.slides);\n\n      // 重置当前索引\n      this.currentIndex = 0;\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error ? error.message : String(error);\n      throw new SlideRunnerError(\n        `Failed to run slides: ${errorMessage}`,\n        'RUN_FAILED'\n      );\n    }\n  }\n\n  /**\n   * 直接渲染幻灯片数组\n   *\n   * 跳过 SlideEngine 生成步骤，直接渲染提供的幻灯片\n   *\n   * @param slides - 幻灯片定义数组\n   */\n  async renderSlides(slides: SlideDefinition[]): Promise<void> {\n    try {\n      this.slides = slides;\n\n      // 执行 beforeRender 插件钩子\n      await this.executePluginHook('beforeRender', this.slides);\n\n      // 初始化适配器（如果尚未初始化）\n      if (!this.isInitialized) {\n        await this.adapter.initialize(this.container, this.adapterOptions);\n        this.isInitialized = true;\n      }\n\n      // 渲染幻灯片\n      await this.adapter.render(this.slides);\n\n      // 执行 afterRender 插件钩子\n      await this.executePluginHook('afterRender', this.slides);\n\n      // 重置当前索引\n      this.currentIndex = 0;\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error ? error.message : String(error);\n      throw new SlideRunnerError(\n        `Failed to render slides: ${errorMessage}`,\n        'RENDER_FAILED'\n      );\n    }\n  }\n\n  /**\n   * 导航到指定幻灯片\n   *\n   * 执行 beforeSlideChange 和 afterSlideChange 插件钩子\n   *\n   * @param index - 目标幻灯片索引\n   * @throws {SlideRunnerError} 如果索引超出范围\n   */\n  navigateTo(index: number): void {\n    if (index < 0 || index >= this.slides.length) {\n      throw new SlideRunnerError(\n        `Invalid slide index: ${index}. Valid range: 0-${this.slides.length - 1}`,\n        'INVALID_INDEX'\n      );\n    }\n\n    const fromIndex = this.currentIndex;\n    const toIndex = index;\n\n    // 执行 beforeSlideChange 插件钩子（同步）\n    this.executePluginHook('beforeSlideChange', fromIndex, toIndex).then(\n      () => {\n        // 调用适配器导航\n        this.adapter.navigateTo(index);\n        this.currentIndex = index;\n\n        // 执行 afterSlideChange 插件钩子（异步）\n        this.executePluginHook('afterSlideChange', fromIndex, toIndex).catch(\n          (error) => {\n            console.error('Plugin afterSlideChange hook failed:', error);\n          }\n        );\n      }\n    );\n  }\n\n  /**\n   * 播放/启动演示文稿\n   *\n   * 导航到第一张幻灯片（索引 0），开始演示\n   */\n  play(): void {\n    if (this.slides.length === 0) {\n      throw new SlideRunnerError(\n        'No slides to play. Call run() or renderSlides() first.',\n        'NO_SLIDES'\n      );\n    }\n\n    if (!this.isInitialized) {\n      throw new SlideRunnerError(\n        'Adapter not initialized. Call run() or renderSlides() first.',\n        'NOT_INITIALIZED'\n      );\n    }\n\n    // 导航到第一张幻灯片\n    this.navigateTo(0);\n  }\n\n  /**\n   * 获取当前幻灯片索引\n   */\n  getCurrentIndex(): number {\n    return this.adapter.getCurrentIndex();\n  }\n\n  /**\n   * 获取幻灯片总数\n   */\n  getTotalSlides(): number {\n    return this.adapter.getTotalSlides();\n  }\n\n  /**\n   * 更新指定幻灯片\n   *\n   * 仅当适配器支持 updateSlide 方法时可用\n   *\n   * @param index - 幻灯片索引\n   * @param slide - 新的幻灯片定义\n   * @throws {SlideRunnerError} 如果适配器不支持更新\n   */\n  async updateSlide(index: number, slide: SlideDefinition): Promise<void> {\n    if (!this.adapter.updateSlide) {\n      throw new SlideRunnerError(\n        `Adapter \"${this.adapter.name}\" does not support updateSlide`,\n        'UNSUPPORTED_OPERATION'\n      );\n    }\n\n    if (index < 0 || index >= this.slides.length) {\n      throw new SlideRunnerError(\n        `Invalid slide index: ${index}. Valid range: 0-${this.slides.length - 1}`,\n        'INVALID_INDEX'\n      );\n    }\n\n    try {\n      // 更新内部状态\n      this.slides[index] = slide;\n\n      // 调用适配器更新\n      await this.adapter.updateSlide(index, slide);\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error ? error.message : String(error);\n      throw new SlideRunnerError(\n        `Failed to update slide: ${errorMessage}`,\n        'UPDATE_FAILED'\n      );\n    }\n  }\n\n  /**\n   * 刷新当前幻灯片\n   *\n   * 重新渲染所有幻灯片\n   */\n  async refresh(): Promise<void> {\n    try {\n      await this.adapter.render(this.slides);\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error ? error.message : String(error);\n      throw new SlideRunnerError(\n        `Failed to refresh slides: ${errorMessage}`,\n        'REFRESH_FAILED'\n      );\n    }\n  }\n\n  /**\n   * 销毁 SlideRunner，清理资源\n   */\n  async destroy(): Promise<void> {\n    try {\n      await this.adapter.destroy();\n      this.slides = [];\n      this.currentIndex = 0;\n      this.isInitialized = false;\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error ? error.message : String(error);\n      throw new SlideRunnerError(\n        `Failed to destroy runner: ${errorMessage}`,\n        'DESTROY_FAILED'\n      );\n    }\n  }\n\n  /**\n   * 注册事件监听器\n   *\n   * @param event - 事件类型\n   * @param handler - 事件处理器\n   */\n  on(event: AdapterEvent, handler: EventHandler): void {\n    this.adapter.on(event, handler);\n  }\n\n  /**\n   * 移除事件监听器\n   *\n   * @param event - 事件类型\n   * @param handler - 事件处理器\n   */\n  off(event: AdapterEvent, handler: EventHandler): void {\n    this.adapter.off(event, handler);\n  }\n\n  /**\n   * 解析容器元素\n   *\n   * @param container - 容器元素或选择器\n   * @returns 解析后的 HTMLElement\n   * @throws {SlideRunnerError} 如果容器无效或找不到\n   */\n  private resolveContainer(container: HTMLElement | string): HTMLElement {\n    if (typeof container === 'string') {\n      const element = document.querySelector<HTMLElement>(container);\n      if (!element) {\n        throw new SlideRunnerError(\n          `Container element not found: ${container}`,\n          'CONTAINER_NOT_FOUND'\n        );\n      }\n      return element;\n    }\n\n    if (!(container instanceof HTMLElement)) {\n      throw new SlideRunnerError(\n        'Container must be an HTMLElement or a valid selector',\n        'INVALID_CONTAINER'\n      );\n    }\n\n    return container;\n  }\n\n  /**\n   * 执行插件钩子\n   *\n   * @param hookName - 钩子名称\n   * @param args - 钩子参数\n   */\n  private async executePluginHook(\n    hookName: keyof SlideRunnerPlugin,\n    ...args: unknown[]\n  ): Promise<void> {\n    for (const plugin of this.plugins) {\n      const hook = plugin[hookName];\n      if (typeof hook === 'function') {\n        try {\n          // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          await (hook as any).apply(plugin, args);\n        } catch (error) {\n          console.error(\n            `Plugin \"${plugin.name}\" ${String(hookName)} hook failed:`,\n            error\n          );\n          // 插件错误不应阻止流程继续\n        }\n      }\n    }\n  }\n\n  /**\n   * 设置适配器事件监听\n   */\n  private setupAdapterEventListeners(): void {\n    // 监听 slideChanged 事件，更新内部状态\n    this.adapter.on('slideChanged', (data) => {\n      if (typeof data === 'object' && data !== null && 'index' in data) {\n        this.currentIndex = data.index as number;\n      }\n    });\n  }\n}\n"],"names":["SlideRunnerError","message","code","SlideRunner","config","dsl","context","engine","SlideEngine","error","errorMessage","slides","index","fromIndex","toIndex","slide","event","handler","container","element","hookName","args","plugin","hook","data"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,283 @@
+import { SlideContext } from '@slidejs/context';
+import { SlideDefinition } from '@slidejs/core';
+import { SlideDSL } from '@slidejs/core';
+
+/**
+ * 适配器事件类型
+ */
+export declare type AdapterEvent = 'slideChanged' | 'slideRendered' | 'ready' | 'error';
+
+/**
+ * 适配器选项基础接口
+ */
+export declare interface AdapterOptions {
+    [key: string]: unknown;
+}
+
+/**
+ * 事件处理器
+ */
+export declare type EventHandler = (data: unknown) => void;
+
+/**
+ * SlideAdapter 接口
+ *
+ * 所有渲染引擎适配器必须实现此接口
+ */
+export declare interface SlideAdapter {
+    /**
+     * 适配器名称
+     */
+    readonly name: string;
+    /**
+     * 初始化适配器
+     *
+     * @param container - 容器元素
+     * @param options - 适配器选项
+     */
+    initialize(container: HTMLElement, options?: AdapterOptions): Promise<void>;
+    /**
+     * 渲染幻灯片
+     *
+     * @param slides - 幻灯片定义数组
+     */
+    render(slides: SlideDefinition[]): Promise<void>;
+    /**
+     * 销毁适配器，清理资源
+     */
+    destroy(): Promise<void>;
+    /**
+     * 导航到指定幻灯片
+     *
+     * @param index - 幻灯片索引
+     */
+    navigateTo(index: number): void;
+    /**
+     * 获取当前幻灯片索引
+     */
+    getCurrentIndex(): number;
+    /**
+     * 获取幻灯片总数
+     */
+    getTotalSlides(): number;
+    /**
+     * 更新指定幻灯片（可选）
+     *
+     * @param index - 幻灯片索引
+     * @param slide - 新的幻灯片定义
+     */
+    updateSlide?(index: number, slide: SlideDefinition): Promise<void>;
+    /**
+     * 注册事件监听器
+     *
+     * @param event - 事件类型
+     * @param handler - 事件处理器
+     */
+    on(event: AdapterEvent, handler: EventHandler): void;
+    /**
+     * 移除事件监听器
+     *
+     * @param event - 事件类型
+     * @param handler - 事件处理器
+     */
+    off(event: AdapterEvent, handler: EventHandler): void;
+}
+
+/**
+ * SlideRunner 核心类
+ *
+ * 负责协调 SlideEngine、SlideAdapter 和插件系统，提供完整的幻灯片运行时环境
+ */
+export declare class SlideRunner<TContext extends SlideContext = SlideContext> {
+    private adapter;
+    private plugins;
+    private container;
+    private adapterOptions?;
+    private slides;
+    private currentIndex;
+    private isInitialized;
+    /**
+     * 创建 SlideRunner 实例
+     *
+     * @param config - SlideRunner 配置
+     * @throws {SlideRunnerError} 如果配置无效
+     */
+    constructor(config: SlideRunnerConfig);
+    /**
+     * 运行幻灯片演示
+     *
+     * 完整流程：
+     * 1. 使用 SlideEngine 生成幻灯片
+     * 2. 执行 beforeRender 插件钩子
+     * 3. 初始化适配器
+     * 4. 渲染幻灯片
+     * 5. 执行 afterRender 插件钩子
+     *
+     * @param dsl - Slide DSL 对象
+     * @param context - 幻灯片上下文数据
+     */
+    run(dsl: SlideDSL<TContext>, context: TContext): Promise<void>;
+    /**
+     * 直接渲染幻灯片数组
+     *
+     * 跳过 SlideEngine 生成步骤，直接渲染提供的幻灯片
+     *
+     * @param slides - 幻灯片定义数组
+     */
+    renderSlides(slides: SlideDefinition[]): Promise<void>;
+    /**
+     * 导航到指定幻灯片
+     *
+     * 执行 beforeSlideChange 和 afterSlideChange 插件钩子
+     *
+     * @param index - 目标幻灯片索引
+     * @throws {SlideRunnerError} 如果索引超出范围
+     */
+    navigateTo(index: number): void;
+    /**
+     * 播放/启动演示文稿
+     *
+     * 导航到第一张幻灯片（索引 0），开始演示
+     */
+    play(): void;
+    /**
+     * 获取当前幻灯片索引
+     */
+    getCurrentIndex(): number;
+    /**
+     * 获取幻灯片总数
+     */
+    getTotalSlides(): number;
+    /**
+     * 更新指定幻灯片
+     *
+     * 仅当适配器支持 updateSlide 方法时可用
+     *
+     * @param index - 幻灯片索引
+     * @param slide - 新的幻灯片定义
+     * @throws {SlideRunnerError} 如果适配器不支持更新
+     */
+    updateSlide(index: number, slide: SlideDefinition): Promise<void>;
+    /**
+     * 刷新当前幻灯片
+     *
+     * 重新渲染所有幻灯片
+     */
+    refresh(): Promise<void>;
+    /**
+     * 销毁 SlideRunner，清理资源
+     */
+    destroy(): Promise<void>;
+    /**
+     * 注册事件监听器
+     *
+     * @param event - 事件类型
+     * @param handler - 事件处理器
+     */
+    on(event: AdapterEvent, handler: EventHandler): void;
+    /**
+     * 移除事件监听器
+     *
+     * @param event - 事件类型
+     * @param handler - 事件处理器
+     */
+    off(event: AdapterEvent, handler: EventHandler): void;
+    /**
+     * 解析容器元素
+     *
+     * @param container - 容器元素或选择器
+     * @returns 解析后的 HTMLElement
+     * @throws {SlideRunnerError} 如果容器无效或找不到
+     */
+    private resolveContainer;
+    /**
+     * 执行插件钩子
+     *
+     * @param hookName - 钩子名称
+     * @param args - 钩子参数
+     */
+    private executePluginHook;
+    /**
+     * 设置适配器事件监听
+     */
+    private setupAdapterEventListeners;
+}
+
+/**
+ * SlideRunner 配置
+ */
+export declare interface SlideRunnerConfig {
+    /**
+     * 容器元素或选择器
+     */
+    container: HTMLElement | string;
+    /**
+     * 渲染引擎适配器
+     */
+    adapter: SlideAdapter;
+    /**
+     * 适配器选项
+     */
+    adapterOptions?: AdapterOptions;
+    /**
+     * 插件数组
+     */
+    plugins?: SlideRunnerPlugin[];
+}
+
+/**
+ * @slidejs/runner - 错误处理
+ *
+ * 定义 SlideRunner 相关的错误类
+ */
+/**
+ * SlideRunner 错误类
+ */
+export declare class SlideRunnerError extends Error {
+    code?: string | undefined;
+    /**
+     * @param message - 错误消息
+     * @param code - 错误代码（可选）
+     */
+    constructor(message: string, code?: string | undefined);
+}
+
+/**
+ * SlideRunner 插件接口
+ *
+ * 插件可以在 SlideRunner 的生命周期钩子中执行自定义逻辑
+ */
+export declare interface SlideRunnerPlugin {
+    /**
+     * 插件名称
+     */
+    name: string;
+    /**
+     * 渲染前钩子
+     *
+     * @param slides - 即将渲染的幻灯片数组
+     */
+    beforeRender?(slides: SlideDefinition[]): Promise<void> | void;
+    /**
+     * 渲染后钩子
+     *
+     * @param slides - 已渲染的幻灯片数组
+     */
+    afterRender?(slides: SlideDefinition[]): Promise<void> | void;
+    /**
+     * 幻灯片切换前钩子
+     *
+     * @param fromIndex - 当前幻灯片索引
+     * @param toIndex - 目标幻灯片索引
+     */
+    beforeSlideChange?(fromIndex: number, toIndex: number): Promise<void> | void;
+    /**
+     * 幻灯片切换后钩子
+     *
+     * @param fromIndex - 上一张幻灯片索引
+     * @param toIndex - 当前幻灯片索引
+     */
+    afterSlideChange?(fromIndex: number, toIndex: number): Promise<void> | void;
+}
+
+export { }

package/dist/index.js

@@ -0,0 +1,256 @@
+import { SlideEngine as a } from "@slidejs/core";
+class r extends Error {
+  /**
+   * @param message - 错误消息
+   * @param code - 错误代码（可选）
+   */
+  constructor(e, t) {
+    super(e), this.code = t, this.name = "SlideRunnerError", Object.setPrototypeOf(this, r.prototype);
+  }
+}
+class l {
+  /**
+   * 创建 SlideRunner 实例
+   *
+   * @param config - SlideRunner 配置
+   * @throws {SlideRunnerError} 如果配置无效
+   */
+  constructor(e) {
+    if (this.slides = [], this.currentIndex = 0, this.isInitialized = !1, !e.adapter)
+      throw new r("Adapter is required", "MISSING_ADAPTER");
+    this.adapter = e.adapter, this.plugins = e.plugins ?? [], this.container = this.resolveContainer(e.container), this.adapterOptions = e.adapterOptions, this.setupAdapterEventListeners();
+  }
+  /**
+   * 运行幻灯片演示
+   *
+   * 完整流程：
+   * 1. 使用 SlideEngine 生成幻灯片
+   * 2. 执行 beforeRender 插件钩子
+   * 3. 初始化适配器
+   * 4. 渲染幻灯片
+   * 5. 执行 afterRender 插件钩子
+   *
+   * @param dsl - Slide DSL 对象
+   * @param context - 幻灯片上下文数据
+   */
+  async run(e, t) {
+    try {
+      const i = new a(e);
+      this.slides = i.generate(t), await this.executePluginHook("beforeRender", this.slides), this.isInitialized || (await this.adapter.initialize(this.container, this.adapterOptions), this.isInitialized = !0), await this.adapter.render(this.slides), await this.executePluginHook("afterRender", this.slides), this.currentIndex = 0;
+    } catch (i) {
+      const s = i instanceof Error ? i.message : String(i);
+      throw new r(
+        `Failed to run slides: ${s}`,
+        "RUN_FAILED"
+      );
+    }
+  }
+  /**
+   * 直接渲染幻灯片数组
+   *
+   * 跳过 SlideEngine 生成步骤，直接渲染提供的幻灯片
+   *
+   * @param slides - 幻灯片定义数组
+   */
+  async renderSlides(e) {
+    try {
+      this.slides = e, await this.executePluginHook("beforeRender", this.slides), this.isInitialized || (await this.adapter.initialize(this.container, this.adapterOptions), this.isInitialized = !0), await this.adapter.render(this.slides), await this.executePluginHook("afterRender", this.slides), this.currentIndex = 0;
+    } catch (t) {
+      const i = t instanceof Error ? t.message : String(t);
+      throw new r(
+        `Failed to render slides: ${i}`,
+        "RENDER_FAILED"
+      );
+    }
+  }
+  /**
+   * 导航到指定幻灯片
+   *
+   * 执行 beforeSlideChange 和 afterSlideChange 插件钩子
+   *
+   * @param index - 目标幻灯片索引
+   * @throws {SlideRunnerError} 如果索引超出范围
+   */
+  navigateTo(e) {
+    if (e < 0 || e >= this.slides.length)
+      throw new r(
+        `Invalid slide index: ${e}. Valid range: 0-${this.slides.length - 1}`,
+        "INVALID_INDEX"
+      );
+    const t = this.currentIndex, i = e;
+    this.executePluginHook("beforeSlideChange", t, i).then(
+      () => {
+        this.adapter.navigateTo(e), this.currentIndex = e, this.executePluginHook("afterSlideChange", t, i).catch(
+          (s) => {
+            console.error("Plugin afterSlideChange hook failed:", s);
+          }
+        );
+      }
+    );
+  }
+  /**
+   * 播放/启动演示文稿
+   *
+   * 导航到第一张幻灯片（索引 0），开始演示
+   */
+  play() {
+    if (this.slides.length === 0)
+      throw new r(
+        "No slides to play. Call run() or renderSlides() first.",
+        "NO_SLIDES"
+      );
+    if (!this.isInitialized)
+      throw new r(
+        "Adapter not initialized. Call run() or renderSlides() first.",
+        "NOT_INITIALIZED"
+      );
+    this.navigateTo(0);
+  }
+  /**
+   * 获取当前幻灯片索引
+   */
+  getCurrentIndex() {
+    return this.adapter.getCurrentIndex();
+  }
+  /**
+   * 获取幻灯片总数
+   */
+  getTotalSlides() {
+    return this.adapter.getTotalSlides();
+  }
+  /**
+   * 更新指定幻灯片
+   *
+   * 仅当适配器支持 updateSlide 方法时可用
+   *
+   * @param index - 幻灯片索引
+   * @param slide - 新的幻灯片定义
+   * @throws {SlideRunnerError} 如果适配器不支持更新
+   */
+  async updateSlide(e, t) {
+    if (!this.adapter.updateSlide)
+      throw new r(
+        `Adapter "${this.adapter.name}" does not support updateSlide`,
+        "UNSUPPORTED_OPERATION"
+      );
+    if (e < 0 || e >= this.slides.length)
+      throw new r(
+        `Invalid slide index: ${e}. Valid range: 0-${this.slides.length - 1}`,
+        "INVALID_INDEX"
+      );
+    try {
+      this.slides[e] = t, await this.adapter.updateSlide(e, t);
+    } catch (i) {
+      const s = i instanceof Error ? i.message : String(i);
+      throw new r(
+        `Failed to update slide: ${s}`,
+        "UPDATE_FAILED"
+      );
+    }
+  }
+  /**
+   * 刷新当前幻灯片
+   *
+   * 重新渲染所有幻灯片
+   */
+  async refresh() {
+    try {
+      await this.adapter.render(this.slides);
+    } catch (e) {
+      const t = e instanceof Error ? e.message : String(e);
+      throw new r(
+        `Failed to refresh slides: ${t}`,
+        "REFRESH_FAILED"
+      );
+    }
+  }
+  /**
+   * 销毁 SlideRunner，清理资源
+   */
+  async destroy() {
+    try {
+      await this.adapter.destroy(), this.slides = [], this.currentIndex = 0, this.isInitialized = !1;
+    } catch (e) {
+      const t = e instanceof Error ? e.message : String(e);
+      throw new r(
+        `Failed to destroy runner: ${t}`,
+        "DESTROY_FAILED"
+      );
+    }
+  }
+  /**
+   * 注册事件监听器
+   *
+   * @param event - 事件类型
+   * @param handler - 事件处理器
+   */
+  on(e, t) {
+    this.adapter.on(e, t);
+  }
+  /**
+   * 移除事件监听器
+   *
+   * @param event - 事件类型
+   * @param handler - 事件处理器
+   */
+  off(e, t) {
+    this.adapter.off(e, t);
+  }
+  /**
+   * 解析容器元素
+   *
+   * @param container - 容器元素或选择器
+   * @returns 解析后的 HTMLElement
+   * @throws {SlideRunnerError} 如果容器无效或找不到
+   */
+  resolveContainer(e) {
+    if (typeof e == "string") {
+      const t = document.querySelector(e);
+      if (!t)
+        throw new r(
+          `Container element not found: ${e}`,
+          "CONTAINER_NOT_FOUND"
+        );
+      return t;
+    }
+    if (!(e instanceof HTMLElement))
+      throw new r(
+        "Container must be an HTMLElement or a valid selector",
+        "INVALID_CONTAINER"
+      );
+    return e;
+  }
+  /**
+   * 执行插件钩子
+   *
+   * @param hookName - 钩子名称
+   * @param args - 钩子参数
+   */
+  async executePluginHook(e, ...t) {
+    for (const i of this.plugins) {
+      const s = i[e];
+      if (typeof s == "function")
+        try {
+          await s.apply(i, t);
+        } catch (n) {
+          console.error(
+            `Plugin "${i.name}" ${String(e)} hook failed:`,
+            n
+          );
+        }
+    }
+  }
+  /**
+   * 设置适配器事件监听
+   */
+  setupAdapterEventListeners() {
+    this.adapter.on("slideChanged", (e) => {
+      typeof e == "object" && e !== null && "index" in e && (this.currentIndex = e.index);
+    });
+  }
+}
+export {
+  l as SlideRunner,
+  r as SlideRunnerError
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/errors.ts","../src/runner.ts"],"sourcesContent":["/**\n * @slidejs/runner - 错误处理\n *\n * 定义 SlideRunner 相关的错误类\n */\n\n/**\n * SlideRunner 错误类\n */\nexport class SlideRunnerError extends Error {\n  /**\n   * @param message - 错误消息\n   * @param code - 错误代码（可选）\n   */\n  constructor(message: string, public code?: string) {\n    super(message);\n    this.name = 'SlideRunnerError';\n    // 保持正确的原型链\n    Object.setPrototypeOf(this, SlideRunnerError.prototype);\n  }\n}\n","/**\n * @slidejs/runner - SlideRunner 核心类\n *\n * 提供幻灯片运行时的核心功能，包括适配器管理、插件系统和生命周期控制\n */\n\nimport type { SlideDSL, SlideDefinition } from '@slidejs/core';\nimport { SlideEngine } from '@slidejs/core';\nimport type { SlideContext } from '@slidejs/context';\nimport type {\n  SlideAdapter,\n  SlideRunnerConfig,\n  SlideRunnerPlugin,\n  AdapterEvent,\n  EventHandler,\n  AdapterOptions,\n} from './types';\nimport { SlideRunnerError } from './errors';\n\n/**\n * SlideRunner 核心类\n *\n * 负责协调 SlideEngine、SlideAdapter 和插件系统，提供完整的幻灯片运行时环境\n */\nexport class SlideRunner<TContext extends SlideContext = SlideContext> {\n  private adapter: SlideAdapter;\n  private plugins: SlideRunnerPlugin[];\n  private container: HTMLElement;\n  private adapterOptions?: AdapterOptions;\n  private slides: SlideDefinition[] = [];\n  private currentIndex = 0;\n  private isInitialized = false;\n\n  /**\n   * 创建 SlideRunner 实例\n   *\n   * @param config - SlideRunner 配置\n   * @throws {SlideRunnerError} 如果配置无效\n   */\n  constructor(config: SlideRunnerConfig) {\n    // 验证配置\n    if (!config.adapter) {\n      throw new SlideRunnerError('Adapter is required', 'MISSING_ADAPTER');\n    }\n\n    this.adapter = config.adapter;\n    this.plugins = config.plugins ?? [];\n    this.container = this.resolveContainer(config.container);\n    this.adapterOptions = config.adapterOptions;\n\n    // 设置适配器事件监听\n    this.setupAdapterEventListeners();\n  }\n\n  /**\n   * 运行幻灯片演示\n   *\n   * 完整流程：\n   * 1. 使用 SlideEngine 生成幻灯片\n   * 2. 执行 beforeRender 插件钩子\n   * 3. 初始化适配器\n   * 4. 渲染幻灯片\n   * 5. 执行 afterRender 插件钩子\n   *\n   * @param dsl - Slide DSL 对象\n   * @param context - 幻灯片上下文数据\n   */\n  async run(dsl: SlideDSL<TContext>, context: TContext): Promise<void> {\n    try {\n      // 1. 使用 SlideEngine 生成幻灯片\n      const engine = new SlideEngine(dsl);\n      this.slides = engine.generate(context);\n\n      // 2. 执行 beforeRender 插件钩子\n      await this.executePluginHook('beforeRender', this.slides);\n\n      // 3. 初始化适配器（如果尚未初始化）\n      if (!this.isInitialized) {\n        await this.adapter.initialize(this.container, this.adapterOptions);\n        this.isInitialized = true;\n      }\n\n      // 4. 渲染幻灯片\n      await this.adapter.render(this.slides);\n\n      // 5. 执行 afterRender 插件钩子\n      await this.executePluginHook('afterRender', this.slides);\n\n      // 重置当前索引\n      this.currentIndex = 0;\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error ? error.message : String(error);\n      throw new SlideRunnerError(\n        `Failed to run slides: ${errorMessage}`,\n        'RUN_FAILED'\n      );\n    }\n  }\n\n  /**\n   * 直接渲染幻灯片数组\n   *\n   * 跳过 SlideEngine 生成步骤，直接渲染提供的幻灯片\n   *\n   * @param slides - 幻灯片定义数组\n   */\n  async renderSlides(slides: SlideDefinition[]): Promise<void> {\n    try {\n      this.slides = slides;\n\n      // 执行 beforeRender 插件钩子\n      await this.executePluginHook('beforeRender', this.slides);\n\n      // 初始化适配器（如果尚未初始化）\n      if (!this.isInitialized) {\n        await this.adapter.initialize(this.container, this.adapterOptions);\n        this.isInitialized = true;\n      }\n\n      // 渲染幻灯片\n      await this.adapter.render(this.slides);\n\n      // 执行 afterRender 插件钩子\n      await this.executePluginHook('afterRender', this.slides);\n\n      // 重置当前索引\n      this.currentIndex = 0;\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error ? error.message : String(error);\n      throw new SlideRunnerError(\n        `Failed to render slides: ${errorMessage}`,\n        'RENDER_FAILED'\n      );\n    }\n  }\n\n  /**\n   * 导航到指定幻灯片\n   *\n   * 执行 beforeSlideChange 和 afterSlideChange 插件钩子\n   *\n   * @param index - 目标幻灯片索引\n   * @throws {SlideRunnerError} 如果索引超出范围\n   */\n  navigateTo(index: number): void {\n    if (index < 0 || index >= this.slides.length) {\n      throw new SlideRunnerError(\n        `Invalid slide index: ${index}. Valid range: 0-${this.slides.length - 1}`,\n        'INVALID_INDEX'\n      );\n    }\n\n    const fromIndex = this.currentIndex;\n    const toIndex = index;\n\n    // 执行 beforeSlideChange 插件钩子（同步）\n    this.executePluginHook('beforeSlideChange', fromIndex, toIndex).then(\n      () => {\n        // 调用适配器导航\n        this.adapter.navigateTo(index);\n        this.currentIndex = index;\n\n        // 执行 afterSlideChange 插件钩子（异步）\n        this.executePluginHook('afterSlideChange', fromIndex, toIndex).catch(\n          (error) => {\n            console.error('Plugin afterSlideChange hook failed:', error);\n          }\n        );\n      }\n    );\n  }\n\n  /**\n   * 播放/启动演示文稿\n   *\n   * 导航到第一张幻灯片（索引 0），开始演示\n   */\n  play(): void {\n    if (this.slides.length === 0) {\n      throw new SlideRunnerError(\n        'No slides to play. Call run() or renderSlides() first.',\n        'NO_SLIDES'\n      );\n    }\n\n    if (!this.isInitialized) {\n      throw new SlideRunnerError(\n        'Adapter not initialized. Call run() or renderSlides() first.',\n        'NOT_INITIALIZED'\n      );\n    }\n\n    // 导航到第一张幻灯片\n    this.navigateTo(0);\n  }\n\n  /**\n   * 获取当前幻灯片索引\n   */\n  getCurrentIndex(): number {\n    return this.adapter.getCurrentIndex();\n  }\n\n  /**\n   * 获取幻灯片总数\n   */\n  getTotalSlides(): number {\n    return this.adapter.getTotalSlides();\n  }\n\n  /**\n   * 更新指定幻灯片\n   *\n   * 仅当适配器支持 updateSlide 方法时可用\n   *\n   * @param index - 幻灯片索引\n   * @param slide - 新的幻灯片定义\n   * @throws {SlideRunnerError} 如果适配器不支持更新\n   */\n  async updateSlide(index: number, slide: SlideDefinition): Promise<void> {\n    if (!this.adapter.updateSlide) {\n      throw new SlideRunnerError(\n        `Adapter \"${this.adapter.name}\" does not support updateSlide`,\n        'UNSUPPORTED_OPERATION'\n      );\n    }\n\n    if (index < 0 || index >= this.slides.length) {\n      throw new SlideRunnerError(\n        `Invalid slide index: ${index}. Valid range: 0-${this.slides.length - 1}`,\n        'INVALID_INDEX'\n      );\n    }\n\n    try {\n      // 更新内部状态\n      this.slides[index] = slide;\n\n      // 调用适配器更新\n      await this.adapter.updateSlide(index, slide);\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error ? error.message : String(error);\n      throw new SlideRunnerError(\n        `Failed to update slide: ${errorMessage}`,\n        'UPDATE_FAILED'\n      );\n    }\n  }\n\n  /**\n   * 刷新当前幻灯片\n   *\n   * 重新渲染所有幻灯片\n   */\n  async refresh(): Promise<void> {\n    try {\n      await this.adapter.render(this.slides);\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error ? error.message : String(error);\n      throw new SlideRunnerError(\n        `Failed to refresh slides: ${errorMessage}`,\n        'REFRESH_FAILED'\n      );\n    }\n  }\n\n  /**\n   * 销毁 SlideRunner，清理资源\n   */\n  async destroy(): Promise<void> {\n    try {\n      await this.adapter.destroy();\n      this.slides = [];\n      this.currentIndex = 0;\n      this.isInitialized = false;\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error ? error.message : String(error);\n      throw new SlideRunnerError(\n        `Failed to destroy runner: ${errorMessage}`,\n        'DESTROY_FAILED'\n      );\n    }\n  }\n\n  /**\n   * 注册事件监听器\n   *\n   * @param event - 事件类型\n   * @param handler - 事件处理器\n   */\n  on(event: AdapterEvent, handler: EventHandler): void {\n    this.adapter.on(event, handler);\n  }\n\n  /**\n   * 移除事件监听器\n   *\n   * @param event - 事件类型\n   * @param handler - 事件处理器\n   */\n  off(event: AdapterEvent, handler: EventHandler): void {\n    this.adapter.off(event, handler);\n  }\n\n  /**\n   * 解析容器元素\n   *\n   * @param container - 容器元素或选择器\n   * @returns 解析后的 HTMLElement\n   * @throws {SlideRunnerError} 如果容器无效或找不到\n   */\n  private resolveContainer(container: HTMLElement | string): HTMLElement {\n    if (typeof container === 'string') {\n      const element = document.querySelector<HTMLElement>(container);\n      if (!element) {\n        throw new SlideRunnerError(\n          `Container element not found: ${container}`,\n          'CONTAINER_NOT_FOUND'\n        );\n      }\n      return element;\n    }\n\n    if (!(container instanceof HTMLElement)) {\n      throw new SlideRunnerError(\n        'Container must be an HTMLElement or a valid selector',\n        'INVALID_CONTAINER'\n      );\n    }\n\n    return container;\n  }\n\n  /**\n   * 执行插件钩子\n   *\n   * @param hookName - 钩子名称\n   * @param args - 钩子参数\n   */\n  private async executePluginHook(\n    hookName: keyof SlideRunnerPlugin,\n    ...args: unknown[]\n  ): Promise<void> {\n    for (const plugin of this.plugins) {\n      const hook = plugin[hookName];\n      if (typeof hook === 'function') {\n        try {\n          // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          await (hook as any).apply(plugin, args);\n        } catch (error) {\n          console.error(\n            `Plugin \"${plugin.name}\" ${String(hookName)} hook failed:`,\n            error\n          );\n          // 插件错误不应阻止流程继续\n        }\n      }\n    }\n  }\n\n  /**\n   * 设置适配器事件监听\n   */\n  private setupAdapterEventListeners(): void {\n    // 监听 slideChanged 事件，更新内部状态\n    this.adapter.on('slideChanged', (data) => {\n      if (typeof data === 'object' && data !== null && 'index' in data) {\n        this.currentIndex = data.index as number;\n      }\n    });\n  }\n}\n"],"names":["SlideRunnerError","message","code","SlideRunner","config","dsl","context","engine","SlideEngine","error","errorMessage","slides","index","fromIndex","toIndex","slide","event","handler","container","element","hookName","args","plugin","hook","data"],"mappings":"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"}