@kubit-ui-web/react-charts 0.1.0

package/dist/esm/components/zoomArea/hooks/useZoomData.js

@@ -0,0 +1,31 @@
+import { useEffect, useState } from 'react';
+import { getRangeIndices } from '../utils/indexRounding';
+import { createDefaultRange } from '../utils/rangeAndPositions';
+export const useZoomData = ({ data, initialRange, onDataChange, }) => {
+    // Initialize range state
+    const defaultRange = initialRange || createDefaultRange(data.length);
+    const [currentRange, setCurrentRange] = useState(defaultRange);
+    // Filter data based on current range and emit changes
+    const filterData = (range) => {
+        if (!onDataChange || data.length === 0) {
+            return;
+        }
+        // Use centralized rounding logic to ensure consistency with accessibility labels
+        const { endIndex, startIndex } = getRangeIndices(range, data.length);
+        const filteredData = data.slice(startIndex, endIndex + 1);
+        onDataChange(filteredData);
+    };
+    // Handle range changes - updates state and filters data
+    const handleRangeChange = (newRange) => {
+        setCurrentRange(newRange);
+        filterData(newRange);
+    };
+    // Emit initial filtered data on mount
+    useEffect(() => {
+        filterData(currentRange);
+    }, []);
+    return {
+        currentRange,
+        handleRangeChange,
+    };
+};

package/dist/esm/components/zoomArea/index.d.ts

@@ -0,0 +1,6 @@
+export * from './components';
+export * from './hooks';
+export * from './utils';
+export * from './zoomArea';
+export * from './zoomArea.type';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/components/zoomArea/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/zoomArea/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/esm/components/zoomArea/index.js

@@ -0,0 +1,5 @@
+export * from './components';
+export * from './hooks';
+export * from './utils';
+export * from './zoomArea';
+export * from './zoomArea.type';

package/dist/esm/components/zoomArea/utils/accessibilityLabels.d.ts

@@ -0,0 +1,28 @@
+import type { IZoomAreaDataPoint, ScreenReaderConfig, ZoomRange } from '../zoomArea.type';
+/**
+ * Extracts the X-axis value from data at a specific index.
+ *
+ * @param data - Array of data points
+ * @param xKey - Property name to extract from data points
+ * @param index - Integer index (should be pre-rounded using indexRounding utils)
+ * @returns String representation of the X-axis value, or fallback to string index
+ */
+export declare const getXAxisValue: (data: IZoomAreaDataPoint[], xKey: string, index: number) => string;
+/**
+ * Generates consistent accessibility labels for ZoomArea handlers and selection area.
+ *
+ * Uses the same floor/ceil logic as data filtering to ensure that screen reader
+ * announcements exactly match the boundaries of the filtered data.
+ *
+ * @param data - Array of data points
+ * @param xKey - Property name to extract X-axis values from
+ * @param currentRange - Current zoom range with start and end indices
+ * @param config - Optional configuration for custom label templates
+ * @returns Object with formatted accessibility labels for UI components
+ */
+export declare const generateAccessibilityLabels: (data: IZoomAreaDataPoint[], xKey: string, currentRange: ZoomRange, config?: ScreenReaderConfig) => {
+    startHandler: string;
+    endHandler: string;
+    selectionArea: string;
+};
+//# sourceMappingURL=accessibilityLabels.d.ts.map

package/dist/esm/components/zoomArea/utils/accessibilityLabels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessibilityLabels.d.ts","sourceRoot":"","sources":["../../../../../src/components/zoomArea/utils/accessibilityLabels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAO1F;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,kBAAkB,EAAE,EAAE,MAAM,MAAM,EAAE,OAAO,MAAM,KAAG,MAGvF,CAAC;AAyBF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,2BAA2B,GACtC,MAAM,kBAAkB,EAAE,EAC1B,MAAM,MAAM,EACZ,cAAc,SAAS,EACvB,SAAS,kBAAkB,KAC1B;IACD,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CAuBvB,CAAC"}

package/dist/esm/components/zoomArea/utils/accessibilityLabels.js

