@eva/plugin-trigger 2.1.0-beta.1 → 2.1.0-beta.11

package/dist/plugin-trigger.cjs.js

@@ -0,0 +1,211 @@
+'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;
+};
+
+/**
+ * Trigger 组件 — 把信号映射成 DSL 动作。
+ *
+ * DSL 用法:
+ * ```json
+ * {
+ *   "type": "Trigger",
+ *   "props": {
+ *     "rules": [
+ *       { "on": "input:fire:press",
+ *         "do": [
+ *           { "type": "emit", "signal": "rocket:spawn" },
+ *           { "type": "incStore", "key": "shotsFired" }
+ *         ] },
+ *       { "on": "rocket:hit",
+ *         "guard": "ctx.allowedScene === true",
+ *         "do": [
+ *           { "type": "incStore", "key": "score" },
+ *           { "type": "emit", "signal": "monster:hurt" }
+ *         ] }
+ *     ]
+ *   }
+ * }
+ * ```
+ *
+ * 这是 plugin-state-machine 的"无状态弟弟":只配 input → output,不维护 state。
+ * 适合写 80% 的"按钮按下→记分"业务,大幅减少自定义 Component 数量。
+ */
+exports.Trigger = class Trigger extends eva_js.Component {
+    constructor() {
+        super(...arguments);
+        this.rules = [];
+        this.subs = [];
+        this.ctx = {};
+    }
+    init(params) {
+        var _a, _b;
+        if (!params)
+            return;
+        this.rules = (_a = params.rules) !== null && _a !== void 0 ? _a : [];
+        this.ctx = (_b = params.context) !== null && _b !== void 0 ? _b : {};
+    }
+    awake() {
+        const bus = pluginSignalBus.getSignalBus();
+        for (const rule of this.rules) {
+            const h = bus.on(rule.on, (payload) => {
+                if (rule.guard && !this.evalGuard(rule.guard, payload))
+                    return;
+                for (const a of rule.do)
+                    this.exec(a, payload);
+            });
+            this.subs.push(h);
+        }
+    }
+    exec(action, payload) {
+        var _a, _b, _c, _d;
+        try {
+            switch (action.type) {
+                case 'emit':
+                    pluginSignalBus.getSignalBus().emit(action.signal, (_a = action.payload) !== null && _a !== void 0 ? _a : payload);
+                    break;
+                case 'setStore':
+                    if (typeof mx !== 'undefined' && ((_b = mx === null || mx === void 0 ? void 0 : mx.store) === null || _b === void 0 ? void 0 : _b.update)) {
+                        mx.store.update(action.key, () => action.value);
+                    }
+                    break;
+                case 'incStore':
+                    if (typeof mx !== 'undefined' && ((_c = mx === null || mx === void 0 ? void 0 : mx.store) === null || _c === void 0 ? void 0 : _c.update)) {
+                        mx.store.update(action.key, (v) => { var _a; return (v !== null && v !== void 0 ? v : 0) + ((_a = action.delta) !== null && _a !== void 0 ? _a : 1); });
+                    }
+                    break;
+                case 'log':
+                    // eslint-disable-next-line no-console
+                    console.log('[trigger]', action.message, payload);
+                    break;
+                case 'callMethod':
+                    this.callMethod(action.entity, action.component, action.method, (_d = action.args) !== null && _d !== void 0 ? _d : [], action.ref);
+                    break;
+            }
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.warn('[plugin-trigger] action failed', action, err);
+        }
+    }
+    /**
+     * 按 (entity, componentName[, ref]) 查找并调用方法。
+     *
+     * ADR-0024B:加 `ref` 字段后修复 alert-chase.json 等模板"同 entity 多
+     * BehaviorScript / Trigger 静默 dedup"的 hidden broken state。匹配规则:
+     *   - 无 ref:按 `(entity, componentName)` 取首个命中(legacy 行为)
+     *   - 有 ref:按 `(entity, componentName, ref)` 三元组定位,匹配 instance.ref /
+     *           instance.name / constructor.ref 字段(优先 instance.ref,与
+     *           ADR-0021 BehaviorScript first-class 一致)
+     */
+    callMethod(entity, compName, method, args, ref) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        const game = (_b = (_a = this.gameObject) === null || _a === void 0 ? void 0 : _a.scene) === null || _b === void 0 ? void 0 : _b.game;
+        if (!game)
+            return;
+        const stack = [...((_d = (_c = game.scene) === null || _c === void 0 ? void 0 : _c.gameObjects) !== null && _d !== void 0 ? _d : [])];
+        while (stack.length) {
+            const go = stack.pop();
+            if (!go)
+                continue;
+            if (go.name === entity) {
+                const comps = (_e = go.components) !== null && _e !== void 0 ? _e : [];
+                const c = this.findComponentByRef(comps, compName, ref);
+                if (c && typeof c[method] === 'function') {
+                    c[method](...args);
+                }
+                return;
+            }
+            if ((_g = (_f = go.transform) === null || _f === void 0 ? void 0 : _f.children) === null || _g === void 0 ? void 0 : _g.length) {
+                for (const ch of go.transform.children)
+                    stack.push(ch.gameObject);
+            }
+        }
+    }
+    /**
+     * 从 comps 列表里取出符合 (componentName, ref) 的 Component 实例。
+     *
+     * `ref` 可选 - 未传时取首个 componentName 匹配的实例(legacy);传入时按
+     * 三元组定位,匹配优先级 instance.ref → instance.name → constructor.ref。
+     */
+    findComponentByRef(comps, componentName, ref) {
+        if (!ref) {
+            return comps.find((c) => { var _a; return ((_a = c === null || c === void 0 ? void 0 : c.constructor) === null || _a === void 0 ? void 0 : _a.componentName) === componentName; });
+        }
+        return comps.find((c) => {
+            var _a, _b;
+            if (((_a = c === null || c === void 0 ? void 0 : c.constructor) === null || _a === void 0 ? void 0 : _a.componentName) !== componentName)
+                return false;
+            // 优先 instance.ref(ADR-0021 BehaviorScript first-class)
+            if (typeof c.ref === 'string' && c.ref === ref)
+                return true;
+            // fallback:instance.name(自定义 Component 习惯字段)
+            if (typeof c.name === 'string' && c.name === ref)
+                return true;
+            // fallback:constructor.ref(静态标签)
+            if (((_b = c === null || c === void 0 ? void 0 : c.constructor) === null || _b === void 0 ? void 0 : _b.ref) === ref)
+                return true;
+            return false;
+        });
+    }
+    evalGuard(guard, payload) {
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-implied-eval, no-new-func
+            const fn = new Function('payload', 'ctx', `return (${guard});`);
+            return Boolean(fn(payload, this.ctx));
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.warn(`[plugin-trigger] bad guard "${guard}":`, err);
+            return false;
+        }
+    }
+    onDestroy() {
+        for (const h of this.subs)
+            h.dispose();
+        this.subs = [];
+    }
+};
+exports.Trigger.componentName = 'Trigger';
+exports.Trigger = __decorate([
+    eva_js.decorators.componentObserver({})
+], exports.Trigger);
+
+class TriggerSystem extends eva_js.System {
+    constructor() {
+        super(...arguments);
+        this.name = 'Trigger';
+    }
+}
+TriggerSystem.systemName = 'Trigger';
+
+exports.TriggerSystem = TriggerSystem;

