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

package/dist/engine/state/viewportState.js

@@ -0,0 +1,352 @@
+import { createSubState, computed, batch, effect, } from '../../foundation/reactivity/signal';
+import { getVisibleRange } from '../viewport/viewport';
+import { computeLeftLoadBufferWidth as pureLeftBuffer, computeContentWidth as pureContentWidth, computeMaxScrollLeft as pureMaxScrollLeft, } from './contentGeometry';
+import { deriveKGap } from '../utils/zoom';
+/**
+ * 钳制 effective DPR，避免超出 MAX_CANVAS_PIXELS 上限。
+ *
+ * @param viewWidth   视口 CSS 宽度
+ * @param viewHeight  视口 CSS 高度
+ * @param effectiveDpr 当前有效 DPR
+ * @param maxCanvasPixels 像素上限（默认 16M）
+ * @returns 钳制后的 DPR
+ */
+export function clampDpr(viewWidth, viewHeight, effectiveDpr, maxCanvasPixels = 16 * 1024 * 1024) {
+    if (viewWidth * effectiveDpr * (viewHeight * effectiveDpr) > maxCanvasPixels) {
+        return Math.sqrt(maxCanvasPixels / (viewWidth * viewHeight));
+    }
+    return effectiveDpr;
+}
+/**
+ * 根据 preciseDpr 与 window.devicePixelRatio 计算 effective DPR。
+ *
+ * @remarks Electron 环境下走特殊逻辑：忽略 preciseDpr，直接读取系统 DPR。
+ *
+ * @param preciseDpr - 用户配置的高精度 DPR（0 表示自动）
+ * @returns 最终生效的 DPR，最低为 1
+ */
+export function getEffectiveDprLogic(preciseDpr) {
+    if (typeof navigator !== 'undefined' && navigator.userAgent.includes('Electron')) {
+        return Math.max(1, (typeof window !== 'undefined' ? window.devicePixelRatio : 1) || 1);
+    }
+    if (preciseDpr > 0)
+        return preciseDpr;
+    const dpr = Math.round((typeof window !== 'undefined' ? window.devicePixelRatio : 1) * 64) / 64;
+    return Math.max(1, dpr || 1);
+}
+const NULL_DOM_RETURN = {
+    container: null,
+    canvasLayer: null,
+    xAxisCanvas: null,
+};
+export function createViewportState(signalDeps) {
+    let _domDeps;
+    const _getDom = () => (_domDeps ? _domDeps.getDom() : NULL_DOM_RETURN);
+    const _resizeSharedWebGLSurface = (w, h, dpr) => {
+        if (_domDeps)
+            _domDeps.resizeSharedWebGLSurface(w, h, dpr);
+    };
+    const computeDpr = (viewWidth, viewHeight, preciseDpr) => {
+        const eff = getEffectiveDprLogic(preciseDpr);
+        return clampDpr(Math.max(1, viewWidth), Math.max(1, viewHeight), eff);
+    };
+    const computePlotWidth = (viewWidth) => Math.round(viewWidth);
+    const computePlotHeight = (viewHeight) => Math.round(viewHeight - signalDeps.options$().bottomAxisHeight);
+    const computeViewport = (viewWidth, viewHeight, scrollLeftRaw, leftLoadBufferWidth, preciseDpr) => {
+        const dpr = computeDpr(viewWidth, viewHeight, preciseDpr);
+        const plotWidth = computePlotWidth(viewWidth);
+        const plotHeight = computePlotHeight(viewHeight);
+        const logicalScrollLeft = scrollLeftRaw - leftLoadBufferWidth;
+        const scrollLeft = Math.round(logicalScrollLeft * dpr) / dpr;
+        return { viewWidth, viewHeight, plotWidth, plotHeight, scrollLeft, dpr };
+    };
+    const { signals, readonly } = createSubState({
+        requestedScrollLeft: 0,
+        viewWidth: 0,
+        viewHeight: 0,
+        preciseDpr: 0,
+        initialized: false,
+    }, {
+        dpr: (s) => computeDpr(s.viewWidth(), s.viewHeight(), s.preciseDpr()),
+        plotWidth: (s) => computePlotWidth(s.viewWidth()),
+        plotHeight: (s) => computePlotHeight(s.viewHeight()),
+        leftLoadBufferWidth: (s) => pureLeftBuffer({
+            viewWidth: s.viewWidth(),
+            plotWidth: Math.round(s.viewWidth()),
+            dataLength: signalDeps.dataLength$(),
+            period: signalDeps.period$(),
+            dpr: 1,
+            kWidth: 0,
+            kGap: 0,
+        }),
+    });
+    const kGap = computed(() => {
+        return deriveKGap({
+            kWidth: signalDeps.options$().kWidth,
+            dpr: readonly.dpr(),
+            period: signalDeps.period$(),
+        });
+    });
+    const contentWidth = computed(() => {
+        const options = signalDeps.options$();
+        return pureContentWidth({
+            viewWidth: readonly.plotWidth(),
+            plotWidth: readonly.plotWidth(),
+            dataLength: signalDeps.dataLength$(),
+            period: signalDeps.period$(),
+            dpr: readonly.dpr(),
+            kWidth: options.kWidth,
+            kGap: kGap(),
+        });
+    });
+    const maxScrollLeft = computed(() => pureMaxScrollLeft(contentWidth(), readonly.viewWidth()));
+    const scrollLeft = computed(() => Math.max(0, Math.min(readonly.requestedScrollLeft(), maxScrollLeft())));
+    const scrollLeftLogical = computed(() => scrollLeft() - readonly.leftLoadBufferWidth());
+    // ── 带引用缓存的 computed —— 仅在字段值实际变化时返回新对象 ──
+    // 避免 Object.is 短路失效导致下游 effect / Vue 订阅在子像素滚动时虚假重跑
+    let _cachedViewport = null;
+    const cachedViewport = computed(() => {
+        const vp = computeViewport(readonly.viewWidth(), readonly.viewHeight(), scrollLeft(), readonly.leftLoadBufferWidth(), readonly.preciseDpr());
+        if (_cachedViewport &&
+            _cachedViewport.viewWidth === vp.viewWidth &&
+            _cachedViewport.viewHeight === vp.viewHeight &&
+            _cachedViewport.plotWidth === vp.plotWidth &&
+            _cachedViewport.plotHeight === vp.plotHeight &&
+            _cachedViewport.scrollLeft === vp.scrollLeft &&
+            _cachedViewport.dpr === vp.dpr) {
+            return _cachedViewport;
+        }
+        _cachedViewport = vp;
+        return vp;
+    });
+    let _cachedVisibleRange = null;
+    const cachedVisibleRange = computed(() => {
+        const vp = cachedViewport();
+        const opts = signalDeps.options$();
+        const vr = getVisibleRange(vp.scrollLeft, vp.plotWidth, opts.kWidth, kGap(), signalDeps.dataLength$(), vp.dpr);
+        if (_cachedVisibleRange && _cachedVisibleRange.start === vr.start && _cachedVisibleRange.end === vr.end) {
+            return _cachedVisibleRange;
+        }
+        _cachedVisibleRange = vr;
+        return vr;
+    });
+    let _cachedViewportState = null;
+    const cachedViewportState = computed(() => {
+        const vp = cachedViewport();
+        const vr = cachedVisibleRange();
+        const opts = signalDeps.options$();
+        const next = {
+            zoomLevel: signalDeps.zoomLevel$(),
+            plotWidth: vp.plotWidth,
+            plotHeight: vp.plotHeight,
+            dpr: vp.dpr,
+            visibleFrom: vr.start,
+            visibleTo: vr.end,
+            kWidth: opts.kWidth,
+            kGap: kGap(),
+        };
+        if (_cachedViewportState &&
+            _cachedViewportState.zoomLevel === next.zoomLevel &&
+            _cachedViewportState.plotWidth === next.plotWidth &&
+            _cachedViewportState.plotHeight === next.plotHeight &&
+            _cachedViewportState.dpr === next.dpr &&
+            _cachedViewportState.visibleFrom === next.visibleFrom &&
+            _cachedViewportState.visibleTo === next.visibleTo &&
+            _cachedViewportState.kWidth === next.kWidth &&
+            _cachedViewportState.kGap === next.kGap) {
+            return _cachedViewportState;
+        }
+        _cachedViewportState = next;
+        return next;
+    });
+    // ── DOM 副作用（effect） ──
+    // compute 负责内部状态计算属性，effect 负责将状态同步到外界
+    // effect 的监听行为是自动的，但它的启动时机是手动控制的
+    let canvasDomEffect = null;
+    let webglEffect = null;
+    let scrollDomEffect = null;
+    const setRequestedScrollLeft = (value) => {
+        const normalized = Number.isFinite(value) ? value : 0;
+        batch(() => {
+            signals.requestedScrollLeft.set(Math.max(0, Math.min(normalized, maxScrollLeft.peek())));
+        });
+    };
+    const syncFromDomScroll = () => {
+        const container = _getDom().container;
+        if (container) {
+            setRequestedScrollLeft(container.scrollLeft);
+        }
+    };
+    /**
+     * 挂载 canvas DOM 尺寸与 WebGL surface 的同步 effect。
+     *
+     * @remarks init() 时调用，返回的清理函数由 dispose() 执行。
+     */
+    const setupCanvasSync = () => {
+        canvasDomEffect = effect(() => {
+            if (!readonly.initialized())
+                return;
+            const viewWidth = readonly.viewWidth();
+            const viewHeight = readonly.viewHeight();
+            if (viewWidth <= 0 || viewHeight <= 0)
+                return;
+            const dpr = readonly.dpr();
+            syncCanvasDom(dpr, viewWidth, viewHeight);
+        });
+        webglEffect = effect(() => {
+            if (!readonly.initialized())
+                return;
+            const plotWidth = readonly.plotWidth();
+            const plotHeight = readonly.plotHeight();
+            if (plotWidth <= 0 || plotHeight <= 0)
+                return;
+            const dpr = readonly.dpr();
+            _resizeSharedWebGLSurface(plotWidth, plotHeight, dpr);
+        });
+        scrollDomEffect = effect(() => {
+            if (!readonly.initialized())
+                return;
+            const derivedContentWidth = contentWidth();
+            const derivedScrollLeft = scrollLeft();
+            const dom = _getDom();
+            if (dom.scrollContent)
+                dom.scrollContent.style.width = `${derivedContentWidth}px`;
+            if (dom.container)
+                dom.container.scrollLeft = derivedScrollLeft;
+        });
+    };
+    const syncCanvasDom = (dpr, viewWidth, viewHeight) => {
+        const dom = _getDom();
+        const canvasLayer = dom.canvasLayer;
+        const xAxisCanvas = dom.xAxisCanvas;
+        if (!canvasLayer || !xAxisCanvas)
+            return;
+        const dprRoundedViewWidth = Math.round(viewWidth * dpr) / dpr;
+        const canvasLayerWidth = `${dprRoundedViewWidth}px`;
+        if (canvasLayer.style.width !== canvasLayerWidth) {
+            canvasLayer.style.width = canvasLayerWidth;
+        }
+        const canvasLayerHeight = `${viewHeight}px`;
+        if (canvasLayer.style.height !== canvasLayerHeight) {
+            canvasLayer.style.height = canvasLayerHeight;
+        }
+        const xAxisWidthPx = Math.round(dprRoundedViewWidth * dpr);
+        if (xAxisCanvas.width !== xAxisWidthPx) {
+            xAxisCanvas.width = xAxisWidthPx;
+        }
+        const xAxisHeight = Math.round(signalDeps.options$().bottomAxisHeight * dpr);
+        if (xAxisCanvas.height !== xAxisHeight) {
+            xAxisCanvas.height = xAxisHeight;
+        }
+        const xAxisCssWidth = `${dprRoundedViewWidth}px`;
+        if (xAxisCanvas.style.width !== xAxisCssWidth) {
+            xAxisCanvas.style.width = xAxisCssWidth;
+        }
+        const xAxisCssHeight = `${xAxisHeight / dpr}px`;
+        if (xAxisCanvas.style.height !== xAxisCssHeight) {
+            xAxisCanvas.style.height = xAxisCssHeight;
+        }
+    };
+    // ── Actions（外部消费者变更内部状态入口） ──
+    // ── 合并 readonly：原始 subState + 缓存 computed ──
+    const mergedReadonly = {
+        ...readonly,
+        contentWidth,
+        maxScrollLeft,
+        scrollLeft,
+        scrollLeftLogical,
+        kGap,
+        viewport: cachedViewport,
+        visibleRange: cachedVisibleRange,
+        viewportState: cachedViewportState,
+    };
+    return {
+        readonly: mergedReadonly,
+        setDomDeps(deps) {
+            _domDeps = deps;
+        },
+        actions: {
+            /**
+             * 滚动到指定 scrollLeft 位置。
+             *
+             * @remarks 仅更新内部信号，DOM 同步由 effect 负责。
+             *
+             * @param v - 目标 scrollLeft（CSS px）
+             */
+            scrollTo(v) {
+                setRequestedScrollLeft(v);
+            },
+            /**
+             * 从 DOM 容器的 scrollLeft 同步状态。
+             *
+             * @remarks 在外部滚动事件中调用，使 signal 与 DOM 保持一致。
+             */
+            syncFromDomScroll() {
+                syncFromDomScroll();
+            },
+            /**
+             * 响应容器尺寸变化，更新视口尺寸与 DPR。
+             *
+             * @remarks 首次初始化时若 scrollLeft 为 0，自动设为 viewWidth 以触发初始渲染。
+             * 三个字段在 batch() 内同步写入，保证 computed 只触发一次重求值，只触发一次重绘。
+             *
+             * @param width  - 新视口 CSS 宽度
+             * @param height - 新视口 CSS 高度
+             * @param dpr    - 新精确 DPR
+             */
+            resize(width, height, dpr) {
+                const w = Number.isFinite(width) ? Math.max(0, width) : 0;
+                const h = Number.isFinite(height) ? Math.max(0, height) : 0;
+                const d = Number.isFinite(dpr) ? dpr : 1;
+                batch(() => {
+                    if (signals.requestedScrollLeft.peek() === 0 && w > 0) {
+                        signals.requestedScrollLeft.set(w);
+                    }
+                    signals.viewWidth.set(w);
+                    signals.viewHeight.set(h);
+                    signals.preciseDpr.set(d);
+                });
+            },
+            /**
+             * 初始化视口状态。
+             *
+             * @remarks 从 DOM 容器读取当前 scrollLeft，并挂载 canvas 尺寸同步 effect。
+             * 重复调用安全（仅首次生效）。
+             */
+            init() {
+                if (signals.initialized.peek())
+                    return;
+                if (!_domDeps)
+                    return;
+                const container = _getDom().container;
+                if (!container)
+                    return;
+                signals.initialized.set(true);
+                setRequestedScrollLeft(container.scrollLeft);
+                setupCanvasSync();
+            },
+        },
+        /**
+         * 清理所有 effect 并重置状态。
+         *
+         * @remarks 图表销毁时调用。取消 DOM 同步与 WebGL 回调，
+         * 将 writable signals 归零。
+         */
+        dispose() {
+            canvasDomEffect?.();
+            webglEffect?.();
+            scrollDomEffect?.();
+            canvasDomEffect = null;
+            webglEffect = null;
+            scrollDomEffect = null;
+            batch(() => {
+                signals.initialized.set(false);
+                signals.preciseDpr.set(0);
+                signals.viewWidth.set(0);
+                signals.viewHeight.set(0);
+                signals.requestedScrollLeft.set(0);
+            });
+        },
+    };
+}
+//# sourceMappingURL=viewportState.js.map

