@eva/plugin-state-machine 2.1.0-beta.1 → 2.1.0-beta.3

package/dist/plugin-state-machine.cjs.js

@@ -0,0 +1,193 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var eva_js = require('@eva/eva.js');
+var pluginSignalBus = require('@eva/plugin-signal-bus');
+
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+
+function __decorate(decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
+
+/**
+ * StateMachine 组件 — 简易有限状态机。
+ *
+ * DSL 用法:
+ * ```json
+ * {
+ *   "type": "StateMachine",
+ *   "props": {
+ *     "initial": "moving",
+ *     "states": {
+ *       "moving":   { "onEnter": "monster:state-moving",
+ *                     "transitions": [
+ *                       { "on": "monster:hit", "to": "knockback" },
+ *                       { "after": 3000, "to": "resting" }
+ *                     ] },
+ *       "resting":  { "transitions": [{ "after": 1000, "to": "moving" }] },
+ *       "knockback":{ "transitions": [{ "after": 800, "to": "resting" }] }
+ *     },
+ *     "signalChange": "monster:state-change"
+ *   }
+ * }
+ * ```
+ *
+ * 行为:
+ * - 进入状态:emit `onEnter` + `signalChange` { from, to }
+ * - `transitions[i].on`: 监听信号,信号触发即迁移
+ * - `transitions[i].after`: 进入状态 N ms 后自动迁移
+ * - `transitions[i].guard`: JS 表达式,以 `ctx` 为变量,假则跳过该规则
+ *
+ * 不主动 emit 任何 lifecycle 信号超出上述列表;复杂语义请组合多个规则。
+ */
+exports.StateMachine = class StateMachine extends eva_js.Component {
+    constructor() {
+        super(...arguments);
+        this.states = {};
+        this.current = '';
+        this.elapsedInState = 0;
+        this.subs = [];
+        /** 上下文,guard 可读 */
+        this.ctx = {};
+    }
+    init(params) {
+        var _a, _b;
+        if (!params)
+            return;
+        this.states = (_a = params.states) !== null && _a !== void 0 ? _a : {};
+        this.signalChange = params.signalChange;
+        this.ctx = (_b = params.context) !== null && _b !== void 0 ? _b : {};
+        if (params.initial && this.states[params.initial]) {
+            this.enter(params.initial, '__init__');
+        }
+    }
+    /** 主动迁移(代码侧也能调) */
+    goto(to, reason = 'manual') {
+        var _a;
+        if (!this.states[to]) {
+            // eslint-disable-next-line no-console
+            console.warn(`[plugin-state-machine] no such state: ${to}`);
+            return;
+        }
+        if (this.current === to)
+            return;
+        const from = this.current;
+        if (from && ((_a = this.states[from]) === null || _a === void 0 ? void 0 : _a.onExit)) {
+            pluginSignalBus.getSignalBus().emit(this.states[from].onExit, { from, to, reason });
+        }
+        this.cleanupSubs();
+        this.enter(to, reason);
+    }
+    get state() {
+        return this.current;
+    }
+    enter(to, reason) {
+        var _a;
+        const from = this.current;
+        this.current = to;
+        this.elapsedInState = 0;
+        const cfg = this.states[to];
+        if (!cfg)
+            return;
+        if (cfg.onEnter)
+            pluginSignalBus.getSignalBus().emit(cfg.onEnter, { from, to, reason });
+        if (this.signalChange)
+            pluginSignalBus.getSignalBus().emit(this.signalChange, { from, to, reason });
+        // 订阅本 state 的 on 信号
+        const bus = pluginSignalBus.getSignalBus();
+        for (const t of (_a = cfg.transitions) !== null && _a !== void 0 ? _a : []) {
+            if (!t.on)
+                continue;
+            const target = t.to;
+            const guard = t.guard;
+            const h = bus.on(t.on, () => {
+                if (this.current !== to)
+                    return; // 已经离开
+                if (guard && !this.evalGuard(guard))
+                    return;
+                this.goto(target, t.on);
+            });
+            this.subs.push(h);
+        }
+    }
+    cleanupSubs() {
+        for (const h of this.subs)
+            h.dispose();
+        this.subs = [];
+    }
+    evalGuard(guard) {
+        try {
+            // 简单 expression eval,只暴露 ctx
+            // eslint-disable-next-line @typescript-eslint/no-implied-eval, no-new-func
+            const fn = new Function('ctx', `return (${guard});`);
+            return Boolean(fn(this.ctx));
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.warn(`[plugin-state-machine] bad guard "${guard}":`, err);
+            return false;
+        }
+    }
+    update(e) {
+        this.elapsedInState += e.deltaTime;
+        const cfg = this.states[this.current];
+        if (!(cfg === null || cfg === void 0 ? void 0 : cfg.transitions))
+            return;
+        for (const t of cfg.transitions) {
+            if (t.after == null)
+                continue;
+            if (this.elapsedInState < t.after)
+                continue;
+            if (t.guard && !this.evalGuard(t.guard))
+                continue;
+            this.goto(t.to, `after:${t.after}`);
+            return;
+        }
+    }
+    onDestroy() {
+        this.cleanupSubs();
+    }
+};
+exports.StateMachine.componentName = 'StateMachine';
+exports.StateMachine = __decorate([
+    eva_js.decorators.componentObserver({})
+], exports.StateMachine);
+
+/**
+ * StateMachineSystem — 仅用于注册;StateMachine 自身在 Component.update 中驱动。
+ *
+ * 之所以保留这个空 System,是因为 Eva.js 的注册习惯是 component + system 成对出现,
+ * 而且未来如果要加全局调度(例如 group: physics 在 HitArea 之后才能切状态)可以扩展这里。
+ */
+class StateMachineSystem extends eva_js.System {
+    constructor() {
+        super(...arguments);
+        this.name = 'StateMachine';
+    }
+}
+StateMachineSystem.systemName = 'StateMachine';
+
+exports.StateMachineSystem = StateMachineSystem;

package/dist/plugin-state-machine.cjs.prod.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var t=require("@eva/eva.js"),e=require("@eva/plugin-signal-bus");"function"==typeof SuppressedError&&SuppressedError,exports.StateMachine=class extends t.Component{constructor(){super(...arguments),this.states={},this.current="",this.elapsedInState=0,this.subs=[],this.ctx={}}init(t){var e,s;t&&(this.states=null!==(e=t.states)&&void 0!==e?e:{},this.signalChange=t.signalChange,this.ctx=null!==(s=t.context)&&void 0!==s?s:{},t.initial&&this.states[t.initial]&&this.enter(t.initial,"__init__"))}goto(t,s="manual"){var n;if(!this.states[t])return void console.warn(`[plugin-state-machine] no such state: ${t}`);if(this.current===t)return;const i=this.current;i&&(null===(n=this.states[i])||void 0===n?void 0:n.onExit)&&e.getSignalBus().emit(this.states[i].onExit,{from:i,to:t,reason:s}),this.cleanupSubs(),this.enter(t,s)}get state(){return this.current}enter(t,s){var n;const i=this.current;this.current=t,this.elapsedInState=0;const r=this.states[t];if(!r)return;r.onEnter&&e.getSignalBus().emit(r.onEnter,{from:i,to:t,reason:s}),this.signalChange&&e.getSignalBus().emit(this.signalChange,{from:i,to:t,reason:s});const a=e.getSignalBus();for(const e of null!==(n=r.transitions)&&void 0!==n?n:[]){if(!e.on)continue;const s=e.to,n=e.guard,i=a.on(e.on,()=>{this.current===t&&(n&&!this.evalGuard(n)||this.goto(s,e.on))});this.subs.push(i)}}cleanupSubs(){for(const t of this.subs)t.dispose();this.subs=[]}evalGuard(t){try{const e=new Function("ctx",`return (${t});`);return Boolean(e(this.ctx))}catch(e){return console.warn(`[plugin-state-machine] bad guard "${t}":`,e),!1}}update(t){this.elapsedInState+=t.deltaTime;const e=this.states[this.current];if(null==e?void 0:e.transitions)for(const t of e.transitions)if(null!=t.after&&!(this.elapsedInState<t.after)&&(!t.guard||this.evalGuard(t.guard)))return void this.goto(t.to,`after:${t.after}`)}onDestroy(){this.cleanupSubs()}},exports.StateMachine.componentName="StateMachine",exports.StateMachine=function(t,e,s,n){var i,r=arguments.length,a=r<3?e:null===n?n=Object.getOwnPropertyDescriptor(e,s):n;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)a=Reflect.decorate(t,e,s,n);else for(var o=t.length-1;o>=0;o--)(i=t[o])&&(a=(r<3?i(a):r>3?i(e,s,a):i(e,s))||a);return r>3&&a&&Object.defineProperty(e,s,a),a}([t.decorators.componentObserver({})],exports.StateMachine);class s extends t.System{constructor(){super(...arguments),this.name="StateMachine"}}s.systemName="StateMachine",exports.StateMachineSystem=s;

