@solidtv/renderer 1.0.0

package/dist/src/core/renderers/webgl/WebGlCtxSubTexture.d.ts

@@ -0,0 +1,22 @@
+import type { Dimensions } from '../../../common/CommonTypes.js';
+import type { TextureMemoryManager } from '../../TextureMemoryManager.js';
+import type { WebGlContextWrapper } from '../../lib/WebGlContextWrapper.js';
+import type { SubTexture } from '../../textures/SubTexture.js';
+import { WebGlCtxTexture } from './WebGlCtxTexture.js';
+export declare class WebGlCtxSubTexture extends WebGlCtxTexture {
+    constructor(glw: WebGlContextWrapper, memManager: TextureMemoryManager, textureSource: SubTexture);
+    onLoadRequest(): Promise<Dimensions>;
+    /**
+     * Efficiently extracts width/height from polymorphic texture data
+     * Optimized for performance by using type guards and avoiding unnecessary property access
+     */
+    private extractDimensions;
+    /**
+     * Type guard for objects with width/height properties
+     */
+    private hasWidthHeight;
+    /**
+     * Type guard for objects with w/h properties
+     */
+    private hasWH;
+}

package/dist/src/core/renderers/webgl/WebGlCtxSubTexture.js

@@ -0,0 +1,49 @@
+import { assertTruthy } from '../../../utils.js';
+import { WebGlCtxTexture } from './WebGlCtxTexture.js';
+export class WebGlCtxSubTexture extends WebGlCtxTexture {
+    constructor(glw, memManager, textureSource) {
+        super(glw, memManager, textureSource);
+    }
+    async onLoadRequest() {
+        const props = this.textureSource.textureData;
+        assertTruthy(props, 'SubTexture must have texture data');
+        if (props.data instanceof Uint8Array) {
+            // its a 1x1 Color Texture
+            return { w: 1, h: 1 };
+        }
+        return this.extractDimensions(props.data);
+    }
+    /**
+     * Efficiently extracts width/height from polymorphic texture data
+     * Optimized for performance by using type guards and avoiding unnecessary property access
+     */
+    extractDimensions(data) {
+        if (data === null) {
+            return { w: 0, h: 0 };
+        }
+        // Check for standard web API objects first (most common case)
+        // These use width/height properties: ImageBitmap, ImageData, HTMLImageElement
+        if (this.hasWidthHeight(data) === true) {
+            return { w: data.width, h: data.height };
+        }
+        // Check for internal objects that use w/h properties: SubTextureProps, CompressedData
+        if (this.hasWH(data) === true) {
+            return { w: data.w, h: data.h };
+        }
+        // Fallback
+        return { w: 0, h: 0 };
+    }
+    /**
+     * Type guard for objects with width/height properties
+     */
+    hasWidthHeight(data) {
+        return typeof data.width === 'number' && typeof data.height === 'number';
+    }
+    /**
+     * Type guard for objects with w/h properties
+     */
+    hasWH(data) {
+        return typeof data.w === 'number' && typeof data.h === 'number';
+    }
+}
+//# sourceMappingURL=WebGlCtxSubTexture.js.map

package/dist/src/core/renderers/webgl/WebGlCtxSubTexture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebGlCtxSubTexture.js","sourceRoot":"","sources":["../../../../../src/core/renderers/webgl/WebGlCtxSubTexture.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAMjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,OAAO,kBAAmB,SAAQ,eAAe;IACrD,YACE,GAAwB,EACxB,UAAgC,EAChC,aAAyB;QAEzB,KAAK,CAAC,GAAG,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;IACxC,CAAC;IAEQ,KAAK,CAAC,aAAa;QAC1B,MAAM,KAAK,GAAI,IAAI,CAAC,aAA4B,CAAC,WAAW,CAAC;QAC7D,YAAY,CAAC,KAAK,EAAE,mCAAmC,CAAC,CAAC;QAEzD,IAAI,KAAK,CAAC,IAAI,YAAY,UAAU,EAAE,CAAC;YACrC,0BAA0B;YAC1B,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACxB,CAAC;QAED,OAAO,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED;;;OAGG;IACK,iBAAiB,CACvB,IAMQ;QAER,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACxB,CAAC;QAED,8DAA8D;QAC9D,8EAA8E;QAC9E,IAAI,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YACvC,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QAC3C,CAAC;QAED,sFAAsF;QACtF,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YAC9B,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;QAClC,CAAC;QAED,WAAW;QACX,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IACxB,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,IAAS;QAC9B,OAAO,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC;IAC3E,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,IAAS;QACrB,OAAO,OAAO,IAAI,CAAC,CAAC,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,CAAC,KAAK,QAAQ,CAAC;IAClE,CAAC;CACF"}

