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

package/dist/rendering/render/createWebGLRenderer.js

@@ -0,0 +1,233 @@
+import { CandleWebGLSurface, LineWebGLSurface } from '../../engine/renderers/webgl/candleSurface';
+const handleCaps = {
+    compute: false,
+    storageBuffer: false,
+    maxInstances: 1_000_000,
+    name: 'webgl2',
+};
+function toWebGLRegion(r) {
+    return r;
+}
+export function createWebGLRenderer(surface, gl) {
+    let disposed = false;
+    let candleSurface = null;
+    let lineSurface = null;
+    let fallbackCtx = null;
+    let fallbackDpr = 1;
+    const candle = new CandleWebGLSurface(gl);
+    if (candle.isAvailable())
+        candleSurface = candle;
+    const line = new LineWebGLSurface(gl);
+    if (line.isAvailable())
+        lineSurface = line;
+    const bufferMeta = new WeakMap();
+    const pipelineMeta = new WeakMap();
+    function disposeSurfaces() {
+        if (candleSurface) {
+            candleSurface.destroy();
+            candleSurface = null;
+        }
+        if (lineSurface) {
+            lineSurface.destroy();
+            lineSurface = null;
+        }
+    }
+    const renderer = {
+        get surface() {
+            return surface;
+        },
+        get caps() {
+            return handleCaps;
+        },
+        setFallbackContext(ctx, dpr) {
+            fallbackCtx = ctx;
+            fallbackDpr = dpr;
+        },
+        createBuffer(usage, sizeBytes) {
+            if (disposed) {
+                throw new Error('Renderer is disposed');
+            }
+            const handle = {};
+            bufferMeta.set(handle, { usage, byteLength: sizeBytes, data: null });
+            return handle;
+        },
+        writeBuffer(handle, data, offsetBytes) {
+            if (disposed)
+                return;
+            const meta = bufferMeta.get(handle);
+            if (!meta)
+                return;
+            const offset = offsetBytes ?? 0;
+            const neededSize = offset + data.byteLength;
+            if (!meta.data || meta.data.byteLength < neededSize) {
+                const newBuf = new ArrayBuffer(Math.max(neededSize, meta.byteLength));
+                if (meta.data) {
+                    new Uint8Array(newBuf).set(new Uint8Array(meta.data, 0, Math.min(meta.data.byteLength, neededSize)));
+                }
+                meta.data = newBuf;
+            }
+            const src = new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+            new Uint8Array(meta.data, offset).set(src);
+        },
+        destroyBuffer(handle) {
+            if (disposed)
+                return;
+            bufferMeta.delete(handle);
+        },
+        createPipeline(descriptor) {
+            if (disposed) {
+                throw new Error('Renderer is disposed');
+            }
+            const desc = descriptor;
+            const handle = {};
+            pipelineMeta.set(handle, { type: desc.type ?? 'candle' });
+            return handle;
+        },
+        destroyPipeline(handle) {
+            if (disposed)
+                return;
+            pipelineMeta.delete(handle);
+        },
+        createComputePipeline(_descriptor) {
+            throw new Error('compute not supported on WebGL backend (caps.compute === false)');
+        },
+        destroyComputePipeline(_handle) {
+            // no-op: WebGL has no compute pipelines
+        },
+        beginFrame(region) {
+            if (disposed)
+                return;
+            surface.bindRegion(region);
+            if (candleSurface) {
+                candleSurface.setRegion(toWebGLRegion(region));
+                candleSurface.resize(region.width, region.height, region.dpr);
+            }
+            if (lineSurface) {
+                lineSurface.setRegion(toWebGLRegion(region));
+                lineSurface.resize(region.width, region.height, region.dpr);
+            }
+        },
+        drawInstances(params) {
+            if (disposed)
+                return;
+            const pipelineMeta_rec = pipelineMeta.get(params.pipeline);
+            if (!pipelineMeta_rec || pipelineMeta_rec.type !== 'candle')
+                return;
+            const instanceMeta = bufferMeta.get(params.instances);
+            if (!instanceMeta || !instanceMeta.data)
+                return;
+            const rectCount = params.instanceCount;
+            if (rectCount <= 0)
+                return;
+            const floats = new Float32Array(instanceMeta.data, 0, rectCount * 4);
+            const color = params.uniforms?.color ?? '#000000';
+            const scrollLeft = params.uniforms?.scrollLeft ?? 0;
+            if (candleSurface) {
+                candleSurface.drawRectBuffer(floats, rectCount, color, scrollLeft);
+                return;
+            }
+            if (fallbackCtx) {
+                const ctx = fallbackCtx;
+                ctx.fillStyle = color;
+                for (let i = 0; i < rectCount; i++) {
+                    const x = floats[i * 4] - scrollLeft;
+                    const y = floats[i * 4 + 1];
+                    const w = Math.max(0, floats[i * 4 + 2]);
+                    const h = floats[i * 4 + 3];
+                    ctx.fillRect(x, y, w, h);
+                }
+            }
+        },
+        drawLines(params) {
+            if (disposed)
+                return;
+            const pipelineMeta_rec = pipelineMeta.get(params.pipeline);
+            if (!pipelineMeta_rec)
+                return;
+            const vertexMeta = bufferMeta.get(params.vertices);
+            if (!vertexMeta || !vertexMeta.data)
+                return;
+            if (params.vertexCount < 2)
+                return;
+            const color = params.uniforms?.color ?? '#000000';
+            const scrollLeft = params.uniforms?.scrollLeft ?? 0;
+            if (pipelineMeta_rec.type === 'fill') {
+                const floats = new Float32Array(vertexMeta.data, 0, params.vertexCount * 2);
+                const pointCount = Math.floor(params.vertexCount / 2);
+                const upperPoints = [];
+                const lowerPoints = [];
+                for (let i = 0; i < pointCount; i++) {
+                    const offset = i * 4;
+                    upperPoints.push({ x: floats[offset], y: floats[offset + 1] });
+                    lowerPoints.push({ x: floats[offset + 2], y: floats[offset + 3] });
+                }
+                if (lineSurface) {
+                    lineSurface.drawFilledBand({ upperPoints, lowerPoints }, color, scrollLeft);
+                    return;
+                }
+                if (fallbackCtx) {
+                    const ctx = fallbackCtx;
+                    ctx.beginPath();
+                    ctx.moveTo(upperPoints[0].x - scrollLeft, upperPoints[0].y);
+                    for (let i = 1; i < upperPoints.length; i++) {
+                        ctx.lineTo(upperPoints[i].x - scrollLeft, upperPoints[i].y);
+                    }
+                    for (let i = lowerPoints.length - 1; i >= 0; i--) {
+                        ctx.lineTo(lowerPoints[i].x - scrollLeft, lowerPoints[i].y);
+                    }
+                    ctx.closePath();
+                    ctx.fillStyle = color;
+                    ctx.fill();
+                }
+                return;
+            }
+            const floats = new Float32Array(vertexMeta.data, 0, params.vertexCount * 2);
+            if (lineSurface) {
+                const points = [];
+                for (let i = 0; i < params.vertexCount; i++) {
+                    points.push({ x: floats[i * 2], y: floats[i * 2 + 1] });
+                }
+                const lineWidth = params.uniforms?.lineWidth ?? 1;
+                const lines = [{ points, color, width: lineWidth }];
+                lineSurface.drawLineStrips(lines, scrollLeft);
+                return;
+            }
+            if (fallbackCtx) {
+                const ctx = fallbackCtx;
+                const lineWidth = params.uniforms?.lineWidth ?? 1;
+                const dashPattern = params.uniforms?.dashPattern;
+                ctx.beginPath();
+                ctx.moveTo(floats[0] - scrollLeft, floats[1]);
+                for (let i = 1; i < params.vertexCount; i++) {
+                    ctx.lineTo(floats[i * 2] - scrollLeft, floats[i * 2 + 1]);
+                }
+                ctx.strokeStyle = color;
+                ctx.lineWidth = lineWidth;
+                if (dashPattern && dashPattern.length > 0) {
+                    ctx.setLineDash(dashPattern);
+                }
+                ctx.stroke();
+                if (dashPattern && dashPattern.length > 0) {
+                    ctx.setLineDash([]);
+                }
+            }
+        },
+        dispatchCompute(_params) {
+            if (!disposed) {
+                throw new Error('dispatchCompute requires a backend with caps.compute === true');
+            }
+        },
+        endFrame() {
+            // no-op per-frame cleanup; surfaces hold region reference until next frame
+        },
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            disposeSurfaces();
+            surface.dispose();
+        },
+    };
+    return renderer;
+}
+//# sourceMappingURL=createWebGLRenderer.js.map

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

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

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

