@eva/plugin-renderer-render-texture 2.1.0-beta.1

package/dist/plugin-renderer-render-texture.cjs.js

@@ -0,0 +1,493 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var eva_js = require('@eva/eva.js');
+var inspectorDecorator = require('@eva/inspector-decorator');
+var pluginRenderer = require('@eva/plugin-renderer');
+var pixi_js = require('pixi.js');
+
+/******************************************************************************
+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;
+}
+
+function __metadata(metadataKey, metadataValue) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(metadataKey, metadataValue);
+}
+
+function __awaiter(thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+}
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
+
+/**
+ * RenderTexture component.
+ *
+ * Equivalent of Phaser RenderTexture / DynamicTexture. Holds a Pixi RenderTexture
+ * underneath and lets the DSL declaratively enqueue draw ops via `ops`.
+ *
+ * Mutating `ops` (or any of the simple props) replays the queue.
+ */
+class RenderTexture extends eva_js.Component {
+    constructor() {
+        super(...arguments);
+        this.width = 256;
+        this.height = 256;
+        this.ops = [];
+        this.backgroundColor = -1;
+        this.backgroundAlpha = 1;
+        this.append = true;
+        /** Bumped by clear()/fill()/etc. so the system can detect imperative changes. */
+        this.dirty = 0;
+    }
+    init(obj) {
+        if (obj)
+            Object.assign(this, obj);
+        if (!Array.isArray(this.ops))
+            this.ops = [];
+    }
+    /** Append an op + mark dirty (works at runtime, not just init). */
+    addOp(op) {
+        this.ops = [...this.ops, op];
+        this.dirty++;
+    }
+    /** Clear the queue (and the texture next commit). */
+    clearOps() {
+        this.ops = [{ type: 'clear' }];
+        this.dirty++;
+    }
+}
+RenderTexture.componentName = 'RenderTexture';
+__decorate([
+    inspectorDecorator.type('number'),
+    __metadata("design:type", Number)
+], RenderTexture.prototype, "width", void 0);
+__decorate([
+    inspectorDecorator.type('number'),
+    __metadata("design:type", Number)
+], RenderTexture.prototype, "height", void 0);
+__decorate([
+    inspectorDecorator.type('array'),
+    __metadata("design:type", Array)
+], RenderTexture.prototype, "ops", void 0);
+__decorate([
+    inspectorDecorator.type('number'),
+    __metadata("design:type", Number)
+], RenderTexture.prototype, "backgroundColor", void 0);
+__decorate([
+    inspectorDecorator.type('number'),
+    __metadata("design:type", Number)
+], RenderTexture.prototype, "backgroundAlpha", void 0);
+
+const FRAME_SEP = '#'; // resource name separator: `myAtlas#frame.png`
+let RenderTextureSystem = class RenderTextureSystem extends pluginRenderer.Renderer {
+    constructor() {
+        super(...arguments);
+        this.name = 'RenderTexture';
+        this.records = {};
+    }
+    init() {
+        this.renderSystem = this.game.getSystem(pluginRenderer.RendererSystem);
+        this.renderSystem.rendererManager.register(this);
+    }
+    rendererUpdate(gameObject) {
+        const record = this.records[gameObject.id];
+        if (!record)
+            return;
+        if (record.needsReplay) {
+            record.needsReplay = false;
+            // fire-and-forget: replay is async (loads textures). next frame will see updated RT.
+            this.replay(gameObject.id);
+        }
+    }
+    componentChanged(changed) {
+        var _a, _b, _c, _d;
+        return __awaiter(this, void 0, void 0, function* () {
+            if (changed.componentName !== 'RenderTexture')
+                return;
+            const component = changed.component;
+            const gameObjectId = changed.gameObject.id;
+            if (changed.type === eva_js.OBSERVER_TYPE.ADD) {
+                const rt = pixi_js.RenderTexture.create({
+                    width: Math.max(1, component.width || 1),
+                    height: Math.max(1, component.height || 1),
+                    resolution: 1,
+                });
+                const sprite = new pixi_js.Sprite(rt);
+                // Force sprite display rect to match component.width/height (in design units)
+                // so the RT shows at intended logical size regardless of devicePixelRatio.
+                sprite.width = component.width;
+                sprite.height = component.height;
+                this.containerManager.getContainer(gameObjectId).addChildAt(sprite, 0);
+                this.records[gameObjectId] = { rt, sprite, component, lastSig: '', needsReplay: true };
+                // schedule replay for next frame so PIXI Application & renderer are ready.
+                this.maybeSave(gameObjectId);
+            }
+            else if (changed.type === eva_js.OBSERVER_TYPE.CHANGE) {
+                const record = this.records[gameObjectId];
+                if (!record)
+                    return;
+                record.component = component;
+                // Resize when width/height changed
+                if (record.rt.width !== component.width || record.rt.height !== component.height) {
+                    try {
+                        (_b = (_a = record.rt).resize) === null || _b === void 0 ? void 0 : _b.call(_a, Math.max(1, component.width), Math.max(1, component.height));
+                    }
+                    catch (e) {
+                        // ignore
+                    }
+                    record.sprite.width = component.width;
+                    record.sprite.height = component.height;
+                }
+                record.needsReplay = true;
+                this.maybeSave(gameObjectId);
+            }
+            else if (changed.type === eva_js.OBSERVER_TYPE.REMOVE) {
+                const record = this.records[gameObjectId];
+                if (!record)
+                    return;
+                (_d = (_c = this.containerManager) === null || _c === void 0 ? void 0 : _c.getContainer(gameObjectId)) === null || _d === void 0 ? void 0 : _d.removeChild(record.sprite);
+                record.sprite.destroy({ children: true });
+                record.rt.destroy(true);
+                delete this.records[gameObjectId];
+            }
+        });
+    }
+    /** Resolve a resource name (optionally with `#frame` suffix) → Texture. */
+    resolveTexture(name, explicitFrame) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!name)
+                return null;
+            let resName = name;
+            let frame = explicitFrame;
+            if (!frame && name.includes(FRAME_SEP)) {
+                const idx = name.indexOf(FRAME_SEP);
+                resName = name.slice(0, idx);
+                frame = name.slice(idx + 1);
+            }
+            try {
+                const { instance } = yield eva_js.resource.getResource(resName);
+                if (!instance)
+                    return null;
+                // sprite atlas: instance is a frames map
+                if (frame) {
+                    if (instance && instance[frame] instanceof pixi_js.Texture) {
+                        return instance[frame];
+                    }
+                    // Sometimes instance has `.textures[frame]`
+                    const textures = instance.textures;
+                    if (textures && textures[frame] instanceof pixi_js.Texture) {
+                        return textures[frame];
+                    }
+                }
+                if (instance instanceof pixi_js.Texture)
+                    return instance;
+                // sprite atlas single texture access
+                if (instance.baseTexture)
+                    return instance;
+                // grab first frame as fallback
+                if (typeof instance === 'object') {
+                    const keys = Object.keys(instance);
+                    for (const k of keys) {
+                        const v = instance[k];
+                        if (v instanceof pixi_js.Texture)
+                            return v;
+                    }
+                }
+                return null;
+            }
+            catch (_a) {
+                return null;
+            }
+        });
+    }
+    /** Build an offscreen Pixi DisplayObject describing the op, then render it into the RT. */
+    replay(gameObjectId) {
+        var _a, _b, _c, _d, _e, _f;
+        return __awaiter(this, void 0, void 0, function* () {
+            const record = this.records[gameObjectId];
+            if (!record)
+                return;
+            const { rt, component } = record;
+            const sig = `${component.dirty}|${(_b = (_a = component.ops) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0}|${component.width}|${component.height}`;
+            if (record.lastSig === sig && component.append) ;
+            record.lastSig = sig;
+            const renderer = (_c = this.renderSystem.application) === null || _c === void 0 ? void 0 : _c.renderer;
+            if (!renderer)
+                return;
+            // Build a single staging Container that aggregates this commit's ops.
+            const stage = new pixi_js.Container();
+            // Optional background (fill RT with color, replacing previous content)
+            const bg = component.backgroundColor;
+            const bgA = (_d = component.backgroundAlpha) !== null && _d !== void 0 ? _d : 1;
+            if (!component.append) {
+                const g = new pixi_js.Graphics();
+                if (bg != null && bg >= 0) {
+                    g.rect(0, 0, component.width, component.height).fill({ color: bg, alpha: bgA });
+                }
+                else {
+                    // transparent clear
+                    g.rect(0, 0, component.width, component.height).fill({ color: 0x000000, alpha: 0 });
+                }
+                stage.addChild(g);
+            }
+            for (const op of component.ops || []) {
+                const node = yield this.buildOpNode(op);
+                if (node)
+                    stage.addChild(node);
+            }
+            try {
+                // Pixi v8 render-to-target API
+                renderer.render({
+                    container: stage,
+                    target: rt,
+                    clear: !component.append,
+                });
+                // eslint-disable-next-line no-console
+                if (globalThis.__RT_DEBUG) {
+                    console.log('[RT] replayed', {
+                        ops: (_e = component.ops) === null || _e === void 0 ? void 0 : _e.length,
+                        w: rt.width,
+                        h: rt.height,
+                        stageChildren: (_f = stage.children) === null || _f === void 0 ? void 0 : _f.length,
+                    });
+                }
+            }
+            catch (e) {
+                // fallback for older API: renderer.render(displayObject, { renderTexture: rt })
+                try {
+                    renderer.render(stage, { renderTexture: rt, clear: !component.append });
+                }
+                catch (_g) {
+                    console.warn('[RenderTexture] renderer.render failed', e);
+                }
+            }
+            finally {
+                // Defer destroy to next microtask so the GPU has time to consume.
+                // Some Pixi v8 builds upload the geometry lazily.
+                Promise.resolve().then(() => {
+                    try {
+                        stage.destroy({ children: true });
+                    }
+                    catch (_a) {
+                        /* noop */
+                    }
+                });
+            }
+        });
+    }
+    buildOpNode(op) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _11, _12, _13, _14;
+        return __awaiter(this, void 0, void 0, function* () {
+            if (op.type === 'clear') {
+                const g = new pixi_js.Graphics();
+                g.rect(0, 0, 1e6, 1e6).fill({ color: 0x000000, alpha: 0 });
+                // Use destination-in trick alternative: simpler — caller knows append=false to actually clear.
+                return g;
+            }
+            if (op.type === 'fill') {
+                const g = new pixi_js.Graphics();
+                const x = (_a = op.x) !== null && _a !== void 0 ? _a : 0;
+                const y = (_b = op.y) !== null && _b !== void 0 ? _b : 0;
+                const w = (_c = op.width) !== null && _c !== void 0 ? _c : 1e6;
+                const h = (_d = op.height) !== null && _d !== void 0 ? _d : 1e6;
+                g.rect(x, y, w, h).fill({ color: op.color, alpha: (_e = op.alpha) !== null && _e !== void 0 ? _e : 1 });
+                return g;
+            }
+            if (op.type === 'draw' || op.type === 'drawFrame') {
+                const tex = yield this.resolveTexture(op.resource, op.frame);
+                if (!tex)
+                    return null;
+                const sp = new pixi_js.Sprite(tex);
+                sp.x = (_f = op.x) !== null && _f !== void 0 ? _f : 0;
+                sp.y = (_g = op.y) !== null && _g !== void 0 ? _g : 0;
+                const o = op;
+                sp.alpha = (_h = o.alpha) !== null && _h !== void 0 ? _h : 1;
+                if (o.tint != null)
+                    sp.tint = o.tint;
+                if (o.width != null)
+                    sp.width = o.width;
+                if (o.height != null)
+                    sp.height = o.height;
+                if (o.rotation != null)
+                    sp.rotation = o.rotation;
+                if (o.anchorX != null || o.anchorY != null) {
+                    sp.anchor.set((_j = o.anchorX) !== null && _j !== void 0 ? _j : 0, (_k = o.anchorY) !== null && _k !== void 0 ? _k : 0);
+                }
+                if (o.scaleX != null || o.scaleY != null) {
+                    sp.scale.set((_l = o.scaleX) !== null && _l !== void 0 ? _l : 1, (_m = o.scaleY) !== null && _m !== void 0 ? _m : 1);
+                }
+                if (o.blendMode) {
+                    try {
+                        sp.blendMode = o.blendMode;
+                    }
+                    catch (_15) {
+                        // ignore
+                    }
+                }
+                return sp;
+            }
+            if (op.type === 'erase') {
+                const g = new pixi_js.Graphics();
+                const w = (_o = op.width) !== null && _o !== void 0 ? _o : 16;
+                const h = (_p = op.height) !== null && _p !== void 0 ? _p : 16;
+                const ax = (_q = op.anchorX) !== null && _q !== void 0 ? _q : 0;
+                const ay = (_r = op.anchorY) !== null && _r !== void 0 ? _r : 0;
+                const x = ((_s = op.x) !== null && _s !== void 0 ? _s : 0) - w * ax;
+                const y = ((_t = op.y) !== null && _t !== void 0 ? _t : 0) - h * ay;
+                g.rect(x, y, w, h).fill({ color: 0xffffff, alpha: 1 });
+                try {
+                    g.blendMode = 'erase';
+                }
+                catch (_16) {
+                    // ignore
+                }
+                return g;
+            }
+            if (op.type === 'drawText') {
+                const t = new pixi_js.Text({
+                    text: op.text,
+                    style: {
+                        fontFamily: (_v = (_u = op.style) === null || _u === void 0 ? void 0 : _u.fontFamily) !== null && _v !== void 0 ? _v : 'Arial',
+                        fontSize: (_x = (_w = op.style) === null || _w === void 0 ? void 0 : _w.fontSize) !== null && _x !== void 0 ? _x : 32,
+                        fontWeight: (_z = (_y = op.style) === null || _y === void 0 ? void 0 : _y.fontWeight) !== null && _z !== void 0 ? _z : 'normal',
+                        fill: (_1 = (_0 = op.style) === null || _0 === void 0 ? void 0 : _0.fill) !== null && _1 !== void 0 ? _1 : 0xffffff,
+                        stroke: (_2 = op.style) === null || _2 === void 0 ? void 0 : _2.stroke,
+                        align: (_4 = (_3 = op.style) === null || _3 === void 0 ? void 0 : _3.align) !== null && _4 !== void 0 ? _4 : 'left',
+                    },
+                });
+                t.x = (_5 = op.x) !== null && _5 !== void 0 ? _5 : 0;
+                t.y = (_6 = op.y) !== null && _6 !== void 0 ? _6 : 0;
+                if (op.alpha != null)
+                    t.alpha = op.alpha;
+                if (op.tint != null)
+                    t.tint = op.tint;
+                return t;
+            }
+            if (op.type === 'paint') {
+                const tex = yield this.resolveTexture(op.resource, op.frame);
+                if (!tex)
+                    return null;
+                const c = new pixi_js.Container();
+                const times = Math.max(1, (_7 = op.times) !== null && _7 !== void 0 ? _7 : 1);
+                const dx = (_9 = (_8 = op.step) === null || _8 === void 0 ? void 0 : _8.x) !== null && _9 !== void 0 ? _9 : 0;
+                const dy = (_11 = (_10 = op.step) === null || _10 === void 0 ? void 0 : _10.y) !== null && _11 !== void 0 ? _11 : 0;
+                for (let i = 0; i < times; i++) {
+                    const sp = new pixi_js.Sprite(tex);
+                    sp.x = ((_12 = op.x) !== null && _12 !== void 0 ? _12 : 0) + dx * i;
+                    sp.y = ((_13 = op.y) !== null && _13 !== void 0 ? _13 : 0) + dy * i;
+                    sp.anchor.set(0.5, 0.5);
+                    sp.alpha = (_14 = op.alpha) !== null && _14 !== void 0 ? _14 : 1;
+                    if (op.tintCycle && op.tintCycle.length > 0) {
+                        sp.tint = op.tintCycle[i % op.tintCycle.length];
+                    }
+                    else if (op.tint != null) {
+                        sp.tint = op.tint;
+                    }
+                    c.addChild(sp);
+                }
+                return c;
+            }
+            return null;
+        });
+    }
+    /**
+     * After a successful replay, save the RT as a resource so other Img/Sprite can reference it.
+     * Idempotent: registers once per gameObject.saveAs key.
+     */
+    maybeSave(gameObjectId) {
+        var _a;
+        const record = this.records[gameObjectId];
+        if (!record)
+            return;
+        const key = record.component.saveAs;
+        if (!key)
+            return;
+        try {
+            // Check if already in resourcesMap
+            const existing = (_a = eva_js.resource.resourcesMap) === null || _a === void 0 ? void 0 : _a[key];
+            if (existing) {
+                existing.complete = true;
+                existing.instance = record.rt;
+                // Make sure callers awaiting getResource get our instance
+                const promiseMap = eva_js.resource.promiseMap;
+                if (promiseMap) {
+                    promiseMap[key] = Promise.resolve({ instance: record.rt, name: key });
+                }
+                return;
+            }
+            // Register a fresh entry
+            eva_js.resource.resourcesMap = eva_js.resource.resourcesMap || {};
+            eva_js.resource.resourcesMap[key] = {
+                name: key,
+                type: 'IMAGE',
+                complete: true,
+                instance: record.rt,
+                data: {},
+            };
+            const promiseMap = eva_js.resource.promiseMap;
+            if (promiseMap) {
+                promiseMap[key] = Promise.resolve({ instance: record.rt, name: key });
+            }
+        }
+        catch (e) {
+            console.warn('[RenderTexture] saveAs failed', e);
+        }
+    }
+    destroy() {
+        var _a, _b;
+        for (const key in this.records) {
+            const id = parseInt(key);
+            const record = this.records[id];
+            (_b = (_a = this.containerManager) === null || _a === void 0 ? void 0 : _a.getContainer(id)) === null || _b === void 0 ? void 0 : _b.removeChild(record.sprite);
+            record.sprite.destroy({ children: true });
+            record.rt.destroy(true);
+            delete this.records[id];
+        }
+    }
+};
+RenderTextureSystem.systemName = 'RenderTexture';
+RenderTextureSystem = __decorate([
+    eva_js.decorators.componentObserver({
+        RenderTexture: [
+            { prop: ['width'], deep: false },
+            { prop: ['height'], deep: false },
+            { prop: ['ops'], deep: true },
+            { prop: ['dirty'], deep: false },
+            { prop: ['backgroundColor'], deep: false },
+            { prop: ['backgroundAlpha'], deep: false },
+        ],
+    })
+], RenderTextureSystem);
+var RenderTextureSystem$1 = RenderTextureSystem;
+
+exports.RenderTexture = RenderTexture;
+exports.RenderTextureSystem = RenderTextureSystem$1;

