@363045841yyt/klinechart-core 0.9.0-alpha.0 → 0.9.0-alpha.2

package/dist/rendering/render/createWebGPUSurfaceBackend.js

@@ -0,0 +1,92 @@
+export function createWebGPUSurfaceBackend(options) {
+    const { canvas, device, format } = options;
+    const context = canvas.getContext('webgpu');
+    if (!context)
+        throw new Error('WebGPU canvas context unavailable');
+    const renderAttachmentUsage = globalThis.GPUTextureUsage?.RENDER_ATTACHMENT ?? 0x10;
+    context.configure({
+        device,
+        format,
+        alphaMode: 'premultiplied',
+        usage: renderAttachmentUsage,
+    });
+    let disposed = false;
+    let boundRegion = null;
+    return {
+        canvas,
+        device,
+        format,
+        isAvailable() {
+            return !disposed;
+        },
+        resize(widthLogical, heightLogical, dpr) {
+            if (disposed)
+                return;
+            const width = Math.max(1, Math.round(widthLogical * dpr));
+            const height = Math.max(1, Math.round(heightLogical * dpr));
+            if (canvas.width !== width)
+                canvas.width = width;
+            if (canvas.height !== height)
+                canvas.height = height;
+            // 可见 DOM 合成：CSS 尺寸跟逻辑 plot，buffer 跟物理像素
+            if (canvas.style) {
+                canvas.style.width = `${Math.max(0, widthLogical)}px`;
+                canvas.style.height = `${Math.max(0, heightLogical)}px`;
+            }
+        },
+        bindRegion(region) {
+            if (disposed || region.width <= 0 || region.height <= 0 || region.dpr <= 0)
+                return false;
+            boundRegion = { ...region };
+            return true;
+        },
+        clearRegion(_region) {
+            if (disposed)
+                return;
+            // 空数据/清屏：提交透明 clear，避免 hybrid 可见 canvas 残留上一帧
+            try {
+                const view = context.getCurrentTexture().createView();
+                const encoder = device.createCommandEncoder();
+                const pass = encoder.beginRenderPass({
+                    colorAttachments: [
+                        {
+                            view,
+                            clearValue: { r: 0, g: 0, b: 0, a: 0 },
+                            loadOp: 'clear',
+                            storeOp: 'store',
+                        },
+                    ],
+                });
+                pass.end();
+                device.queue.submit([encoder.finish()]);
+            }
+            catch {
+                // device lost / texture unavailable：忽略，下帧 beginFrame 会重建
+            }
+        },
+        compositeTo(_targetCtx, _region, _compositeOptions) {
+            // M2：WebGPU 可见 canvas 直接参与 DOM 分层，禁止 GPU→2D drawImage
+        },
+        getBoundRegion() {
+            return boundRegion ? { ...boundRegion } : null;
+        },
+        getCurrentTextureView() {
+            if (disposed)
+                return null;
+            try {
+                return context.getCurrentTexture().createView();
+            }
+            catch {
+                return null;
+            }
+        },
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            boundRegion = null;
+            context.unconfigure();
+        },
+    };
+}
+//# sourceMappingURL=createWebGPUSurfaceBackend.js.map

package/dist/rendering/render/createWebGPUSurfaceBackend.js.map

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

package/dist/rendering/render/frameMetrics.d.ts

@@ -0,0 +1,19 @@
+export type FrameMetricsSnapshot = {
+    bufferCreateCount: number;
+    bufferUploadBytes: number;
+    drawCallCount: number;
+    queueSubmitCount: number;
+    compositeCount: number;
+};
+export declare function resetFrameMetrics(): void;
+export declare function getFrameMetrics(): FrameMetricsSnapshot;
+export declare function createFrameMetrics(): {
+    beginFrame(): void;
+    recordBufferCreate(): void;
+    recordUpload(bytes: number): void;
+    recordDraw(): void;
+    recordSubmit(): void;
+    recordComposite(): void;
+    endFrame(): void;
+};
+//# sourceMappingURL=frameMetrics.d.ts.map

package/dist/rendering/render/frameMetrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameMetrics.d.ts","sourceRoot":"","sources":["../../../src/rendering/render/frameMetrics.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAAG;IACjC,iBAAiB,EAAE,MAAM,CAAA;IACzB,iBAAiB,EAAE,MAAM,CAAA;IACzB,aAAa,EAAE,MAAM,CAAA;IACrB,gBAAgB,EAAE,MAAM,CAAA;IACxB,cAAc,EAAE,MAAM,CAAA;CACvB,CAAA;AAcD,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED,wBAAgB,eAAe,IAAI,oBAAoB,CAEtD;AAED,wBAAgB,kBAAkB;kBAGhB,IAAI;0BAGI,IAAI;wBAGN,MAAM,GAAG,IAAI;kBAGnB,IAAI;oBAGF,IAAI;uBAGD,IAAI;gBAGX,IAAI;EAInB"}

