@363045841yyt/klinechart-core 0.7.3

package/dist/engine/utils/tickPosition.js

@@ -0,0 +1,141 @@
+import { calculateTickCount } from './tickCount';
+import { fromLog, logFormulaForPriceRange, toLog } from '../scale/logFormula';
+export function calculateTickPositions(options) {
+    const { height, paddingTop, paddingBottom, isMain, hideEdgeTicks } = options;
+    const yStart = paddingTop;
+    const yEnd = Math.max(paddingTop, height - paddingBottom);
+    const viewH = Math.max(0, yEnd - yStart);
+    const ticks = calculateTickCount(height, isMain);
+    const positions = [];
+    for (let i = 0; i < ticks; i++) {
+        if (hideEdgeTicks && (i === 0 || i === ticks - 1))
+            continue;
+        const t = ticks <= 1 ? 0 : i / (ticks - 1);
+        const y = yStart + t * viewH;
+        positions.push({ index: i, t, y });
+    }
+    return positions;
+}
+const LOG_EPSILON = 1e-10;
+const LOG_ROUND_CANDIDATES = [1, 1.2, 1.5, 2, 2.5, 3, 4, 5, 6, 7.5, 8, 10];
+function roundLogTickValue(value) {
+    if (!Number.isFinite(value) || value <= 0) {
+        return value;
+    }
+    const exp = Math.floor(Math.log10(value));
+    const magnitude = Math.pow(10, exp);
+    const normalized = value / magnitude;
+    let best = LOG_ROUND_CANDIDATES[0];
+    let minDiff = Infinity;
+    for (const candidate of LOG_ROUND_CANDIDATES) {
+        const diff = Math.abs(candidate - normalized);
+        if (diff < minDiff) {
+            minDiff = diff;
+            best = candidate;
+        }
+    }
+    return best * magnitude;
+}
+function generatePixelUniformLogTicks(options) {
+    const { height, paddingTop, paddingBottom, valueMin, valueMax, targetCount } = options;
+    const effectiveMin = Math.max(valueMin, LOG_EPSILON);
+    const effectiveMax = Math.max(valueMax, effectiveMin * 1.001);
+    const yStart = paddingTop;
+    const yEnd = Math.max(paddingTop, height - paddingBottom);
+    const viewH = Math.max(0, yEnd - yStart);
+    if (viewH <= 0) {
+        return [];
+    }
+    const formula = logFormulaForPriceRange({ minPrice: effectiveMin, maxPrice: effectiveMax });
+    const logMin = toLog(effectiveMin, formula);
+    const logMax = toLog(effectiveMax, formula);
+    const logRange = logMax - logMin;
+    if (!Number.isFinite(logRange) || Math.abs(logRange) < 1e-10) {
+        return [];
+    }
+    const total = Math.max(2, targetCount);
+    const spacingPx = total <= 1 ? viewH : viewH / (total - 1);
+    const minSpacingPx = spacingPx * 0.6;
+    const maxRoundShiftPx = spacingPx * 0.15;
+    const positions = [];
+    let prevY = null;
+    for (let i = 0; i < total; i++) {
+        const idealT = total <= 1 ? 0 : i / (total - 1);
+        const idealY = yStart + idealT * viewH;
+        const logical = logMax - idealT * logRange;
+        const rawValue = fromLog(logical, formula);
+        let value = rawValue;
+        let t = idealT;
+        let y = idealY;
+        const roundedValue = roundLogTickValue(rawValue);
+        if (Number.isFinite(roundedValue) && roundedValue > 0) {
+            const roundedLogical = toLog(roundedValue, formula);
+            const roundedT = (logMax - roundedLogical) / logRange;
+            const roundedY = yStart + roundedT * viewH;
+            if (Number.isFinite(roundedY) && Math.abs(roundedY - idealY) <= maxRoundShiftPx) {
+                value = roundedValue;
+                t = roundedT;
+                y = roundedY;
+            }
+        }
+        if (y < yStart - 0.5 || y > yEnd + 0.5) {
+            continue;
+        }
+        if (prevY !== null && Math.abs(y - prevY) < minSpacingPx) {
+            continue;
+        }
+        positions.push({ index: positions.length, t, y, value });
+        prevY = y;
+    }
+    return positions;
+}
+// calculateValueTickPositions 缓存
+let _cvtpCacheKey = '';
+let _cvtpCacheResult = [];
+function buildCvtpCacheKey(options) {
+    return `${options.valueMin}:${options.valueMax}:${options.height}:${options.paddingTop}:${options.paddingBottom}:${options.isMain}:${options.scaleType ?? 'linear'}:${options.hideEdgeTicks ?? false}`;
+}
+export function calculateValueTickPositions(options) {
+    // 缓存命中：所有参数相同则直接返回
+    const key = buildCvtpCacheKey(options);
+    if (key === _cvtpCacheKey)
+        return _cvtpCacheResult;
+    const { valueMin, valueMax, scaleType = 'linear' } = options;
+    if (scaleType === 'log') {
+        if (valueMin <= 0) {
+            // 递归调用走线性路径，线性路径会更新缓存
+            return calculateValueTickPositions({ ...options, scaleType: 'linear' });
+        }
+        const effectiveMin = Math.max(valueMin, LOG_EPSILON);
+        const effectiveMax = Math.max(valueMax, effectiveMin * 1.001);
+        const { height, paddingTop, paddingBottom, isMain, hideEdgeTicks } = options;
+        const targetCount = Math.max(2, calculateTickCount(height, isMain));
+        let positions = generatePixelUniformLogTicks({
+            height,
+            paddingTop,
+            paddingBottom,
+            valueMin: effectiveMin,
+            valueMax: effectiveMax,
+            targetCount,
+        });
+        if (hideEdgeTicks && positions.length > 2) {
+            positions = positions.slice(1, -1);
+        }
+        const result = positions.map((position, index) => ({ ...position, index }));
+        _cvtpCacheKey = key;
+        _cvtpCacheResult = result;
+        return result;
+    }
+    const basePositions = calculateTickPositions(options);
+    const totalTicks = calculateTickCount(options.height, options.isMain);
+    const valueRange = valueMax - valueMin || 1;
+    const result = basePositions.map((pos) => {
+        const step = valueRange / Math.max(1, totalTicks - 1);
+        const value = valueMax - step * pos.index;
+        return { ...pos, value };
+    });
+    _cvtpCacheKey = key;
+    _cvtpCacheResult = result;
+    return result;
+}
+//# sourceMappingURL=tickPosition.js.map