package/dist/plugin-trigger.cjs.prod.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@eva/eva.js"),o=require("@eva/plugin-signal-bus");"function"==typeof SuppressedError&&SuppressedError,exports.Trigger=class extends e.Component{constructor(){super(...arguments),this.rules=[],this.subs=[],this.ctx={}}init(e){var o,t;e&&(this.rules=null!==(o=e.rules)&&void 0!==o?o:[],this.ctx=null!==(t=e.context)&&void 0!==t?t:{})}awake(){const e=o.getSignalBus();for(const o of this.rules){const t=e.on(o.on,e=>{if(!o.guard||this.evalGuard(o.guard,e))for(const t of o.do)this.exec(t,e)});this.subs.push(t)}}exec(e,t){var r,n,s,i;try{switch(e.type){case"emit":o.getSignalBus().emit(e.signal,null!==(r=e.payload)&&void 0!==r?r:t);break;case"setStore":"undefined"!=typeof mx&&(null===(n=null===mx||void 0===mx?void 0:mx.store)||void 0===n?void 0:n.update)&&mx.store.update(e.key,()=>e.value);break;case"incStore":"undefined"!=typeof mx&&(null===(s=null===mx||void 0===mx?void 0:mx.store)||void 0===s?void 0:s.update)&&mx.store.update(e.key,o=>{var t;return(null!=o?o:0)+(null!==(t=e.delta)&&void 0!==t?t:1)});break;case"log":console.log("[trigger]",e.message,t);break;case"callMethod":this.callMethod(e.entity,e.component,e.method,null!==(i=e.args)&&void 0!==i?i:[],e.ref)}}catch(o){console.warn("[plugin-trigger] action failed",e,o)}}callMethod(e,o,t,r,n){var s,i,l,u,c,a,d;const v=null===(i=null===(s=this.gameObject)||void 0===s?void 0:s.scene)||void 0===i?void 0:i.game;if(!v)return;const g=[...null!==(u=null===(l=v.scene)||void 0===l?void 0:l.gameObjects)&&void 0!==u?u:[]];for(;g.length;){const s=g.pop();if(s){if(s.name===e){const e=null!==(c=s.components)&&void 0!==c?c:[],i=this.findComponentByRef(e,o,n);return void(i&&"function"==typeof i[t]&&i[t](...r))}if(null===(d=null===(a=s.transform)||void 0===a?void 0:a.children)||void 0===d?void 0:d.length)for(const e of s.transform.children)g.push(e.gameObject)}}}findComponentByRef(e,o,t){return t?e.find(e=>{var r,n;return(null===(r=null==e?void 0:e.constructor)||void 0===r?void 0:r.componentName)===o&&("string"==typeof e.ref&&e.ref===t||("string"==typeof e.name&&e.name===t||(null===(n=null==e?void 0:e.constructor)||void 0===n?void 0:n.ref)===t))}):e.find(e=>{var t;return(null===(t=null==e?void 0:e.constructor)||void 0===t?void 0:t.componentName)===o})}evalGuard(e,o){try{const t=new Function("payload","ctx",`return (${e});`);return Boolean(t(o,this.ctx))}catch(o){return console.warn(`[plugin-trigger] bad guard "${e}":`,o),!1}}onDestroy(){for(const e of this.subs)e.dispose();this.subs=[]}},exports.Trigger.componentName="Trigger",exports.Trigger=function(e,o,t,r){var n,s=arguments.length,i=s<3?o:null===r?r=Object.getOwnPropertyDescriptor(o,t):r;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)i=Reflect.decorate(e,o,t,r);else for(var l=e.length-1;l>=0;l--)(n=e[l])&&(i=(s<3?n(i):s>3?n(o,t,i):n(o,t))||i);return s>3&&i&&Object.defineProperty(o,t,i),i}([e.decorators.componentObserver({})],exports.Trigger);class t extends e.System{constructor(){super(...arguments),this.name="Trigger"}}t.systemName="Trigger",exports.TriggerSystem=t;

