Merge pull request tradingview#1945 from tradingview/feature/conflate-bars

Data conflation

Author: illetid

.size-limit.js

@@ -8,7 +8,7 @@ export default [
 	{
 		name: 'ESM',
 		path: 'dist/lightweight-charts.production.mjs',
-		limit: '47.50 KB',
+		limit: '49.50 KB',
 		import: '*',
 		ignore: ['fancy-canvas'],
 		brotli: true,
@@ -48,14 +48,14 @@ export default [
 	{
 		name: 'Standalone-ESM',
 		path: 'dist/lightweight-charts.standalone.production.mjs',
-		limit: '50.00 KB',
+		limit: '51.00 KB',
 		import: '*',
 		brotli: true,
 	},
 	{
 		name: 'Standalone',
 		path: 'dist/lightweight-charts.standalone.production.js',
-		limit: '50.00 KB',
+		limit: '51.00 KB',
 		brotli: true,
 	},
 	{
@@ -87,7 +87,7 @@ export default [
 		path: 'dist/lightweight-charts.production.mjs',
 		import: '{ LineSeries }',
 		ignore: ['fancy-canvas'],
-		limit: '2.7 KB',
+		limit: '2.8 KB',
 		brotli: true,
 	},
 	{

src/api/options/time-scale-options-defaults.ts

@@ -21,4 +21,8 @@ export const timeScaleOptionsDefaults: HorzScaleOptions = {
 	minimumHeight: 0,
 	allowBoldLabels: true,
 	ignoreWhitespaceIndices: false,
+	enableConflation: false,
+	conflationThresholdFactor: 1,
+	precomputeConflationOnInit: false,
+	precomputeConflationPriority: 'background',
 };

src/model/conflation/constants.ts

@@ -0,0 +1,21 @@
+/**
+ * Power-of-2 conflation levels supported by the system.
+ * These represent the number of original data points that get merged into one conflated point.
+ */
+export const CONFLATION_LEVELS = [2, 4, 8, 16, 32, 64, 128, 256, 512] as const;
+
+/**
+ * Maximum conflation level supported.
+ */
+export const MAX_CONFLATION_LEVEL = 512;
+
+/**
+ * Device pixel ratio threshold for conflation.
+ * Conflation happens when barSpacing is less than 1.0 / devicePixelRatio.
+ * This ensures we only conflate when we can't physically display the detail.
+ */
+export const DPR_CONFLATION_THRESHOLD = 1;
+
+export const CONFLATION_ERROR_MESSAGES = {
+	missingPriceValueBuilder: 'Custom series with conflation reducer must have a priceValueBuilder method',
+} as const;