@@ -0,0 +1,4 @@
+import { SharedWebGLSurface } from '../../engine/renderers/webgl/sharedWebGLSurface';
+import type { SurfaceBackend } from './SurfaceBackend';
+export declare function createWebGLSurfaceBackend(surface: SharedWebGLSurface): SurfaceBackend;
+//# sourceMappingURL=createWebGLSurfaceBackend.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createWebGLSurfaceBackend.d.ts","sourceRoot":"","sources":["../../../src/rendering/render/createWebGLSurfaceBackend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAA;AAEpF,OAAO,KAAK,EAAE,cAAc,EAAmC,MAAM,kBAAkB,CAAA;AAEvF,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,kBAAkB,GAAG,cAAc,CAuCrF"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"createWebGLSurfaceBackend.js","sourceRoot":"","sources":["../../../src/rendering/render/createWebGLSurfaceBackend.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,yBAAyB,CAAC,OAA2B;IACnE,IAAI,QAAQ,GAAG,KAAK,CAAA;IAEpB,OAAO;QACL,WAAW;YACT,IAAI,QAAQ;gBAAE,OAAO,KAAK,CAAA;YAC1B,OAAO,OAAO,CAAC,WAAW,EAAE,CAAA;QAC9B,CAAC;QAED,MAAM,CAAC,YAAoB,EAAE,aAAqB,EAAE,GAAW;YAC7D,IAAI,QAAQ;gBAAE,OAAM;YACpB,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,aAAa,EAAE,GAAG,CAAC,CAAA;QAClD,CAAC;QAED,UAAU,CAAC,MAAqB;YAC9B,IAAI,QAAQ;gBAAE,OAAO,KAAK,CAAA;YAC1B,OAAO,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;QACnC,CAAC;QAED,WAAW,CAAC,MAAqB;YAC/B,IAAI,QAAQ;gBAAE,OAAM;YACpB,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;QAC7B,CAAC;QAED,WAAW,CACT,SAAmC,EACnC,MAAqB,EACrB,OAA0B;YAE1B,IAAI,QAAQ;gBAAE,OAAM;YACpB,OAAO,CAAC,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;QACvD,CAAC;QAED,OAAO;YACL,IAAI,QAAQ;gBAAE,OAAM;YACpB,QAAQ,GAAG,IAAI,CAAA;YACf,OAAO,CAAC,OAAO,EAAE,CAAA;QACnB,CAAC;KACF,CAAA;AACH,CAAC"}

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

