@lightningjs/renderer 2.13.1 → 2.13.2

package/README.md

@@ -1,147 +1,147 @@
-# Lightning 3 Renderer
-
-A powerful 2D scene renderer designed for rendering highly performant user
-interfaces on web browsers running on embedded devices using WebGL.
-
-The Renderer is part of the [LightningJS](https://lightningjs.io) project. While it is possible to use the renderer directly, it is not recommended. Instead, Lightning 3 works best when combined with [Blits](https://lightningjs.io/v3-docs/blits/getting_started/intro.html).
-
-## Setup & Commands
-
-```
-# Install renderer + example dependencies
-pnpm install
-
-# Build Renderer
-pnpm build
-
-# Build Renderer (watch mode)
-pnpm watch
-
-# Run unit tests
-pnpm test
-
-# Run Visual Regression Tests
-pnpm test:visual
-
-# Build API Documentation (builds into ./typedocs folder)
-pnpm typedoc
-
-# Launch Example Tests in dev mode (includes Build Renderer (watch mode))
-pnpm start
-
-# Launch Example Tests in production mode
-# IMPORTANT: To run test examples on embedded devices that use older browser versions
-# you MUST run the examples in this mode.
-pnpm start:prod
-```
-
-## Browser Targets
-
-The Lightning 3 Renderer's goal is to work with the following browser versions and above:
-
-- Chrome v38 (Released October 7, 2014)
-
-Any JavaScript language features or browser APIs that cannot be automatically transpiled or polyfilled by industry standard transpilers (such as Babel) to target these versions must be carefully considered before use.
-
-For a more detailed and comprehensive list of browsers and their features please see [browsers](./BROWSERS.md).
-
-## Example Tests
-
-The Example Tests sub-project define a set of tests for various Renderer
-features. This is NOT an automated test. The command below will launch a
-web server which can be accessed by a web browser for manual testing. However,
-many of the Example Tests define Snapshots for the Visual Regression Test Runner
-(see below).
-
-The Example Tests can be launched with:
-
-```
-pnpm start
-```
-
-A hosted version can be found [here](https://lightning-js.github.io/renderer/).
-
-This supports modern browsers as well as Chrome 38 and above through a legacy build.
-
-See [examples/README.md](./examples/README.md) for more info.
-
-## Visual Regression Tests
-
-In order to prevent bugs on existing Renderer features when new features or bug
-fixes are added, the Renderer includes a Visual Regression Test Runner along
-with a set of certified snapshot files that are checked into the repository.
-
-These tests can be launched with:
-
-```
-pnpm test:visual
-```
-
-The captured Snapshots of these tests are optionally defined in the individual
-Example Tests.
-
-See [visual-regression/README.md](./visual-regression/README.md) for more info.
-
-## Manual Regression Tests
-
-See [docs/ManualRegressionTests.md].
-
-## Release Procedure
-
-See [RELEASE.md](./RELEASE.md)
-
-## Installing Fonts
-
-Fonts can be installed into the Font Manager exposed by the Renderer's Stage.
-There are two types of fonts that you can install, Web/Canvas2D fonts (WebTrFontFace)
-and SDF fonts (SdfTrFontFace). Install that fonts that your applications needs
-at start up so they are ready when your application is rendered.
-
-```ts
-import {
-  RendererMain,
-  WebTrFontFace,
-  SdfTrFontFace,
-} from '@lightningjs/renderer';
-
-import {
-  WebGlCoreRenderer,
-  SdfTextRenderer,
-} from '@lightningjs/renderer/webgl';
-import { CanvasTextRenderer } from '@lightningjs/renderer/canvas';
-
-const renderer = new RendererMain(
-  {
-    appWidth: 1920,
-    appHeight: 1080,
-    renderEngine: WebGlCoreRenderer,
-    fontEngines: [SdfTextRenderer, CanvasTextRenderer],
-    // ...Other Renderer Config
-  },
-  'app', // id of div to insert Canvas.
-);
-
-// Load fonts into renderer
-renderer.stage.fontManager.addFontFace(
-  new WebTrFontFace('Ubuntu', {}, '/fonts/Ubuntu-Regular.ttf'),
-);
-
-renderer.stage.fontManager.addFontFace(
-  new SdfTrFontFace(
-    'Ubuntu',
-    {},
-    'msdf',
-    stage,
-    '/fonts/Ubuntu-Regular.msdf.png',
-    '/fonts/Ubuntu-Regular.msdf.json',
-  ),
-);
-```
-
-Please note that the WebGL renderer supports both SDF Fonts and Web Fonts, however the
-Canvas renderer only supports Web Fonts:
-
-| Font Type Renderer | SDF Font | Web Font |
-| ------------------ | -------- | -------- |
-| WebGL              | Y        | Y        |
-| Canvas             | N        | Y        |
+# Lightning 3 Renderer
+
+A powerful 2D scene renderer designed for rendering highly performant user
+interfaces on web browsers running on embedded devices using WebGL.
+
+The Renderer is part of the [LightningJS](https://lightningjs.io) project. While it is possible to use the renderer directly, it is not recommended. Instead, Lightning 3 works best when combined with [Blits](https://lightningjs.io/v3-docs/blits/getting_started/intro.html).
+
+## Setup & Commands
+
+```
+# Install renderer + example dependencies
+pnpm install
+
+# Build Renderer
+pnpm build
+
+# Build Renderer (watch mode)
+pnpm watch
+
+# Run unit tests
+pnpm test
+
+# Run Visual Regression Tests
+pnpm test:visual
+
+# Build API Documentation (builds into ./typedocs folder)
+pnpm typedoc
+
+# Launch Example Tests in dev mode (includes Build Renderer (watch mode))
+pnpm start
+
+# Launch Example Tests in production mode
+# IMPORTANT: To run test examples on embedded devices that use older browser versions
+# you MUST run the examples in this mode.
+pnpm start:prod
+```
+
+## Browser Targets
+
+The Lightning 3 Renderer's goal is to work with the following browser versions and above:
+
+- Chrome v38 (Released October 7, 2014)
+
+Any JavaScript language features or browser APIs that cannot be automatically transpiled or polyfilled by industry standard transpilers (such as Babel) to target these versions must be carefully considered before use.
+
+For a more detailed and comprehensive list of browsers and their features please see [browsers](./BROWSERS.md).
+
+## Example Tests
+
+The Example Tests sub-project define a set of tests for various Renderer
+features. This is NOT an automated test. The command below will launch a
+web server which can be accessed by a web browser for manual testing. However,
+many of the Example Tests define Snapshots for the Visual Regression Test Runner
+(see below).
+
+The Example Tests can be launched with:
+
+```
+pnpm start
+```
+
+A hosted version can be found [here](https://lightning-js.github.io/renderer/).
+
+This supports modern browsers as well as Chrome 38 and above through a legacy build.
+
+See [examples/README.md](./examples/README.md) for more info.
+
+## Visual Regression Tests
+
+In order to prevent bugs on existing Renderer features when new features or bug
+fixes are added, the Renderer includes a Visual Regression Test Runner along
+with a set of certified snapshot files that are checked into the repository.
+
+These tests can be launched with:
+
+```
+pnpm test:visual
+```
+
+The captured Snapshots of these tests are optionally defined in the individual
+Example Tests.
+
+See [visual-regression/README.md](./visual-regression/README.md) for more info.
+
+## Manual Regression Tests
+
+See [docs/ManualRegressionTests.md].
+
+## Release Procedure
+
+See [RELEASE.md](./RELEASE.md)
+
+## Installing Fonts
+
+Fonts can be installed into the Font Manager exposed by the Renderer's Stage.
+There are two types of fonts that you can install, Web/Canvas2D fonts (WebTrFontFace)
+and SDF fonts (SdfTrFontFace). Install that fonts that your applications needs
+at start up so they are ready when your application is rendered.
+
+```ts
+import {
+  RendererMain,
+  WebTrFontFace,
+  SdfTrFontFace,
+} from '@lightningjs/renderer';
+
+import {
+  WebGlCoreRenderer,
+  SdfTextRenderer,
+} from '@lightningjs/renderer/webgl';
+import { CanvasTextRenderer } from '@lightningjs/renderer/canvas';
+
+const renderer = new RendererMain(
+  {
+    appWidth: 1920,
+    appHeight: 1080,
+    renderEngine: WebGlCoreRenderer,
+    fontEngines: [SdfTextRenderer, CanvasTextRenderer],
+    // ...Other Renderer Config
+  },
+  'app', // id of div to insert Canvas.
+);
+
+// Load fonts into renderer
+renderer.stage.fontManager.addFontFace(
+  new WebTrFontFace('Ubuntu', {}, '/fonts/Ubuntu-Regular.ttf'),
+);
+
+renderer.stage.fontManager.addFontFace(
+  new SdfTrFontFace(
+    'Ubuntu',
+    {},
+    'msdf',
+    stage,
+    '/fonts/Ubuntu-Regular.msdf.png',
+    '/fonts/Ubuntu-Regular.msdf.json',
+  ),
+);
+```
+
+Please note that the WebGL renderer supports both SDF Fonts and Web Fonts, however the
+Canvas renderer only supports Web Fonts:
+
+| Font Type Renderer | SDF Font | Web Font |
+| ------------------ | -------- | -------- |
+| WebGL              | Y        | Y        |
+| Canvas             | N        | Y        |

package/dist/exports/canvas-shaders.d.ts

@@ -0,0 +1,10 @@
+export * from '../src/core/renderers/canvas/CanvasShaderNode.js';
+export { Rounded } from '../src/core/shaders/canvas/Rounded.js';
+export { RoundedWithBorder } from '../src/core/shaders/canvas/RoundedWithBorder.js';
+export { RoundedWithBorderAndShadow } from '../src/core/shaders/canvas/RoundedWithBorderAndShadow.js';
+export { RoundedWithShadow } from '../src/core/shaders/canvas/RoundedWithShadow.js';
+export { Border } from '../src/core/shaders/canvas/Border.js';
+export { Shadow } from '../src/core/shaders/canvas/Shadow.js';
+export { HolePunch } from '../src/core/shaders/canvas/HolePunch.js';
+export { LinearGradient } from '../src/core/shaders/canvas/LinearGradient.js';
+export { RadialGradient } from '../src/core/shaders/canvas/RadialGradient.js';

package/dist/exports/canvas-shaders.js

@@ -0,0 +1,27 @@
+/*
+ * 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.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from '../src/core/renderers/canvas/CanvasShaderNode.js';
+export { Rounded } from '../src/core/shaders/canvas/Rounded.js';
+export { RoundedWithBorder } from '../src/core/shaders/canvas/RoundedWithBorder.js';
+export { RoundedWithBorderAndShadow } from '../src/core/shaders/canvas/RoundedWithBorderAndShadow.js';
+export { RoundedWithShadow } from '../src/core/shaders/canvas/RoundedWithShadow.js';
+export { Border } from '../src/core/shaders/canvas/Border.js';
+export { Shadow } from '../src/core/shaders/canvas/Shadow.js';
+export { HolePunch } from '../src/core/shaders/canvas/HolePunch.js';
+export { LinearGradient } from '../src/core/shaders/canvas/LinearGradient.js';
+export { RadialGradient } from '../src/core/shaders/canvas/RadialGradient.js';
+//# sourceMappingURL=canvas-shaders.js.map

package/dist/exports/canvas-shaders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-shaders.js","sourceRoot":"","sources":["../../exports/canvas-shaders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,cAAc,kDAAkD,CAAC;AAEjE,OAAO,EAAE,OAAO,EAAE,MAAM,uCAAuC,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AACpF,OAAO,EAAE,0BAA0B,EAAE,MAAM,0DAA0D,CAAC;AACtG,OAAO,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AACpF,OAAO,EAAE,MAAM,EAAE,MAAM,sCAAsC,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,sCAAsC,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC"}

package/dist/exports/webgl-shaders.d.ts

@@ -0,0 +1,11 @@
+export * from '../src/core/renderers/webgl/WebGlShaderNode.js';
+export { Rounded } from '../src/core/shaders/webgl/Rounded.js';
+export { RoundedWithBorder } from '../src/core/shaders/webgl/RoundedWithBorder.js';
+export { RoundedWithBorderAndShadow } from '../src/core/shaders/webgl/RoundedWithBorderAndShadow.js';
+export { RoundedWithShadow } from '../src/core/shaders/webgl/RoundedWithShadow.js';
+export { Border } from '../src/core/shaders/webgl/Border.js';
+export { Shadow } from '../src/core/shaders/webgl/Shadow.js';
+export { HolePunch } from '../src/core/shaders/webgl/HolePunch.js';
+export { LinearGradient } from '../src/core/shaders/webgl/LinearGradient.js';
+export { RadialGradient } from '../src/core/shaders/webgl/RadialGradient.js';
+export { Default } from '../src/core/shaders/webgl/Default.js';

package/dist/exports/webgl-shaders.js

@@ -0,0 +1,28 @@
+/*
+ * 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.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from '../src/core/renderers/webgl/WebGlShaderNode.js';
+export { Rounded } from '../src/core/shaders/webgl/Rounded.js';
+export { RoundedWithBorder } from '../src/core/shaders/webgl/RoundedWithBorder.js';
+export { RoundedWithBorderAndShadow } from '../src/core/shaders/webgl/RoundedWithBorderAndShadow.js';
+export { RoundedWithShadow } from '../src/core/shaders/webgl/RoundedWithShadow.js';
+export { Border } from '../src/core/shaders/webgl/Border.js';
+export { Shadow } from '../src/core/shaders/webgl/Shadow.js';
+export { HolePunch } from '../src/core/shaders/webgl/HolePunch.js';
+export { LinearGradient } from '../src/core/shaders/webgl/LinearGradient.js';
+export { RadialGradient } from '../src/core/shaders/webgl/RadialGradient.js';
+export { Default } from '../src/core/shaders/webgl/Default.js';
+//# sourceMappingURL=webgl-shaders.js.map

package/dist/exports/webgl-shaders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webgl-shaders.js","sourceRoot":"","sources":["../../exports/webgl-shaders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,cAAc,gDAAgD,CAAC;AAE/D,OAAO,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACnF,OAAO,EAAE,0BAA0B,EAAE,MAAM,yDAAyD,CAAC;AACrG,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACnF,OAAO,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/src/core/renderers/CoreShaderNode.d.ts

@@ -0,0 +1,59 @@
+import { type CoreNode } from '../CoreNode.js';
+import type { Stage } from '../Stage.js';
+export interface AdvShaderProp<T = any, Props = Record<string, unknown>> {
+    /**
+     * default value
+     */
+    default: T;
+    resolve?: (this: AdvShaderProp<T, Props>, value: T, props: Props) => T;
+    transform?: (start: T, end: T, progress: number) => T;
+}
+export type AdvancedShaderProp<T = any, Props = Record<string, unknown>> = (AdvShaderProp<T, Props> & {
+    set: (value: T, props: Props) => void;
+    get: (props: Props) => T;
+}) | (AdvShaderProp<T, Props> & {
+    set?: never;
+    get?: never;
+});
+export type ShaderProp<T, Props> = T | AdvancedShaderProp<T, Props>;
+export type ShaderProps<Props> = {
+    [K in keyof Props]: ShaderProp<Props[K], Props>;
+};
+export declare function isAdvancedShaderProp(obj: any): obj is AdvancedShaderProp;
+export declare function resolveShaderProps(props: Record<string, unknown>, propsConfig: ShaderProps<Record<string, unknown>>): void;
+/**
+ * CoreShaderType is a template for ShaderTypes the renderer.
+ * You could view a ShaderType as a configuration object that contains methods,
+ * and values that you can use to alter the way a node is drawn by the Renderer.
+ */
+export interface CoreShaderType<Props extends object = Record<string, unknown>> {
+    /**
+     * Values you use to draw the Shader
+     */
+    props?: ShaderProps<Props>;
+    /**
+     * used for making a cache key to check for reusability, currently only used for webgl ShaderTypes but might be needed for other types of renderer
+     */
+    getCacheMarkers?: (props: Props) => string;
+}
+/**
+ * CoreShaderNode is a base class that manages the shader prop values.
+ * When a prop is being updated the CoreShaderNode will notify either the associated CoreNode,
+ * or the Stage that there has been a change and a new render of the scene.
+ */
+export declare class CoreShaderNode<Props extends object = Record<string, unknown>> {
+    readonly shaderKey: string;
+    readonly stage: Stage;
+    readonly shaderType: CoreShaderType<Props>;
+    protected propsConfig: ShaderProps<Props> | undefined;
+    protected resolvedProps: Props | undefined;
+    protected definedProps: Props | undefined;
+    protected node: CoreNode | null;
+    update: (() => void) | undefined;
+    constructor(shaderKey: string, type: CoreShaderType<Props>, stage: Stage, props?: Props);
+    private defineProps;
+    attachNode(node: CoreNode): void;
+    getResolvedProps(): Props | undefined;
+    get props(): Props | undefined;
+    set props(props: Props | undefined);
+}

package/dist/src/core/renderers/CoreShaderNode.js

@@ -0,0 +1,107 @@
+import { deepClone } from '../../utils.js';
+import { UpdateType } from '../CoreNode.js';
+export function isAdvancedShaderProp(obj) {
+    return obj !== null && typeof obj === 'object' && obj.default !== undefined;
+}
+export function resolveShaderProps(props, propsConfig) {
+    for (const key in propsConfig) {
+        if (!isAdvancedShaderProp(propsConfig[key]) && props[key] === undefined) {
+            props[key] = propsConfig[key];
+            continue;
+        }
+        const pConfig = propsConfig[key];
+        const hasValue = props[key] !== undefined;
+        if (pConfig.resolve !== undefined) {
+            props[key] = pConfig.resolve(props[key], props);
+            continue;
+        }
+        if (hasValue && pConfig.set !== undefined) {
+            pConfig.set(props[key], props);
+            continue;
+        }
+        if (hasValue) {
+            continue;
+        }
+        if (props[key] === undefined && pConfig.get === undefined) {
+            props[key] = deepClone(pConfig.default);
+            continue;
+        }
+        props[key] = pConfig.get(props);
+    }
+}
+/**
+ * CoreShaderNode is a base class that manages the shader prop values.
+ * When a prop is being updated the CoreShaderNode will notify either the associated CoreNode,
+ * or the Stage that there has been a change and a new render of the scene.
+ */
+export class CoreShaderNode {
+    shaderKey;
+    stage;
+    shaderType;
+    propsConfig;
+    resolvedProps = undefined;
+    definedProps = undefined;
+    node = null;
+    update = undefined;
+    constructor(shaderKey, type, stage, props) {
+        this.shaderKey = shaderKey;
+        this.stage = stage;
+        this.shaderType = type;
+        if (props !== undefined) {
+            /**
+             * props are already resolved by shadermanager
+             */
+            this.resolvedProps = props;
+            this.defineProps(props);
+        }
+    }
+    defineProps(props) {
+        const definedProps = {};
+        for (const key in props) {
+            const propConfig = this.shaderType.props[key];
+            const isAdvancedProp = isAdvancedShaderProp(propConfig);
+            Object.defineProperty(definedProps, key, {
+                get: () => {
+                    return this.resolvedProps[key];
+                },
+                set: (value) => {
+                    // this.resolvedProps![key as keyof Props] = value;
+                    if (isAdvancedProp === true && propConfig.resolve !== undefined) {
+                        this.resolvedProps[key] = propConfig.resolve(value, this.resolvedProps);
+                    }
+                    else if (isAdvancedProp === true && propConfig.set !== undefined) {
+                        propConfig.set(value, this.resolvedProps);
+                    }
+                    else {
+                        this.resolvedProps[key] = value;
+                    }
+                    if (this.update !== undefined && this.node !== null) {
+                        this.node.setUpdateType(UpdateType.RecalcUniforms);
+                    }
+                    else {
+                        this.stage.requestRender();
+                    }
+                },
+            });
+        }
+        this.definedProps = definedProps;
+    }
+    attachNode(node) {
+        this.node = node;
+    }
+    getResolvedProps() {
+        return this.resolvedProps;
+    }
+    get props() {
+        return this.definedProps;
+    }
+    set props(props) {
+        if (props === undefined) {
+            return;
+        }
+        for (const key in props) {
+            this.props[key] = props[key];
+        }
+    }
+}
+//# sourceMappingURL=CoreShaderNode.js.map

package/dist/src/core/renderers/CoreShaderNode.js.map

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

package/dist/src/core/renderers/CoreShaderProgram.d.ts

@@ -0,0 +1,4 @@
+export interface CoreShaderProgram {
+    attach?: () => void;
+    detach?: () => void;
+}

package/dist/src/{main-api/ICoreDriver.js → core/renderers/CoreShaderProgram.js}

@@ -17,4 +17,4 @@
  * limitations under the License.
  */
 export {};
-//# sourceMappingURL=ICoreDriver.js.map
+//# sourceMappingURL=CoreShaderProgram.js.map

package/dist/src/core/renderers/CoreShaderProgram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreShaderProgram.js","sourceRoot":"","sources":["../../../../src/core/renderers/CoreShaderProgram.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/src/core/renderers/canvas/CanvasRenderer.d.ts

@@ -0,0 +1,36 @@
+import type { CoreNode } from '../../CoreNode.js';
+import { type Texture } from '../../textures/Texture.js';
+import type { CoreContextTexture } from '../CoreContextTexture.js';
+import { CoreRenderer, type CoreRendererOptions, type QuadOptions } from '../CoreRenderer.js';
+import { CanvasShaderNode, type CanvasShaderType } from './CanvasShaderNode.js';
+export declare class CanvasRenderer extends CoreRenderer {
+    private context;
+    private canvas;
+    private pixelRatio;
+    private clearColor;
+    renderToTextureActive: boolean;
+    activeRttNode: CoreNode | null;
+    private parsedColorCache;
+    constructor(options: CoreRendererOptions);
+    reset(): void;
+    render(): void;
+    addQuad(quad: QuadOptions): void;
+    renderContext(quad: QuadOptions): void;
+    createShaderNode(shaderKey: string, shaderType: Readonly<CanvasShaderType>, props?: Record<string, any>): CanvasShaderNode<Record<string, any>, Record<string, unknown>>;
+    createShaderProgram(shaderConfig: any): null;
+    supportsShaderType(shaderType: Readonly<CanvasShaderType>): boolean;
+    createCtxTexture(textureSource: Texture): CoreContextTexture;
+    renderRTTNodes(): void;
+    removeRTTNode(node: CoreNode): void;
+    renderToTexture(node: CoreNode): void;
+    getBufferInfo(): null;
+    getQuadCount(): null;
+    getParsedColor(color: number, isRGBA?: boolean): string;
+    /**
+     * Updates the clear color of the canvas renderer.
+     *
+     * @param color - The color to set as the clear color.
+     */
+    updateClearColor(color: number): void;
+    getDefaultShaderNode(): null;
+}