@fintatech/fintachart 3.1.1 → 3.1.2

package/CHANGELOG.md

@@ -5,6 +5,33 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.1.2] - 2026-05-04
+
+### Added
+
+- `FintaChart.Themes` — public namespace exposing the 10 built-in themes (`defaultTheme`, `darkTheme`, `fintatechDarkTheme`, `beetTheme`, `grayTheme`, `oliveTheme`, `orangeTheme`, `purpleTheme`, `skyTheme`, `tealTheme`).
+- `FintaChart.ThemeUtils.deepMerge(target, source)` for deriving custom themes from a base theme.
+- `ChartTypeNames.LINE` (`'line'`) and `ChartTypeNames.AREA` (`'area'`) — the two chart types that were registered with `ChartTypeFactory` but missing from the public `ChartTypeNames` constant.
+- New example `examples/html/14-instrument-switching/` demonstrating the programmatic instrument-change pattern with `INSTRUMENT_CHANGED` event handling.
+- New custom-indicators guide at `docs/api/custom-indicators.md` covering lifecycle hooks, plot setup, parameters, the two registration patterns (direct add vs `IndicatorFactory.add` for state save/restore), and reserved-field pitfalls.
+- New "Identity & equality" section in `docs/api/instrument.md` documenting the `id`-based equality contract and the silent no-op trap when instruments lack `id`.
+- New "Switching instruments at runtime" section in `docs/api/data-adapters.md` documenting the unique-`id` + explicit `sendBarsRequest()` contract.
+- `id` field populated on the bundled `FileDatafeed` instrument configs (`shared/file-data-adapter.js`, `src/scripts/jsdataadapters/fileDataAdapter.js`).
+
+### Changed
+
+- `chart.appendBars(bars)` now auto-establishes the visible range and calls `refreshAsync(true)` when called on a chart with no visible range set.
+- Renamed example `examples/html/14-custom-datafeed/` to `examples/html/15-custom-datafeed/` to make room for the new instrument-switching example.
+
+### Fixed
+
+- Toolbar / instrument watermark duplication on chart re-create, and scrollbar theme sync when the active theme changes.
+- README quick-start now lists `detectizr.min.js` and `dom-to-image-more.min.js` in the framework script block — both have always been runtime-required and were previously missing from the documented script list, causing `FintaChart.Chart is not a constructor` for anyone copy-pasting the README quick-start.
+- `docs/quick-start/chart-concepts.md` quickstart switched from `chart.chartType = 'candle'` (assignment to the chart-type-instance accessor; throws on string) to `chart.applyChartType('candle')` (the public method that takes a string).
+- Documentation counts unified at **19 chart types** and **114 indicators** across README, introduction, chart-concepts, chart-types, indicators, and custom-indicators (was variously 16+/17 and 95/100+ depending on the doc).
+- `docs/api/events-enums.md` `ChartTypeNames` table rebuilt against the source constant — previously listed fabricated entries (`BAR`, `MOUNTAIN`, `STEP_LINE`, `DOT`, `DASH`, `VOLUME_CANDLE`, etc.) that don't exist; now lists all 19 real entries.
+- `docs/api/indicators.md` "Available Indicator Types" section: removed the unregistered `Encapsulation`, added the missing `EaseOfMovement` and `WWS`. Listed types now match the 114 registered with `IndicatorFactory`.
+
 ## [3.1.1] - 2026-04-22
 
 ### Changed
@@ -23,5 +50,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Initial public release of `@fintatech/fintachart`
 
+[3.1.2]: https://github.com/fintatech/fintachart/releases/tag/v3.1.2
 [3.1.1]: https://github.com/fintatech/fintachart/releases/tag/v3.1.1
 [3.1.0]: https://github.com/fintatech/fintachart/releases/tag/v3.1.0

package/README.md

@@ -15,8 +15,8 @@ High-performance financial charting component for web applications. Designed for
 
 ## Features
 
-- **16+ chart types** — Candlestick, OHLC, Heikin Ashi, Renko, Kagi, Line Break, Point & Figure, Hollow Candle, Range Bar, Candle Volume, Equi Volume, Mountain, Line, Area, and more
-- **100+ technical indicators** — RSI, MACD, Bollinger Bands, Ichimoku, EMA, SMA, Stochastics, and the full range of standard analysis tools
+- **19 chart types** — Candlestick, OHLC, Heikin Ashi, Renko, Kagi, Line Break, Point & Figure, Hollow Candle, Range Bar, Candle Volume, Equi Volume, Line, Area, and more
+- **114 technical indicators** — RSI, MACD, Bollinger Bands, Ichimoku, EMA, SMA, Stochastics, and the full range of standard analysis tools
 - **Drawing and analysis tools** — Lines, channels, rectangles, circles, ellipses, polygons, freehand, arrows, text and image annotations
 - **Fibonacci tools** — Retracements, Fan, Extensions, Arcs, Ellipses, Time Zones
 - **Trend analysis** — Andrews' Pitchfork, Raff Regression, Error Channel, Gann Fan, Speed Lines, Quadrant Lines, Tirone Levels