package/dist/engine/utils/tickPosition.js.map

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

package/dist/engine/utils/zoom.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 缩放计算纯函数
+ * 无副作用、无 DOM 访问，供 Vue 层直接调用
+ */
+export interface ZoomConfig {
+    minKWidth: number;
+    maxKWidth: number;
+    zoomLevelCount: number;
+    dpr: number;
+}
+export interface ZoomResult {
+    targetLevel: number;
+    newKWidth: number;
+    newKGap: number;
+    newScrollLeft: number;
+}
+/** 将缩放级别转换为 K 线宽度（逻辑像素） */
+export declare function zoomLevelToKWidth(level: number, config: ZoomConfig): number;
+/** 根据K线宽度和DPR推导间隙（逻辑像素），K线越窄间距越小 */
+export declare function kGapFromKWidth(kWidth: number, dpr: number): number;
+/**
+ * 缩放一级（+1 放大 / -1 缩小）
+ * 返回新状态或 null（已达边界）
+ */
+export declare function computeZoom(delta: number, mouseX: number, scrollLeft: number, currentLevel: number, currentKWidth: number, currentKGap: number, config: ZoomConfig): ZoomResult | null;
+/**
+ * 缩放到指定级别
+ * 返回新状态或 null（级别不变或无效）
+ */
+export declare function computeZoomToLevel(targetLevel: number, anchorX: number, scrollLeft: number, currentLevel: number, currentKWidth: number, currentKGap: number, config: ZoomConfig): ZoomResult | null;
+//# sourceMappingURL=zoom.d.ts.map