@@ -0,0 +1,60 @@
+import { getRangeIndices } from './indexRounding';
+// Template keys for accessibility labels
+const ACCESSIBILITY_START_VALUE_KEY = '{{startValue}}';
+const ACCESSIBILITY_END_VALUE_KEY = '{{endValue}}';
+/**
+ * Extracts the X-axis value from data at a specific index.
+ *
+ * @param data - Array of data points
+ * @param xKey - Property name to extract from data points
+ * @param index - Integer index (should be pre-rounded using indexRounding utils)
+ * @returns String representation of the X-axis value, or fallback to string index
+ */
+export const getXAxisValue = (data, xKey, index) => {
+    // Index should already be rounded and clamped by getRangeIndices()
+    return data[index]?.[xKey]?.toString() || `${index}`;
+};
+/**
+ * Builds screen reader text by replacing template keys with actual values
+ *
+ * @param template - Template string with {{startValue}} and/or {{endValue}} placeholders
+ * @param startValue - Value to replace {{startValue}} with
+ * @param endValue - Value to replace {{endValue}} with
+ * @returns String with placeholders replaced, or undefined if template is not provided
+ */
+const buildScreenReaderText = (template, startValue, endValue) => {
+    if (!template) {
+        return template;
+    }
+    const startValueRegExp = new RegExp(ACCESSIBILITY_START_VALUE_KEY, 'g');
+    const endValueRegExp = new RegExp(ACCESSIBILITY_END_VALUE_KEY, 'g');
+    return template.replace(startValueRegExp, startValue).replace(endValueRegExp, endValue);
+};
+/**
+ * Generates consistent accessibility labels for ZoomArea handlers and selection area.
+ *
+ * Uses the same floor/ceil logic as data filtering to ensure that screen reader
+ * announcements exactly match the boundaries of the filtered data.
+ *
+ * @param data - Array of data points
+ * @param xKey - Property name to extract X-axis values from
+ * @param currentRange - Current zoom range with start and end indices
+ * @param config - Optional configuration for custom label templates
+ * @returns Object with formatted accessibility labels for UI components
+ */
+export const generateAccessibilityLabels = (data, xKey, currentRange, config) => {
+    // Use EXACT same indexing logic as useZoomData.filterData() via shared utilities
+    const { endIndex, startIndex } = getRangeIndices(currentRange, data.length);
+    const startValue = getXAxisValue(data, xKey, startIndex);
+    const endValue = getXAxisValue(data, xKey, endIndex);
+    // Use custom templates or fall back to simple defaults (just the values)
+    const startHandler = buildScreenReaderText(config?.startHandler, startValue, endValue) ?? startValue;
+    const endHandler = buildScreenReaderText(config?.endHandler, startValue, endValue) ?? endValue;
+    const selectionArea = buildScreenReaderText(config?.selectionArea, startValue, endValue) ??
+        `${startValue} - ${endValue}`;
+    return {
+        endHandler,
+        selectionArea,
+        startHandler,
+    };
+};

package/dist/esm/components/zoomArea/utils/index.d.ts

@@ -0,0 +1,4 @@
+export { getInteractionConfig } from './interactionConfig';
+export { generateCurvedPath, calculateLinesPathData } from './pathGeneration';
+export { calculateHandlerPositions, mouseToDataIndex, clampRange, createDefaultRange, isFullRange, } from './rangeAndPositions';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/components/zoomArea/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/zoomArea/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EACL,yBAAyB,EACzB,gBAAgB,EAChB,UAAU,EACV,kBAAkB,EAClB,WAAW,GACZ,MAAM,qBAAqB,CAAC"}

package/dist/esm/components/zoomArea/utils/index.js

@@ -0,0 +1,3 @@
+export { getInteractionConfig } from './interactionConfig';
+export { generateCurvedPath, calculateLinesPathData } from './pathGeneration';
+export { calculateHandlerPositions, mouseToDataIndex, clampRange, createDefaultRange, isFullRange, } from './rangeAndPositions';

