@slidejs/runner-revealjs 0.1.0

package/src/runner.ts

@@ -0,0 +1,84 @@
+/**
+ * @slidejs/runner-revealjs - SlideRunner 工厂函数
+ *
+ * 提供创建配置好的 SlideRunner 实例的便捷方法
+ */
+
+import { parseSlideDSL, compile } from '@slidejs/dsl';
+import { SlideRunner } from '@slidejs/runner';
+import type { SlideContext } from '@slidejs/context';
+import { RevealJsAdapter } from './adapter';
+import type { RevealJsOptions } from './types';
+
+/**
+ * SlideRunner 配置选项
+ */
+export interface SlideRunnerConfig {
+  /**
+   * 容器选择器或 HTMLElement
+   */
+  container: string | HTMLElement;
+
+  /**
+   * reveal.js 配置选项
+   */
+  revealOptions?: RevealJsOptions['revealConfig'];
+}
+
+/**
+ * 从 DSL 源代码创建并运行 SlideRunner
+ *
+ * @example
+ * ```typescript
+ * import { createSlideRunner } from '@slidejs/runner-revealjs';
+ *
+ * const dslSource = `
+ *   present quiz "demo" {
+ *     rules {
+ *       rule start "intro" {
+ *         slide {
+ *           content text { "Hello World!" }
+ *         }
+ *       }
+ *     }
+ *   }
+ * `;
+ *
+ * const context = { sourceType: 'quiz', sourceId: 'demo', items: [] };
+ * const runner = await createSlideRunner(dslSource, context, {
+ *   container: '#app',
+ *   revealOptions: {
+ *     controls: true,
+ *     progress: true,
+ *   },
+ * });
+ * ```
+ */
+export async function createSlideRunner<TContext extends SlideContext = SlideContext>(
+  dslSource: string,
+  context: TContext,
+  config: SlideRunnerConfig
+): Promise<SlideRunner<TContext>> {
+  // 1. 解析 DSL
+  const ast = await parseSlideDSL(dslSource);
+
+  // 2. 编译为 SlideDSL
+  const slideDSL = compile<TContext>(ast);
+
+  // 3. 创建适配器和 Runner
+  const adapter = new RevealJsAdapter();
+  const runner = new SlideRunner<TContext>({
+    container: config.container,
+    adapter,
+    adapterOptions: {
+      revealConfig: config.revealOptions,
+    },
+  });
+
+  // 4. 运行演示（这会初始化适配器并渲染幻灯片）
+  await runner.run(slideDSL, context);
+
+  // 注意：需要手动调用 runner.play() 来启动演示（导航到第一张幻灯片）
+  // 返回 runner 以便用户可以控制演示
+  return runner;
+}

package/src/style.css

@@ -0,0 +1,17 @@
+/**
+ * @slidejs/runner-revealjs - reveal.js 核心样式
+ *
+ * 此文件导入 reveal.js 的核心 CSS，用户只需导入此包即可获得所有必需的样式。
+ * 主题样式需要单独导入（可选）。
+ *
+ * 使用示例：
+ * ```typescript
+ * import '@slidejs/runner-revealjs';
+ * // 或显式导入样式
+ * import '@slidejs/runner-revealjs/style.css';
+ * ```
+ */
+
+/* 导入 reveal.js 核心 CSS */
+@import 'reveal.js/dist/reveal.css';
+

package/src/types.ts

@@ -0,0 +1,24 @@
+/**
+ * @slidejs/runner-revealjs - 类型定义
+ *
+ * 定义 reveal.js 适配器的选项和配置
+ */
+
+import type Reveal from 'reveal.js';
+import type { AdapterOptions } from '@slidejs/runner';
+
+/**
+ * RevealJsAdapter 选项
+ *
+ * 主题通过静态导入加载：
+ * ```typescript
+ * import 'reveal.js/dist/theme/black.css';
+ * ```
+ */
+export interface RevealJsOptions extends AdapterOptions {
+  /**
+   * reveal.js 配置
+   * @see https://revealjs.com/config/
+   */
+  revealConfig?: Reveal.Options;
+}

package/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "extends": "../../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "composite": true,
+    "declarationMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["**/*.test.ts", "dist", "node_modules"],
+  "references": [{ "path": "../core" }, { "path": "../runner" }]
+}

package/vite.config.ts

@@ -0,0 +1,44 @@
+import { defineConfig } from 'vite';
+import dts from 'vite-plugin-dts';
+import { resolve } from 'path';
+
+export default defineConfig({
+  build: {
+    lib: {
+      entry: resolve(__dirname, 'src/index.ts'),
+      name: 'SlideJsRevealJs',
+      formats: ['es', 'cjs'],
+      fileName: (format) => `index.${format === 'es' ? 'js' : 'cjs'}`,
+    },
+    rollupOptions: {
+      external: [
+        '@slidejs/core',
+        '@slidejs/runner',
+        '@slidejs/dsl',
+        '@slidejs/context',
+        'reveal.js',
+        // Only externalize JS modules from reveal.js, NOT CSS
+        /^reveal\.js\/.*\.js$/,
+      ],
+      output: {
+        // 确保 CSS 文件被正确提取
+        assetFileNames: (assetInfo) => {
+          if (assetInfo.name === 'style.css') {
+            return 'style.css';
+          }
+          return assetInfo.name || 'assets/[name].[ext]';
+        },
+      },
+    },
+    sourcemap: true,
+    // 确保 CSS 被提取到单独的文件
+    cssCodeSplit: false,
+  },
+  plugins: [
+    dts({
+      include: ['src/**/*'],
+      exclude: ['**/*.test.ts', 'src/themes/**/*'],
+      rollupTypes: true,
+    }),
+  ],
+});