package/dist/engine/utils/zoom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zoom.d.ts","sourceRoot":"","sources":["../../../src/engine/utils/zoom.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;CACtB;AAID,2BAA2B;AAC3B,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAG3E;AAED,oCAAoC;AACpC,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAIlE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,UAAU,GACjB,UAAU,GAAG,IAAI,CAenB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,UAAU,GACjB,UAAU,GAAG,IAAI,CAKnB"}

package/dist/engine/utils/zoom.js

@@ -0,0 +1,43 @@
+import { getPhysicalKLineConfig } from './klineConfig';
+const PHYS_K_GAP_MAX = 3;
+/** 将缩放级别转换为 K 线宽度（逻辑像素） */
+export function zoomLevelToKWidth(level, config) {
+    const t = (level - 1) / (config.zoomLevelCount - 1);
+    return config.minKWidth + t * (config.maxKWidth - config.minKWidth);
+}
+/** 根据K线宽度和DPR推导间隙（逻辑像素），K线越窄间距越小 */
+export function kGapFromKWidth(kWidth, dpr) {
+    const kWidthPx = Math.round(kWidth * dpr);
+    const kGapPx = Math.max(1, Math.min(PHYS_K_GAP_MAX, Math.round(kWidthPx * 0.6)));
+    return kGapPx / dpr;
+}
+/**
+ * 缩放一级（+1 放大 / -1 缩小）
+ * 返回新状态或 null（已达边界）
+ */
+export function computeZoom(delta, mouseX, scrollLeft, currentLevel, currentKWidth, currentKGap, config) {
+    const targetLevel = Math.max(1, Math.min(config.zoomLevelCount, currentLevel + delta));
+    if (targetLevel === currentLevel)
+        return null;
+    const newKWidth = zoomLevelToKWidth(targetLevel, config);
+    const newKGap = kGapFromKWidth(newKWidth, config.dpr);
+    const oldConfig = getPhysicalKLineConfig(currentKWidth, currentKGap, config.dpr);
+    const newConfig = getPhysicalKLineConfig(newKWidth, newKGap, config.dpr);
+    const anchorWorldPx = Math.round((scrollLeft + mouseX) * config.dpr);
+    const anchorSlotFloat = (anchorWorldPx - oldConfig.startXPx) / oldConfig.unitPx;
+    const newAnchorWorldPx = newConfig.startXPx + anchorSlotFloat * newConfig.unitPx;
+    const newScrollLeft = newAnchorWorldPx / config.dpr - mouseX;
+    return { targetLevel, newKWidth, newKGap, newScrollLeft };
+}
+/**
+ * 缩放到指定级别
+ * 返回新状态或 null（级别不变或无效）
+ */
+export function computeZoomToLevel(targetLevel, anchorX, scrollLeft, currentLevel, currentKWidth, currentKGap, config) {
+    const clamped = Math.max(1, Math.min(config.zoomLevelCount, Math.round(targetLevel)));
+    const delta = clamped - currentLevel;
+    if (delta === 0)
+        return null;
+    return computeZoom(delta, anchorX, scrollLeft, currentLevel, currentKWidth, currentKGap, config);
+}
+//# sourceMappingURL=zoom.js.map

package/dist/engine/utils/zoom.js.map

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

package/dist/engine/viewport/viewport.d.ts