package/dist/esm/components/zoomArea/utils/indexRounding.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Index rounding utilities for consistent data filtering and accessibility labels.
+ *
+ * These utilities ensure that both data filtering (useZoomData) and accessibility labels
+ * (generateAccessibilityLabels) use exactly the same rounding logic, preventing
+ * inconsistencies between what users see and what screen readers announce.
+ */
+/**
+ * Rounds a fractional index to be used as a start index (inclusive lower bound).
+ * Uses Math.floor() to include the current data point and everything after it.
+ *
+ * @param index - Continuous index (can be fractional)
+ * @param maxIndex - Maximum valid index (usually data.length - 1)
+ * @returns Rounded index clamped to valid bounds
+ *
+ * @example
+ * ```typescript
+ * roundStartIndex(1.3, 4); // Math.floor(1.3) = 1, clamped to [0,4] → 1
+ * roundStartIndex(-0.5, 4); // Math.floor(-0.5) = -1, clamped to [0,4] → 0
+ * ```
+ */
+export declare const roundStartIndex: (index: number, maxIndex: number) => number;
+/**
+ * Rounds a fractional index to be used as an end index (inclusive upper bound).
+ * Uses Math.ceil() to include the current data point and everything before it.
+ *
+ * @param index - Continuous index (can be fractional)
+ * @param maxIndex - Maximum valid index (usually data.length - 1)
+ * @returns Rounded index clamped to valid bounds
+ *
+ * @example
+ * ```typescript
+ * roundEndIndex(2.7, 4); // Math.ceil(2.7) = 3, clamped to [0,4] → 3
+ * roundEndIndex(5.2, 4); // Math.ceil(5.2) = 6, clamped to [0,4] → 4
+ * ```
+ */
+export declare const roundEndIndex: (index: number, maxIndex: number) => number;
+/**
+ * Converts a fractional range to integer indices using consistent rounding.
+ * This is the core function that both data filtering and accessibility use.
+ *
+ * @param range - Zoom range with potentially fractional start/end values
+ * @param dataLength - Length of the data array
+ * @returns Object with rounded startIndex and endIndex
+ *
+ * @example
+ * ```typescript
+ * const indices = getRangeIndices({ start: 1.3, end: 3.7 }, 10);
+ * // Returns: { startIndex: 1, endIndex: 4 }
+ *
+ * // This can be used for:
+ * // 1. Data filtering: data.slice(startIndex, endIndex + 1)
+ * // 2. Accessibility: data[startIndex][xKey] to data[endIndex][xKey]
+ * ```
+ */
+export declare const getRangeIndices: (range: {
+    start: number;
+    end: number;
+}, dataLength: number) => {
+    startIndex: number;
+    endIndex: number;
+};
+//# sourceMappingURL=indexRounding.d.ts.map

package/dist/esm/components/zoomArea/utils/indexRounding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexRounding.d.ts","sourceRoot":"","sources":["../../../../../src/components/zoomArea/utils/indexRounding.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,EAAE,UAAU,MAAM,KAAG,MAGjE,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,EAAE,UAAU,MAAM,KAAG,MAG/D,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EACrC,YAAY,MAAM,KACjB;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAOxC,CAAC"}

package/dist/esm/components/zoomArea/utils/indexRounding.js