package/dist/rendering/render/frameMetrics.js

@@ -0,0 +1,43 @@
+function empty() {
+    return {
+        bufferCreateCount: 0,
+        bufferUploadBytes: 0,
+        drawCallCount: 0,
+        queueSubmitCount: 0,
+        compositeCount: 0,
+    };
+}
+let snapshot = empty();
+export function resetFrameMetrics() {
+    snapshot = empty();
+}
+export function getFrameMetrics() {
+    return { ...snapshot };
+}
+export function createFrameMetrics() {
+    let current = empty();
+    return {
+        beginFrame() {
+            current = empty();
+        },
+        recordBufferCreate() {
+            current.bufferCreateCount += 1;
+        },
+        recordUpload(bytes) {
+            current.bufferUploadBytes += bytes;
+        },
+        recordDraw() {
+            current.drawCallCount += 1;
+        },
+        recordSubmit() {
+            current.queueSubmitCount += 1;
+        },
+        recordComposite() {
+            current.compositeCount += 1;
+        },
+        endFrame() {
+            snapshot = { ...current };
+        },
+    };
+}
+//# sourceMappingURL=frameMetrics.js.map

package/dist/rendering/render/frameMetrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameMetrics.js","sourceRoot":"","sources":["../../../src/rendering/render/frameMetrics.ts"],"names":[],"mappings":"AAQA,SAAS,KAAK;IACZ,OAAO;QACL,iBAAiB,EAAE,CAAC;QACpB,iBAAiB,EAAE,CAAC;QACpB,aAAa,EAAE,CAAC;QAChB,gBAAgB,EAAE,CAAC;QACnB,cAAc,EAAE,CAAC;KAClB,CAAA;AACH,CAAC;AAED,IAAI,QAAQ,GAAyB,KAAK,EAAE,CAAA;AAE5C,MAAM,UAAU,iBAAiB;IAC/B,QAAQ,GAAG,KAAK,EAAE,CAAA;AACpB,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,EAAE,GAAG,QAAQ,EAAE,CAAA;AACxB,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,IAAI,OAAO,GAAG,KAAK,EAAE,CAAA;IACrB,OAAO;QACL,UAAU;YACR,OAAO,GAAG,KAAK,EAAE,CAAA;QACnB,CAAC;QACD,kBAAkB;YAChB,OAAO,CAAC,iBAAiB,IAAI,CAAC,CAAA;QAChC,CAAC;QACD,YAAY,CAAC,KAAa;YACxB,OAAO,CAAC,iBAAiB,IAAI,KAAK,CAAA;QACpC,CAAC;QACD,UAAU;YACR,OAAO,CAAC,aAAa,IAAI,CAAC,CAAA;QAC5B,CAAC;QACD,YAAY;YACV,OAAO,CAAC,gBAAgB,IAAI,CAAC,CAAA;QAC/B,CAAC;QACD,eAAe;YACb,OAAO,CAAC,cAAc,IAAI,CAAC,CAAA;QAC7B,CAAC;QACD,QAAQ;YACN,QAAQ,GAAG,EAAE,GAAG,OAAO,EAAE,CAAA;QAC3B,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/rendering/render/index.d.ts

@@ -7,5 +7,15 @@
 export type { SurfaceBackend, SurfaceRegion, CompositeOptions } from './SurfaceBackend';
 export { createWebGLSurfaceBackend } from './createWebGLSurfaceBackend';
 export { createWebGLRenderer } from './createWebGLRenderer';
+export { createWebGPUSurfaceBackend } from './createWebGPUSurfaceBackend';
+export { createWebGPURenderer } from './createWebGPURenderer';
+export { createCanvas2DRenderer } from './createCanvas2DRenderer';
+export { createRendererHost, createRendererHostFromRenderer } from './rendererHost';
+export { createDefaultRendererHost, createDefaultRendererHostSync, } from './createDefaultRendererHost';
+export type { RendererBackend, RendererBackendStatus, RendererBackendRuntime, RendererFactory, RendererHostDependencies, RendererHostListeners, RendererHost, } from './rendererHost';
+export type { WebGPUSurfaceBackend, WebGPUSurfaceBackendOptions, } from './createWebGPUSurfaceBackend';
+export type { CreateWebGPURendererOptions } from './createWebGPURenderer';
+export { createFrameMetrics, getFrameMetrics, resetFrameMetrics, } from './frameMetrics';
+export type { FrameMetricsSnapshot } from './frameMetrics';
 export type { Renderer, RendererCapabilities, BufferHandle, PipelineHandle, ComputePipelineHandle, BufferUsage, DrawInstancesParams, DrawLinesParams, DispatchComputeParams, } from './Renderer';
 //# sourceMappingURL=index.d.ts.map