package/dist/src/core/renderers/webgl/WebGlCtxTexture.d.ts

@@ -0,0 +1,67 @@
+import type { Dimensions } from '../../../common/CommonTypes.js';
+import type { TextureMemoryManager } from '../../TextureMemoryManager.js';
+import type { WebGlContextWrapper } from '../../lib/WebGlContextWrapper.js';
+import type { Texture } from '../../textures/Texture.js';
+import { CoreContextTexture } from '../CoreContextTexture.js';
+import type { Bound } from '../../lib/utils.js';
+/**
+ * A wrapper around a WebGLTexture that handles loading the texture data
+ * from a Texture source and uploading it to the GPU as well as freeing
+ * the uploaded texture.
+ *
+ * @remarks
+ * When accessing the ctxTexture property, the texture will be loaded if
+ * it hasn't been already. ctxTexture will always return a valid WebGLTexture
+ * and trigger the loading/uploading of the texture's data if it hasn't been
+ * loaded yet.
+ */
+export declare class WebGlCtxTexture extends CoreContextTexture {
+    protected glw: WebGlContextWrapper;
+    protected _nativeCtxTexture: WebGLTexture | null;
+    private _w;
+    private _h;
+    txCoords: Bound;
+    constructor(glw: WebGlContextWrapper, memManager: TextureMemoryManager, textureSource: Texture);
+    /**
+     * GL error check with direct state marking
+     * Uses cached error result to minimize function calls
+     */
+    private checkGLError;
+    get ctxTexture(): WebGLTexture | null;
+    get w(): number;
+    get h(): number;
+    /**
+     * Load the texture data from the Texture source and upload it to the GPU
+     *
+     * @remarks
+     * This method is called automatically when accessing the ctxTexture property
+     * if the texture hasn't been loaded yet. But it can also be called manually
+     * to force the texture to be pre-loaded prior to accessing the ctxTexture
+     * property.
+     */
+    load(): Promise<void>;
+    /**
+     * Called when the texture data needs to be loaded and uploaded to a texture
+     */
+    onLoadRequest(): Promise<Dimensions>;
+    /**
+     * Free the WebGLTexture from the GPU
+     *
+     * @returns
+     */
+    free(): void;
+    /**
+     * Release the WebGLTexture from the GPU without changing state
+     */
+    release(): void;
+    /**
+     * Create native context texture asynchronously
+     *
+     * @remarks
+     * When this method resolves, the returned texture will be bound to the GL context state
+     * and fully ready for use. This ensures proper GPU resource allocation timing.
+     *
+     * @returns Promise that resolves to the native WebGL texture or null on failure
+     */
+    protected createNativeCtxTexture(): WebGLTexture | null;
+}

package/dist/src/core/renderers/webgl/WebGlCtxTexture.js