package/dist/plugin-state-machine.d.ts

@@ -0,0 +1,98 @@
+import { Component } from '@eva/eva.js';
+import { System } from '@eva/eva.js';
+
+export declare interface StateConfig {
+    /** 进入时 emit 的信号 */
+    onEnter?: string;
+    /** 退出时 emit 的信号 */
+    onExit?: string;
+    /** 该状态下的迁移规则 */
+    transitions?: TransitionRule[];
+}
+
+/**
+ * StateMachine 组件 — 简易有限状态机。
+ *
+ * DSL 用法:
+ * ```json
+ * {
+ *   "type": "StateMachine",
+ *   "props": {
+ *     "initial": "moving",
+ *     "states": {
+ *       "moving":   { "onEnter": "monster:state-moving",
+ *                     "transitions": [
+ *                       { "on": "monster:hit", "to": "knockback" },
+ *                       { "after": 3000, "to": "resting" }
+ *                     ] },
+ *       "resting":  { "transitions": [{ "after": 1000, "to": "moving" }] },
+ *       "knockback":{ "transitions": [{ "after": 800, "to": "resting" }] }
+ *     },
+ *     "signalChange": "monster:state-change"
+ *   }
+ * }
+ * ```
+ *
+ * 行为:
+ * - 进入状态:emit `onEnter` + `signalChange` { from, to }
+ * - `transitions[i].on`: 监听信号,信号触发即迁移
+ * - `transitions[i].after`: 进入状态 N ms 后自动迁移
+ * - `transitions[i].guard`: JS 表达式,以 `ctx` 为变量,假则跳过该规则
+ *
+ * 不主动 emit 任何 lifecycle 信号超出上述列表;复杂语义请组合多个规则。
+ */
+export declare class StateMachine extends Component<StateMachineParams> {
+    static componentName: string;
+    private states;
+    private current;
+    private signalChange?;
+    private elapsedInState;
+    private subs;
+    /** 上下文,guard 可读 */
+    ctx: Record<string, any>;
+    init(params?: StateMachineParams): void;
+    /** 主动迁移(代码侧也能调) */
+    goto(to: string, reason?: string): void;
+    get state(): string;
+    private enter;
+    private cleanupSubs;
+    private evalGuard;
+    update(e: {
+        deltaTime: number;
+    }): void;
+    onDestroy(): void;
+}
+
+export declare interface StateMachineParams {
+    initial: string;
+    states: Record<string, StateConfig>;
+    /** 状态切换 emit 信号 */
+    signalChange?: string;
+    /** 上下文变量,可在 guard 中读 */
+    context?: Record<string, any>;
+}
+
+/**
+ * StateMachineSystem — 仅用于注册;StateMachine 自身在 Component.update 中驱动。
+ *
+ * 之所以保留这个空 System,是因为 Eva.js 的注册习惯是 component + system 成对出现,
+ * 而且未来如果要加全局调度(例如 group: physics 在 HitArea 之后才能切状态)可以扩展这里。
+ */
+export declare class StateMachineSystem extends System {
+    static systemName: string;
+    readonly name = "StateMachine";
+}
+
+/** 单条迁移规则 */
+export declare interface TransitionRule {
+    /** 触发该迁移的信号名 */
+    on?: string;
+    /** 进入该状态后等待 N ms 自动迁移(可与 on 二选一) */
+    after?: number;
+    /** 目标状态名 */
+    to: string;
+    /** 可选:JS 表达式字符串,以 ctx 为上下文 */
+    guard?: string;
+}
+
+export { }