@@ -0,0 +1,68 @@
+/**
+ * Index rounding utilities for consistent data filtering and accessibility labels.
+ *
+ * These utilities ensure that both data filtering (useZoomData) and accessibility labels
+ * (generateAccessibilityLabels) use exactly the same rounding logic, preventing
+ * inconsistencies between what users see and what screen readers announce.
+ */
+/**
+ * Rounds a fractional index to be used as a start index (inclusive lower bound).
+ * Uses Math.floor() to include the current data point and everything after it.
+ *
+ * @param index - Continuous index (can be fractional)
+ * @param maxIndex - Maximum valid index (usually data.length - 1)
+ * @returns Rounded index clamped to valid bounds
+ *
+ * @example
+ * ```typescript
+ * roundStartIndex(1.3, 4); // Math.floor(1.3) = 1, clamped to [0,4] → 1
+ * roundStartIndex(-0.5, 4); // Math.floor(-0.5) = -1, clamped to [0,4] → 0
+ * ```
+ */
+export const roundStartIndex = (index, maxIndex) => {
+    const rounded = Math.floor(index);
+    return Math.max(0, Math.min(maxIndex, rounded));
+};
+/**
+ * Rounds a fractional index to be used as an end index (inclusive upper bound).
+ * Uses Math.ceil() to include the current data point and everything before it.
+ *
+ * @param index - Continuous index (can be fractional)
+ * @param maxIndex - Maximum valid index (usually data.length - 1)
+ * @returns Rounded index clamped to valid bounds
+ *
+ * @example
+ * ```typescript
+ * roundEndIndex(2.7, 4); // Math.ceil(2.7) = 3, clamped to [0,4] → 3
+ * roundEndIndex(5.2, 4); // Math.ceil(5.2) = 6, clamped to [0,4] → 4
+ * ```
+ */
+export const roundEndIndex = (index, maxIndex) => {
+    const rounded = Math.ceil(index);
+    return Math.max(0, Math.min(maxIndex, rounded));
+};
+/**
+ * Converts a fractional range to integer indices using consistent rounding.
+ * This is the core function that both data filtering and accessibility use.
+ *
+ * @param range - Zoom range with potentially fractional start/end values
+ * @param dataLength - Length of the data array
+ * @returns Object with rounded startIndex and endIndex
+ *
+ * @example
+ * ```typescript
+ * const indices = getRangeIndices({ start: 1.3, end: 3.7 }, 10);
+ * // Returns: { startIndex: 1, endIndex: 4 }
+ *
+ * // This can be used for:
+ * // 1. Data filtering: data.slice(startIndex, endIndex + 1)
+ * // 2. Accessibility: data[startIndex][xKey] to data[endIndex][xKey]
+ * ```
+ */
+export const getRangeIndices = (range, dataLength) => {
+    const maxIndex = Math.max(0, dataLength - 1);
+    return {
+        endIndex: roundEndIndex(range.end, maxIndex),
+        startIndex: roundStartIndex(range.start, maxIndex),
+    };
+};

package/dist/esm/components/zoomArea/utils/interactionConfig.d.ts

@@ -0,0 +1,10 @@
+import type { ZoomAreaInteractionConfig } from '../zoomArea.type';
+/**
+ * Utility function to get resolved interaction configuration.
+ * Merges user-provided config with sensible defaults.
+ *
+ * @param config - Optional user configuration
+ * @returns Complete interaction configuration with defaults applied
+ */
+export declare const getInteractionConfig: (config?: ZoomAreaInteractionConfig) => Required<ZoomAreaInteractionConfig>;
+//# sourceMappingURL=interactionConfig.d.ts.map

package/dist/esm/components/zoomArea/utils/interactionConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactionConfig.d.ts","sourceRoot":"","sources":["../../../../../src/components/zoomArea/utils/interactionConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAclE;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAC/B,SAAS,yBAAyB,KACjC,QAAQ,CAAC,yBAAyB,CAInC,CAAC"}

package/dist/esm/components/zoomArea/utils/interactionConfig.js

@@ -0,0 +1,23 @@
+/**
+ * Default configuration for ZoomArea interactions
+ */
+const DEFAULT_INTERACTION_CONFIG = {
+    /** Fast keyboard movement step (Shift + arrows) */
+    KEYBOARD_FAST_STEP: 2,
+    /** Default keyboard movement step (arrows without modifiers) */
+    KEYBOARD_STEP: 1,
+    /** Minimum distance between start and end handlers */
+    MIN_HANDLER_DISTANCE: 1,
+};
+/**
+ * Utility function to get resolved interaction configuration.
+ * Merges user-provided config with sensible defaults.
+ *
+ * @param config - Optional user configuration
+ * @returns Complete interaction configuration with defaults applied
+ */
+export const getInteractionConfig = (config) => ({
+    keyboardFastStep: config?.keyboardFastStep ?? DEFAULT_INTERACTION_CONFIG.KEYBOARD_FAST_STEP,
+    keyboardStep: config?.keyboardStep ?? DEFAULT_INTERACTION_CONFIG.KEYBOARD_STEP,
+    minHandlerDistance: config?.minHandlerDistance ?? DEFAULT_INTERACTION_CONFIG.MIN_HANDLER_DISTANCE,
+});

