@fintatech/fintachart 3.1.0 → 3.1.2

package/CHANGELOG.md

@@ -5,10 +5,51 @@ 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
+
+- Removed the jQuery dependency. All DOM, drag, and resize behavior is now implemented with native browser APIs (`DomUtils`, `Draggable`, `Resizable`).
+- Improved scrollbar styling and zoom animation smoothness in the chart container.
+- Refreshed documentation and HTML/React examples.
+
+### Removed
+
+- `jquery`, `jquery-ui`, `jquery.ui.touch-punch`, `jquery-i18next`, and `bootstrap-select` runtime dependencies.
+
 ## [3.1.0] - 2026-04-18
 
 ### Added
 
 - 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

@@ -1,9 +1,12 @@
 <div align="center">
   <a href="https://fintatech.com" target="_blank">
-    <img width="200" src="https://raw.githubusercontent.com/fintatech/fintachart/master/.github/logo-200x200.svg" alt="FintaChart logo">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/fintatech/fintachart/master/.github/logo-dark.svg">
+      <img width="400" src="https://raw.githubusercontent.com/fintatech/fintachart/master/.github/logo.svg" alt="FintaChart logo">
+    </picture>
   </a>
 
-  <h1>FintaChart</h1>
+  <h1>FintaChart™ — Financial Charting Library</h1>
 
   [![npm version](https://img.shields.io/npm/v/@fintatech/fintachart.svg)](https://www.npmjs.com/package/@fintatech/fintachart)
 </div>
@@ -12,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
@@ -45,12 +48,11 @@ npm install @fintatech/fintachart
 <link rel="stylesheet" href="node_modules/@fintatech/fintachart/css/FintaChart.min.css">
 
 <!-- 2. Framework dependencies -->
-<script src="node_modules/@fintatech/fintachart/scripts/frameworks/jquery.min.js"></script>
-<script src="node_modules/@fintatech/fintachart/scripts/frameworks/jquery-ui.min.js"></script>
-<script src="node_modules/@fintatech/fintachart/scripts/frameworks/moment.min.js"></script>
 <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>
-<script src="node_modules/@fintatech/fintachart/scripts/frameworks/jquery-i18next.min.js"></script>
 
 <!-- 3. Main bundle -->
 <script src="node_modules/@fintatech/fintachart/scripts/FintaChart.min.js"></script>

package/THIRD_PARTY_NOTICES.md

@@ -1,6 +1,6 @@
 # Third-Party Notices
 
-Trading Chart Designer includes the following third-party libraries,
+FintaChart includes the following third-party libraries,
 all distributed under the MIT License:
 
 | Library | Version | License | URL |

package/basic-objects.html

@@ -14,15 +14,11 @@
         <link rel="stylesheet" href="css/external/jqNumericField.min.css">
         <link rel="stylesheet" href="css/FintaChart.min.css">
 
-        <script src="scripts/frameworks/jquery.min.js"></script>
-        <script src="scripts/frameworks/jquery-ui.min.js"></script>
         <script src="scripts/frameworks/Intl.min.js"></script>
         <script src="scripts/frameworks/moment.min.js"></script>
         <script src="scripts/frameworks/detectizr.min.js"></script>
         <script src="scripts/frameworks/dom-to-image-more.min.js"></script>
         <script src="scripts/frameworks/i18nextXHRBackend.min.js"></script>
-        <script src="scripts/frameworks/jquery-i18next.min.js"></script>
-        <script src="scripts/frameworks/jquery.ui.touch-punch.min.js"></script>
         <script src="scripts/FintaChart.min.js"></script>
         <script src="scripts/jsdataadapters/fileDataAdapter.js"></script>
         <script src="scripts/jsdataadapters/restDataAdapter.js"></script>
@@ -60,7 +56,7 @@
         FintaChart.ResourcePath.localization = 'localization/';
         const datafeed = fileDatafeed;
 
-        $(function () {
+        document.addEventListener('DOMContentLoaded', function () {
             datafeed.init().then(df => {
                 let config = {
                     chartContainer: '#chartContainer',
@@ -79,7 +75,7 @@
                         '4 Hours'/*, '1 Day', '1 Month', '1 Year'*/
                     ]
                 };
-                const chart = window.globalChart = $(config.chartContainer).FintaChart(config);
+                const chart = window.globalChart = FintaChart.createChart(document.querySelector(config.chartContainer), config);
 
                 drawBasicObjects(chart)
             });