@backtest-kit/signals 14.0.0 → 15.0.0

package/build/index.mjs

@@ -138,13 +138,6 @@ const columns$3 = [
             ? `${await formatPrice(symbol, Number(v))} USD`
             : "N/A",
     },
-    {
-        key: "atr14_raw",
-        label: "ATR(14) Raw",
-        format: async (v, symbol) => v !== null
-            ? `${await formatPrice(symbol, Number(v))} USD`
-            : "N/A",
-    },
     {
         key: "atr20",
         label: "ATR(20)",
@@ -207,6 +200,11 @@ const columns$3 = [
             ? `${await formatPrice(symbol, Number(v))} USD`
             : "N/A",
     },
+    {
+        key: "volumeTrendRatio",
+        label: "Volume Trend Ratio",
+        format: (v) => (v !== null ? `${Number(v).toFixed(2)}x` : "N/A"),
+    },
     {
         key: "currentPrice",
         label: "Current Price",
@@ -341,8 +339,8 @@ function calculateFibonacciLevels$2(candles, endIndex) {
         "61.8%": high - range * 0.618,
         "78.6%": high - range * 0.786,
         "100.0%": low,
-        "127.2%": high - range * 1.272,
-        "161.8%": high - range * 1.618,
+        "127.2% (downside)": high - range * 1.272,
+        "161.8% (downside)": high - range * 1.618,
     };
     const currentPrice = Number(candles[endIndex].close);
     let nearestLevel = {
@@ -436,20 +434,19 @@ function generateAnalysis$3(symbol, candles) {
         if (i < WARMUP_PERIOD$3) {
             return;
         }
-        // Volume trend calculation
-        const volumeSma6 = new FasterSMA(6);
-        const volumeSma6Prev = new FasterSMA(6);
+        // Volume trend calculation: average of last 6 candles vs previous 6
         const volumeStart = Math.max(0, i + 1 - 12);
         const prevVolumeData = volumes.slice(volumeStart, Math.min(volumeStart + 6, i + 1));
         const recentVolumeData = volumes.slice(Math.max(0, i + 1 - 6), i + 1);
-        if (prevVolumeData.length > 0) {
-            prevVolumeData.forEach((vol) => volumeSma6Prev.update(vol, false));
-        }
-        if (recentVolumeData.length > 0) {
-            recentVolumeData.forEach((vol) => volumeSma6.update(vol, false));
-        }
-        const recentVolumeRaw = volumeSma6.getResult();
-        const prevVolumeRaw = volumeSma6Prev.getResult();
+        const averageOf = (values) => {
+            const safe = values.filter((value) => !isUnsafe$4(value));
+            if (safe.length === 0) {
+                return null;
+            }
+            return safe.reduce((sum, value) => sum + value, 0) / safe.length;
+        };
+        const recentVolumeRaw = averageOf(recentVolumeData);
+        const prevVolumeRaw = averageOf(prevVolumeData);
         const recentVolume = !isUnsafe$4(recentVolumeRaw)
             ? recentVolumeRaw
             : volumes[i];
@@ -501,9 +498,6 @@ function generateAnalysis$3(symbol, candles) {
             atr14: atr14.getResult() != null && !isUnsafe$4(atr14.getResult())
                 ? atr14.getResult()
                 : null,
-            atr14_raw: atr14.getResult() != null && !isUnsafe$4(atr14.getResult())
-                ? atr14.getResult()
-                : null,
             atr20: atr20.getResult() != null && !isUnsafe$4(atr20.getResult())
                 ? atr20.getResult()
                 : null,
@@ -554,11 +548,12 @@ function generateAnalysis$3(symbol, candles) {
             fibonacciDistance: fibonacciNearest.distance,
             bodySize,
             closePrice: close,
-            date: new Date(),
+            date: new Date(_candle.timestamp),
             lookbackPeriod: "48 candles (48 hours) with SMA(50) from 100 hours",
         });
     });
-    return results;
+    // Return only the last TABLE_ROWS_LIMIT rows
+    return results.slice(-TABLE_ROWS_LIMIT$3);
 }
 /**
  * Generates markdown table with long-term technical analysis history.
@@ -621,9 +616,7 @@ async function generateHistoryTable$3(indicators, symbol) {
     markdown +=
         "- **ATR(14)**: over previous 14 candles (14 hours on 1h timeframe) before row timestamp (Min: 0 USD, Max: +∞)\n";
     markdown +=
-        "- **ATR(14) Raw**: raw value over previous 14 candles before row timestamp (Min: 0 USD, Max: +∞)\n";
-    markdown +=
-        "- **ATR(20) Raw**: raw value over previous 20 candles (20 hours on 1h timeframe) before row timestamp (Min: 0 USD, Max: +∞)\n";
+        "- **ATR(20)**: over previous 20 candles (20 hours on 1h timeframe) before row timestamp (Min: 0 USD, Max: +∞)\n";
     markdown +=
         "- **CCI(20)**: over previous 20 candles (20 hours on 1h timeframe) before row timestamp (Min: -∞, Max: +∞)\n";
     markdown +=
@@ -648,12 +641,14 @@ async function generateHistoryTable$3(indicators, symbol) {
         "- **EMA(34)**: over previous 34 candles (34 hours on 1h timeframe) before row timestamp (Min: 0 USD, Max: +∞ USD)\n";
     markdown +=
         "- **Momentum(10)**: over previous 10 candles (10 hours on 1h timeframe) before row timestamp (Min: -∞ USD, Max: +∞ USD)\n";
+    markdown +=
+        "- **Volume Trend Ratio**: average volume of last 6 candles relative to previous 6 candles before row timestamp (Min: 0x, Max: +∞x; above 1x = volume increasing)\n";
     markdown +=
         "- **Support**: over previous 4 candles (4 hours on 1h timeframe) before row timestamp (Min: 0 USD, Max: +∞ USD)\n";
     markdown +=
         "- **Resistance**: over previous 4 candles (4 hours on 1h timeframe) before row timestamp (Min: 0 USD, Max: +∞ USD)\n";
     markdown +=
-        "- **Fibonacci Nearest Level**: nearest level name before row timestamp\n";
+        "- **Fibonacci Nearest Level**: nearest level name before row timestamp; levels marked (downside) lie below the range low\n";
     markdown +=
         "- **Fibonacci Nearest Price**: nearest price level before row timestamp (Min: 0 USD, Max: +∞ USD)\n";
     markdown +=
@@ -768,9 +763,7 @@ class LongTermHistoryService {
         this.getReport = async (symbol) => {
             this.loggerService.log("longTermHistoryService getReport", { symbol });
             const fullCandles = await getCandles(symbol, "1h", 100);
-            // Use all candles for indicator warm-up, then filter to last TABLE_ROWS_LIMIT rows
-            const allRows = await this.getData(symbol, fullCandles);
-            const rows = allRows.slice(-TABLE_ROWS_LIMIT$3);
+            const rows = await this.getData(symbol, fullCandles);
             return generateHistoryTable$3(rows, symbol);
         };
         /**
@@ -1066,6 +1059,11 @@ const columns$2 = [
         label: "Volume Ratio",
         format: (v) => (v !== null ? `${Number(v).toFixed(2)}x` : "N/A"),
     },
+    {
+        key: "volumeTrendRatio",
+        label: "Volume Trend Ratio",
+        format: (v) => (v !== null ? `${Number(v).toFixed(2)}x` : "N/A"),
+    },
     {
         key: "volatility5",
         label: "Volatility(5)",
@@ -1155,9 +1153,11 @@ function calculateVolumeMetrics(candles, endIndex) {
     const volumeSma5 = new FasterSMA(5);
     volumes.forEach((vol) => volumeSma5.update(vol, false));
     const avgVolumeRaw = volumeSma5.getResult();
-    const avgVolume = !isUnsafe$3(avgVolumeRaw) ? avgVolumeRaw : 0;
+    const avgVolume = !isUnsafe$3(avgVolumeRaw) ? avgVolumeRaw : null;
     const currentVolume = volumes[volumes.length - 1];
-    const volumeRatio = avgVolume > 0 && !isUnsafe$3(currentVolume) ? currentVolume / avgVolume : 1;
+    const volumeRatio = avgVolume !== null && avgVolume > 0 && !isUnsafe$3(currentVolume)
+        ? currentVolume / avgVolume
+        : null;
     let volumeTrendRatio = null;
     if (volumes.length >= 6) {
         const recent3 = volumes.slice(-3);
@@ -1194,15 +1194,15 @@ function calculatePriceChanges(candles, endIndex) {
         return { priceChange1m: null, priceChange3m: null, priceChange5m: null };
     }
     const current = closes[closes.length - 1];
-    const priceChange1m = closes.length >= 2
+    const priceChange1m = closes.length >= 2 && closes[closes.length - 2] > 0
         ? ((current - closes[closes.length - 2]) / closes[closes.length - 2]) *
             100
         : null;
-    const priceChange3m = closes.length >= 4
+    const priceChange3m = closes.length >= 4 && closes[closes.length - 4] > 0
         ? ((current - closes[closes.length - 4]) / closes[closes.length - 4]) *
             100
         : null;
-    const priceChange5m = closes.length >= 6
+    const priceChange5m = closes.length >= 6 && closes[closes.length - 6] > 0
         ? ((current - closes[closes.length - 6]) / closes[closes.length - 6]) *
             100
         : null;
@@ -1348,9 +1348,9 @@ function generateAnalysis$2(symbol, candles) {
         sma8.update(close, false);
         dema8.update(close, false);
         wma5.update(close, false);
-        // Determine minimum warm-up period needed (largest indicator period)
-        // EMA(21) is the largest period
-        // Skip rows until all indicators are warmed up
+        // Skip rows until the primary indicators are warmed up.
+        // WARMUP_PERIOD covers EMA(21); slower indicators (e.g. StochRSI(14)
+        // needs ~28 candles) render as N/A in the first rows until ready.
         if (i < WARMUP_PERIOD$2) {
             return;
         }
@@ -1521,7 +1521,7 @@ function generateAnalysis$2(symbol, candles) {
             squeezeMomentum,
             pressureIndex,
             closePrice: close,
-            date: new Date(),
+            date: new Date(_candle.timestamp),
             lookbackPeriod: "60 candles (60 minutes)",
         });
     });
@@ -1607,7 +1607,7 @@ async function generateHistoryTable$2(indicators, symbol) {
     markdown +=
         "- **Bollinger Width(8,2.0)**: width percentage before row timestamp (Min: 0%, Max: +∞)\n";
     markdown +=
-        "- **Bollinger Position**: price position within bands before row timestamp (Min: 0%, Max: 100%)\n";
+        "- **Bollinger Position**: price position within bands before row timestamp (0% = lower band, 100% = upper band; can go below 0% or above 100% when price is outside the bands)\n";
     markdown +=
         "- **Stochastic K(3,3,3)**: over previous 3 candles (3 minutes on 1m timeframe) before row timestamp (Min: 0, Max: 100)\n";
     markdown +=
@@ -1644,6 +1644,8 @@ async function generateHistoryTable$2(indicators, symbol) {
         "- **Volume SMA(5)**: over previous 5 candles (5 minutes on 1m timeframe) before row timestamp (Min: 0, Max: +∞)\n";
     markdown +=
         "- **Volume Ratio**: volume relative to average at row timestamp (Min: 0x, Max: +∞x)\n";
+    markdown +=
+        "- **Volume Trend Ratio**: average volume of last 3 candles relative to previous 3 candles at row timestamp (Min: 0x, Max: +∞x; above 1x = volume increasing)\n";
     markdown +=
         "- **Support**: over previous 30 candles (30 minutes on 1m timeframe) before row timestamp (Min: 0 USD, Max: +∞ USD)\n";
     markdown +=
@@ -1894,6 +1896,11 @@ const columns$1 = [
         label: "ROC(10) - Rate of Change %",
         format: (v) => (v !== null ? `${Number(v).toFixed(3)}%` : "N/A"),
     },
+    {
+        key: "volumeTrendRatio",
+        label: "Volume Trend Ratio",
+        format: (v) => (v !== null ? `${Number(v).toFixed(2)}x` : "N/A"),
+    },
     {
         key: "sma50",
         label: "SMA(50)",
@@ -2068,8 +2075,8 @@ function calculateFibonacciLevels$1(candles, endIndex) {
         "61.8%": high - range * 0.618,
         "78.6%": high - range * 0.786,
         "100.0%": low,
-        "127.2%": high - range * 1.272,
-        "161.8%": high - range * 1.618,
+        "127.2% (downside)": high - range * 1.272,
+        "161.8% (downside)": high - range * 1.618,
     };
     const currentPrice = Number(candles[endIndex].close);
     let nearestLevel = {
@@ -2248,7 +2255,8 @@ function generateAnalysis$1(symbol, candles) {
             bollingerWidth10_2: bollingerResult &&
                 !isUnsafe$2(bollingerResult.upper) &&
                 !isUnsafe$2(bollingerResult.lower) &&
-                !isUnsafe$2(bollingerResult.middle)
+                !isUnsafe$2(bollingerResult.middle) &&
+                bollingerResult.middle !== 0
                 ? ((bollingerResult.upper - bollingerResult.lower) /
                     bollingerResult.middle) *
                     100
@@ -2309,7 +2317,7 @@ function generateAnalysis$1(symbol, candles) {
             fibonacciDistance: fibonacciNearest.distance,
             bodySize,
             closePrice: close,
-            date: new Date(),
+            date: new Date(_candle.timestamp),
             lookbackPeriod: "144 candles (36 hours)",
         });
     });
@@ -2396,6 +2404,8 @@ async function generateHistoryTable$1(indicators, symbol) {
         "- **ROC(5)**: over previous 5 candles (75 minutes on 15m timeframe) before row timestamp (Min: -∞%, Max: +∞%)\n";
     markdown +=
         "- **ROC(10)**: over previous 10 candles (150 minutes on 15m timeframe) before row timestamp (Min: -∞%, Max: +∞%)\n";
+    markdown +=
+        "- **Volume Trend Ratio**: average volume of last 8 candles relative to previous 8 candles before row timestamp (Min: 0x, Max: +∞x; above 1x = volume increasing)\n";
     markdown +=
         "- **SMA(50)**: over previous 50 candles (750 minutes on 15m timeframe) before row timestamp (Min: 0 USD, Max: +∞ USD)\n";
     markdown +=
@@ -2411,9 +2421,9 @@ async function generateHistoryTable$1(indicators, symbol) {
     markdown +=
         "- **Resistance**: over previous 48 candles (12 hours on 15m timeframe) before row timestamp (Min: 0 USD, Max: +∞ USD)\n";
     markdown +=
-        "- **Fibonacci Nearest Level**: nearest level name before row timestamp\n";
+        "- **Fibonacci Nearest Level**: nearest level name before row timestamp; levels marked (downside) lie below the range low\n";
     markdown +=
-        "- **Fibonacci Nearest Price**: nearest price level over 288 candles (72h on 15m timeframe) before row timestamp (Min: 0 USD, Max: +∞ USD)\n";
+        "- **Fibonacci Nearest Price**: nearest price level over up to 288 candles (limited by the 144-candle / 36h report history) before row timestamp (Min: 0 USD, Max: +∞ USD)\n";
     markdown +=
         "- **Fibonacci Distance**: distance to nearest level before row timestamp (Min: 0 USD, Max: +∞ USD)\n";
     markdown +=
@@ -2568,6 +2578,11 @@ const TABLE_ROWS_LIMIT = 30;
  * Ensures all technical indicators (especially EMA(34)) have sufficient data.
  */
 const WARMUP_PERIOD = 34;
+/**
+ * Rolling window (in candles) for the volatility calculation.
+ * Keeps the metric comparable across rows regardless of total history length.
+ */
+const VOLATILITY_WINDOW = 20;
 const columns = [
     {
         key: "rsi14",
@@ -3001,16 +3016,20 @@ function generateAnalysis(symbol, candles) {
         if (i < WARMUP_PERIOD) {
             return;
         }
-        const priceChanges = closes
-            .slice(0, i + 1)
-            .slice(1)
-            .map((price, idx) => {
-            const prevPrice = closes.slice(0, i + 1)[idx];
-            return ((price - prevPrice) / prevPrice) * 100;
-        });
-        const volatility = priceChanges.length > 0
-            ? Math.sqrt(priceChanges.reduce((sum, change) => sum + change ** 2, 0) /
-                priceChanges.length)
+        let volatilitySumSq = 0;
+        let volatilityCount = 0;
+        for (let idx = Math.max(1, i + 1 - VOLATILITY_WINDOW); idx <= i; idx++) {
+            const prevPrice = closes[idx - 1];
+            const currPrice = closes[idx];
+            if (isUnsafe$1(prevPrice) || isUnsafe$1(currPrice) || prevPrice <= 0) {
+                continue;
+            }
+            const change = ((currPrice - prevPrice) / prevPrice) * 100;
+            volatilitySumSq += change ** 2;
+            volatilityCount += 1;
+        }
+        const volatility = volatilityCount > 0
+            ? Math.sqrt(volatilitySumSq / volatilityCount)
             : null;
         const { support, resistance } = calculateSupportResistance(candles, i);
         const fibonacci = calculateFibonacciLevels(candles, i);
@@ -3106,7 +3125,7 @@ function generateAnalysis(symbol, candles) {
             fibonacciPositionPercent: fibonacci.fibonacciPositionPercent,
             bodySize,
             closePrice: close,
-            date: new Date(),
+            date: new Date(_candle.timestamp),
             lookbackPeriod: "96 candles (48 hours)",
         });
     });
@@ -3220,7 +3239,7 @@ async function generateHistoryTable(indicators, symbol) {
     markdown +=
         "- **Volume**: trading volume at row timestamp (Min: 0, Max: +∞)\n";
     markdown +=
-        "- **Volatility**: volatility percentage at row timestamp (Min: 0%, Max: +∞)\n";
+        "- **Volatility**: RMS of 1-candle percentage changes over previous 20 candles (10 hours on 30m timeframe) before row timestamp (Min: 0%, Max: +∞)\n";
     markdown += "\n## Column Descriptions\n\n";
     markdown += "**RSI(14) - Relative Strength Index**: Momentum oscillator measuring the speed and magnitude of price changes on 30-minute timeframe. Values above 70 indicate overbought conditions suitable for profit-taking, below 30 indicate oversold conditions suitable for entries.\n\n";
     markdown += "**StochRSI(14) - RSI Oscillator**: Applies Stochastic calculation to RSI values, providing more sensitive overbought/oversold signals for swing trading. Range 0-100, with 80+ being overbought and 20- being oversold.\n\n";
@@ -3625,11 +3644,11 @@ class HourCandleHistoryService {
                 markdown += `### 1h Candle ${index + 1}\n`;
                 markdown += `- **Price Change**: ${priceChangePercent.toFixed(3)}%\n`;
                 markdown += `- **Time**: ${formattedTime}\n`;
-                markdown += `- **Open**: ${formatPrice(symbol, candle.open)} USD\n`;
-                markdown += `- **High**: ${formatPrice(symbol, candle.high)} USD\n`;
-                markdown += `- **Low**: ${formatPrice(symbol, candle.low)} USD\n`;
-                markdown += `- **Close**: ${formatPrice(symbol, candle.close)} USD\n`;
-                markdown += `- **Volume**: ${formatQuantity(symbol, candle.volume)}\n`;
+                markdown += `- **Open**: ${await formatPrice(symbol, candle.open)} USD\n`;
+                markdown += `- **High**: ${await formatPrice(symbol, candle.high)} USD\n`;
+                markdown += `- **Low**: ${await formatPrice(symbol, candle.low)} USD\n`;
+                markdown += `- **Close**: ${await formatPrice(symbol, candle.close)} USD\n`;
+                markdown += `- **Volume**: ${await formatQuantity(symbol, candle.volume)}\n`;
                 markdown += `- **1h Volatility**: ${volatilityPercent.toFixed(2)}%\n`;
                 markdown += `- **Body Size**: ${bodyPercent.toFixed(1)}%\n\n`;
             }
@@ -3779,7 +3798,7 @@ class OneMinuteCandleHistoryService {
                 markdown += `- **High**: ${await formatPrice(symbol, candle.high)} USD\n`;
                 markdown += `- **Low**: ${await formatPrice(symbol, candle.low)} USD\n`;
                 markdown += `- **Close**: ${await formatPrice(symbol, candle.close)} USD\n`;
-                markdown += `- **Volume**: ${formatQuantity(symbol, candle.volume)}\n`;
+                markdown += `- **Volume**: ${await formatQuantity(symbol, candle.volume)}\n`;
                 markdown += `- **1m Volatility**: ${volatilityPercent.toFixed(2)}%\n`;
                 markdown += `- **Body Size**: ${bodyPercent.toFixed(1)}%\n\n`;
             }
@@ -3929,7 +3948,7 @@ class ThirtyMinuteCandleHistoryService {
                 report += `- **High**: ${await formatPrice(symbol, candle.high)} USD\n`;
                 report += `- **Low**: ${await formatPrice(symbol, candle.low)} USD\n`;
                 report += `- **Close**: ${await formatPrice(symbol, candle.close)} USD\n`;
-                report += `- **Volume**: ${formatQuantity(symbol, candle.volume)}\n`;
+                report += `- **Volume**: ${await formatQuantity(symbol, candle.volume)}\n`;
                 report += `- **30m Volatility**: ${volatilityPercent.toFixed(2)}%\n`;
                 report += `- **Body Size**: ${bodyPercent.toFixed(1)}%\n\n`;
             }
@@ -4260,18 +4279,18 @@ class BookDataMathService {
             });
             const depth = await getOrderBook(symbol, MAX_DEPTH_LEVELS);
             // Just process raw data - no calculations
-            const bids = processOrderBookSide(depth.bids.sort((a, b) => parseFloat(b.price) - parseFloat(a.price))); // Сортировка по убыванию
-            const asks = processOrderBookSide(depth.asks.sort((a, b) => parseFloat(a.price) - parseFloat(b.price))); // Сортировка по возрастанию
-            const bestBid = bids.length > 0 ? bids[0].price : 0;
-            const bestAsk = asks.length > 0 ? asks[0].price : 0;
-            const midPrice = (bestBid + bestAsk) / 2;
-            const spread = bestAsk - bestBid;
+            const bids = processOrderBookSide([...depth.bids].sort((a, b) => parseFloat(b.price) - parseFloat(a.price))); // Сортировка по убыванию
+            const asks = processOrderBookSide([...depth.asks].sort((a, b) => parseFloat(a.price) - parseFloat(b.price))); // Сортировка по возрастанию
+            const bestBid = bids.length > 0 ? bids[0].price : null;
+            const bestAsk = asks.length > 0 ? asks[0].price : null;
+            const midPrice = bestBid !== null && bestAsk !== null ? (bestBid + bestAsk) / 2 : null;
+            const spread = bestBid !== null && bestAsk !== null ? bestAsk - bestBid : null;
             // Calculate depth imbalance
             const totalBidVolume = bids.reduce((sum, bid) => sum + bid.quantity, 0);
             const totalAskVolume = asks.reduce((sum, ask) => sum + ask.quantity, 0);
             const depthImbalance = totalBidVolume + totalAskVolume > 0
                 ? (totalBidVolume - totalAskVolume) / (totalBidVolume + totalAskVolume)
-                : 0;
+                : null;
             return {
                 symbol,
                 timestamp: new Date().toISOString(),
@@ -5024,7 +5043,7 @@ const commitHistorySetup = async (symbol, history) => {
     await commitShortTermMath(symbol, history);
     await commitSwingTermMath(symbol, history);
     await commitLongTermMath(symbol, history);
-    const displayName = await String(symbol).toUpperCase();
+    const displayName = String(symbol).toUpperCase();
     const currentPrice = await getAveragePrice(symbol);
     const currentData = await getDate();
     await history.push({

package/package.json

@@ -1,87 +1,87 @@
-{
-  "name": "@backtest-kit/signals",
-  "version": "14.0.0",
-  "description": "Technical analysis and trading signal generation library for AI-powered trading systems. Computes 50+ indicators across 4 timeframes and generates markdown reports for LLM consumption.",
-  "author": {
-    "name": "Petr Tripolsky",
-    "email": "tripolskypetr@gmail.com",
-    "url": "https://github.com/tripolskypetr"
-  },
-  "funding": {
-    "type": "individual",
-    "url": "http://paypal.me/tripolskypetr"
-  },
-  "license": "MIT",
-  "homepage": "https://backtest-kit.github.io/documents/article_07_ai_news_trading_signals.html",
-  "keywords": [
-    "framework",
-    "technical-analysis",
-    "trading-bot",
-    "algorithmic-trading",
-    "quantitative-trading",
-    "stock-market",
-    "cryptocurrency",
-    "forex",
-    "strategy-testing",
-    "portfolio-management",
-    "market-data",
-    "ohlcv",
-    "candlestick",
-    "time-series"
-  ],
-  "files": [
-    "build",
-    "types.d.ts",
-    "README.md"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/tripolskypetr/backtest-kit",
-    "documentation": "https://github.com/tripolskypetr/backtest-kit/tree/master/docs"
-  },
-  "bugs": {
-    "url": "https://github.com/tripolskypetr/backtest-kit/issues"
-  },
-  "scripts": {
-    "build": "rollup -c"
-  },
-  "main": "build/index.cjs",
-  "module": "build/index.mjs",
-  "source": "src/index.ts",
-  "types": "./types.d.ts",
-  "exports": {
-    "require": "./build/index.cjs",
-    "types": "./types.d.ts",
-    "import": "./build/index.mjs",
-    "default": "./build/index.cjs"
-  },
-  "devDependencies": {
-    "@rollup/plugin-typescript": "11.1.6",
-    "@types/node": "22.9.0",
-    "glob": "11.0.1",
-    "rimraf": "6.0.1",
-    "rollup": "3.29.5",
-    "rollup-plugin-dts": "6.1.1",
-    "rollup-plugin-peer-deps-external": "2.2.4",
-    "ts-morph": "27.0.2",
-    "tslib": "2.7.0",
-    "typedoc": "0.27.9",
-    "backtest-kit": "14.0.0",
-    "worker-testbed": "2.1.0"
-  },
-  "peerDependencies": {
-    "backtest-kit": "^14.0.0",
-    "typescript": "^5.0.0"
-  },
-  "dependencies": {
-    "di-kit": "^1.1.1",
-    "di-scoped": "^1.0.21",
-    "functools-kit": "^3.0.0",
-    "trading-signals": "^6.9.1",
-    "get-moment-stamp": "^2.0.0",
-    "agent-swarm-kit": "^3.2.0"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "@backtest-kit/signals",
+  "version": "15.0.0",
+  "description": "Technical analysis and trading signal generation library for AI-powered trading systems. Computes 50+ indicators across 4 timeframes and generates markdown reports for LLM consumption.",
+  "author": {
+    "name": "Petr Tripolsky",
+    "email": "tripolskypetr@gmail.com",
+    "url": "https://github.com/tripolskypetr"
+  },
+  "funding": {
+    "type": "individual",
+    "url": "http://paypal.me/tripolskypetr"
+  },
+  "license": "MIT",
+  "homepage": "https://backtest-kit.github.io/documents/article_07_ai_news_trading_signals.html",
+  "keywords": [
+    "framework",
+    "technical-analysis",
+    "trading-bot",
+    "algorithmic-trading",
+    "quantitative-trading",
+    "stock-market",
+    "cryptocurrency",
+    "forex",
+    "strategy-testing",
+    "portfolio-management",
+    "market-data",
+    "ohlcv",
+    "candlestick",
+    "time-series"
+  ],
+  "files": [
+    "build",
+    "types.d.ts",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tripolskypetr/backtest-kit",
+    "documentation": "https://github.com/tripolskypetr/backtest-kit/tree/master/docs"
+  },
+  "bugs": {
+    "url": "https://github.com/tripolskypetr/backtest-kit/issues"
+  },
+  "scripts": {
+    "build": "rollup -c"
+  },
+  "main": "build/index.cjs",
+  "module": "build/index.mjs",
+  "source": "src/index.ts",
+  "types": "./types.d.ts",
+  "exports": {
+    "require": "./build/index.cjs",
+    "types": "./types.d.ts",
+    "import": "./build/index.mjs",
+    "default": "./build/index.cjs"
+  },
+  "devDependencies": {
+    "@rollup/plugin-typescript": "11.1.6",
+    "@types/node": "22.9.0",
+    "glob": "11.0.1",
+    "rimraf": "6.0.1",
+    "rollup": "3.29.5",
+    "rollup-plugin-dts": "6.1.1",
+    "rollup-plugin-peer-deps-external": "2.2.4",
+    "ts-morph": "27.0.2",
+    "tslib": "2.7.0",
+    "typedoc": "0.27.9",
+    "backtest-kit": "15.0.0",
+    "worker-testbed": "3.0.0"
+  },
+  "peerDependencies": {
+    "backtest-kit": "^15.0.0",
+    "typescript": "^5.0.0"
+  },
+  "dependencies": {
+    "di-kit": "^1.1.1",
+    "di-scoped": "^1.0.21",
+    "functools-kit": "^4.0.0",
+    "trading-signals": "^6.9.1",
+    "get-moment-stamp": "^2.0.0",
+    "agent-swarm-kit": "^4.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/types.d.ts

@@ -632,7 +632,6 @@ interface ILongTermRow {
     pdi14: number | null;
     ndi14: number | null;
     atr14: number | null;
-    atr14_raw: number | null;
     atr20: number | null;
     cci20: number | null;
     bollinger20_2_upper: number | null;
@@ -1543,16 +1542,16 @@ interface IBookDataAnalysis {
     bids: IOrderBookEntry[];
     /** Ask (sell) levels with percentages */
     asks: IOrderBookEntry[];
-    /** Highest bid price */
-    bestBid: number;
-    /** Lowest ask price */
-    bestAsk: number;
-    /** Mid price: (bestBid + bestAsk) / 2 */
-    midPrice: number;
-    /** Spread: bestAsk - bestBid */
-    spread: number;
-    /** Depth imbalance: (bidVol - askVol) / (bidVol + askVol) */
-    depthImbalance: number;
+    /** Highest bid price (null when the book side is empty) */
+    bestBid: number | null;
+    /** Lowest ask price (null when the book side is empty) */
+    bestAsk: number | null;
+    /** Mid price: (bestBid + bestAsk) / 2 (null when either side is empty) */
+    midPrice: number | null;
+    /** Spread: bestAsk - bestBid (null when either side is empty) */
+    spread: number | null;
+    /** Depth imbalance: (bidVol - askVol) / (bidVol + askVol) (null when the book is empty) */
+    depthImbalance: number | null;
 }
 /**
  * Service for order book analysis and markdown report generation.