package/dist/rendering/render/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/rendering/render/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAEvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAE3D,YAAY,EACV,QAAQ,EACR,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,qBAAqB,GACtB,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/rendering/render/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAEvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAA;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACjE,OAAO,EAAE,kBAAkB,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAA;AACnF,OAAO,EACL,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,6BAA6B,CAAA;AAEpC,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,EACf,wBAAwB,EACxB,qBAAqB,EACrB,YAAY,GACb,MAAM,gBAAgB,CAAA;AAEvB,YAAY,EACV,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,8BAA8B,CAAA;AACrC,YAAY,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAA;AACzE,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,iBAAiB,GAClB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAE1D,YAAY,EACV,QAAQ,EACR,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,qBAAqB,GACtB,MAAM,YAAY,CAAA"}

package/dist/rendering/render/index.js

@@ -6,4 +6,10 @@
  */
 export { createWebGLSurfaceBackend } from './createWebGLSurfaceBackend';
 export { createWebGLRenderer } from './createWebGLRenderer';
+export { createWebGPUSurfaceBackend } from './createWebGPUSurfaceBackend';
+export { createWebGPURenderer } from './createWebGPURenderer';
+export { createCanvas2DRenderer } from './createCanvas2DRenderer';
+export { createRendererHost, createRendererHostFromRenderer } from './rendererHost';
+export { createDefaultRendererHost, createDefaultRendererHostSync, } from './createDefaultRendererHost';
+export { createFrameMetrics, getFrameMetrics, resetFrameMetrics, } from './frameMetrics';
 //# sourceMappingURL=index.js.map

package/dist/rendering/render/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/rendering/render/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/rendering/render/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAA;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACjE,OAAO,EAAE,kBAAkB,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAA;AACnF,OAAO,EACL,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,6BAA6B,CAAA;AAiBpC,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,iBAAiB,GAClB,MAAM,gBAAgB,CAAA"}

package/dist/rendering/render/rendererHost.d.ts

@@ -0,0 +1,34 @@
+import type { Renderer } from './Renderer';
+export type RendererBackend = 'webgpu' | 'webgl' | 'canvas';
+export type RendererBackendStatus = 'initializing' | 'ready' | 'switching' | 'degraded' | 'failed';
+export type RendererBackendRuntime = {
+    effective: RendererBackend;
+    status: RendererBackendStatus;
+    error: string | null;
+};
+export type RendererFactory = () => Renderer | Promise<Renderer>;
+export type RendererHostDependencies = {
+    createWebGPU: RendererFactory;
+    createWebGL: RendererFactory;
+    createCanvas: RendererFactory;
+    onRuntimeChange?: (runtime: Readonly<RendererBackendRuntime>) => void;
+    requestRedraw?: () => void;
+};
+export type RendererHostListeners = Pick<RendererHostDependencies, 'onRuntimeChange' | 'requestRedraw'>;
+export interface RendererHost {
+    readonly renderer: Renderer;
+    readonly runtime: Readonly<RendererBackendRuntime>;
+    resize(widthLogical: number, heightLogical: number, dpr: number): void;
+    switchTo(preference: RendererBackend): Promise<void>;
+    handleDeviceLost(error: string): Promise<void>;
+    setListeners(listeners: RendererHostListeners): void;
+    dispose(): void;
+}
+export type PreparedRenderer = {
+    renderer: Renderer;
+    effective: RendererBackend;
+    error: string | null;
+};
+export declare function createRendererHost(preference: RendererBackend, deps: RendererHostDependencies): Promise<RendererHost>;
+export declare function createRendererHostFromRenderer(preference: RendererBackend, initial: PreparedRenderer, deps: RendererHostDependencies): RendererHost;
+//# sourceMappingURL=rendererHost.d.ts.map

package/dist/rendering/render/rendererHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rendererHost.d.ts","sourceRoot":"","sources":["../../../src/rendering/render/rendererHost.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE1C,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAA;AAE3D,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAA;AAElG,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,eAAe,CAAA;IAC1B,MAAM,EAAE,qBAAqB,CAAA;IAC7B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;AAEhE,MAAM,MAAM,wBAAwB,GAAG;IACrC,YAAY,EAAE,eAAe,CAAA;IAC7B,WAAW,EAAE,eAAe,CAAA;IAC5B,YAAY,EAAE,eAAe,CAAA;IAC7B,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,sBAAsB,CAAC,KAAK,IAAI,CAAA;IACrE,aAAa,CAAC,EAAE,MAAM,IAAI,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG,IAAI,CACtC,wBAAwB,EACxB,iBAAiB,GAAG,eAAe,CACpC,CAAA;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,sBAAsB,CAAC,CAAA;IAClD,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACtE,QAAQ,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpD,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,YAAY,CAAC,SAAS,EAAE,qBAAqB,GAAG,IAAI,CAAA;IACpD,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,QAAQ,CAAA;IAClB,SAAS,EAAE,eAAe,CAAA;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB,CAAA;AAwCD,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,eAAe,EAC3B,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,YAAY,CAAC,CAGvB;AAED,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,eAAe,EAC3B,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,wBAAwB,GAC7B,YAAY,CAoHd"}

