triggerix-ui-preset-war3 0.0.0 → 0.0.2

package/LICENSE

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

package/dist/index.cjs

@@ -20,7 +20,8 @@ function parseTemplate(template, slots, slotValues) {
         key,
         label: slotDef.label,
         tools: slotDef.tools,
-        value: entry?.value ?? null
+        value: entry?.value ?? null,
+        entry: entry ?? void 0
       });
     } else {
       segments.push({ type: "text", content: match[0] });
@@ -273,6 +274,8 @@ function createWar3Editor() {
     registerAction: (def) => registry.registerAction(def),
     registerCondition: (def) => registry.registerCondition(def),
     registerTool: (name, def) => registry.registerTool(name, def),
+    // --- 注册表访问 ---
+    getRegistry: () => registry,
     // --- 查询 ---
     getAvailableEvents: () => registry.getEvents(),
     getAvailableActions: () => registry.getActions(),
@@ -321,6 +324,54 @@ function createWar3Editor() {
   return editor;
 }
 
+function valueEquals(a, b) {
+  if (a === b) return true;
+  if (a == null || b == null) return false;
+  if (typeof a !== "object" || typeof b !== "object") return false;
+  try {
+    return JSON.stringify(a) === JSON.stringify(b);
+  } catch {
+    return false;
+  }
+}
+function stringifyValue(v) {
+  if (v == null) return "";
+  if (typeof v === "string" || typeof v === "number" || typeof v === "boolean")
+    return String(v);
+  try {
+    return JSON.stringify(v);
+  } catch {
+    return String(v);
+  }
+}
+function resolveSlotDisplayText(entry, registry, fallbackLabel) {
+  if (!entry?.tool)
+    return fallbackLabel;
+  const toolDef = registry.getTool(entry.tool);
+  if (!toolDef)
+    return fallbackLabel;
+  if (toolDef.type === "leaf") {
+    if (entry.value == null || entry.value === "")
+      return fallbackLabel;
+    if (toolDef.input.type === "select") {
+      const opt = toolDef.input.options?.find((o) => valueEquals(o.value, entry.value));
+      if (opt)
+        return opt.label;
+    }
+    return stringifyValue(entry.value);
+  }
+  const segments = parseTemplate(toolDef.template, toolDef.slots, entry.subSlots ?? {});
+  return segments.map((seg) => {
+    if (seg.type === "text")
+      return seg.content;
+    if (seg.type === "slot") {
+      const subEntry = entry.subSlots?.[seg.key];
+      return resolveSlotDisplayText(subEntry ?? null, registry, seg.label);
+    }
+    return "";
+  }).join("");
+}
+
 function defineWar3Preset(options) {
   return {
     name: options.name,
@@ -347,5 +398,6 @@ exports.getEventDescriptor = getEventDescriptor;
 exports.getSlotToolDescriptors = getSlotToolDescriptors;
 exports.getToolDescriptor = getToolDescriptor;
 exports.parseTemplate = parseTemplate;
+exports.resolveSlotDisplayText = resolveSlotDisplayText;
 exports.resolveSlotValue = resolveSlotValue;
 exports.toRule = toRule;

package/dist/index.d.cts

@@ -1,7 +1,11 @@
-import { BaseItemDef, Editor, Preset, BaseRegistry, ObservableState } from '@triggerix/editor';
+import { BaseRegistry, Editor, Preset, ObservableState } from '@triggerix/editor';
 export { Preset } from '@triggerix/editor';
 import { Rule } from '@triggerix/core';
 
+interface BaseItemDef {
+    type: string;
+    label?: string;
+}
 interface SlotDef {
     label: string;
     tools: string[];
@@ -15,7 +19,7 @@ interface LeafToolInput {
     type: 'text' | 'number' | 'select';
     placeholder?: string;
     options?: Array<{
-        value: string;
+        value: unknown;
         label: string;
     }>;
 }
@@ -54,6 +58,7 @@ type Segment = {
     label: string;
     tools: string[];
     value: unknown;
+    entry?: SlotValueEntry;
 };
 interface ItemDescriptor {
     type: string;
@@ -89,11 +94,22 @@ interface War3PresetOptions {
     tools?: Record<string, ToolDef>;
 }
 
+/**
+ * War3 注册表 - 继承 BaseRegistry，增加 Tool 注册能力
+ */
+declare class War3Registry extends BaseRegistry<War3EventDef, War3ActionDef, War3ConditionDef> {
+    private tools;
+    registerTool(name: string, def: ToolDef): void;
+    getTool(name: string): ToolDef | undefined;
+    getTools(): Map<string, ToolDef>;
+}
+
 interface War3Editor extends Editor<War3EditorState> {
     registerEvent: (def: War3EventDef) => void;
     registerAction: (def: War3ActionDef) => void;
     registerCondition: (def: War3ConditionDef) => void;
     registerTool: (name: string, def: ToolDef) => void;
+    getRegistry: () => War3Registry;
     getAvailableEvents: () => War3EventDef[];
     getAvailableActions: () => War3ActionDef[];
     getAvailableConditions: () => War3ConditionDef[];
@@ -117,22 +133,24 @@ interface War3Editor extends Editor<War3EditorState> {
 }
 declare function createWar3Editor(): War3Editor;
 
-/**
- * War3 注册表 - 继承 BaseRegistry，增加 Tool 注册能力
- */
-declare class War3Registry extends BaseRegistry<War3EventDef, War3ActionDef, War3ConditionDef> {
-    private tools;
-    registerTool(name: string, def: ToolDef): void;
-    getTool(name: string): ToolDef | undefined;
-    getTools(): Map<string, ToolDef>;
-}
-
 declare function getEventDescriptor(registry: War3Registry, type: string, slotValues?: Record<string, SlotValueEntry>): ItemDescriptor | null;
 declare function getActionDescriptor(registry: War3Registry, type: string, slotValues?: Record<string, SlotValueEntry>): ItemDescriptor | null;
 declare function getConditionDescriptor(registry: War3Registry, type: 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;
+
 /**
  * 解析模板字符串为 Segment 数组
  * 模板格式: "普通文本${slotKey}更多文本"
@@ -178,5 +196,5 @@ declare class War3EditorStateManager extends ObservableState<War3EditorState> {
     reset(): void;
 }
 
-export { War3EditorStateManager, War3Registry, createWar3Editor, defineWar3Preset, getActionDescriptor, getConditionDescriptor, getEventDescriptor, getSlotToolDescriptors, getToolDescriptor, parseTemplate, resolveSlotValue, toRule };
+export { War3EditorStateManager, War3Registry, createWar3Editor, defineWar3Preset, getActionDescriptor, getConditionDescriptor, getEventDescriptor, getSlotToolDescriptors, getToolDescriptor, parseTemplate, resolveSlotDisplayText, resolveSlotValue, toRule };
 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,7 +1,11 @@
-import { BaseItemDef, Editor, Preset, BaseRegistry, ObservableState } from '@triggerix/editor';
+import { BaseRegistry, Editor, Preset, ObservableState } from '@triggerix/editor';
 export { Preset } from '@triggerix/editor';
 import { Rule } from '@triggerix/core';
 
+interface BaseItemDef {
+    type: string;
+    label?: string;
+}
 interface SlotDef {
     label: string;
     tools: string[];
@@ -15,7 +19,7 @@ interface LeafToolInput {
     type: 'text' | 'number' | 'select';
     placeholder?: string;
     options?: Array<{
-        value: string;
+        value: unknown;
         label: string;
     }>;
 }
@@ -54,6 +58,7 @@ type Segment = {
     label: string;
     tools: string[];
     value: unknown;
+    entry?: SlotValueEntry;
 };
 interface ItemDescriptor {
     type: string;
@@ -89,11 +94,22 @@ interface War3PresetOptions {
     tools?: Record<string, ToolDef>;
 }
 
+/**
+ * War3 注册表 - 继承 BaseRegistry，增加 Tool 注册能力
+ */
+declare class War3Registry extends BaseRegistry<War3EventDef, War3ActionDef, War3ConditionDef> {
+    private tools;
+    registerTool(name: string, def: ToolDef): void;
+    getTool(name: string): ToolDef | undefined;
+    getTools(): Map<string, ToolDef>;
+}
+
 interface War3Editor extends Editor<War3EditorState> {
     registerEvent: (def: War3EventDef) => void;
     registerAction: (def: War3ActionDef) => void;
     registerCondition: (def: War3ConditionDef) => void;
     registerTool: (name: string, def: ToolDef) => void;
+    getRegistry: () => War3Registry;
     getAvailableEvents: () => War3EventDef[];
     getAvailableActions: () => War3ActionDef[];
     getAvailableConditions: () => War3ConditionDef[];
@@ -117,22 +133,24 @@ interface War3Editor extends Editor<War3EditorState> {
 }
 declare function createWar3Editor(): War3Editor;
 
-/**
- * War3 注册表 - 继承 BaseRegistry，增加 Tool 注册能力
- */
-declare class War3Registry extends BaseRegistry<War3EventDef, War3ActionDef, War3ConditionDef> {
-    private tools;
-    registerTool(name: string, def: ToolDef): void;
-    getTool(name: string): ToolDef | undefined;
-    getTools(): Map<string, ToolDef>;
-}
-
 declare function getEventDescriptor(registry: War3Registry, type: string, slotValues?: Record<string, SlotValueEntry>): ItemDescriptor | null;
 declare function getActionDescriptor(registry: War3Registry, type: string, slotValues?: Record<string, SlotValueEntry>): ItemDescriptor | null;
 declare function getConditionDescriptor(registry: War3Registry, type: 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;
+
 /**
  * 解析模板字符串为 Segment 数组
  * 模板格式: "普通文本${slotKey}更多文本"
@@ -178,5 +196,5 @@ declare class War3EditorStateManager extends ObservableState<War3EditorState> {
     reset(): void;
 }
 
-export { War3EditorStateManager, War3Registry, createWar3Editor, defineWar3Preset, getActionDescriptor, getConditionDescriptor, getEventDescriptor, getSlotToolDescriptors, getToolDescriptor, parseTemplate, resolveSlotValue, toRule };
+export { War3EditorStateManager, War3Registry, createWar3Editor, defineWar3Preset, getActionDescriptor, getConditionDescriptor, getEventDescriptor, getSlotToolDescriptors, getToolDescriptor, parseTemplate, resolveSlotDisplayText, resolveSlotValue, toRule };
 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,7 +1,11 @@
-import { BaseItemDef, Editor, Preset, BaseRegistry, ObservableState } from '@triggerix/editor';
+import { BaseRegistry, Editor, Preset, ObservableState } from '@triggerix/editor';
 export { Preset } from '@triggerix/editor';
 import { Rule } from '@triggerix/core';
 
+interface BaseItemDef {
+    type: string;
+    label?: string;
+}
 interface SlotDef {
     label: string;
     tools: string[];
@@ -15,7 +19,7 @@ interface LeafToolInput {
     type: 'text' | 'number' | 'select';
     placeholder?: string;
     options?: Array<{
-        value: string;
+        value: unknown;
         label: string;
     }>;
 }
@@ -54,6 +58,7 @@ type Segment = {
     label: string;
     tools: string[];
     value: unknown;
+    entry?: SlotValueEntry;
 };
 interface ItemDescriptor {
     type: string;
@@ -89,11 +94,22 @@ interface War3PresetOptions {
     tools?: Record<string, ToolDef>;
 }
 
+/**
+ * War3 注册表 - 继承 BaseRegistry，增加 Tool 注册能力
+ */
+declare class War3Registry extends BaseRegistry<War3EventDef, War3ActionDef, War3ConditionDef> {
+    private tools;
+    registerTool(name: string, def: ToolDef): void;
+    getTool(name: string): ToolDef | undefined;
+    getTools(): Map<string, ToolDef>;
+}
+
 interface War3Editor extends Editor<War3EditorState> {
     registerEvent: (def: War3EventDef) => void;
     registerAction: (def: War3ActionDef) => void;
     registerCondition: (def: War3ConditionDef) => void;
     registerTool: (name: string, def: ToolDef) => void;
+    getRegistry: () => War3Registry;
     getAvailableEvents: () => War3EventDef[];
     getAvailableActions: () => War3ActionDef[];
     getAvailableConditions: () => War3ConditionDef[];
@@ -117,22 +133,24 @@ interface War3Editor extends Editor<War3EditorState> {
 }
 declare function createWar3Editor(): War3Editor;
 
-/**
- * War3 注册表 - 继承 BaseRegistry，增加 Tool 注册能力
- */
-declare class War3Registry extends BaseRegistry<War3EventDef, War3ActionDef, War3ConditionDef> {
-    private tools;
-    registerTool(name: string, def: ToolDef): void;
-    getTool(name: string): ToolDef | undefined;
-    getTools(): Map<string, ToolDef>;
-}
-
 declare function getEventDescriptor(registry: War3Registry, type: string, slotValues?: Record<string, SlotValueEntry>): ItemDescriptor | null;
 declare function getActionDescriptor(registry: War3Registry, type: string, slotValues?: Record<string, SlotValueEntry>): ItemDescriptor | null;
 declare function getConditionDescriptor(registry: War3Registry, type: 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;
+
 /**
  * 解析模板字符串为 Segment 数组
  * 模板格式: "普通文本${slotKey}更多文本"
@@ -178,5 +196,5 @@ declare class War3EditorStateManager extends ObservableState<War3EditorState> {
     reset(): void;
 }
 
-export { War3EditorStateManager, War3Registry, createWar3Editor, defineWar3Preset, getActionDescriptor, getConditionDescriptor, getEventDescriptor, getSlotToolDescriptors, getToolDescriptor, parseTemplate, resolveSlotValue, toRule };
+export { War3EditorStateManager, War3Registry, createWar3Editor, defineWar3Preset, getActionDescriptor, getConditionDescriptor, getEventDescriptor, getSlotToolDescriptors, getToolDescriptor, parseTemplate, resolveSlotDisplayText, resolveSlotValue, toRule };
 export type { CompositeToolDef, CompositeToolDescriptor, ItemDescriptor, ItemState, LeafToolDef, LeafToolDescriptor, LeafToolInput, Segment, SlotDef, SlotValueEntry, ToolDef, ToolDescriptor, War3ActionDef, War3ConditionDef, War3Editor, War3EditorState, War3EventDef, War3PresetOptions };

package/dist/index.mjs

@@ -18,7 +18,8 @@ function parseTemplate(template, slots, slotValues) {
         key,
         label: slotDef.label,
         tools: slotDef.tools,
-        value: entry?.value ?? null
+        value: entry?.value ?? null,
+        entry: entry ?? void 0
       });
     } else {
       segments.push({ type: "text", content: match[0] });
@@ -271,6 +272,8 @@ function createWar3Editor() {
     registerAction: (def) => registry.registerAction(def),
     registerCondition: (def) => registry.registerCondition(def),
     registerTool: (name, def) => registry.registerTool(name, def),
+    // --- 注册表访问 ---
+    getRegistry: () => registry,
     // --- 查询 ---
     getAvailableEvents: () => registry.getEvents(),
     getAvailableActions: () => registry.getActions(),
@@ -319,6 +322,54 @@ function createWar3Editor() {
   return editor;
 }
 
+function valueEquals(a, b) {
+  if (a === b) return true;
+  if (a == null || b == null) return false;
+  if (typeof a !== "object" || typeof b !== "object") return false;
+  try {
+    return JSON.stringify(a) === JSON.stringify(b);
+  } catch {
+    return false;
+  }
+}
+function stringifyValue(v) {
+  if (v == null) return "";
+  if (typeof v === "string" || typeof v === "number" || typeof v === "boolean")
+    return String(v);
+  try {
+    return JSON.stringify(v);
+  } catch {
+    return String(v);
+  }
+}
+function resolveSlotDisplayText(entry, registry, fallbackLabel) {
+  if (!entry?.tool)
+    return fallbackLabel;
+  const toolDef = registry.getTool(entry.tool);
+  if (!toolDef)
+    return fallbackLabel;
+  if (toolDef.type === "leaf") {
+    if (entry.value == null || entry.value === "")
+      return fallbackLabel;
+    if (toolDef.input.type === "select") {
+      const opt = toolDef.input.options?.find((o) => valueEquals(o.value, entry.value));
+      if (opt)
+        return opt.label;
+    }
+    return stringifyValue(entry.value);
+  }
+  const segments = parseTemplate(toolDef.template, toolDef.slots, entry.subSlots ?? {});
+  return segments.map((seg) => {
+    if (seg.type === "text")
+      return seg.content;
+    if (seg.type === "slot") {
+      const subEntry = entry.subSlots?.[seg.key];
+      return resolveSlotDisplayText(subEntry ?? null, registry, seg.label);
+    }
+    return "";
+  }).join("");
+}
+
 function defineWar3Preset(options) {
   return {
     name: options.name,
@@ -335,4 +386,4 @@ function defineWar3Preset(options) {
   };
 }
 
-export { War3EditorStateManager, War3Registry, createWar3Editor, defineWar3Preset, getActionDescriptor, getConditionDescriptor, getEventDescriptor, getSlotToolDescriptors, getToolDescriptor, parseTemplate, resolveSlotValue, toRule };
+export { War3EditorStateManager, War3Registry, createWar3Editor, defineWar3Preset, getActionDescriptor, getConditionDescriptor, getEventDescriptor, getSlotToolDescriptors, getToolDescriptor, parseTemplate, resolveSlotDisplayText, resolveSlotValue, toRule };

package/package.json

@@ -1,11 +1,16 @@
 {
   "name": "triggerix-ui-preset-war3",
-  "version": "0.0.0",
-  "description": "War3-style template editor preset for Triggerix",
   "type": "module",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
+  "version": "0.0.2",
+  "description": "War3-style template editor preset for Triggerix",
+  "homepage": "https://github.com/triggerix-lang/triggerix-ui-preset-war3#readme",
+  "repository": {
+    "type": "git",
+    "url": "git@github.com:triggerix-lang/triggerix-ui-preset-war3.git"
+  },
+  "bugs": {
+    "url": "https://github.com/triggerix-lang/triggerix-ui-preset-war3/issues"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -13,20 +18,37 @@
       "require": "./dist/index.cjs"
     }
   },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
   "files": [
     "dist"
   ],
   "dependencies": {
-    "@triggerix/core": "^0.0.3",
-    "@triggerix/editor": "^0.0.3"
+    "@triggerix/core": "^0.0.4",
+    "@triggerix/editor": "^0.0.4"
   },
   "devDependencies": {
+    "@antfu/eslint-config": "^9.0.0",
+    "bumpp": "^11.1.0",
+    "eslint": "^10.5.0",
+    "jiti": "^2.7.0",
+    "nano-staged": "^1.0.2",
+    "simple-git-hooks": "^2.13.1",
     "typescript": "^6.0.3",
     "unbuild": "^3.6.1"
   },
+  "simple-git-hooks": {
+    "pre-commit": "pnpm nano-staged"
+  },
+  "nano-staged": {
+    "*": "eslint --cache --fix"
+  },
   "scripts": {
     "build": "unbuild",
     "dev": "unbuild --stub",
-    "typecheck": "tsc --noEmit"
+    "lint": "eslint --cache",
+    "typecheck": "tsc --noEmit",
+    "release": "bumpp"
   }
 }