package/dist/engine/state/viewportState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewportState.js","sourceRoot":"","sources":["../../../src/engine/state/viewportState.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,QAAQ,EACR,KAAK,EACL,MAAM,GAEP,MAAM,oCAAoC,CAAA;AAG3C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EACL,0BAA0B,IAAI,cAAc,EAC5C,mBAAmB,IAAI,gBAAgB,EACvC,oBAAoB,IAAI,iBAAiB,GAC1C,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE1C;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CACtB,SAAiB,EACjB,UAAkB,EAClB,YAAoB,EACpB,eAAe,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI;IAElC,IAAI,SAAS,GAAG,YAAY,GAAG,CAAC,UAAU,GAAG,YAAY,CAAC,GAAG,eAAe,EAAE,CAAC;QAC7E,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,SAAS,GAAG,UAAU,CAAC,CAAC,CAAA;IAC9D,CAAC;IACD,OAAO,YAAY,CAAA;AACrB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAAkB;IACrD,IAAI,OAAO,SAAS,KAAK,WAAW,IAAI,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACjF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;IACxF,CAAC;IACD,IAAI,UAAU,GAAG,CAAC;QAAE,OAAO,UAAU,CAAA;IACrC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAA;IAC/F,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAA;AAC9B,CAAC;AA8BD,MAAM,eAAe,GAA0C;IAC7D,SAAS,EAAE,IAAI;IACf,WAAW,EAAE,IAAI;IACjB,WAAW,EAAE,IAAI;CAClB,CAAA;AAED,MAAM,UAAU,mBAAmB,CAAC,UAA8B;IAChE,IAAI,QAAqC,CAAA;IAEzC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAA;IACtE,MAAM,yBAAyB,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,GAAW,EAAE,EAAE;QACtE,IAAI,QAAQ;YAAE,QAAQ,CAAC,wBAAwB,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAA;IAC5D,CAAC,CAAA;IAED,MAAM,UAAU,GAAG,CAAC,SAAiB,EAAE,UAAkB,EAAE,UAAkB,EAAU,EAAE;QACvF,MAAM,GAAG,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAA;QAC5C,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,GAAG,CAAC,CAAA;IACvE,CAAC,CAAA;IAED,MAAM,gBAAgB,GAAG,CAAC,SAAiB,EAAU,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IAC7E,MAAM,iBAAiB,GAAG,CAAC,UAAkB,EAAU,EAAE,CACvD,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC,gBAAgB,CAAC,CAAA;IAEjE,MAAM,eAAe,GAAG,CACtB,SAAiB,EACjB,UAAkB,EAClB,aAAqB,EACrB,mBAA2B,EAC3B,UAAkB,EACR,EAAE;QACZ,MAAM,GAAG,GAAG,UAAU,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC,CAAA;QACzD,MAAM,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAA;QAC7C,MAAM,UAAU,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAA;QAChD,MAAM,iBAAiB,GAAG,aAAa,GAAG,mBAAmB,CAAA;QAC7D,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,GAAG,GAAG,CAAC,GAAG,GAAG,CAAA;QAC5D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,CAAA;IAC1E,CAAC,CAAA;IAED,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,cAAc,CAC1C;QACE,mBAAmB,EAAE,CAAC;QACtB,SAAS,EAAE,CAAC;QACZ,UAAU,EAAE,CAAC;QACb,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,KAAK;KACnB,EACD;QACE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC;QACrE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;QACjD,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;QACpD,mBAAmB,EAAE,CAAC,CAAC,EAAE,EAAE,CACzB,cAAc,CAAC;YACb,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE;YACxB,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;YACpC,UAAU,EAAE,UAAU,CAAC,WAAW,EAAE;YACpC,MAAM,EAAE,UAAU,CAAC,OAAO,EAAE;YAC5B,GAAG,EAAE,CAAC;YACN,MAAM,EAAE,CAAC;YACT,IAAI,EAAE,CAAC;SACR,CAAC;KACL,CACF,CAAA;IAED,MAAM,IAAI,GAAG,QAAQ,CAAS,GAAG,EAAE;QACjC,OAAO,UAAU,CAAC;YAChB,MAAM,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,MAAM;YACpC,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE;YACnB,MAAM,EAAE,UAAU,CAAC,OAAO,EAAE;SAC7B,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,EAAE;QACjC,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAA;QACrC,OAAO,gBAAgB,CAAC;YACtB,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE;YAC/B,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE;YAC/B,UAAU,EAAE,UAAU,CAAC,WAAW,EAAE;YACpC,MAAM,EAAE,UAAU,CAAC,OAAO,EAAE;YAC5B,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE;YACnB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,IAAI,EAAE;SACb,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IACF,MAAM,aAAa,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,YAAY,EAAE,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;IAC7F,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,EAAE,CAC/B,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,mBAAmB,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC,CACvE,CAAA;IACD,MAAM,iBAAiB,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,GAAG,QAAQ,CAAC,mBAAmB,EAAE,CAAC,CAAA;IAEvF,2CAA2C;IAC3C,mDAAmD;IAEnD,IAAI,eAAe,GAAoB,IAAI,CAAA;IAC3C,MAAM,cAAc,GAAG,QAAQ,CAAW,GAAG,EAAE;QAC7C,MAAM,EAAE,GAAG,eAAe,CACxB,QAAQ,CAAC,SAAS,EAAE,EACpB,QAAQ,CAAC,UAAU,EAAE,EACrB,UAAU,EAAE,EACZ,QAAQ,CAAC,mBAAmB,EAAE,EAC9B,QAAQ,CAAC,UAAU,EAAE,CACtB,CAAA;QACD,IACE,eAAe;YACf,eAAe,CAAC,SAAS,KAAK,EAAE,CAAC,SAAS;YAC1C,eAAe,CAAC,UAAU,KAAK,EAAE,CAAC,UAAU;YAC5C,eAAe,CAAC,SAAS,KAAK,EAAE,CAAC,SAAS;YAC1C,eAAe,CAAC,UAAU,KAAK,EAAE,CAAC,UAAU;YAC5C,eAAe,CAAC,UAAU,KAAK,EAAE,CAAC,UAAU;YAC5C,eAAe,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,EAC9B,CAAC;YACD,OAAO,eAAe,CAAA;QACxB,CAAC;QACD,eAAe,GAAG,EAAE,CAAA;QACpB,OAAO,EAAE,CAAA;IACX,CAAC,CAAC,CAAA;IAEF,IAAI,mBAAmB,GAAwB,IAAI,CAAA;IACnD,MAAM,kBAAkB,GAAG,QAAQ,CAAe,GAAG,EAAE;QACrD,MAAM,EAAE,GAAG,cAAc,EAAE,CAAA;QAC3B,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAA;QAClC,MAAM,EAAE,GAAG,eAAe,CACxB,EAAE,CAAC,UAAU,EACb,EAAE,CAAC,SAAS,EACZ,IAAI,CAAC,MAAM,EACX,IAAI,EAAE,EACN,UAAU,CAAC,WAAW,EAAE,EACxB,EAAE,CAAC,GAAG,CACP,CAAA;QACD,IAAI,mBAAmB,IAAI,mBAAmB,CAAC,KAAK,KAAK,EAAE,CAAC,KAAK,IAAI,mBAAmB,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC;YACxG,OAAO,mBAAmB,CAAA;QAC5B,CAAC;QACD,mBAAmB,GAAG,EAAE,CAAA;QACxB,OAAO,EAAE,CAAA;IACX,CAAC,CAAC,CAAA;IAEF,IAAI,oBAAoB,GAAyB,IAAI,CAAA;IACrD,MAAM,mBAAmB,GAAG,QAAQ,CAAgB,GAAG,EAAE;QACvD,MAAM,EAAE,GAAG,cAAc,EAAE,CAAA;QAC3B,MAAM,EAAE,GAAG,kBAAkB,EAAE,CAAA;QAC/B,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAA;QAClC,MAAM,IAAI,GAAkB;YAC1B,SAAS,EAAE,UAAU,CAAC,UAAU,EAAE;YAClC,SAAS,EAAE,EAAE,CAAC,SAAS;YACvB,UAAU,EAAE,EAAE,CAAC,UAAU;YACzB,GAAG,EAAE,EAAE,CAAC,GAAG;YACX,WAAW,EAAE,EAAE,CAAC,KAAK;YACrB,SAAS,EAAE,EAAE,CAAC,GAAG;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI,EAAE,IAAI,EAAE;SACb,CAAA;QACD,IACE,oBAAoB;YACpB,oBAAoB,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS;YACjD,oBAAoB,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS;YACjD,oBAAoB,CAAC,UAAU,KAAK,IAAI,CAAC,UAAU;YACnD,oBAAoB,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG;YACrC,oBAAoB,CAAC,WAAW,KAAK,IAAI,CAAC,WAAW;YACrD,oBAAoB,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS;YACjD,oBAAoB,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;YAC3C,oBAAoB,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EACvC,CAAC;YACD,OAAO,oBAAoB,CAAA;QAC7B,CAAC;QACD,oBAAoB,GAAG,IAAI,CAAA;QAC3B,OAAO,IAAI,CAAA;IACb,CAAC,CAAC,CAAA;IAEF,wBAAwB;IACxB,uCAAuC;IACvC,iCAAiC;IAEjC,IAAI,eAAe,GAAwB,IAAI,CAAA;IAC/C,IAAI,WAAW,GAAwB,IAAI,CAAA;IAC3C,IAAI,eAAe,GAAwB,IAAI,CAAA;IAE/C,MAAM,sBAAsB,GAAG,CAAC,KAAa,EAAQ,EAAE;QACrD,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QACrD,KAAK,CAAC,GAAG,EAAE;YACT,OAAO,CAAC,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QAC1F,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,MAAM,iBAAiB,GAAG,GAAG,EAAE;QAC7B,MAAM,SAAS,GAAG,OAAO,EAAE,CAAC,SAAS,CAAA;QACrC,IAAI,SAAS,EAAE,CAAC;YACd,sBAAsB,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;QAC9C,CAAC;IACH,CAAC,CAAA;IAED;;;;OAIG;IACH,MAAM,eAAe,GAAG,GAAS,EAAE;QACjC,eAAe,GAAG,MAAM,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE;gBAAE,OAAM;YACnC,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAA;YACtC,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAA;YACxC,IAAI,SAAS,IAAI,CAAC,IAAI,UAAU,IAAI,CAAC;gBAAE,OAAM;YAC7C,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAA;YAC1B,aAAa,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,CAAC,CAAA;QAC3C,CAAC,CAAC,CAAA;QACF,WAAW,GAAG,MAAM,CAAC,GAAG,EAAE;YACxB,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE;gBAAE,OAAM;YACnC,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAA;YACtC,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAA;YACxC,IAAI,SAAS,IAAI,CAAC,IAAI,UAAU,IAAI,CAAC;gBAAE,OAAM;YAC7C,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAA;YAC1B,yBAAyB,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,CAAC,CAAA;QACvD,CAAC,CAAC,CAAA;QACF,eAAe,GAAG,MAAM,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE;gBAAE,OAAM;YACnC,MAAM,mBAAmB,GAAG,YAAY,EAAE,CAAA;YAC1C,MAAM,iBAAiB,GAAG,UAAU,EAAE,CAAA;YACtC,MAAM,GAAG,GAAG,OAAO,EAAE,CAAA;YACrB,IAAI,GAAG,CAAC,aAAa;gBAAE,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,mBAAmB,IAAI,CAAA;YACjF,IAAI,GAAG,CAAC,SAAS;gBAAE,GAAG,CAAC,SAAS,CAAC,UAAU,GAAG,iBAAiB,CAAA;QACjE,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,MAAM,aAAa,GAAG,CAAC,GAAW,EAAE,SAAiB,EAAE,UAAkB,EAAQ,EAAE;QACjF,MAAM,GAAG,GAAG,OAAO,EAAE,CAAA;QACrB,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,CAAA;QACnC,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,CAAA;QACnC,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW;YAAE,OAAM;QAExC,MAAM,mBAAmB,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,GAAG,CAAC,GAAG,GAAG,CAAA;QAE7D,MAAM,gBAAgB,GAAG,GAAG,mBAAmB,IAAI,CAAA;QACnD,IAAI,WAAW,CAAC,KAAK,CAAC,KAAK,KAAK,gBAAgB,EAAE,CAAC;YACjD,WAAW,CAAC,KAAK,CAAC,KAAK,GAAG,gBAAgB,CAAA;QAC5C,CAAC;QAED,MAAM,iBAAiB,GAAG,GAAG,UAAU,IAAI,CAAA;QAC3C,IAAI,WAAW,CAAC,KAAK,CAAC,MAAM,KAAK,iBAAiB,EAAE,CAAC;YACnD,WAAW,CAAC,KAAK,CAAC,MAAM,GAAG,iBAAiB,CAAA;QAC9C,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,GAAG,GAAG,CAAC,CAAA;QAC1D,IAAI,WAAW,CAAC,KAAK,KAAK,YAAY,EAAE,CAAC;YACvC,WAAW,CAAC,KAAK,GAAG,YAAY,CAAA;QAClC,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,gBAAgB,GAAG,GAAG,CAAC,CAAA;QAC5E,IAAI,WAAW,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YACvC,WAAW,CAAC,MAAM,GAAG,WAAW,CAAA;QAClC,CAAC;QAED,MAAM,aAAa,GAAG,GAAG,mBAAmB,IAAI,CAAA;QAChD,IAAI,WAAW,CAAC,KAAK,CAAC,KAAK,KAAK,aAAa,EAAE,CAAC;YAC9C,WAAW,CAAC,KAAK,CAAC,KAAK,GAAG,aAAa,CAAA;QACzC,CAAC;QAED,MAAM,cAAc,GAAG,GAAG,WAAW,GAAG,GAAG,IAAI,CAAA;QAC/C,IAAI,WAAW,CAAC,KAAK,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;YAChD,WAAW,CAAC,KAAK,CAAC,MAAM,GAAG,cAAc,CAAA;QAC3C,CAAC;IACH,CAAC,CAAA;IAED,+BAA+B;IAE/B,8CAA8C;IAC9C,MAAM,cAAc,GAAG;QACrB,GAAG,QAAQ;QACX,YAAY;QACZ,aAAa;QACb,UAAU;QACV,iBAAiB;QACjB,IAAI;QACJ,QAAQ,EAAE,cAAc;QACxB,YAAY,EAAE,kBAAkB;QAChC,aAAa,EAAE,mBAAmB;KACnC,CAAA;IAED,OAAO;QACL,QAAQ,EAAE,cAAc;QAExB,UAAU,CAAC,IAAqB;YAC9B,QAAQ,GAAG,IAAI,CAAA;QACjB,CAAC;QAED,OAAO,EAAE;YACP;;;;;;eAMG;YACH,QAAQ,CAAC,CAAS;gBAChB,sBAAsB,CAAC,CAAC,CAAC,CAAA;YAC3B,CAAC;YAED;;;;eAIG;YACH,iBAAiB;gBACf,iBAAiB,EAAE,CAAA;YACrB,CAAC;YAED;;;;;;;;;eASG;YACH,MAAM,CAAC,KAAa,EAAE,MAAc,EAAE,GAAW;gBAC/C,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;gBACzD,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;gBAC3D,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;gBACxC,KAAK,CAAC,GAAG,EAAE;oBACT,IAAI,OAAO,CAAC,mBAAmB,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;wBACtD,OAAO,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;oBACpC,CAAC;oBACD,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;oBACxB,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;oBACzB,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;gBAC3B,CAAC,CAAC,CAAA;YACJ,CAAC;YAED;;;;;eAKG;YACH,IAAI;gBACF,IAAI,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE;oBAAE,OAAM;gBACtC,IAAI,CAAC,QAAQ;oBAAE,OAAM;gBACrB,MAAM,SAAS,GAAG,OAAO,EAAE,CAAC,SAAS,CAAA;gBACrC,IAAI,CAAC,SAAS;oBAAE,OAAM;gBACtB,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;gBAC7B,sBAAsB,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;gBAC5C,eAAe,EAAE,CAAA;YACnB,CAAC;SACF;QAED;;;;;WAKG;QACH,OAAO;YACL,eAAe,EAAE,EAAE,CAAA;YACnB,WAAW,EAAE,EAAE,CAAA;YACf,eAAe,EAAE,EAAE,CAAA;YACnB,eAAe,GAAG,IAAI,CAAA;YACtB,WAAW,GAAG,IAAI,CAAA;YAClB,eAAe,GAAG,IAAI,CAAA;YACtB,KAAK,CAAC,GAAG,EAAE;gBACT,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;gBAC9B,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;gBACzB,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;gBACxB,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;gBACzB,OAAO,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;YACpC,CAAC,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/engine/state/zoomState.d.ts

