@eva/plugin-renderer 2.1.0-beta.3 → 2.1.0-beta.5

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

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@eva/eva.js"),t=require("@eva/renderer-adapter"),n=require("lodash-es/isEqual"),i=require("eventemitter3"),r=require("pixi.js");function o(e){return e&&"object"==typeof e&&"default"in e?e.default:e}var s=o(n),a=o(i);function c(e,t,n,i){var r,o=arguments.length,s=o<3?t:null===i?i=Object.getOwnPropertyDescriptor(t,n):i;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)s=Reflect.decorate(e,t,n,i);else for(var a=e.length-1;a>=0;a--)(r=e[a])&&(s=(o<3?r(s):o>3?r(t,n,s):r(t,n))||s);return o>3&&s&&Object.defineProperty(t,n,s),s}function l(e,t,n,i){return new(n||(n=Promise))(function(r,o){function s(e){try{c(i.next(e))}catch(e){o(e)}}function a(e){try{c(i.throw(e))}catch(e){o(e)}}function c(e){var t;e.done?r(e.value):(t=e.value,t instanceof n?t:new n(function(e){e(t)})).then(s,a)}c((i=i.apply(e,t||[])).next())})}"function"==typeof SuppressedError&&SuppressedError;var d=class{constructor({game:e,rendererSystem:t}){this.renderers=[],this.game=e,this.rendererSystem=t}register(...e){for(const t of e)t.game=this.game,t.rendererManager=this.rendererSystem.rendererManager,t.containerManager=this.rendererSystem.containerManager,this.renderers.push(t)}componentChanged(t){for(const n of t)for(const t of this.renderers){const i=t.observerInfo[n.componentName];if(i){if([e.OBSERVER_TYPE.ADD,e.OBSERVER_TYPE.REMOVE].indexOf(n.type)>-1){try{t.componentChanged&&t.componentChanged(n)}catch(e){console.error(`gameObject: ${n.gameObject.name}, ${n.componentName} is error.`,n,e)}continue}if(i.findIndex(e=>s(e,n.prop))>-1)try{t.componentChanged&&t.componentChanged(n)}catch(e){console.error(`gameObject: ${n.gameObject&&n.gameObject.name}, ${n.componentName} is componentChanged error.`,n,e)}}}}update(e){for(const t of e.components)for(const n of this.renderers){const i=[];if(n.observerInfo[t.name]&&-1===i.indexOf(e)){i.push(e);try{n.rendererUpdate&&n.rendererUpdate(e)}catch(n){console.info(`gameObject: ${e.name}, ${t.name} is update error`,n)}}}}};const h=(e,t,n)=>{const i=Number.isFinite(e.x)?e.x:0,r=Number.isFinite(e.y)?e.y:0,o=Number.isFinite(e.width)?e.width:0,s=Number.isFinite(e.height)?e.height:0;return{x:i,y:r,width:o,height:s,right:i+o,bottom:r+s,coordinateSpace:t,source:n}};class u{constructor(){this.containerMap={}}addContainer({name:e,container:t,gameObject:n}){this.containerMap[e]=t,t.gName=n.name||e}getContainer(e){return this.containerMap[e]}getBounds(e,t={}){if(!e||e.destroyed)return null;const n=t.coordinateSpace||"world",i=!1!==t.fallbackToTransform,r=this.getContainer(e.id);if(null==r?void 0:r.getBounds)try{const e=r.getBounds();if(e&&Number.isFinite(e.width)&&Number.isFinite(e.height)&&(0!==e.width||0!==e.height))return h(e,n,"pixi")}catch(e){}return i?this.getTransformBounds(e,n):null}getTransformBounds(e,t){var n,i,r,o,s,a;const c=e.transform,l=this.getContainer(e.id);let d=null===(n=null==l?void 0:l.worldTransform)||void 0===n?void 0:n.tx,u=null===(i=null==l?void 0:l.worldTransform)||void 0===i?void 0:i.ty;if(!Number.isFinite(d)||!Number.isFinite(u)){const e=this.resolveFallbackWorldPosition(c);d=e.x,u=e.y}const p=Number.isFinite(null===(r=c.scale)||void 0===r?void 0:r.x)?c.scale.x:1,m=Number.isFinite(null===(o=c.scale)||void 0===o?void 0:o.y)?c.scale.y:1,g=Math.abs(((null===(s=c.size)||void 0===s?void 0:s.width)||0)*p),v=Math.abs(((null===(a=c.size)||void 0===a?void 0:a.height)||0)*m);return h({x:d,y:u,width:g,height:v},t,"transform")}resolveFallbackWorldPosition(e){var t,n,i,r;if(!e)return{x:0,y:0};const o=e.parent,s=o?this.resolveFallbackWorldPosition(o):{x:0,y:0},a=(null==o?void 0:o.size)||{width:0,height:0};return{x:s.x+((null===(t=e.position)||void 0===t?void 0:t.x)||0)+a.width*((null===(n=e.anchor)||void 0===n?void 0:n.x)||0),y:s.y+((null===(i=e.position)||void 0===i?void 0:i.y)||0)+a.height*((null===(r=e.anchor)||void 0===r?void 0:r.y)||0)}}removeContainer(e){const t=this.containerMap[e];t&&t.destroy({children:!0}),delete this.containerMap[e]}updateTransform({name:e,transform:t}){const n=this.containerMap[e];if(!n||!t)return;const{anchor:i,origin:r,position:o,rotation:s,scale:a,size:c,skew:l}=t;n.rotation=s,n.scale=a,n.pivot.x=c.width*r.x,n.pivot.y=c.height*r.y,n.skew=l;let d=o.x,h=o.y;if(t.parent){const e=t.parent;d+=e.size.width*i.x,h+=e.size.height*i.y}n.position={x:d,y:h}}}let p=class extends a{constructor({system:e,containerManager:t}){super(),this.name="Transform",this.waitRemoveIds=[],this.waitChangeScenes=[],this.containerManager=t,this.init(e)}init(e){this.system=e,this.on("changeScene",({scene:e,mode:t,application:n})=>{this.waitChangeScenes.push({scene:e,mode:t,application:n})})}update(){for(const e of this.waitRemoveIds)this.containerManager.removeContainer(e);this.waitRemoveIds=[];for(const e of this.waitChangeScenes){const t=this.containerManager.getContainer(e.scene.id);t&&(e.application.stage.removeChildren(),e.application.stage.addChild(t))}this.waitChangeScenes=[]}componentChanged(t){t.type===e.OBSERVER_TYPE.ADD?this.addContainer(t):t.type===e.OBSERVER_TYPE.CHANGE?this.change(t):t.type===e.OBSERVER_TYPE.REMOVE&&this.waitRemoveIds.push(t.gameObject.id)}addContainer(e){const n=new t.Container;n.label=e.gameObject.name,this.containerManager.addContainer({name:e.gameObject.id,container:n,gameObject:e.gameObject});const i=e.component;Object.defineProperty(i,"worldTransform",{get:()=>n.renderGroup||n.parentRenderGroup?n.worldTransform:void 0})}change(e){const t=e.component;if(t.parent){this.containerManager.getContainer(t.parent.gameObject.id).addChild(this.containerManager.getContainer(e.gameObject.id));const n=e.gameObject.transform.parent&&e.gameObject.transform.parent.gameObject.getComponent("Render");n&&(n.sortDirty=!0)}else{const t=this.containerManager.getContainer(e.gameObject.id);t.parent&&t.parent.removeChild(t)}}destroy(){this.removeAllListeners(),this.waitRemoveIds=null,this.waitChangeScenes=null,this.system=null,this.containerManager=null}};p=c([e.decorators.componentObserver({Transform:["_parent"]}),function(e,t){if("object"==typeof Reflect&&"function"==typeof Reflect.metadata)return Reflect.metadata(e,t)}("design:paramtypes",[Object])],p);var m,g=p;exports.RENDERER_TYPE=void 0,(m=exports.RENDERER_TYPE||(exports.RENDERER_TYPE={}))[m.UNKNOWN=0]="UNKNOWN",m[m.WEBGL=1]="WEBGL",m[m.CANVAS=2]="CANVAS";let v=class extends e.System{constructor(){super(...arguments),this.multiApps=[],this.destroyed=!1}init(t={}){var n,i,r,o,s,a,c,h;return l(this,void 0,void 0,function*(){this.destroyed=!1;const p=!this.game&&function(e){if(!e||"object"!=typeof e)return!1;const t=e;return Boolean(t.scene||t.gameObjects||"function"==typeof t.on)}(t)?t:void 0;p&&(this.game=p);const m=p?this.__systemDefaultParams||{}:t;this.params=m,this.application=yield this.createApplication(m),this.containerManager=new u,this.rendererManager=new d({game:this.game,rendererSystem:this}),this.game&&(this.game.canvas=this.application.canvas),this.transform=new g({system:this,containerManager:this.containerManager}),null===(i=null===(n=this.game)||void 0===n?void 0:n.on)||void 0===i||i.call(n,"sceneChanged",({scene:t,mode:n,params:i})=>l(this,void 0,void 0,function*(){let r;switch(n){case e.LOAD_SCENE_MODE.SINGLE:r=this.application;break;case e.LOAD_SCENE_MODE.MULTI_CANVAS:r=yield this.createMultiApplication({params:i})}t.canvas=r.canvas,this.transform.emit("changeScene",{scene:t,mode:n,application:r})})),null===(o=null===(r=this.game)||void 0===r?void 0:r.on)||void 0===o||o.call(r,"pauseScene",({scene:e})=>{this.onPauseScene(e)}),null===(a=null===(s=this.game)||void 0===s?void 0:s.on)||void 0===a||a.call(s,"startScene",({scene:e})=>{this.onStartScene(e)}),null===(h=null===(c=this.game)||void 0===c?void 0:c.on)||void 0===h||h.call(c,"sceneDestroyed",({scene:e})=>l(this,void 0,void 0,function*(){const t=this.multiApps.findIndex(t=>t.canvas===e.canvas);if(t>-1){this.multiApps.splice(t,1)[0].destroy(),e.destroy()}}))})}registerObserver(e){const t=this.constructor.observerInfo;for(const n in e)t[n]||(t[n]=[]),t[n].push(...e[n])}createMultiApplication({params:e}){return l(this,void 0,void 0,function*(){const t=yield this.createApplication(e);return this.multiApps.push(t),t})}createApplication(e){return l(this,void 0,void 0,function*(){const n=new t.Application;var i;return e.debugMode&&(globalThis.__PIXI_APP__=n),yield n.init(Object.assign(Object.assign({sharedTicker:!0},e),{hello:!0})),void 0!==e.enableScroll&&(e.enableScroll?((i=n.renderer).events.autoPreventDefault=!1,i.canvas.style.touchAction="auto"):(e=>{e.events.autoPreventDefault=!0,e.canvas.style.touchAction="none"})(n.renderer)),r.Ticker.shared.stop(),r.Ticker.shared.autoStart=!1,n})}update(){if(this.destroyed||!this.game||!this.containerManager||!this.rendererManager)return;const e=this.componentObserver.clear();for(const t of e)this.transform.componentChanged(t);for(const e of this.game.gameObjects)this.containerManager.updateTransform({name:e.id,transform:e.transform}),this.rendererManager.update(e)}lateUpdate(e){!this.destroyed&&this.transform&&this.application&&(this.transform.update(),this.application.ticker.update(e.time))}onDestroy(){var e,t,n,i,r,o,s;if(!this.destroyed){this.destroyed=!0,null===(n=null===(t=null===(e=this.application)||void 0===e?void 0:e.ticker)||void 0===t?void 0:t.stop)||void 0===n||n.call(t),null===(i=this.application)||void 0===i||i.destroy(!1,{children:!0,context:!0});for(const e of this.multiApps)null===(o=null===(r=null==e?void 0:e.ticker)||void 0===r?void 0:r.stop)||void 0===o||o.call(r),e&&e.destroy(!1,{children:!0,context:!0});null===(s=this.transform)||void 0===s||s.destroy(),this.transform=null,this.params=null,this.rendererManager=null,this.containerManager=null,this.application=null,this.game=null,this.multiApps=null}}resize(e,t,n){this.params.width=e,this.params.height=t,null!=n&&(this.params.resolution=this.clampResolution(n)),this.application.renderer.resize(e,t,this.params.resolution),null!=n&&this.syncDisplayObjectResolution(this.params.resolution)}resizeRenderer(e){var t,n,i,r,o,s;const a=null!==(n=null!==(t=e.width)&&void 0!==t?t:this.params.width)&&void 0!==n?n:this.application.renderer.width,c=null!==(r=null!==(i=e.height)&&void 0!==i?i:this.params.height)&&void 0!==r?r:this.application.renderer.height,l=null==e.resolution?null!==(s=null!==(o=this.params.resolution)&&void 0!==o?o:this.application.renderer.resolution)&&void 0!==s?s:1:this.clampResolution(e.resolution,e.maxResolution);this.params.width=a,this.params.height=c,this.params.resolution=l,this.application.renderer.resize(a,c,l);return{width:a,height:c,resolution:l,displayResolutionSyncCount:this.syncDisplayObjectResolution(l)}}setResolution(e,t={}){return this.resizeRenderer(Object.assign(Object.assign({},t),{resolution:e}))}clampResolution(e,t=3){const n=Number.isFinite(e)&&e>0?e:1;return Math.min(n,t)}syncDisplayObjectResolution(e){var t;const n=(null===(t=this.containerManager)||void 0===t?void 0:t.containerMap)?Object.values(this.containerManager.containerMap):[],i="undefined"!=typeof WeakSet?new WeakSet:void 0;let r=0;const o=t=>{if(t&&"object"==typeof t&&!(null==i?void 0:i.has(t))){if(null==i||i.add(t),"resolution"in t){const n=t.resolution;if(("number"==typeof n||null===n)&&Math.abs((null!=n?n:1)-e)>.001)try{t.resolution=e,"number"==typeof t.resolution&&Math.abs(t.resolution-e)<=.001&&(r+=1)}catch(e){}}if(Array.isArray(t.children))for(const e of t.children)o(e)}};for(const e of n)o(e);return r}getBounds(e,t){var n;return(null===(n=this.containerManager)||void 0===n?void 0:n.getBounds(e,t))||null}getApplicationByScene(e){const t=this.multiApps.findIndex(t=>t.canvas===e.canvas);if(t>-1){return this.multiApps[t]}console.warn("application not found")}onPauseScene(e){const t=this.getApplicationByScene(e);t&&t.stop()}onStartScene(e){const t=this.getApplicationByScene(e);t&&t.start()}resizeByScene(e,t,n,i){const r=this.getApplicationByScene(e);r&&r.renderer.resize(t,n,i)}};v.systemName="Renderer",v=c([e.decorators.componentObserver({Transform:["_parent"]})],v);var f=v;let y;function b(e){e.addPreProcessResourceHandler(function(e){var t,n,i;let r=null===(n=null===(t=e.src)||void 0===t?void 0:t.image)||void 0===n?void 0:n.texture;if(!r)return;Array.isArray(r)||(r=[r]);const o=null!==(i=function(){if(y)return y;const e=document.createElement("canvas").getContext("webgl2");if(!e)return console.warn("WebGL not available for compressed textures. Silently failing."),{s3tc:!1,etc:!1,etc1:!1,pvrtc:!1,atc:!1,astc:!1};y={s3tc:!!e.getExtension("WEBGL_compressed_texture_s3tc"),etc:!!e.getExtension("WEBGL_compressed_texture_etc"),etc1:!!e.getExtension("WEBGL_compressed_texture_etc1"),pvrtc:!!e.getExtension("WEBGL_compressed_texture_pvrtc")||!!e.getExtension("WEBKIT_WEBGL_compressed_texture_pvrtc"),atc:!!e.getExtension("WEBGL_compressed_texture_atc"),astc:!!e.getExtension("WEBGL_compressed_texture_astc")};try{console.log("Eva.js Supported Compressed Texture Format List: "+Object.keys(y).filter(e=>y[e]).join(", "))}catch(e){}return y}())&&void 0!==i?i:{};let s=r.find(e=>o[e.type]);s&&Object.assign(e.src.image,s)})}class x extends e.System{constructor(e){super(e),this.asyncIdMap={},this.observerInfo=this.constructor.observerInfo}componentChanged(e){}rendererUpdate(e){}update(e){const t=this.componentObserver.clear();for(const e of t)this.componentChanged(e)}increaseAsyncId(e){return this.asyncIdMap[e]=(this.asyncIdMap[e]||0)+1,this.asyncIdMap[e]}validateAsyncId(e,t){return this.asyncIdMap[e]===t}}exports.ContainerManager=u,exports.Renderer=x,exports.RendererManager=d,exports.RendererSystem=f,exports.registerKtx2CompressedTexture=function(t){r.setKTXTranscoderPath(t),r.extensions.add(r.loadKTX2),r.extensions.add(r.resolveCompressedTextureUrl),r.extensions.add(r.detectCompressed),b(e.resource)};