package/dist/rendering/render/rendererHost.js

@@ -0,0 +1,144 @@
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+async function prepareRenderer(preference, deps) {
+    const attempts = preference === 'webgpu'
+        ? [
+            ['webgpu', deps.createWebGPU],
+            ['webgl', deps.createWebGL],
+            ['canvas', deps.createCanvas],
+        ]
+        : preference === 'webgl'
+            ? [
+                ['webgl', deps.createWebGL],
+                ['canvas', deps.createCanvas],
+            ]
+            : [['canvas', deps.createCanvas]];
+    let firstError = null;
+    for (const [effective, factory] of attempts) {
+        try {
+            return {
+                renderer: await factory(),
+                effective,
+                error: firstError,
+            };
+        }
+        catch (error) {
+            firstError ??= errorMessage(error);
+        }
+    }
+    throw new Error(firstError ?? `Unable to create ${preference} renderer`);
+}
+export async function createRendererHost(preference, deps) {
+    const initial = await prepareRenderer(preference, deps);
+    return createRendererHostFromRenderer(preference, initial, deps);
+}
+export function createRendererHostFromRenderer(preference, initial, deps) {
+    let activeRenderer = initial.renderer;
+    let runtime = {
+        effective: initial.effective,
+        status: initial.effective === preference ? 'ready' : 'degraded',
+        error: initial.error,
+    };
+    let generation = 0;
+    let disposed = false;
+    let surfaceSize = null;
+    let listeners = {
+        onRuntimeChange: deps.onRuntimeChange,
+        requestRedraw: deps.requestRedraw,
+    };
+    function publish(next) {
+        runtime = next;
+        listeners.onRuntimeChange?.(runtime);
+    }
+    const host = {
+        get renderer() {
+            return activeRenderer;
+        },
+        get runtime() {
+            return runtime;
+        },
+        resize(widthLogical, heightLogical, dpr) {
+            if (disposed)
+                return;
+            surfaceSize = { widthLogical, heightLogical, dpr };
+            activeRenderer.surface.resize(widthLogical, heightLogical, dpr);
+        },
+        async switchTo(nextPreference) {
+            if (disposed)
+                return;
+            const requestGeneration = ++generation;
+            publish({ ...runtime, status: 'switching', error: null });
+            let prepared;
+            try {
+                prepared = await prepareRenderer(nextPreference, deps);
+            }
+            catch (error) {
+                if (disposed || requestGeneration !== generation)
+                    return;
+                publish({ ...runtime, status: 'degraded', error: errorMessage(error) });
+                return;
+            }
+            if (disposed || requestGeneration !== generation) {
+                prepared.renderer.dispose();
+                return;
+            }
+            if (surfaceSize) {
+                prepared.renderer.surface.resize(surfaceSize.widthLogical, surfaceSize.heightLogical, surfaceSize.dpr);
+            }
+            const previous = activeRenderer;
+            activeRenderer = prepared.renderer;
+            publish({
+                effective: prepared.effective,
+                status: prepared.effective === nextPreference ? 'ready' : 'degraded',
+                error: prepared.error,
+            });
+            listeners.requestRedraw?.();
+            if (previous !== activeRenderer)
+                previous.dispose();
+        },
+        async handleDeviceLost(error) {
+            if (disposed || runtime.effective !== 'webgpu')
+                return;
+            const requestGeneration = ++generation;
+            publish({ ...runtime, status: 'degraded', error });
+            let prepared;
+            try {
+                prepared = await prepareRenderer('webgl', deps);
+            }
+            catch (fallbackError) {
+                if (disposed || requestGeneration !== generation)
+                    return;
+                publish({ ...runtime, status: 'failed', error: errorMessage(fallbackError) });
+                return;
+            }
+            if (disposed || requestGeneration !== generation) {
+                prepared.renderer.dispose();
+                return;
+            }
+            if (surfaceSize) {
+                prepared.renderer.surface.resize(surfaceSize.widthLogical, surfaceSize.heightLogical, surfaceSize.dpr);
+            }
+            const previous = activeRenderer;
+            activeRenderer = prepared.renderer;
+            publish({ effective: prepared.effective, status: 'degraded', error });
+            listeners.requestRedraw?.();
+            if (previous !== activeRenderer)
+                previous.dispose();
+        },
+        setListeners(nextListeners) {
+            listeners = { ...nextListeners };
+            listeners.onRuntimeChange?.(runtime);
+        },
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            generation += 1;
+            activeRenderer.dispose();
+        },
+    };
+    listeners.onRuntimeChange?.(runtime);
+    return host;
+}
+//# sourceMappingURL=rendererHost.js.map