@@ -0,0 +1,259 @@
+import { uploadCompressedTexture } from '../../lib/textureCompression.js';
+import { CoreContextTexture } from '../CoreContextTexture.js';
+import { isHTMLImageElement } from './internal/RendererUtils.js';
+import { isProductionEnvironment } from '../../../utils.js';
+const TRANSPARENT_TEXTURE_DATA = new Uint8Array([0, 0, 0, 0]);
+/**
+ * A wrapper around a WebGLTexture that handles loading the texture data
+ * from a Texture source and uploading it to the GPU as well as freeing
+ * the uploaded texture.
+ *
+ * @remarks
+ * When accessing the ctxTexture property, the texture will be loaded if
+ * it hasn't been already. ctxTexture will always return a valid WebGLTexture
+ * and trigger the loading/uploading of the texture's data if it hasn't been
+ * loaded yet.
+ */
+export class WebGlCtxTexture extends CoreContextTexture {
+    glw;
+    _nativeCtxTexture = null;
+    _w = 0;
+    _h = 0;
+    txCoords = {
+        x1: 0,
+        y1: 0,
+        x2: 1,
+        y2: 1,
+    };
+    constructor(glw, memManager, textureSource) {
+        super(memManager, textureSource);
+        this.glw = glw;
+    }
+    /**
+     * GL error check with direct state marking
+     * Uses cached error result to minimize function calls
+     */
+    checkGLError() {
+        // Skip if already failed to prevent double-processing
+        if (this.state === 'failed') {
+            return true;
+        }
+        if (isProductionEnvironment === false) {
+            const error = this.glw.getError();
+            if (error !== 0) {
+                this.state = 'failed';
+                this.textureSource.setState('failed', new Error(`WebGL Error: ${error}`));
+                return true;
+            }
+        }
+        return false;
+    }
+    get ctxTexture() {
+        if (this.state === 'freed') {
+            this.load();
+            return null;
+        }
+        return this._nativeCtxTexture;
+    }
+    get w() {
+        return this._w;
+    }
+    get h() {
+        return this._h;
+    }
+    /**
+     * Load the texture data from the Texture source and upload it to the GPU
+     *
+     * @remarks
+     * This method is called automatically when accessing the ctxTexture property
+     * if the texture hasn't been loaded yet. But it can also be called manually
+     * to force the texture to be pre-loaded prior to accessing the ctxTexture
+     * property.
+     */
+    async load() {
+        // If the texture is already loading or loaded, return resolved promise
+        if (this.state === 'loading' || this.state === 'loaded') {
+            return Promise.resolve();
+        }
+        this.state = 'loading';
+        this.textureSource.setState('loading');
+        // Await the native texture creation to ensure GPU buffer is fully allocated
+        this._nativeCtxTexture = this.createNativeCtxTexture();
+        if (this._nativeCtxTexture === null) {
+            this.state = 'failed';
+            const error = new Error('Could not create WebGL Texture');
+            this.textureSource.setState('failed', error);
+            console.error('Could not create WebGL Texture');
+            throw error;
+        }
+        try {
+            const { w, h } = await this.onLoadRequest();
+            // If the texture has been freed while loading, return early.
+            // Type assertion needed because state could change during async operations
+            if (this.state === 'freed') {
+                return;
+            }
+            this.state = 'loaded';
+            this._w = w;
+            this._h = h;
+            // Update the texture source's width and height so that it can be used
+            // for rendering.
+            this.textureSource.setState('loaded', { w, h });
+            // cleanup source texture data next tick
+            // This is done using queueMicrotask to ensure it runs after the current
+            // event loop tick, allowing the texture to be fully loaded and bound
+            // to the GL context before freeing the source data.
+            // This is important to avoid issues with the texture data being
+            // freed while the texture is still being loaded or used.
+            this.textureSource.freeTextureData();
+        }
+        catch (err) {
+            // If the texture has been freed while loading, return early.
+            // Type assertion needed because state could change during async operations
+            if (this.state === 'freed') {
+                return;
+            }
+            this.state = 'failed';
+            const error = err instanceof Error ? err : new Error(String(err));
+            this.textureSource.setState('failed', error);
+            this.textureSource.freeTextureData();
+            console.error(err);
+            throw error; // Re-throw to propagate the error
+        }
+    }
+    /**
+     * Called when the texture data needs to be loaded and uploaded to a texture
+     */
+    async onLoadRequest() {
+        const { glw } = this;
+        const textureData = this.textureSource.textureData;
+        if (textureData === null || this._nativeCtxTexture === null) {
+            throw new Error('Texture data or native texture is null ' + this.textureSource.type);
+        }
+        // Set to a 1x1 transparent texture
+        glw.texImage2D(0, glw.RGBA, 1, 1, 0, glw.RGBA, glw.UNSIGNED_BYTE, null);
+        this.setTextureMemUse(TRANSPARENT_TEXTURE_DATA.byteLength);
+        let w = 0;
+        let h = 0;
+        glw.activeTexture(0);
+        const tdata = textureData.data;
+        const format = glw.RGBA;
+        const formatBytes = 4;
+        const memoryPadding = 1.1; // Add padding to account for GPU Padding
+        const isImageBitmap = typeof ImageBitmap !== 'undefined' && tdata instanceof ImageBitmap;
+        // If textureData is null, the texture is empty (0, 0) and we don't need to
+        // upload any data to the GPU.
+        if (isImageBitmap ||
+            tdata instanceof ImageData ||
+            // not using typeof HTMLI mageElement due to web worker
+            isHTMLImageElement(tdata) === true) {
+            w = tdata.width;
+            h = tdata.height;
+            glw.bindTexture(this._nativeCtxTexture);
+            glw.pixelStorei(glw.UNPACK_PREMULTIPLY_ALPHA_WEBGL, isImageBitmap ? false : !!textureData.premultiplyAlpha);
+            glw.texImage2D(0, format, format, glw.UNSIGNED_BYTE, tdata);
+            // Check for errors after compressed texture operations
+            if (this.checkGLError() === true) {
+                throw this.textureSource.error || new Error('WebGL Error');
+            }
+            this.setTextureMemUse(h * w * formatBytes * memoryPadding);
+        }
+        else if (tdata === null) {
+            w = 0;
+            h = 0;
+            // Reset to a 1x1 transparent texture
+            glw.bindTexture(this._nativeCtxTexture);
+            glw.texImage2D(0, format, 1, 1, 0, format, glw.UNSIGNED_BYTE, TRANSPARENT_TEXTURE_DATA);
+            this.setTextureMemUse(TRANSPARENT_TEXTURE_DATA.byteLength);
+        }
+        else if ('mipmaps' in tdata && tdata.mipmaps) {
+            const { mipmaps, type, blockInfo } = tdata;
+            uploadCompressedTexture[type](glw, this._nativeCtxTexture, tdata);
+            // Check for errors after compressed texture operations
+            if (this.checkGLError() === true) {
+                throw this.textureSource.error || new Error('WebGL Error');
+            }
+            w = tdata.w;
+            h = tdata.h;
+            this.txCoords.x2 = w / (Math.ceil(w / blockInfo.width) * blockInfo.width);
+            this.txCoords.y2 =
+                h / (Math.ceil(h / blockInfo.height) * blockInfo.height);
+            this.setTextureMemUse(mipmaps[0]?.byteLength ?? 0);
+        }
+        else if (tdata && tdata instanceof Uint8Array) {
+            // Color Texture
+            w = 1;
+            h = 1;
+            glw.bindTexture(this._nativeCtxTexture);
+            glw.pixelStorei(glw.UNPACK_PREMULTIPLY_ALPHA_WEBGL, !!textureData.premultiplyAlpha);
+            glw.texImage2D(0, format, w, h, 0, format, glw.UNSIGNED_BYTE, tdata);
+            // Check for errors after compressed texture operations
+            if (this.checkGLError() === true) {
+                throw this.textureSource.error || new Error('WebGL Error');
+            }
+            this.setTextureMemUse(w * h * formatBytes);
+        }
+        else {
+            throw new Error(`WebGlCoreCtxTexture.onLoadRequest: Unexpected textureData returned`);
+        }
+        return {
+            w,
+            h,
+        };
+    }
+    /**
+     * Free the WebGLTexture from the GPU
+     *
+     * @returns
+     */
+    free() {
+        if (this.state === 'freed') {
+            return;
+        }
+        this.state = 'freed';
+        this.textureSource.setState('freed');
+        this.release();
+    }
+    /**
+     * Release the WebGLTexture from the GPU without changing state
+     */
+    release() {
+        this._w = 0;
+        this._h = 0;
+        if (this._nativeCtxTexture !== null) {
+            this.glw.deleteTexture(this._nativeCtxTexture);
+            this.setTextureMemUse(0);
+            this._nativeCtxTexture = null;
+        }
+        // if the texture still has source data, free it
+        this.textureSource.freeTextureData();
+    }
+    /**
+     * Create native context texture asynchronously
+     *
+     * @remarks
+     * When this method resolves, the returned texture will be bound to the GL context state
+     * and fully ready for use. This ensures proper GPU resource allocation timing.
+     *
+     * @returns Promise that resolves to the native WebGL texture or null on failure
+     */
+    createNativeCtxTexture() {
+        const { glw } = this;
+        const nativeTexture = glw.createTexture();
+        if (!nativeTexture) {
+            return null;
+        }
+        // On initial load request, create a 1x1 transparent texture to use until
+        // the texture data is finally loaded.
+        glw.activeTexture(0);
+        glw.bindTexture(nativeTexture);
+        // linear texture filtering
+        glw.texParameteri(glw.TEXTURE_MAG_FILTER, glw.LINEAR);
+        glw.texParameteri(glw.TEXTURE_MIN_FILTER, glw.LINEAR);
+        // texture wrapping method
+        glw.texParameteri(glw.TEXTURE_WRAP_S, glw.CLAMP_TO_EDGE);
+        glw.texParameteri(glw.TEXTURE_WRAP_T, glw.CLAMP_TO_EDGE);
+        return nativeTexture;
+    }
+}
+//# sourceMappingURL=WebGlCtxTexture.js.map