@@ -0,0 +1,32 @@
+import type { KLineData } from '../../types/price';
+import type { PriceRange } from '../scale/price';
+/**
+ * 计算当前视口可见的 K 线索引范围（使用物理像素对齐）。
+ *
+ * - 所有计算在物理像素空间进行，确保与 calcKLinePositions 一致
+ * - 会额外在左右各扩展 1 根（start-1/end+1），用于避免边缘裁剪带来的”断线/缺一根”观感
+ *
+ * @param scrollLeft 容器当前横向滚动量（逻辑像素）
+ * @param viewWidth  绘图区域宽度（plotWidth，逻辑像素，不含右侧 yAxis）
+ * @param kWidth     单根 K 线宽度（逻辑像素）
+ * @param kGap       K 线间距（逻辑像素）
+ * @param totalDataCount 数据总条数
+ * @param dpr        设备像素比
+ */
+export declare function getVisibleRange(scrollLeft: number, viewWidth: number, kWidth: number, kGap: number, totalDataCount: number, dpr?: number): {
+    start: number;
+    end: number;
+};
+/**
+ * 计算指定索引区间内的价格范围（max/min）。
+ *
+ * 主要用途：
+ * - 为 pane 的 y 轴缩放与刻度提供 priceRange
+ * - 为渲染器（网格线、极值标注等）提供可视区参考范围
+ *
+ * 注意：
+ * - `endIndex` 为开区间（不包含）
+ * - 若区间内无有效数据，会返回兜底范围 `{ maxPrice: 100, minPrice: 0 }`
+ */
+export declare function getVisiblePriceRange(data: KLineData[], startIndex: number, endIndex: number): PriceRange;
+//# sourceMappingURL=viewport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.d.ts","sourceRoot":"","sources":["../../../src/engine/viewport/viewport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAGhD;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC3B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,GAAG,GAAE,MAAU,GAChB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAahC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAgBxG"}

package/dist/engine/viewport/viewport.js

@@ -0,0 +1,54 @@
+import { getPhysicalKLineConfig } from '../utils/klineConfig';
+/**
+ * 计算当前视口可见的 K 线索引范围（使用物理像素对齐）。
+ *
+ * - 所有计算在物理像素空间进行，确保与 calcKLinePositions 一致
+ * - 会额外在左右各扩展 1 根（start-1/end+1），用于避免边缘裁剪带来的”断线/缺一根”观感
+ *
+ * @param scrollLeft 容器当前横向滚动量（逻辑像素）
+ * @param viewWidth  绘图区域宽度（plotWidth，逻辑像素，不含右侧 yAxis）
+ * @param kWidth     单根 K 线宽度（逻辑像素）
+ * @param kGap       K 线间距（逻辑像素）
+ * @param totalDataCount 数据总条数
+ * @param dpr        设备像素比
+ */
+export function getVisibleRange(scrollLeft, viewWidth, kWidth, kGap, totalDataCount, dpr = 1) {
+    // 使用统一的物理像素配置，确保与 calcKLinePositions 完全一致
+    const { unitPx, startXPx } = getPhysicalKLineConfig(kWidth, kGap, dpr);
+    // scrollLeft 和 viewWidth 转换到物理像素空间
+    const scrollLeftPx = scrollLeft * dpr;
+    const viewWidthPx = viewWidth * dpr;
+    // 计算可见范围（物理像素空间整数运算）
+    const start = Math.max(0, Math.floor((scrollLeftPx - startXPx) / unitPx) - 1);
+    const end = Math.min(totalDataCount, Math.ceil((scrollLeftPx + viewWidthPx - startXPx) / unitPx) + 1);
+    return { start, end };
+}
+/**
+ * 计算指定索引区间内的价格范围（max/min）。
+ *
+ * 主要用途：
+ * - 为 pane 的 y 轴缩放与刻度提供 priceRange
+ * - 为渲染器（网格线、极值标注等）提供可视区参考范围
+ *
+ * 注意：
+ * - `endIndex` 为开区间（不包含）
+ * - 若区间内无有效数据，会返回兜底范围 `{ maxPrice: 100, minPrice: 0 }`
+ */
+export function getVisiblePriceRange(data, startIndex, endIndex) {
+    let maxPrice = -Infinity;
+    let minPrice = Infinity;
+    for (let i = startIndex; i < endIndex && i < data.length; i++) {
+        const e = data[i];
+        if (!e)
+            continue;
+        if (e.high > maxPrice)
+            maxPrice = e.high;
+        if (e.low < minPrice)
+            minPrice = e.low;
+    }
+    if (!Number.isFinite(maxPrice) || !Number.isFinite(minPrice)) {
+        return { maxPrice: 100, minPrice: 0 };
+    }
+    return { maxPrice, minPrice };
+}
+//# sourceMappingURL=viewport.js.map

