pace-chart-lib 1.0.2 → 1.0.3

package/dist/{components → Components}/Charts/ChartsWithAxis/ChartsWithAxisFunctions.d.ts

@@ -26,47 +26,60 @@ export declare function calculateWidthHeightDynamically(content: string, fontSiz
  */
 export declare function getYAxisLabel(formatOptions: TDefaultChartFormatOptionsType, maxLegendLength: number): number;
 /**
- * Calculates the dynamic chart margins based on chart configuration, window size,
- * legend content, dimension labels, axis titles/labels, and other formatting options.
- * Supports both primary and secondary Y-axes, data tables, and scrollable charts.
- *
- * @param {number} windowWidth - The width of the chart container in pixels.
- * @param {number} windowHeight - The height of the chart container in pixels.
- * @param {number} maxNumberForPrimaryAxis - The maximum numeric value on the primary Y-axis.
- * @param {number} maxNumberForSecondaryAxis - The maximum numeric value on the secondary Y-axis.
- * @param {number} yMaxLeft - Maximum value for scaling the primary Y-axis.
- * @param {TDefaultChartFormatOptionsType} formatOptions - Object containing all chart formatting options.
- * @param {string[]} legendList - Array of legend labels used in the chart.
- * @param {string[]} dimensionList - Array of dimension labels used for X-axis.
- * @param {number} yMaxRight - Maximum value for scaling the secondary Y-axis.
- * @param {boolean} isSecondaryAxisDrawn - Flag indicating whether the secondary Y-axis is displayed.
- * @param {any} xAxisObj - Object containing properties related to the X-axis.
- * @param {boolean} isBarChart - Flag indicating whether the chart is a bar chart.
+ * Calculates horizontal margins (left and right) and returns other layout values needed by the caller.
  *
- * @returns {{
- *   margin: TMargin,
- *   yLabel: number,
- *   xLabel: number,
- *   yTitle: number,
- *   xTitle: number,
- *   dimensionHeightWidthArray: number[],
- *   chartTitleHeight: number,
- *   legendMargin: number,
- *   secondaryYLabel: number,
- *   secondaryAxisTitleWidth: number
- * }} Object containing calculated margins and supporting layout measurements.
- */
-export declare function marginCalculation(windowWidth: number, windowHeight: number, maxNumberForPrimaryAxis: number, maxNumberForSecondaryAxis: number, yMaxLeft: number, formatOptions: TDefaultChartFormatOptionsType, legendList: string[], dimensionList: string[], yMaxRight: number, isSecondaryAxisDrawn: boolean, isNormalizedChart: boolean, isDateType: boolean, isBarChart?: boolean): {
+ * Accepts an optional precomputed metrics object to avoid re-computation.
+ *
+ * @returns {Object} { left: number, right: number, yLabel, yTitle, xLabel, xTitle, dimensionHeightWidthArray, chartTitleHeight, legendMargin, secondaryYLabel, secondaryAxisTitleWidth }
+ */
+export declare function calculateHorizontalMargins(windowWidth: number, windowHeight: number, maxNumberForPrimaryAxis: number, maxNumberForSecondaryAxis: number, yMaxLeft: number, formatOptions: TDefaultChartFormatOptionsType, legendList: string[], dimensionList: string[], yMaxRight: number, isSecondaryAxisDrawn: boolean, isNormalizedChart: boolean, xAxisObject: any, isBarChart?: boolean, precomputedMetrics?: any): {
+    left: number;
+    right: number;
+    yLabel: any;
+    yTitle: any;
+    xLabel: any;
+    xTitle: any;
+    dimensionHeightWidthArray: any;
+    chartTitleHeight: any;
+    legendMargin: any;
+    secondaryYLabel: any;
+    secondaryAxisTitleWidth: any;
+};
+/**
+ * Calculates vertical margins (top and bottom) and returns other layout values needed by the caller.
+ *
+ * Accepts an optional precomputed metrics object to avoid re-computation.
+ *
+ * @returns {Object} { top: number, bottom: number, chartTitleHeight, xAxisRelatedMargin, ... }
+ */
+export declare function calculateVerticalMargins(windowWidth: number, windowHeight: number, maxNumberForPrimaryAxis: number, maxNumberForSecondaryAxis: number, yMaxLeft: number, formatOptions: TDefaultChartFormatOptionsType, legendList: string[], dimensionList: string[], yMaxRight: number, isSecondaryAxisDrawn: boolean, isNormalizedChart: boolean, xAxisObject: any, isBarChart?: boolean, precomputedMetrics?: any, isScrollbarVisible?: boolean): {
+    top: number;
+    bottom: number;
+    chartTitleHeight: any;
+    xAxisRelatedMargin: any;
+    xLabel: any;
+    xTitle: any;
+};
+/**
+ * Backwards-compatible wrapper that returns the same shape as the original marginCalculation
+ * by delegating work to the split horizontal/vertical calculators.
+ *
+ * Now computes metrics once and passes the precomputed result to both calculators.
+ */
+export declare function marginCalculation(windowWidth: number, windowHeight: number, maxNumberForPrimaryAxis: number, maxNumberForSecondaryAxis: number, yMaxLeft: number, formatOptions: TDefaultChartFormatOptionsType, legendList: string[], dimensionList: string[], yMaxRight: number, isSecondaryAxisDrawn: boolean, isNormalizedChart: boolean, xAxisObject: any, isBarChart?: boolean, chartJSON?: TChartJSON): {
     margin: TMargin;
     yLabel: any;
-    xLabel: number;
-    yTitle: number;
-    xTitle: number;
-    dimensionHeightWidthArray: number[];
-    chartTitleHeight: number;
-    legendMargin: number;
+    xLabel: any;
+    yTitle: any;
+    xTitle: any;
+    dimensionHeightWidthArray: any;
+    chartTitleHeight: any;
+    legendMargin: any;
     secondaryYLabel: any;
-    secondaryAxisTitleWidth: number;
+    secondaryAxisTitleWidth: any;
+    visibleBars: any;
+    columnWidth: any;
+    scrollbarVisible: boolean;
 };
 /**
  * Initializes the base SVG and optionally adds a scrollable floating SVG layer
@@ -386,7 +399,7 @@ export declare function setXaxistitle(formatOptions: TDefaultChartFormatOptionsT
  *
  * @returns {any} The SVG selection with the appended Y-axis title.
  */
-export declare function yAxistitle(innerHeight: number, formatOptions: TDefaultChartFormatOptionsType, dataTableHeight: number, barChart: boolean, svg: any, margin: TMargin, yTitle: number, yLabel: number, width?: number): any;
+export declare function yAxistitle(innerHeight: number, formatOptions: TDefaultChartFormatOptionsType, dataTableHeight: number, barChart: boolean, svg: any, margin: TMargin, yTitle: number, yLabel: number, width?: number, xTitle?: number, xLabel?: number): any;
 /**
  * Adds a Y-axis title on the right side (secondary axis) of the chart,
  * handling visibility, positioning, rotation, and styling based on format options.
@@ -624,3 +637,28 @@ export declare const initYaxisBar: (formatOptions: TDefaultChartFormatOptionsTyp
 export declare const dataLabelsPositionForBarChartFamily: (formatOptions: TDefaultChartFormatOptionsType, xCordinate: number, position: number, xScale: any, minValue: number, prevValue?: number, chartType?: string, isSensitivityChart?: boolean, axis?: string) => any;
 export declare const initXaxisTop: (formatOptions: TDefaultChartFormatOptionsType, gTag: any, xLabelSecondary: number, xAxisTop: any) => void;
 export declare const xAxisTitleTop: (formatOptions: TDefaultChartFormatOptionsType, svg: any, margin: TMargin, isSecondaryAxisDrawn: boolean, xLabelSecondary: number, xTitleSecondary: number) => void;
+export declare const bandWidthFromBar: (gapFraction: any, barWidth: number) => number;
+export declare const barWidthFromBand: (gapFraction: any, bandWidth: number) => number;
+/**
+ * Calculate how many bars can be visible without horizontal scroll and the resulting
+ * per-bar column width and gap width. This is a pure function that takes required
+ * inputs and returns the computed layout values instead of mutating outer-scope variables.
+ *
+ * @param innerWidth - drawable width of the plot area in pixels
+ * @param formatOptions - chart formatting options (used for plotAreaGapWidth)
+ * @param chartJSON - chart data/meta (used for number of categories)
+ * @param minBarWidthPx - minimum allowed bar width in pixels (default: 25)
+ *
+ * @returns object containing:
+ *  - visibleBars: number of bars that can be shown without scrolling
+ *  - columnWidth: computed width of each bar (px)
+ *  - gapWidthPx: computed gap width between bars (px)
+ *  - scrollbarVisible: whether a horizontal scrollbar would be required to see all bars
+ */
+export declare function calculateVisibleBars(innerWidth: number, formatOptions: TDefaultChartFormatOptionsType, chartJSON: TChartJSON): {
+    visibleBars: number;
+    columnWidth: number;
+    scrollbarVisible: boolean;
+};
+export declare const clamp: (v: any, a: any, b: any) => number;
+export declare const horizontalScrollBar: (seriesData: any, height: any, width: any, svg: any, margin: any, innerWidth: any, scrollbarVisible: any, visibleBars: any, chartJSON: any, scrollPosition: any, isStackedChart: any, setAndUpdateChartData: any, isBarChart?: boolean) => void;

package/dist/{components → Components}/Charts/ChartsWithoutAxis/ChartsWithoutAxisTypes.types.d.ts

@@ -1,7 +1,9 @@
-import { TData, TDefaultChartFormatOptionsType, TLegendEntry, TPieOfPieSeries } from "../Core/Common.types";
+import { TDefaultChartFormatOptionsType, TLegendEntry, TPieOfPieSeries, TSeries } from "../Core/Common.types";
 export interface IChartProps {
     chartId: string;
-    data: TData;
+    data: {
+        ChartData: TSeries[];
+    };
     clientWidth: number;
     clientHeight: number;
     formatOptions: TDefaultChartFormatOptionsType;

package/dist/{components → Components}/Charts/Core/CommonFunctions.d.ts

@@ -90,7 +90,7 @@ export declare function getNumberWithFormatFunction(displayUnits: any, numberFor
  * @param chartFormatOptions -> rightpane format options;
  * @param event -> optional mouse event to track mouse;
  */
-export declare function showTooltipOnMouseMove(elements: any, chartFormatOptions: TDefaultChartFormatOptionsType, event?: MouseEvent): void;
+export declare function showTooltipOnMouseMove(elements: any, chartFormatOptions: TDefaultChartFormatOptionsType, event?: MouseEvent, markerProp?: any): void;
 export declare function hideTooltipOnMouseOut(): void;
 /**
  * Adds chart title to svg
@@ -234,3 +234,5 @@ export declare const marginCalculationsForChartsWithoutLegends: (chartFormatOpti
 };
 export declare const convertStringToNumber: (value: any) => any;
 export declare function generalizedChartData(chartData: any, dimensionList?: any): any;
+export declare const getJQuerySelector: (strSeletor?: string) => string;
+export declare const connectorNumberFormat: (numerator: any, denominator: any, decimalValues: any, numberFormat: any, x: any, y: any, formatOptions: TDefaultChartFormatOptionsType) => any;

package/dist/{components → Components}/Charts/Core/DefaultProperties.types.d.ts

@@ -24,6 +24,7 @@ export declare const defaultChartFormatOptions: {
     xAxisLabel: {
         xAxisLabelVisibility: boolean;
         xAxisColor: string;
+        xAxisColorInverted: string;
         xAxisWidth: string;
         xAxisLabelFontSize: string;
         xAxisLabelFontFamily: string;
@@ -71,6 +72,7 @@ export declare const defaultChartFormatOptions: {
     yAxisLabel: {
         yAxisLabelVisibility: boolean;
         yAxisColor: string;
+        yAxisColorInverted: string;
         yAxisWidth: string;
         yAxisLabelFontSize: string;
         yAxisLabelFontFamily: string;

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import "./Components/Charts/Core/ChartStyles.scss";
 export { default as ColumnChart } from "./Components/Charts/ChartsWithAxis/ColumnFamily/ColumnChart";
 export { default as CustomColumnChart } from "./Components/Charts/ChartsWithAxis/ColumnFamily/CustomColumnChart";
 export { default as LayeredColumnChart } from "./Components/Charts/ChartsWithAxis/ColumnFamily/LayeredColumnChart";