package/dist/plugin-trigger.d.ts

@@ -0,0 +1,118 @@
+import { Component } from '@eva/eva.js';
+import { System } from '@eva/eva.js';
+
+/**
+ * Trigger 组件 — 把信号映射成 DSL 动作。
+ *
+ * DSL 用法:
+ * ```json
+ * {
+ *   "type": "Trigger",
+ *   "props": {
+ *     "rules": [
+ *       { "on": "input:fire:press",
+ *         "do": [
+ *           { "type": "emit", "signal": "rocket:spawn" },
+ *           { "type": "incStore", "key": "shotsFired" }
+ *         ] },
+ *       { "on": "rocket:hit",
+ *         "guard": "ctx.allowedScene === true",
+ *         "do": [
+ *           { "type": "incStore", "key": "score" },
+ *           { "type": "emit", "signal": "monster:hurt" }
+ *         ] }
+ *     ]
+ *   }
+ * }
+ * ```
+ *
+ * 这是 plugin-state-machine 的"无状态弟弟":只配 input → output,不维护 state。
+ * 适合写 80% 的"按钮按下→记分"业务,大幅减少自定义 Component 数量。
+ */
+export declare class Trigger extends Component<TriggerParams> {
+    static componentName: string;
+    private rules;
+    private subs;
+    ctx: Record<string, any>;
+    init(params?: TriggerParams): void;
+    awake(): void;
+    private exec;
+    /**
+     * 按 (entity, componentName[, ref]) 查找并调用方法。
+     *
+     * ADR-0024B:加 `ref` 字段后修复 alert-chase.json 等模板"同 entity 多
+     * BehaviorScript / Trigger 静默 dedup"的 hidden broken state。匹配规则:
+     *   - 无 ref:按 `(entity, componentName)` 取首个命中(legacy 行为)
+     *   - 有 ref:按 `(entity, componentName, ref)` 三元组定位,匹配 instance.ref /
+     *           instance.name / constructor.ref 字段(优先 instance.ref,与
+     *           ADR-0021 BehaviorScript first-class 一致)
+     */
+    private callMethod;
+    /**
+     * 从 comps 列表里取出符合 (componentName, ref) 的 Component 实例。
+     *
+     * `ref` 可选 - 未传时取首个 componentName 匹配的实例(legacy);传入时按
+     * 三元组定位,匹配优先级 instance.ref → instance.name → constructor.ref。
+     */
+    private findComponentByRef;
+    private evalGuard;
+    onDestroy(): void;
+}
+
+/** 单条 action,DSL 描述时只填 type + 字段 */
+export declare type TriggerAction = {
+    type: 'emit';
+    signal: string;
+    payload?: any;
+} | {
+    type: 'setStore';
+    key: string;
+    value: any;
+} | {
+    type: 'incStore';
+    key: string;
+    delta?: number;
+} | {
+    type: 'log';
+    message: string;
+} | {
+    type: 'callMethod';
+    entity: string;
+    component: string;
+    method: string;
+    args?: any[];
+    /**
+     * 同 entity 上同 componentName 多实例时的实例区分符(ADR-0024B / ADR-0015)。
+     *
+     * 默认按 `(entity, componentName)` 二元组定位 — 同名多实例时取首个命中。
+     * 设 `ref` 后按 `(entity, componentName, ref)` 三元组定位,匹配
+     * `BehaviorScript` 的 ADR-0021 `ref` 字段或自定义 Component 的 `name` /
+     * `static ref` 字段。
+     *
+     * 修复 alert-chase.json 模板"同 entity 多 BehaviorScript 静默 dedup"的
+     * hidden broken state。
+     */
+    ref?: string;
+};
+
+export declare interface TriggerParams {
+    rules: TriggerRule[];
+    /** ctx 变量,可在 guard 中读 */
+    context?: Record<string, any>;
+}
+
+export declare interface TriggerRule {
+    /** 监听的信号名 */
+    on: string;
+    /** 命中后执行的动作列表 */
+    do: TriggerAction[];
+    /** 可选:JS 表达式;以 (payload, ctx) 为变量,假则跳过 */
+    guard?: string;
+}
+
+export declare class TriggerSystem extends System {
+    static systemName: string;
+    readonly name = "Trigger";
+}
+
+export { }