package/dist/engine/viewport/viewport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.js","sourceRoot":"","sources":["../../../src/engine/viewport/viewport.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAE7D;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAC3B,UAAkB,EAClB,SAAiB,EACjB,MAAc,EACd,IAAY,EACZ,cAAsB,EACtB,MAAc,CAAC;IAEf,0CAA0C;IAC1C,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,sBAAsB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IAEtE,mCAAmC;IACnC,MAAM,YAAY,GAAG,UAAU,GAAG,GAAG,CAAA;IACrC,MAAM,WAAW,GAAG,SAAS,GAAG,GAAG,CAAA;IAEnC,qBAAqB;IACrB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,GAAG,QAAQ,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;IAC7E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;IAErG,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAA;AACzB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAiB,EAAE,UAAkB,EAAE,QAAgB;IACxF,IAAI,QAAQ,GAAG,CAAC,QAAQ,CAAA;IACxB,IAAI,QAAQ,GAAG,QAAQ,CAAA;IAEvB,KAAK,IAAI,CAAC,GAAG,UAAU,EAAE,CAAC,GAAG,QAAQ,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5D,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,IAAI,CAAC,CAAC;YAAE,SAAQ;QAChB,IAAI,CAAC,CAAC,IAAI,GAAG,QAAQ;YAAE,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAA;QACxC,IAAI,CAAC,CAAC,GAAG,GAAG,QAAQ;YAAE,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAA;IAC1C,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3D,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAA;IACzC,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAA;AACjC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './reactivity';
+export * from './controllers';
+export { VERSION } from './version';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from './reactivity';
+export * from './controllers';
+export { VERSION } from './version';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA"}

package/dist/plugin/ConfigManager.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 配置管理器
+ */
+export declare class ConfigManager {
+    private configs;
+    private defaults;
+    /**
+     * 注册插件的默认配置
+     */
+    registerDefaults(pluginName: string, defaults: Record<string, unknown>): void;
+    /**
+     * 获取配置
+     */
+    get<K = unknown>(pluginName: string, key: string, defaultValue?: K): K;
+    /**
+     * 设置配置
+     */
+    set(pluginName: string, key: string, value: unknown): void;
+    /**
+     * 批量设置配置
+     */
+    setAll(pluginName: string, config: Record<string, unknown>): void;
+    /**
+     * 获取插件所有配置
+     */
+    getAll(pluginName: string): Record<string, unknown>;
+    /**
+     * 清除插件配置
+     */
+    clear(pluginName?: string): void;
+}
+//# sourceMappingURL=ConfigManager.d.ts.map

package/dist/plugin/ConfigManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigManager.d.ts","sourceRoot":"","sources":["../../src/plugin/ConfigManager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,QAAQ,CAAkD;IAElE;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAiB7E;;OAEG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC;IAetE;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAO1D;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAMjE;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAUnD;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;CASjC"}

package/dist/plugin/ConfigManager.js

