@lightningtv/renderer 2.16.1 → 3.2.3

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

@@ -1,45 +1,30 @@
 import { AnimationManager } from './animations/AnimationManager.js';
 import { CoreNode, type CoreNodeProps } from './CoreNode.js';
 import { CoreTextureManager } from './CoreTextureManager.js';
-import { TrFontManager } from './text-rendering/TrFontManager.js';
-import { CoreShaderManager, type ShaderMap } from './CoreShaderManager.js';
-import { TextRenderer, type TextRendererMap, type TrProps } from './text-rendering/renderers/TextRenderer.js';
+import { CoreShaderManager } from './CoreShaderManager.js';
+import { type FontHandler, type FontLoadOptions, type TextRenderer, type TextRenderers, type TrProps } from './text-rendering/TextRenderer.js';
 import { EventEmitter } from '../common/EventEmitter.js';
 import { ContextSpy } from './lib/ContextSpy.js';
 import type { FpsUpdatePayload, FrameTickPayload } from '../common/CommonTypes.js';
 import { TextureMemoryManager, type TextureMemoryManagerSettings } from './TextureMemoryManager.js';
 import { CoreRenderer } from './renderers/CoreRenderer.js';
-import type { WebGlCoreRenderer } from './renderers/webgl/WebGlCoreRenderer.js';
-import type { CanvasCoreRenderer } from './renderers/canvas/CanvasCoreRenderer.js';
-import type { BaseShaderController } from '../main-api/ShaderController.js';
 import { CoreTextNode, type CoreTextNodeProps } from './CoreTextNode.js';
-import type { SdfTextRenderer } from './text-rendering/renderers/SdfTextRenderer/SdfTextRenderer.js';
-import type { CanvasTextRenderer } from './text-rendering/renderers/CanvasTextRenderer.js';
+import type { CoreShaderNode } from './renderers/CoreShaderNode.js';
 import { type Bound } from './lib/utils.js';
 import type { Texture } from './textures/Texture.js';