package/dist/rendering/render/rendererHost.js.map

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

package/dist/rendering/render/webgpuResourceTable.d.ts

@@ -0,0 +1,25 @@
+import type { createFrameMetrics } from './frameMetrics';
+type Metrics = ReturnType<typeof createFrameMetrics>;
+export type ResourceUsage = 'vertex' | 'instance' | 'uniform';
+export type EnsureUploadedParams = {
+    key: string;
+    revision: number;
+    data: Float32Array;
+    usage: ResourceUsage;
+};
+export type GpuResourceHandle = {
+    buffer: GPUBuffer;
+    capacity: number;
+    lastRevision: number;
+};
+export type WebGPUResourceTable = {
+    ensureUploaded(params: EnsureUploadedParams): GpuResourceHandle;
+    destroyKey(key: string): void;
+    destroyAll(): void;
+};
+export declare function createWebGPUResourceTable(options: {
+    device: GPUDevice;
+    metrics?: Metrics;
+}): WebGPUResourceTable;
+export {};
+//# sourceMappingURL=webgpuResourceTable.d.ts.map

package/dist/rendering/render/webgpuResourceTable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webgpuResourceTable.d.ts","sourceRoot":"","sources":["../../../src/rendering/render/webgpuResourceTable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAExD,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAEpD,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAA;AAE7D,MAAM,MAAM,oBAAoB,GAAG;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,YAAY,CAAA;IAClB,KAAK,EAAE,aAAa,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,SAAS,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,iBAAiB,CAAA;IAC/D,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,UAAU,IAAI,IAAI,CAAA;CACnB,CAAA;AAiBD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IACjD,MAAM,EAAE,SAAS,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,GAAG,mBAAmB,CA2CtB"}

package/dist/rendering/render/webgpuResourceTable.js

@@ -0,0 +1,54 @@
+const GPU_BUFFER_COPY_DST = globalThis.GPUBufferUsage?.COPY_DST ?? 0x0008;
+const GPU_BUFFER_VERTEX = globalThis.GPUBufferUsage?.VERTEX ?? 0x0020;
+const GPU_BUFFER_UNIFORM = globalThis.GPUBufferUsage?.UNIFORM ?? 0x0040;
+function gpuUsage(usage) {
+    if (usage === 'uniform')
+        return GPU_BUFFER_UNIFORM | GPU_BUFFER_COPY_DST;
+    return GPU_BUFFER_VERTEX | GPU_BUFFER_COPY_DST;
+}
+function growCapacity(needed, existing) {
+    let capacity = Math.max(4, existing || 4);
+    while (capacity < needed)
+        capacity = Math.ceil(capacity * 1.5);
+    return Math.ceil(capacity / 4) * 4;
+}
+export function createWebGPUResourceTable(options) {
+    const { device, metrics } = options;
+    const resources = new Map();
+    return {
+        ensureUploaded({ key, revision, data, usage }) {
+            const byteLength = data.byteLength;
+            let resource = resources.get(key);
+            if (!resource || resource.capacity < byteLength) {
+                resource?.buffer.destroy();
+                const capacity = growCapacity(byteLength, resource?.capacity ?? 0);
+                const buffer = device.createBuffer({
+                    size: capacity,
+                    usage: gpuUsage(usage),
+                });
+                metrics?.recordBufferCreate();
+                resource = { buffer, capacity, lastRevision: -1 };
+                resources.set(key, resource);
+            }
+            if (resource.lastRevision !== revision) {
+                device.queue.writeBuffer(resource.buffer, 0, data.buffer, data.byteOffset, data.byteLength);
+                metrics?.recordUpload(byteLength);
+                resource.lastRevision = revision;
+            }
+            return resource;
+        },
+        destroyKey(key) {
+            const resource = resources.get(key);
+            if (!resource)
+                return;
+            resource.buffer.destroy();
+            resources.delete(key);
+        },
+        destroyAll() {
+            for (const resource of resources.values())
+                resource.buffer.destroy();
+            resources.clear();
+        },
+    };
+}
+//# sourceMappingURL=webgpuResourceTable.js.map

package/dist/rendering/render/webgpuResourceTable.js.map

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

