@lightningjs/renderer 3.0.0-beta18 → 3.0.0-beta19

package/dist/src/core/textures/RenderTexture.js.map

@@ -1 +1 @@
-{"version":3,"file":"RenderTexture.js","sourceRoot":"","sources":["../../../../src/core/textures/RenderTexture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAoB,MAAM,cAAc,CAAC;AAmBtE,MAAM,OAAO,aAAc,SAAQ,OAAO;IACxC,KAAK,CAA+B;IAEpB,IAAI,GAAgB,WAAW,CAAC,eAAe,CAAC;IAEhE,YAAY,SAA6B,EAAE,KAA0B;QACnE,KAAK,CAAC,SAAS,CAAC,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,aAAa,CAAC,eAAe,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,CAAC,CAAC,KAAa;QACjB,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,CAAC,CAAC,KAAa;QACjB,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC;IACvB,CAAC;IAEQ,KAAK,CAAC,gBAAgB;QAC7B,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAEzB,OAAO;YACL,IAAI,EAAE,IAAI;YACV,gBAAgB,EAAE,IAAI;SACvB,CAAC;IACJ,CAAC;IAED,MAAM,CAAU,eAAe,CAC7B,KAAyB;QAEzB,OAAO;YACL,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,GAAG;YACjB,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,GAAG;SAClB,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,eAAe,CAAqB;CAC5C"}
+{"version":3,"file":"RenderTexture.js","sourceRoot":"","sources":["../../../../src/core/textures/RenderTexture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAoB,MAAM,cAAc,CAAC;AAmBtE,MAAM,OAAO,aAAc,SAAQ,OAAO;IACxC,KAAK,CAA+B;IAEpB,IAAI,GAAgB,WAAW,CAAC,eAAe,CAAC;IAEhE,YACE,SAA6B,EAC7B,KAAmC;QAEnC,KAAK,CAAC,SAAS,CAAC,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,CAAC,CAAC,KAAa;QACjB,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,CAAC,CAAC,KAAa;QACjB,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC;IACvB,CAAC;IAEQ,KAAK,CAAC,gBAAgB;QAC7B,mEAAmE;QACnE,OAAO;YACL,IAAI,EAAE,IAAI;YACV,gBAAgB,EAAE,IAAI;SACvB,CAAC;IACJ,CAAC;IAED,MAAM,CAAU,eAAe,CAC7B,KAAyB;QAEzB,OAAO;YACL,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,GAAG;YACjB,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,GAAG;SAClB,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,eAAe,CAAqB;CAC5C"}

package/dist/src/core/textures/SubTexture.d.ts

@@ -47,14 +47,12 @@ export declare class SubTexture extends Texture {
     props: Required<SubTextureProps>;
     parentTexture: Texture;
     type: TextureType;
-    constructor(txManager: CoreTextureManager, props: SubTextureProps);
+    subtextureId: string;
+    constructor(txManager: CoreTextureManager, props: Required<SubTextureProps>);
     private onParentTxLoaded;
     private onParentTxFailed;
-    private onParentTxFetched;
-    private onParentTxFetching;
     private onParentTxLoading;
     private onParentTxFreed;
-    private forwardParentTxState;
     onChangeIsRenderable(isRenderable: boolean): void;
     getTextureSource(): Promise<TextureData>;
     static makeCacheKey(props: SubTextureProps): string | false;

package/dist/src/core/textures/SubTexture.js

@@ -19,6 +19,7 @@
 import { assertTruthy } from '../../utils.js';
 import { ImageTexture } from './ImageTexture.js';
 import { Texture, TextureType, } from './Texture.js';
+let subTextureId = 0;
 /**
  * A Texture that is a sub-region of another Texture.
  *
@@ -33,15 +34,16 @@ export class SubTexture extends Texture {
     props;
     parentTexture;
     type = TextureType.subTexture;
+    subtextureId = `subtexture-${subTextureId++}`;
     constructor(txManager, props) {
         super(txManager);
-        this.props = SubTexture.resolveDefaults(props || {});
+        this.props = props;
         assertTruthy(this.props.texture, 'SubTexture requires a parent texture');
         assertTruthy(this.props.texture instanceof ImageTexture, 'SubTexture requires an ImageTexture parent');
         // Resolve parent texture from cache or fallback to provided texture
         this.parentTexture = txManager.resolveParentTexture(this.props.texture);
-        if (this.renderableOwners.size > 0) {
-            this.parentTexture.setRenderableOwner(this, true);
+        if (this.renderableOwners.length > 0) {
+            this.parentTexture.setRenderableOwner(this.subtextureId, true);
         }
         // If parent texture is already loaded / failed, trigger loaded event manually
         // so that users get a consistent event experience.
@@ -49,27 +51,19 @@ export class SubTexture extends Texture {
         // synchronous task after calling loadTexture()
         queueMicrotask(() => {
             const parentTx = this.parentTexture;
-            if (parentTx.state === 'loaded') {
+            if (parentTx.state === 'loaded' && parentTx.dimensions !== null) {
                 this.onParentTxLoaded(parentTx, parentTx.dimensions);
             }
-            else if (parentTx.state === 'fetching') {
-                this.onParentTxFetching();
-            }
-            else if (parentTx.state === 'fetched') {
-                this.onParentTxFetched();
-            }
             else if (parentTx.state === 'loading') {
                 this.onParentTxLoading();
             }
-            else if (parentTx.state === 'failed') {
+            else if (parentTx.state === 'failed' && parentTx.error !== null) {
                 this.onParentTxFailed(parentTx, parentTx.error);
             }
             else if (parentTx.state === 'freed') {
                 this.onParentTxFreed();
             }
-            parentTx.on('fetched', this.onParentTxFetched);
             parentTx.on('loading', this.onParentTxLoading);
-            parentTx.on('fetching', this.onParentTxFetching);
             parentTx.on('loaded', this.onParentTxLoaded);
             parentTx.on('failed', this.onParentTxFailed);
             parentTx.on('freed', this.onParentTxFreed);
@@ -78,40 +72,28 @@ export class SubTexture extends Texture {
     onParentTxLoaded = () => {
         // We ignore the parent's passed dimensions, and simply use the SubTexture's
         // configured dimensions (because that's all that matters here)
-        this.forwardParentTxState('loaded', {
+        this.setState('loaded', {
             w: this.props.w,
             h: this.props.h,
         });
     };
     onParentTxFailed = (target, error) => {
-        this.forwardParentTxState('failed', error);
-    };
-    onParentTxFetched = () => {
-        this.forwardParentTxState('fetched', {
-            w: this.props.w,
-            h: this.props.h,
-        });
-    };
-    onParentTxFetching = () => {
-        this.forwardParentTxState('fetching');
+        this.retryCount = this.parentTexture.retryCount - 1;
+        this.setState('failed', error);
     };
     onParentTxLoading = () => {
-        this.forwardParentTxState('loading');
+        this.setState('loading');
     };
     onParentTxFreed = () => {
-        this.forwardParentTxState('freed');
+        this.setState('freed');
     };
-    forwardParentTxState(state, errorOrDimensions) {
-        this.setState(state, errorOrDimensions);
-    }
     onChangeIsRenderable(isRenderable) {
         // Propagate the renderable owner change to the parent texture
-        this.parentTexture.setRenderableOwner(this, isRenderable);
+        this.parentTexture.setRenderableOwner(this.subtextureId, isRenderable);
     }
     async getTextureSource() {
         // Check if parent texture is loaded
         return new Promise((resolve, reject) => {
-            this.setState('fetched');
             resolve({
                 data: this.props,
             });

package/dist/src/core/textures/SubTexture.js.map

@@ -1 +1 @@
-{"version":3,"file":"SubTexture.js","sourceRoot":"","sources":["../../../../src/core/textures/SubTexture.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SubTexture.js","sourceRoot":"","sources":["../../../../src/core/textures/SubTexture.ts"],"names":[],"mappings":"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"}

package/dist/src/core/textures/Texture.d.ts

@@ -27,11 +27,11 @@ export interface CompressedData {
     /**
      * All mipmap levels
      */
-    mipmaps?: ArrayBuffer[];
+    mipmaps: ArrayBuffer[];
     /**
      * Supported container types ('pvr' or 'ktx').
      */
-    type: 'pvr' | 'ktx';
+    type: 'pvr' | 'ktx' | 'astc';
     /**
      * The width of the compressed texture in pixels. Defaults to 0.
      *
@@ -42,6 +42,14 @@ export interface CompressedData {
      * The height of the compressed texture in pixels.
      **/
     h: number;
+    /**
+     * block info compressed texture format
+     */
+    blockInfo: {
+        width: number;
+        height: number;
+        bytes: number;
+    };
 }
 /**
  * Event handler for when a Texture fails to load
@@ -95,20 +103,50 @@ export declare abstract class Texture extends EventEmitter {
      */
     private _dimensions;
     private _error;
-    /**
-     * Texture states that are considered transitional and should be skipped during cleanup
-     */
-    static readonly TRANSITIONAL_TEXTURE_STATES: readonly TextureState[];
     state: TextureState;
-    readonly renderableOwners: Set<unknown>;
+    readonly renderableOwners: any[];
     readonly renderable: boolean;
     type: TextureType;
     preventCleanup: boolean;
     ctxTexture: CoreContextTexture | undefined;
     textureData: TextureData | null;
+    memUsed: number;
+    /**
+     * Memory used by this texture in bytes
+     *
+     * @remarks
+     * This is tracked by the TextureMemoryManager and updated when the texture
+     * is loaded/freed. Set to 0 when texture is not loaded.
+     */
+    retryCount: number;
+    maxRetryCount: number;
+    /**
+     * Timestamp when texture was created (for startup grace period)
+     */
+    private createdAt;
+    /**
+     * Flag to track if grace period has expired to avoid repeated Date.now() calls
+     */
+    private gracePeriodExpired;
+    /**
+     * Grace period in milliseconds to prevent premature cleanup during app startup
+     * This helps prevent race conditions when bounds calculation is delayed
+     */
+    private static readonly STARTUP_GRACE_PERIOD;
     constructor(txManager: CoreTextureManager);
     get dimensions(): Dimensions | null;
     get error(): Error | null;
+    /**
+     * Checks if the texture is within the startup grace period.
+     * During this period, textures are protected from cleanup to prevent
+     * race conditions during app initialization.
+     */
+    isWithinStartupGracePeriod(): boolean;
+    /**
+     * Checks if the texture can be safely cleaned up.
+     * Considers the renderable state, startup grace period, and renderable owners.
+     */
+    canBeCleanedUp(): boolean;
     /**
      * Add/remove an owner to/from the Texture based on its renderability.
      *
@@ -123,7 +161,7 @@ export declare abstract class Texture extends EventEmitter {
      * @param owner
      * @param renderable
      */
-    setRenderableOwner(owner: unknown, renderable: boolean): void;
+    setRenderableOwner(owner: string | number, renderable: boolean): void;
     load(): void;
     /**
      * Event called when the Texture becomes renderable or unrenderable.
@@ -149,6 +187,13 @@ export declare abstract class Texture extends EventEmitter {
      * The ctxTexture is created by the renderer and lives on the GPU.
      */
     free(): void;
+    /**
+     * Release the texture data and core context texture for this Texture without changing state.
+     *
+     * @remarks
+     * The ctxTexture is created by the renderer and lives on the GPU.
+     */
+    release(): void;
     /**
      * Destroy the texture.
      *
@@ -177,6 +222,20 @@ export declare abstract class Texture extends EventEmitter {
      * The texture data for this texture.
      */
     getTextureData(): Promise<TextureData>;
+    /**
+     * Task for queueMicrotask to free texture data.
+     *
+     * @remarks
+     * This method is called in a microtask to free the texture data.
+     */
+    private freeTextureDataTask;
+    /**
+     * Task for queueMicrotask to release the texture.
+     *
+     * @remarks
+     * This method is called in a microtask to release the texture.
+     */
+    private releaseTask;
     /**
      * Get the texture source for this texture.
      *

package/dist/src/core/textures/Texture.js

@@ -46,21 +46,41 @@ export class Texture extends EventEmitter {
      */
     _dimensions = null;
     _error = null;
-    /**
-     * Texture states that are considered transitional and should be skipped during cleanup
-     */
-    static TRANSITIONAL_TEXTURE_STATES = ['fetching', 'fetched', 'loading'];
     // aggregate state
     state = 'initial';
-    renderableOwners = new Set();
+    renderableOwners = [];
     renderable = false;
     type = TextureType.generic;
     preventCleanup = false;
     ctxTexture;
     textureData = null;
+    memUsed = 0;
+    /**
+     * Memory used by this texture in bytes
+     *
+     * @remarks
+     * This is tracked by the TextureMemoryManager and updated when the texture
+     * is loaded/freed. Set to 0 when texture is not loaded.
+     */
+    retryCount = 0;
+    maxRetryCount;
+    /**
+     * Timestamp when texture was created (for startup grace period)
+     */
+    createdAt = Date.now();
+    /**
+     * Flag to track if grace period has expired to avoid repeated Date.now() calls
+     */
+    gracePeriodExpired = false;
+    /**
+     * Grace period in milliseconds to prevent premature cleanup during app startup
+     * This helps prevent race conditions when bounds calculation is delayed
+     */
+    static STARTUP_GRACE_PERIOD = 2000; // 2 seconds
     constructor(txManager) {
         super();
         this.txManager = txManager;
+        this.maxRetryCount = this.txManager.maxRetryCount;
     }
     get dimensions() {
         return this._dimensions;
@@ -68,6 +88,49 @@ export class Texture extends EventEmitter {
     get error() {
         return this._error;
     }
+    /**
+     * Checks if the texture is within the startup grace period.
+     * During this period, textures are protected from cleanup to prevent
+     * race conditions during app initialization.
+     */
+    isWithinStartupGracePeriod() {
+        // If grace period already expired, return false immediately
+        if (this.gracePeriodExpired === true) {
+            return false;
+        }
+        // Check if grace period has expired now
+        const hasExpired = Date.now() - this.createdAt >= Texture.STARTUP_GRACE_PERIOD;
+        if (hasExpired) {
+            // Cache the result to avoid future Date.now() calls
+            this.gracePeriodExpired = true;
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Checks if the texture can be safely cleaned up.
+     * Considers the renderable state, startup grace period, and renderable owners.
+     */
+    canBeCleanedUp() {
+        // Never cleanup if explicitly prevented
+        if (this.preventCleanup) {
+            return false;
+        }
+        // Don't cleanup if still within startup grace period
+        if (this.isWithinStartupGracePeriod()) {
+            return false;
+        }
+        // Don't cleanup if not renderable
+        if (this.renderable === true) {
+            return false;
+        }
+        // Don't cleanup if there are still renderable owners
+        if (this.renderableOwners.length > 0) {
+            return false;
+        }
+        // Safe to cleanup
+        return true;
+    }
     /**
      * Add/remove an owner to/from the Texture based on its renderability.
      *
@@ -83,30 +146,38 @@ export class Texture extends EventEmitter {
      * @param renderable
      */
     setRenderableOwner(owner, renderable) {
-        const oldSize = this.renderableOwners.size;
+        const oldSize = this.renderableOwners.length;
+        const hasOwnerIndex = this.renderableOwners.indexOf(owner);
         if (renderable === true) {
-            if (this.renderableOwners.has(owner) === false) {
+            if (hasOwnerIndex === -1) {
                 // Add the owner to the set
-                this.renderableOwners.add(owner);
+                this.renderableOwners.push(owner);
             }
-            const newSize = this.renderableOwners.size;
-            if (newSize > oldSize && newSize === 1) {
+            const newSize = this.renderableOwners.length;
+            if (oldSize !== newSize && newSize === 1) {
                 this.renderable = true;
                 this.onChangeIsRenderable?.(true);
                 this.load();
             }
         }
         else {
-            this.renderableOwners.delete(owner);
-            const newSize = this.renderableOwners.size;
-            if (newSize < oldSize && newSize === 0) {
+            if (hasOwnerIndex !== -1) {
+                this.renderableOwners.splice(hasOwnerIndex, 1);
+            }
+            const newSize = this.renderableOwners.length;
+            if (oldSize !== newSize && newSize === 0) {
                 this.renderable = false;
                 this.onChangeIsRenderable?.(false);
-                this.txManager.orphanTexture(this);
+                // note, not doing a cleanup here, cleanup is managed by the Stage/TextureMemoryManager
+                // when it deems appropriate based on memory pressure
             }
         }
     }
     load() {
+        if (this.retryCount > this.maxRetryCount) {
+            // We've exceeded the max retry count, do not attempt to load again
+            return;
+        }
         this.txManager.loadTexture(this);
     }
     /**
@@ -130,6 +201,17 @@ export class Texture extends EventEmitter {
     free() {
         this.ctxTexture?.free();
     }
+    /**
+     * Release the texture data and core context texture for this Texture without changing state.
+     *
+     * @remarks
+     * The ctxTexture is created by the renderer and lives on the GPU.
+     */
+    release() {
+        this.ctxTexture?.release();
+        this.ctxTexture = undefined;
+        this.freeTextureData();
+    }
     /**
      * Destroy the texture.
      *
@@ -153,7 +235,7 @@ export class Texture extends EventEmitter {
      * e.g. ImageData that is downloaded from a URL.
      */
     freeTextureData() {
-        this.textureData = null;
+        queueMicrotask(this.freeTextureDataTask);
     }
     setState(state, errorOrDimensions) {
         if (this.state === state) {
@@ -173,6 +255,18 @@ export class Texture extends EventEmitter {
         else if (state === 'failed') {
             this._error = errorOrDimensions;
             payload = this._error;
+            // increment the retry count for the texture
+            // this is used to compare against maxRetryCount, if set
+            // to determine if we should try loading again
+            this.retryCount += 1;
+            queueMicrotask(this.releaseTask);
+        }
+        else if (state === 'loading') {
+            this._error = null;
+            this._dimensions = null;
+        }
+        else {
+            this._error = null;
         }
         // emit the new state
         this.state = state;
@@ -194,6 +288,24 @@ export class Texture extends EventEmitter {
         }
         return this.textureData;
     }
+    /**
+     * Task for queueMicrotask to free texture data.
+     *
+     * @remarks
+     * This method is called in a microtask to free the texture data.
+     */
+    freeTextureDataTask = () => {
+        this.textureData = null;
+    };
+    /**
+     * Task for queueMicrotask to release the texture.
+     *
+     * @remarks
+     * This method is called in a microtask to release the texture.
+     */
+    releaseTask = () => {
+        this.release();
+    };
     /**
      * Make a cache key for this texture.
      *

package/dist/src/core/textures/Texture.js.map

@@ -1 +1 @@
-{"version":3,"file":"Texture.js","sourceRoot":"","sources":["../../../../src/core/textures/Texture.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Texture.js","sourceRoot":"","sources":["../../../../src/core/textures/Texture.ts"],"names":[],"mappings":"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"}

package/dist/src/main-api/Renderer.d.ts

@@ -372,6 +372,19 @@ export type RendererMainSettings = RendererRuntimeSettings & {
      * @defaultValue `null`
      */
     platform: typeof Platform | null;
+    /**
+     * Number of times to retry loading a failed texture
+     *
+     * @remarks
+     * When a texture fails to load, Lightning will retry up to this many times
+     * before permanently giving up. Each retry will clear the texture ownership
+     * and then re-establish it to trigger a new load attempt.
+     *
+     * Set to null to disable retries. Set to 0 to always try once and never retry.
+     * This is typically only used on ImageTexture instances.
+     *
+     */
+    maxRetryCount?: number;
 };
 /**
  * The Renderer Main API
@@ -436,7 +449,7 @@ export declare class RendererMain extends EventEmitter {
      * @param target Element ID or HTMLElement to insert the canvas into
      * @param driver Core Driver to use
      */
-    constructor(settings: Partial<RendererMainSettings>, target: string | HTMLElement);
+    constructor(settings: Partial<RendererMainSettings>, target?: string | HTMLElement);
     /**
      * Resolves the Texture Memory Manager values
      *
@@ -555,7 +568,7 @@ export declare class RendererMain extends EventEmitter {
      * **NOTE3**: This will not cleanup textures that are marked as `preventCleanup`.
      * **NOTE4**: This has nothing to do with the garbage collection of JavaScript.
      */
-    cleanup(aggressive?: boolean): void;
+    cleanup(): void;
     /**
      * Sets the clear color for the stage.
      *

package/dist/src/main-api/Renderer.js

@@ -95,7 +95,7 @@ export class RendererMain extends EventEmitter {
             textureMemory: resolvedTxSettings,
             boundsMargin: settings.boundsMargin || 0,
             deviceLogicalPixelRatio: settings.deviceLogicalPixelRatio || 1,
-            devicePhysicalPixelRatio: settings.devicePhysicalPixelRatio || (window.devicePixelRatio || 1),
+            devicePhysicalPixelRatio: settings.devicePhysicalPixelRatio || window.devicePixelRatio || 1,
             clearColor: settings.clearColor ?? 0x00000000,
             fpsUpdateInterval: settings.fpsUpdateInterval || 0,
             targetFPS: settings.targetFPS || 0,
@@ -111,6 +111,7 @@ export class RendererMain extends EventEmitter {
             canvas: settings.canvas,
             createImageBitmapSupport: settings.createImageBitmapSupport || 'full',
             platform: settings.platform || null,
+            maxRetryCount: settings.maxRetryCount ?? 5,
         };
         const { appWidth, appHeight, deviceLogicalPixelRatio, devicePhysicalPixelRatio, inspector, } = settings;
         let platform;
@@ -154,21 +155,27 @@ export class RendererMain extends EventEmitter {
             textureProcessingTimeLimit: settings.textureProcessingTimeLimit,
             createImageBitmapSupport: settings.createImageBitmapSupport,
             platform,
+            maxRetryCount: settings.maxRetryCount ?? 5,
         });
         // Extract the root node
         this.root = this.stage.root;
         // Get the target element and attach the canvas to it
-        let targetEl;
-        if (typeof target === 'string') {
-            targetEl = document.getElementById(target);
-        }
-        else {
-            targetEl = target;
+        if (target) {
+            let targetEl;
+            if (typeof target === 'string') {
+                targetEl = document.getElementById(target);
+            }
+            else {
+                targetEl = target;
+            }
+            if (!targetEl) {
+                throw new Error('Could not find target element');
+            }
+            targetEl.appendChild(canvas);
         }
-        if (!targetEl) {
-            throw new Error('Could not find target element');
+        else if (settings.canvas !== canvas) {
+            throw new Error('New canvas element could not be appended to undefined target');
         }
-        targetEl.appendChild(canvas);
         // Initialize inspector (if enabled)
         if (inspector && isProductionEnvironment === false) {
             this.inspector = new inspector(canvas, settings);
@@ -359,8 +366,8 @@ export class RendererMain extends EventEmitter {
      * **NOTE3**: This will not cleanup textures that are marked as `preventCleanup`.
      * **NOTE4**: This has nothing to do with the garbage collection of JavaScript.
      */
-    cleanup(aggressive = false) {
-        this.stage.cleanup(aggressive);
+    cleanup() {
+        this.stage.cleanup();
     }
     /**
      * Sets the clear color for the stage.