@lightningjs/renderer 2.10.0 → 2.11.0

package/dist/src/core/TextNode.js

@@ -0,0 +1,331 @@
+/*
+ * If not stated otherwise in this file or this component's LICENSE file the
+ * following copyright and licenses apply:
+ *
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
+ *
+ * Licensed under the Apache License, Version 2.0 (the License);
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { LngNode, UpdateType } from './LngNode.js';
+import { assertTruthy } from '../utils.js';
+import { Matrix3d } from './lib/Matrix3d.js';
+/**
+ * An LngNode in the Renderer scene graph that renders text.
+ *
+ * @remarks
+ * A Text Node is the second graphical building block of the Renderer scene
+ * graph. It renders text using a specific text renderer that is automatically
+ * chosen based on the font requested and what type of fonts are installed
+ * into an app.
+ *
+ * The text renderer can be overridden by setting the `textRendererOverride`
+ *
+ * The `texture` and `shader` properties are managed by loaded text renderer and
+ * should not be set directly.
+ *
+ * For non-text rendering, see {@link LngNode}.
+ */
+export class TextNode extends LngNode {
+    textRenderer;
+    trState;
+    _textRendererOverride = null;
+    constructor(stage, props) {
+        super(stage, props);
+        this._textRendererOverride = props.textRendererOverride;
+        const { resolvedTextRenderer, textRendererState } = this.resolveTextRendererAndState({
+            x: this.absX,
+            y: this.absY,
+            width: props.width,
+            height: props.height,
+            textAlign: props.textAlign,
+            color: props.color,
+            zIndex: props.zIndex,
+            contain: props.contain,
+            scrollable: props.scrollable,
+            scrollY: props.scrollY,
+            offsetY: props.offsetY,
+            letterSpacing: props.letterSpacing,
+            debug: props.debug,
+            fontFamily: props.fontFamily,
+            fontSize: props.fontSize,
+            fontStretch: props.fontStretch,
+            fontStyle: props.fontStyle,
+            fontWeight: props.fontWeight,
+            text: props.text,
+            lineHeight: props.lineHeight,
+            maxLines: props.maxLines,
+            textBaseline: props.textBaseline,
+            verticalAlign: props.verticalAlign,
+            overflowSuffix: props.overflowSuffix,
+        });
+        this.textRenderer = resolvedTextRenderer;
+        this.trState = textRendererState;
+    }
+    onTextLoaded = () => {
+        const { contain } = this;
+        const setWidth = this.trState.props.width;
+        const setHeight = this.trState.props.height;
+        const calcWidth = this.trState.textW || 0;
+        const calcHeight = this.trState.textH || 0;
+        if (contain === 'both') {
+            this.props.width = setWidth;
+            this.props.height = setHeight;
+        }
+        else if (contain === 'width') {
+            this.props.width = setWidth;
+            this.props.height = calcHeight;
+        }
+        else if (contain === 'none') {
+            this.props.width = calcWidth;
+            this.props.height = calcHeight;
+        }
+        this.updateLocalTransform();
+        // Incase the RAF loop has been stopped already before text was loaded,
+        // we request a render so it can be drawn.
+        this.stage.requestRender();
+        this.emit('loaded', {
+            type: 'text',
+            dimensions: {
+                width: this.trState.textW || 0,
+                height: this.trState.textH || 0,
+            },
+        });
+    };
+    onTextFailed = (target, error) => {
+        this.emit('failed', {
+            type: 'text',
+            error,
+        });
+    };
+    get width() {
+        return this.props.width;
+    }
+    set width(value) {
+        this.props.width = value;
+        this.textRenderer.set.width(this.trState, value);
+        // If not containing, we must update the local transform to account for the
+        // new width
+        if (this.contain === 'none') {
+            this.setUpdateType(UpdateType.Local);
+        }
+    }
+    get height() {
+        return this.props.height;
+    }
+    set height(value) {
+        this.props.height = value;
+        this.textRenderer.set.height(this.trState, value);
+        // If not containing in the horizontal direction, we must update the local
+        // transform to account for the new height
+        if (this.contain !== 'both') {
+            this.setUpdateType(UpdateType.Local);
+        }
+    }
+    get color() {
+        return this.trState.props.color;
+    }
+    set color(value) {
+        this.textRenderer.set.color(this.trState, value);
+    }
+    get text() {
+        return this.trState.props.text;
+    }
+    set text(value) {
+        this.textRenderer.set.text(this.trState, value);
+    }
+    get textRendererOverride() {
+        return this._textRendererOverride;
+    }
+    set textRendererOverride(value) {
+        this._textRendererOverride = value;
+        this.textRenderer.destroyState(this.trState);
+        const { resolvedTextRenderer, textRendererState } = this.resolveTextRendererAndState(this.trState.props);
+        this.textRenderer = resolvedTextRenderer;
+        this.trState = textRendererState;
+    }
+    get fontSize() {
+        return this.trState.props.fontSize;
+    }
+    set fontSize(value) {
+        this.textRenderer.set.fontSize(this.trState, value);
+    }
+    get fontFamily() {
+        return this.trState.props.fontFamily;
+    }
+    set fontFamily(value) {
+        this.textRenderer.set.fontFamily(this.trState, value);
+    }
+    get fontStretch() {
+        return this.trState.props.fontStretch;
+    }
+    set fontStretch(value) {
+        this.textRenderer.set.fontStretch(this.trState, value);
+    }
+    get fontStyle() {
+        return this.trState.props.fontStyle;
+    }
+    set fontStyle(value) {
+        this.textRenderer.set.fontStyle(this.trState, value);
+    }
+    get fontWeight() {
+        return this.trState.props.fontWeight;
+    }
+    set fontWeight(value) {
+        this.textRenderer.set.fontWeight(this.trState, value);
+    }
+    get textAlign() {
+        return this.trState.props.textAlign;
+    }
+    set textAlign(value) {
+        this.textRenderer.set.textAlign(this.trState, value);
+    }
+    get contain() {
+        return this.trState.props.contain;
+    }
+    set contain(value) {
+        this.textRenderer.set.contain(this.trState, value);
+    }
+    get scrollable() {
+        return this.trState.props.scrollable;
+    }
+    set scrollable(value) {
+        this.textRenderer.set.scrollable(this.trState, value);
+    }
+    get scrollY() {
+        return this.trState.props.scrollY;
+    }
+    set scrollY(value) {
+        this.textRenderer.set.scrollY(this.trState, value);
+    }
+    get offsetY() {
+        return this.trState.props.offsetY;
+    }
+    set offsetY(value) {
+        this.textRenderer.set.offsetY(this.trState, value);
+    }
+    get letterSpacing() {
+        return this.trState.props.letterSpacing;
+    }
+    set letterSpacing(value) {
+        this.textRenderer.set.letterSpacing(this.trState, value);
+    }
+    get lineHeight() {
+        return this.trState.props.lineHeight;
+    }
+    set lineHeight(value) {
+        if (this.textRenderer.set.lineHeight) {
+            this.textRenderer.set.lineHeight(this.trState, value);
+        }
+    }
+    get maxLines() {
+        return this.trState.props.maxLines;
+    }
+    set maxLines(value) {
+        if (this.textRenderer.set.maxLines) {
+            this.textRenderer.set.maxLines(this.trState, value);
+        }
+    }
+    get textBaseline() {
+        return this.trState.props.textBaseline;
+    }
+    set textBaseline(value) {
+        if (this.textRenderer.set.textBaseline) {
+            this.textRenderer.set.textBaseline(this.trState, value);
+        }
+    }
+    get verticalAlign() {
+        return this.trState.props.verticalAlign;
+    }
+    set verticalAlign(value) {
+        if (this.textRenderer.set.verticalAlign) {
+            this.textRenderer.set.verticalAlign(this.trState, value);
+        }
+    }
+    get overflowSuffix() {
+        return this.trState.props.overflowSuffix;
+    }
+    set overflowSuffix(value) {
+        if (this.textRenderer.set.overflowSuffix) {
+            this.textRenderer.set.overflowSuffix(this.trState, value);
+        }
+    }
+    get debug() {
+        return this.trState.props.debug;
+    }
+    set debug(value) {
+        this.textRenderer.set.debug(this.trState, value);
+    }
+    update(delta, parentClippingRect) {
+        super.update(delta, parentClippingRect);
+        assertTruthy(this.globalTransform);
+        // globalTransform is updated in super.update(delta)
+        this.textRenderer.set.x(this.trState, this.globalTransform.tx);
+        this.textRenderer.set.y(this.trState, this.globalTransform.ty);
+    }
+    checkRenderProps() {
+        if (this.trState.props.text !== '') {
+            return true;
+        }
+        return super.checkRenderProps();
+    }
+    onChangeIsRenderable(isRenderable) {
+        super.onChangeIsRenderable(isRenderable);
+        this.textRenderer.setIsRenderable(this.trState, isRenderable);
+    }
+    renderQuads(renderer) {
+        assertTruthy(this.globalTransform);
+        // Prevent quad rendering if parent has a render texture
+        // and this node is not the render texture
+        if (this.parentHasRenderTexture) {
+            if (!renderer.renderToTextureActive) {
+                return;
+            }
+            // Prevent quad rendering if parent render texture is not the active render texture
+            if (this.parentRenderTexture !== renderer.activeRttNode) {
+                return;
+            }
+        }
+        if (this.parentHasRenderTexture && this.props.parent?.rtt) {
+            this.globalTransform = Matrix3d.identity();
+            if (this.localTransform) {
+                this.globalTransform.multiply(this.localTransform);
+            }
+        }
+        assertTruthy(this.globalTransform);
+        this.textRenderer.renderQuads(this.trState, this.globalTransform, this.clippingRect, this.worldAlpha, this.parentHasRenderTexture, this.framebufferDimensions);
+    }
+    /**
+     * Destroy the node and cleanup all resources
+     */
+    destroy() {
+        super.destroy();
+        this.textRenderer.destroyState(this.trState);
+    }
+    /**
+     * Resolve a text renderer and a new state based on the current text renderer props provided
+     * @param props
+     * @returns
+     */
+    resolveTextRendererAndState(props) {
+        const resolvedTextRenderer = this.stage.resolveTextRenderer(props, this._textRendererOverride);
+        const textRendererState = resolvedTextRenderer.createState(props);
+        textRendererState.emitter.on('loaded', this.onTextLoaded);
+        textRendererState.emitter.on('failed', this.onTextFailed);
+        resolvedTextRenderer.scheduleUpdateState(textRendererState);
+        return {
+            resolvedTextRenderer,
+            textRendererState,
+        };
+    }
+}
+//# sourceMappingURL=TextNode.js.map