package/dist/plugin-trigger.esm.js

@@ -0,0 +1,207 @@
+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;
+};
+
+/**
+ * Trigger 组件 — 把信号映射成 DSL 动作。
+ *
+ * DSL 用法:
+ * ```json
+ * {
+ *   "type": "Trigger",
+ *   "props": {
+ *     "rules": [
+ *       { "on": "input:fire:press",
+ *         "do": [
+ *           { "type": "emit", "signal": "rocket:spawn" },
+ *           { "type": "incStore", "key": "shotsFired" }
+ *         ] },
+ *       { "on": "rocket:hit",
+ *         "guard": "ctx.allowedScene === true",
+ *         "do": [
+ *           { "type": "incStore", "key": "score" },
+ *           { "type": "emit", "signal": "monster:hurt" }
+ *         ] }
+ *     ]
+ *   }
+ * }
+ * ```
+ *
+ * 这是 plugin-state-machine 的"无状态弟弟":只配 input → output,不维护 state。
+ * 适合写 80% 的"按钮按下→记分"业务,大幅减少自定义 Component 数量。
+ */
+let Trigger = class Trigger extends Component {
+    constructor() {
+        super(...arguments);
+        this.rules = [];
+        this.subs = [];
+        this.ctx = {};
+    }
+    init(params) {
+        var _a, _b;
+        if (!params)
+            return;
+        this.rules = (_a = params.rules) !== null && _a !== void 0 ? _a : [];
+        this.ctx = (_b = params.context) !== null && _b !== void 0 ? _b : {};
+    }
+    awake() {
+        const bus = getSignalBus();
+        for (const rule of this.rules) {
+            const h = bus.on(rule.on, (payload) => {
+                if (rule.guard && !this.evalGuard(rule.guard, payload))
+                    return;
+                for (const a of rule.do)
+                    this.exec(a, payload);
+            });
+            this.subs.push(h);
+        }
+    }
+    exec(action, payload) {
+        var _a, _b, _c, _d;
+        try {
+            switch (action.type) {
+                case 'emit':
+                    getSignalBus().emit(action.signal, (_a = action.payload) !== null && _a !== void 0 ? _a : payload);
+                    break;
+                case 'setStore':
+                    if (typeof mx !== 'undefined' && ((_b = mx === null || mx === void 0 ? void 0 : mx.store) === null || _b === void 0 ? void 0 : _b.update)) {
+                        mx.store.update(action.key, () => action.value);
+                    }
+                    break;
+                case 'incStore':
+                    if (typeof mx !== 'undefined' && ((_c = mx === null || mx === void 0 ? void 0 : mx.store) === null || _c === void 0 ? void 0 : _c.update)) {
+                        mx.store.update(action.key, (v) => { var _a; return (v !== null && v !== void 0 ? v : 0) + ((_a = action.delta) !== null && _a !== void 0 ? _a : 1); });
+                    }
+                    break;
+                case 'log':
+                    // eslint-disable-next-line no-console
+                    console.log('[trigger]', action.message, payload);
+                    break;
+                case 'callMethod':
+                    this.callMethod(action.entity, action.component, action.method, (_d = action.args) !== null && _d !== void 0 ? _d : [], action.ref);
+                    break;
+            }
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.warn('[plugin-trigger] action failed', action, err);
+        }
+    }
+    /**
+     * 按 (entity, componentName[, ref]) 查找并调用方法。
+     *
+     * ADR-0024B:加 `ref` 字段后修复 alert-chase.json 等模板"同 entity 多
+     * BehaviorScript / Trigger 静默 dedup"的 hidden broken state。匹配规则:
+     *   - 无 ref:按 `(entity, componentName)` 取首个命中(legacy 行为)
+     *   - 有 ref:按 `(entity, componentName, ref)` 三元组定位,匹配 instance.ref /
+     *           instance.name / constructor.ref 字段(优先 instance.ref,与
+     *           ADR-0021 BehaviorScript first-class 一致)
+     */
+    callMethod(entity, compName, method, args, ref) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        const game = (_b = (_a = this.gameObject) === null || _a === void 0 ? void 0 : _a.scene) === null || _b === void 0 ? void 0 : _b.game;
+        if (!game)
+            return;
+        const stack = [...((_d = (_c = game.scene) === null || _c === void 0 ? void 0 : _c.gameObjects) !== null && _d !== void 0 ? _d : [])];
+        while (stack.length) {
+            const go = stack.pop();
+            if (!go)
+                continue;
+            if (go.name === entity) {
+                const comps = (_e = go.components) !== null && _e !== void 0 ? _e : [];
+                const c = this.findComponentByRef(comps, compName, ref);
+                if (c && typeof c[method] === 'function') {
+                    c[method](...args);
+                }
+                return;
+            }
+            if ((_g = (_f = go.transform) === null || _f === void 0 ? void 0 : _f.children) === null || _g === void 0 ? void 0 : _g.length) {
+                for (const ch of go.transform.children)
+                    stack.push(ch.gameObject);
+            }
+        }
+    }
+    /**
+     * 从 comps 列表里取出符合 (componentName, ref) 的 Component 实例。
+     *
+     * `ref` 可选 - 未传时取首个 componentName 匹配的实例(legacy);传入时按
+     * 三元组定位,匹配优先级 instance.ref → instance.name → constructor.ref。
+     */
+    findComponentByRef(comps, componentName, ref) {
+        if (!ref) {
+            return comps.find((c) => { var _a; return ((_a = c === null || c === void 0 ? void 0 : c.constructor) === null || _a === void 0 ? void 0 : _a.componentName) === componentName; });
+        }
+        return comps.find((c) => {
+            var _a, _b;
+            if (((_a = c === null || c === void 0 ? void 0 : c.constructor) === null || _a === void 0 ? void 0 : _a.componentName) !== componentName)
+                return false;
+            // 优先 instance.ref(ADR-0021 BehaviorScript first-class)
+            if (typeof c.ref === 'string' && c.ref === ref)
+                return true;
+            // fallback:instance.name(自定义 Component 习惯字段)
+            if (typeof c.name === 'string' && c.name === ref)
+                return true;
+            // fallback:constructor.ref(静态标签)
+            if (((_b = c === null || c === void 0 ? void 0 : c.constructor) === null || _b === void 0 ? void 0 : _b.ref) === ref)
+                return true;
+            return false;
+        });
+    }
+    evalGuard(guard, payload) {
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-implied-eval, no-new-func
+            const fn = new Function('payload', 'ctx', `return (${guard});`);
+            return Boolean(fn(payload, this.ctx));
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.warn(`[plugin-trigger] bad guard "${guard}":`, err);
+            return false;
+        }
+    }
+    onDestroy() {
+        for (const h of this.subs)
+            h.dispose();
+        this.subs = [];
+    }
+};
+Trigger.componentName = 'Trigger';
+Trigger = __decorate([
+    decorators.componentObserver({})
+], Trigger);
+
+class TriggerSystem extends System {
+    constructor() {
+        super(...arguments);
+        this.name = 'Trigger';
+    }
+}
+TriggerSystem.systemName = 'Trigger';
+
+export { Trigger, TriggerSystem };