@@ -0,0 +1,22 @@
+import { type ReadonlySignal } from '../../foundation/reactivity/signal';
+export interface ZoomDeps {
+    minKWidth$: ReadonlySignal<number>;
+    maxKWidth$: ReadonlySignal<number>;
+    zoomLevelCount: number;
+}
+export declare function createZoomState(deps: ZoomDeps): {
+    readonly: {
+        zoomLevel: ReadonlySignal<number>;
+        kWidthOverride: ReadonlySignal<number | null>;
+    } & {
+        kWidth: ReadonlySignal<number>;
+    };
+    actions: {
+        setZoomLevel(level: number): void;
+        setDirectKWidth(kWidth: number): void;
+        clearDirectKWidth(): void;
+    };
+    dispose(): void;
+};
+export type ZoomStateModule = ReturnType<typeof createZoomState>;
+//# sourceMappingURL=zoomState.d.ts.map

package/dist/engine/state/zoomState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zoomState.d.ts","sourceRoot":"","sources":["../../../src/engine/state/zoomState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,cAAc,EAAE,MAAM,oCAAoC,CAAA;AAG/F,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,cAAc,CAAC,MAAM,CAAC,CAAA;IAClC,UAAU,EAAE,cAAc,CAAC,MAAM,CAAC,CAAA;IAClC,cAAc,EAAE,MAAM,CAAA;CACvB;AAgBD,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ;;;;;;;;4BAmBpB,MAAM;gCAQF,MAAM;;;;EAiBnC;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAA"}

