@tranding-custom-chart/financial 0.0.0-stage → 2.0.0

package/README.md

@@ -1,3 +1,41 @@
-# Temporary Holding Version
+# @tranding-custom-chart/financial
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> High-throughput financial indicators, market data adapters, multi-pane geometry, and time-independent series engines.
+
+[![Version](https://img.shields.io/badge/version-2.0.0-blue.svg)](https://semver.org)
+
+## Features
+- **Technical Indicators**:
+  - `computeSMA`: Simple Moving Average.
+  - `computeEMA`: Exponential Moving Average.
+  - `computeWMA`: Weighted Moving Average.
+  - `computeVWAP`: Session-anchored Volume Weighted Average Price.
+  - `computeBollingerBands`: Volatility envelope with standard deviation multiplier.
+  - `computeRSI`: Relative Strength Index with Wilder's smoothing.
+  - `computeMACD`: MACD Line, Signal Line, and Divergence Histogram.
+  - `computeATR`: Average True Range volatility measure.
+  - `computeSupertrend`: ATR-based dynamic trailing stop bands with direction and reversal tracking.
+  - `computeVolumeProfile`: Visible Range Volume Profile (VRVP) binned volume with POC and 70% Value Area bounds.
+- **Time-Independent Series**:
+  - `computeRenko`: Price movement bricks eliminating market noise.
+  - `computeHeikinAshi`: Mathematical synthetic trend smoothing.
+- **Multi-Pane Layout Calculator**:
+  - `computePaneLayouts`: Splits vertical chart height proportionally across Price, Volume, and Oscillator panes.
+
+## Installation
+```bash
+npm install @tranding-custom-chart/financial @tranding-custom-chart/core
+```
+
+## Quick Start
+```ts
+import { computeSupertrend, computeVolumeProfile } from '@tranding-custom-chart/financial';
+
+const supertrend = computeSupertrend(bars, { period: 10, multiplier: 3.0 });
+const profile = computeVolumeProfile(bars, { binCount: 24, valueAreaRatio: 0.7 });
+
+console.log('POC Price:', profile.pocPrice);
+```
+
+## License
+UNLICENSED (Internal / In-House Use)

package/dist/adapter.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @file packages/chart-financial/src/adapter.ts
+ * Adapter converting raw market contracts (e.g. StoredCandleDto) into canonical OHLCVBar objects.
+ * Truthfulness guarantee: never fabricates artificial candles.
+ */
+import { type OHLCVBar } from '@tranding-custom-chart/core';
+export interface RawCandleInput {
+    readonly id?: string | undefined;
+    readonly entityKey?: string | undefined;
+    readonly interval?: string | undefined;
+    readonly candleStart: string;
+    readonly open: string | number;
+    readonly high: string | number;
+    readonly low: string | number;
+    readonly close: string | number;
+    readonly volume?: string | number | null | undefined;
+    readonly qualityFlags?: readonly string[] | undefined;
+    readonly timezoneInterpretation?: string | undefined;
+}
+/**
+ * Normalizes an array of raw candle inputs into strictly validated, sorted OHLCV bars.
+ */
+export declare function normalizeCandleDtos(candles: readonly RawCandleInput[]): readonly OHLCVBar[];
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,QAAQ,EAGd,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,SAAS,cAAc,EAAE,GACjC,SAAS,QAAQ,EAAE,CA0CrB"}

package/dist/adapter.js

@@ -0,0 +1,47 @@
+/**
+ * @file packages/chart-financial/src/adapter.ts
+ * Adapter converting raw market contracts (e.g. StoredCandleDto) into canonical OHLCVBar objects.
+ * Truthfulness guarantee: never fabricates artificial candles.
+ */
+import { normalizeTimeSeries, validateOHLCVBar, } from '@tranding-custom-chart/core';
+/**
+ * Normalizes an array of raw candle inputs into strictly validated, sorted OHLCV bars.
+ */
+export function normalizeCandleDtos(candles) {
+    if (!candles || candles.length === 0)
+        return [];
+    const rawBars = [];
+    for (const c of candles) {
+        const timeMs = Date.parse(c.candleStart);
+        if (!Number.isFinite(timeMs) || timeMs <= 0)
+            continue;
+        const time = Math.floor(timeMs / 1000); // Unix timestamp in seconds
+        const open = typeof c.open === 'number' ? c.open : Number.parseFloat(c.open);
+        const high = typeof c.high === 'number' ? c.high : Number.parseFloat(c.high);
+        const low = typeof c.low === 'number' ? c.low : Number.parseFloat(c.low);
+        const close = typeof c.close === 'number' ? c.close : Number.parseFloat(c.close);
+        let volume = null;
+        if (c.volume !== null && c.volume !== undefined) {
+            const parsedVol = typeof c.volume === 'number' ? c.volume : Number.parseFloat(c.volume);
+            if (Number.isFinite(parsedVol) && parsedVol >= 0) {
+                volume = parsedVol;
+            }
+        }
+        const candidate = {
+            time,
+            dateStr: c.candleStart,
+            open,
+            high,
+            low,
+            close,
+            volume,
+            qualityFlags: c.qualityFlags ?? [],
+        };
+        const validation = validateOHLCVBar(candidate);
+        if (validation.valid) {
+            rawBars.push(candidate);
+        }
+    }
+    // Deduplicate by timestamp and sort ascending
+    return normalizeTimeSeries(rawBars, (b) => b.time);
+}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @file packages/chart-financial/src/index.ts
+ * Main entry point for @tranding-custom-chart/financial.
+ */
+export * from './adapter.js';
+export * from './indicators/sma.js';
+export * from './indicators/ema.js';
+export * from './indicators/rsi.js';
+export * from './indicators/bollinger.js';
+export * from './indicators/heikin-ashi.js';
+export * from './indicators/vwap.js';
+export * from './indicators/macd.js';
+export * from './indicators/wma.js';
+export * from './indicators/renko.js';
+export * from './indicators/kagi.js';
+export * from './indicators/line-break.js';
+export * from './indicators/volume-profile.js';
+export * from './indicators/atr.js';
+export * from './indicators/supertrend.js';
+export * from './layout/pane-layout.js';
+//# 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;;;GAGG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * @file packages/chart-financial/src/index.ts
+ * Main entry point for @tranding-custom-chart/financial.
+ */
+export * from './adapter.js';
+export * from './indicators/sma.js';
+export * from './indicators/ema.js';
+export * from './indicators/rsi.js';
+export * from './indicators/bollinger.js';
+export * from './indicators/heikin-ashi.js';
+export * from './indicators/vwap.js';
+export * from './indicators/macd.js';
+export * from './indicators/wma.js';
+export * from './indicators/renko.js';
+export * from './indicators/kagi.js';
+export * from './indicators/line-break.js';
+export * from './indicators/volume-profile.js';
+export * from './indicators/atr.js';
+export * from './indicators/supertrend.js';
+export * from './layout/pane-layout.js';

package/dist/indicators/atr.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @file packages/chart-financial/src/indicators/atr.ts
+ * Average True Range (ATR) calculation engine.
+ */
+import type { OHLCVBar, ATRPoint } from '@tranding-custom-chart/core';
+export interface ATROptions {
+    readonly period?: number | undefined;
+}
+/**
+ * Computes True Range and smoothed Average True Range (ATR).
+ */
+export declare function computeATR(bars: readonly OHLCVBar[], period?: number): readonly ATRPoint[];
+//# sourceMappingURL=atr.d.ts.map

package/dist/indicators/atr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atr.d.ts","sourceRoot":"","sources":["../../src/indicators/atr.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEtE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,SAAS,QAAQ,EAAE,EACzB,MAAM,GAAE,MAAW,GAClB,SAAS,QAAQ,EAAE,CAqCrB"}

package/dist/indicators/atr.js

@@ -0,0 +1,40 @@
+/**
+ * @file packages/chart-financial/src/indicators/atr.ts
+ * Average True Range (ATR) calculation engine.
+ */
+/**
+ * Computes True Range and smoothed Average True Range (ATR).
+ */
+export function computeATR(bars, period = 14) {
+    if (bars.length === 0)
+        return [];
+    const results = [];
+    const p = Math.max(1, period);
+    let prevClose = bars[0].open;
+    let trSum = 0;
+    let prevATR = 0;
+    for (let i = 0; i < bars.length; i++) {
+        const bar = bars[i];
+        const hl = bar.high - bar.low;
+        const hc = Math.abs(bar.high - prevClose);
+        const lc = Math.abs(bar.low - prevClose);
+        const tr = Math.max(hl, hc, lc);
+        let atr = 0;
+        if (i < p) {
+            trSum += tr;
+            atr = trSum / (i + 1);
+            prevATR = atr;
+        }
+        else {
+            atr = (prevATR * (p - 1) + tr) / p;
+            prevATR = atr;
+        }
+        results.push({
+            time: bar.time,
+            tr,
+            atr,
+        });
+        prevClose = bar.close;
+    }
+    return results;
+}

package/dist/indicators/bollinger.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @file packages/chart-financial/src/indicators/bollinger.ts
+ * Bollinger Bands calculation (Middle SMA, Upper Band, Lower Band).
+ */
+import type { OHLCVBar } from '@tranding-custom-chart/core';
+export interface BollingerBandsResult {
+    readonly middle: (number | null)[];
+    readonly upper: (number | null)[];
+    readonly lower: (number | null)[];
+}
+export declare function computeBollingerBands(bars: readonly OHLCVBar[], period?: number, multiplier?: number): BollingerBandsResult;
+//# sourceMappingURL=bollinger.d.ts.map

package/dist/indicators/bollinger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bollinger.d.ts","sourceRoot":"","sources":["../../src/indicators/bollinger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE5D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;CACnC;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,SAAS,QAAQ,EAAE,EACzB,MAAM,SAAK,EACX,UAAU,SAAI,GACb,oBAAoB,CAqCtB"}

package/dist/indicators/bollinger.js

@@ -0,0 +1,34 @@
+/**
+ * @file packages/chart-financial/src/indicators/bollinger.ts
+ * Bollinger Bands calculation (Middle SMA, Upper Band, Lower Band).
+ */
+export function computeBollingerBands(bars, period = 20, multiplier = 2) {
+    const length = bars.length;
+    const middle = new Array(length).fill(null);
+    const upper = new Array(length).fill(null);
+    const lower = new Array(length).fill(null);
+    if (period <= 0 || length < period) {
+        return { middle, upper, lower };
+    }
+    let windowSum = 0;
+    for (let i = 0; i < length; i++) {
+        windowSum += bars[i].close;
+        if (i >= period) {
+            windowSum -= bars[i - period].close;
+        }
+        if (i >= period - 1) {
+            const mean = windowSum / period;
+            middle[i] = mean;
+            // Calculate population variance over the window
+            let varianceSum = 0;
+            for (let j = i - period + 1; j <= i; j++) {
+                const diff = bars[j].close - mean;
+                varianceSum += diff * diff;
+            }
+            const stdDev = Math.sqrt(varianceSum / period);
+            upper[i] = mean + multiplier * stdDev;
+            lower[i] = mean - multiplier * stdDev;
+        }
+    }
+    return { middle, upper, lower };
+}

package/dist/indicators/ema.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @file packages/chart-financial/src/indicators/ema.ts
+ * Exponential Moving Average (EMA) computation with formal initial smoothing.
+ */
+import type { OHLCVBar } from '@tranding-custom-chart/core';
+export declare function computeEMA(bars: readonly OHLCVBar[], period: number): (number | null)[];
+//# sourceMappingURL=ema.d.ts.map

package/dist/indicators/ema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ema.d.ts","sourceRoot":"","sources":["../../src/indicators/ema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE5D,wBAAgB,UAAU,CACxB,IAAI,EAAE,SAAS,QAAQ,EAAE,EACzB,MAAM,EAAE,MAAM,GACb,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAyBnB"}

package/dist/indicators/ema.js

@@ -0,0 +1,26 @@
+/**
+ * @file packages/chart-financial/src/indicators/ema.ts
+ * Exponential Moving Average (EMA) computation with formal initial smoothing.
+ */
+export function computeEMA(bars, period) {
+    if (period <= 0 || bars.length < period) {
+        return bars.map(() => null);
+    }
+    const result = new Array(bars.length).fill(null);
+    const alpha = 2 / (period + 1);
+    // Initialize first EMA value at (period - 1) as simple average
+    let initialSum = 0;
+    for (let i = 0; i < period; i++) {
+        initialSum += bars[i].close;
+    }
+    let prevEma = initialSum / period;
+    result[period - 1] = prevEma;
+    // Compute subsequent EMA values
+    for (let i = period; i < bars.length; i++) {
+        const currentClose = bars[i].close;
+        const currentEma = alpha * currentClose + (1 - alpha) * prevEma;
+        result[i] = currentEma;
+        prevEma = currentEma;
+    }
+    return result;
+}

package/dist/indicators/heikin-ashi.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @file packages/chart-financial/src/indicators/heikin-ashi.ts
+ * Transforms standard OHLCV candlesticks into smoothed Heikin-Ashi candles.
+ *
+ * Formulas:
+ * - Close_HA = (Open + High + Low + Close) / 4
+ * - Open_HA[0] = (Open[0] + Close[0]) / 2
+ * - Open_HA[i] = (Open_HA[i-1] + Close_HA[i-1]) / 2
+ * - High_HA = max(High, Open_HA, Close_HA)
+ * - Low_HA = min(Low, Open_HA, Close_HA)
+ */
+import type { OHLCVBar } from '@tranding-custom-chart/core';
+export declare function computeHeikinAshi(bars: readonly OHLCVBar[]): readonly OHLCVBar[];
+//# sourceMappingURL=heikin-ashi.d.ts.map

package/dist/indicators/heikin-ashi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heikin-ashi.d.ts","sourceRoot":"","sources":["../../src/indicators/heikin-ashi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE5D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,QAAQ,EAAE,GAAG,SAAS,QAAQ,EAAE,CA8BhF"}

package/dist/indicators/heikin-ashi.js

@@ -0,0 +1,36 @@
+/**
+ * @file packages/chart-financial/src/indicators/heikin-ashi.ts
+ * Transforms standard OHLCV candlesticks into smoothed Heikin-Ashi candles.
+ *
+ * Formulas:
+ * - Close_HA = (Open + High + Low + Close) / 4
+ * - Open_HA[0] = (Open[0] + Close[0]) / 2
+ * - Open_HA[i] = (Open_HA[i-1] + Close_HA[i-1]) / 2
+ * - High_HA = max(High, Open_HA, Close_HA)
+ * - Low_HA = min(Low, Open_HA, Close_HA)
+ */
+export function computeHeikinAshi(bars) {
+    if (bars.length === 0)
+        return [];
+    const result = [];
+    for (let i = 0; i < bars.length; i++) {
+        const bar = bars[i];
+        const haClose = (bar.open + bar.high + bar.low + bar.close) / 4;
+        const haOpen = i === 0
+            ? (bar.open + bar.close) / 2
+            : (result[i - 1].open + result[i - 1].close) / 2;
+        const haHigh = Math.max(bar.high, haOpen, haClose);
+        const haLow = Math.min(bar.low, haOpen, haClose);
+        result.push({
+            time: bar.time,
+            open: haOpen,
+            high: haHigh,
+            low: haLow,
+            close: haClose,
+            volume: bar.volume,
+            dateStr: bar.dateStr,
+            qualityFlags: bar.qualityFlags,
+        });
+    }
+    return result;
+}

package/dist/indicators/kagi.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @file packages/chart-financial/src/indicators/kagi.ts
+ * Algorithmic Kagi line generation from sequential OHLCV bars.
+ * Kagi charts filter time and noise, indicating trend reversals and Yang (bullish) / Yin (bearish) inflections.
+ */
+import type { OHLCVBar } from '@tranding-custom-chart/core';
+export interface KagiSegment extends OHLCVBar {
+    readonly isYang: boolean;
+    readonly isUp: boolean;
+    readonly originalIndex: number;
+}
+export interface KagiOptions {
+    readonly reversalAmount?: number | undefined;
+    readonly reversalPercent?: number | undefined;
+}
+/**
+ * Computes Kagi trend segments from standard OHLCV bars.
+ */
+export declare function computeKagi(bars: readonly OHLCVBar[], options?: KagiOptions): readonly KagiSegment[];
+//# sourceMappingURL=kagi.d.ts.map

package/dist/indicators/kagi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kagi.d.ts","sourceRoot":"","sources":["../../src/indicators/kagi.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE5D,MAAM,WAAW,WAAY,SAAQ,QAAQ;IAC3C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/C;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,SAAS,QAAQ,EAAE,EACzB,OAAO,GAAE,WAAgB,GACxB,SAAS,WAAW,EAAE,CAsHxB"}

package/dist/indicators/kagi.js

@@ -0,0 +1,122 @@
+/**
+ * @file packages/chart-financial/src/indicators/kagi.ts
+ * Algorithmic Kagi line generation from sequential OHLCV bars.
+ * Kagi charts filter time and noise, indicating trend reversals and Yang (bullish) / Yin (bearish) inflections.
+ */
+/**
+ * Computes Kagi trend segments from standard OHLCV bars.
+ */
+export function computeKagi(bars, options = {}) {
+    if (bars.length === 0)
+        return [];
+    const firstClose = bars[0].close;
+    const reversalPct = options.reversalPercent ?? 0.01;
+    const reversalThreshold = options.reversalAmount && options.reversalAmount > 0
+        ? options.reversalAmount
+        : Math.max(0.1, Number((firstClose * reversalPct).toFixed(2)));
+    const segments = [];
+    let currentStartPrice = firstClose;
+    let currentEndPrice = firstClose;
+    let currentDirection = null;
+    let isYang = true;
+    let lastShoulder = firstClose; // Previous peak
+    let lastWaist = firstClose; // Previous trough
+    for (let i = 1; i < bars.length; i++) {
+        const bar = bars[i];
+        const price = bar.close;
+        if (currentDirection === null) {
+            if (price >= currentStartPrice + reversalThreshold) {
+                currentDirection = 'up';
+                currentEndPrice = price;
+                lastShoulder = price;
+            }
+            else if (price <= currentStartPrice - reversalThreshold) {
+                currentDirection = 'down';
+                currentEndPrice = price;
+                lastWaist = price;
+                isYang = false;
+            }
+            continue;
+        }
+        if (currentDirection === 'up') {
+            if (price > currentEndPrice) {
+                // Continue upward trend
+                currentEndPrice = price;
+                if (!isYang && price > lastShoulder) {
+                    isYang = true; // Breakout above shoulder turns Yang
+                }
+            }
+            else if (price <= currentEndPrice - reversalThreshold) {
+                // Reversal downwards
+                segments.push({
+                    time: bar.time,
+                    open: currentStartPrice,
+                    high: currentEndPrice,
+                    low: currentStartPrice,
+                    close: currentEndPrice,
+                    volume: bar.volume ?? 0,
+                    isYang,
+                    isUp: true,
+                    originalIndex: i - 1,
+                    dateStr: bar.dateStr,
+                });
+                lastShoulder = currentEndPrice;
+                currentStartPrice = currentEndPrice;
+                currentEndPrice = price;
+                currentDirection = 'down';
+                if (isYang && price < lastWaist) {
+                    isYang = false; // Breakdown below waist turns Yin
+                }
+            }
+        }
+        else {
+            // currentDirection === 'down'
+            if (price < currentEndPrice) {
+                // Continue downward trend
+                currentEndPrice = price;
+                if (isYang && price < lastWaist) {
+                    isYang = false; // Breakdown below waist turns Yin
+                }
+            }
+            else if (price >= currentEndPrice + reversalThreshold) {
+                // Reversal upwards
+                segments.push({
+                    time: bar.time,
+                    open: currentStartPrice,
+                    high: currentStartPrice,
+                    low: currentEndPrice,
+                    close: currentEndPrice,
+                    volume: bar.volume ?? 0,
+                    isYang,
+                    isUp: false,
+                    originalIndex: i - 1,
+                    dateStr: bar.dateStr,
+                });
+                lastWaist = currentEndPrice;
+                currentStartPrice = currentEndPrice;
+                currentEndPrice = price;
+                currentDirection = 'up';
+                if (!isYang && price > lastShoulder) {
+                    isYang = true; // Breakout above shoulder turns Yang
+                }
+            }
+        }
+    }
+    // Push terminal active segment
+    if (currentDirection !== null) {
+        const lastBar = bars[bars.length - 1];
+        segments.push({
+            time: lastBar.time,
+            open: currentStartPrice,
+            high: Math.max(currentStartPrice, currentEndPrice),
+            low: Math.min(currentStartPrice, currentEndPrice),
+            close: currentEndPrice,
+            volume: lastBar.volume ?? 0,
+            isYang,
+            isUp: currentEndPrice >= currentStartPrice,
+            originalIndex: bars.length - 1,
+            dateStr: lastBar.dateStr,
+        });
+    }
+    return segments;
+}

package/dist/indicators/line-break.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @file packages/chart-financial/src/indicators/line-break.ts
+ * Algorithmic Three-Line Break (TLB) chart generation.
+ * Filters minor oscillations, adding new blocks only when price exceeds the extreme of the prior N lines.
+ */
+import type { OHLCVBar } from '@tranding-custom-chart/core';
+export interface LineBreakBar extends OHLCVBar {
+    readonly isUp: boolean;
+    readonly originalIndex: number;
+}
+export interface LineBreakOptions {
+    readonly lineCount?: number | undefined;
+}
+/**
+ * Computes Three-Line Break (TLB) bars from sequential OHLCV bars.
+ */
+export declare function computeLineBreak(bars: readonly OHLCVBar[], options?: LineBreakOptions): readonly LineBreakBar[];
+//# sourceMappingURL=line-break.d.ts.map

package/dist/indicators/line-break.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-break.d.ts","sourceRoot":"","sources":["../../src/indicators/line-break.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE5D,MAAM,WAAW,YAAa,SAAQ,QAAQ;IAC5C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,SAAS,QAAQ,EAAE,EACzB,OAAO,GAAE,gBAAqB,GAC7B,SAAS,YAAY,EAAE,CAoEzB"}

package/dist/indicators/line-break.js

@@ -0,0 +1,73 @@
+/**
+ * @file packages/chart-financial/src/indicators/line-break.ts
+ * Algorithmic Three-Line Break (TLB) chart generation.
+ * Filters minor oscillations, adding new blocks only when price exceeds the extreme of the prior N lines.
+ */
+/**
+ * Computes Three-Line Break (TLB) bars from sequential OHLCV bars.
+ */
+export function computeLineBreak(bars, options = {}) {
+    if (bars.length === 0)
+        return [];
+    const lineCount = Math.max(1, options.lineCount ?? 3);
+    const result = [];
+    // Seed with initial bar
+    const first = bars[0];
+    result.push({
+        time: first.time,
+        open: first.open,
+        high: Math.max(first.open, first.close),
+        low: Math.min(first.open, first.close),
+        close: first.close,
+        volume: first.volume ?? 0,
+        isUp: first.close >= first.open,
+        originalIndex: 0,
+        dateStr: first.dateStr,
+    });
+    for (let i = 1; i < bars.length; i++) {
+        const bar = bars[i];
+        const price = bar.close;
+        // Check extremes of recent N lines
+        const recent = result.slice(-lineCount);
+        let highestHigh = -Infinity;
+        let lowestLow = Infinity;
+        for (const line of recent) {
+            const top = Math.max(line.open, line.close);
+            const bottom = Math.min(line.open, line.close);
+            if (top > highestHigh)
+                highestHigh = top;
+            if (bottom < lowestLow)
+                lowestLow = bottom;
+        }
+        const lastLine = result[result.length - 1];
+        if (price > highestHigh) {
+            // New up line
+            result.push({
+                time: bar.time,
+                open: lastLine.isUp ? lastLine.close : lastLine.open,
+                high: price,
+                low: lastLine.isUp ? lastLine.close : lastLine.open,
+                close: price,
+                volume: bar.volume ?? 0,
+                isUp: true,
+                originalIndex: i,
+                dateStr: bar.dateStr,
+            });
+        }
+        else if (price < lowestLow) {
+            // New down line
+            result.push({
+                time: bar.time,
+                open: !lastLine.isUp ? lastLine.close : lastLine.open,
+                high: !lastLine.isUp ? lastLine.close : lastLine.open,
+                low: price,
+                close: price,
+                volume: bar.volume ?? 0,
+                isUp: false,
+                originalIndex: i,
+                dateStr: bar.dateStr,
+            });
+        }
+    }
+    return result;
+}

package/dist/indicators/macd.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @file packages/chart-financial/src/indicators/macd.ts
+ * Moving Average Convergence Divergence (MACD) calculation.
+ * Outputs MACD Line, Signal Line, and Histogram oscillator.
+ */
+import type { OHLCVBar } from '@tranding-custom-chart/core';
+export interface MACDResult {
+    readonly macd: readonly (number | null)[];
+    readonly signal: readonly (number | null)[];
+    readonly histogram: readonly (number | null)[];
+}
+export declare function computeMACD(bars: readonly OHLCVBar[], fastPeriod?: number, slowPeriod?: number, signalPeriod?: number): MACDResult;
+//# sourceMappingURL=macd.d.ts.map

package/dist/indicators/macd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"macd.d.ts","sourceRoot":"","sources":["../../src/indicators/macd.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAG5D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;CAChD;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,SAAS,QAAQ,EAAE,EACzB,UAAU,SAAK,EACf,UAAU,SAAK,EACf,YAAY,SAAI,GACf,UAAU,CA4DZ"}