openalgo-charts 1.0.28 → 1.0.29

package/README.md

@@ -4,12 +4,12 @@
 
 **A from-scratch, dependency-free HTML5-canvas charting engine for OpenAlgo.**
 
-Professional interactive charts, indicators, drawing tools, order flow, and on-chart trading — six lazy-loaded tiers, zero runtime dependencies, ~33 KB Brotli for the base engine.
+Professional interactive charts, indicators, drawing tools, order flow, and on-chart trading — six lazy-loaded tiers, zero runtime dependencies, ~37 KB Brotli for the base engine.
 
 [![npm version](https://img.shields.io/npm/v/openalgo-charts.svg?color=cb3837&label=npm)](https://www.npmjs.com/package/openalgo-charts)
 [![license](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](./LICENSE)
-[![bundle](https://img.shields.io/badge/brotli-33%20KB%20base%20%C2%B7%2058%20KB%20all%20tiers-brightgreen.svg)](#size-budget)
-[![tests](https://img.shields.io/badge/tests-468%20passing-brightgreen.svg)](#develop)
+[![bundle](https://img.shields.io/badge/brotli-37%20KB%20base%20%C2%B7%2074%20KB%20all%20tiers-brightgreen.svg)](#size-budget)
+[![tests](https://img.shields.io/badge/tests-620%20passing-brightgreen.svg)](#develop)
 [![dependencies](https://img.shields.io/badge/runtime%20deps-0-brightgreen.svg)](#principles)
 
 [**Documentation**](https://marketcalls.github.io/openalgo-charts/)  ·  [**Live examples**](https://marketcalls.github.io/openalgo-charts/examples)  ·  [**Getting started**](./docs/getting-started.md)  ·  [**Architecture**](./ARCHITECTURE.md)
@@ -60,14 +60,14 @@ Import only what you use. Each tier is a separate bundle that registers into the
 
 | Import | Contents | Brotli |
 |---|---|---|
-| `openalgo-charts` | Engine, 13 chart types, panes & scales, primitives, registries, chart state, trading overlay, OpenAlgo feeds | 34.6 KB |
-| `openalgo-charts/indicators` | 18 built-in indicators + the Tier-2 (external-data) contract | 4.5 KB |
-| `openalgo-charts/draw` | 43 drawing tools + a headless drawing controller | 11.3 KB |
+| `openalgo-charts` | Engine, 13 chart types, panes & scales, primitives, registries, chart state, trading overlay, OpenAlgo feeds | 37.0 KB |
+| `openalgo-charts/indicators` | 20 built-in indicators + the Tier-2 (external-data) contract | 6.1 KB |
+| `openalgo-charts/draw` | 43 drawing tools + a headless drawing controller | 11.7 KB |
 | `openalgo-charts/transform` | Heikin Ashi, Renko, Range bars, Line Break, Point & Figure, Kagi | 2.7 KB |
 | `openalgo-charts/profile` | Volume Profile, Market Profile (TPO), Footprint, order flow | 10.1 KB |
 | `openalgo-charts/trade` | Order / position / bracket tools + DOM ladder | 6.6 KB |
 
-Everything together is **69.8 KB Brotli**.
+Everything together is **74.2 KB Brotli**. Figures are the measured `size-limit` output; the trade tier is a delta over the base, which is why base + trade (43.6 KB) is less than their listed sum.
 
 ## What's built
 
@@ -84,7 +84,7 @@ const macd = chart.addIndicator('macd', { fastPeriod: 8 });   // gets its own pa
 macd.setSettings({ 'macd:width': 2, 'macd:lineStyle': 'dashed' });
 ```
 
-18 built-ins: SMA, EMA, WMA, VWAP, Bollinger Bands, Supertrend, Parabolic SAR, Ichimoku Cloud, RSI, MACD, Stochastic, ADX/DMI, CCI, MFI, ATR, Volume, OBV, A/D.
+20 built-ins: SMA, EMA, WMA, VWAP, Bollinger Bands, Supertrend, HalfTrend, Parabolic SAR, Ichimoku Cloud, RSI, MACD, Stochastic, ADX/DMI, CCI, MFI, ATR, William VIX FIX, Volume, OBV, A/D.
 
 The chart owns the whole lifecycle — series, pane placement, reference levels, fixed ranges (RSI 0..100), recompute on data change, teardown. Every plot gets colour, opacity, thickness, and line style for free, generated from the descriptor. Write your own with `registerIndicator`, or use the **Tier-2 contract** for indicators whose data isn't derived from OHLCV (open interest, CVD, any external feed).
 
@@ -122,13 +122,13 @@ Enforced in CI by [`size-limit`](./.size-limit.json) — nothing is excluded, be
 
 | Bundle | Limit | Actual |
 |---|---|---|
-| Base engine | 34 KB | 32.72 KB |
-| Base + trade | 40.5 KB | 39.31 KB |
-| Indicators tier | 9 KB | 4.47 KB |
-| Draw tier | 14 KB | 6.25 KB |
+| Base engine | 40 KB | 37.01 KB |
+| Base + trade | 47 KB | 43.59 KB |
+| Indicators tier | 9 KB | 6.08 KB |
+| Draw tier | 14 KB | 11.73 KB |
 | Transform tier | 5 KB | 2.66 KB |
-| Profile tier | 8 KB | 5.53 KB |
-| **Everything** | **72 KB** | **58.22 KB** |
+| Profile tier | 11 KB | 10.12 KB |
+| **Everything** | **90 KB** | **74.18 KB** |
 
 ## Documentation
 
@@ -143,6 +143,16 @@ npm run build                               # build the library (dist/) the live
 cd website && npm install && npm run dev    # http://localhost:3000/openalgo-charts
 ```
 
+## Agent skills
+
+Teach your AI coding assistant this library:
+
+```bash
+npx skills add https://github.com/marketcalls/openalgo-charts
+```
+
+Installs six skills from [`.github/skills/`](./.github/skills) - a reference hub with 18 deep-dive files covering the whole API surface and its foot-guns, plus task skills for scaffolding a chart, adding indicators, building a terminal, writing a plugin, and debugging. Works with Claude Code, Cursor, Codex, Copilot, Gemini CLI and the rest of the `skills` CLI's supported agents.
+
 ## Examples
 
 Runnable demos in [`examples/`](./examples), including a full **yfinance terminal** ([`examples/yfinance`](./examples/yfinance)) with a full terminal shell: symbol search, interval pills, chart-type picker, indicator menu, a vertical drawing rail, a floating properties bar, generated indicator settings, and layout persistence.
@@ -158,7 +168,7 @@ cd examples/yfinance && pip install -r requirements.txt && python server.py
 ```bash
 npm install        # install dev toolchain
 npm run typecheck  # strict TypeScript check
-npm test           # unit tests (vitest) - 468 across 47 files
+npm test           # unit tests (vitest) - 620 across 50 files
 npm run build      # Rollup -> dist/ (minified ESM per tier + types)
 npm run size       # size-limit (Brotli) against the budget
 npm run e2e        # Playwright Chromium smoke tests
@@ -175,14 +185,14 @@ npm run verify     # typecheck + test + build + size
 
 ## Status & limitations
 
-Version **1.0.8 (published)**. All engine build phases are implemented with 468 unit tests across 47 files.
+Version **1.0.29**. All engine build phases are implemented with 620 unit tests across 50 files.
 
 Known gaps, stated plainly:
 
-- The **Footprint / order-flow renderer** works but has not had its visual pass — hardcoded colours (not theme-aware), a single display mode, no `setOptions`, and `stackedImbalances` is computed but not drawn.
-- **Footprint and order flow need trade-by-trade data classified bid/ask.** OpenAlgo does not store this by default, so it is live-session-only unless you add a tick recorder. See [`ARCHITECTURE.md`](./ARCHITECTURE.md) §6A.
+- **Footprint and order flow need trade-by-trade data classified bid/ask.** OpenAlgo does not store this by default, so it is live-session-only unless you add a tick recorder — `FootprintAggregator` is the live path. See [`ARCHITECTURE.md`](./ARCHITECTURE.md) §6A.
+- **Only `Footprint` is theme-aware among the profile primitives.** `VolumeProfile`, `MarketProfile` and `HorizontalProfile` never read `rc.theme`; their defaults are dark-tuned, so a light theme needs explicit colours. `HorizontalProfile` also hardcodes its POC / value-area line colours and has no `setOptions`.
 - The OpenAlgo **WS/trade adapter wire schemas** ship with injectable transports and offline tests, but the exact field names should be verified against your running OpenAlgo build.
-- Price-scale **`percentage`** and **`indexed-to-100`** modes, and overlay scales on a shared axis, are not implemented.
+- Price-scale **`percentage`** and **`indexed-to-100`** modes are not implemented. (Hidden overlay scales *are* — add a series with `priceScaleId: ''`.)
 - An optional **DOM chrome package** (toolbar, dialogs, command palette, objects panel) is the next planned piece; today that UI lives in the examples.
 
 See [`ARCHITECTURE.md`](./ARCHITECTURE.md) §13a for the full deferred list.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /** Library version string. Matches package.json (published npm release). */
-declare const VERSION = "1.0.24";
+declare const VERSION = "1.0.29";
 /** Returns the current library version. */
 declare function version(): string;
 
@@ -109,8 +109,10 @@ interface PriceRange {
 }
 /**
  * Price-scale mode. `linear` and `logarithmic` are full coordinate transforms;
- * `percentage`/`indexed-to-100` (rebase to a baseline) and overlay scales are
- * not yet implemented (see the README known limitations).
+ * `percentage`/`indexed-to-100` (rebase to a baseline) are not yet implemented
+ * (see the README known limitations). Overlay scales *are* supported — a series
+ * added with `priceScaleId: ''` gets a hidden scale with its own autoscale, see
+ * `Pane._scaleFor`.
  */
 type PriceScaleMode = 'linear' | 'logarithmic';
 interface PriceScaleOptions {
@@ -591,7 +593,13 @@ interface IPrimitive {
 /** Pick the best hit across primitives: nearest distance, then z-order priority. */
 declare function bestHit(hits: readonly (PrimitiveHit | null)[]): PrimitiveHit | null;
 
-type MarkerShape = 'arrowUp' | 'arrowDown' | 'circle' | 'square' | 'triangleUp' | 'triangleDown' | 'diamond' | 'flag' | 'text';
+/**
+ * `labelUp` / `labelDown` are text plates with a tail, for named signals ("Buy",
+ * "Sell") rather than bare glyphs. The tail points *at* the anchor price and the
+ * body sits clear of it: `labelUp`'s tail points up so its body hangs below the
+ * anchor, `labelDown` is the mirror. Both require `text`.
+ */
+type MarkerShape = 'arrowUp' | 'arrowDown' | 'circle' | 'square' | 'triangleUp' | 'triangleDown' | 'diamond' | 'flag' | 'text' | 'labelUp' | 'labelDown';
 type MarkerPosition = 'aboveBar' | 'belowBar' | 'inBar' | 'atPrice';
 type MarkerSize = 'tiny' | 'small' | 'medium' | 'big';
 interface SeriesMarker {
@@ -609,6 +617,12 @@ declare function markerSizePx(size: MarkerSize): number;
 /** Effective glyph px, clamped so it never exceeds the current bar spacing. */
 declare function effectiveMarkerPx(size: MarkerSize, barSpacing: number): number;
 declare function drawShape(ctx: CanvasRenderingContext2D, shape: MarkerShape, cx: number, cy: number, px: number, color: string): void;
+/**
+ * A signal label: rounded plate, contrasting text, and a tail that points at
+ * `anchorY`. All coordinates are bitmap px — the caller has already applied dpr.
+ * `up` puts the tail on the top edge and the body below the anchor.
+ */
+declare function drawLabel(ctx: CanvasRenderingContext2D, up: boolean, cx: number, anchorY: number, text: string, color: string, fontPx: number): void;
 declare class SeriesMarkers implements IPrimitive {
     private readonly _seriesId;
     private _markers;
@@ -858,6 +872,16 @@ declare function plotStyleKeys(plot: IndicatorPlot): {
  * an indicator that already ships colours keeps them.
  */
 declare function indicatorStyleInputs(descriptor: IndicatorDescriptor): IndicatorInput[];
+/**
+ * Chart types a plot can be re-rendered as. A moving average is a line by
+ * default, but the same column of numbers reads better as a histogram or an
+ * area depending on what you are looking for — and a descriptor cannot know
+ * which. Restricted to the types that make sense for a single value column.
+ */
+declare const INDICATOR_PLOT_STYLES: readonly {
+    label: string;
+    value: string;
+}[];
 /** Canonical option list for a `type: 'source'` input, for settings UIs. */
 declare const INDICATOR_SOURCES: readonly {
     label: string;
@@ -979,6 +1003,20 @@ interface IndicatorDescriptor {
      * indicator, so implement this for anything meant to run in a busy live pane.
      */
     calcTail?(bars: readonly Bar[], settings: Readonly<IndicatorSettings>, fromIndex: number, previous: IndicatorValues, store: IndicatorStore): IndicatorValues | null;
+    /**
+     * Optional bar-anchored signal markers — a named "Buy"/"Sell" plate, an arrow
+     * at a crossover. Runs after every `calc`, so it reads the values it just
+     * produced rather than recomputing anything.
+     *
+     * A plot cannot express this: a plot is a column of prices drawn as a line or
+     * histogram, whereas a signal is a discrete event with a label. Returning `[]`
+     * (when a `showLabels`-style input is off, say) clears the layer.
+     */
+    markers?(ctx: {
+        bars: readonly Bar[];
+        values: IndicatorValues;
+        settings: Readonly<IndicatorSettings>;
+    }): readonly SeriesMarker[];
     /** Optional horizontal reference levels drawn in the indicator's pane. */
     levels?(settings: Readonly<IndicatorSettings>): readonly IndicatorLevel[];
     /**
@@ -1243,6 +1281,12 @@ interface IndicatorHost {
     /** Attach a band drawn behind the plots (an Ichimoku cloud). */
     addIndicatorFill(fill: IndicatorFill, paneIndex: number): void;
     removeIndicatorFill(fill: IndicatorFill): void;
+    /**
+     * Detach a signal-marker layer. There is no matching `add`: the layer comes
+     * from `series.createMarkers()` on a plot's own series, so it already lands in
+     * the right pane. Removing a series does not remove its primitives, hence this.
+     */
+    removeIndicatorMarkers(markers: SeriesMarkers): void;
     /** Bars of the primary price series — the calculation input. */
     sourceBars(): readonly Bar[];
     /** Index of a fresh pane for an indicator that wants its own. */
@@ -1760,7 +1804,7 @@ interface ChartOptions {
         schedule: RafScheduler;
         cancel?: RafCanceller;
     };
-    /** Full palette; pass `darkTheme` (default), `lightTheme`, or a custom ChartTheme. */
+    /** Full palette; pass `lightTheme` (the default), `darkTheme`, or a custom ChartTheme. */
     theme?: ChartTheme;
     priceAxisWidth?: number;
     timeAxisHeight?: number;
@@ -3334,4 +3378,4 @@ declare function lerp(a: number, b: number, t: number): number;
  */
 declare function roundToTick(value: number, step: number): number;
 
-export { ALT_PRESET, type AddSeriesOptions, type AggTick, BUILTIN_COMMANDS, type Bar, type BarUpdate, type BarsRequest, BuySellButtons, type BuySellButtonsOptions, CHART_STATE_VERSION, CandleBuilder, type CandleBuilderOptions, type CandleStyle, type CandleUpdate, Chart, type ChartEvent, type ChartOptions, type ChartState, type ChartTheme, type CrosshairMoveEvent, type CustomShortcut, DEFAULT_CANDLE_BUILDER_OPTIONS, DEFAULT_CANDLE_STYLE, DEFAULT_HISTOGRAM_STYLE, DEFAULT_KEYMAP, DEFAULT_PRICE_SCALE_OPTIONS, DEFAULT_THEME, DEFAULT_TIME_NAVIGATOR_OPTIONS, DEFAULT_TIME_SCALE_OPTIONS, DEFAULT_TRADING_COLORS, type DataFeed, DataLayer, type DepthLevel, type DrawItem, EventMarkers, FakeDataFeed, type FeedScheduler, type FillPoint, type HistogramStyle, INDICATOR_LINE_STYLES, INDICATOR_SOURCES, type IPrimitive, IST_OFFSET_SECONDS, type IndexedBar, type IndicatorApi, type IndicatorAttachContext, type IndicatorDescriptor, IndicatorFill, type IndicatorFillOptions, type IndicatorFillSpec, type IndicatorHost, type IndicatorInput, type IndicatorLevel, type IndicatorPlot, type IndicatorSettings, type IndicatorSource, type IndicatorState, type IndicatorStore, type IndicatorValues, InvalidationLevel, type KeymapEntry, type LateTickPolicy, type LegendValue, type LinePoint, type LogicalRange, LogoWatermark, type LogoWatermarkOptions, type LtpEvent, type MarkerPosition, type MarkerShape, type MarkerSize, type MarketDepth, type OpenAlgoConfig, OpenAlgoDataFeed, type OpenAlgoLiveConfig, OpenAlgoLiveDataFeed, type OpenAlgoTradeConfig, OpenAlgoTradeFeed, type OpenAlgoWsConfig, OpenAlgoWsFeed, type OrderSide$1 as OrderSide, type OrderType$1 as OrderType, type OriginalTime, Pane, type PaneInvalidation, PaneLegend, type PaneLegendAction, type PaneLegendOptions, type PaneState, type PlaceOrder, type PositionSide, PriceLine, type PriceLineOptions, type PriceRange, PriceScale, type PriceScaleId, type PriceScaleMode, type PriceScaleOptions, type PriceScaleState, type PrimitiveHit, type PrimitiveHost, type PrimitiveRenderContext, type RendererEntry, type RestoreReport, type SeriesApi, type SeriesDataItem, type SeriesId, type SeriesMarker, SeriesMarkers, type SeriesRenderContext, type SeriesState, type SeriesStyle, type SeriesType, type ShortcutListItem, ShortcutManager, type ShortcutManagerOptions, type ShortcutPreset, type ShortcutScope, type ShortcutTriggerEvent, type Size, type SocketFactory, type SocketLike, type SupertrendPoint, type Tick, TickBarAggregator, type TickMarkType, type TickTimeframe, TimeNavigator, type TimeNavigatorAction, type TimeNavigatorOptions, TimeScale, type TimeScaleOp, type TimeScaleOptions, type TradeFeed, type TradeMarkerVariant, TradeMarkersPrimitive, type TradingColors, TradingController, type TradingHost, type TradingLineStyle, type TradingLineVariant, type TradingOrder, type TradingOrderSide, type TradingOrderType, type TradingPosition, type TradingSettings, type TradingSyncPayload, type TradingTrade, type UTCSeconds, type UnsubscribeFn, VERSION, type VolumeMode, type WatermarkPosition, type Whitespace, type WsControlMessage, type WsMode, type WsState, type ZOrder, atr, autoscaleRange, bestHit, bitmapSize, clamp, compactVolume, conflateBars, conflateItems, conflationGroupSize, createChart, darkTheme, drawShape, effectiveMarkerPx, ema, emaSeries, epochMsToUtcSeconds, eventToCombo, formatCombo, formatIstDate, formatIstTime, formatIstTimeSeconds, formatSubscribe, formatUnsubscribe, generateBars, getChartType, getIndicator, hasIndicator, indicatorDefaults, indicatorStyleInputs, intervalToSeconds, isNewIstDay, isReservedCombo, isValidCombo, isWhitespace, istStringToUtcSeconds, lerp, lightTheme, mapHistoryResponse, mapOrder, mapPosition, markerSizePx, mergeBars, niceTicks, normalizeCombo, optimalBarWidth, parseCombo, parseMessage, plotStyleKeys, precisionForStep, registerChartType, registerIndicator, registeredChartTypes, registeredIndicators, roundToTick, rowTimeToUtcSeconds, rsi, rsiSeries, snapToDevicePixel, sourceValue, sourceValues, supertrend, supertrendSeries, toBar, trueRange, utcSecondsToIstDateString, utcSecondsToIstParts, version, verticalGradient, watermarkRect };
+export { ALT_PRESET, type AddSeriesOptions, type AggTick, BUILTIN_COMMANDS, type Bar, type BarUpdate, type BarsRequest, BuySellButtons, type BuySellButtonsOptions, CHART_STATE_VERSION, CandleBuilder, type CandleBuilderOptions, type CandleStyle, type CandleUpdate, Chart, type ChartEvent, type ChartOptions, type ChartState, type ChartTheme, type CrosshairMoveEvent, type CustomShortcut, DEFAULT_CANDLE_BUILDER_OPTIONS, DEFAULT_CANDLE_STYLE, DEFAULT_HISTOGRAM_STYLE, DEFAULT_KEYMAP, DEFAULT_PRICE_SCALE_OPTIONS, DEFAULT_THEME, DEFAULT_TIME_NAVIGATOR_OPTIONS, DEFAULT_TIME_SCALE_OPTIONS, DEFAULT_TRADING_COLORS, type DataFeed, DataLayer, type DepthLevel, type DrawItem, EventMarkers, FakeDataFeed, type FeedScheduler, type FillPoint, type HistogramStyle, INDICATOR_LINE_STYLES, INDICATOR_PLOT_STYLES, INDICATOR_SOURCES, type IPrimitive, IST_OFFSET_SECONDS, type IndexedBar, type IndicatorApi, type IndicatorAttachContext, type IndicatorDescriptor, IndicatorFill, type IndicatorFillOptions, type IndicatorFillSpec, type IndicatorHost, type IndicatorInput, type IndicatorLevel, type IndicatorPlot, type IndicatorSettings, type IndicatorSource, type IndicatorState, type IndicatorStore, type IndicatorValues, InvalidationLevel, type KeymapEntry, type LateTickPolicy, type LegendValue, type LinePoint, type LogicalRange, LogoWatermark, type LogoWatermarkOptions, type LtpEvent, type MarkerPosition, type MarkerShape, type MarkerSize, type MarketDepth, type OpenAlgoConfig, OpenAlgoDataFeed, type OpenAlgoLiveConfig, OpenAlgoLiveDataFeed, type OpenAlgoTradeConfig, OpenAlgoTradeFeed, type OpenAlgoWsConfig, OpenAlgoWsFeed, type OrderSide$1 as OrderSide, type OrderType$1 as OrderType, type OriginalTime, Pane, type PaneInvalidation, PaneLegend, type PaneLegendAction, type PaneLegendOptions, type PaneState, type PlaceOrder, type PositionSide, PriceLine, type PriceLineOptions, type PriceRange, PriceScale, type PriceScaleId, type PriceScaleMode, type PriceScaleOptions, type PriceScaleState, type PrimitiveHit, type PrimitiveHost, type PrimitiveRenderContext, type RendererEntry, type RestoreReport, type SeriesApi, type SeriesDataItem, type SeriesId, type SeriesMarker, SeriesMarkers, type SeriesRenderContext, type SeriesState, type SeriesStyle, type SeriesType, type ShortcutListItem, ShortcutManager, type ShortcutManagerOptions, type ShortcutPreset, type ShortcutScope, type ShortcutTriggerEvent, type Size, type SocketFactory, type SocketLike, type SupertrendPoint, type Tick, TickBarAggregator, type TickMarkType, type TickTimeframe, TimeNavigator, type TimeNavigatorAction, type TimeNavigatorOptions, TimeScale, type TimeScaleOp, type TimeScaleOptions, type TradeFeed, type TradeMarkerVariant, TradeMarkersPrimitive, type TradingColors, TradingController, type TradingHost, type TradingLineStyle, type TradingLineVariant, type TradingOrder, type TradingOrderSide, type TradingOrderType, type TradingPosition, type TradingSettings, type TradingSyncPayload, type TradingTrade, type UTCSeconds, type UnsubscribeFn, VERSION, type VolumeMode, type WatermarkPosition, type Whitespace, type WsControlMessage, type WsMode, type WsState, type ZOrder, atr, autoscaleRange, bestHit, bitmapSize, clamp, compactVolume, conflateBars, conflateItems, conflationGroupSize, createChart, darkTheme, drawLabel, drawShape, effectiveMarkerPx, ema, emaSeries, epochMsToUtcSeconds, eventToCombo, formatCombo, formatIstDate, formatIstTime, formatIstTimeSeconds, formatSubscribe, formatUnsubscribe, generateBars, getChartType, getIndicator, hasIndicator, indicatorDefaults, indicatorStyleInputs, intervalToSeconds, isNewIstDay, isReservedCombo, isValidCombo, isWhitespace, istStringToUtcSeconds, lerp, lightTheme, mapHistoryResponse, mapOrder, mapPosition, markerSizePx, mergeBars, niceTicks, normalizeCombo, optimalBarWidth, parseCombo, parseMessage, plotStyleKeys, precisionForStep, registerChartType, registerIndicator, registeredChartTypes, registeredIndicators, roundToTick, rowTimeToUtcSeconds, rsi, rsiSeries, snapToDevicePixel, sourceValue, sourceValues, supertrend, supertrendSeries, toBar, trueRange, utcSecondsToIstDateString, utcSecondsToIstParts, version, verticalGradient, watermarkRect };

package/dist/indicators/index.d.ts

@@ -8,6 +8,27 @@ declare const VWAP: IndicatorDescriptor;
 declare const SUPERTREND: IndicatorDescriptor;
 declare const PARABOLIC_SAR: IndicatorDescriptor;
 declare const ICHIMOKU: IndicatorDescriptor;
+/**
+ * HalfTrend — a trend-following level that only moves against the trend once
+ * the opposing side of the range genuinely gives way, so it holds flat through
+ * noise where a moving average would wobble.
+ *
+ * Two state machines run at once. `trend` is what is drawn; `nextTrend` is which
+ * flip is currently *armed*. While a down-flip is armed the indicator tracks the
+ * running maximum of the `amplitude`-bar low; the flip only fires when the mean
+ * high drops under that maximum **and** the bar closes below the previous bar's
+ * low. The up-flip is the mirror. Requiring both a mean crossing and a close
+ * beyond the prior bar's extreme is what keeps the level still.
+ *
+ * On a flip the new level starts from the level the other side ended on, which
+ * is why the line steps rather than jumping to price. `channelDeviation` half-ATR
+ * bands ride the level as a channel, and the flip bar is marked half an ATR
+ * inside the channel.
+ *
+ * Original implementation written from the algorithm's published behaviour, per
+ * ARCHITECTURE.md §0.1 — not ported from any third-party source.
+ */
+declare const HALFTREND: IndicatorDescriptor;
 
 declare const RSI: IndicatorDescriptor;
 declare const MACD: IndicatorDescriptor;
@@ -146,4 +167,4 @@ declare const BUILTIN_INDICATORS: readonly IndicatorDescriptor[];
  */
 declare function registerBuiltinIndicators(): void;
 
-export { ADL, ADX, ATR, BOLLINGER, BUILTIN_INDICATORS, CCI, EMA, ICHIMOKU, INDICATORS_TIER, MACD, MFI, OBV, PARABOLIC_SAR, RSI, SMA, STOCHASTIC, SUPERTREND, type Tier2Context, type Tier2Descriptor, type Tier2Point, VOLUME, VWAP, WILLIAMS_VIX_FIX, WMA, createTier2Indicator, highest, lowest, nulls, registerBuiltinIndicators, rma, sma, stdev, wma };
+export { ADL, ADX, ATR, BOLLINGER, BUILTIN_INDICATORS, CCI, EMA, HALFTREND, ICHIMOKU, INDICATORS_TIER, MACD, MFI, OBV, PARABOLIC_SAR, RSI, SMA, STOCHASTIC, SUPERTREND, type Tier2Context, type Tier2Descriptor, type Tier2Point, VOLUME, VWAP, WILLIAMS_VIX_FIX, WMA, createTier2Indicator, highest, lowest, nulls, registerBuiltinIndicators, rma, sma, stdev, wma };