package/dist/plugin-renderer.d.ts

@@ -0,0 +1,294 @@
+import { Application } from '@eva/renderer-adapter';
+import type { ApplicationOptions } from 'pixi.js';
+import { ComponentChanged } from '@eva/eva.js';
+import { Container } from '@eva/renderer-adapter';
+import EventEmitter from 'eventemitter3';
+import { Game } from '@eva/eva.js';
+import { GameObject } from '@eva/eva.js';
+import { LOAD_SCENE_MODE } from '@eva/eva.js';
+import { PureObserverInfo } from '@eva/eva.js';
+import { Scene } from '@eva/eva.js';
+import { System } from '@eva/eva.js';
+import { Transform } from '@eva/eva.js';
+import { UpdateParams } from '@eva/eva.js';
+
+export declare type BoundsCoordinateSpace = 'world' | 'canvas' | 'design';
+
+export declare class ContainerManager {
+    containerMap: {
+        [propName: number]: Container;
+    };
+    addContainer({ name, container, gameObject }: {
+        name: number;
+        container: Container;
+        gameObject: GameObject;
+    }): void;
+    getContainer(name: number): Container;
+    /**
+     * Return actual rendered bounds for a GameObject.
+     *
+     * The primary path uses PixiJS Container#getBounds(), so renderers such as
+     * Text/Img/Graphics/Sprite/Spine report the real display size after loading
+     * and style application. If the display object is not ready yet, callers can
+     * fall back to Transform.size in the same Eva design/canvas coordinate space.
+     */
+    getBounds(gameObject: GameObject, options?: GetBoundsOptions): RenderBounds | null;
+    private getTransformBounds;
+    private resolveFallbackWorldPosition;
+    removeContainer(name: number): void;
+    updateTransform({ name, transform }: {
+        name: number;
+        transform: Transform;
+    }): void;
+}
+
+export declare interface GetBoundsOptions {
+    /**
+     * Returned coordinate space.
+     * Eva's Pixi world coordinates use the same logical units as canvas/design coordinates.
+     */
+    coordinateSpace?: BoundsCoordinateSpace;
+    /** Use Transform.size when Pixi bounds are unavailable or still zero. Defaults to true. */
+    fallbackToTransform?: boolean;
+}
+
+declare interface Params {
+    jsUrl: string;
+    wasmUrl: string;
+}
+
+export declare function registerKtx2CompressedTexture(params: Params): void;
+
+export declare interface RenderBounds {
+    /** Bounds x in Eva design/canvas coordinates. */
+    x: number;
+    /** Bounds y in Eva design/canvas coordinates. */
+    y: number;
+    /** Actual rendered width measured from Pixi getBounds(), or Transform.size fallback. */
+    width: number;
+    /** Actual rendered height measured from Pixi getBounds(), or Transform.size fallback. */
+    height: number;
+    /** Bounds right edge in the same coordinate space. */
+    right: number;
+    /** Bounds bottom edge in the same coordinate space. */
+    bottom: number;
+    /** Coordinate space of the returned values. world/canvas/design are the same logical Eva coordinates. */
+    coordinateSpace: BoundsCoordinateSpace;
+    /** Whether this value came from Pixi display object bounds or Transform.size fallback. */
+    source: 'pixi' | 'transform';
+}
+
+export declare class Renderer<T extends {} = {}> extends System<T> {
+    /**
+     * Renderer name
+     */
+    name: string;
+    /**
+     * currentGame
+     */
+    game: Game;
+    /**
+     * observer component props info
+     */
+    static observerInfo: PureObserverInfo;
+    /**
+     * observer component props info
+     */
+    observerInfo: PureObserverInfo;
+    /**
+     * containerManager
+     */
+    containerManager: ContainerManager;
+    rendererManager: RendererManager;
+    constructor(params?: T);
+    /**
+     * 当监听的属性变化时候调用
+     *
+     * called while the observed component props change.
+     */
+    componentChanged(_changed: ComponentChanged): void;
+    /**
+     * 每帧调用
+     *
+     * called by every loop
+     * @param _gameObject - gameObject
+     */
+    rendererUpdate(_gameObject: GameObject): void;
+    update(e?: UpdateParams): void;
+    protected asyncIdMap: Record<number, number>;
+    protected increaseAsyncId(id: number): number;
+    protected validateAsyncId(id: number, asyncId: number): boolean;
+}
+
+export declare enum RENDERER_TYPE {
+    UNKNOWN = 0,
+    WEBGL = 1,
+    CANVAS = 2
+}
+
+declare type RendererGameLike = Partial<Game> & {
+    scene?: unknown;
+    gameObjects?: unknown;
+    on?: (name: string, handler: (...args: any[]) => void) => void;
+};
+
+/**
+ * 渲染管理器类
+ *
+ * RendererManager 负责管理和协调所有渲染器。
+ * 它将组件变化事件分发给相应的渲染器，
+ * 并在每帧调用渲染器的更新方法。
+ *
+ * @example
+ * ```typescript
+ * const rendererManager = new RendererManager({
+ *   game,
+ *   rendererSystem
+ * });
+ *
+ * rendererManager.register(
+ *   new SpriteRenderer(),
+ *   new TextRenderer()
+ * );
+ * ```
+ */
+export declare class RendererManager {
+    /** 游戏实例引用 */
+    game: Game;
+    /** 渲染系统引用 */
+    rendererSystem: RendererSystem;
+    /**
+     * 构造渲染管理器
+     * @param game - 游戏实例
+     * @param rendererSystem - 渲染系统实例
+     */
+    constructor({ game, rendererSystem }: {
+        game: any;
+        rendererSystem: any;
+    });
+    /** 注册的渲染器列表 */
+    renderers: Renderer[];
+    /**
+     * 注册渲染器
+     *
+     * 将渲染器添加到管理器，并为其设置必要的引用。
+     *
+     * @param renderers - 要注册的渲染器列表
+     */
+    register(...renderers: Renderer[]): void;
+    componentChanged(changes: ComponentChanged[]): void;
+    update(gameObject: GameObject): void;
+}
+
+export declare interface RendererResolutionState {
+    width: number;
+    height: number;
+    resolution: number;
+    /** Number of display objects whose own resolution was synchronized. */
+    displayResolutionSyncCount?: number;
+}
+
+export declare class RendererSystem extends System<RendererSystemParams> {
+    static systemName: string;
+    params: Partial<RendererSystemParams>;
+    rendererManager: RendererManager;
+    containerManager: ContainerManager;
+    application: Application;
+    game: Game;
+    transform: Transform_2;
+    multiApps: Application[];
+    suportedCompressedTextureFormats: SuportedCompressedTexture;
+    private destroyed;
+    init(params?: Partial<RendererSystemParams> | RendererGameLike): Promise<void>;
+    registerObserver(observerInfo: any): void;
+    createMultiApplication({ params }: {
+        params: RendererSystemParams;
+    }): Promise<Application>;
+    createApplication(params: Partial<RendererSystemParams>): Promise<Application>;
+    update(): void;
+    lateUpdate(e: any): void;
+    onDestroy(): void;
+    resize(width: number, height: number, resolution?: number): void;
+    /**
+     * 更新 Pixi renderer backing-store resolution，不改变 Eva 设计坐标系。
+     *
+     * 预览画布可用该入口在 zoom/devicePixelRatio 变化时提高清晰度；
+     * getBounds/Transform/worldTransform 仍返回设计逻辑坐标，不乘 resolution。
+     */
+    resizeRenderer(options: ResizeRendererOptions): RendererResolutionState;
+    setResolution(resolution: number, options?: Omit<ResizeRendererOptions, 'resolution'>): RendererResolutionState;
+    private clampResolution;
+    /**
+     * Keep renderer-owned display objects that expose a resolution property in
+     * sync with the backing-store resolution. This is intentionally display-tree
+     * based rather than component-type based, so Text/HTMLText and future Pixi
+     * objects with resolution support all follow the same renderer contract.
+     */
+    private syncDisplayObjectResolution;
+    /**
+     * 获取 GameObject 的真实渲染 bounds。
+     *
+     * 默认返回 PixiJS display object 的 world bounds。Eva 的 Pixi world 坐标
+     * 与 canvas/design 逻辑坐标一致；如果画布被 CSS 缩放，调用方再按
+     * canvas.getBoundingClientRect() / renderer width 做屏幕坐标换算。
+     *
+     * 当渲染对象尚未挂载或资源未加载完成时，会回退到 Transform.size。
+     */
+    getBounds(gameObject: GameObject, options?: GetBoundsOptions): RenderBounds | null;
+    private getApplicationByScene;
+    private onPauseScene;
+    private onStartScene;
+    resizeByScene(scene: any, width: number, height: number, resolution?: number): void;
+}
+
+export declare interface RendererSystemParams extends Partial<ApplicationOptions> {
+    canvas?: HTMLCanvasElement;
+    renderType?: number;
+    enableScroll?: boolean;
+    debugMode?: boolean;
+}
+
+export declare interface ResizeRendererOptions {
+    /** Eva design/canvas logical width. This does not include resolution scaling. */
+    width?: number;
+    /** Eva design/canvas logical height. This does not include resolution scaling. */
+    height?: number;
+    /** Pixi backing-store resolution. Does not change Eva design coordinates. */
+    resolution?: number;
+    /** Upper bound for resolution to avoid oversized backing stores. Defaults to 3. */
+    maxResolution?: number;
+}
+
+declare interface SuportedCompressedTexture {
+    s3tc: boolean;
+    etc: boolean;
+    etc1: boolean;
+    pvrtc: boolean;
+    atc: boolean;
+    astc: boolean;
+}
+
+declare class Transform_2 extends EventEmitter {
+    name: string;
+    waitRemoveIds: number[];
+    waitSceneId: number;
+    system: RendererSystem;
+    containerManager: ContainerManager;
+    waitChangeScenes: {
+        scene: Scene;
+        mode: LOAD_SCENE_MODE;
+        application: Application;
+    }[];
+    constructor({ system, containerManager }: {
+        system: any;
+        containerManager: any;
+    });
+    init(system: RendererSystem): void;
+    update(): void;
+    componentChanged(changed: ComponentChanged): void;
+    addContainer(changed: ComponentChanged): void;
+    change(changed: ComponentChanged): void;
+    destroy(): void;
+}
+
+export { }