package/dist/plugin-renderer-render-texture.cjs.prod.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@eva/eva.js"),t=require("@eva/inspector-decorator"),r=require("@eva/plugin-renderer"),n=require("pixi.js");function i(e,t,r,n){var i,o=arguments.length,l=o<3?t:null===n?n=Object.getOwnPropertyDescriptor(t,r):n;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)l=Reflect.decorate(e,t,r,n);else for(var s=e.length-1;s>=0;s--)(i=e[s])&&(l=(o<3?i(l):o>3?i(t,r,l):i(t,r))||l);return o>3&&l&&Object.defineProperty(t,r,l),l}function o(e,t){if("object"==typeof Reflect&&"function"==typeof Reflect.metadata)return Reflect.metadata(e,t)}function l(e,t,r,n){return new(r||(r=Promise))(function(i,o){function l(e){try{d(n.next(e))}catch(e){o(e)}}function s(e){try{d(n.throw(e))}catch(e){o(e)}}function d(e){var t;e.done?i(e.value):(t=e.value,t instanceof r?t:new r(function(e){e(t)})).then(l,s)}d((n=n.apply(e,t||[])).next())})}"function"==typeof SuppressedError&&SuppressedError;class s extends e.Component{constructor(){super(...arguments),this.width=256,this.height=256,this.ops=[],this.backgroundColor=-1,this.backgroundAlpha=1,this.append=!0,this.dirty=0}init(e){e&&Object.assign(this,e),Array.isArray(this.ops)||(this.ops=[])}addOp(e){this.ops=[...this.ops,e],this.dirty++}clearOps(){this.ops=[{type:"clear"}],this.dirty++}}s.componentName="RenderTexture",i([t.type("number"),o("design:type",Number)],s.prototype,"width",void 0),i([t.type("number"),o("design:type",Number)],s.prototype,"height",void 0),i([t.type("array"),o("design:type",Array)],s.prototype,"ops",void 0),i([t.type("number"),o("design:type",Number)],s.prototype,"backgroundColor",void 0),i([t.type("number"),o("design:type",Number)],s.prototype,"backgroundAlpha",void 0);let d=class extends r.Renderer{constructor(){super(...arguments),this.name="RenderTexture",this.records={}}init(){this.renderSystem=this.game.getSystem(r.RendererSystem),this.renderSystem.rendererManager.register(this)}rendererUpdate(e){const t=this.records[e.id];t&&t.needsReplay&&(t.needsReplay=!1,this.replay(e.id))}componentChanged(t){var r,i,o,s;return l(this,void 0,void 0,function*(){if("RenderTexture"!==t.componentName)return;const l=t.component,d=t.gameObject.id;if(t.type===e.OBSERVER_TYPE.ADD){const e=n.RenderTexture.create({width:Math.max(1,l.width||1),height:Math.max(1,l.height||1),resolution:1}),t=new n.Sprite(e);t.width=l.width,t.height=l.height,this.containerManager.getContainer(d).addChildAt(t,0),this.records[d]={rt:e,sprite:t,component:l,lastSig:"",needsReplay:!0},this.maybeSave(d)}else if(t.type===e.OBSERVER_TYPE.CHANGE){const e=this.records[d];if(!e)return;if(e.component=l,e.rt.width!==l.width||e.rt.height!==l.height){try{null===(i=(r=e.rt).resize)||void 0===i||i.call(r,Math.max(1,l.width),Math.max(1,l.height))}catch(e){}e.sprite.width=l.width,e.sprite.height=l.height}e.needsReplay=!0,this.maybeSave(d)}else if(t.type===e.OBSERVER_TYPE.REMOVE){const e=this.records[d];if(!e)return;null===(s=null===(o=this.containerManager)||void 0===o?void 0:o.getContainer(d))||void 0===s||s.removeChild(e.sprite),e.sprite.destroy({children:!0}),e.rt.destroy(!0),delete this.records[d]}})}resolveTexture(t,r){return l(this,void 0,void 0,function*(){if(!t)return null;let i=t,o=r;if(!o&&t.includes("#")){const e=t.indexOf("#");i=t.slice(0,e),o=t.slice(e+1)}try{const{instance:t}=yield e.resource.getResource(i);if(!t)return null;if(o){if(t&&t[o]instanceof n.Texture)return t[o];const e=t.textures;if(e&&e[o]instanceof n.Texture)return e[o]}if(t instanceof n.Texture)return t;if(t.baseTexture)return t;if("object"==typeof t){const e=Object.keys(t);for(const r of e){const e=t[r];if(e instanceof n.Texture)return e}}return null}catch(e){return null}})}replay(e){var t,r,i,o,s,d;return l(this,void 0,void 0,function*(){const l=this.records[e];if(!l)return;const{rt:a,component:c}=l,u=`${c.dirty}|${null!==(r=null===(t=c.ops)||void 0===t?void 0:t.length)&&void 0!==r?r:0}|${c.width}|${c.height}`;l.lastSig===u&&c.append,l.lastSig=u;const h=null===(i=this.renderSystem.application)||void 0===i?void 0:i.renderer;if(!h)return;const p=new n.Container,v=c.backgroundColor,y=null!==(o=c.backgroundAlpha)&&void 0!==o?o:1;if(!c.append){const e=new n.Graphics;null!=v&&v>=0?e.rect(0,0,c.width,c.height).fill({color:v,alpha:y}):e.rect(0,0,c.width,c.height).fill({color:0,alpha:0}),p.addChild(e)}for(const e of c.ops||[]){const t=yield this.buildOpNode(e);t&&p.addChild(t)}try{h.render({container:p,target:a,clear:!c.append}),globalThis.__RT_DEBUG&&console.log("[RT] replayed",{ops:null===(s=c.ops)||void 0===s?void 0:s.length,w:a.width,h:a.height,stageChildren:null===(d=p.children)||void 0===d?void 0:d.length})}catch(e){try{h.render(p,{renderTexture:a,clear:!c.append})}catch(t){console.warn("[RenderTexture] renderer.render failed",e)}}finally{Promise.resolve().then(()=>{try{p.destroy({children:!0})}catch(e){}})}})}buildOpNode(e){var t,r,i,o,s,d,a,c,u,h,p,v,y,f,g,m,x,w,b,R,T,C,M,S,O,E,A,j,k,N,P,Y,_,G,X,q,B,D,V;return l(this,void 0,void 0,function*(){if("clear"===e.type){const e=new n.Graphics;return e.rect(0,0,1e6,1e6).fill({color:0,alpha:0}),e}if("fill"===e.type){const l=new n.Graphics,d=null!==(t=e.x)&&void 0!==t?t:0,a=null!==(r=e.y)&&void 0!==r?r:0,c=null!==(i=e.width)&&void 0!==i?i:1e6,u=null!==(o=e.height)&&void 0!==o?o:1e6;return l.rect(d,a,c,u).fill({color:e.color,alpha:null!==(s=e.alpha)&&void 0!==s?s:1}),l}if("draw"===e.type||"drawFrame"===e.type){const t=yield this.resolveTexture(e.resource,e.frame);if(!t)return null;const r=new n.Sprite(t);r.x=null!==(d=e.x)&&void 0!==d?d:0,r.y=null!==(a=e.y)&&void 0!==a?a:0;const i=e;if(r.alpha=null!==(c=i.alpha)&&void 0!==c?c:1,null!=i.tint&&(r.tint=i.tint),null!=i.width&&(r.width=i.width),null!=i.height&&(r.height=i.height),null!=i.rotation&&(r.rotation=i.rotation),null==i.anchorX&&null==i.anchorY||r.anchor.set(null!==(u=i.anchorX)&&void 0!==u?u:0,null!==(h=i.anchorY)&&void 0!==h?h:0),null==i.scaleX&&null==i.scaleY||r.scale.set(null!==(p=i.scaleX)&&void 0!==p?p:1,null!==(v=i.scaleY)&&void 0!==v?v:1),i.blendMode)try{r.blendMode=i.blendMode}catch(e){}return r}if("erase"===e.type){const t=new n.Graphics,r=null!==(y=e.width)&&void 0!==y?y:16,i=null!==(f=e.height)&&void 0!==f?f:16,o=null!==(g=e.anchorX)&&void 0!==g?g:0,l=null!==(m=e.anchorY)&&void 0!==m?m:0,s=(null!==(x=e.x)&&void 0!==x?x:0)-r*o,d=(null!==(w=e.y)&&void 0!==w?w:0)-i*l;t.rect(s,d,r,i).fill({color:16777215,alpha:1});try{t.blendMode="erase"}catch(e){}return t}if("drawText"===e.type){const t=new n.Text({text:e.text,style:{fontFamily:null!==(R=null===(b=e.style)||void 0===b?void 0:b.fontFamily)&&void 0!==R?R:"Arial",fontSize:null!==(C=null===(T=e.style)||void 0===T?void 0:T.fontSize)&&void 0!==C?C:32,fontWeight:null!==(S=null===(M=e.style)||void 0===M?void 0:M.fontWeight)&&void 0!==S?S:"normal",fill:null!==(E=null===(O=e.style)||void 0===O?void 0:O.fill)&&void 0!==E?E:16777215,stroke:null===(A=e.style)||void 0===A?void 0:A.stroke,align:null!==(k=null===(j=e.style)||void 0===j?void 0:j.align)&&void 0!==k?k:"left"}});return t.x=null!==(N=e.x)&&void 0!==N?N:0,t.y=null!==(P=e.y)&&void 0!==P?P:0,null!=e.alpha&&(t.alpha=e.alpha),null!=e.tint&&(t.tint=e.tint),t}if("paint"===e.type){const t=yield this.resolveTexture(e.resource,e.frame);if(!t)return null;const r=new n.Container,i=Math.max(1,null!==(Y=e.times)&&void 0!==Y?Y:1),o=null!==(G=null===(_=e.step)||void 0===_?void 0:_.x)&&void 0!==G?G:0,l=null!==(q=null===(X=e.step)||void 0===X?void 0:X.y)&&void 0!==q?q:0;for(let s=0;s<i;s++){const i=new n.Sprite(t);i.x=(null!==(B=e.x)&&void 0!==B?B:0)+o*s,i.y=(null!==(D=e.y)&&void 0!==D?D:0)+l*s,i.anchor.set(.5,.5),i.alpha=null!==(V=e.alpha)&&void 0!==V?V:1,e.tintCycle&&e.tintCycle.length>0?i.tint=e.tintCycle[s%e.tintCycle.length]:null!=e.tint&&(i.tint=e.tint),r.addChild(i)}return r}return null})}maybeSave(t){var r;const n=this.records[t];if(!n)return;const i=n.component.saveAs;if(i)try{const t=null===(r=e.resource.resourcesMap)||void 0===r?void 0:r[i];if(t){t.complete=!0,t.instance=n.rt;const r=e.resource.promiseMap;return void(r&&(r[i]=Promise.resolve({instance:n.rt,name:i})))}e.resource.resourcesMap=e.resource.resourcesMap||{},e.resource.resourcesMap[i]={name:i,type:"IMAGE",complete:!0,instance:n.rt,data:{}};const o=e.resource.promiseMap;o&&(o[i]=Promise.resolve({instance:n.rt,name:i}))}catch(e){console.warn("[RenderTexture] saveAs failed",e)}}destroy(){var e,t;for(const r in this.records){const n=parseInt(r),i=this.records[n];null===(t=null===(e=this.containerManager)||void 0===e?void 0:e.getContainer(n))||void 0===t||t.removeChild(i.sprite),i.sprite.destroy({children:!0}),i.rt.destroy(!0),delete this.records[n]}}};d.systemName="RenderTexture",d=i([e.decorators.componentObserver({RenderTexture:[{prop:["width"],deep:!1},{prop:["height"],deep:!1},{prop:["ops"],deep:!0},{prop:["dirty"],deep:!1},{prop:["backgroundColor"],deep:!1},{prop:["backgroundAlpha"],deep:!1}]})],d);var a=d;exports.RenderTexture=s,exports.RenderTextureSystem=a;

