@363045841yyt/klinechart-core 0.8.11-alpha.1 → 0.8.13-alpha.0

package/README.md

@@ -26,7 +26,7 @@ const controller = createChartController({
   container: document.getElementById('chart'),
   data: [],
   initialZoomLevel: 3,
-  theme: 'light'
+  theme: 'light',
 })
 
 // Load data
@@ -43,24 +43,29 @@ controller.dispose()
 ## Exports
 
 ### Controllers
+
 - `createChartController` — Factory for creating chart instances
 - `ChartController` — Main controller interface
 
 ### Reactivity
+
 - `Signal<T>` — Reactive primitive for state management
 - `effect`, `peek` — Reactive utilities
 
 ### Engine
+
 - `ChartController` — Public chart interface (via `@363045841yyt/klinechart-core/controllers`)
 - `createChartController` — Factory for creating controller instances
 - Renderers (internal — use controllers facade)
 
 ### Plugin System
+
 - `PluginHost` — Plugin registration and lifecycle
 - `EventBus` — Cross-component communication
 - `StateStore` — Global state management
 
 ### Types
+
 - `KLineData` — Candlestick data point
 - `ChartViewport` — Viewport state
 - `InteractionSnapshot` — Interaction state
@@ -165,17 +170,17 @@ const semantic = new SemanticChartController(chartInstance)
 
 // Apply natural language config
 semantic.applyConfig({
-  "stockSymbol": "AAPL",
-  "dateRange": { "start": "2024-01-01", "end": "2024-06-01" },
-  "indicators": ["MA20", "MACD", "RSI"],
-  "chart": {
-    "chartType": "candlestick",
-    "theme": "dark",
-    "gridLines": { "horizontal": true, "vertical": false }
+  stockSymbol: 'AAPL',
+  dateRange: { start: '2024-01-01', end: '2024-06-01' },
+  indicators: ['MA20', 'MACD', 'RSI'],
+  chart: {
+    chartType: 'candlestick',
+    theme: 'dark',
+    gridLines: { horizontal: true, vertical: false },
+  },
+  display: {
+    paneRatios: { main: 0.6, sub1: 0.4 },
   },
-  "display": {
-    "paneRatios": { "main": 0.6, "sub1": 0.4 }
-  }
 })
 ```
 
@@ -186,6 +191,7 @@ semantic.applyConfig({
 - Safari 14+
 
 Requires support for:
+
 - ResizeObserver
 - Canvas 2D Context
 - ES2022 (or transpile)
@@ -198,4 +204,4 @@ MIT © 363045841
 
 - `@363045841yyt/klinechart` — Vue 3 bindings
 - `@363045841yyt/klinechart-react` — React bindings (coming soon)
-- `@363045841yyt/klinechart-angular` — Angular bindings (coming soon)
+- `@363045841yyt/klinechart-angular` — Angular bindings (coming soon)

package/README.zh-CN.md

@@ -26,7 +26,7 @@ const controller = createChartController({
   container: document.getElementById('chart'),
   data: [],
   initialZoomLevel: 3,
-  theme: 'light'
+  theme: 'light',
 })
 
 // 加载数据
@@ -43,24 +43,29 @@ controller.dispose()
 ## 导出内容
 
 ### 控制器
+
 - `createChartController` —— 创建图表实例的工厂函数
 - `ChartController` —— 主控制器接口
 
 ### 响应式系统
+
 - `Signal<T>` —— 用于状态管理的响应式原语
 - `effect`、`peek` —— 响应式工具函数
 
 ### 引擎
+
 - `ChartController` —— 公开图表接口（通过 `@363045841yyt/klinechart-core/controllers` 导入）
 - `createChartController` —— 创建控制器实例的工厂函数
 - 渲染器（内部使用 —— 请通过 controllers 门面访问）
 
 ### 插件系统
+
 - `PluginHost` —— 插件注册与生命周期管理
 - `EventBus` —— 跨组件通信
 - `StateStore` —— 全局状态管理
 
 ### 类型
+
 - `KLineData` —— K 线数据点
 - `ChartViewport` —— 视口状态
 - `InteractionSnapshot` —— 交互状态
@@ -165,17 +170,17 @@ const semantic = new SemanticChartController(chartInstance)
 
 // 应用自然语言配置
 semantic.applyConfig({
-  "stockSymbol": "AAPL",
-  "dateRange": { "start": "2024-01-01", "end": "2024-06-01" },
-  "indicators": ["MA20", "MACD", "RSI"],
-  "chart": {
-    "chartType": "candlestick",
-    "theme": "dark",
-    "gridLines": { "horizontal": true, "vertical": false }
+  stockSymbol: 'AAPL',
+  dateRange: { start: '2024-01-01', end: '2024-06-01' },
+  indicators: ['MA20', 'MACD', 'RSI'],
+  chart: {
+    chartType: 'candlestick',
+    theme: 'dark',
+    gridLines: { horizontal: true, vertical: false },
+  },
+  display: {
+    paneRatios: { main: 0.6, sub1: 0.4 },
   },
-  "display": {
-    "paneRatios": { "main": 0.6, "sub1": 0.4 }
-  }
 })
 ```
 
@@ -186,6 +191,7 @@ semantic.applyConfig({
 - Safari 14+
 
 需要支持以下特性：
+
 - ResizeObserver
 - Canvas 2D Context
 - ES2022（或转译）
@@ -198,4 +204,4 @@ MIT © 363045841
 
 - `@363045841yyt/klinechart` —— Vue 3 绑定
 - `@363045841yyt/klinechart-react` —— React 绑定（即将推出）
-- `@363045841yyt/klinechart-angular` —— Angular 绑定（即将推出）
+- `@363045841yyt/klinechart-angular` —— Angular 绑定（即将推出）

package/dist/alerts/createAlertController.d.ts

@@ -0,0 +1,30 @@
+/**
+ * AlertController — framework-agnostic, signal-based.
+ *
+ * Same dispose-guard pattern as the other core controllers (volume-profile,
+ * indicator-selector). Adapters (React/Vue/Angular) subscribe to the
+ * `rules` and `events` signals via their native reactivity.
+ *
+ * Per-rule prev-snapshot:
+ *   Cross-style predicates compare prev vs. curr. Rather than asking the
+ *   caller to thread that state, the controller stashes the previous
+ *   evaluation snapshot per rule id and feeds it back into the predicate.
+ *   When a rule is added or re-enabled, its prev is reset — that prevents
+ *   a spurious fire on first evaluation (a newly-added "price-cross 100"
+ *   rule should NOT fire just because the current close happens to be 105).
+ *
+ * Cooldown:
+ *   For non-oneShot rules we record `lastFiredAt` and suppress re-fires
+ *   within `cooldownMs`. oneShot ignores cooldown — it just flips
+ *   `enabled` to false on first fire.
+ *
+ * Crash safety:
+ *   `kind: 'custom'` predicates run inside try/catch. A throwing predicate
+ *   is caught, marked internally, and skipped for this pass; the rest of
+ *   the rules continue to evaluate. Errors are swallowed at the boundary
+ *   (no console.* per coding-style.md) — observability hooks are a future
+ *   addition (`onError` listener on the controller).
+ */
+import type { AlertController, AlertControllerOptions } from './types';
+export declare function createAlertController(opts?: AlertControllerOptions): AlertController;
+//# sourceMappingURL=createAlertController.d.ts.map

package/dist/alerts/createAlertController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAlertController.d.ts","sourceRoot":"","sources":["../../src/alerts/createAlertController.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EAIvB,MAAM,SAAS,CAAA;AAWhB,wBAAgB,qBAAqB,CAAC,IAAI,CAAC,EAAE,sBAAsB,GAAG,eAAe,CAqPpF"}

package/dist/alerts/createAlertController.js

@@ -0,0 +1,257 @@
+/**
+ * AlertController — framework-agnostic, signal-based.
+ *
+ * Same dispose-guard pattern as the other core controllers (volume-profile,
+ * indicator-selector). Adapters (React/Vue/Angular) subscribe to the
+ * `rules` and `events` signals via their native reactivity.
+ *
+ * Per-rule prev-snapshot:
+ *   Cross-style predicates compare prev vs. curr. Rather than asking the
+ *   caller to thread that state, the controller stashes the previous
+ *   evaluation snapshot per rule id and feeds it back into the predicate.
+ *   When a rule is added or re-enabled, its prev is reset — that prevents
+ *   a spurious fire on first evaluation (a newly-added "price-cross 100"
+ *   rule should NOT fire just because the current close happens to be 105).
+ *
+ * Cooldown:
+ *   For non-oneShot rules we record `lastFiredAt` and suppress re-fires
+ *   within `cooldownMs`. oneShot ignores cooldown — it just flips
+ *   `enabled` to false on first fire.
+ *
+ * Crash safety:
+ *   `kind: 'custom'` predicates run inside try/catch. A throwing predicate
+ *   is caught, marked internally, and skipped for this pass; the rest of
+ *   the rules continue to evaluate. Errors are swallowed at the boundary
+ *   (no console.* per coding-style.md) — observability hooks are a future
+ *   addition (`onError` listener on the controller).
+ */
+import { createSignal } from '../reactivity/signal';
+import { evaluatePredicate } from './predicates';
+const DEFAULT_MAX_EVENTS = 100;
+export function createAlertController(opts) {
+    const maxEvents = (() => {
+        const raw = opts?.maxEvents;
+        if (raw === undefined)
+            return DEFAULT_MAX_EVENTS;
+        if (!Number.isFinite(raw) || raw < 1)
+            return DEFAULT_MAX_EVENTS;
+        return Math.floor(raw);
+    })();
+    // -----------------------------------------------------------------------
+    // Signals — frozen arrays so React/Vue see new identity on every change.
+    // -----------------------------------------------------------------------
+    const rules = createSignal([]);
+    const events = createSignal([]);
+    // -----------------------------------------------------------------------
+    // Private state
+    // -----------------------------------------------------------------------
+    const runtime = new Map();
+    const listeners = new Set();
+    let disposed = false;
+    function findIndex(id) {
+        const arr = rules.peek();
+        for (let i = 0; i < arr.length; i++) {
+            if (arr[i].id === id)
+                return i;
+        }
+        return -1;
+    }
+    function replaceAt(arr, i, next) {
+        const copy = arr.slice();
+        copy[i] = next;
+        return copy;
+    }
+    // -----------------------------------------------------------------------
+    // addRule / removeRule / setRuleEnabled / updateRule
+    // -----------------------------------------------------------------------
+    function addRule(rule) {
+        if (findIndex(rule.id) >= 0)
+            return false;
+        // Defensive shallow copy so external mutation of the caller's object
+        // does not affect controller state.
+        const stored = {
+            ...rule,
+            metadata: rule.metadata !== undefined ? { ...rule.metadata } : undefined,
+        };
+        rules.set([...rules.peek(), stored]);
+        runtime.set(rule.id, { prev: null, lastFiredAt: undefined });
+        return true;
+    }
+    function removeRule(id) {
+        const idx = findIndex(id);
+        if (idx < 0)
+            return false;
+        const copy = rules.peek().slice();
+        copy.splice(idx, 1);
+        rules.set(copy);
+        runtime.delete(id);
+        return true;
+    }
+    function setRuleEnabled(id, enabled) {
+        const idx = findIndex(id);
+        if (idx < 0)
+            return false;
+        const cur = rules.peek()[idx];
+        if (cur.enabled === enabled)
+            return true; // no-op but reports success
+        const next = { ...cur, enabled };
+        rules.set(replaceAt(rules.peek(), idx, next));
+        // Re-enabling resets prev — a freshly enabled cross rule should not
+        // fire on the first eval just because the level is already broken.
+        if (enabled) {
+            runtime.set(id, { prev: null, lastFiredAt: undefined });
+        }
+        return true;
+    }
+    function updateRule(id, patch) {
+        const idx = findIndex(id);
+        if (idx < 0)
+            return false;
+        const cur = rules.peek()[idx];
+        const next = {
+            ...cur,
+            ...patch,
+            id: cur.id, // id is invariant
+            metadata: patch.metadata !== undefined ? { ...patch.metadata } : cur.metadata,
+        };
+        rules.set(replaceAt(rules.peek(), idx, next));
+        // Changing the predicate invalidates prev — different predicates may
+        // need different prev fields, and a stale prev could cause a spurious
+        // fire on next eval.
+        if (patch.predicate !== undefined) {
+            runtime.set(id, { prev: null, lastFiredAt: undefined });
+        }
+        return true;
+    }
+    // -----------------------------------------------------------------------
+    // evaluate — the hot path. Safe to call every frame.
+    // -----------------------------------------------------------------------
+    function evaluate(snapshot, now) {
+        const fired = [];
+        const currentRules = rules.peek();
+        // We may need to flip oneShot rules off — collect indices and apply
+        // once at the end to avoid mutating `currentRules` mid-loop.
+        const toDisable = [];
+        for (let i = 0; i < currentRules.length; i++) {
+            const rule = currentRules[i];
+            if (!rule.enabled)
+                continue;
+            const rt = runtime.get(rule.id) ?? {
+                prev: null,
+                lastFiredAt: undefined,
+            };
+            // Cooldown gate (applies to non-oneShot rules; oneShot rules
+            // can only fire once anyway).
+            if (!rule.oneShot &&
+                rule.cooldownMs !== undefined &&
+                rule.cooldownMs > 0 &&
+                rt.lastFiredAt !== undefined &&
+                now - rt.lastFiredAt < rule.cooldownMs) {
+                // Still update prev so the next eval after cooldown has the
+                // right reference point for cross detection.
+                rt.prev = snapshot;
+                runtime.set(rule.id, rt);
+                continue;
+            }
+            // Evaluate. Custom predicates can throw — wrap.
+            let hit = false;
+            try {
+                hit = evaluatePredicate(rule.predicate, snapshot, rt.prev);
+            }
+            catch {
+                // Swallow per crash-safety contract. Do NOT fire. Continue.
+                hit = false;
+            }
+            if (hit) {
+                const event = {
+                    ruleId: rule.id,
+                    ruleName: rule.name,
+                    triggeredAt: now,
+                    snapshotBar: snapshot.bar !== null ? { ...snapshot.bar } : null,
+                    metadata: rule.metadata,
+                };
+                fired.push(event);
+                rt.lastFiredAt = now;
+                if (rule.oneShot) {
+                    toDisable.push(i);
+                }
+            }
+            rt.prev = snapshot;
+            runtime.set(rule.id, rt);
+        }
+        if (fired.length > 0) {
+            // Append fired events to the ring, capped at maxEvents.
+            const prevEvents = events.peek();
+            const merged = prevEvents.concat(fired);
+            const trimmed = merged.length > maxEvents ? merged.slice(merged.length - maxEvents) : merged;
+            events.set(trimmed);
+            // Notify per-event listeners. Copy first so a listener that
+            // unsubscribes during fire-out doesn't mutate the iteration.
+            const snapshotListeners = [...listeners];
+            for (const ev of fired) {
+                for (const l of snapshotListeners) {
+                    try {
+                        l(ev);
+                    }
+                    catch {
+                        // listener errors are isolated — never leak across.
+                    }
+                }
+            }
+        }
+        if (toDisable.length > 0) {
+            const copy = rules.peek().slice();
+            for (const i of toDisable) {
+                const r = copy[i];
+                if (r !== undefined)
+                    copy[i] = { ...r, enabled: false };
+            }
+            rules.set(copy);
+        }
+        return fired;
+    }
+    // -----------------------------------------------------------------------
+    // events / listener management
+    // -----------------------------------------------------------------------
+    function clearEvents() {
+        if (events.peek().length === 0)
+            return;
+        events.set([]);
+    }
+    function onEvent(listener) {
+        listeners.add(listener);
+        return () => {
+            listeners.delete(listener);
+        };
+    }
+    // -----------------------------------------------------------------------
+    // dispose
+    // -----------------------------------------------------------------------
+    function dispose() {
+        if (disposed)
+            return;
+        disposed = true;
+        listeners.clear();
+        runtime.clear();
+    }
+    function guard(fn, fallback) {
+        return ((...args) => {
+            if (disposed)
+                return fallback;
+            return fn(...args);
+        });
+    }
+    return {
+        rules,
+        events,
+        addRule: guard(addRule, false),
+        removeRule: guard(removeRule, false),
+        setRuleEnabled: guard(setRuleEnabled, false),
+        updateRule: guard(updateRule, false),
+        evaluate: guard(evaluate, []),
+        clearEvents: guard(clearEvents, undefined),
+        onEvent: guard(onEvent, (() => undefined)),
+        dispose,
+    };
+}
+//# sourceMappingURL=createAlertController.js.map

package/dist/alerts/createAlertController.js.map

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

package/dist/alerts/index.d.ts

@@ -0,0 +1,5 @@
+export type { AlertController, AlertControllerOptions, AlertEvent, AlertPredicate, AlertPredicateKind, AlertRule, CrossDirection, IndicatorCrossPairDirection, MarketSnapshot, } from './types';
+export { createAlertController } from './createAlertController';
+export { evaluatePredicate } from './predicates';
+export { AlertRuleSchemaError, deserializeRule, serializeRule } from './ruleSchema';
+//# sourceMappingURL=index.d.ts.map

package/dist/alerts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/alerts/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,SAAS,EACT,cAAc,EACd,2BAA2B,EAC3B,cAAc,GACf,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA"}

package/dist/alerts/index.js

@@ -0,0 +1,4 @@
+export { createAlertController } from './createAlertController';
+export { evaluatePredicate } from './predicates';
+export { AlertRuleSchemaError, deserializeRule, serializeRule } from './ruleSchema';
+//# sourceMappingURL=index.js.map

package/dist/alerts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/alerts/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA"}

package/dist/alerts/predicates.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Built-in predicate kit.
+ *
+ * Each predicate is a pure function over `(predicate, curr, prev)`:
+ *   - `curr` is the snapshot at the current evaluation.
+ *   - `prev` is the snapshot from the previous evaluation of the SAME rule
+ *     (the controller threads it through). For cross-style predicates the
+ *     prev value is what makes "just-crossed" detectable vs. "is above".
+ *   - When `prev` is null (first evaluation), cross predicates must NOT fire —
+ *     we cannot distinguish "already above" from "just crossed up" without a
+ *     reference point.
+ *
+ * All predicates are O(1) — no scanning of history. The caller pre-computes
+ * any rolling state (e.g. `rollingVolume[N]`).
+ *
+ * Defensive: predicates return `false` for any required field that is null,
+ * undefined, or non-finite. We never throw — a bad snapshot must not crash
+ * an entire alert pass.
+ */
+import type { AlertPredicate, MarketSnapshot } from './types';
+/**
+ * Returns `true` iff the predicate fires for this (prev, curr) pair.
+ *
+ * The controller wraps `kind: 'custom'` in its own try/catch — but we still
+ * defensively guard against the function being missing here.
+ */
+export declare function evaluatePredicate(predicate: AlertPredicate, curr: MarketSnapshot, prev: MarketSnapshot | null): boolean;
+//# sourceMappingURL=predicates.d.ts.map

package/dist/alerts/predicates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicates.d.ts","sourceRoot":"","sources":["../../src/alerts/predicates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EACV,cAAc,EAGd,cAAc,EACf,MAAM,SAAS,CAAA;AAmEhB;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,cAAc,EACzB,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,cAAc,GAAG,IAAI,GAC1B,OAAO,CA0HT"}