@@ -0,0 +1,81 @@
+/**
+ * 配置管理器
+ */
+export class ConfigManager {
+    configs = new Map();
+    defaults = new Map();
+    /**
+     * 注册插件的默认配置
+     */
+    registerDefaults(pluginName, defaults) {
+        this.defaults.set(pluginName, { ...defaults });
+        // 初始化配置
+        if (!this.configs.has(pluginName)) {
+            this.configs.set(pluginName, new Map());
+        }
+        // 应用默认值
+        const config = this.configs.get(pluginName);
+        for (const [key, value] of Object.entries(defaults)) {
+            if (!config.has(key)) {
+                config.set(key, value);
+            }
+        }
+    }
+    /**
+     * 获取配置
+     */
+    get(pluginName, key, defaultValue) {
+        const pluginConfig = this.configs.get(pluginName);
+        if (pluginConfig?.has(key)) {
+            return pluginConfig.get(key);
+        }
+        // 尝试默认值
+        const defaults = this.defaults.get(pluginName);
+        if (defaults && key in defaults) {
+            return defaults[key];
+        }
+        return defaultValue;
+    }
+    /**
+     * 设置配置
+     */
+    set(pluginName, key, value) {
+        if (!this.configs.has(pluginName)) {
+            this.configs.set(pluginName, new Map());
+        }
+        this.configs.get(pluginName).set(key, value);
+    }
+    /**
+     * 批量设置配置
+     */
+    setAll(pluginName, config) {
+        for (const [key, value] of Object.entries(config)) {
+            this.set(pluginName, key, value);
+        }
+    }
+    /**
+     * 获取插件所有配置
+     */
+    getAll(pluginName) {
+        const config = this.configs.get(pluginName);
+        const defaults = this.defaults.get(pluginName) || {};
+        return {
+            ...defaults,
+            ...(config ? Object.fromEntries(config) : {}),
+        };
+    }
+    /**
+     * 清除插件配置
+     */
+    clear(pluginName) {
+        if (pluginName) {
+            this.configs.delete(pluginName);
+            this.defaults.delete(pluginName);
+        }
+        else {
+            this.configs.clear();
+            this.defaults.clear();
+        }
+    }
+}
+//# sourceMappingURL=ConfigManager.js.map

package/dist/plugin/ConfigManager.js.map

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

package/dist/plugin/EventBus.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 事件总线实现
+ */
+import type { EventHandler } from './types';
+export declare class EventBus {
+    private listeners;
+    /**
+     * 订阅事件
+     */
+    on<T = unknown>(event: string, handler: EventHandler<T>): void;
+    /**
+     * 取消订阅
+     */
+    off<T = unknown>(event: string, handler: EventHandler<T>): void;
+    /**
+     * 发布事件
+     */
+    emit<T = unknown>(event: string, data: T): void;
+    /**
+     * 订阅一次性事件
+     *
+     * 注册一个仅在事件首次触发时执行的回调。回调执行后会自动从监听队列中移除，
+     * 确保后续相同事件的 emit 不会再触发该逻辑。
+     *
+     * @param event - 事件名称
+     * @param handler - 待执行的回调函数
+     */
+    once<T = unknown>(event: string, handler: EventHandler<T>): void;
+    /**
+     * 清除所有事件监听
+     */
+    clear(): void;
+    /**
+     * 获取事件的监听器数量
+     */
+    listenerCount(event: string): number;
+}
+//# sourceMappingURL=EventBus.d.ts.map

package/dist/plugin/EventBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBus.d.ts","sourceRoot":"","sources":["../../src/plugin/EventBus.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAI3C,qBAAa,QAAQ;IACnB,OAAO,CAAC,SAAS,CAAsB;IAEvC;;OAEG;IACH,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAO9D;;OAEG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAO/D;;OAEG;IACH,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAa/C;;;;;;;;OAQG;IACH,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAQhE;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAGrC"}

package/dist/plugin/EventBus.js