package/dist/engine/state/zoomState.js

@@ -0,0 +1,54 @@
+import { batch, createSubState } from '../../foundation/reactivity/signal';
+import { zoomLevelToKWidth } from '../utils/zoom';
+function readZoomConfig(deps) {
+    return {
+        minKWidth: deps.minKWidth$(),
+        maxKWidth: deps.maxKWidth$(),
+        zoomLevelCount: deps.zoomLevelCount,
+    };
+}
+function clampZoomLevel(level, zoomLevelCount) {
+    const count = Math.max(2, Math.round(zoomLevelCount));
+    const rounded = Number.isFinite(level) ? Math.round(level) : 1;
+    return Math.max(1, Math.min(count, rounded));
+}
+export function createZoomState(deps) {
+    const { signals, readonly } = createSubState({
+        zoomLevel: 1,
+        kWidthOverride: null,
+    }, {
+        kWidth: (s) => {
+            const override = s.kWidthOverride();
+            if (override !== null)
+                return override;
+            return zoomLevelToKWidth(s.zoomLevel(), readZoomConfig(deps));
+        },
+    });
+    return {
+        readonly,
+        actions: {
+            setZoomLevel(level) {
+                const clamped = clampZoomLevel(level, deps.zoomLevelCount);
+                batch(() => {
+                    signals.zoomLevel.set(clamped);
+                    signals.kWidthOverride.set(null);
+                });
+            },
+            setDirectKWidth(kWidth) {
+                if (!Number.isFinite(kWidth) || kWidth <= 0)
+                    return;
+                signals.kWidthOverride.set(kWidth);
+            },
+            clearDirectKWidth() {
+                signals.kWidthOverride.set(null);
+            },
+        },
+        dispose() {
+            batch(() => {
+                signals.zoomLevel.set(1);
+                signals.kWidthOverride.set(null);
+            });
+        },
+    };
+}
+//# sourceMappingURL=zoomState.js.map