package/dist/rendering/scene/createLayerFromPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createLayerFromPlugin.d.ts","sourceRoot":"","sources":["../../../src/rendering/scene/createLayerFromPlugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAElF,OAAO,KAAK,EAAE,KAAK,EAAqC,MAAM,SAAS,CAAA;AAEvE,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,MAAM,aAAa,GAAG,IAAI,EACtC,YAAY,EAAE,MAAM,GACnB,KAAK,CA4BP"}
+{"version":3,"file":"createLayerFromPlugin.d.ts","sourceRoot":"","sources":["../../../src/rendering/scene/createLayerFromPlugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAElF,OAAO,KAAK,EAAE,KAAK,EAAqC,MAAM,SAAS,CAAA;AAEvE,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,MAAM,aAAa,GAAG,IAAI,EACtC,YAAY,EAAE,MAAM,GACnB,KAAK,CAmCP"}

package/dist/rendering/scene/createLayerFromPlugin.js

@@ -22,10 +22,18 @@ export function createLayerFromPlugin(plugin, getContext, targetPaneId) {
             const context = getContext();
             if (!context)
                 return;
-            plugin.draw(context);
+            // 注入本帧 Scene Renderer，供已迁路径（candle 等）走统一画笔
+            context.sceneRenderer = ctx.renderer;
+            try {
+                plugin.draw(context);
+            }
+            catch (e) {
+                // 隔离单层异常，避免中断同 pane 后续 Layer（对齐旧 Manager.render）
+                console.error(`[RendererPlugin] ${plugin.name} draw error:`, e);
+            }
         },
         dispose() {
-            plugin.onUninstall?.();
+            // onUninstall 由 removeRenderer / Manager.unregister 单点负责，避免双调
         },
     };
 }

