@kubit-ui-web/react-charts 1.1.0 → 1.3.0

package/README.md

@@ -55,6 +55,9 @@
 **Customizable**: Flexible styling and granular configurations  
 **Responsive**: Adaptable to different screen sizes  
 **TypeScript**: Fully typed for better developer experience  
+**SSR Ready**: Complete Server-Side Rendering support for Next.js, Remix, Gatsby, and more  
+**Error Handling**: Advanced centralized error management system with detailed debugging  
+**Production Safe**: Built-in logging system that's automatically optimized for production builds  
 **Tested**: Complete coverage with Vitest and Testing Library
 
 ## Installation
@@ -86,6 +89,22 @@ yarn add react react-dom
 - React: ^18.3.1
 - React DOM: ^18.3.1
 
+### Tree-Shaking Support
+
+The library supports granular imports for optimal bundle size:
+
+```typescript
+// Import specific charts only
+import { BarChart } from '@kubit-ui-web/react-charts/charts/barChart';
+import { LineChart } from '@kubit-ui-web/react-charts/charts/lineChart';
+// Import specific components only
+import { Node } from '@kubit-ui-web/react-charts/components/node';
+import { Path } from '@kubit-ui-web/react-charts/components/path';
+// Import specific utilities only
+import { logger } from '@kubit-ui-web/react-charts/utils/logger';
+import { isBrowser } from '@kubit-ui-web/react-charts/utils/ssr';
+```
+
 ## Quick Start
 
 ### Importing Components
@@ -97,6 +116,9 @@ import { BarChart, LineChart, PieChart } from '@kubit-ui-web/react-charts';
 import { Node, Path, Plot } from '@kubit-ui-web/react-charts/components';
 // Import types
 import type { BarOrientation, ChartData } from '@kubit-ui-web/react-charts/types';
+// Import utilities
+import { configureLogger, logger } from '@kubit-ui-web/react-charts/utils';
+import { createSVGElement, isBrowser, safeWindow } from '@kubit-ui-web/react-charts/utils';
 ```
 
 ### LineChart Example
@@ -162,6 +184,67 @@ function MyBarChart() {
 }
 ```
 
+### Error Handling Example
+
+```tsx
+import { LineChart } from '@kubit-ui-web/react-charts';
+import type { ChartErrorCollection } from '@kubit-ui-web/react-charts/types';
+import React from 'react';
+
+function ChartWithErrorHandling() {
+  const handleErrors = (errors: ChartErrorCollection) => {
+    // Centralized error handling
+    console.warn('Chart errors:', errors);
+    // Display user-friendly messages or retry logic
+  };
+
+  return (
+    <LineChart data={data} xKey="year" onErrors={handleErrors} width="100%" height="400px">
+      <LineChart.Path dataKey="sales" stroke="#0078D4" />
+      <LineChart.XAxis position="BOTTOM" />
+      <LineChart.YAxis position="LEFT" />
+    </LineChart>
+  );
+}
+```
+
+### SSR (Server-Side Rendering) Support
+
+```tsx
+import { LineChart, isBrowser, safeWindow } from '@kubit-ui-web/react-charts';
+import React from 'react';
+
+function SSRCompatibleChart() {
+  // Safe browser API access
+  const windowWidth = isBrowser() ? safeWindow()?.innerWidth || 800 : 800;
+
+  return (
+    <LineChart data={data} xKey="year" width={windowWidth} height="400px">
+      <LineChart.Path dataKey="sales" stroke="#0078D4" />
+    </LineChart>
+  );
+}
+```
+
+### Logger Configuration
+
+```tsx
+import { configureLogger, logger } from '@kubit-ui-web/react-charts';
+
+// Configure logger for development
+configureLogger({
+  enabled: true,
+  minLevel: 'debug',
+  prefix: '[MyApp Charts]',
+});
+
+// Use logger in your components
+function MyComponent() {
+  logger.info('Chart rendering started');
+  // Chart implementation
+}
+```
+
 ## Available Components
 
 ### Main Charts