package/dist/engine/state/zoomState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zoomState.js","sourceRoot":"","sources":["../../../src/engine/state/zoomState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,cAAc,EAAuB,MAAM,oCAAoC,CAAA;AAC/F,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAQjD,SAAS,cAAc,CAAC,IAAc;IACpC,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE;QAC5B,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE;QAC5B,cAAc,EAAE,IAAI,CAAC,cAAc;KACpC,CAAA;AACH,CAAC;AAED,SAAS,cAAc,CAAC,KAAa,EAAE,cAAsB;IAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAA;IACrD,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC9D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAA;AAC9C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAc;IAC5C,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,cAAc,CAC1C;QACE,SAAS,EAAE,CAAC;QACZ,cAAc,EAAE,IAAqB;KACtC,EACD;QACE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE;YACZ,MAAM,QAAQ,GAAG,CAAC,CAAC,cAAc,EAAE,CAAA;YACnC,IAAI,QAAQ,KAAK,IAAI;gBAAE,OAAO,QAAQ,CAAA;YACtC,OAAO,iBAAiB,CAAC,CAAC,CAAC,SAAS,EAAE,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC,CAAA;QAC/D,CAAC;KACF,CACF,CAAA;IAED,OAAO;QACL,QAAQ;QAER,OAAO,EAAE;YACP,YAAY,CAAC,KAAa;gBACxB,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,CAAA;gBAC1D,KAAK,CAAC,GAAG,EAAE;oBACT,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;oBAC9B,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;gBAClC,CAAC,CAAC,CAAA;YACJ,CAAC;YAED,eAAe,CAAC,MAAc;gBAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC;oBAAE,OAAM;gBACnD,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YACpC,CAAC;YAED,iBAAiB;gBACf,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YAClC,CAAC;SACF;QAED,OAAO;YACL,KAAK,CAAC,GAAG,EAAE;gBACT,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;gBACxB,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YAClC,CAAC,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/engine/subPaneManager.d.ts