-export interface StageOptions {
-    appWidth: number;
-    appHeight: number;
+import type { Platform } from './platforms/Platform.js';
+import type { WebPlatform } from './platforms/web/WebPlatform.js';
+import type { RendererMainSettings } from '../main-api/Renderer.js';
+export type StageOptions = Omit<RendererMainSettings, 'inspector' | 'platform' | 'maxRetryCount'> & {
     textureMemory: TextureMemoryManagerSettings;
-    boundsMargin: number | [number, number, number, number];
-    deviceLogicalPixelRatio: number;
-    devicePhysicalPixelRatio: number;
     canvas: HTMLCanvasElement | OffscreenCanvas;
-    clearColor: number;
     fpsUpdateInterval: number;
-    targetFPS: number;
-    enableContextSpy: boolean;
-    forceWebGL2: boolean;
-    numImageWorkers: number;
-    renderEngine: typeof WebGlCoreRenderer | typeof CanvasCoreRenderer;
     eventBus: EventEmitter;
-    quadBufferSize: number;
-    fontEngines: (typeof CanvasTextRenderer | typeof SdfTextRenderer)[];
+    platform: Platform | WebPlatform;
     inspector: boolean;
-    strictBounds: boolean;
-    textureProcessingTimeLimit: number;
-    createImageBitmapSupport: 'auto' | 'basic' | 'options' | 'full';
-}
+    maxRetryCount: number;
+    enableClear: boolean;
+};
 export type StageFpsUpdateHandler = (stage: Stage, fpsData: FpsUpdatePayload) => void;
 export type StageFrameTickHandler = (stage: Stage, frameTickData: FrameTickPayload) => void;
 export interface Point {
@@ -47,22 +32,25 @@ export interface Point {
     y: number;
 }
 export declare class Stage {
-    readonly options: StageOptions;
+    options: StageOptions;
     readonly animationManager: AnimationManager;
     readonly txManager: CoreTextureManager;
     readonly txMemManager: TextureMemoryManager;
-    readonly fontManager: TrFontManager;
-    readonly textRenderers: Partial<TextRendererMap>;
+    readonly textRenderers: Record<string, TextRenderer>;
+    readonly fontHandlers: Record<string, FontHandler>;
     readonly shManager: CoreShaderManager;
     readonly renderer: CoreRenderer;
     readonly root: CoreNode;
     readonly interactiveNodes: Set<CoreNode>;
     boundsMargin: [number, number, number, number];
-    readonly defShaderCtr: BaseShaderController;
-    readonly strictBound: Bound;
-    readonly preloadBound: Bound;
-    readonly strictBounds: boolean;
+    readonly defShaderNode: CoreShaderNode | null;
+    strictBound: Bound;
+    preloadBound: Bound;
     readonly defaultTexture: Texture | null;
+    pixelRatio: number;
+    readonly bufferMemory: number;
+    readonly platform: Platform | WebPlatform;
+    readonly calculateTextureCoord: boolean;
     /**
      * Target frame time in milliseconds (calculated from targetFPS)
      *
@@ -81,15 +69,27 @@ export declare class Stage {
      * without having to set up forwarding handlers.
      */
     readonly eventBus: EventEmitter;
+    startTime: number;
     deltaTime: number;
     lastFrameTime: number;
     currentFrameTime: number;
+    elapsedTime: number;
+    private timedNodes;
+    private clrColor;
     private fpsNumFrames;
     private fpsElapsedTime;
     private numQuadsRendered;
     private renderRequested;
+    private reprocessFrame;
+    private reprocessCallback;
     private frameEventQueue;
-    private fontResolveMap;
+    renderList: CoreNode[];
+    renderListDirty: boolean;
+    private hasOnlyOneFontEngine;
+    private hasOnlyCanvasFontEngine;
+    private hasCanvasEngine;
+    private singleFontEngine;
+    private singleFontHandler;
     contextSpy: ContextSpy | null;
     /**
      * Stage constructor
@@ -114,7 +114,7 @@ export declare class Stage {
     /**
      * Update animations
      */
-    updateAnimations(): void;
+    updateAnimations(): boolean;
     /**
      * Check if the scene has updates
      */
@@ -122,7 +122,7 @@ export declare class Stage {
     /**
      * Start a new frame draw
      */
-    drawFrame(): void;
+    drawFrame(hasActiveAnimations?: boolean): void;
     /**
      * Queue an event to be emitted after the current/next frame is rendered
      *
@@ -150,13 +150,32 @@ export declare class Stage {
     flushFrameEvents(): void;
     calculateFps(): void;
     calculateQuads(): void;
-    addQuads(node: CoreNode): void;
+    requestRenderListUpdate(): void;
+    buildRenderList(node: CoreNode): void;
     /**
      * Request a render pass without forcing an update
      */
     requestRender(): void;
+    reprocessUpdates(callback?: () => void): void;
     /**
-     * Find all nodes at a given point
+     * Given a font name, and possible renderer override, return the best compatible text renderer.
+     *
+     * @remarks
+     * Will try to return a canvas renderer if no other suitable renderer can be resolved.
+     *
+     * @param fontFamily
+     * @param textRendererOverride
+     * @returns
+     */
+    resolveTextRenderer(trProps: TrProps, textRendererOverride?: keyof TextRenderers | null): TextRenderer | null;
+    createNode(props: Partial<CoreNodeProps>): CoreNode;
+    createTextNode(props: Partial<CoreTextNodeProps>): CoreTextNode;
+    setBoundsMargin(value: number | [number, number, number, number]): void;
+    /**
+     * Update the viewport bounds
+     */
+    updateViewportBounds(): void;
+    /** Find all nodes at a given point
      * @param data
      */
     findNodesAtPoint(data: Point): CoreNode[];
@@ -167,27 +186,17 @@ export declare class Stage {
      */
     getNodeFromPosition(data: Point): CoreNode | null;
     /**
-     * Given a font name, and possible renderer override, return the best compatible text renderer.
-     *
-     * @remarks
-     * Will try to return a canvas renderer if no other suitable renderer can be resolved.
-     *
-     * @param fontFamily
-     * @param textRendererOverride
+     * add node to timeNodes arrays
+     * @param node
      * @returns
      */
-    resolveTextRenderer(trProps: TrProps, textRendererOverride?: keyof TextRendererMap | null): TextRenderer | null;
+    trackTimedNode(node: CoreNode): void;
     /**
-     * Create a shader controller instance
-     *
-     * @param type
-     * @param props
+     * remove node from timeNodes arrays
+     * @param node
      * @returns
      */
-    createShaderCtr(type: keyof ShaderMap, props: Record<string, unknown>): BaseShaderController;
-    createNode(props: Partial<CoreNodeProps>): CoreNode;
-    createTextNode(props: Partial<CoreTextNodeProps>): CoreTextNode;
-    setBoundsMargin(value: number | [number, number, number, number]): void;
+    untrackTimedNode(node: CoreNode): void;
     /**
      * Resolves the default property values for a Node
      *
@@ -206,5 +215,23 @@ export declare class Stage {
      * @remarks
      * This method is used to cleanup orphaned textures that are no longer in use.
      */
-    cleanup(aggressive: boolean): void;
+    cleanup(full?: boolean): void;
+    set clearColor(value: number);
+    get clearColor(): number;
+    /**
+     * Load a font using a specific text renderer type
+     *
+     * @remarks
+     * This method allows consumers to explicitly load fonts for a specific
+     * text renderer type (e.g., 'canvas', 'sdf'). Consumers must specify
+     * the renderer type to ensure fonts are loaded with the correct pipeline.
+     *
+     * For Canvas fonts, provide fontUrl (e.g., .ttf, .woff, .woff2)
+     * For SDF fonts, provide atlasUrl (image) and atlasDataUrl (JSON glyph data)
+     *
+     * @param rendererType - The type of text renderer ('canvas', 'sdf', etc.)
+     * @param options - Font loading options specific to the renderer type
+     * @returns Promise that resolves when the font is loaded
+     */
+    loadFont(rendererType: TextRenderers, options: FontLoadOptions): Promise<void>;
 }