package/dist/esm/components/zoomArea/utils/pathGeneration.d.ts

@@ -0,0 +1,57 @@
+import type { IZoomAreaDataPoint, ZoomAreaLineConfig } from '../zoomArea.type';
+/**
+ * Path generation utilities for ZoomArea SVG rendering
+ */
+/**
+ * Generates smooth curved path using simplified Bézier curves.
+ *
+ * This implementation is based on LineChart's curve algorithm but optimized for performance
+ * in the ZoomArea context. Uses cubic Bézier curves with control points positioned at 30%
+ * of the horizontal distance between consecutive points.
+ *
+ * @param points - Array of [x, y] coordinates representing the line points
+ * @returns SVG path string with curved segments (e.g., "M 0 10 C 3 10, 7 20, 10 20")
+ *
+ * @example
+ * ```typescript
+ * const points: Array<[number, number]> = [[0, 10], [10, 20], [20, 15]];
+ * const curvedPath = generateCurvedPath(points);
+ * // Returns: "M 0 10 C 3 10, 7 20, 10 20 C 13 20, 17 15, 20 15"
+ * ```
+ */
+export declare const generateCurvedPath: (points: Array<[number, number]>) => string;
+/**
+ * Calculates path data for all lines with unified Y-scale, supporting both curved and straight lines.
+ *
+ * This function processes multiple line configurations and generates SVG path strings for each line.
+ * All lines share the same Y-scale to maintain visual consistency when comparing different datasets.
+ *
+ * **Y-scaling behavior:** Uses padding to prevent lines from touching chart bounds, similar to LineChart.
+ * The effective chart area is reduced by 10% (5% top + 5% bottom) to provide visual breathing room.
+ *
+ * @param data - Array of data points containing values for all lines
+ * @param lines - Configuration for each line including styling and curve settings
+ * @param width - Canvas width for scaling X coordinates
+ * @param height - Canvas height for scaling Y coordinates
+ * @returns Array of objects containing line and fill paths with their configurations
+ *
+ * @example
+ * ```typescript
+ * const result = calculateLinesPathData(
+ *   [{ month: 'Jan', sales: 100, profit: 20 }, { month: 'Feb', sales: 150, profit: 30 }],
+ *   [
+ *     { yKey: 'sales', stroke: '#blue', curved: true },
+ *     { yKey: 'profit', stroke: '#red', curved: false }
+ *   ],
+ *   400, // width
+ *   100  // height
+ * );
+ * // Returns: [{ linePath: "M 0 80 C...", fillPath: "", config: {...} }, ...]
+ * ```
+ */
+export declare const calculateLinesPathData: (data: IZoomAreaDataPoint[], lines: ZoomAreaLineConfig[], width: number, height: number) => Array<{
+    linePath: string;
+    fillPath: string;
+    config: ZoomAreaLineConfig;
+}>;
+//# sourceMappingURL=pathGeneration.d.ts.map

package/dist/esm/components/zoomArea/utils/pathGeneration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathGeneration.d.ts","sourceRoot":"","sources":["../../../../../src/components/zoomArea/utils/pathGeneration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE/E;;GAEG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KAAG,MAqBpE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,sBAAsB,GACjC,MAAM,kBAAkB,EAAE,EAC1B,OAAO,kBAAkB,EAAE,EAC3B,OAAO,MAAM,EACb,QAAQ,MAAM,KACb,KAAK,CAAC;IACP,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,kBAAkB,CAAC;CAC5B,CA8CA,CAAC"}

package/dist/esm/components/zoomArea/utils/pathGeneration.js