package/dist/src/core/renderers/webgl/WebGlCtxTexture.js.map

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

package/dist/src/core/renderers/webgl/WebGlRenderer.d.ts

@@ -0,0 +1,221 @@
+import { CoreRenderer, type BufferInfo, type CoreRendererOptions } from '../CoreRenderer.js';
+import { SdfRenderOp } from './SdfRenderOp.js';
+import type { CoreContextTexture } from '../CoreContextTexture.js';
+import { type CoreWebGlParameters, type CoreWebGlExtensions, type WebGlColor } from './internal/RendererUtils.js';
+import { WebGlCtxTexture } from './WebGlCtxTexture.js';
+import { Texture, type TextureCoords } from '../../textures/Texture.js';
+import { BufferCollection } from './internal/BufferCollection.js';
+import { WebGlShaderProgram } from './WebGlShaderProgram.js';
+import { WebGlContextWrapper } from '../../lib/WebGlContextWrapper.js';
+import { CoreNode } from '../../CoreNode.js';
+import type { WebGlShaderType } from './WebGlShaderNode.js';
+import { WebGlShaderNode } from './WebGlShaderNode.js';
+export type WebGlRendererOptions = CoreRendererOptions;
+interface CoreWebGlSystem {
+    parameters: CoreWebGlParameters;
+    extensions: CoreWebGlExtensions;
+}
+export type WebGlRenderOp = CoreNode | SdfRenderOp;
+export declare class WebGlRenderer extends CoreRenderer {
+    glw: WebGlContextWrapper;
+    system: CoreWebGlSystem;
+    quadBuffer: ArrayBuffer;
+    fQuadBuffer: Float32Array;
+    uiQuadBuffer: Uint32Array;
+    renderOps: WebGlRenderOp[];
+    coreTextRenderOps: WebGlRenderOp[];
+    curBufferIdx: number;
+    curRenderOp: WebGlRenderOp | null;
+    rttNodes: CoreNode[];
+    activeRttNode: CoreNode | null;
+    /**
+     * Shared vertex buffer for all SDF text glyphs.
+     * Layout per vertex (6 floats = 24 bytes):
+     *   [0] x (float) - world pixel X
+     *   [1] y (float) - world pixel Y
+     *   [2] u (float) - atlas U
+     *   [3] v (float) - atlas V
+     *   [4] color (uint32) - ABGR packed, read as vec4 normalized
+     *   [5] distRange (float) - SDF distance range
+     *
+     * 4 vertices per glyph → 24 float units per glyph.
+     * Triangles are formed via the shared element index buffer.
+     */
+    sdfBuffer: ArrayBuffer;
+    fSdfBuffer: Float32Array;
+    uiSdfBuffer: Uint32Array;
+    sdfBufferIdx: number;
+    /** Running count of SDF quads written this frame (for element offset). */
+    sdfQuadCount: number;
+    sdfQuadBufferCollection: BufferCollection;
+    curSdfRenderOp: SdfRenderOp | null;
+    /**
+     * When true, the entire quad buffer is re-uploaded to the GPU via bufferData
+     * (DYNAMIC_DRAW) rather than the surgical per-node bufferSubData path.
+     * Set to true on first frame and whenever the renderList changes structurally
+     * (node added / removed / reordered).
+     */
+    needsFullUpload: boolean;
+    defaultTextureCoords: TextureCoords;
+    defaultShaderNode: WebGlShaderNode | null;
+    quadBufferCollection: BufferCollection;
+    clearColor: WebGlColor;
+    /**
+     * White pixel texture used by default when no texture is specified.
+     */
+    quadBufferUsage: number;
+    numQuadsRendered: number;
+    /**
+     * Number of float32 elements last uploaded to the GPU via bufferData.
+     * Used to detect when curBufferIdx has grown beyond the GPU buffer's
+     * capacity, requiring a full re-upload even when needsFullUpload is false.
+     */
+    lastUploadedBufferSize: number;
+    /**
+     * Whether the renderer is currently rendering to a texture.
+     */
+    renderToTextureActive: boolean;
+    constructor(options: WebGlRendererOptions);
+    reset(): void;
+    createShaderProgram(shaderType: WebGlShaderType, props: Record<string, unknown>): WebGlShaderProgram;
+    createShaderNode(shaderKey: string, shaderType: WebGlShaderType, props?: Record<string, unknown>, program?: WebGlShaderProgram): WebGlShaderNode<Record<string, unknown>>;
+    supportsShaderType(shaderType: Readonly<WebGlShaderType>): boolean;
+    createCtxTexture(textureSource: Texture): CoreContextTexture;
+    /**
+     * This function adds a quad (a rectangle composed of two triangles) to the WebGL rendering pipeline.
+     *
+     * It takes a set of options that define the quad's properties, such as its dimensions, colors, texture, shader, and transformation matrix.
+     * The function first updates the shader properties with the current dimensions if necessary, then sets the default texture if none is provided.
+     * It then checks if a new render operation is needed, based on the current shader and clipping rectangle.
+     * If a new render operation is needed, it creates one and updates the current render operation.
+     * The function then adjusts the texture coordinates based on the texture options and adds the texture to the texture manager.
+     *
+     * Finally, it calculates the vertices for the quad, taking into account any transformations, and adds them to the quad buffer.
+     * The function updates the length and number of quads in the current render operation, and updates the current buffer index.
+     */
+    addQuad(node: CoreNode): void;
+    /**
+     * Replace the existing RenderOp with a new one that uses the specified Shader
+     * and starts at the specified buffer index.
+     *
+     * @param shader
+     * @param bufferIdx
+     */
+    private newRenderOp;
+    /**
+     * Test if the current Render operation can be reused for the specified parameters.
+     * @param params
+     * @returns
+     */
+    reuseRenderOp(node: CoreNode): boolean;
+    /**
+     * add RenderOp to the render pipeline
+     */
+    addRenderOp(renderable: WebGlRenderOp): void;
+    flushTextRenderOps(): void;
+    /**
+     * Append pre-transformed SDF glyph vertices to the shared SDF buffer
+     * and manage SDF render op batching.
+     *
+     * @remarks
+     * This method pre-transforms glyph positions from design units to world
+     * pixel space on the CPU, packs per-vertex color and distanceRange, and
+     * writes them into the shared SDF buffer. Compatible consecutive calls
+     * (same atlas, same clipping, same RTT state) are merged into a single
+     * SdfRenderOp, resulting in one draw call for many text nodes.
+     */
+    addSdfQuads(glyphs: import('../../text-rendering/TextRenderer.js').GlyphLayout[], fontScale: number, transform: Float32Array, color: number, worldAlpha: number, distanceRange: number, atlasTexture: WebGlCtxTexture, clippingRect: import('../../lib/utils.js').RectWithValid, width: number, height: number, parentHasRenderTexture: boolean, framebufferDimensions: import('../../../common/CommonTypes.js').Dimensions | null, sdfShader: WebGlShaderNode): void;
+    /**
+     * Fast path: copy pre-computed cached SDF vertex data into the shared
+     * buffer and create/extend an SdfRenderOp.
+     *
+     * @remarks
+     * When a text node hasn't changed (same layout, transform, color, alpha),
+     * the per-glyph matrix multiplication is skipped entirely. The cached
+     * Float32Array is written via a single `Float32Array.set()` (memcpy),
+     * which is orders of magnitude faster than the per-glyph computation path.
+     */
+    addSdfCachedQuads(cachedVertices: Float32Array, numGlyphs: number, atlasTexture: WebGlCtxTexture, clippingRect: import('../../lib/utils.js').RectWithValid, worldAlpha: number, width: number, height: number, parentHasRenderTexture: boolean, framebufferDimensions: import('../../../common/CommonTypes.js').Dimensions | null, sdfShader: WebGlShaderNode): void;
+    /**
+     * Shared batching logic for SDF render ops.
+     * Called by both `addSdfQuads` (full compute) and `addSdfCachedQuads` (fast copy).
+     */
+    private finalizeSdfBatch;
+    /**
+     * Resizes the shared SDF ArrayBuffer if the required size (in floats) goes beyond
+     * the current buffer capacity.
+     */
+    private ensureSdfBufferCapacity;
+    /**
+     * Render the current set of RenderOps to render to the specified surface.
+     *
+     * On the first frame after a renderList structural change (`needsFullUpload`
+     * is true) the entire quad buffer is re-allocated on the GPU with
+     * `bufferData(DYNAMIC_DRAW)`. On every subsequent frame only the slots of
+     * nodes flagged `isQuadDirty` are surgically updated via `bufferSubData`,
+     * leaving the rest of the GPU's buffer unchanged.
+     *
+     * TODO: 'screen' is the only supported surface at the moment.
+     *
+     * @param surface
+     */
+    render(surface?: 'screen' | CoreContextTexture): void;
+    getQuadCount(): number;
+    getRenderOpCount(): number;
+    renderToTexture(node: CoreNode): void;
+    /**
+     * Inserts an RTT node into `this.rttNodes` while maintaining the correct rendering order based on hierarchy.
+     *
+     * Rendering order for RTT nodes is critical when nested RTT nodes exist in a parent-child relationship.
+     * Specifically:
+     *  - Child RTT nodes must be rendered before their RTT-enabled parents to ensure proper texture composition.
+     *  - If an RTT node is added and it has existing RTT children, it should be rendered after those children.
+     *
+     * This function addresses both cases by:
+     * 1. **Checking Upwards**: It traverses the node's hierarchy upwards to identify any RTT parent
+     *    already in `rttNodes`. If an RTT parent is found, the new node is placed before this parent.
+     * 2. **Checking Downwards**: It traverses the node’s children recursively to find any RTT-enabled
+     *    children that are already in `rttNodes`. If such children are found, the new node is inserted
+     *    after the last (highest index) RTT child node.
+     *
+     * The final calculated insertion index ensures the new node is positioned in `rttNodes` to respect
+     * both parent-before-child and child-before-parent rendering rules, preserving the correct order
+     * for the WebGL renderer.
+     *
+     * @param node - The RTT-enabled CoreNode to be added to `rttNodes` in the appropriate hierarchical position.
+     */
+    private insertRTTNodeInOrder;
+    private findMaxChildRTTIndex;
+    renderRTTNodes(): void;
+    /**
+     * Recursively walk the subtree of an RTT node and add quads for all
+     * renderable descendants. This restores the recursive behavior that was
+     * lost when `stage.addQuads(child)` was replaced with `child.renderQuads(this)`.
+     */
+    private addRTTQuads;
+    /**
+     * Render pass for RTT: always does a full buffer upload since RTT quads
+     * use temporary sequential buffer slots that are rebuilt each frame.
+     */
+    private renderRTT;
+    updateViewport(): void;
+    removeRTTNode(node: CoreNode): void;
+    getBufferInfo(): BufferInfo | null;
+    getDefaultShaderNode(): WebGlShaderNode;
+    getTextureCoords(node: CoreNode): TextureCoords | undefined;
+    /**
+     * Resets all per-node quad buffer slot assignments and schedules a full GPU
+     * buffer re-upload on the next render call.
+     *
+     * Called by Stage.requestRenderListUpdate() whenever the render list changes
+     * structurally (node added, removed, or reordered). After this call, the
+     * next addQuad() pass will reassign compact, contiguous slots starting from 0.
+     */
+    invalidateQuadBuffer(): void;
+    /**
+     * Sets the glClearColor to the specified color.   *
+     * @param color - The color to set as the clear color, represented as a 32-bit integer.
+     */
+    updateClearColor(color: number): void;
+}
+export {};