@@ -50,6 +50,8 @@ npm install @fintatech/fintachart
 <!-- 2. Framework dependencies -->
 <script src="node_modules/@fintatech/fintachart/scripts/frameworks/Intl.min.js"></script>
 <script src="node_modules/@fintatech/fintachart/scripts/frameworks/moment.min.js"></script>
+<script src="node_modules/@fintatech/fintachart/scripts/frameworks/detectizr.min.js"></script>
+<script src="node_modules/@fintatech/fintachart/scripts/frameworks/dom-to-image-more.min.js"></script>
 <script src="node_modules/@fintatech/fintachart/scripts/frameworks/i18nextXHRBackend.min.js"></script>
 
 <!-- 3. Main bundle -->

package/d.ts/FintaChart.d.ts

@@ -3027,6 +3027,16 @@ declare module FintaChart {
         closeMarketFillColor: string;
     }
 }
+declare const defaultTheme: any;
+declare const darkTheme: any;
+declare const fintatechDarkTheme: any;
+declare const beetTheme: any;
+declare const grayTheme: any;
+declare const oliveTheme: any;
+declare const orangeTheme: any;
+declare const purpleTheme: any;
+declare const skyTheme: any;
+declare const tealTheme: any;
 declare module FintaChart {
     enum StrokePriority {
         COLOR = "color"
@@ -3060,6 +3070,19 @@ declare module FintaChart {
         DASH: number[];
         DASH_DOT: number[];
     };
+    const Themes: {
+        readonly default: any;
+        readonly light: any;
+        readonly dark: any;
+        readonly fintatechDark: any;
+        readonly beet: any;
+        readonly gray: any;
+        readonly olive: any;
+        readonly orange: any;
+        readonly purple: any;
+        readonly sky: any;
+        readonly teal: any;
+    };
     /**
      * Represents stroke theme
      */
@@ -3233,6 +3256,13 @@ declare module FintaChart {
         static isLight(chartTheme: any): boolean;
     }
 }
+declare module FintaChart {
+    class ThemeUtils {
+        private static isObject;
+        static deepMerge<T extends object>(target: T, source: Partial<T>): T;
+        private static mergeInto;
+    }
+}
 declare module FintaChart {
     /**
      * Represents container dislocation
@@ -5871,6 +5901,7 @@ declare module FintaChart {
         private _toolbarScroll;
         private _locked;
         private _lastOrderTime;
+        private _disponsed;
         private _autoScaleBtn;
         private _logScaleBtn;
         private _percentScaleBtn;
@@ -15979,6 +16010,8 @@ declare module FintaChart {
         CANDLE_VOLUME: string;
         EQUI_VOLUME: string;
         EQUI_VOLUME_SHADOW: string;
+        LINE: string;
+        AREA: string;
     };
     /**
      * Represents plot bar

package/htmldialogs/Toolbar.html

@@ -481,7 +481,7 @@
                 <div class="tcdToolbarButton-buttonWrapper">
                     <div class="tcdToolbarButton-activateBtn">
                         <span class="tcdToolbarButton-dropdownElement-image tcd-icon tcdSVGIcon"
-                              tcdSVGData="stash"></span>
+                              tcdSVGData="screenshot"></span>
                     </div>
                     <button class="tcdToolbarButton-toggleDropdownBtn">
                         <span class="tcdToolbarButton-dropdownElement-image tcd-icon"></span>
@@ -532,7 +532,7 @@
         <li class="tcdToolbarDivider"></li>
 
             <li class="tcdToolbar-btn toolbar-title tcdToolbarExport" data-i18n="[title]toolbar.title.export">
-                <div class="tcdToolbarButton-dropdownElement-image tcdSVGIcon" tcdSVGData="screenshot"></div>
+                <div class="tcdToolbarButton-dropdownElement-image tcdSVGIcon" tcdSVGData="stash"></div>
                 <a style="display: none" id="tcdToolbarExport_link" download href></a>
             </li>
 

package/package.json

@@ -2,7 +2,7 @@
     "name": "@fintatech/fintachart",
     "description": "FintaChart financial charting component",
     "homepage": "https://fintatech.com",
-    "version": "3.1.1",
+    "version": "3.1.2",
     "types": "./d.ts/FintaChart.d.ts",
     "license": "SEE LICENSE IN LICENSE.md",
     "repository": {