@@ -0,0 +1,112 @@
+/**
+ * Path generation utilities for ZoomArea SVG rendering
+ */
+/**
+ * Generates smooth curved path using simplified Bézier curves.
+ *
+ * This implementation is based on LineChart's curve algorithm but optimized for performance
+ * in the ZoomArea context. Uses cubic Bézier curves with control points positioned at 30%
+ * of the horizontal distance between consecutive points.
+ *
+ * @param points - Array of [x, y] coordinates representing the line points
+ * @returns SVG path string with curved segments (e.g., "M 0 10 C 3 10, 7 20, 10 20")
+ *
+ * @example
+ * ```typescript
+ * const points: Array<[number, number]> = [[0, 10], [10, 20], [20, 15]];
+ * const curvedPath = generateCurvedPath(points);
+ * // Returns: "M 0 10 C 3 10, 7 20, 10 20 C 13 20, 17 15, 20 15"
+ * ```
+ */
+export const generateCurvedPath = (points) => {
+    if (points.length === 0) {
+        return '';
+    }
+    if (points.length === 1) {
+        return `M ${points[0][0]} ${points[0][1]}`;
+    }
+    const [firstPoint, ...remainingPoints] = points;
+    let path = `M ${firstPoint[0]} ${firstPoint[1]}`;
+    remainingPoints.forEach((point, i) => {
+        const start = i === 0 ? firstPoint : remainingPoints[i - 1];
+        const [x1, y1] = start;
+        const [x2, y2] = point;
+        // Control points calculation (same as LineChart but simplified factor)
+        const dx = (x2 - x1) * 0.3;
+        const controlPoint1 = [x1 + dx, y1];
+        const controlPoint2 = [x2 - dx, y2];
+        path += ` C ${controlPoint1[0]} ${controlPoint1[1]}, ${controlPoint2[0]} ${controlPoint2[1]}, ${x2} ${y2}`;
+    });
+    return path;
+};
+/**
+ * Calculates path data for all lines with unified Y-scale, supporting both curved and straight lines.
+ *
+ * This function processes multiple line configurations and generates SVG path strings for each line.
+ * All lines share the same Y-scale to maintain visual consistency when comparing different datasets.
+ *
+ * **Y-scaling behavior:** Uses padding to prevent lines from touching chart bounds, similar to LineChart.
+ * The effective chart area is reduced by 10% (5% top + 5% bottom) to provide visual breathing room.
+ *
+ * @param data - Array of data points containing values for all lines
+ * @param lines - Configuration for each line including styling and curve settings
+ * @param width - Canvas width for scaling X coordinates
+ * @param height - Canvas height for scaling Y coordinates
+ * @returns Array of objects containing line and fill paths with their configurations
+ *
+ * @example
+ * ```typescript
+ * const result = calculateLinesPathData(
+ *   [{ month: 'Jan', sales: 100, profit: 20 }, { month: 'Feb', sales: 150, profit: 30 }],
+ *   [
+ *     { yKey: 'sales', stroke: '#blue', curved: true },
+ *     { yKey: 'profit', stroke: '#red', curved: false }
+ *   ],
+ *   400, // width
+ *   100  // height
+ * );
+ * // Returns: [{ linePath: "M 0 80 C...", fillPath: "", config: {...} }, ...]
+ * ```
+ */
+export const calculateLinesPathData = (data, lines, width, height) => {
+    if (data.length === 0 || lines.length === 0) {
+        return [];
+    }
+    // Add padding to prevent lines from touching chart bounds (similar to LineChart behavior)
+    const yPaddingPercent = 0.05; // 5% padding top and bottom
+    const yPadding = height * yPaddingPercent;
+    const effectiveHeight = height - 2 * yPadding;
+    // Get min/max values for scaling across all lines for consistent Y scale
+    const allYValues = lines.flatMap(line => data.map(d => Number(d[line.yKey])));
+    const minY = Math.min(...allYValues);
+    const maxY = Math.max(...allYValues);
+    const yRange = maxY - minY || 1;
+    return lines.map(lineConfig => {
+        // Create path points for this specific line
+        const pathPoints = data.map((d, index) => {
+            const x = (index / Math.max(1, data.length - 1)) * width;
+            // Apply padding and scale within the effective height
+            const y = yPadding +
+                effectiveHeight -
+                ((Number(d[lineConfig.yKey]) - minY) / yRange) * effectiveHeight;
+            return [x, y];
+        });
+        // Generate line path - curved or straight based on config
+        const linePath = lineConfig.curved
+            ? generateCurvedPath(pathPoints)
+            : `M ${pathPoints.map(([x, y]) => `${x},${y}`).join(' L ')}`;
+        // Generate fill path if needed
+        let fillPath = '';
+        if (lineConfig.fill) {
+            // For fill, extend to the bottom of the chart (full height)
+            fillPath = lineConfig.curved
+                ? `${generateCurvedPath(pathPoints)} L ${width} ${height} L 0 ${height} Z`
+                : `${linePath} L ${width},${height} L 0,${height} Z`;
+        }
+        return {
+            config: lineConfig,
+            fillPath,
+            linePath,
+        };
+    });
+};