package/dist/plugin-state-machine.esm.js

@@ -0,0 +1,189 @@
+import { Component, decorators, System } from '@eva/eva.js';
+import { getSignalBus } from '@eva/plugin-signal-bus';
+
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+
+function __decorate(decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
+
+/**
+ * StateMachine 组件 — 简易有限状态机。
+ *
+ * DSL 用法:
+ * ```json
+ * {
+ *   "type": "StateMachine",
+ *   "props": {
+ *     "initial": "moving",
+ *     "states": {
+ *       "moving":   { "onEnter": "monster:state-moving",
+ *                     "transitions": [
+ *                       { "on": "monster:hit", "to": "knockback" },
+ *                       { "after": 3000, "to": "resting" }
+ *                     ] },
+ *       "resting":  { "transitions": [{ "after": 1000, "to": "moving" }] },
+ *       "knockback":{ "transitions": [{ "after": 800, "to": "resting" }] }
+ *     },
+ *     "signalChange": "monster:state-change"
+ *   }
+ * }
+ * ```
+ *
+ * 行为:
+ * - 进入状态:emit `onEnter` + `signalChange` { from, to }
+ * - `transitions[i].on`: 监听信号,信号触发即迁移
+ * - `transitions[i].after`: 进入状态 N ms 后自动迁移
+ * - `transitions[i].guard`: JS 表达式,以 `ctx` 为变量,假则跳过该规则
+ *
+ * 不主动 emit 任何 lifecycle 信号超出上述列表;复杂语义请组合多个规则。
+ */
+let StateMachine = class StateMachine extends Component {
+    constructor() {
+        super(...arguments);
+        this.states = {};
+        this.current = '';
+        this.elapsedInState = 0;
+        this.subs = [];
+        /** 上下文,guard 可读 */
+        this.ctx = {};
+    }
+    init(params) {
+        var _a, _b;
+        if (!params)
+            return;
+        this.states = (_a = params.states) !== null && _a !== void 0 ? _a : {};
+        this.signalChange = params.signalChange;
+        this.ctx = (_b = params.context) !== null && _b !== void 0 ? _b : {};
+        if (params.initial && this.states[params.initial]) {
+            this.enter(params.initial, '__init__');
+        }
+    }
+    /** 主动迁移(代码侧也能调) */
+    goto(to, reason = 'manual') {
+        var _a;
+        if (!this.states[to]) {
+            // eslint-disable-next-line no-console
+            console.warn(`[plugin-state-machine] no such state: ${to}`);
+            return;
+        }
+        if (this.current === to)
+            return;
+        const from = this.current;
+        if (from && ((_a = this.states[from]) === null || _a === void 0 ? void 0 : _a.onExit)) {
+            getSignalBus().emit(this.states[from].onExit, { from, to, reason });
+        }
+        this.cleanupSubs();
+        this.enter(to, reason);
+    }
+    get state() {
+        return this.current;
+    }
+    enter(to, reason) {
+        var _a;
+        const from = this.current;
+        this.current = to;
+        this.elapsedInState = 0;
+        const cfg = this.states[to];
+        if (!cfg)
+            return;
+        if (cfg.onEnter)
+            getSignalBus().emit(cfg.onEnter, { from, to, reason });
+        if (this.signalChange)
+            getSignalBus().emit(this.signalChange, { from, to, reason });
+        // 订阅本 state 的 on 信号
+        const bus = getSignalBus();
+        for (const t of (_a = cfg.transitions) !== null && _a !== void 0 ? _a : []) {
+            if (!t.on)
+                continue;
+            const target = t.to;
+            const guard = t.guard;
+            const h = bus.on(t.on, () => {
+                if (this.current !== to)
+                    return; // 已经离开
+                if (guard && !this.evalGuard(guard))
+                    return;
+                this.goto(target, t.on);
+            });
+            this.subs.push(h);
+        }
+    }
+    cleanupSubs() {
+        for (const h of this.subs)
+            h.dispose();
+        this.subs = [];
+    }
+    evalGuard(guard) {
+        try {
+            // 简单 expression eval,只暴露 ctx
+            // eslint-disable-next-line @typescript-eslint/no-implied-eval, no-new-func
+            const fn = new Function('ctx', `return (${guard});`);
+            return Boolean(fn(this.ctx));
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.warn(`[plugin-state-machine] bad guard "${guard}":`, err);
+            return false;
+        }
+    }
+    update(e) {
+        this.elapsedInState += e.deltaTime;
+        const cfg = this.states[this.current];
+        if (!(cfg === null || cfg === void 0 ? void 0 : cfg.transitions))
+            return;
+        for (const t of cfg.transitions) {
+            if (t.after == null)
+                continue;
+            if (this.elapsedInState < t.after)
+                continue;
+            if (t.guard && !this.evalGuard(t.guard))
+                continue;
+            this.goto(t.to, `after:${t.after}`);
+            return;
+        }
+    }
+    onDestroy() {
+        this.cleanupSubs();
+    }
+};
+StateMachine.componentName = 'StateMachine';
+StateMachine = __decorate([
+    decorators.componentObserver({})
+], StateMachine);
+
+/**
+ * StateMachineSystem — 仅用于注册;StateMachine 自身在 Component.update 中驱动。
+ *
+ * 之所以保留这个空 System,是因为 Eva.js 的注册习惯是 component + system 成对出现,
+ * 而且未来如果要加全局调度(例如 group: physics 在 HitArea 之后才能切状态)可以扩展这里。
+ */
+class StateMachineSystem extends System {
+    constructor() {
+        super(...arguments);
+        this.name = 'StateMachine';
+    }
+}
+StateMachineSystem.systemName = 'StateMachine';
+
+export { StateMachine, StateMachineSystem };

package/index.js

@@ -0,0 +1,7 @@
+'use strict';
+
+if (process.env.NODE_ENV === 'production') {
+  module.exports = require('./dist/plugin-state-machine.cjs.prod.js');
+} else {
+  module.exports = require('./dist/plugin-state-machine.cjs.js');
+}

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@eva/plugin-state-machine",
-  "version": "2.1.0-beta.1",
+  "version": "2.1.0-beta.3",
   "description": "Finite state machine — DSL 声明 states/transitions/timeouts/guards/actions,emit state-change 信号。",
-  "main": "lib/index.ts",
-  "module": "lib/index.ts",
-  "types": "lib/index.ts",
+  "main": "index.js",
+  "module": "dist/plugin-state-machine.esm.js",
+  "types": "dist/plugin-state-machine.d.ts",
   "files": [
-    "lib"
+    "index.js",
+    "dist"
   ],
   "keywords": [
     "eva.js",
@@ -16,7 +17,7 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@eva/eva.js": "2.1.0-beta.1",
-    "@eva/plugin-signal-bus": "2.1.0-beta.1"
+    "@eva/eva.js": "2.1.0-beta.3",
+    "@eva/plugin-signal-bus": "2.1.0-beta.3"
   }
 }