package/index.js

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

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@eva/plugin-trigger",
-  "version": "2.1.0-beta.1",
+  "version": "2.1.0-beta.11",
   "description": "Trigger — 信号 → DSL 动作的执行器,DSL 配置 \"on signal\" + \"do actions\",emit/setStore/transitionState/playSound 等。",
-  "main": "lib/index.ts",
-  "module": "lib/index.ts",
-  "types": "lib/index.ts",
+  "main": "index.js",
+  "module": "dist/plugin-trigger.esm.js",
+  "types": "dist/plugin-trigger.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.11",
+    "@eva/plugin-signal-bus": "2.1.0-beta.11"
   }
 }

package/lib/Trigger.ts

@@ -1,127 +0,0 @@
-import { Component, decorators } from '@eva/eva.js';
-import { getSignalBus, SignalHandle } from '@eva/plugin-signal-bus';
-import type { TriggerParams, TriggerRule, TriggerAction } from './types';
-
-declare const mx: any;
-
-/**
- * Trigger 组件 — 把信号映射成 DSL 动作。
- *
- * DSL 用法:
- * ```json
- * {
- *   "type": "Trigger",
- *   "props": {
- *     "rules": [
- *       { "on": "input:fire:press",
- *         "do": [
- *           { "type": "emit", "signal": "rocket:spawn" },
- *           { "type": "incStore", "key": "shotsFired" }
- *         ] },
- *       { "on": "rocket:hit",
- *         "guard": "ctx.allowedScene === true",
- *         "do": [
- *           { "type": "incStore", "key": "score" },
- *           { "type": "emit", "signal": "monster:hurt" }
- *         ] }
- *     ]
- *   }
- * }
- * ```
- *
- * 这是 plugin-state-machine 的"无状态弟弟":只配 input → output,不维护 state。
- * 适合写 80% 的"按钮按下→记分"业务,大幅减少自定义 Component 数量。
- */
-@decorators.componentObserver({})
-export class Trigger extends Component<TriggerParams> {
-  static componentName = 'Trigger';
-
-  private rules: TriggerRule[] = [];
-  private subs: SignalHandle[] = [];
-  ctx: Record<string, any> = {};
-
-  init(params?: TriggerParams) {
-    if (!params) return;
-    this.rules = params.rules ?? [];
-    this.ctx = params.context ?? {};
-  }
-
-  awake() {
-    const bus = getSignalBus();
-    for (const rule of this.rules) {
-      const h = bus.on(rule.on, (payload: any) => {
-        if (rule.guard && !this.evalGuard(rule.guard, payload)) return;
-        for (const a of rule.do) this.exec(a, payload);
-      });
-      this.subs.push(h);
-    }
-  }
-
-  private exec(action: TriggerAction, payload: any) {
-    try {
-      switch (action.type) {
-        case 'emit':
-          getSignalBus().emit(action.signal, action.payload ?? payload);
-          break;
-        case 'setStore':
-          if (typeof mx !== 'undefined' && mx?.store?.update) {
-            mx.store.update(action.key, () => action.value);
-          }
-          break;
-        case 'incStore':
-          if (typeof mx !== 'undefined' && mx?.store?.update) {
-            mx.store.update(action.key, (v: number) => (v ?? 0) + (action.delta ?? 1));
-          }
-          break;
-        case 'log':
-          // eslint-disable-next-line no-console
-          console.log('[trigger]', action.message, payload);
-          break;
-        case 'callMethod':
-          this.callMethod(action.entity, action.component, action.method, action.args ?? []);
-          break;
-      }
-    } catch (err) {
-      // eslint-disable-next-line no-console
-      console.warn('[plugin-trigger] action failed', action, err);
-    }
-  }
-
-  private callMethod(entity: string, compName: string, method: string, args: any[]) {
-    const game: any = (this as any).gameObject?.scene?.game;
-    if (!game) return;
-    const stack: any[] = [...(game.scene?.gameObjects ?? [])];
-    while (stack.length) {
-      const go = stack.pop();
-      if (!go) continue;
-      if (go.name === entity) {
-        const comps: any[] = go.components ?? [];
-        const c = comps.find((c) => c?.constructor?.componentName === compName);
-        if (c && typeof c[method] === 'function') {
-          c[method](...args);
-        }
-        return;
-      }
-      if (go.transform?.children?.length) {
-        for (const ch of go.transform.children) stack.push(ch.gameObject);
-      }
-    }
-  }
-
-  private evalGuard(guard: string, payload: any): boolean {
-    try {
-      // eslint-disable-next-line @typescript-eslint/no-implied-eval, no-new-func
-      const fn = new Function('payload', 'ctx', `return (${guard});`);
-      return Boolean(fn(payload, this.ctx));
-    } catch (err) {
-      // eslint-disable-next-line no-console
-      console.warn(`[plugin-trigger] bad guard "${guard}":`, err);
-      return false;
-    }
-  }
-
-  onDestroy() {
-    for (const h of this.subs) h.dispose();
-    this.subs = [];
-  }
-}