package/dist/plugin-renderer-render-texture.d.ts

@@ -0,0 +1,167 @@
+import { Component } from '@eva/eva.js';
+import { ComponentChanged } from '@eva/eva.js';
+import { ContainerManager } from '@eva/plugin-renderer';
+import { GameObject } from '@eva/eva.js';
+import { Renderer } from '@eva/plugin-renderer';
+import { RendererManager } from '@eva/plugin-renderer';
+import { RendererSystem } from '@eva/plugin-renderer';
+
+/**
+ * RenderTexture component.
+ *
+ * Equivalent of Phaser RenderTexture / DynamicTexture. Holds a Pixi RenderTexture
+ * underneath and lets the DSL declaratively enqueue draw ops via `ops`.
+ *
+ * Mutating `ops` (or any of the simple props) replays the queue.
+ */
+export declare class RenderTexture extends Component<RenderTextureParams> {
+    static componentName: string;
+    width: number;
+    height: number;
+    ops: RenderTextureOp[];
+    backgroundColor: number;
+    backgroundAlpha: number;
+    saveAs?: string;
+    append: boolean;
+    /** Bumped by clear()/fill()/etc. so the system can detect imperative changes. */
+    dirty: number;
+    init(obj?: RenderTextureParams): void;
+    /** Append an op + mark dirty (works at runtime, not just init). */
+    addOp(op: RenderTextureOp): void;
+    /** Clear the queue (and the texture next commit). */
+    clearOps(): void;
+}
+
+/** Single declarative drawing op applied to a RenderTexture. */
+export declare type RenderTextureOp = 
+/** Fill the whole RT (or a sub-rect) with a solid color. */
+{
+    type: 'fill';
+    color: number;
+    alpha?: number;
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+}
+/** Clear the RT (transparent). */
+ | {
+    type: 'clear';
+}
+/** Draw an image / atlas frame / text-as-texture into the RT. */
+ | {
+    type: 'draw';
+    /** Resource name registered in DSL assets (image / sprite / saved RT). */
+    resource: string;
+    /** Optional sprite atlas frame name. */
+    frame?: string;
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+    alpha?: number;
+    tint?: number;
+    rotation?: number;
+    anchorX?: number;
+    anchorY?: number;
+    scaleX?: number;
+    scaleY?: number;
+    blendMode?: string;
+}
+/** Convenience alias for drawing an atlas frame at (x,y). */
+ | {
+    type: 'drawFrame';
+    resource: string;
+    frame: string;
+    x?: number;
+    y?: number;
+    alpha?: number;
+    tint?: number;
+}
+/** Erase a region (alpha→0) by drawing with destination-out blend. */
+ | {
+    type: 'erase';
+    resource?: string;
+    frame?: string;
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+    anchorX?: number;
+    anchorY?: number;
+}
+/** Draw a text string (PIXI.Text) into the RT. */
+ | {
+    type: 'drawText';
+    text: string;
+    x?: number;
+    y?: number;
+    style?: {
+        fontFamily?: string;
+        fontSize?: number;
+        fontWeight?: string | number;
+        fill?: number | string;
+        stroke?: number | string;
+        strokeThickness?: number;
+        align?: 'left' | 'center' | 'right';
+    };
+    alpha?: number;
+    tint?: number;
+}
+/** Repeat the previous draw N times with offset (paint trail). */
+ | {
+    type: 'paint';
+    resource: string;
+    frame?: string;
+    x?: number;
+    y?: number;
+    step?: {
+        x?: number;
+        y?: number;
+    };
+    times?: number;
+    alpha?: number;
+    tint?: number;
+    tintCycle?: number[];
+};
+
+export declare interface RenderTextureParams {
+    /** Logical width in design units. */
+    width: number;
+    /** Logical height in design units. */
+    height: number;
+    /** Declarative draw queue replayed every commit. */
+    ops?: RenderTextureOp[];
+    /** Optional clear color before replaying ops. */
+    backgroundColor?: number;
+    backgroundAlpha?: number;
+    /** Save final RT as a resource key (so other Img/Sprite can reference it). */
+    saveAs?: string;
+    /** Append ops instead of clearing on each commit. Defaults true (Phaser-like). */
+    append?: boolean;
+}
+
+export declare class RenderTextureSystem extends Renderer {
+    static systemName: string;
+    name: string;
+    private records;
+    renderSystem: RendererSystem;
+    rendererManager: RendererManager;
+    containerManager: ContainerManager;
+    init(): void;
+    rendererUpdate(gameObject: GameObject): void;
+    componentChanged(changed: ComponentChanged): Promise<void>;
+    /** Resolve a resource name (optionally with `#frame` suffix) → Texture. */
+    private resolveTexture;
+    /** Build an offscreen Pixi DisplayObject describing the op, then render it into the RT. */
+    private replay;
+    private buildOpNode;
+    /**
+     * After a successful replay, save the RT as a resource so other Img/Sprite can reference it.
+     * Idempotent: registers once per gameObject.saveAs key.
+     */
+    private maybeSave;
+    destroy(): void;
+}
+
+export { }