package/lib/StateMachine.ts

@@ -1,136 +0,0 @@
-import { Component, decorators } from '@eva/eva.js';
-import { getSignalBus, SignalHandle } from '@eva/plugin-signal-bus';
-import type { StateMachineParams, StateConfig } from './types';
-
-/**
- * StateMachine 组件 — 简易有限状态机。
- *
- * DSL 用法:
- * ```json
- * {
- *   "type": "StateMachine",
- *   "props": {
- *     "initial": "moving",
- *     "states": {
- *       "moving":   { "onEnter": "monster:state-moving",
- *                     "transitions": [
- *                       { "on": "monster:hit", "to": "knockback" },
- *                       { "after": 3000, "to": "resting" }
- *                     ] },
- *       "resting":  { "transitions": [{ "after": 1000, "to": "moving" }] },
- *       "knockback":{ "transitions": [{ "after": 800, "to": "resting" }] }
- *     },
- *     "signalChange": "monster:state-change"
- *   }
- * }
- * ```
- *
- * 行为:
- * - 进入状态:emit `onEnter` + `signalChange` { from, to }
- * - `transitions[i].on`: 监听信号,信号触发即迁移
- * - `transitions[i].after`: 进入状态 N ms 后自动迁移
- * - `transitions[i].guard`: JS 表达式,以 `ctx` 为变量,假则跳过该规则
- *
- * 不主动 emit 任何 lifecycle 信号超出上述列表;复杂语义请组合多个规则。
- */
-@decorators.componentObserver({})
-export class StateMachine extends Component<StateMachineParams> {
-  static componentName = 'StateMachine';
-
-  private states: Record<string, StateConfig> = {};
-  private current: string = '';
-  private signalChange?: string;
-  private elapsedInState = 0;
-  private subs: SignalHandle[] = [];
-
-  /** 上下文,guard 可读 */
-  ctx: Record<string, any> = {};
-
-  init(params?: StateMachineParams) {
-    if (!params) return;
-    this.states = params.states ?? {};
-    this.signalChange = params.signalChange;
-    this.ctx = params.context ?? {};
-    if (params.initial && this.states[params.initial]) {
-      this.enter(params.initial, '__init__');
-    }
-  }
-
-  /** 主动迁移(代码侧也能调) */
-  goto(to: string, reason: string = 'manual') {
-    if (!this.states[to]) {
-      // eslint-disable-next-line no-console
-      console.warn(`[plugin-state-machine] no such state: ${to}`);
-      return;
-    }
-    if (this.current === to) return;
-    const from = this.current;
-    if (from && this.states[from]?.onExit) {
-      getSignalBus().emit(this.states[from].onExit!, { from, to, reason });
-    }
-    this.cleanupSubs();
-    this.enter(to, reason);
-  }
-
-  get state(): string {
-    return this.current;
-  }
-
-  private enter(to: string, reason: string) {
-    const from = this.current;
-    this.current = to;
-    this.elapsedInState = 0;
-    const cfg = this.states[to];
-    if (!cfg) return;
-    if (cfg.onEnter) getSignalBus().emit(cfg.onEnter, { from, to, reason });
-    if (this.signalChange) getSignalBus().emit(this.signalChange, { from, to, reason });
-    // 订阅本 state 的 on 信号
-    const bus = getSignalBus();
-    for (const t of cfg.transitions ?? []) {
-      if (!t.on) continue;
-      const target = t.to;
-      const guard = t.guard;
-      const h = bus.on(t.on, () => {
-        if (this.current !== to) return; // 已经离开
-        if (guard && !this.evalGuard(guard)) return;
-        this.goto(target, t.on!);
-      });
-      this.subs.push(h);
-    }
-  }
-
-  private cleanupSubs() {
-    for (const h of this.subs) h.dispose();
-    this.subs = [];
-  }
-
-  private evalGuard(guard: string): boolean {
-    try {
-      // 简单 expression eval,只暴露 ctx
-      // eslint-disable-next-line @typescript-eslint/no-implied-eval, no-new-func
-      const fn = new Function('ctx', `return (${guard});`);
-      return Boolean(fn(this.ctx));
-    } catch (err) {
-      // eslint-disable-next-line no-console
-      console.warn(`[plugin-state-machine] bad guard "${guard}":`, err);
-      return false;
-    }
-  }
-
-  update(e: { deltaTime: number }) {
-    this.elapsedInState += e.deltaTime;
-    const cfg = this.states[this.current];
-    if (!cfg?.transitions) return;
-    for (const t of cfg.transitions) {
-      if (t.after == null) continue;
-      if (this.elapsedInState < t.after) continue;
-      if (t.guard && !this.evalGuard(t.guard)) continue;
-      this.goto(t.to, `after:${t.after}`);
-      return;
-    }
-  }
-
-  onDestroy() {
-    this.cleanupSubs();
-  }
-}