package/dist/esm/components/zoomArea/utils/rangeAndPositions.d.ts

@@ -0,0 +1,60 @@
+import type { ZoomRange } from '../zoomArea.type';
+/**
+ * Range operations and position calculation utilities for ZoomArea
+ */
+/**
+ * Calculates handler positions based on current range
+ *
+ * @param currentRange - The current zoom range
+ * @param dataLength - Total length of the dataset
+ * @param width - Canvas width for scaling
+ * @returns Object with startX and endX positions
+ */
+export declare const calculateHandlerPositions: (currentRange: ZoomRange, dataLength: number, width: number) => {
+    startX: number;
+    endX: number;
+};
+/**
+ * Converts mouse position to continuous data index
+ *
+ * @param mouseX - Mouse X coordinate relative to the chart
+ * @param width - Canvas width
+ * @param dataLength - Total length of the dataset
+ * @returns Data index
+ */
+export declare const mouseToDataIndex: (mouseX: number, width: number, dataLength: number) => number;
+/**
+ * Clamps a range to valid bounds
+ *
+ * @param range - The range to clamp
+ * @param dataLength - Total length of the dataset
+ * @param minDistance - Minimum distance between start and end (default: 0.1)
+ * @returns Clamped range within valid bounds
+ */
+export declare const clampRange: (range: ZoomRange, dataLength: number, minDistance?: number) => ZoomRange;
+/**
+ * Creates a default range for the given data length
+ *
+ * @param dataLength - Total length of the dataset
+ * @returns Default range covering the full dataset
+ */
+export declare const createDefaultRange: (dataLength: number) => ZoomRange;
+/**
+ * Determines if the current range covers the full dataset.
+ * According to design specs: overlay is "only visible when a range is defined".
+ * A range is considered "defined" when it doesn't cover the complete dataset.
+ *
+ * @param range - The current zoom range
+ * @param dataLength - Total length of the dataset
+ * @returns true if the range covers the full dataset (no selection defined)
+ *
+ * @example
+ * ```typescript
+ * // Dataset with 10 elements [0-9]
+ * isFullRange({ start: 0, end: 9 }, 10); // true - covers full dataset
+ * isFullRange({ start: 1, end: 8 }, 10); // false - partial selection
+ * isFullRange({ start: 0, end: 7 }, 10); // false - partial selection
+ * ```
+ */
+export declare const isFullRange: (range: ZoomRange, dataLength: number) => boolean;
+//# sourceMappingURL=rangeAndPositions.d.ts.map

package/dist/esm/components/zoomArea/utils/rangeAndPositions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rangeAndPositions.d.ts","sourceRoot":"","sources":["../../../../../src/components/zoomArea/utils/rangeAndPositions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD;;GAEG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,GACpC,cAAc,SAAS,EACvB,YAAY,MAAM,EAClB,OAAO,MAAM,KACZ;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAIhC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,GAAI,QAAQ,MAAM,EAAE,OAAO,MAAM,EAAE,YAAY,MAAM,KAAG,MAIpF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GACrB,OAAO,SAAS,EAChB,YAAY,MAAM,EAClB,cAAa,MAAY,KACxB,SAQF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,YAAY,MAAM,KAAG,SAGtD,CAAC;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,SAAS,EAAE,YAAY,MAAM,KAAG,OAElE,CAAC"}

