triggerix-editor-preset-war3 0.0.5 → 0.0.7

package/README.md

@@ -0,0 +1,351 @@
+# triggerix-editor-preset-war3
+
+> **War3-style template editor preset for [Triggerix](https://github.com/triggerix-collective)**
+>
+> 为 Triggerix 提供的「魔兽争霸 III 触发器」风格编辑器预设 —— 用模板字符串 + 槽位的方式声明 Event / Condition / Action，并最终序列化为标准 Trigger JSON。
+
+[![npm](https://img.shields.io/npm/v/triggerix-editor-preset-war3)](https://www.npmjs.com/package/triggerix-editor-preset-war3)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue)](https://www.typescriptlang.org/)
+[![License](https://img.shields.io/github/license/triggerix-collective/triggerix-editor-preset-war3)](./LICENSE)
+
+## 特性
+
+- 🎯 **模板驱动**：用 `"${unit} 发动技能效果"` 这样的自然语言模板声明触发器节点
+- 🧩 **嵌套复合工具 (Composite Tool)**：Tool 可以由其他 Tool 组合，槽位无限嵌套
+- 🪝 **类型安全工厂**：`defineLeafTool` / `defineCompositeTool` / `defineCondition` 提供完整类型推断
+- 🔌 **可插拔预设**：`defineWar3Preset` 一键注入 Event/Action/Condition/Tool 集合
+- 📤 **标准输出**：`toTrigger()` 直接产出 `@triggerix/core` 兼容的 Trigger JSON
+- 🔍 **值来源查询**：`getValueSources(type)` 过滤同类型 Condition / Tool，作为槽位候选项
+- 🪶 **零依赖运行**：仅依赖 `@triggerix/core` 与 `@triggerix/editor`
+
+## 安装
+
+```bash
+pnpm add triggerix-editor-preset-war3 @triggerix/core @triggerix/editor
+# 或
+npm install triggerix-editor-preset-war3 @triggerix/core @triggerix/editor
+```
+
+> 运行时需要 `crypto.randomUUID`（Node 18+ / 现代浏览器）；不支持时会回退到基于时间戳的 ID。
+
+## 快速开始
+
+```ts
+import {
+  createWar3Editor,
+  defineCondition,
+  defineLeafTool,
+  defineWar3Preset
+} from 'triggerix-editor-preset-war3'
+
+// 1. 定义工具 (槽位填充器)
+const elementTool = defineLeafTool<string, string>({
+  type: 'element',
+  label: '元素',
+  input: {
+    type: 'select',
+    options: [
+      { value: '#submit-btn', label: '提交按钮' },
+      { value: '#search-input', label: '搜索框' }
+    ]
+  },
+  resolve: v => v
+})
+
+const eventNameTool = defineLeafTool<string, string>({
+  type: 'event-name',
+  label: '事件名',
+  input: { type: 'text', placeholder: '如 submit-success' },
+  resolve: v => v
+})
+
+const booleanTool = defineLeafTool<boolean, boolean>({
+  type: 'boolean',
+  label: '开关',
+  input: {
+    type: 'select',
+    options: [
+      { value: true, label: '启用' },
+      { value: false, label: '禁用' }
+    ]
+  },
+  resolve: v => v
+})
+
+// 2. 定义 Condition
+const elementVisible = defineCondition<{ element: string }>({
+  id: 'element-visible',
+  label: '元素可见',
+  template: '${element} 当前可见',
+  slots: {
+    element: { label: '元素', tools: ['element'] }
+  },
+  resolve: ({ element }) => ({ element })
+})
+
+// 3. 定义 Event / Action（结构与 Condition 类似，继承 BaseItemDef）
+// ...
+
+// 4. 打包成 Preset
+const preset = defineWar3Preset({
+  name: 'my-web-app',
+  events: [/* War3EventDef[] */],
+  actions: [/* War3ActionDef[] */],
+  conditions: [elementVisible],
+  tools: {
+    element: elementTool,
+    'event-name': eventNameTool,
+    boolean: booleanTool
+  }
+})
+
+// 5. 创建编辑器并应用 Preset
+const editor = createWar3Editor()
+editor.applyPreset(preset)
+
+// 6. 改变状态：监听 #submit-btn 点击后派发 submit-success
+editor.setEvent('element-click')
+editor.addCondition('element-visible')
+editor.setConditionSlot(0, 'element', { tool: 'element', value: '#submit-btn' })
+
+editor.addAction('emit-event')
+editor.setActionSlot(0, 'element', { tool: 'element', value: '#submit-btn' })
+editor.setActionSlot(0, 'event', { tool: 'event-name', value: 'submit-success' })
+
+// 7. 输出标准 Trigger
+const trigger = editor.toTrigger()
+console.log(JSON.stringify(trigger, null, 2))
+```
+
+## 核心概念
+
+| 概念 | 含义 |
+|---|---|
+| **Trigger** | 一条完整的触发器：`{ event, conditions?, actions[] }`，即 `toTrigger()` 的输出 |
+| **Template** | 模板字符串，如 `"${element} 被点击时，发送 ${eventName} 事件"`，`${key}` 为槽位 |
+| **Slot (槽位)** | 模板中的可替换位置，由 `SlotDef` 声明（label + 允许填入的 tool 列表） |
+| **Tool (工具)** | 槽位的填充器；分 `LeafTool`（单值输入）和 `CompositeTool`（由其他 Tool 嵌套） |
+| **Leaf Tool Input** | `text` / `number` / `select`（`select` 携带 `options: { value, label }[]`） |
+| **Segment** | 模板解析后的最小单元：`{ type: 'text', content }` 或 `{ type: 'slot', key, label, tools, value, entry }` |
+| **Item State** | 编辑器运行时状态：`{ id, slotValues: Record<key, SlotValueEntry> }` |
+| **Descriptor** | UI 渲染用：把 Item/Template 解析为 `Segment[]`，附加 `SlotValueEntry` 上下文 |
+| **Value Source** | 同类型的 Condition + Tool 集合，可作为另一个槽位的可选值来源 |
+
+### 数据流
+
+```
+定义侧 (开发者)                       运行侧 (编辑器)
+─────────────────                    ─────────────────
+War3EventDef / War3ActionDef /         editor.applyPreset(preset)
+War3ConditionDef / ToolDef                      │
+        │                                      ▼
+        └── defineWar3Preset ──▶ Preset    War3Registry
+                                            │
+                                  状态操作 │ setEvent / addAction / ...
+                                            ▼
+                                  War3EditorStateManager
+                                            │
+                  ┌─────────────────────────┼─────────────────────────┐
+                  ▼                         ▼                         ▼
+           parseTemplate             resolveSlotDisplayText         toTrigger
+           (→ ItemDescriptor)         (→ 人类可读展示文本)            (→ Trigger JSON)
+```
+
+## API 概览
+
+### 工厂与预设
+
+| 导出 | 说明 |
+|---|---|
+| `createWar3Editor()` | 创建 `War3Editor` 实例（`Editor<War3EditorState>`） |
+| `defineWar3Preset(options)` | 打包为 `Preset<War3Editor>`，批量注册 events / actions / conditions / tools |
+| `defineLeafTool(def)` | 类型安全的叶子工具工厂 |
+| `defineCompositeTool(def)` | 类型安全的复合工具工厂（槽位值类型从 `resolve` 推断） |
+| `defineCondition(def)` | 类型安全的 Condition 工厂 |
+
+### `War3Editor` 方法
+
+- **注册**：`registerEvent` / `registerAction` / `registerCondition` / `registerTool`
+- **查询**：`getAvailableEvents` / `getAvailableActions` / `getAvailableConditions`
+- **描述符**：`getEventDescriptor` / `getActionDescriptor(index)` / `getConditionDescriptor(index)` / `getToolDescriptor(name, slotValues?)` / `getSlotTools(slotDef)`
+- **状态操作**：
+  - Event：`setEvent` / `clearEvent` / `setEventSlot`
+  - Action：`addAction` / `removeAction` / `moveAction` / `setActionSlot`
+  - Condition：`addCondition` / `removeCondition` / `setConditionSlot`
+- **值来源**：`getValueSources(valueType?)` 返回 `{ conditions, tools }`
+- **生命周期**：`getState` / `onChange` / `reset` / `dispose`
+- **序列化**：`toTrigger(triggerId?)` 输出标准 Trigger；`resolveSlotValue(entry)` 解析单个槽位
+
+### 独立函数
+
+| 导出 | 说明 |
+|---|---|
+| `parseTemplate(template, slots?, slotValues?)` | 模板 → `Segment[]` |
+| `resolveSlotDisplayText(entry, registry, fallbackLabel)` | `SlotValueEntry` → 可读文本 |
+| `resolveSlotValue(entry, registry)` | `SlotValueEntry` → `Value`（递归） |
+| `getEventDescriptor` / `getActionDescriptor` / `getConditionDescriptor` / `getToolDescriptor` / `getSlotToolDescriptors` | 不走 Editor 的纯函数版本（直接接收 `War3Registry`） |
+
+### `toTrigger` 输出结构
+
+与 `@triggerix/core` 完全兼容：
+
+```ts
+{
+  id: string,                 // 默认 crypto.randomUUID()，可外部传入
+  event: { type: string, payload?: Record<string, Value> },
+  conditions?: { type: 'and', conditions: Action[] }, // 仅当 conditions 非空时存在
+  actions: Action[]           // [{ type, params? }]
+}
+```
+
+> 注：编辑期 Condition 在内部以 `Action` 形式（`{ type, params }`）存储，序列化为 `and` 分组；Condition ↔ Action 的语义映射由运行时层完成。
+
+## 模块结构
+
+```
+src/
+├── index.ts                 # 统一入口
+├── types.ts                 # 所有类型定义
+├── createWar3Editor.ts      # 工厂函数：组装 Registry + State + Serializer
+├── preset.ts                # defineWar3Preset → Preset<War3Editor>
+├── registry.ts              # War3Registry（继承 BaseRegistry + Tool）
+├── state.ts                 # War3EditorStateManager（继承 ObservableState）
+├── parser.ts                # 模板字符串 → Segment[]
+├── descriptor.ts            # Item/Template → ItemDescriptor / ToolDescriptor
+├── display.ts               # SlotValueEntry → 人类可读展示文本
+├── serializer.ts            # War3EditorState → Trigger JSON
+└── helpers.ts               # defineLeafTool / defineCompositeTool / defineCondition
+```
+
+## 模板系统详解
+
+### 模板字符串
+
+模板中以 `${key}` 标记槽位，`key` 须为 `SlotDef` 中声明的键：
+
+```ts
+{
+  id: 'element-focus',
+  label: '元素获得焦点',
+  template: '${element} 获得焦点时，切换为 ${state}',
+  slots: {
+    element: { label: '元素', tools: ['element'] },
+    state:   { label: '状态', tools: ['boolean'] }
+  }
+}
+```
+
+解析后 `Segment[]`：
+
+```ts
+[
+  { type: 'slot', key: 'element', label: '元素', tools: ['element'], value: ..., entry: ... },
+  { type: 'text', content: ' 获得焦点时，切换为 ' },
+  { type: 'slot', key: 'state',   label: '状态', tools: ['boolean'], value: ..., entry: ... }
+]
+```
+
+> **未知 `${key}`**：未在 `slots` 中声明的占位符将作为普通文本保留（不抛错），便于迁移期兼容。
+
+### Leaf Tool
+
+```ts
+defineLeafTool<boolean, boolean>({
+  type: 'boolean', // 语义类型（用于 getValueSources 过滤）
+  label: '开关',
+  input: {
+    type: 'select',
+    options: [{ value: true, label: '启用' }]
+  },
+  resolve: v => v // 序列化为 Trigger.params 时的最终值
+})
+```
+
+`resolve` 接收 `input` 类型，返回**最终写入 `params`** 的值（可做单位换算、字符串映射等）。
+
+### Composite Tool
+
+```ts
+const emitEventTool = defineCompositeTool<
+  { element: string, event: string },
+  { target: string, type: string }
+>({
+  type: 'emit-event',
+  label: '发送事件',
+  template: '从 ${element} 派发 ${event}',
+  slots: {
+    element: { label: '元素',   tools: ['element'] },
+    event:   { label: '事件名', tools: ['event-name'] }
+  },
+  resolve: ({ element, event }) => ({ target: element, type: event })
+})
+```
+
+- 槽位键 `source` / `target` 会从 `resolve` 参数中推断，保证 `slots` 键与 `resolve` 参数键一致
+- Composite 可无限嵌套（一个 Composite 的槽位可以填入另一个 Composite）
+
+## 编辑器状态形状
+
+```ts
+interface War3EditorState {
+  event: ItemState | null // 单一事件
+  conditions: ItemState[] // 条件列表（AND 语义）
+  actions: ItemState[] // 动作列表（顺序敏感）
+}
+
+interface ItemState {
+  id: string // 对应 War3EventDef/Action/Condition 的 id
+  slotValues: Record<string, SlotValueEntry> // 各槽位填充值
+}
+
+interface SlotValueEntry {
+  tool: string | null // 选中的 tool 名
+  value: unknown // leaf: 原值; composite: 通常为空对象
+  subSlots?: Record<string, SlotValueEntry> // composite 递归结构
+}
+```
+
+## 监听变化
+
+```ts
+const editor = createWar3Editor()
+const off = editor.onChange((state) => {
+  // 触发时机：setEvent / addAction / setActionSlot / reset ...
+  console.log('state changed:', state)
+})
+
+off() // 取消订阅
+```
+
+`onChange` 返回的解绑函数也可以在 `dispose()` 后自动失效。
+
+## 开发
+
+### 命令
+
+```bash
+pnpm install        # 安装依赖
+pnpm dev            # 监听构建（生成 stub 供本地调试）
+pnpm build          # 产出 dist/{index.mjs,index.cjs,index.d.ts}
+pnpm typecheck      # tsc --noEmit
+pnpm lint           # eslint --cache
+pnpm release        # bumpp 交互式升级版本号并打 tag
+```
+
+### 构建产物
+
+- ESM: `dist/index.mjs`
+- CJS: `dist/index.cjs`
+- 类型: `dist/index.d.ts`
+
+由 [unbuild](https://github.com/unjs/unbuild) 打包，`@triggerix/core` 与 `@triggerix/editor` 标记为 external。
+
+### 质量保障
+
+- TypeScript `strict: true` + `declaration: true`
+- ESLint (`@antfu/eslint-config`) + pre-commit (simple-git-hooks + nano-staged)
+- 发布：推送 `v*` tag → GitHub Actions 自动 `changelogithub` + `pnpm publish`
+
+## License
+
+[MIT](./LICENSE) © Triggerix Collective

package/dist/index.cjs

@@ -34,47 +34,6 @@ function parseTemplate(template, slots, slotValues) {
   return segments;
 }
 
-function buildDescriptor(def, slotValues) {
-  return {
-    id: def.id,
-    segments: parseTemplate(def.template, def.slots, slotValues)
-  };
-}
-function getEventDescriptor(registry, id, slotValues) {
-  const def = registry.getEvent(id);
-  return def ? buildDescriptor(def, slotValues) : null;
-}
-function getActionDescriptor(registry, id, slotValues) {
-  const def = registry.getAction(id);
-  return def ? buildDescriptor(def, slotValues) : null;
-}
-function getConditionDescriptor(registry, id, slotValues) {
-  const def = registry.getCondition(id);
-  return def ? buildDescriptor(def, slotValues) : null;
-}
-function getToolDescriptor(registry, toolName, slotValues) {
-  const def = registry.getTool(toolName);
-  if (!def)
-    return null;
-  if (def.kind === "leaf") {
-    return {
-      kind: "leaf",
-      name: toolName,
-      label: def.label,
-      input: def.input
-    };
-  }
-  return {
-    kind: "composite",
-    name: toolName,
-    label: def.label,
-    segments: parseTemplate(def.template, def.slots, slotValues)
-  };
-}
-function getSlotToolDescriptors(registry, slotDef) {
-  return slotDef.tools.map((name) => getToolDescriptor(registry, name)).filter((d) => d !== null);
-}
-
 class War3Registry extends editor.BaseRegistry {
   tools = /* @__PURE__ */ new Map();
   registerTool(name, def) {
@@ -97,72 +56,6 @@ class War3Registry extends editor.BaseRegistry {
   }
 }
 
-function resolveSlotValue(entry, registry) {
-  if (!entry.tool)
-    return void 0;
-  const toolDef = registry.getTool(entry.tool);
-  if (!toolDef)
-    return void 0;
-  if (toolDef.kind === "leaf") {
-    return toolDef.resolve(entry.value);
-  }
-  const resolvedSubSlots = {};
-  if (entry.subSlots) {
-    for (const [key, subEntry] of Object.entries(entry.subSlots)) {
-      resolvedSubSlots[key] = resolveSlotValue(subEntry, registry);
-    }
-  }
-  return toolDef.resolve(resolvedSubSlots);
-}
-function resolveItemParams(slotValues, registry) {
-  const params = {};
-  let hasParams = false;
-  for (const [key, entry] of Object.entries(slotValues)) {
-    const resolved = resolveSlotValue(entry, registry);
-    if (resolved !== void 0) {
-      params[key] = resolved;
-      hasParams = true;
-    }
-  }
-  return hasParams ? params : void 0;
-}
-function serializeItems(items, registry) {
-  return items.map((item) => {
-    const params = resolveItemParams(item.slotValues, registry);
-    const action = { type: item.id };
-    if (params) {
-      action.params = params;
-    }
-    return action;
-  });
-}
-function generateRuleId() {
-  if (typeof globalThis.crypto?.randomUUID === "function") {
-    return globalThis.crypto.randomUUID();
-  }
-  return `rule-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
-}
-function toRule(state, registry, ruleId) {
-  const eventParams = state.event ? resolveItemParams(state.event.slotValues, registry) : void 0;
-  const event = {
-    type: state.event?.id ?? "",
-    ...eventParams ? { payload: eventParams } : {}
-  };
-  const actions = serializeItems(state.actions, registry);
-  const rule = {
-    id: ruleId ?? generateRuleId(),
-    event,
-    actions
-  };
-  if (state.conditions.length > 0) {
-    rule.conditions = {
-      type: "and",
-      conditions: serializeItems(state.conditions, registry)
-    };
-  }
-  return rule;
-}
-
 const INITIAL_STATE = {
   event: null,
   conditions: [],
@@ -249,6 +142,113 @@ class War3EditorStateManager extends editor.ObservableState {
   }
 }
 
+function buildDescriptor(def, slotValues) {
+  return {
+    id: def.id,
+    segments: parseTemplate(def.template, def.slots, slotValues)
+  };
+}
+function getEventDescriptor(registry, id, slotValues) {
+  const def = registry.getEvent(id);
+  return def ? buildDescriptor(def, slotValues) : null;
+}
+function getActionDescriptor(registry, id, slotValues) {
+  const def = registry.getAction(id);
+  return def ? buildDescriptor(def, slotValues) : null;
+}
+function getConditionDescriptor(registry, id, slotValues) {
+  const def = registry.getCondition(id);
+  return def ? buildDescriptor(def, slotValues) : null;
+}
+function getToolDescriptor(registry, toolName, slotValues) {
+  const def = registry.getTool(toolName);
+  if (!def)
+    return null;
+  if (def.kind === "leaf") {
+    return {
+      kind: "leaf",
+      name: toolName,
+      label: def.label,
+      input: def.input
+    };
+  }
+  return {
+    kind: "composite",
+    name: toolName,
+    label: def.label,
+    segments: parseTemplate(def.template, def.slots, slotValues)
+  };
+}
+function getSlotToolDescriptors(registry, slotDef) {
+  return slotDef.tools.map((name) => getToolDescriptor(registry, name)).filter((d) => d !== null);
+}
+
+function resolveSlotValue(entry, registry) {
+  if (!entry.tool)
+    return void 0;
+  const toolDef = registry.getTool(entry.tool);
+  if (!toolDef)
+    return void 0;
+  if (toolDef.kind === "leaf") {
+    return toolDef.resolve(entry.value);
+  }
+  const resolvedSubSlots = {};
+  if (entry.subSlots) {
+    for (const [key, subEntry] of Object.entries(entry.subSlots)) {
+      resolvedSubSlots[key] = resolveSlotValue(subEntry, registry);
+    }
+  }
+  return toolDef.resolve(resolvedSubSlots);
+}
+function resolveItemParams(slotValues, registry) {
+  const params = {};
+  let hasParams = false;
+  for (const [key, entry] of Object.entries(slotValues)) {
+    const resolved = resolveSlotValue(entry, registry);
+    if (resolved !== void 0) {
+      params[key] = resolved;
+      hasParams = true;
+    }
+  }
+  return hasParams ? params : void 0;
+}
+function serializeItems(items, registry) {
+  return items.map((item) => {
+    const params = resolveItemParams(item.slotValues, registry);
+    const action = { type: item.id };
+    if (params) {
+      action.params = params;
+    }
+    return action;
+  });
+}
+function generateTriggerId() {
+  if (typeof globalThis.crypto?.randomUUID === "function") {
+    return globalThis.crypto.randomUUID();
+  }
+  return `trigger-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+}
+function toTrigger(state, registry, triggerId) {
+  const eventParams = state.event ? resolveItemParams(state.event.slotValues, registry) : void 0;
+  const event = {
+    type: state.event?.id ?? "",
+    ...eventParams ? { payload: eventParams } : {}
+  };
+  const actions = serializeItems(state.actions, registry);
+  const trigger = {
+    id: triggerId ?? generateTriggerId(),
+    event,
+    actions
+  };
+  if (state.conditions.length > 0) {
+    trigger.conditions = {
+      type: "and",
+      conditions: serializeItems(state.conditions, registry)
+    };
+  }
+  return trigger;
+}
+
 function createWar3Editor() {
   const registry = new War3Registry();
   const stateManager = new War3EditorStateManager();
@@ -256,7 +256,7 @@ function createWar3Editor() {
     // --- Editor 接口 ---
     getState: () => stateManager.getState(),
     onChange: (listener) => stateManager.onChange(listener),
-    toRule: (ruleId) => toRule(stateManager.getState(), registry, ruleId),
+    toTrigger: (triggerId) => toTrigger(stateManager.getState(), registry, triggerId),
     reset: () => stateManager.reset(),
     dispose: () => stateManager.dispose(),
     // --- 注册 ---
@@ -316,6 +316,16 @@ function createWar3Editor() {
   return editor;
 }
 
+function defineLeafTool(def) {
+  return { ...def, kind: "leaf" };
+}
+function defineCompositeTool(def) {
+  return { ...def, kind: "composite" };
+}
+function defineCondition(def) {
+  return def;
+}
+
 function valueEquals(a, b) {
   if (a === b)
     return true;
@@ -368,16 +378,6 @@ function resolveSlotDisplayText(entry, registry, fallbackLabel) {
   }).join("");
 }
 
-function defineLeafTool(def) {
-  return { ...def, kind: "leaf" };
-}
-function defineCompositeTool(def) {
-  return { ...def, kind: "composite" };
-}
-function defineCondition(def) {
-  return def;
-}
-
 function defineWar3Preset(options) {
   return {
     name: options.name,
@@ -409,4 +409,4 @@ exports.getToolDescriptor = getToolDescriptor;
 exports.parseTemplate = parseTemplate;
 exports.resolveSlotDisplayText = resolveSlotDisplayText;
 exports.resolveSlotValue = resolveSlotValue;
-exports.toRule = toRule;
+exports.toTrigger = toTrigger;

package/dist/index.d.cts

@@ -1,6 +1,6 @@
-import { BaseItemDef, BaseRegistry, Editor, Preset, ObservableState } from '@triggerix/editor';
+import { BaseItemDef, BaseRegistry, ObservableState, Editor, Preset } from '@triggerix/editor';
 export { BaseItemDef, Preset } from '@triggerix/editor';
-import { Value, Rule } from '@triggerix/core';
+import { Value, Trigger } from '@triggerix/core';
 
 interface SlotDef {
     label: string;
@@ -93,6 +93,12 @@ interface War3PresetOptions {
     tools?: Record<string, ToolDef>;
 }
 
+/**
+ * 解析模板字符串为 Segment 数组
+ * 模板格式: "普通文本${slotKey}更多文本"
+ */
+declare function parseTemplate(template: string, slots?: Record<string, SlotDef>, slotValues?: Record<string, SlotValueEntry>): Segment[];
+
 /**
  * War3 注册表 - 继承 BaseRegistry，增加 Tool 注册能力
  */
@@ -107,6 +113,26 @@ declare class War3Registry extends BaseRegistry<War3EventDef, War3ActionDef, War
     };
 }
 
+/**
+ * War3 编辑器状态管理
+ * 继承 ObservableState，提供模板模式特有的状态操作
+ */
+declare class War3EditorStateManager extends ObservableState<War3EditorState> {
+    constructor();
+    setEvent(id: string): void;
+    clearEvent(): void;
+    setEventSlot(key: string, entry: SlotValueEntry): void;
+    addAction(id: string): void;
+    removeAction(index: number): void;
+    moveAction(from: number, to: number): void;
+    setActionSlot(actionIndex: number, key: string, entry: SlotValueEntry): void;
+    addCondition(id: string): void;
+    removeCondition(index: number): void;
+    setConditionSlot(conditionIndex: number, key: string, entry: SlotValueEntry): void;
+    reset(): void;
+    private setItemSlot;
+}
+
 interface War3Editor extends Editor<War3EditorState> {
     registerEvent: (def: War3EventDef) => void;
     registerAction: (def: War3ActionDef) => void;
@@ -140,24 +166,6 @@ interface War3Editor extends Editor<War3EditorState> {
 }
 declare function createWar3Editor(): War3Editor;
 
-declare function getEventDescriptor(registry: War3Registry, id: string, slotValues?: Record<string, SlotValueEntry>): ItemDescriptor | null;
-declare function getActionDescriptor(registry: War3Registry, id: string, slotValues?: Record<string, SlotValueEntry>): ItemDescriptor | null;
-declare function getConditionDescriptor(registry: War3Registry, id: string, slotValues?: Record<string, SlotValueEntry>): ItemDescriptor | null;
-declare function getToolDescriptor(registry: War3Registry, toolName: string, slotValues?: Record<string, SlotValueEntry>): ToolDescriptor | null;
-declare function getSlotToolDescriptors(registry: War3Registry, slotDef: SlotDef): ToolDescriptor[];
-
-/**
- * 递归解析 SlotValueEntry 为人类可读的展示文本
- *
- * - 如果 entry 为 null/undefined 或未选择 tool，返回 fallbackLabel（slot 占位文案）
- * - 如果 tool 为 leaf：
- *   - select 类型：尝试匹配 options 找到对应 label（支持对象值的深比较）
- *   - 其它类型：返回 value 的字符串形式
- *   - 若 value 为空：返回 fallbackLabel
- * - 如果 tool 为 composite：使用 tool 的 template 递归展开
- */
-declare function resolveSlotDisplayText(entry: SlotValueEntry | null | undefined, registry: War3Registry, fallbackLabel: string): string;
-
 /**
  * Type-safe LeafTool definition.
  * Input type comes from the resolve callback annotation; output is inferred.
@@ -192,11 +200,23 @@ declare function defineCondition<TSlotValues extends Record<string, unknown> = R
     resolve?: (slotValues: TSlotValues) => unknown;
 }): War3ConditionDef;
 
+declare function getEventDescriptor(registry: War3Registry, id: string, slotValues?: Record<string, SlotValueEntry>): ItemDescriptor | null;
+declare function getActionDescriptor(registry: War3Registry, id: string, slotValues?: Record<string, SlotValueEntry>): ItemDescriptor | null;
+declare function getConditionDescriptor(registry: War3Registry, id: string, slotValues?: Record<string, SlotValueEntry>): ItemDescriptor | null;
+declare function getToolDescriptor(registry: War3Registry, toolName: string, slotValues?: Record<string, SlotValueEntry>): ToolDescriptor | null;
+declare function getSlotToolDescriptors(registry: War3Registry, slotDef: SlotDef): ToolDescriptor[];
+
 /**
- * 解析模板字符串为 Segment 数组
- * 模板格式: "普通文本${slotKey}更多文本"
+ * 递归解析 SlotValueEntry 为人类可读的展示文本
+ *
+ * - 如果 entry 为 null/undefined 或未选择 tool，返回 fallbackLabel（slot 占位文案）
+ * - 如果 tool 为 leaf：
+ *   - select 类型：尝试匹配 options 找到对应 label（支持对象值的深比较）
+ *   - 其它类型：返回 value 的字符串形式
+ *   - 若 value 为空：返回 fallbackLabel
+ * - 如果 tool 为 composite：使用 tool 的 template 递归展开
  */
-declare function parseTemplate(template: string, slots?: Record<string, SlotDef>, slotValues?: Record<string, SlotValueEntry>): Segment[];
+declare function resolveSlotDisplayText(entry: SlotValueEntry | null | undefined, registry: War3Registry, fallbackLabel: string): string;
 
 declare function defineWar3Preset(options: War3PresetOptions): Preset<War3Editor>;
 
@@ -205,7 +225,7 @@ declare function defineWar3Preset(options: War3PresetOptions): Preset<War3Editor
  */
 declare function resolveSlotValue(entry: SlotValueEntry, registry: War3Registry): Value | undefined;
 /**
- * Serialize editor state into a standard Rule JSON.
+ * Serialize editor state into a standard Trigger JSON.
  *
  * Output shape (compatible with @triggerix/core):
  *   {
@@ -213,27 +233,7 @@ declare function resolveSlotValue(entry: SlotValueEntry, registry: War3Registry)
  *     actions: [{ type, params? }]
  *   }
  */
-declare function toRule(state: War3EditorState, registry: War3Registry, ruleId?: string): Rule;
-
-/**
- * War3 编辑器状态管理
- * 继承 ObservableState，提供模板模式特有的状态操作
- */
-declare class War3EditorStateManager extends ObservableState<War3EditorState> {
-    constructor();
-    setEvent(id: string): void;
-    clearEvent(): void;
-    setEventSlot(key: string, entry: SlotValueEntry): void;
-    addAction(id: string): void;
-    removeAction(index: number): void;
-    moveAction(from: number, to: number): void;
-    setActionSlot(actionIndex: number, key: string, entry: SlotValueEntry): void;
-    addCondition(id: string): void;
-    removeCondition(index: number): void;
-    setConditionSlot(conditionIndex: number, key: string, entry: SlotValueEntry): void;
-    reset(): void;
-    private setItemSlot;
-}
+declare function toTrigger(state: War3EditorState, registry: War3Registry, triggerId?: string): Trigger;
 
-export { War3EditorStateManager, War3Registry, createWar3Editor, defineCompositeTool, defineCondition, defineLeafTool, defineWar3Preset, getActionDescriptor, getConditionDescriptor, getEventDescriptor, getSlotToolDescriptors, getToolDescriptor, parseTemplate, resolveSlotDisplayText, resolveSlotValue, toRule };
+export { War3EditorStateManager, War3Registry, createWar3Editor, defineCompositeTool, defineCondition, defineLeafTool, defineWar3Preset, getActionDescriptor, getConditionDescriptor, getEventDescriptor, getSlotToolDescriptors, getToolDescriptor, parseTemplate, resolveSlotDisplayText, resolveSlotValue, toTrigger };
 export type { CompositeToolDef, CompositeToolDescriptor, ItemDescriptor, ItemState, LeafToolDef, LeafToolDescriptor, LeafToolInput, Segment, SlotDef, SlotValueEntry, ToolDef, ToolDescriptor, War3ActionDef, War3ConditionDef, War3Editor, War3EditorState, War3EventDef, War3PresetOptions };

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { BaseItemDef, BaseRegistry, Editor, Preset, ObservableState } from '@triggerix/editor';
+import { BaseItemDef, BaseRegistry, ObservableState, Editor, Preset } from '@triggerix/editor';
 export { BaseItemDef, Preset } from '@triggerix/editor';
-import { Value, Rule } from '@triggerix/core';
+import { Value, Trigger } from '@triggerix/core';
 
 interface SlotDef {
     label: string;
@@ -93,6 +93,12 @@ interface War3PresetOptions {
     tools?: Record<string, ToolDef>;
 }
 
+/**
+ * 解析模板字符串为 Segment 数组
+ * 模板格式: "普通文本${slotKey}更多文本"
+ */
+declare function parseTemplate(template: string, slots?: Record<string, SlotDef>, slotValues?: Record<string, SlotValueEntry>): Segment[];
+
 /**
  * War3 注册表 - 继承 BaseRegistry，增加 Tool 注册能力
  */
@@ -107,6 +113,26 @@ declare class War3Registry extends BaseRegistry<War3EventDef, War3ActionDef, War
     };
 }
 
+/**
+ * War3 编辑器状态管理
+ * 继承 ObservableState，提供模板模式特有的状态操作
+ */
+declare class War3EditorStateManager extends ObservableState<War3EditorState> {
+    constructor();
+    setEvent(id: string): void;
+    clearEvent(): void;
+    setEventSlot(key: string, entry: SlotValueEntry): void;
+    addAction(id: string): void;
+    removeAction(index: number): void;
+    moveAction(from: number, to: number): void;
+    setActionSlot(actionIndex: number, key: string, entry: SlotValueEntry): void;
+    addCondition(id: string): void;
+    removeCondition(index: number): void;
+    setConditionSlot(conditionIndex: number, key: string, entry: SlotValueEntry): void;
+    reset(): void;
+    private setItemSlot;
+}
+
 interface War3Editor extends Editor<War3EditorState> {
     registerEvent: (def: War3EventDef) => void;
     registerAction: (def: War3ActionDef) => void;
@@ -140,24 +166,6 @@ interface War3Editor extends Editor<War3EditorState> {
 }
 declare function createWar3Editor(): War3Editor;
 
-declare function getEventDescriptor(registry: War3Registry, id: string, slotValues?: Record<string, SlotValueEntry>): ItemDescriptor | null;
-declare function getActionDescriptor(registry: War3Registry, id: string, slotValues?: Record<string, SlotValueEntry>): ItemDescriptor | null;
-declare function getConditionDescriptor(registry: War3Registry, id: string, slotValues?: Record<string, SlotValueEntry>): ItemDescriptor | null;
-declare function getToolDescriptor(registry: War3Registry, toolName: string, slotValues?: Record<string, SlotValueEntry>): ToolDescriptor | null;
-declare function getSlotToolDescriptors(registry: War3Registry, slotDef: SlotDef): ToolDescriptor[];
-
-/**
- * 递归解析 SlotValueEntry 为人类可读的展示文本
- *
- * - 如果 entry 为 null/undefined 或未选择 tool，返回 fallbackLabel（slot 占位文案）
- * - 如果 tool 为 leaf：
- *   - select 类型：尝试匹配 options 找到对应 label（支持对象值的深比较）
- *   - 其它类型：返回 value 的字符串形式
- *   - 若 value 为空：返回 fallbackLabel
- * - 如果 tool 为 composite：使用 tool 的 template 递归展开
- */
-declare function resolveSlotDisplayText(entry: SlotValueEntry | null | undefined, registry: War3Registry, fallbackLabel: string): string;
-
 /**
  * Type-safe LeafTool definition.
  * Input type comes from the resolve callback annotation; output is inferred.
@@ -192,11 +200,23 @@ declare function defineCondition<TSlotValues extends Record<string, unknown> = R
     resolve?: (slotValues: TSlotValues) => unknown;
 }): War3ConditionDef;
 
+declare function getEventDescriptor(registry: War3Registry, id: string, slotValues?: Record<string, SlotValueEntry>): ItemDescriptor | null;
+declare function getActionDescriptor(registry: War3Registry, id: string, slotValues?: Record<string, SlotValueEntry>): ItemDescriptor | null;
+declare function getConditionDescriptor(registry: War3Registry, id: string, slotValues?: Record<string, SlotValueEntry>): ItemDescriptor | null;
+declare function getToolDescriptor(registry: War3Registry, toolName: string, slotValues?: Record<string, SlotValueEntry>): ToolDescriptor | null;
+declare function getSlotToolDescriptors(registry: War3Registry, slotDef: SlotDef): ToolDescriptor[];
+
 /**
- * 解析模板字符串为 Segment 数组
- * 模板格式: "普通文本${slotKey}更多文本"
+ * 递归解析 SlotValueEntry 为人类可读的展示文本
+ *
+ * - 如果 entry 为 null/undefined 或未选择 tool，返回 fallbackLabel（slot 占位文案）
+ * - 如果 tool 为 leaf：
+ *   - select 类型：尝试匹配 options 找到对应 label（支持对象值的深比较）
+ *   - 其它类型：返回 value 的字符串形式
+ *   - 若 value 为空：返回 fallbackLabel
+ * - 如果 tool 为 composite：使用 tool 的 template 递归展开
  */
-declare function parseTemplate(template: string, slots?: Record<string, SlotDef>, slotValues?: Record<string, SlotValueEntry>): Segment[];
+declare function resolveSlotDisplayText(entry: SlotValueEntry | null | undefined, registry: War3Registry, fallbackLabel: string): string;
 
 declare function defineWar3Preset(options: War3PresetOptions): Preset<War3Editor>;
 
@@ -205,7 +225,7 @@ declare function defineWar3Preset(options: War3PresetOptions): Preset<War3Editor
  */
 declare function resolveSlotValue(entry: SlotValueEntry, registry: War3Registry): Value | undefined;
 /**
- * Serialize editor state into a standard Rule JSON.
+ * Serialize editor state into a standard Trigger JSON.
  *
  * Output shape (compatible with @triggerix/core):
  *   {
@@ -213,27 +233,7 @@ declare function resolveSlotValue(entry: SlotValueEntry, registry: War3Registry)
  *     actions: [{ type, params? }]
  *   }
  */
-declare function toRule(state: War3EditorState, registry: War3Registry, ruleId?: string): Rule;
-
-/**
- * War3 编辑器状态管理
- * 继承 ObservableState，提供模板模式特有的状态操作
- */
-declare class War3EditorStateManager extends ObservableState<War3EditorState> {
-    constructor();
-    setEvent(id: string): void;
-    clearEvent(): void;
-    setEventSlot(key: string, entry: SlotValueEntry): void;
-    addAction(id: string): void;
-    removeAction(index: number): void;
-    moveAction(from: number, to: number): void;
-    setActionSlot(actionIndex: number, key: string, entry: SlotValueEntry): void;
-    addCondition(id: string): void;
-    removeCondition(index: number): void;
-    setConditionSlot(conditionIndex: number, key: string, entry: SlotValueEntry): void;
-    reset(): void;
-    private setItemSlot;
-}
+declare function toTrigger(state: War3EditorState, registry: War3Registry, triggerId?: string): Trigger;
 
-export { War3EditorStateManager, War3Registry, createWar3Editor, defineCompositeTool, defineCondition, defineLeafTool, defineWar3Preset, getActionDescriptor, getConditionDescriptor, getEventDescriptor, getSlotToolDescriptors, getToolDescriptor, parseTemplate, resolveSlotDisplayText, resolveSlotValue, toRule };
+export { War3EditorStateManager, War3Registry, createWar3Editor, defineCompositeTool, defineCondition, defineLeafTool, defineWar3Preset, getActionDescriptor, getConditionDescriptor, getEventDescriptor, getSlotToolDescriptors, getToolDescriptor, parseTemplate, resolveSlotDisplayText, resolveSlotValue, toTrigger };
 export type { CompositeToolDef, CompositeToolDescriptor, ItemDescriptor, ItemState, LeafToolDef, LeafToolDescriptor, LeafToolInput, Segment, SlotDef, SlotValueEntry, ToolDef, ToolDescriptor, War3ActionDef, War3ConditionDef, War3Editor, War3EditorState, War3EventDef, War3PresetOptions };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { BaseItemDef, BaseRegistry, Editor, Preset, ObservableState } from '@triggerix/editor';
+import { BaseItemDef, BaseRegistry, ObservableState, Editor, Preset } from '@triggerix/editor';
 export { BaseItemDef, Preset } from '@triggerix/editor';
-import { Value, Rule } from '@triggerix/core';
+import { Value, Trigger } from '@triggerix/core';
 
 interface SlotDef {
     label: string;
@@ -93,6 +93,12 @@ interface War3PresetOptions {
     tools?: Record<string, ToolDef>;
 }
 
+/**
+ * 解析模板字符串为 Segment 数组
+ * 模板格式: "普通文本${slotKey}更多文本"
+ */
+declare function parseTemplate(template: string, slots?: Record<string, SlotDef>, slotValues?: Record<string, SlotValueEntry>): Segment[];
+
 /**
  * War3 注册表 - 继承 BaseRegistry，增加 Tool 注册能力
  */
@@ -107,6 +113,26 @@ declare class War3Registry extends BaseRegistry<War3EventDef, War3ActionDef, War
     };
 }
 
+/**
+ * War3 编辑器状态管理
+ * 继承 ObservableState，提供模板模式特有的状态操作
+ */
+declare class War3EditorStateManager extends ObservableState<War3EditorState> {
+    constructor();
+    setEvent(id: string): void;
+    clearEvent(): void;
+    setEventSlot(key: string, entry: SlotValueEntry): void;
+    addAction(id: string): void;
+    removeAction(index: number): void;
+    moveAction(from: number, to: number): void;
+    setActionSlot(actionIndex: number, key: string, entry: SlotValueEntry): void;
+    addCondition(id: string): void;
+    removeCondition(index: number): void;
+    setConditionSlot(conditionIndex: number, key: string, entry: SlotValueEntry): void;
+    reset(): void;
+    private setItemSlot;
+}
+
 interface War3Editor extends Editor<War3EditorState> {
     registerEvent: (def: War3EventDef) => void;
     registerAction: (def: War3ActionDef) => void;
@@ -140,24 +166,6 @@ interface War3Editor extends Editor<War3EditorState> {
 }
 declare function createWar3Editor(): War3Editor;
 
-declare function getEventDescriptor(registry: War3Registry, id: string, slotValues?: Record<string, SlotValueEntry>): ItemDescriptor | null;
-declare function getActionDescriptor(registry: War3Registry, id: string, slotValues?: Record<string, SlotValueEntry>): ItemDescriptor | null;
-declare function getConditionDescriptor(registry: War3Registry, id: string, slotValues?: Record<string, SlotValueEntry>): ItemDescriptor | null;
-declare function getToolDescriptor(registry: War3Registry, toolName: string, slotValues?: Record<string, SlotValueEntry>): ToolDescriptor | null;
-declare function getSlotToolDescriptors(registry: War3Registry, slotDef: SlotDef): ToolDescriptor[];
-
-/**
- * 递归解析 SlotValueEntry 为人类可读的展示文本
- *
- * - 如果 entry 为 null/undefined 或未选择 tool，返回 fallbackLabel（slot 占位文案）
- * - 如果 tool 为 leaf：
- *   - select 类型：尝试匹配 options 找到对应 label（支持对象值的深比较）
- *   - 其它类型：返回 value 的字符串形式
- *   - 若 value 为空：返回 fallbackLabel
- * - 如果 tool 为 composite：使用 tool 的 template 递归展开
- */
-declare function resolveSlotDisplayText(entry: SlotValueEntry | null | undefined, registry: War3Registry, fallbackLabel: string): string;
-
 /**
  * Type-safe LeafTool definition.
  * Input type comes from the resolve callback annotation; output is inferred.
@@ -192,11 +200,23 @@ declare function defineCondition<TSlotValues extends Record<string, unknown> = R
     resolve?: (slotValues: TSlotValues) => unknown;
 }): War3ConditionDef;
 
+declare function getEventDescriptor(registry: War3Registry, id: string, slotValues?: Record<string, SlotValueEntry>): ItemDescriptor | null;
+declare function getActionDescriptor(registry: War3Registry, id: string, slotValues?: Record<string, SlotValueEntry>): ItemDescriptor | null;
+declare function getConditionDescriptor(registry: War3Registry, id: string, slotValues?: Record<string, SlotValueEntry>): ItemDescriptor | null;
+declare function getToolDescriptor(registry: War3Registry, toolName: string, slotValues?: Record<string, SlotValueEntry>): ToolDescriptor | null;
+declare function getSlotToolDescriptors(registry: War3Registry, slotDef: SlotDef): ToolDescriptor[];
+
 /**
- * 解析模板字符串为 Segment 数组
- * 模板格式: "普通文本${slotKey}更多文本"
+ * 递归解析 SlotValueEntry 为人类可读的展示文本
+ *
+ * - 如果 entry 为 null/undefined 或未选择 tool，返回 fallbackLabel（slot 占位文案）
+ * - 如果 tool 为 leaf：
+ *   - select 类型：尝试匹配 options 找到对应 label（支持对象值的深比较）
+ *   - 其它类型：返回 value 的字符串形式
+ *   - 若 value 为空：返回 fallbackLabel
+ * - 如果 tool 为 composite：使用 tool 的 template 递归展开
  */
-declare function parseTemplate(template: string, slots?: Record<string, SlotDef>, slotValues?: Record<string, SlotValueEntry>): Segment[];
+declare function resolveSlotDisplayText(entry: SlotValueEntry | null | undefined, registry: War3Registry, fallbackLabel: string): string;
 
 declare function defineWar3Preset(options: War3PresetOptions): Preset<War3Editor>;
 
@@ -205,7 +225,7 @@ declare function defineWar3Preset(options: War3PresetOptions): Preset<War3Editor
  */
 declare function resolveSlotValue(entry: SlotValueEntry, registry: War3Registry): Value | undefined;
 /**
- * Serialize editor state into a standard Rule JSON.
+ * Serialize editor state into a standard Trigger JSON.
  *
  * Output shape (compatible with @triggerix/core):
  *   {
@@ -213,27 +233,7 @@ declare function resolveSlotValue(entry: SlotValueEntry, registry: War3Registry)
  *     actions: [{ type, params? }]
  *   }
  */
-declare function toRule(state: War3EditorState, registry: War3Registry, ruleId?: string): Rule;
-
-/**
- * War3 编辑器状态管理
- * 继承 ObservableState，提供模板模式特有的状态操作
- */
-declare class War3EditorStateManager extends ObservableState<War3EditorState> {
-    constructor();
-    setEvent(id: string): void;
-    clearEvent(): void;
-    setEventSlot(key: string, entry: SlotValueEntry): void;
-    addAction(id: string): void;
-    removeAction(index: number): void;
-    moveAction(from: number, to: number): void;
-    setActionSlot(actionIndex: number, key: string, entry: SlotValueEntry): void;
-    addCondition(id: string): void;
-    removeCondition(index: number): void;
-    setConditionSlot(conditionIndex: number, key: string, entry: SlotValueEntry): void;
-    reset(): void;
-    private setItemSlot;
-}
+declare function toTrigger(state: War3EditorState, registry: War3Registry, triggerId?: string): Trigger;
 
-export { War3EditorStateManager, War3Registry, createWar3Editor, defineCompositeTool, defineCondition, defineLeafTool, defineWar3Preset, getActionDescriptor, getConditionDescriptor, getEventDescriptor, getSlotToolDescriptors, getToolDescriptor, parseTemplate, resolveSlotDisplayText, resolveSlotValue, toRule };
+export { War3EditorStateManager, War3Registry, createWar3Editor, defineCompositeTool, defineCondition, defineLeafTool, defineWar3Preset, getActionDescriptor, getConditionDescriptor, getEventDescriptor, getSlotToolDescriptors, getToolDescriptor, parseTemplate, resolveSlotDisplayText, resolveSlotValue, toTrigger };
 export type { CompositeToolDef, CompositeToolDescriptor, ItemDescriptor, ItemState, LeafToolDef, LeafToolDescriptor, LeafToolInput, Segment, SlotDef, SlotValueEntry, ToolDef, ToolDescriptor, War3ActionDef, War3ConditionDef, War3Editor, War3EditorState, War3EventDef, War3PresetOptions };

package/dist/index.mjs

@@ -32,47 +32,6 @@ function parseTemplate(template, slots, slotValues) {
   return segments;
 }
 
-function buildDescriptor(def, slotValues) {
-  return {
-    id: def.id,
-    segments: parseTemplate(def.template, def.slots, slotValues)
-  };
-}
-function getEventDescriptor(registry, id, slotValues) {
-  const def = registry.getEvent(id);
-  return def ? buildDescriptor(def, slotValues) : null;
-}
-function getActionDescriptor(registry, id, slotValues) {
-  const def = registry.getAction(id);
-  return def ? buildDescriptor(def, slotValues) : null;
-}
-function getConditionDescriptor(registry, id, slotValues) {
-  const def = registry.getCondition(id);
-  return def ? buildDescriptor(def, slotValues) : null;
-}
-function getToolDescriptor(registry, toolName, slotValues) {
-  const def = registry.getTool(toolName);
-  if (!def)
-    return null;
-  if (def.kind === "leaf") {
-    return {
-      kind: "leaf",
-      name: toolName,
-      label: def.label,
-      input: def.input
-    };
-  }
-  return {
-    kind: "composite",
-    name: toolName,
-    label: def.label,
-    segments: parseTemplate(def.template, def.slots, slotValues)
-  };
-}
-function getSlotToolDescriptors(registry, slotDef) {
-  return slotDef.tools.map((name) => getToolDescriptor(registry, name)).filter((d) => d !== null);
-}
-
 class War3Registry extends BaseRegistry {
   tools = /* @__PURE__ */ new Map();
   registerTool(name, def) {
@@ -95,72 +54,6 @@ class War3Registry extends BaseRegistry {
   }
 }
 
-function resolveSlotValue(entry, registry) {
-  if (!entry.tool)
-    return void 0;
-  const toolDef = registry.getTool(entry.tool);
-  if (!toolDef)
-    return void 0;
-  if (toolDef.kind === "leaf") {
-    return toolDef.resolve(entry.value);
-  }
-  const resolvedSubSlots = {};
-  if (entry.subSlots) {
-    for (const [key, subEntry] of Object.entries(entry.subSlots)) {
-      resolvedSubSlots[key] = resolveSlotValue(subEntry, registry);
-    }
-  }
-  return toolDef.resolve(resolvedSubSlots);
-}
-function resolveItemParams(slotValues, registry) {
-  const params = {};
-  let hasParams = false;
-  for (const [key, entry] of Object.entries(slotValues)) {
-    const resolved = resolveSlotValue(entry, registry);
-    if (resolved !== void 0) {
-      params[key] = resolved;
-      hasParams = true;
-    }
-  }
-  return hasParams ? params : void 0;
-}
-function serializeItems(items, registry) {
-  return items.map((item) => {
-    const params = resolveItemParams(item.slotValues, registry);
-    const action = { type: item.id };
-    if (params) {
-      action.params = params;
-    }
-    return action;
-  });
-}
-function generateRuleId() {
-  if (typeof globalThis.crypto?.randomUUID === "function") {
-    return globalThis.crypto.randomUUID();
-  }
-  return `rule-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
-}
-function toRule(state, registry, ruleId) {
-  const eventParams = state.event ? resolveItemParams(state.event.slotValues, registry) : void 0;
-  const event = {
-    type: state.event?.id ?? "",
-    ...eventParams ? { payload: eventParams } : {}
-  };
-  const actions = serializeItems(state.actions, registry);
-  const rule = {
-    id: ruleId ?? generateRuleId(),
-    event,
-    actions
-  };
-  if (state.conditions.length > 0) {
-    rule.conditions = {
-      type: "and",
-      conditions: serializeItems(state.conditions, registry)
-    };
-  }
-  return rule;
-}
-
 const INITIAL_STATE = {
   event: null,
   conditions: [],
@@ -247,6 +140,113 @@ class War3EditorStateManager extends ObservableState {
   }
 }
 
+function buildDescriptor(def, slotValues) {
+  return {
+    id: def.id,
+    segments: parseTemplate(def.template, def.slots, slotValues)
+  };
+}
+function getEventDescriptor(registry, id, slotValues) {
+  const def = registry.getEvent(id);
+  return def ? buildDescriptor(def, slotValues) : null;
+}
+function getActionDescriptor(registry, id, slotValues) {
+  const def = registry.getAction(id);
+  return def ? buildDescriptor(def, slotValues) : null;
+}
+function getConditionDescriptor(registry, id, slotValues) {
+  const def = registry.getCondition(id);
+  return def ? buildDescriptor(def, slotValues) : null;
+}
+function getToolDescriptor(registry, toolName, slotValues) {
+  const def = registry.getTool(toolName);
+  if (!def)
+    return null;
+  if (def.kind === "leaf") {
+    return {
+      kind: "leaf",
+      name: toolName,
+      label: def.label,
+      input: def.input
+    };
+  }
+  return {
+    kind: "composite",
+    name: toolName,
+    label: def.label,
+    segments: parseTemplate(def.template, def.slots, slotValues)
+  };
+}
+function getSlotToolDescriptors(registry, slotDef) {
+  return slotDef.tools.map((name) => getToolDescriptor(registry, name)).filter((d) => d !== null);
+}
+
+function resolveSlotValue(entry, registry) {
+  if (!entry.tool)
+    return void 0;
+  const toolDef = registry.getTool(entry.tool);
+  if (!toolDef)
+    return void 0;
+  if (toolDef.kind === "leaf") {
+    return toolDef.resolve(entry.value);
+  }
+  const resolvedSubSlots = {};
+  if (entry.subSlots) {
+    for (const [key, subEntry] of Object.entries(entry.subSlots)) {
+      resolvedSubSlots[key] = resolveSlotValue(subEntry, registry);
+    }
+  }
+  return toolDef.resolve(resolvedSubSlots);
+}
+function resolveItemParams(slotValues, registry) {
+  const params = {};
+  let hasParams = false;
+  for (const [key, entry] of Object.entries(slotValues)) {
+    const resolved = resolveSlotValue(entry, registry);
+    if (resolved !== void 0) {
+      params[key] = resolved;
+      hasParams = true;
+    }
+  }
+  return hasParams ? params : void 0;
+}
+function serializeItems(items, registry) {
+  return items.map((item) => {
+    const params = resolveItemParams(item.slotValues, registry);
+    const action = { type: item.id };
+    if (params) {
+      action.params = params;
+    }
+    return action;
+  });
+}
+function generateTriggerId() {
+  if (typeof globalThis.crypto?.randomUUID === "function") {
+    return globalThis.crypto.randomUUID();
+  }
+  return `trigger-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+}
+function toTrigger(state, registry, triggerId) {
+  const eventParams = state.event ? resolveItemParams(state.event.slotValues, registry) : void 0;
+  const event = {
+    type: state.event?.id ?? "",
+    ...eventParams ? { payload: eventParams } : {}
+  };
+  const actions = serializeItems(state.actions, registry);
+  const trigger = {
+    id: triggerId ?? generateTriggerId(),
+    event,
+    actions
+  };
+  if (state.conditions.length > 0) {
+    trigger.conditions = {
+      type: "and",
+      conditions: serializeItems(state.conditions, registry)
+    };
+  }
+  return trigger;
+}
+
 function createWar3Editor() {
   const registry = new War3Registry();
   const stateManager = new War3EditorStateManager();
@@ -254,7 +254,7 @@ function createWar3Editor() {
     // --- Editor 接口 ---
     getState: () => stateManager.getState(),
     onChange: (listener) => stateManager.onChange(listener),
-    toRule: (ruleId) => toRule(stateManager.getState(), registry, ruleId),
+    toTrigger: (triggerId) => toTrigger(stateManager.getState(), registry, triggerId),
     reset: () => stateManager.reset(),
     dispose: () => stateManager.dispose(),
     // --- 注册 ---
@@ -314,6 +314,16 @@ function createWar3Editor() {
   return editor;
 }
 
+function defineLeafTool(def) {
+  return { ...def, kind: "leaf" };
+}
+function defineCompositeTool(def) {
+  return { ...def, kind: "composite" };
+}
+function defineCondition(def) {
+  return def;
+}
+
 function valueEquals(a, b) {
   if (a === b)
     return true;
@@ -366,16 +376,6 @@ function resolveSlotDisplayText(entry, registry, fallbackLabel) {
   }).join("");
 }
 
-function defineLeafTool(def) {
-  return { ...def, kind: "leaf" };
-}
-function defineCompositeTool(def) {
-  return { ...def, kind: "composite" };
-}
-function defineCondition(def) {
-  return def;
-}
-
 function defineWar3Preset(options) {
   return {
     name: options.name,
@@ -392,4 +392,4 @@ function defineWar3Preset(options) {
   };
 }
 
-export { War3EditorStateManager, War3Registry, createWar3Editor, defineCompositeTool, defineCondition, defineLeafTool, defineWar3Preset, getActionDescriptor, getConditionDescriptor, getEventDescriptor, getSlotToolDescriptors, getToolDescriptor, parseTemplate, resolveSlotDisplayText, resolveSlotValue, toRule };
+export { War3EditorStateManager, War3Registry, createWar3Editor, defineCompositeTool, defineCondition, defineLeafTool, defineWar3Preset, getActionDescriptor, getConditionDescriptor, getEventDescriptor, getSlotToolDescriptors, getToolDescriptor, parseTemplate, resolveSlotDisplayText, resolveSlotValue, toTrigger };

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "triggerix-editor-preset-war3",
   "type": "module",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "War3-style template editor preset for Triggerix",
-  "homepage": "https://github.com/triggerix-lang/triggerix-editor-preset-war3#readme",
+  "homepage": "https://github.com/triggerix-collective/triggerix-editor-preset-war3#readme",
   "repository": {
     "type": "git",
-    "url": "git@github.com:triggerix-lang/triggerix-editor-preset-war3.git"
+    "url": "git@github.com:triggerix-collective/triggerix-editor-preset-war3.git"
   },
   "bugs": {
-    "url": "https://github.com/triggerix-lang/triggerix-editor-preset-war3/issues"
+    "url": "https://github.com/triggerix-collective/triggerix-editor-preset-war3/issues"
   },
   "exports": {
     ".": {
@@ -25,8 +25,8 @@
     "dist"
   ],
   "dependencies": {
-    "@triggerix/core": "^0.0.6",
-    "@triggerix/editor": "^0.0.6"
+    "@triggerix/core": "^0.0.8",
+    "@triggerix/editor": "^0.0.8"
   },
   "devDependencies": {
     "@antfu/eslint-config": "^9.0.0",
@@ -36,7 +36,8 @@
     "nano-staged": "^1.0.2",
     "simple-git-hooks": "^2.13.1",
     "typescript": "^6.0.3",
-    "unbuild": "^3.6.1"
+    "unbuild": "^3.6.1",
+    "vitest": "^4.1.9"
   },
   "simple-git-hooks": {
     "pre-commit": "pnpm nano-staged"
@@ -49,6 +50,8 @@
     "dev": "unbuild --stub",
     "lint": "eslint --cache",
     "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "release": "bumpp"
   }
 }