package/lib/TriggerSystem.ts

@@ -1,6 +0,0 @@
-import { System } from '@eva/eva.js';
-
-export class TriggerSystem extends System {
-  static systemName = 'Trigger';
-  readonly name = 'Trigger';
-}

package/lib/index.ts

@@ -1,3 +0,0 @@
-export { Trigger } from './Trigger';
-export { TriggerSystem } from './TriggerSystem';
-export type { TriggerParams, TriggerRule, TriggerAction } from './types';

package/lib/types.ts

@@ -1,22 +0,0 @@
-/** 单条 action,DSL 描述时只填 type + 字段 */
-export type TriggerAction =
-  | { type: 'emit'; signal: string; payload?: any }
-  | { type: 'setStore'; key: string; value: any }
-  | { type: 'incStore'; key: string; delta?: number }
-  | { type: 'log'; message: string }
-  | { type: 'callMethod'; entity: string; component: string; method: string; args?: any[] };
-
-export interface TriggerRule {
-  /** 监听的信号名 */
-  on: string;
-  /** 命中后执行的动作列表 */
-  do: TriggerAction[];
-  /** 可选:JS 表达式;以 (payload, ctx) 为变量,假则跳过 */
-  guard?: string;
-}
-
-export interface TriggerParams {
-  rules: TriggerRule[];
-  /** ctx 变量,可在 guard 中读 */
-  context?: Record<string, any>;
-}