package/dist/esm/components/zoomArea/utils/rangeAndPositions.js

@@ -0,0 +1,75 @@
+/**
+ * Range operations and position calculation utilities for ZoomArea
+ */
+/**
+ * Calculates handler positions based on current range
+ *
+ * @param currentRange - The current zoom range
+ * @param dataLength - Total length of the dataset
+ * @param width - Canvas width for scaling
+ * @returns Object with startX and endX positions
+ */
+export const calculateHandlerPositions = (currentRange, dataLength, width) => {
+    const startX = (currentRange.start / Math.max(1, dataLength - 1)) * width;
+    const endX = (currentRange.end / Math.max(1, dataLength - 1)) * width;
+    return { endX, startX };
+};
+/**
+ * Converts mouse position to continuous data index
+ *
+ * @param mouseX - Mouse X coordinate relative to the chart
+ * @param width - Canvas width
+ * @param dataLength - Total length of the dataset
+ * @returns Data index
+ */
+export const mouseToDataIndex = (mouseX, width, dataLength) => {
+    const relativeX = Math.max(0, Math.min(width, mouseX));
+    const normalizedPosition = relativeX / width;
+    return Math.round(normalizedPosition * (dataLength - 1));
+};
+/**
+ * Clamps a range to valid bounds
+ *
+ * @param range - The range to clamp
+ * @param dataLength - Total length of the dataset
+ * @param minDistance - Minimum distance between start and end (default: 0.1)
+ * @returns Clamped range within valid bounds
+ */
+export const clampRange = (range, dataLength, minDistance = 0.1) => {
+    const clampedStart = Math.max(0, Math.min(range.start, dataLength - 1 - minDistance));
+    const clampedEnd = Math.min(dataLength - 1, Math.max(range.end, clampedStart + minDistance));
+    return {
+        end: clampedEnd,
+        start: clampedStart,
+    };
+};
+/**
+ * Creates a default range for the given data length
+ *
+ * @param dataLength - Total length of the dataset
+ * @returns Default range covering the full dataset
+ */
+export const createDefaultRange = (dataLength) => ({
+    end: Math.max(0, dataLength - 1),
+    start: 0,
+});
+/**
+ * Determines if the current range covers the full dataset.
+ * According to design specs: overlay is "only visible when a range is defined".
+ * A range is considered "defined" when it doesn't cover the complete dataset.
+ *
+ * @param range - The current zoom range
+ * @param dataLength - Total length of the dataset
+ * @returns true if the range covers the full dataset (no selection defined)
+ *
+ * @example
+ * ```typescript
+ * // Dataset with 10 elements [0-9]
+ * isFullRange({ start: 0, end: 9 }, 10); // true - covers full dataset
+ * isFullRange({ start: 1, end: 8 }, 10); // false - partial selection
+ * isFullRange({ start: 0, end: 7 }, 10); // false - partial selection
+ * ```
+ */
+export const isFullRange = (range, dataLength) => {
+    return range.start === 0 && range.end === dataLength - 1;
+};

package/dist/esm/components/zoomArea/utils/selectionConfig.d.ts

@@ -0,0 +1,10 @@
+import type { ZoomAreaSelectionConfig } from '../zoomArea.type';
+/**
+ * Utility function to get resolved selection configuration.
+ * Merges user-provided config with sensible defaults.
+ *
+ * @param config - Optional user configuration
+ * @returns Complete selection configuration with defaults applied
+ */
+export declare const getSelectionConfig: (config?: ZoomAreaSelectionConfig) => Required<ZoomAreaSelectionConfig>;
+//# sourceMappingURL=selectionConfig.d.ts.map