package/lib/StateMachineSystem.ts

@@ -1,12 +0,0 @@
-import { System } from '@eva/eva.js';
-
-/**
- * StateMachineSystem — 仅用于注册;StateMachine 自身在 Component.update 中驱动。
- *
- * 之所以保留这个空 System,是因为 Eva.js 的注册习惯是 component + system 成对出现,
- * 而且未来如果要加全局调度(例如 group: physics 在 HitArea 之后才能切状态)可以扩展这里。
- */
-export class StateMachineSystem extends System {
-  static systemName = 'StateMachine';
-  readonly name = 'StateMachine';
-}

package/lib/index.ts

@@ -1,3 +0,0 @@
-export { StateMachine } from './StateMachine';
-export { StateMachineSystem } from './StateMachineSystem';
-export type { StateMachineParams, StateConfig, TransitionRule } from './types';

package/lib/types.ts

@@ -1,29 +0,0 @@
-/** 单条迁移规则 */
-export interface TransitionRule {
-  /** 触发该迁移的信号名 */
-  on?: string;
-  /** 进入该状态后等待 N ms 自动迁移(可与 on 二选一) */
-  after?: number;
-  /** 目标状态名 */
-  to: string;
-  /** 可选:JS 表达式字符串,以 ctx 为上下文 */
-  guard?: string;
-}
-
-export interface StateConfig {
-  /** 进入时 emit 的信号 */
-  onEnter?: string;
-  /** 退出时 emit 的信号 */
-  onExit?: string;
-  /** 该状态下的迁移规则 */
-  transitions?: TransitionRule[];
-}
-
-export interface StateMachineParams {
-  initial: string;
-  states: Record<string, StateConfig>;
-  /** 状态切换 emit 信号 */
-  signalChange?: string;
-  /** 上下文变量,可在 guard 中读 */
-  context?: Record<string, any>;
-}