@@ -0,0 +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"}

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

@@ -0,0 +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"}

package/dist/rendering/renderer-tier/detectRendererTier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectRendererTier.d.ts","sourceRoot":"","sources":["../../../src/rendering/renderer-tier/detectRendererTier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACxB,MAAM,SAAS,CAAA;AAmDhB;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,yBAAyB,GAAG,kBAAkB,CA6BvF;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,CAAC,EAAE,yBAAyB,GAAG,kBAAkB,CAM9F;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAMhF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAEhF"}

package/dist/rendering/renderer-tier/detectRendererTier.js

@@ -0,0 +1,143 @@
+/**
+ * Synchronous renderer tier detection.
+ *
+ * Probes (in descending capability order):
+ *
+ *   1. **webgpu**   `'gpu' in navigator`. We deliberately do NOT call
+ *                   `navigator.gpu.requestAdapter()` here — that's async
+ *                   and the answer can change between probe and use
+ *                   (e.g. user toggles the WebGPU flag). The renderer
+ *                   should retry adapter acquisition at startup; this
+ *                   sync check is a pre-mount fast path.
+ *
+ *   2. **webgl2**   `canvas.getContext('webgl2') !== null`. Probes a
+ *                   throwaway `<canvas>`; if the browser hard-disabled
+ *                   WebGL (some hardened policies do), this returns
+ *                   null and we fall through.
+ *
+ *   3. **canvas2d** `canvas.getContext('2d') !== null`. Universal
+ *                   fallback for browsers from the 2010s onwards.
+ *
+ *   4. **none**     None of the above worked — likely SSR (no document)
+ *                   or a sandboxed environment. The caller can decide
+ *                   whether that's an error or a "render nothing" state.
+ *
+ * All exceptions from a probe are caught and folded into the `reason`
+ * field — a probe that throws is treated identically to one that
+ * returns false (no tier-skip cascade).
+ */
+import { KLineChartError } from '../../errors';
+import { RENDERER_TIER_RANK, } from './types';
+// ---------------------------------------------------------------------------
+// Production probes — only run when no override is supplied
+// ---------------------------------------------------------------------------
+function probeWebGpu() {
+    const nav = globalThis.navigator;
+    if (typeof nav !== 'object' || nav === null)
+        return false;
+    return 'gpu' in nav;
+}
+function probeWebGl2() {
+    const doc = globalThis.document;
+    if (typeof doc?.createElement !== 'function')
+        return false;
+    const canvas = doc.createElement('canvas');
+    if (typeof canvas.getContext !== 'function')
+        return false;
+    return canvas.getContext('webgl2') !== null;
+}
+function probeCanvas2d() {
+    const doc = globalThis.document;
+    if (typeof doc?.createElement !== 'function')
+        return false;
+    const canvas = doc.createElement('canvas');
+    if (typeof canvas.getContext !== 'function')
+        return false;
+    return canvas.getContext('2d') !== null;
+}
+// ---------------------------------------------------------------------------
+// runProbe — adapter that turns probe → "ok, false, or error string"
+// ---------------------------------------------------------------------------
+function runProbe(probe) {
+    try {
+        return { ok: probe() === true, error: null };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return { ok: false, error: msg };
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+const TIER_ORDER = ['webgpu', 'webgl2', 'canvas2d'];
+/**
+ * Detect the best renderer tier available in the current environment.
+ *
+ * Returns synchronously. Use this at the call site of `createChart` to
+ * pick the renderer backend; persist the result if you re-mount, since
+ * recomputing is cheap but not free (probing creates a throwaway canvas).
+ */
+export function detectRendererTier(opts) {
+    const probes = opts?.probes ?? {};
+    const reasonParts = [];
+    const tried = [];
+    for (const tier of TIER_ORDER) {
+        tried.push(tier);
+        const probe = tier === 'webgpu'
+            ? (probes.webgpu ?? probeWebGpu)
+            : tier === 'webgl2'
+                ? (probes.webgl2 ?? probeWebGl2)
+                : (probes.canvas2d ?? probeCanvas2d);
+        const r = runProbe(probe);
+        if (r.ok) {
+            return {
+                tier,
+                reason: `selected ${tier} (${reasonParts.length === 0 ? 'first probe succeeded' : reasonParts.join('; ')})`,
+                tried: [...tried],
+            };
+        }
+        reasonParts.push(r.error === null ? `${tier}: not available` : `${tier}: threw "${r.error}"`);
+    }
+    return {
+        tier: 'none',
+        reason: `no tier available — ${reasonParts.join('; ')}`,
+        tried: [...tried],
+    };
+}
+/**
+ * Strict variant: throws `KLineChartError('INVALID_STATE')` when no
+ * renderable tier is found. Use when you want a hard failure rather
+ * than a silent `'none'`.
+ */
+export function detectRendererTierOrThrow(opts) {
+    const r = detectRendererTier(opts);
+    if (r.tier === 'none') {
+        throw new KLineChartError('INVALID_STATE', `detectRendererTierOrThrow: ${r.reason}`);
+    }
+    return r;
+}
+/**
+ * Three-way compare on the tier rank. `a > b → 1`, `a < b → -1`, equal → 0.
+ *
+ *   compareRendererTier('webgpu', 'webgl2') === 1
+ *   compareRendererTier('canvas2d', 'webgl2') === -1
+ *   compareRendererTier('webgl2', 'webgl2') === 0
+ */
+export function compareRendererTier(a, b) {
+    const ra = RENDERER_TIER_RANK[a];
+    const rb = RENDERER_TIER_RANK[b];
+    if (ra > rb)
+        return 1;
+    if (ra < rb)
+        return -1;
+    return 0;
+}
+/**
+ * `tier >= minimum` guard for renderer features that require a floor
+ * (e.g. GPU compute volume profile needs `>= 'webgl2'`).
+ */
+export function isTierAtLeast(tier, minimum) {
+    return compareRendererTier(tier, minimum) >= 0;
+}
+//# sourceMappingURL=detectRendererTier.js.map

package/dist/rendering/renderer-tier/detectRendererTier.js.map

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

package/dist/rendering/renderer-tier/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/rendering/renderer-tier/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,mBAAmB,EACnB,aAAa,GACd,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,GAC1B,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,GAC/B,MAAM,SAAS,CAAA"}

package/dist/rendering/renderer-tier/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/rendering/renderer-tier/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,mBAAmB,EACnB,aAAa,GACd,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,aAAa,EACb,oBAAoB,GAKrB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,kBAAkB,GAKnB,MAAM,SAAS,CAAA"}

package/dist/rendering/renderer-tier/selectBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectBackend.d.ts","sourceRoot":"","sources":["../../../src/rendering/renderer-tier/selectBackend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAKH,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACxB,MAAM,SAAS,CAAA;AAMhB;;;;GAIG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,OAAO,IAAI,MAAM,CAAC,CAAA;AAEjD;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,OAAO,IAAI,OAAO,CAChD,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAChE,CAAA;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,OAAO;IAC3C,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IAC1C,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,YAAY,CAAC,CAAA;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAA;CACvC;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC,GAAG,OAAO;IAC/C,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,CAAA;IACrC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,yBAAyB,CAAA;IAC3C;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAA;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAA;CAChC;AAQD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAuD7F;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,GAAG,OAAO,EAC9C,IAAI,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC5B,gBAAgB,CAAC,CAAC,CAAC,GAAG;IAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,CAAA;CAAE,CAMtD"}

package/dist/rendering/renderer-tier/selectBackend.js

@@ -0,0 +1,109 @@
+/**
+ * Renderer backend selector — bridges the tier-detection layer
+ * ({@link detectRendererTier}) to the actual backend factory the
+ * `Renderer` interface will instantiate.
+ *
+ * Why this exists separately from {@link detectRendererTier}:
+ *
+ *   - Detection answers "what's *possible*?".
+ *   - Selection answers "what's *registered* and matches what's possible?".
+ *
+ * In practice the answers diverge. A consumer can:
+ *
+ *   (a) Choose to omit a backend they don't want to ship (e.g. drop the
+ *       WebGPU backend to save bundle size; the selector then falls
+ *       through to WebGL2 even when the host supports WebGPU).
+ *   (b) Override a backend for a specific tier (e.g. inject a Canvas2D
+ *       backend stub during tests, so the chart still renders headless).
+ *
+ * Both shapes need a *structural* fallback chain, not just "give me the
+ * factory for the detected tier". This module formalises that chain so
+ * the wiring is consistent across React, Vue, Angular, and any future
+ * adapter.
+ *
+ * Pure data: no DOM, no async, no side effects. The returned factory is
+ * just the function the caller registered.
+ */
+import { KLineChartError } from '../../errors';
+import { detectRendererTier, isTierAtLeast } from './detectRendererTier';
+import { RENDERER_TIER_RANK, } from './types';
+// ---------------------------------------------------------------------------
+// Selection
+// ---------------------------------------------------------------------------
+const SEARCH_ORDER = ['webgpu', 'webgl2', 'canvas2d'];
+/**
+ * Pick the highest registered backend at or below the detected tier
+ * (and at or above the optional minimum). Pure-data.
+ *
+ *   const sel = selectBackend({
+ *     registry: { webgpu: makeGpu, webgl2: makeGl2, canvas2d: makeC2d },
+ *   })
+ *   if (sel.factory === null) throw new Error('no renderer')
+ *   const renderer = sel.factory()
+ *
+ * Telemetry pattern:
+ *
+ *   if (sel.tier !== sel.detection.tier) {
+ *     log('renderer downgrade', sel.detection.tier, '→', sel.tier, sel.reason)
+ *   }
+ */
+export function selectBackend(opts) {
+    const detection = opts.detection ?? detectRendererTier(opts.detect);
+    const detectedTier = detection.tier;
+    const minimum = opts.minimum ?? 'none';
+    // Validate the minimum is a known tier; reject 'none' as a minimum
+    // because a 'none' floor is meaningless — nothing can be below it.
+    if (!(minimum in RENDERER_TIER_RANK)) {
+        throw new KLineChartError('INVALID_PARAM', `selectBackend: minimum must be a RendererTier, got ${JSON.stringify(minimum)}`);
+    }
+    const chain = [];
+    // Search from the detected tier downwards through SEARCH_ORDER.
+    for (const candidate of SEARCH_ORDER) {
+        // Skip tiers above the detected ceiling.
+        if (RENDERER_TIER_RANK[candidate] > RENDERER_TIER_RANK[detectedTier]) {
+            continue;
+        }
+        chain.push(candidate);
+        // Skip below the configured minimum.
+        if (!isTierAtLeast(candidate, minimum)) {
+            // No further candidate will satisfy the minimum.
+            break;
+        }
+        const factory = opts.registry[candidate] ?? null;
+        if (factory !== null) {
+            return {
+                tier: candidate,
+                factory,
+                fallbackChain: chain,
+                reason: candidate === detectedTier
+                    ? `direct match: detected ${candidate} and ${candidate} backend is registered`
+                    : `downgrade: detected ${detectedTier}, but only ${candidate} backend is registered`,
+                detection,
+            };
+        }
+    }
+    return {
+        tier: 'none',
+        factory: null,
+        fallbackChain: chain,
+        reason: detectedTier === 'none'
+            ? `host has no renderable tier`
+            : `no registered backend at or below detected ${detectedTier}` +
+                (opts.minimum !== undefined && opts.minimum !== 'none'
+                    ? ` (minimum=${opts.minimum})`
+                    : ''),
+        detection,
+    };
+}
+/**
+ * Strict variant: throws `KLineChartError('INVALID_STATE')` if no factory
+ * could be selected. Use when a renderable backend is mandatory.
+ */
+export function selectBackendOrThrow(opts) {
+    const sel = selectBackend(opts);
+    if (sel.factory === null) {
+        throw new KLineChartError('INVALID_STATE', `selectBackendOrThrow: ${sel.reason}`);
+    }
+    return sel;
+}
+//# sourceMappingURL=selectBackend.js.map

package/dist/rendering/renderer-tier/selectBackend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectBackend.js","sourceRoot":"","sources":["../../../src/rendering/renderer-tier/selectBackend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE9C,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACxE,OAAO,EACL,kBAAkB,GAInB,MAAM,SAAS,CAAA;AAkEhB,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,YAAY,GAAiD,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAA;AAEnG;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,aAAa,CAAc,IAA6B;IACtE,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACnE,MAAM,YAAY,GAAG,SAAS,CAAC,IAAI,CAAA;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,MAAM,CAAA;IAEtC,mEAAmE;IACnE,mEAAmE;IACnE,IAAI,CAAC,CAAC,OAAO,IAAI,kBAAkB,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,eAAe,CACvB,eAAe,EACf,sDAAsD,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAChF,CAAA;IACH,CAAC;IAED,MAAM,KAAK,GAAmB,EAAE,CAAA;IAChC,gEAAgE;IAChE,KAAK,MAAM,SAAS,IAAI,YAAY,EAAE,CAAC;QACrC,yCAAyC;QACzC,IAAI,kBAAkB,CAAC,SAAS,CAAC,GAAG,kBAAkB,CAAC,YAAY,CAAC,EAAE,CAAC;YACrE,SAAQ;QACV,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACrB,qCAAqC;QACrC,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC;YACvC,iDAAiD;YACjD,MAAK;QACP,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,IAAI,CAAA;QAChD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO;gBACP,aAAa,EAAE,KAAK;gBACpB,MAAM,EACJ,SAAS,KAAK,YAAY;oBACxB,CAAC,CAAC,0BAA0B,SAAS,QAAQ,SAAS,wBAAwB;oBAC9E,CAAC,CAAC,uBAAuB,YAAY,cAAc,SAAS,wBAAwB;gBACxF,SAAS;aACV,CAAA;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,IAAI;QACb,aAAa,EAAE,KAAK;QACpB,MAAM,EACJ,YAAY,KAAK,MAAM;YACrB,CAAC,CAAC,6BAA6B;YAC/B,CAAC,CAAC,8CAA8C,YAAY,EAAE;gBAC5D,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,MAAM;oBACpD,CAAC,CAAC,aAAa,IAAI,CAAC,OAAO,GAAG;oBAC9B,CAAC,CAAC,EAAE,CAAC;QACb,SAAS;KACV,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAA6B;IAE7B,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;IAC/B,IAAI,GAAG,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,IAAI,eAAe,CAAC,eAAe,EAAE,yBAAyB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAA;IACnF,CAAC;IACD,OAAO,GAA2D,CAAA;AACpE,CAAC"}

package/dist/rendering/renderer-tier/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/rendering/renderer-tier/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAA;AAEpE;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAKrE,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,YAAY,CAAC,CAAA;CAC5C;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,OAAO,CAAA;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,OAAO,CAAA;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAA;CAClC;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAA;CACrC"}

package/dist/rendering/renderer-tier/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/rendering/renderer-tier/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA2C;IACxE,MAAM,EAAE,CAAC;IACT,MAAM,EAAE,CAAC;IACT,QAAQ,EAAE,CAAC;IACX,IAAI,EAAE,CAAC;CACR,CAAA"}

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

@@ -0,0 +1,4 @@
+import type { RendererPlugin, RenderContext } from '../../foundation/plugin/index';
+import type { Layer } from './types';
+export declare function createLayerFromPlugin(plugin: RendererPlugin, getContext: () => RenderContext | null, targetPaneId: string): Layer;
+//# sourceMappingURL=createLayerFromPlugin.d.ts.map

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

@@ -0,0 +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"}

package/dist/rendering/scene/createLayerFromPlugin.js

@@ -0,0 +1,45 @@
+import { RENDERER_PRIORITY } from '../../foundation/plugin/index';
+export function createLayerFromPlugin(plugin, getContext, targetPaneId) {
+    const paneRole = targetPaneId === 'main' ? 'main' : targetPaneId === 'global' ? 'global' : 'sub';
+    let visible = plugin.enabled !== false;
+    return {
+        id: `plugin:${plugin.name}`,
+        role: pluginPriorityToRole(plugin.priority, plugin),
+        paneRole,
+        z: plugin.priority,
+        get visible() {
+            return visible;
+        },
+        set visible(v) {
+            visible = v;
+        },
+        paint(ctx) {
+            if (!visible)
+                return;
+            // For sub-pane layers, skip if we're painting a different sub-pane
+            if (paneRole === 'sub' && ctx.paneId !== targetPaneId)
+                return;
+            const context = getContext();
+            if (!context)
+                return;
+            plugin.draw(context);
+        },
+        dispose() {
+            plugin.onUninstall?.();
+        },
+    };
+}
+function pluginPriorityToRole(priority, plugin) {
+    if (plugin.layer === 'overlay')
+        return 'overlay';
+    if (priority <= RENDERER_PRIORITY.GRID || plugin.name === 'gridLines' || plugin.name === 'grid')
+        return 'background';
+    if (priority <= RENDERER_PRIORITY.INDICATOR && plugin.name !== 'candle')
+        return 'indicator';
+    if (plugin.name === 'candle' || plugin.name === 'comparisonLine')
+        return 'primary';
+    if (plugin.name.startsWith('drawing'))
+        return 'drawing';
+    return 'indicator';
+}
+//# sourceMappingURL=createLayerFromPlugin.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"createScene.d.ts","sourceRoot":"","sources":["../../../src/rendering/scene/createScene.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAkC,KAAK,EAAE,MAAM,SAAS,CAAA;AAEpE,wBAAgB,WAAW,IAAI,KAAK,CAgGnC"}