package/dist/src/core/TextNode.js.map

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

package/dist/src/core/TextureMemoryManager.d.ts

@@ -44,6 +44,16 @@ export interface TextureMemoryManagerSettings {
      * @defaultValue `false`
      */
     debugLogging: boolean;
+    /**
+     * Baseline memory allocation for the Texture Memory Manager
+     *
+     * @remarks
+     * Baseline texture memory is an allocation of memory by simply having a 1080p WebGL context.
+     * This will be used on top of the memory used by textures to determine when to trigger a cleanup.
+     *
+     * @defaultValue `25e6` (25 MB)
+     */
+    baselineMemoryAllocation: number;
 }
 export interface MemoryInfo {
     criticalThreshold: number;
@@ -52,6 +62,7 @@ export interface MemoryInfo {
     memUsed: number;
     renderableTexturesLoaded: number;
     loadedTextures: number;
+    baselineMemoryAllocation: number;
 }
 /**
  * LRU (Least Recently Used) style memory manager for textures
@@ -72,6 +83,7 @@ export declare class TextureMemoryManager {
     private stage;
     private memUsed;
     private loadedTextures;
+    private orphanedTextures;
     private criticalThreshold;
     private targetThreshold;
     private cleanupInterval;
@@ -88,6 +100,24 @@ export declare class TextureMemoryManager {
      */
     frameTime: number;
     constructor(stage: Stage, settings: TextureMemoryManagerSettings);
+    /**
+     * Add a texture to the orphaned textures list
+     *
+     * @param texture - The texture to add to the orphaned textures list
+     */
+    addToOrphanedTextures(texture: Texture): void;
+    /**
+     * Remove a texture from the orphaned textures list
+     *
+     * @param texture - The texture to remove from the orphaned textures list
+     */
+    removeFromOrphanedTextures(texture: Texture): void;
+    /**
+     * Set the memory usage of a texture
+     *
+     * @param texture - The texture to set memory usage for
+     * @param byteSize - The size of the texture in bytes
+     */
     setTextureMemUse(texture: Texture, byteSize: number): void;
     checkCleanup(): boolean;
     cleanup(): void;

package/dist/src/core/TextureMemoryManager.js

@@ -1,3 +1,22 @@
+/*
+ * If not stated otherwise in this file or this component's LICENSE file the
+ * following copyright and licenses apply:
+ *
+ * Copyright 2024 Comcast Cable Communications Management, LLC.
+ *
+ * Licensed under the Apache License, Version 2.0 (the License);
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { isProductionEnvironment } from '../utils.js';
 import { bytesToMb } from './utils.js';
 /**
  * LRU (Least Recently Used) style memory manager for textures
@@ -18,6 +37,7 @@ export class TextureMemoryManager {
     stage;
     memUsed = 0;
     loadedTextures = new Map();
+    orphanedTextures = [];
     criticalThreshold;
     targetThreshold;
     cleanupInterval;
@@ -41,6 +61,7 @@ export class TextureMemoryManager {
         this.targetThreshold = Math.round(criticalThreshold * targetFraction);
         this.cleanupInterval = settings.cleanupInterval;
         this.debugLogging = settings.debugLogging;
+        this.memUsed = Math.round(settings.baselineMemoryAllocation);
         if (settings.debugLogging) {
             let lastMemUse = 0;
             setInterval(() => {
@@ -57,6 +78,34 @@ export class TextureMemoryManager {
             this.setTextureMemUse = () => { };
         }
     }
+    /**
+     * Add a texture to the orphaned textures list
+     *
+     * @param texture - The texture to add to the orphaned textures list
+     */
+    addToOrphanedTextures(texture) {
+        // If the texture can be cleaned up, add it to the orphaned textures list
+        if (texture.preventCleanup === false) {
+            this.orphanedTextures.push(texture);
+        }
+    }
+    /**
+     * Remove a texture from the orphaned textures list
+     *
+     * @param texture - The texture to remove from the orphaned textures list
+     */
+    removeFromOrphanedTextures(texture) {
+        const index = this.orphanedTextures.indexOf(texture);
+        if (index !== -1) {
+            this.orphanedTextures.splice(index, 1);
+        }
+    }
+    /**
+     * Set the memory usage of a texture
+     *
+     * @param texture - The texture to set memory usage for
+     * @param byteSize - The size of the texture in bytes
+     */
     setTextureMemUse(texture, byteSize) {
         if (this.loadedTextures.has(texture)) {
             // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
@@ -83,7 +132,7 @@ export class TextureMemoryManager {
         const critical = this.criticalCleanupRequested;
         this.lastCleanupTime = this.frameTime;
         this.criticalCleanupRequested = false;
-        if (critical) {
+        if (critical === true) {
             this.stage.queueFrameEvent('criticalCleanup', {
                 memUsed: this.memUsed,
                 criticalThreshold: this.criticalThreshold,
@@ -92,52 +141,22 @@ export class TextureMemoryManager {
         if (this.debugLogging) {
             console.log(`[TextureMemoryManager] Cleaning up textures. Critical: ${critical}`);
         }
-        /**
-         * Sort the loaded textures by renderability, then by last touch time.
-         *
-         * This will ensure that the array is ordered by the following:
-         * - Non-renderable textures, starting at the least recently rendered
-         * - Renderable textures, starting at the least recently rendered
-         */
-        const textures = [...this.loadedTextures.keys()].sort((textureA, textureB) => {
-            const txARenderable = textureA.renderable;
-            const txBRenderable = textureB.renderable;
-            if (txARenderable === txBRenderable) {
-                return (textureA.lastRenderableChangeTime -
-                    textureB.lastRenderableChangeTime);
-            }
-            else if (txARenderable) {
-                return 1;
-            }
-            else if (txBRenderable) {
-                return -1;
-            }
-            return 0;
-        });
         // Free non-renderable textures until we reach the target threshold
         const memTarget = this.targetThreshold;
         const txManager = this.stage.txManager;
-        for (const texture of textures) {
-            if (texture.renderable) {
-                // Stop at the first renderable texture (The rest are renderable because of the sort above)
-                // We don't want to free renderable textures because they will just likely be reloaded in the next frame
-                break;
-            }
-            if (texture.preventCleanup === false) {
-                texture.free();
-                txManager.removeTextureFromCache(texture);
-            }
-            if (this.memUsed <= memTarget) {
-                // Stop once we've freed enough textures to reach under the target threshold
-                break;
-            }
+        while (this.memUsed >= memTarget && this.orphanedTextures.length > 0) {
+            const texture = this.orphanedTextures.shift();
+            texture.free();
+            txManager.removeTextureFromCache(texture);
         }
         if (this.memUsed >= this.criticalThreshold) {
             this.stage.queueFrameEvent('criticalCleanupFailed', {
                 memUsed: this.memUsed,
                 criticalThreshold: this.criticalThreshold,
             });
-            console.warn(`[TextureMemoryManager] Memory usage above critical threshold after cleanup: ${this.memUsed}`);
+            if (this.debugLogging === true || isProductionEnvironment() === false) {
+                console.warn(`[TextureMemoryManager] Memory usage above critical threshold after cleanup: ${this.memUsed}`);
+            }
         }
     }
     /**
@@ -160,6 +179,7 @@ export class TextureMemoryManager {
             memUsed: this.memUsed,
             renderableTexturesLoaded,
             loadedTextures: this.loadedTextures.size,
+            baselineMemoryAllocation: this.memUsed - renderableMemUsed,
         };
     }
 }

package/dist/src/core/TextureMemoryManager.js.map

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

package/dist/src/core/lib/Coords.d.ts

@@ -0,0 +1,14 @@
+export declare class RenderCoords {
+    data: Float32Array;
+    constructor(entries?: [number, number, number, number, number, number, number, number] | Float32Array);
+    get x1(): number;
+    get x2(): number;
+    get x3(): number;
+    get xValues(): [number, number, number, number];
+    get x4(): number;
+    get y1(): number;
+    get y2(): number;
+    get y3(): number;
+    get y4(): number;
+    get yValues(): [number, number, number, number];
+}

package/dist/src/core/lib/Coords.js

@@ -0,0 +1,55 @@
+const x1 = 0;
+const x2 = 2;
+const x3 = 4;
+const x4 = 6;
+const y1 = 1;
+const y2 = 3;
+const y3 = 5;
+const y4 = 7;
+export class RenderCoords {
+    data;
+    constructor(entries) {
+        this.data = new Float32Array(8);
+        if (entries) {
+            this.data[x1] = entries[x1];
+            this.data[x2] = entries[x2];
+            this.data[x3] = entries[x3];
+            this.data[x4] = entries[x4];
+            this.data[y1] = entries[y1];
+            this.data[y2] = entries[y2];
+            this.data[y3] = entries[y3];
+            this.data[y4] = entries[y4];
+        }
+    }
+    get x1() {
+        return this.data[x1];
+    }
+    get x2() {
+        return this.data[x2];
+    }
+    get x3() {
+        return this.data[x3];
+    }
+    get xValues() {
+        return [this.data[x1], this.data[x2], this.data[x3], this.data[x4]];
+    }
+    get x4() {
+        return this.data[x4];
+    }
+    get y1() {
+        return this.data[y1];
+    }
+    get y2() {
+        return this.data[y2];
+    }
+    get y3() {
+        return this.data[y3];
+    }
+    get y4() {
+        return this.data[y4];
+    }
+    get yValues() {
+        return [this.data[y1], this.data[y2], this.data[y3], this.data[y4]];
+    }
+}
+//# sourceMappingURL=Coords.js.map

package/dist/src/core/lib/Coords.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Coords.js","sourceRoot":"","sources":["../../../../src/core/lib/Coords.ts"],"names":[],"mappings":"AAAA,MAAM,EAAE,GAAG,CAAC,CAAC;AACb,MAAM,EAAE,GAAG,CAAC,CAAC;AACb,MAAM,EAAE,GAAG,CAAC,CAAC;AACb,MAAM,EAAE,GAAG,CAAC,CAAC;AACb,MAAM,EAAE,GAAG,CAAC,CAAC;AACb,MAAM,EAAE,GAAG,CAAC,CAAC;AACb,MAAM,EAAE,GAAG,CAAC,CAAC;AACb,MAAM,EAAE,GAAG,CAAC,CAAC;AAEb,MAAM,OAAO,YAAY;IAChB,IAAI,CAAe;IAC1B,YAAY,OAEI;QAEd,IAAI,CAAC,IAAI,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,IAAG,OAAO,EAAE;YACV,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;SAC7B;IACH,CAAC;IAED,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC;IACxB,CAAC;IAED,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC;IACxB,CAAC;IAED,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC;IACxB,CAAC;IAED,IAAI,OAAO;QACT,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAE,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAE,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAE,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC,CAAA;IACzE,CAAC;IAED,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC;IACxB,CAAC;IAED,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC;IACxB,CAAC;IAED,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC;IACxB,CAAC;IAED,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC;IACxB,CAAC;IAED,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC;IACxB,CAAC;IAED,IAAI,OAAO;QACT,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAE,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAE,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAE,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC,CAAA;IACzE,CAAC;CACF"}