@@ -0,0 +1,66 @@
+export class EventBus {
+    listeners = new Map();
+    /**
+     * 订阅事件
+     */
+    on(event, handler) {
+        if (!this.listeners.has(event)) {
+            this.listeners.set(event, new Set());
+        }
+        this.listeners.get(event).add(handler);
+    }
+    /**
+     * 取消订阅
+     */
+    off(event, handler) {
+        const handlers = this.listeners.get(event);
+        if (handlers) {
+            handlers.delete(handler);
+        }
+    }
+    /**
+     * 发布事件
+     */
+    emit(event, data) {
+        const handlers = this.listeners.get(event);
+        if (handlers) {
+            handlers.forEach((handler) => {
+                try {
+                    handler(data);
+                }
+                catch (error) {
+                    console.error(`[EventBus] Error in handler for "${event}":`, error);
+                }
+            });
+        }
+    }
+    /**
+     * 订阅一次性事件
+     *
+     * 注册一个仅在事件首次触发时执行的回调。回调执行后会自动从监听队列中移除，
+     * 确保后续相同事件的 emit 不会再触发该逻辑。
+     *
+     * @param event - 事件名称
+     * @param handler - 待执行的回调函数
+     */
+    once(event, handler) {
+        const wrapper = (data) => {
+            this.off(event, wrapper);
+            handler(data);
+        };
+        this.on(event, wrapper);
+    }
+    /**
+     * 清除所有事件监听
+     */
+    clear() {
+        this.listeners.clear();
+    }
+    /**
+     * 获取事件的监听器数量
+     */
+    listenerCount(event) {
+        return this.listeners.get(event)?.size ?? 0;
+    }
+}
+//# sourceMappingURL=EventBus.js.map

package/dist/plugin/EventBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBus.js","sourceRoot":"","sources":["../../src/plugin/EventBus.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,QAAQ;IACX,SAAS,GAAa,IAAI,GAAG,EAAE,CAAA;IAEvC;;OAEG;IACH,EAAE,CAAc,KAAa,EAAE,OAAwB;QACrD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,CAAA;QACtC,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,OAAuB,CAAC,CAAA;IACzD,CAAC;IAED;;OAEG;IACH,GAAG,CAAc,KAAa,EAAE,OAAwB;QACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAC1C,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,MAAM,CAAC,OAAuB,CAAC,CAAA;QAC1C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,CAAc,KAAa,EAAE,IAAO;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAC1C,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC3B,IAAI,CAAC;oBACH,OAAO,CAAC,IAAI,CAAC,CAAA;gBACf,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,KAAK,CAAC,oCAAoC,KAAK,IAAI,EAAE,KAAK,CAAC,CAAA;gBACrE,CAAC;YACH,CAAC,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CAAc,KAAa,EAAE,OAAwB;QACvD,MAAM,OAAO,GAAoB,CAAC,IAAI,EAAE,EAAE;YACxC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;YACxB,OAAO,CAAC,IAAI,CAAC,CAAA;QACf,CAAC,CAAA;QACD,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IACzB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAA;IACxB,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,KAAa;QACzB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,CAAA;IAC7C,CAAC;CACF"}

package/dist/plugin/HookSystem.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Hook 钩子系统实现
+ */
+import type { HookCallOptions, HookFn } from './types';
+export declare class HookSystem {
+    private hooks;
+    /**
+     * 注册钩子
+     */
+    tap<T = unknown, R = unknown>(hookName: string, fn: HookFn<T, R>, priority?: number): void;
+    /**
+     * 移除钩子
+     */
+    untap(hookName: string, fn: HookFn): void;
+    /**
+     * 触发钩子（异步）
+     */
+    call<T = unknown, R = unknown>(hookName: string, context: T, options?: HookCallOptions): Promise<R[]>;
+    /**
+     * 触发钩子（同步）
+     */
+    callSync<T = unknown, R = unknown>(hookName: string, context: T, options?: HookCallOptions): R[];
+    /**
+     * 清除所有钩子
+     */
+    clear(): void;
+    /**
+     * 获取钩子数量
+     */
+    hookCount(hookName: string): number;
+}
+//# sourceMappingURL=HookSystem.d.ts.map

package/dist/plugin/HookSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HookSystem.d.ts","sourceRoot":"","sources":["../../src/plugin/HookSystem.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,EAAE,MAAM,SAAS,CAAA;AAEtE,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAA2C;IAExD;;OAEG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAC1B,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAChB,QAAQ,SAAI,GACX,IAAI;IAYP;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAUzC;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,CAAC,EACV,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,CAAC,EAAE,CAAC;IAqBf;;OAEG;IACH,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,CAAC,EAAE;IAqBhG;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;CAGpC"}