package/dist/rendering/scene/createLayerFromPlugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"createLayerFromPlugin.js","sourceRoot":"","sources":["../../../src/rendering/scene/createLayerFromPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAKjE,MAAM,UAAU,qBAAqB,CACnC,MAAsB,EACtB,UAAsC,EACtC,YAAoB;IAEpB,MAAM,QAAQ,GACZ,YAAY,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAA;IACjF,IAAI,OAAO,GAAG,MAAM,CAAC,OAAO,KAAK,KAAK,CAAA;IAEtC,OAAO;QACL,EAAE,EAAE,UAAU,MAAM,CAAC,IAAI,EAAE;QAC3B,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC;QACnD,QAAQ;QACR,CAAC,EAAE,MAAM,CAAC,QAAQ;QAClB,IAAI,OAAO;YACT,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,IAAI,OAAO,CAAC,CAAU;YACpB,OAAO,GAAG,CAAC,CAAA;QACb,CAAC;QACD,KAAK,CAAC,GAAiB;YACrB,IAAI,CAAC,OAAO;gBAAE,OAAM;YACpB,mEAAmE;YACnE,IAAI,QAAQ,KAAK,KAAK,IAAI,GAAG,CAAC,MAAM,KAAK,YAAY;gBAAE,OAAM;YAC7D,MAAM,OAAO,GAAG,UAAU,EAAE,CAAA;YAC5B,IAAI,CAAC,OAAO;gBAAE,OAAM;YACpB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACtB,CAAC;QACD,OAAO;YACL,MAAM,CAAC,WAAW,EAAE,EAAE,CAAA;QACxB,CAAC;KACF,CAAA;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,QAAgB,EAAE,MAAsB;IACpE,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAChD,IAAI,QAAQ,IAAI,iBAAiB,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM;QAC7F,OAAO,YAAY,CAAA;IACrB,IAAI,QAAQ,IAAI,iBAAiB,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,WAAW,CAAA;IAC3F,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,gBAAgB;QAAE,OAAO,SAAS,CAAA;IAClF,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAA;IACvD,OAAO,WAAW,CAAA;AACpB,CAAC"}
+{"version":3,"file":"createLayerFromPlugin.js","sourceRoot":"","sources":["../../../src/rendering/scene/createLayerFromPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAKjE,MAAM,UAAU,qBAAqB,CACnC,MAAsB,EACtB,UAAsC,EACtC,YAAoB;IAEpB,MAAM,QAAQ,GACZ,YAAY,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAA;IACjF,IAAI,OAAO,GAAG,MAAM,CAAC,OAAO,KAAK,KAAK,CAAA;IAEtC,OAAO;QACL,EAAE,EAAE,UAAU,MAAM,CAAC,IAAI,EAAE;QAC3B,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC;QACnD,QAAQ;QACR,CAAC,EAAE,MAAM,CAAC,QAAQ;QAClB,IAAI,OAAO;YACT,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,IAAI,OAAO,CAAC,CAAU;YACpB,OAAO,GAAG,CAAC,CAAA;QACb,CAAC;QACD,KAAK,CAAC,GAAiB;YACrB,IAAI,CAAC,OAAO;gBAAE,OAAM;YACpB,mEAAmE;YACnE,IAAI,QAAQ,KAAK,KAAK,IAAI,GAAG,CAAC,MAAM,KAAK,YAAY;gBAAE,OAAM;YAC7D,MAAM,OAAO,GAAG,UAAU,EAAE,CAAA;YAC5B,IAAI,CAAC,OAAO;gBAAE,OAAM;YACpB,2CAA2C;YAC3C,OAAO,CAAC,aAAa,GAAG,GAAG,CAAC,QAAQ,CAAA;YACpC,IAAI,CAAC;gBACH,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YACtB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,iDAAiD;gBACjD,OAAO,CAAC,KAAK,CAAC,oBAAoB,MAAM,CAAC,IAAI,cAAc,EAAE,CAAC,CAAC,CAAA;YACjE,CAAC;QACH,CAAC;QACD,OAAO;YACL,8DAA8D;QAChE,CAAC;KACF,CAAA;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,QAAgB,EAAE,MAAsB;IACpE,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAChD,IAAI,QAAQ,IAAI,iBAAiB,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM;QAC7F,OAAO,YAAY,CAAA;IACrB,IAAI,QAAQ,IAAI,iBAAiB,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,WAAW,CAAA;IAC3F,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,gBAAgB;QAAE,OAAO,SAAS,CAAA;IAClF,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAA;IACvD,OAAO,WAAW,CAAA;AACpB,CAAC"}

package/dist/rendering/scene/layerRegistry.d.ts

@@ -14,11 +14,9 @@
  *    avoids forcing every consumer through a single "register + auto-add"
  *    pipeline that would be hard to compose with config-driven scenes.
  *
- * This PR does NOT pre-register any factories — that's a follow-up PR
- * once the legacy WebGL renderers have adapters that satisfy the `Layer`
- * interface. This file ships the registry mechanism plus the canonical
- * `typeId` constants so the rest of the codebase can reference layer types
- * by symbol rather than magic string.
+ * Factories are registered by chart wiring / plugins; this file ships the
+ * registry mechanism plus the canonical `typeId` constants so the rest of
+ * the codebase can reference layer types by symbol rather than magic string.
  */
 import type { Layer, LayerRole } from './types';
 /**

package/dist/rendering/scene/layerRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layerRegistry.d.ts","sourceRoot":"","sources":["../../../src/rendering/scene/layerRegistry.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAE/C;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY,CAAC,OAAO,GAAG,OAAO;IAC7C,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,SAAS,CAAA;IACf,4EAA4E;IAC5E,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,KAAK,CAAA;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAA;IACrC;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAA;IACnC,qEAAqE;IACrE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAAA;IACxC,4EAA4E;IAC5E,IAAI,IAAI,aAAa,CAAC,YAAY,CAAC,CAAA;CACpC;AAED,wBAAgB,mBAAmB,IAAI,aAAa,CAwBnD;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;CAatB,CAAA;AAEV,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAA"}
+{"version":3,"file":"layerRegistry.d.ts","sourceRoot":"","sources":["../../../src/rendering/scene/layerRegistry.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAE/C;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY,CAAC,OAAO,GAAG,OAAO;IAC7C,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,SAAS,CAAA;IACf,4EAA4E;IAC5E,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,KAAK,CAAA;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAA;IACrC;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAA;IACnC,qEAAqE;IACrE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAAA;IACxC,4EAA4E;IAC5E,IAAI,IAAI,aAAa,CAAC,YAAY,CAAC,CAAA;CACpC;AAED,wBAAgB,mBAAmB,IAAI,aAAa,CAwBnD;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;CAatB,CAAA;AAEV,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAA"}

package/dist/rendering/scene/layerRegistry.js

@@ -27,7 +27,7 @@ export function createLayerRegistry() {
  * string literal types without an enum import — useful for config blobs.
  */
 export const BUILTIN_LAYER_TYPES = {
-    // Existing in v0 (handled by legacy renderers)
+    // Built-in chart layers
     CANDLE: 'builtin:candle',
     VOLUME: 'builtin:volume',
     INDICATOR_MA: 'builtin:indicator:ma',

package/dist/rendering/scene/layerRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"layerRegistry.js","sourceRoot":"","sources":["../../../src/rendering/scene/layerRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AA8D9C,MAAM,UAAU,mBAAmB;IACjC,sEAAsE;IACtE,oEAAoE;IACpE,8DAA8D;IAC9D,MAAM,SAAS,GAAG,IAAI,GAAG,EAAwB,CAAA;IAEjD,MAAM,QAAQ,GAAG,CAAC,OAAqB,EAAQ,EAAE;QAC/C,IAAI,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,eAAe,CACvB,gBAAgB,EAChB,0BAA0B,OAAO,CAAC,MAAM,yBAAyB,CAClE,CAAA;QACH,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,CAAC,CAAA;IAED,MAAM,UAAU,GAAG,CAAC,MAAc,EAAW,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAExE,MAAM,GAAG,GAAG,CAAC,MAAc,EAAuB,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAA;IAElF,MAAM,IAAI,GAAG,GAAgC,EAAE,CAC7C,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAgC,CAAA;IAExD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,CAAA;AAC5C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,+CAA+C;IAC/C,MAAM,EAAE,gBAAgB;IACxB,MAAM,EAAE,gBAAgB;IACxB,YAAY,EAAE,sBAAsB;IACpC,cAAc,EAAE,wBAAwB;IACxC,OAAO,EAAE,iBAAiB;IAC1B,SAAS,EAAE,mBAAmB;IAC9B,IAAI,EAAE,cAAc;IACpB,+EAA+E;IAC/E,cAAc,EAAE,0BAA0B;IAC1C,kBAAkB,EAAE,8BAA8B;IAClD,SAAS,EAAE,qBAAqB;CACxB,CAAA"}
+{"version":3,"file":"layerRegistry.js","sourceRoot":"","sources":["../../../src/rendering/scene/layerRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AA4D9C,MAAM,UAAU,mBAAmB;IACjC,sEAAsE;IACtE,oEAAoE;IACpE,8DAA8D;IAC9D,MAAM,SAAS,GAAG,IAAI,GAAG,EAAwB,CAAA;IAEjD,MAAM,QAAQ,GAAG,CAAC,OAAqB,EAAQ,EAAE;QAC/C,IAAI,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,eAAe,CACvB,gBAAgB,EAChB,0BAA0B,OAAO,CAAC,MAAM,yBAAyB,CAClE,CAAA;QACH,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,CAAC,CAAA;IAED,MAAM,UAAU,GAAG,CAAC,MAAc,EAAW,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAExE,MAAM,GAAG,GAAG,CAAC,MAAc,EAAuB,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAA;IAElF,MAAM,IAAI,GAAG,GAAgC,EAAE,CAC7C,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAgC,CAAA;IAExD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,CAAA;AAC5C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,wBAAwB;IACxB,MAAM,EAAE,gBAAgB;IACxB,MAAM,EAAE,gBAAgB;IACxB,YAAY,EAAE,sBAAsB;IACpC,cAAc,EAAE,wBAAwB;IACxC,OAAO,EAAE,iBAAiB;IAC1B,SAAS,EAAE,mBAAmB;IAC9B,IAAI,EAAE,cAAc;IACpB,+EAA+E;IAC/E,cAAc,EAAE,0BAA0B;IAC1C,kBAAkB,EAAE,8BAA8B;IAClD,SAAS,EAAE,qBAAqB;CACxB,CAAA"}

package/dist/rendering/scene/retainedScene.d.ts

@@ -0,0 +1,60 @@
+export type SceneNodeKey = string;
+export type RectsNode = {
+    kind: 'rects';
+    key: SceneNodeKey;
+    revision: number;
+    instances: Float32Array;
+    count: number;
+    color: string;
+    scrollLeft: number;
+    z: number;
+    paneId: string;
+};
+export type LinesNode = {
+    kind: 'lines';
+    key: SceneNodeKey;
+    revision: number;
+    strips: ReadonlyArray<{
+        points: ReadonlyArray<{
+            x: number;
+            y: number;
+        }>;
+        color: string;
+        width?: number;
+    }>;
+    scrollLeft: number;
+    z: number;
+    paneId: string;
+};
+export type BandNode = {
+    kind: 'band';
+    key: SceneNodeKey;
+    revision: number;
+    upper: ReadonlyArray<{
+        x: number;
+        y: number;
+    }>;
+    lower: ReadonlyArray<{
+        x: number;
+        y: number;
+    }>;
+    color: string;
+    alpha: number;
+    scrollLeft: number;
+    z: number;
+    paneId: string;
+};
+export type SceneNode = RectsNode | LinesNode | BandNode;
+export type RetainedSceneOptions = {
+    staleFrames?: number;
+};
+export type RetainedScene = {
+    beginFrame(frameNumber: number): void;
+    upsert(node: SceneNode): void;
+    collectVisible(paneId?: string): SceneNode[];
+    endFrame(): void;
+    prune(): string[];
+    clear(): void;
+};
+export declare function createRetainedScene(options?: RetainedSceneOptions): RetainedScene;
+//# sourceMappingURL=retainedScene.d.ts.map