@@ -1,29 +1,30 @@
-import type { RendererPlugin, RendererPluginWithHost, RenderContext } from '../plugin';
-import { type Signal } from '../reactivity/signal';
-import type { Layer } from '../scene/types';
-import type { PaneSpec } from './chartTypes';
+import type { RendererPlugin, RendererPluginWithHost, RenderContext } from '../foundation/plugin/index';
+import type { Layer } from '../rendering/scene/types';
 import type { IndicatorScheduler } from './indicators/scheduler';
-import type { SubIndicatorType } from './renderers/Indicator';
-export interface SubPaneEntry {
-    paneId: string;
-    indicatorId: SubIndicatorType;
-    params: Record<string, unknown>;
-    rendererName: string;
-    scaleRendererName: string;
-    paneTitleRendererName: string;
-    layerId: string;
-    scaleLayerId: string;
-    paneTitleLayerId: string;
+import type { SubPaneSpec } from './state/subPaneState';
+export interface SubPaneResources {
+    readonly paneId: string;
+    readonly rendererName: string;
+    readonly scaleRendererName: string;
+    readonly paneTitleRendererName: string;
+    readonly layerId: string;
+    readonly scaleLayerId: string;
+    readonly paneTitleLayerId: string;
+}
+export interface SubPaneEntry extends SubPaneSpec {
+    readonly rendererName?: string;
+    readonly scaleRendererName?: string;
+    readonly paneTitleRendererName?: string;
+    readonly layerId?: string;
+    readonly scaleLayerId?: string;
+    readonly paneTitleLayerId?: string;
 }
 export interface SubPaneContext {
     getIndicatorScheduler: () => IndicatorScheduler;
-    hasPane: (paneId: string) => boolean;
-    upsertPane: (def: PaneSpec) => void;
     getRenderer: <T extends RendererPlugin = RendererPlugin>(name: string) => T | undefined;
     useRenderer: (plugin: RendererPlugin | RendererPluginWithHost, config?: Record<string, unknown>) => void;
     removeRenderer: (name: string) => void;
     setRendererEnabled: (name: string, enabled: boolean) => void;
-    removePaneDefinition: (paneId: string) => void;
     updateRendererConfig: (name: string, config: Record<string, unknown>) => void;
     getRightAxisWidth: () => number;
     getPriceLabelWidth: () => number;
@@ -40,22 +41,19 @@ export interface SubPaneContext {
     setLayerVisibility: (id: string, visible: boolean) => void;
     getRenderContext: (paneId: string) => RenderContext | null;
 }
+/** 副图 renderer/layer 的 runtime projection，不持有业务 Signal。 */
 export declare class SubPaneManager {
-    private entries;
-    private _entriesSignal;
-    get entriesSignal(): Signal<ReadonlyArray<SubPaneEntry>>;
-    private syncEntriesSignal;
-    create(ctx: SubPaneContext, paneId: string, indicatorId: SubIndicatorType, params: Record<string, unknown>): boolean;
-    remove(ctx: SubPaneContext, paneId: string): void;
-    replaceIndicator(ctx: SubPaneContext, paneId: string, newIndicatorId: SubIndicatorType, newParams: Record<string, unknown>): void;
-    updateParams(ctx: SubPaneContext, paneId: string, params: Record<string, unknown>): void;
-    getByPaneId(paneId: string): SubPaneEntry | undefined;
-    private createIndicatorRenderer;
-    getAll(): SubPaneEntry[];
-    getPaneIds(): string[];
+    private readonly mounted;
+    reconcile(ctx: SubPaneContext, desired: ReadonlyArray<SubPaneSpec>): boolean;
+    getMountedResources(paneId: string): SubPaneResources | undefined;
     clear(ctx: SubPaneContext): void;
-    private syncSchedulerConfig;
+    private describeEntry;
+    private mount;
     private mountScaleRenderer;
     private mountPaneTitleRenderer;
+    private updateParams;
+    private unmount;
+    private invalidateProjection;
+    private syncSchedulerConfig;
 }
 //# sourceMappingURL=subPaneManager.d.ts.map

package/dist/engine/subPaneManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subPaneManager.d.ts","sourceRoot":"","sources":["../../src/engine/subPaneManager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"subPaneManager.d.ts","sourceRoot":"","sources":["../../src/engine/subPaneManager.ts"],"names":[],"mappings":"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"}