@@ -190,6 +273,19 @@ function MyBarChart() {
 | **`useFocus`** | Focus state management for accessibility |
 | **`useHover`** | Hover detection with callbacks           |
 
+### Utility Functions
+
+| Utility                      | Description                                        |
+| ---------------------------- | -------------------------------------------------- |
+| **`logger`**                 | Production-safe logging with configurable levels   |
+| **`configureLogger`**        | Logger configuration for development/debugging     |
+| **`isBrowser`**              | Environment detection for browser vs SSR           |
+| **`isServer`**               | Check if running in server-side environment        |
+| **`safeWindow`**             | Safe access to window object in SSR environments   |
+| **`safeDocument`**           | Safe access to document object in SSR environments |
+| **`createSVGElement`**       | SSR-compatible SVG element creation                |
+| **`createErrorAccumulator`** | Advanced error management for chart components     |
+
 ## API Reference
 
 For detailed API documentation, component props, and advanced examples, please refer to our individual component READMEs:

package/dist/cjs/charts/barChart/barChart.type.d.ts

@@ -5,6 +5,7 @@ import type { BarChartStyles, BarOrientation } from '../../components/bar/bar.ty
 import type { PathProps, StyleProps } from '../../components/path/path.types';
 import type { TickData } from '../../components/tick/tick.types';
 import type { CanvasConfig } from '../../types/canvas.type';
+import type { ChartError, ChartErrorCollection, ErrorType } from '../../types/errors.type';
 import type { Positions } from '../../types/position.enum';
 export type BarChartChildrenType = ReactNode | ReactElement<PathProps | XAxisProps | YAxisProps>;
 export interface BarChartIDataPoint {
@@ -51,6 +52,8 @@ export type BarChartContextType = Omit<BarChartExtraSpacings, OmitLineProps> & {
     barChildrenCount: number;
     gapBetweenBars?: number;
     orientation: (typeof BarOrientation)[keyof typeof BarOrientation];
+    error?: ChartError;
+    addError?: (errorType: keyof typeof ErrorType, error: Omit<ChartError, 'type'>) => void;
 };
 export interface BarChartProps {
     children: BarChartChildrenType;
@@ -74,6 +77,7 @@ export interface BarChartProps {
     onBlur?: (event: React.FocusEvent<SVGElement>) => void;
     onKeyDown?: (event: React.KeyboardEvent<SVGSVGElement>) => void;
     onKeyUp?: (event: React.KeyboardEvent<SVGSVGElement>) => void;
+    onErrors?: (errors: ChartErrorCollection) => void;
 }
 export interface BarChartTickNumeric {
     max: number;

package/dist/cjs/charts/barChart/barChart.type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"barChart.type.d.ts","sourceRoot":"","sources":["../../../../src/charts/barChart/barChart.type.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"barChart.type.d.ts","sourceRoot":"","sources":["../../../../src/charts/barChart/barChart.type.ts"],"names":[],"mappings":"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"}

package/dist/cjs/charts/barChart/barChartStructure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"barChartStructure.d.ts","sourceRoot":"","sources":["../../../../src/charts/barChart/barChartStructure.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAOrD,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CAyFrD,CAAC"}
+{"version":3,"file":"barChartStructure.d.ts","sourceRoot":"","sources":["../../../../src/charts/barChart/barChartStructure.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAOrD,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CAoGrD,CAAC"}

package/dist/cjs/charts/barChart/barChartStructure.js

@@ -3,6 +3,7 @@ import { Children, useMemo } from 'react';
 import { SvgContainer } from '../../components/svgContainer/svgContainer';
 import { buildViewBox } from '../../components/svgContainer/utils/buildViewBox/buildViewBox';
 import { DefaultCanvasConfig } from '../../types/canvas.type';
+import { createErrorAccumulator } from '../../utils/createErrorAccumulator';
 import { getDataFingerprint } from '../../utils/getDataFingerprint/getDataFingerprint';
 import { parseStringToNumberPx } from '../../utils/parseStringToNumberPx.ts/parseStringToNumberPx';
 import { BarChartContext } from './context/barChartContext';
@@ -10,7 +11,7 @@ import { buildBarContextValue } from './context/buildBarContextValues';
 import { BarChartXAxis } from './fragments/barChartXAxis';
 import { BarChartYAxis } from './fragments/barChartYAxis';
 import { countBarChildren } from './utils/countBarChildren';
-export const BarChartStructure = ({ canvasConfig = DefaultCanvasConfig, caption, children, classNames, data, dataTestId, gapBetweenBars = 0, height = '100%', orientation, pKey, role, tabIndex, width = '100%', ...props }) => {
+export const BarChartStructure = ({ canvasConfig = DefaultCanvasConfig, caption, children, classNames, data, dataTestId, gapBetweenBars = 0, height = '100%', onErrors, orientation, pKey, role, tabIndex, width = '100%', ...props }) => {
     // Extracts and sets default values for canvas configuration
     const { extraSpace: canvasExtraSpace, height: canvasHeight, width: canvasWidth } = canvasConfig;
     const parsedCanvasWidth = parseStringToNumberPx(canvasWidth);
@@ -32,11 +33,17 @@ export const BarChartStructure = ({ canvasConfig = DefaultCanvasConfig, caption,
     const maxValue = Math.max(parsedCanvasWidth, parsedCanvasHeight, parsedCanvasExtraSpace ?? 0);
     const ajustedX = parsedCanvasWidth / maxValue;
     const ajustedY = parsedCanvasHeight / maxValue;
+    const errorAccumulator = useMemo(() => createErrorAccumulator(onErrors), [onErrors]);
     // Create a fingerprint of the data to avoid unnecessary contextValue updates
     const dataFingerprint = getDataFingerprint(data);
     // Build the context value
     const contextValue = useMemo(() => {
+        // Clear previous errors before building new context
+        errorAccumulator.clearErrors();
         return buildBarContextValue({
+            addError: (errorType, error) => {
+                errorAccumulator.addError(errorType, error);
+            },
             ajustedX,
             ajustedY,
             canvasHeight: parsedCanvasHeight,
@@ -48,7 +55,7 @@ export const BarChartStructure = ({ canvasConfig = DefaultCanvasConfig, caption,
             pKey,
             viewBox,
         });
-    }, [canvasHeight, canvasWidth, dataFingerprint, pKey, orientation]);
+    }, [canvasHeight, canvasWidth, dataFingerprint, pKey, orientation, errorAccumulator.addError]);
     return (_jsx(SvgContainer, { caption: caption, className: classNames, dataTestId: dataTestId, height: height, role: role, tabIndex: tabIndex, viewBox: viewBox, width: width, ...props, children: _jsx(BarChartContext.Provider, { value: {
                 ...contextValue,
                 barChildrenCount,

package/dist/cjs/charts/barChart/context/buildBarContextValues.d.ts

@@ -1,4 +1,5 @@
 import { BarOrientation } from '../../../components/bar/bar.type';
+import { type ChartError, ErrorType } from '../../../types/errors.type';
 import type { BarChartChildrenType, BarChartContextType, BarChartIDataPoint } from '../barChart.type';
 interface BuildContextValue {
     children: BarChartChildrenType;
@@ -11,6 +12,7 @@ interface BuildContextValue {
     gapBetweenBars: number;
     orientation: (typeof BarOrientation)[keyof typeof BarOrientation];
     viewBox: string;
+    addError?: (errorType: keyof typeof ErrorType, error: Omit<ChartError, 'type'>) => void;
 }
 type OmitProps = 'data' | 'pKey' | 'canvasHeight' | 'canvasWidth' | 'canvasExtraSpace' | 'xBreakAxis' | 'yBreakAxis' | 'xCursor' | 'yCursor' | 'barChildrenCount' | 'orientation';
 /**
@@ -19,6 +21,6 @@ type OmitProps = 'data' | 'pKey' | 'canvasHeight' | 'canvasWidth' | 'canvasExtra
  * @param {BuildContextValue} options - The options for building the context value.
  * @returns {LineContextValue} - The built context value.
  */
-export declare const buildBarContextValue: ({ ajustedX, ajustedY, canvasHeight, canvasWidth, children, data, gapBetweenBars, orientation, pKey, viewBox, }: BuildContextValue) => Omit<BarChartContextType, OmitProps>;
+export declare const buildBarContextValue: ({ addError, ajustedX, ajustedY, canvasHeight, canvasWidth, children, data, gapBetweenBars, orientation, pKey, viewBox, }: BuildContextValue) => Omit<BarChartContextType, OmitProps>;
 export {};
 //# sourceMappingURL=buildBarContextValues.d.ts.map

package/dist/cjs/charts/barChart/context/buildBarContextValues.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildBarContextValues.d.ts","sourceRoot":"","sources":["../../../../../src/charts/barChart/context/buildBarContextValues.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAO3D,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAG1B,UAAU,iBAAiB;IACzB,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,IAAI,EAAE,kBAAkB,EAAE,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;IAClE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,KAAK,SAAS,GACV,MAAM,GACN,MAAM,GACN,cAAc,GACd,aAAa,GACb,kBAAkB,GAClB,YAAY,GACZ,YAAY,GACZ,SAAS,GACT,SAAS,GACT,kBAAkB,GAClB,aAAa,CAAC;AAElB;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,gHAWlC,iBAAiB,KAAG,IAAI,CAAC,mBAAmB,EAAE,SAAS,CA2GzD,CAAC"}
+{"version":3,"file":"buildBarContextValues.d.ts","sourceRoot":"","sources":["../../../../../src/charts/barChart/context/buildBarContextValues.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,KAAK,UAAU,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAoBjE,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAI1B,UAAU,iBAAiB;IACzB,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,IAAI,EAAE,kBAAkB,EAAE,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,OAAO,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;CACzF;AAED,KAAK,SAAS,GACV,MAAM,GACN,MAAM,GACN,cAAc,GACd,aAAa,GACb,kBAAkB,GAClB,YAAY,GACZ,YAAY,GACZ,SAAS,GACT,SAAS,GACT,kBAAkB,GAClB,aAAa,CAAC;AAElB;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,0HAYlC,iBAAiB,KAAG,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAkSzD,CAAC"}

package/dist/cjs/charts/barChart/context/buildBarContextValues.js

@@ -1,8 +1,12 @@
 import { BarOrientation } from '../../../components/bar/bar.type';
+import { ErrorType } from '../../../types/errors.type';
 import { Positions } from '../../../types/position.enum';
+import { BuildError, buildBarDistributionError, buildCanvasDimensionsError, buildError, } from '../../../utils/buildErrors/buildErrors';
 import { getXCoordinates, getYCoordinates } from '../../../utils/getCoordinates/getCoordinates';
 import { getPoints } from '../../../utils/getPoints/getPoints';
 import { getXTicks, getYTicks } from '../../../utils/getTicks/getTicks';
+import { AXIS_VALIDATION, BAR_CHART_DEFAULTS, BAR_CHART_FALLBACK_DATA, BREAK_AXIS_DEFAULTS, CHART_CANVAS_DEFAULTS, SHARED_FALLBACK_DATA, } from '../../constants/chartDefaults';
+import { countBarChildren } from '../utils/countBarChildren';
 import { getAxisExtraSpacing } from '../utils/getAxisExtraSpacing';
 /**
  * Builds the context value for the line chart.
@@ -10,17 +14,62 @@ import { getAxisExtraSpacing } from '../utils/getAxisExtraSpacing';
  * @param {BuildContextValue} options - The options for building the context value.
  * @returns {LineContextValue} - The built context value.
  */
-export const buildBarContextValue = ({ ajustedX, ajustedY, canvasHeight, canvasWidth, children, data, gapBetweenBars, orientation, pKey, viewBox, }) => {
+export const buildBarContextValue = ({ addError, ajustedX, ajustedY, canvasHeight, canvasWidth, children, data, gapBetweenBars, orientation, pKey, viewBox, }) => {
+    let error = undefined;
+    // 1. Validate data exists
+    if (!data || data.length === 0) {
+        const dataError = {
+            error: buildError(BuildError.BAR_CHART_NO_DATA),
+        };
+        addError?.('BAR_CHART_CONTEXT_ERROR', dataError);
+        error = dataError;
+    }
+    // 2. Validate canvas dimensions
+    if (canvasWidth <= 0 || canvasHeight <= 0) {
+        const canvasError = {
+            error: buildCanvasDimensionsError(canvasWidth, canvasHeight),
+        };
+        addError?.('BAR_CHART_CONTEXT_ERROR', canvasError);
+        error = canvasError;
+    }
+    // 3. Validate bar spacing and distribution
+    const barChildrenCount = countBarChildren(children);
+    const defaultBarWidth = BAR_CHART_DEFAULTS.BAR_WIDTH; // Default width used in BarChartPath
+    const requiredSpace = barChildrenCount * defaultBarWidth;
+    const totalGapSpace = (barChildrenCount - 1) * gapBetweenBars;
+    const availableSpace = orientation === BarOrientation.VERTICAL ? canvasWidth : canvasHeight;
+    if (requiredSpace + totalGapSpace > availableSpace) {
+        const distributionError = {
+            error: buildBarDistributionError('all', `Insufficient space: requires ${requiredSpace + totalGapSpace}px but only ${availableSpace}px available`),
+        };
+        addError?.('BAR_CHART_CONTEXT_ERROR', distributionError);
+        error = distributionError;
+    }
+    // Use safe defaults for data processing if there are critical errors
+    const safeData = data && data.length > 0
+        ? data
+        : [
+            {
+                [BAR_CHART_FALLBACK_DATA.FALLBACK_SECONDARY_KEY]: BAR_CHART_FALLBACK_DATA.DEFAULT_X_VALUE,
+                [pKey]: SHARED_FALLBACK_DATA.FALLBACK_PKEY_FIRST,
+            },
+            {
+                [BAR_CHART_FALLBACK_DATA.FALLBACK_SECONDARY_KEY]: BAR_CHART_FALLBACK_DATA.DEFAULT_X_VALUE,
+                [pKey]: SHARED_FALLBACK_DATA.FALLBACK_PKEY_SECOND,
+            },
+        ];
+    const safeCanvasWidth = canvasWidth > 0 ? canvasWidth : CHART_CANVAS_DEFAULTS.SAFE_WIDTH;
+    const safeCanvasHeight = canvasHeight > 0 ? canvasHeight : CHART_CANVAS_DEFAULTS.SAFE_HEIGHT;
     /**
      * Get the extra spacings for the line chart.
      */
     const { barChartXPosition, barChartYPosition, extraSpaceBottomY, extraSpaceLeftX, extraSpaceRightX, extraSpaceTopY, securityXSpace, securityYSpace, xAxisText, xBreakAxis, xData, yAxisText, yBreakAxis, yData, } = getAxisExtraSpacing({
         ajustedX,
         ajustedY,
-        canvasHeight,
-        canvasWidth,
+        canvasHeight: safeCanvasHeight,
+        canvasWidth: safeCanvasWidth,
         children,
-        data,
+        data: safeData,
         gapBetweenBars,
         orientation,
         pKey,
@@ -33,35 +82,94 @@ export const buildBarContextValue = ({ ajustedX, ajustedY, canvasHeight, canvasW
     const yAxisSpace = extraSpaceLeftX + extraSpaceRightX;
     const xTickValue = getXTicks({
         initPos: extraSpaceLeftX,
-        maxSpaceAvailable: canvasWidth,
+        maxSpaceAvailable: safeCanvasWidth,
         otherAxisSpace: yAxisSpace,
         securitySpace: securityXSpace,
         tickValues: xData,
     });
+    if ((xTickValue ?? []).some(({ position }) => isNaN(position))) {
+        const xTickError = {
+            error: buildError(BuildError.INVALID_X_TICK),
+        };
+        addError?.('BAR_CHART_CONTEXT_ERROR', xTickError);
+        error = xTickError;
+    }
+    // Validate X-axis tick values
+    if (xTickValue) {
+        const hasInsufficientTicks = xTickValue.length < AXIS_VALIDATION.MIN_TICK_COUNT;
+        const hasIdenticalValues = xTickValue.length >= AXIS_VALIDATION.MIN_TICK_COUNT &&
+            new Set(xTickValue.map(tick => tick.value)).size === AXIS_VALIDATION.UNIQUE_VALUE_THRESHOLD;
+        if (hasInsufficientTicks) {
+            const xAxisError = {
+                error: buildError(BuildError.LINE_CHART_X_AXIS_INSUFFICIENT_TICKS),
+            };
+            addError?.('BAR_CHART_X_AXIS_ERROR', xAxisError);
+            if (!error) {
+                error = xAxisError;
+            }
+        }
+        if (hasIdenticalValues) {
+            const xAxisError = {
+                error: buildError(BuildError.LINE_CHART_X_AXIS_IDENTICAL_VALUES),
+            };
+            addError?.('BAR_CHART_X_AXIS_ERROR', xAxisError);
+            if (!error) {
+                error = xAxisError;
+            }
+        }
+    }
     /**
      * Calculate the tick values for the Y Axis.
      */
     const crossYAxis = barChartYPosition !== Positions.LEFT && barChartYPosition !== Positions.RIGHT;
     const otherAxisSpace = extraSpaceTopY + extraSpaceBottomY;
     const yTickValue = getYTicks({
-        initPos: canvasHeight - extraSpaceBottomY,
-        maxSpaceAvailable: canvasHeight,
+        initPos: safeCanvasHeight - extraSpaceBottomY,
+        maxSpaceAvailable: safeCanvasHeight,
         needAjusted: orientation === BarOrientation.HORIZONTAL,
         otherAxisSpace,
         securitySpace: securityYSpace,
         tickValues: yData,
     });
+    // Validate Y-axis tick values
+    if (yTickValue) {
+        const hasInsufficientTicks = yTickValue.length < AXIS_VALIDATION.MIN_TICK_COUNT;
+        const hasIdenticalValues = yTickValue.length >= AXIS_VALIDATION.MIN_TICK_COUNT &&
+            new Set(yTickValue.map(tick => tick.value)).size === AXIS_VALIDATION.UNIQUE_VALUE_THRESHOLD;
+        if (hasInsufficientTicks) {
+            const yAxisError = {
+                error: buildError(BuildError.LINE_CHART_Y_AXIS_INSUFFICIENT_TICKS),
+            };
+            addError?.('BAR_CHART_Y_AXIS_ERROR', yAxisError);
+            if (!error) {
+                error = yAxisError;
+            }
+        }
+        if (hasIdenticalValues) {
+            const yAxisError = {
+                error: buildError(BuildError.LINE_CHART_Y_AXIS_IDENTICAL_VALUES),
+            };
+            addError?.('BAR_CHART_Y_AXIS_ERROR', yAxisError);
+            if (!error) {
+                error = yAxisError;
+            }
+        }
+    }
     /**
      * Calculate the custom breakAxis for the X and Y Axis.
      */
-    const customBreakXAxis = crossXAxis ? getPoints(yTickValue || [], [String(xBreakAxis)])[0] : 0;
-    const customBreakYAxis = crossYAxis ? getPoints(xTickValue || [], [String(yBreakAxis)])[0] : 0;
+    const customBreakXAxis = crossXAxis
+        ? getPoints(yTickValue || [], [String(xBreakAxis)])[0]
+        : BREAK_AXIS_DEFAULTS.DEFAULT_BREAK_VALUE;
+    const customBreakYAxis = crossYAxis
+        ? getPoints(xTickValue || [], [String(yBreakAxis)])[0]
+        : BREAK_AXIS_DEFAULTS.DEFAULT_BREAK_VALUE;
     /**
      * Calculate the X coordinates for the line chart.
      */
     const xCoordinates = getXCoordinates({
-        canvasHeight,
-        canvasWidth,
+        canvasHeight: safeCanvasHeight,
+        canvasWidth: safeCanvasWidth,
         customBreakAxis: Number(customBreakXAxis),
         extraSpaceBottomY,
         extraSpaceLeftX,
@@ -74,8 +182,8 @@ export const buildBarContextValue = ({ ajustedX, ajustedY, canvasHeight, canvasW
      * Calculate the Y coordinates for the line chart.
      */
     const yCoordinates = getYCoordinates({
-        canvasHeight,
-        canvasWidth,
+        canvasHeight: safeCanvasHeight,
+        canvasWidth: safeCanvasWidth,
         customBreakAxis: Number(customBreakYAxis),
         extraSpaceBottomY,
         extraSpaceLeftX,
@@ -84,18 +192,71 @@ export const buildBarContextValue = ({ ajustedX, ajustedY, canvasHeight, canvasW
         position: barChartYPosition,
         securityYSpace,
     });
-    return {
+    // Validate axis coordinates for zero-length axes
+    if (xCoordinates.x1 === xCoordinates.x2) {
+        const xAxisError = {
+            error: buildError(BuildError.LINE_CHART_X_AXIS_ZERO_LENGTH),
+        };
+        addError?.('BAR_CHART_X_AXIS_ERROR', xAxisError);
+        if (!error) {
+            error = xAxisError;
+        }
+    }
+    if (yCoordinates.y1 === yCoordinates.y2) {
+        const yAxisError = {
+            error: buildError(BuildError.LINE_CHART_Y_AXIS_ZERO_LENGTH),
+        };
+        addError?.('BAR_CHART_Y_AXIS_ERROR', yAxisError);
+        if (!error) {
+            error = yAxisError;
+        }
+    }
+    const baseContext = {
+        addError,
         crossXAxis,
         crossYAxis,
+        data: safeData,
         extraSpaceBottomY,
         extraSpaceLeftX,
         extraSpaceRightX,
         extraSpaceTopY,
         securityXSpace,
         securityYSpace,
-        xAxisCoordinates: { coordinates: xCoordinates, tickValues: xTickValue },
+        xAxisCoordinates: {
+            coordinates: xCoordinates,
+            tickValues: xTickValue ||
+                (error
+                    ? [
+                        {
+                            position: BREAK_AXIS_DEFAULTS.DEFAULT_BREAK_VALUE,
+                            value: SHARED_FALLBACK_DATA.FALLBACK_PKEY_FIRST,
+                        },
+                        { position: safeCanvasWidth, value: SHARED_FALLBACK_DATA.FALLBACK_PKEY_SECOND },
+                    ]
+                    : []),
+        },
         xAxisText,
-        yAxisCoordinates: { coordinates: yCoordinates, tickValues: yTickValue },
+        yAxisCoordinates: {
+            coordinates: yCoordinates,
+            tickValues: yTickValue ||
+                (error
+                    ? [
+                        { position: safeCanvasHeight, value: SHARED_FALLBACK_DATA.FALLBACK_PKEY_FIRST },
+                        {
+                            position: BREAK_AXIS_DEFAULTS.DEFAULT_BREAK_VALUE,
+                            value: SHARED_FALLBACK_DATA.FALLBACK_PKEY_SECOND,
+                        },
+                    ]
+                    : []),
+        },
         yAxisText,
     };
+    // Add error only if it exists
+    if (error) {
+        return {
+            ...baseContext,
+            error: { ...error, type: ErrorType.BAR_CHART_CONTEXT_ERROR },
+        };
+    }
+    return baseContext;
 };

package/dist/cjs/charts/barChart/fragments/barChartPath.d.ts

@@ -1,3 +1,9 @@
 import type { BarChartPathProps } from '../barChart.type';
+/**
+ * Extracts the values for a specific key from the dataset
+ * @param data Array of data points
+ * @param key Key to extract values from
+ * @returns Array of values for the given key
+ */
 export declare const BarChartPath: React.FC<BarChartPathProps>;
 //# sourceMappingURL=barChartPath.d.ts.map

package/dist/cjs/charts/barChart/fragments/barChartPath.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"barChartPath.d.ts","sourceRoot":"","sources":["../../../../../src/charts/barChart/fragments/barChartPath.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CA6CpD,CAAC"}
+{"version":3,"file":"barChartPath.d.ts","sourceRoot":"","sources":["../../../../../src/charts/barChart/fragments/barChartPath.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D;;;;;GAKG;AAEH,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CA8EpD,CAAC"}

package/dist/cjs/charts/barChart/fragments/barChartPath.js

@@ -1,18 +1,52 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { useContext } from 'react';
+import { useContext, useEffect } from 'react';
 import { Bar } from '../../../components/bar/bar';
 import { BarOrientation } from '../../../components/bar/bar.type';
+import { buildBarNegativeValueError, buildBarValueError, buildDataKeyNotFoundError, } from '../../../utils/buildErrors/buildErrors';
 import { getPoints } from '../../../utils/getPoints/getPoints';
 import { BarChartContext } from '../context/barChartContext';
+/**
+ * Extracts the values for a specific key from the dataset
+ * @param data Array of data points
+ * @param key Key to extract values from
+ * @returns Array of values for the given key
+ */
 export const BarChartPath = ({ barConfig, dataIdx, dataKey, order, ...props }) => {
-    const { xAxisCoordinates, yAxisCoordinates, ...context } = useContext(BarChartContext);
+    const { addError, xAxisCoordinates, yAxisCoordinates, ...context } = useContext(BarChartContext);
     const { coordinates: xACoord, tickValues: xTickValues } = xAxisCoordinates;
     const { coordinates: yACoord, tickValues: yTickValues } = yAxisCoordinates;
     const isVertical = context.orientation === BarOrientation.VERTICAL;
     const xKey = isVertical ? context.pKey : dataKey;
     const yKey = isVertical ? dataKey : context.pKey;
-    const xData = context.data[dataIdx][xKey];
-    const yData = context.data[dataIdx][yKey];
+    // Safe data access
+    const dataItem = context.data[dataIdx];
+    const xData = dataItem?.[xKey];
+    const yData = dataItem?.[yKey];
+    // Path error validations - only validates the data for this specific bar
+    useEffect(() => {
+        // Validate dataKey exists in dataset
+        if (context.data.length > 0 &&
+            !Object.prototype.hasOwnProperty.call(context.data[0], dataKey)) {
+            addError?.('BAR_CHART_PATH_ERROR', {
+                error: buildDataKeyNotFoundError(dataKey),
+            });
+            return; // Stop validation if dataKey doesn't exist
+        }
+        // Validate bar value is numeric
+        const numericValue = Number(yData);
+        if (isNaN(numericValue)) {
+            addError?.('BAR_CHART_PATH_ERROR', {
+                error: buildBarValueError(yData, dataKey),
+            });
+            return;
+        }
+        // Validate negative values
+        if (numericValue < 0) {
+            addError?.('BAR_CHART_PATH_ERROR', {
+                error: buildBarNegativeValueError(numericValue, dataKey),
+            });
+        }
+    }, [addError, context.data, dataKey, yData]);
     const xPoint = getPoints(xTickValues, [String(xData)], true)[0];
     const yPoint = getPoints(yTickValues, [String(yData)])[0];
     const points = isVertical

package/dist/cjs/charts/barChart/fragments/barChartSeparator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"barChartSeparator.d.ts","sourceRoot":"","sources":["../../../../../src/charts/barChart/fragments/barChartSeparator.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAiC,MAAM,OAAO,CAAC;AAI/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAG/D,eAAO,MAAM,iBAAiB,EAAE,EAAE,CAAC,sBAAsB,CAoCxD,CAAC"}
+{"version":3,"file":"barChartSeparator.d.ts","sourceRoot":"","sources":["../../../../../src/charts/barChart/fragments/barChartSeparator.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAA4C,MAAM,OAAO,CAAC;AAY1E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAG/D,eAAO,MAAM,iBAAiB,EAAE,EAAE,CAAC,sBAAsB,CA0FxD,CAAC"}