backtest-kit 1.4.15 → 1.5.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "backtest-kit",
-  "version": "1.4.15",
+  "version": "1.5.1",
   "description": "A TypeScript library for trading system backtest",
   "author": {
     "name": "Petr Tripolsky",

package/types.d.ts

@@ -31,6 +31,15 @@ declare const GLOBAL_CONFIG: {
      * Default: 1440 minutes (1 day)
      */
     CC_MAX_SIGNAL_LIFETIME_MINUTES: number;
+    /**
+     * Maximum time allowed for signal generation (in seconds).
+     * Prevents long-running or stuck signal generation routines from blocking
+     * execution or consuming resources indefinitely. If generation exceeds this
+     * threshold the attempt should be aborted, logged and optionally retried.
+     *
+     * Default: 180 seconds (3 minutes)
+     */
+    CC_MAX_SIGNAL_GENERATION_SECONDS: number;
     /**
      * Number of retries for getCandles function
      * Default: 3 retries
@@ -723,7 +732,7 @@ interface IPartial {
      * // Memoized instance cleared from getPartial cache
      * ```
      */
-    clear(symbol: string, data: ISignalRow, priceClose: number): Promise<void>;
+    clear(symbol: string, data: ISignalRow, priceClose: number, backtest: boolean): Promise<void>;
 }
 
 /**
@@ -918,6 +927,10 @@ interface IStrategyTickResultActive {
     exchangeName: ExchangeName;
     /** Trading pair symbol (e.g., "BTCUSDT") */
     symbol: string;
+    /** Percentage progress towards take profit (0-100%, 0 if moving towards SL) */
+    percentTp: number;
+    /** Percentage progress towards stop loss (0-100%, 0 if moving towards TP) */
+    percentSl: number;
 }
 /**
  * Tick result: signal closed with PNL.
@@ -3764,6 +3777,10 @@ interface TickEvent {
     takeProfit?: number;
     /** Stop loss price (only for opened/active/closed) */
     stopLoss?: number;
+    /** Percentage progress towards take profit (only for active) */
+    percentTp?: number;
+    /** Percentage progress towards stop loss (only for active) */
+    percentSl?: number;
     /** PNL percentage (only for closed) */
     pnl?: number;
     /** Close reason (only for closed) */
@@ -8661,7 +8678,7 @@ declare class PartialConnectionService implements IPartial {
      * @param priceClose - Final closing price
      * @returns Promise that resolves when clear is complete
      */
-    clear: (symbol: string, data: ISignalRow, priceClose: number) => Promise<void>;
+    clear: (symbol: string, data: ISignalRow, priceClose: number, backtest: boolean) => Promise<void>;
 }
 
 /**
@@ -8742,7 +8759,7 @@ declare class PartialGlobalService {
      * @param priceClose - Final closing price
      * @returns Promise that resolves when clear is complete
      */
-    clear: (symbol: string, data: ISignalRow, priceClose: number) => Promise<void>;
+    clear: (symbol: string, data: ISignalRow, priceClose: number, backtest: boolean) => Promise<void>;
 }
 
 /**