@cdc/chart 4.25.10 → 4.26.1

package/src/components/Brush/BrushSelector.tsx

@@ -0,0 +1,1258 @@
+import React, { FC, useContext, useMemo, memo, useRef, useEffect, useState, useCallback } from 'react'
+import { Brush } from '@visx/brush'
+import BaseBrush from '@visx/brush/lib/BaseBrush'
+import { Group } from '@visx/group'
+import { scaleBand, scaleLinear } from '@visx/scale'
+import { Bounds } from '@visx/brush/lib/types'
+import type { BrushHandleRenderProps } from '@visx/brush/lib/BrushHandle'
+import ConfigContext, { ChartDispatchContext } from '../../ConfigContext'
+import MiniChartPreview from './MiniChartPreview'
+
+interface BrushSelectorProps {
+  xMax: number
+  yMax: number
+}
+
+const BRUSH_HEIGHT = 50
+const BRUSH_PADDING = 10
+const KEYBOARD_STEP = 10 // pixels to move per arrow key press
+const KEYBOARD_STEP_LARGE = 50 // pixels to move with Shift+arrow
+
+type FocusedElement = 'left-handle' | 'selection' | 'right-handle' | null
+
+// Simple brush handle component with wider grab area
+const BrushHandle = memo<BrushHandleRenderProps>(({ x, height, isBrushActive, className }) => {
+  if (!isBrushActive) return null
+
+  const pathWidth = 14
+  const pathHeight = 28
+  const grabAreaWidth = 28 // Wider invisible grab area
+
+  // Determine if this is the left or right handle from className
+  const isLeftHandle = className?.includes('left')
+
+  // Arrow path: "<" for left handle, ">" for right handle
+  const arrowPath = isLeftHandle
+    ? 'M 2 7 L -3 14 L 2 21' // "<" chevron (points left)
+    : 'M -2 7 L 3 14 L -2 21' // ">" chevron (points right)
+
+  return (
+    <Group left={x + pathWidth / 2 - 7} top={(height - pathHeight) / 2}>
+      {/* Invisible wider grab area that extends full height */}
+      <rect
+        x={-grabAreaWidth / 2}
+        y={-(height - pathHeight) / 2}
+        width={grabAreaWidth}
+        height={height}
+        fill='transparent'
+        style={{ cursor: 'ew-resize' }}
+        pointerEvents='all'
+      />
+      {/* Visible handle background */}
+      <rect
+        x={-pathWidth / 2}
+        y={0}
+        width={pathWidth}
+        height={pathHeight}
+        fill='white'
+        stroke='rgb(51, 51, 51)'
+        strokeWidth='1'
+        style={{ cursor: 'ew-resize' }}
+        pointerEvents='none'
+      />
+      {/* Arrow icon */}
+      <path
+        d={arrowPath}
+        fill='none'
+        stroke='rgb(51, 51, 51)'
+        strokeWidth='2'
+        strokeLinecap='round'
+        strokeLinejoin='round'
+        style={{ cursor: 'ew-resize' }}
+        pointerEvents='none'
+      />
+    </Group>
+  )
+})
+
+BrushHandle.displayName = 'BrushHandle'
+
+const BrushSelector: FC<BrushSelectorProps> = ({ xMax, yMax }) => {
+  const brushRef = useRef<BaseBrush>(null)
+  const containerRef = useRef<HTMLDivElement>(null)
+  const hasInitialized = useRef(false)
+  const mouseDownPos = useRef<{ x: number; y: number } | null>(null)
+  const isMouseDown = useRef<boolean>(false)
+  const previousExtent = useRef<{ x0: number; x1: number } | null>(null)
+  const previousDefaultCount = useRef<number | undefined>(undefined)
+  const isProgrammaticUpdate = useRef<boolean>(false)
+  const isUserInteracting = useRef<boolean>(false)
+
+  // Custom touch handling state
+  const touchState = useRef<{
+    active: boolean
+    startX: number
+    currentX: number
+    startExtent: { x0: number; x1: number }
+    dragType: 'selection' | 'left-handle' | 'right-handle' | 'new-selection' | null
+  }>({
+    active: false,
+    startX: 0,
+    currentX: 0,
+    startExtent: { x0: 0, x1: 0 },
+    dragType: null
+  })
+
+  // Keyboard accessibility state
+  const [focusedElement, setFocusedElement] = useState<FocusedElement>(null)
+  const [accessibleExtent, setAccessibleExtent] = useState<{ x0: number; x1: number } | null>(null)
+  const leftHandleRef = useRef<HTMLButtonElement>(null)
+  const selectionRef = useRef<HTMLButtonElement>(null)
+  const rightHandleRef = useRef<HTMLButtonElement>(null)
+
+  const { tableData, config, colorScale } = useContext(ConfigContext)
+  const dispatch = useContext(ChartDispatchContext)
+  const dataKey = config.xAxis.dataKey
+  const series = config.series || []
+
+  // Capture initial brush extent after mount and sync accessible extent
+  useEffect(() => {
+    if (brushRef.current && brushRef.current.state.extent.x0 !== -1) {
+      const { x0, x1 } = brushRef.current.state.extent
+      if (!previousExtent.current) {
+        previousExtent.current = { x0, x1 }
+      }
+      // Also sync accessible extent for keyboard navigation
+      setAccessibleExtent({ x0, x1 })
+    }
+  }, [brushRef.current?.state])
+
+  // X scale for brush data - ensure positive dimensions
+  const xScale = useMemo(() => {
+    if (!tableData.length || xMax <= 0) {
+      return scaleBand<string>({ domain: [], range: [0, Math.max(xMax, 0)] })
+    }
+
+    const mappedDates = tableData.map(row => row[dataKey])
+    const domain = config?.xAxis?.sortByRecentDate ? [...mappedDates].reverse() : mappedDates
+
+    return scaleBand<string>({
+      domain,
+      range: [0, Math.max(xMax, 0)],
+      paddingInner: 0.1,
+      paddingOuter: 0.1
+    })
+  }, [tableData, dataKey, config?.xAxis?.sortByRecentDate, xMax])
+
+  // Simple Y scale for brush (identity mapping)
+  const yScale = useMemo(() => scaleLinear<number>({ domain: [0, BRUSH_HEIGHT], range: [BRUSH_HEIGHT, 0] }), [])
+
+  // Mini chart Y scale
+  const miniYScale = useMemo(() => {
+    if (!series.length || !tableData.length) {
+      return scaleLinear({ domain: [0, 100], range: [BRUSH_HEIGHT - 4, 2] })
+    }
+
+    const isStacked =
+      config.visualizationSubType === 'stacked' &&
+      (config.visualizationType === 'Bar' || config.visualizationType === 'Area Chart')
+    let minValue = Number.POSITIVE_INFINITY
+    let maxValue = Number.NEGATIVE_INFINITY
+    let hasValidValues = false
+
+    if (isStacked) {
+      // For stacked bars, calculate the sum of all series for each row
+      for (const row of tableData) {
+        let rowSum = 0
+        let hasRowValue = false
+        for (const s of series) {
+          if (!s.dataKey) continue
+          const value = parseFloat(row[s.dataKey])
+          if (!isNaN(value) && isFinite(value)) {
+            rowSum += value
+            hasRowValue = true
+          }
+        }
+        if (hasRowValue) {
+          hasValidValues = true
+          minValue = Math.min(minValue, rowSum)
+          maxValue = Math.max(maxValue, rowSum)
+        }
+      }
+      // For stacked charts, ensure domain starts at 0
+      minValue = Math.min(0, minValue)
+    } else {
+      // For non-stacked charts, use individual series values
+      for (const s of series) {
+        if (!s.dataKey) continue
+        for (const row of tableData) {
+          const value = parseFloat(row[s.dataKey])
+          if (!isNaN(value) && isFinite(value)) {
+            hasValidValues = true
+            minValue = Math.min(minValue, value)
+            maxValue = Math.max(maxValue, value)
+          }
+        }
+      }
+      // For bar charts, ensure domain includes 0
+      if (config.visualizationType === 'Bar') {
+        minValue = Math.min(0, minValue)
+      }
+    }
+
+    // Handle edge case where all values are the same
+    if (hasValidValues && minValue === maxValue) {
+      // Create a domain with some padding around the single value
+      const padding = Math.abs(minValue) * 0.1 || 10
+      minValue = minValue - padding
+      maxValue = maxValue + padding
+      // Ensure 0 is included if we're near it
+      if (minValue > 0) minValue = 0
+    }
+
+    if (!hasValidValues) {
+      return scaleLinear({ domain: [0, 100], range: [BRUSH_HEIGHT - 4, 2] })
+    }
+
+    // Ensure domain includes 0 for bar charts
+    if (config.visualizationType === 'Bar') {
+      minValue = Math.min(0, minValue)
+    }
+
+    const domain = minValue === maxValue ? [minValue - 1, maxValue + 1] : [minValue, maxValue]
+    return scaleLinear({ domain, range: [BRUSH_HEIGHT - 4, 2], nice: true })
+  }, [series, tableData, config.visualizationSubType, config.visualizationType])
+
+  // Fallback: Window mouseup listener to prevent stuck drag states
+  useEffect(() => {
+    const handleWindowMouseUp = () => {
+      // Check if brush is stuck in dragging state
+      if (brushRef.current?.state?.isBrushing) {
+        const brush = brushRef.current
+
+        // Use reset method if available to clear the brush.
+        // If the visx Brush API is insufficient, consider filing an issue upstream.
+        if (typeof brush.reset === 'function') {
+          brush.reset()
+          return
+        }
+        // No reliable fallback: avoid DOM manipulation. If issues persist, document and address upstream.
+      }
+    }
+
+    // Add window-level event listeners as fallback safety net
+    window.addEventListener('mouseup', handleWindowMouseUp, { passive: true })
+    window.addEventListener('touchend', handleWindowMouseUp, { passive: true })
+    // Also listen for mouse leave events on the window (e.g., mouse goes outside browser)
+    window.addEventListener('mouseleave', handleWindowMouseUp, { passive: true })
+
+    return () => {
+      window.removeEventListener('mouseup', handleWindowMouseUp)
+      window.removeEventListener('touchend', handleWindowMouseUp)
+      window.removeEventListener('mouseleave', handleWindowMouseUp)
+    }
+  }, [])
+
+  // Custom touch handling for mobile - bypasses broken @visx/brush touch support
+  useEffect(() => {
+    const container = containerRef.current
+    if (!container) return
+
+    const HANDLE_WIDTH = 24 // Width of the drag handles
+
+    const getRelativeX = (touch: Touch): number => {
+      const rect = container.getBoundingClientRect()
+      return touch.clientX - rect.left
+    }
+
+    const getDragType = (x: number): 'selection' | 'left-handle' | 'right-handle' | 'new-selection' => {
+      const brush = brushRef.current
+      if (!brush || brush.state.extent.x0 === -1) return 'new-selection'
+
+      const { x0, x1 } = brush.state.extent
+
+      // Check if touch is on handles (with some tolerance)
+      if (Math.abs(x - x0) < HANDLE_WIDTH) return 'left-handle'
+      if (Math.abs(x - x1) < HANDLE_WIDTH) return 'right-handle'
+
+      // Check if touch is on selection
+      if (x >= x0 && x <= x1) return 'selection'
+
+      // Touch is outside selection - create new selection
+      return 'new-selection'
+    }
+
+    const handleTouchStart = (e: TouchEvent) => {
+      if (e.touches.length !== 1) return
+
+      const touch = e.touches[0]
+      const x = getRelativeX(touch)
+      const dragType = getDragType(x)
+
+      e.preventDefault()
+      e.stopPropagation()
+
+      isUserInteracting.current = true
+
+      const brush = brushRef.current
+      const startExtent =
+        brush && brush.state.extent.x0 !== -1
+          ? { x0: brush.state.extent.x0, x1: brush.state.extent.x1 }
+          : { x0: x, x1: x } // For new selection, start at touch point
+
+      touchState.current = {
+        active: true,
+        startX: x,
+        currentX: x,
+        startExtent,
+        dragType
+      }
+    }
+
+    const handleTouchMove = (e: TouchEvent) => {
+      if (!touchState.current.active || e.touches.length !== 1) return
+
+      e.preventDefault()
+      e.stopPropagation()
+
+      const touch = e.touches[0]
+      const x = getRelativeX(touch)
+      touchState.current.currentX = x
+      const delta = x - touchState.current.startX
+      const { startExtent, dragType, startX } = touchState.current
+      const safeXMax = Math.max(xMax, 100)
+      const safeYMax = Math.max(yMax, BRUSH_HEIGHT + BRUSH_PADDING * 2)
+      const minSelectionWidth = 20
+
+      let newX0 = startExtent.x0
+      let newX1 = startExtent.x1
+
+      if (dragType === 'selection') {
+        // Move entire selection
+        const width = startExtent.x1 - startExtent.x0
+        newX0 = Math.max(0, Math.min(safeXMax - width, startExtent.x0 + delta))
+        newX1 = newX0 + width
+      } else if (dragType === 'left-handle') {
+        // Resize from left
+        newX0 = Math.max(0, Math.min(startExtent.x1 - minSelectionWidth, startExtent.x0 + delta))
+      } else if (dragType === 'right-handle') {
+        // Resize from right
+        newX1 = Math.max(startExtent.x0 + minSelectionWidth, Math.min(safeXMax, startExtent.x1 + delta))
+      } else if (dragType === 'new-selection') {
+        // Create new selection from start point to current point
+        newX0 = Math.max(0, Math.min(startX, x))
+        newX1 = Math.min(safeXMax, Math.max(startX, x))
+        // Ensure minimum width
+        if (newX1 - newX0 < minSelectionWidth) {
+          if (x > startX) {
+            newX1 = Math.min(safeXMax, newX0 + minSelectionWidth)
+          } else {
+            newX0 = Math.max(0, newX1 - minSelectionWidth)
+          }
+        }
+      }
+
+      // Update brush position
+      const brush = brushRef.current
+      if (brush?.updateBrush) {
+        brush.updateBrush(() => ({
+          ...brush.state,
+          extent: { x0: newX0, x1: newX1, y0: 0, y1: safeYMax },
+          start: { x: newX0, y: 0 },
+          end: { x: newX1, y: safeYMax }
+        }))
+      }
+    }
+
+    const handleTouchEnd = (e: TouchEvent) => {
+      if (!touchState.current.active) return
+
+      e.preventDefault()
+      e.stopPropagation()
+
+      // Get final brush state and update data
+      const brush = brushRef.current
+      if (brush && brush.state.extent && brush.state.extent.x1 > brush.state.extent.x0) {
+        const { x0, x1 } = brush.state.extent
+        const domain = xScale.domain()
+        const xValues: string[] = []
+
+        for (const value of domain) {
+          const xPos = xScale(value)
+          if (xPos !== undefined && xPos >= x0 && xPos < x1) {
+            xValues.push(value)
+          }
+        }
+
+        if (xValues.length > 0) {
+          const selectedSet = new Set(xValues)
+          const filteredData = tableData.filter(row => selectedSet.has(row[dataKey]))
+          dispatch({ type: 'SET_BRUSH_DATA', payload: filteredData })
+          previousExtent.current = { x0, x1 }
+          setAccessibleExtent({ x0, x1 })
+        }
+      }
+
+      // Reset touch state
+      touchState.current = {
+        active: false,
+        startX: 0,
+        currentX: 0,
+        startExtent: { x0: 0, x1: 0 },
+        dragType: null
+      }
+
+      // Reset isUserInteracting - handleBrushChange will check brush state if needed
+      // Reuse the brush variable already declared above
+      if (brush && !brush.state?.isBrushing) {
+        isUserInteracting.current = false
+      }
+    }
+
+    // Attach native event listeners with passive: false to allow preventDefault
+    container.addEventListener('touchstart', handleTouchStart, { passive: false })
+    container.addEventListener('touchmove', handleTouchMove, { passive: false })
+    container.addEventListener('touchend', handleTouchEnd, { passive: false })
+
+    return () => {
+      container.removeEventListener('touchstart', handleTouchStart)
+      container.removeEventListener('touchmove', handleTouchMove)
+      container.removeEventListener('touchend', handleTouchEnd)
+    }
+  }, [xMax, yMax, xScale, tableData, dataKey, dispatch])
+
+  // Handle brush changes
+  const handleBrushChange = useCallback(
+    (bounds: Bounds | null) => {
+      if (!bounds) {
+        dispatch({ type: 'SET_BRUSH_DATA', payload: [] })
+        return
+      }
+
+      // Validate bounds have valid numeric values
+      if (!isFinite(bounds.x0) || !isFinite(bounds.x1) || !isFinite(bounds.y0) || !isFinite(bounds.y1)) {
+        // Invalid bounds - likely an intermediate state during drag, skip silently
+        return
+      }
+
+      // Only ignore calls where x0=0, x1=0 AND xValues matches the FULL dataset
+      // This indicates an invalid initialization/reset. But if xValues is a subset,
+      // the user is legitimately dragging and we should accept it even with x0=0, x1=0
+      const domain = xScale.domain()
+
+      // Guard: ignore only if it's clearly an invalid full-dataset reset
+      // (x0=0, x1=0 with all domain values) - this happens on visx internal resets
+      const isFullDatasetReset =
+        bounds.x0 === 0 && bounds.x1 === 0 && bounds.xValues && bounds.xValues.length === domain.length
+      if (isFullDatasetReset) {
+        return
+      }
+
+      // Get xValues from bounds or compute from the scale if not provided
+      let xValues = bounds.xValues?.filter(val => val !== undefined) || []
+      const brushDefaultRecentDateCount = config.xAxis?.brushDefaultRecentDateCount
+
+      // If xValues is empty but we have valid bounds, compute xValues from the scale
+      // This handles cases where visx doesn't properly compute xValues during drag
+      if (xValues.length === 0 && bounds.x1 > bounds.x0) {
+        // During programmatic updates with brushDefaultRecentDateCount, use exact count
+        // During user interactions, use pixel-based calculation to allow free brush movement
+        if (isProgrammaticUpdate.current && brushDefaultRecentDateCount && brushDefaultRecentDateCount > 0) {
+          // When using brushDefaultRecentDateCount during programmatic updates, use exact count
+          // to avoid including extra dates that fall within the pixel bounds
+          const countToSelect = Math.min(brushDefaultRecentDateCount, domain.length)
+          xValues = domain.slice(-countToSelect)
+        } else {
+          // For manual brush selection, use pixel-based calculation
+          for (const value of domain) {
+            const xPos = xScale(value)
+            if (xPos !== undefined) {
+              const bandCenter = xPos + (xScale.bandwidth?.() || 0) / 2
+              if (bandCenter >= bounds.x0 && bandCenter <= bounds.x1) {
+                xValues.push(value)
+              }
+            }
+          }
+        }
+      } else if (xValues.length > 0 && brushDefaultRecentDateCount && brushDefaultRecentDateCount > 0) {
+        // CRITICAL: Always check if xValues matches expected count when brushDefaultRecentDateCount is set
+        // This prevents the tick/dates bug where visx recalculates and includes extra dates
+        // The bug fix from bb9d533 always enforced exact count, but that breaks user interactions
+        // Solution: Only enforce exact count during programmatic updates OR when user is not actively interacting
+        const expectedCount = Math.min(brushDefaultRecentDateCount, domain.length)
+        if (xValues.length !== expectedCount) {
+          if (isProgrammaticUpdate.current || !isUserInteracting.current) {
+            // Enforce exact count during programmatic updates or when user is not actively dragging
+            // This preserves the bug fix while allowing free brush movement during active user interactions
+            xValues = domain.slice(-expectedCount)
+          }
+          // During active user interactions (dragging), allow xValues to be any count - user can select freely
+        }
+      }
+
+      if (xValues.length === 0) {
+        dispatch({ type: 'SET_BRUSH_DATA', payload: [] })
+        return
+      }
+
+      // Create filtered dataset
+      const selectedSet = new Set(xValues)
+      const filteredData = tableData.filter(row => selectedSet.has(row[dataKey]))
+
+      dispatch({ type: 'SET_BRUSH_DATA', payload: filteredData })
+
+      // Update accessible extent for keyboard controls positioning
+      setAccessibleExtent({ x0: bounds.x0, x1: bounds.x1 })
+
+      // Reset programmatic update flag after handling the change
+      isProgrammaticUpdate.current = false
+
+      // Reset user interaction flag if brush is no longer being dragged
+      // This ensures we don't use timeouts and check the actual brush state
+      const brush = brushRef.current
+      if (isUserInteracting.current && brush && !brush.state?.isBrushing) {
+        isUserInteracting.current = false
+      }
+    },
+    [dispatch, tableData, dataKey, xScale, config.xAxis?.brushDefaultRecentDateCount]
+  )
+
+  // Set default selection on initial load
+  // Uses either the last X data points (if defaultRecentDateCount is set) or 35% of width
+  useEffect(() => {
+    if (hasInitialized.current || !tableData.length || !xScale || xMax <= 0) {
+      return
+    }
+
+    const safeXMax = Math.max(xMax, 100)
+    const safeYMax = Math.max(yMax, BRUSH_HEIGHT + BRUSH_PADDING * 2)
+    const domain = xScale.domain()
+    const brushDefaultRecentDateCount = config.xAxis.brushDefaultRecentDateCount
+
+    let x0: number
+    let x1: number
+    let xValues: string[] = []
+
+    if (brushDefaultRecentDateCount && brushDefaultRecentDateCount > 0 && domain.length > 0) {
+      // Use exact count of most recent data points
+      const countToSelect = Math.min(brushDefaultRecentDateCount, domain.length)
+      const selectedValues = domain.slice(-countToSelect)
+      xValues = selectedValues
+
+      const firstSelectedPos = xScale(selectedValues[0])
+      const lastSelectedPos = xScale(selectedValues[selectedValues.length - 1])
+      const bandwidth = xScale.bandwidth() || 0
+
+      x0 = firstSelectedPos ?? safeXMax * 0.65
+      x1 = lastSelectedPos !== undefined ? lastSelectedPos + bandwidth : safeXMax
+    } else {
+      // Default: 35% of the width, starting from most recent dates
+      const initialWidth = safeXMax * 0.35
+      x0 = safeXMax - initialWidth
+      x1 = safeXMax
+
+      for (const value of domain) {
+        const xPos = xScale(value)
+        if (xPos !== undefined && xPos >= x0 && xPos < x1) {
+          xValues.push(value)
+        }
+      }
+    }
+
+    // If we have values in the initial range, set the brush data
+    if (xValues.length > 0) {
+      const initialBounds: Bounds = {
+        x0,
+        x1,
+        y0: 0,
+        y1: safeYMax,
+        xValues
+      }
+
+      // Mark as programmatic update for initial load
+      isProgrammaticUpdate.current = true
+      // Just set the brush data - let the Brush component handle the visual selection
+      handleBrushChange(initialBounds)
+      hasInitialized.current = true
+    }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [tableData, xScale, xMax, dataKey, config.xAxis.brushDefaultRecentDateCount])
+
+  // Update brush selection when brushDefaultRecentDateCount changes in the editor
+  useEffect(() => {
+    const currentCount = config.xAxis.brushDefaultRecentDateCount
+
+    // Skip if not initialized yet (let the initial effect handle it)
+    if (!hasInitialized.current) {
+      previousDefaultCount.current = currentCount
+      return
+    }
+
+    // Skip if the value hasn't actually changed
+    if (currentCount === previousDefaultCount.current) {
+      return
+    }
+
+    // Update the previous value
+    previousDefaultCount.current = currentCount
+
+    // Skip if we don't have the necessary data
+    if (!tableData.length || !xScale || xMax <= 0) {
+      return
+    }
+
+    const safeXMax = Math.max(xMax, 100)
+    const safeYMax = Math.max(yMax, BRUSH_HEIGHT + BRUSH_PADDING * 2)
+    const domain = xScale.domain()
+
+    let x0: number
+    let x1: number
+    let xValues: string[] = []
+
+    if (currentCount && currentCount > 0 && domain.length > 0) {
+      // Use exact count of most recent data points
+      const countToSelect = Math.min(currentCount, domain.length)
+      const selectedValues = domain.slice(-countToSelect)
+      xValues = selectedValues
+
+      const firstSelectedPos = xScale(selectedValues[0])
+      const lastSelectedPos = xScale(selectedValues[selectedValues.length - 1])
+      const bandwidth = xScale.bandwidth() || 0
+
+      x0 = firstSelectedPos ?? safeXMax * 0.65
+      x1 = lastSelectedPos !== undefined ? lastSelectedPos + bandwidth : safeXMax
+    } else {
+      // Default: 35% of the width, starting from most recent dates
+      const initialWidth = safeXMax * 0.35
+      x0 = safeXMax - initialWidth
+      x1 = safeXMax
+
+      for (const value of domain) {
+        const xPos = xScale(value)
+        if (xPos !== undefined && xPos >= x0 && xPos < x1) {
+          xValues.push(value)
+        }
+      }
+    }
+
+    if (xValues.length > 0) {
+      const newBounds: Bounds = {
+        x0,
+        x1,
+        y0: 0,
+        y1: safeYMax,
+        xValues
+      }
+
+      // Mark as programmatic update when editor value changes
+      isProgrammaticUpdate.current = true
+      // Update the brush data
+      handleBrushChange(newBounds)
+
+      // Update the visual brush position
+      const brush = brushRef.current
+      if (brush && brush.updateBrush) {
+        brush.updateBrush(() => ({
+          ...brush.state,
+          extent: {
+            x0,
+            x1,
+            y0: 0,
+            y1: safeYMax
+          },
+          start: { x: x0, y: 0 },
+          end: { x: x1, y: safeYMax }
+        }))
+
+        // Store the new extent
+        previousExtent.current = { x0, x1 }
+      }
+    }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [config.xAxis.brushDefaultRecentDateCount])
+
+  // Selected box style with solid border and pattern fill
+  const selectedBoxStyle = useMemo(
+    () => ({
+      fill: 'url(#brush_pattern)',
+      stroke: '#333',
+      strokeWidth: 1
+    }),
+    []
+  )
+
+  // Helper to update brush position programmatically
+  const updateBrushPosition = useCallback(
+    (newX0: number, newX1: number) => {
+      const brush = brushRef.current
+      if (!brush || !tableData.length) return
+
+      const safeXMax = Math.max(xMax, 100)
+      const safeYMax = Math.max(yMax, BRUSH_HEIGHT + BRUSH_PADDING * 2)
+
+      // Clamp values to valid range
+      newX0 = Math.max(0, Math.min(safeXMax, newX0))
+      newX1 = Math.max(0, Math.min(safeXMax, newX1))
+
+      // Ensure x0 < x1
+      if (newX0 > newX1) {
+        ;[newX0, newX1] = [newX1, newX0]
+      }
+
+      // Ensure minimum width
+      if (newX1 - newX0 < 1) return
+
+      // Get the domain values for the new range
+      const domain = xScale.domain()
+      const xValues: string[] = []
+
+      for (const value of domain) {
+        const xPos = xScale(value)
+        if (xPos !== undefined && xPos >= newX0 && xPos < newX1) {
+          xValues.push(value)
+        }
+      }
+
+      if (xValues.length > 0) {
+        const newBounds: Bounds = {
+          x0: newX0,
+          x1: newX1,
+          y0: 0,
+          y1: safeYMax,
+          xValues
+        }
+
+        handleBrushChange(newBounds)
+
+        if (brush.updateBrush) {
+          brush.updateBrush(() => ({
+            ...brush.state,
+            extent: {
+              x0: newX0,
+              x1: newX1,
+              y0: 0,
+              y1: safeYMax
+            },
+            start: { x: newX0, y: 0 },
+            end: { x: newX1, y: safeYMax }
+          }))
+
+          previousExtent.current = { x0: newX0, x1: newX1 }
+          // For keyboard navigation, update state immediately so buttons move
+          setAccessibleExtent({ x0: newX0, x1: newX1 })
+        }
+      }
+    },
+    [xMax, yMax, tableData, xScale, handleBrushChange]
+  )
+
+  // Keyboard event handler for brush navigation
+  const handleKeyDown = useCallback(
+    (event: React.KeyboardEvent, element: FocusedElement) => {
+      if (!element) return
+
+      const brush = brushRef.current
+      if (!brush || brush.state.extent.x0 === -1) return
+
+      const { x0, x1 } = brush.state.extent
+      const step = event.shiftKey ? KEYBOARD_STEP_LARGE : KEYBOARD_STEP
+      const safeXMax = Math.max(xMax, 100)
+      const minSelectionWidth = 20 // Minimum selection width in pixels
+
+      let newX0 = x0
+      let newX1 = x1
+      let handled = false
+
+      switch (event.key) {
+        case 'ArrowLeft':
+          if (element === 'left-handle') {
+            // Move left handle left (expand selection)
+            newX0 = Math.max(0, x0 - step)
+          } else if (element === 'right-handle') {
+            // Move right handle left (shrink selection)
+            newX1 = Math.max(x0 + minSelectionWidth, x1 - step)
+          } else if (element === 'selection') {
+            // Move entire selection left
+            const width = x1 - x0
+            newX0 = Math.max(0, x0 - step)
+            newX1 = newX0 + width
+          }
+          handled = true
+          break
+
+        case 'ArrowRight':
+          if (element === 'left-handle') {
+            // Move left handle right (shrink selection)
+            newX0 = Math.min(x1 - minSelectionWidth, x0 + step)
+          } else if (element === 'right-handle') {
+            // Move right handle right (expand selection)
+            newX1 = Math.min(safeXMax, x1 + step)
+          } else if (element === 'selection') {
+            // Move entire selection right
+            const width = x1 - x0
+            newX1 = Math.min(safeXMax, x1 + step)
+            newX0 = newX1 - width
+          }
+          handled = true
+          break
+
+        case 'Home':
+          if (element === 'selection') {
+            // Move selection to start
+            const width = x1 - x0
+            newX0 = 0
+            newX1 = width
+          } else if (element === 'left-handle') {
+            newX0 = 0
+          }
+          handled = true
+          break
+
+        case 'End':
+          if (element === 'selection') {
+            // Move selection to end
+            const width = x1 - x0
+            newX1 = safeXMax
+            newX0 = safeXMax - width
+          } else if (element === 'right-handle') {
+            newX1 = safeXMax
+          }
+          handled = true
+          break
+      }
+
+      if (handled) {
+        event.preventDefault()
+        event.stopPropagation()
+        updateBrushPosition(newX0, newX1)
+      }
+    },
+    [xMax, updateBrushPosition]
+  )
+
+  // Get current brush extent for positioning accessible controls
+  const getCurrentExtent = useCallback(() => {
+    const brush = brushRef.current
+    if (brush && brush.state.extent.x0 !== -1) {
+      return {
+        x0: brush.state.extent.x0,
+        x1: brush.state.extent.x1
+      }
+    }
+    // Fallback to previousExtent or default
+    if (previousExtent.current) {
+      return previousExtent.current
+    }
+    const safeXMax = Math.max(xMax, 100)
+    return {
+      x0: safeXMax * 0.65,
+      x1: safeXMax
+    }
+  }, [xMax])
+
+  // Track when brush interaction starts (mouse down) with position
+  const handleBrushStart = (start: any) => {
+    isMouseDown.current = true
+    isUserInteracting.current = true
+
+    // Store the starting mouse position (from the brush start object)
+    if (start && start.x !== undefined) {
+      mouseDownPos.current = { x: start.x, y: start.y || 0 }
+    }
+
+    // Store the current extent before any changes
+    const brush = brushRef.current
+    if (brush && brush.state.extent.x0 !== -1) {
+      previousExtent.current = {
+        x0: brush.state.extent.x0,
+        x1: brush.state.extent.x1
+      }
+    }
+  }
+
+  // Track when brush interaction ends
+  const handleBrushEnd = () => {
+    isMouseDown.current = false
+    // Reset isUserInteracting - handleBrushChange will be called after this
+    // and will check brush state to ensure it's truly done
+    const brush = brushRef.current
+    if (brush && !brush.state?.isBrushing) {
+      isUserInteracting.current = false
+    }
+  }
+
+  const handleMouseLeave = (event: React.PointerEvent<SVGRectElement>) => {
+    // Don't cancel brush on touch devices - touch interactions trigger pointer leave
+    // when finger moves, which would cancel the brush prematurely
+    if (event.pointerType === 'touch') {
+      return
+    }
+    isMouseDown.current = false
+    mouseDownPos.current = null
+    // Reset isUserInteracting - handleBrushChange will check brush state if needed
+    const brush = brushRef.current
+    if (brush && !brush.state?.isBrushing) {
+      isUserInteracting.current = false
+    }
+  }
+
+  // Handle click to move brush to clicked location
+  const handleClick = (event: React.PointerEvent<SVGRectElement>) => {
+    const DRAG_THRESHOLD = 5 // pixels - if mouse moved less than this, it's a click
+    const HANDLE_WIDTH = 8 // Width of the brush handles
+
+    // Calculate click position relative to the brush area (accounting for BRUSH_PADDING)
+    const svgRect = event.currentTarget.ownerSVGElement?.getBoundingClientRect()
+    if (!svgRect) {
+      return
+    }
+
+    const clickX = event.clientX - svgRect.left - BRUSH_PADDING
+
+    // Check if we have a mouse down position to compare against
+    if (!mouseDownPos.current) {
+      mouseDownPos.current = null
+      return
+    }
+
+    // Calculate distance moved since mouse down
+    const dragDistance = Math.abs(clickX - mouseDownPos.current.x)
+
+    // Reset mouse down position for next interaction
+    mouseDownPos.current = null
+
+    // Only proceed if this was a click (minimal movement), not a drag
+    if (dragDistance > DRAG_THRESHOLD) {
+      return
+    }
+
+    // Use the previous extent (before visx potentially changed it)
+    if (!previousExtent.current) {
+      return
+    }
+
+    const brush = brushRef.current
+    if (!brush || !tableData.length) {
+      return
+    }
+
+    const prevExtent = previousExtent.current
+
+    // Check if click was on a handle (ignore clicks on handles)
+    const currentWidth = Math.abs(prevExtent.x1 - prevExtent.x0)
+    const leftHandleStart = Math.min(prevExtent.x0, prevExtent.x1) - HANDLE_WIDTH / 2
+    const leftHandleEnd = Math.min(prevExtent.x0, prevExtent.x1) + HANDLE_WIDTH / 2
+    const rightHandleStart = Math.max(prevExtent.x0, prevExtent.x1) - HANDLE_WIDTH / 2
+    const rightHandleEnd = Math.max(prevExtent.x0, prevExtent.x1) + HANDLE_WIDTH / 2
+
+    // If click was on a handle, do nothing
+    if (
+      (clickX >= leftHandleStart && clickX <= leftHandleEnd) ||
+      (clickX >= rightHandleStart && clickX <= rightHandleEnd)
+    ) {
+      return
+    }
+
+    // Check if click was inside the current selection (ignore clicks inside selection to allow dragging)
+    const selectionStart = Math.min(prevExtent.x0, prevExtent.x1)
+    const selectionEnd = Math.max(prevExtent.x0, prevExtent.x1)
+
+    if (clickX > selectionStart + HANDLE_WIDTH && clickX < selectionEnd - HANDLE_WIDTH) {
+      return
+    }
+
+    // Calculate the new brush position centered on click
+    const halfWidth = currentWidth / 2
+    let newX0 = clickX - halfWidth
+    let newX1 = clickX + halfWidth
+
+    // Ensure the new position stays within bounds
+    const safeXMax = Math.max(xMax, 100)
+    if (newX0 < 0) {
+      newX0 = 0
+      newX1 = currentWidth
+    } else if (newX1 > safeXMax) {
+      newX1 = safeXMax
+      newX0 = safeXMax - currentWidth
+    }
+
+    // Get the domain values for the new range
+    const domain = xScale.domain()
+    const xValues: string[] = []
+
+    for (const value of domain) {
+      const xPos = xScale(value)
+      if (xPos !== undefined && xPos >= newX0 && xPos < newX1) {
+        xValues.push(value)
+      }
+    }
+
+    // Update the brush position
+    if (xValues.length > 0) {
+      const safeYMax = Math.max(yMax, BRUSH_HEIGHT + BRUSH_PADDING * 2)
+      const newBounds: Bounds = {
+        x0: newX0,
+        x1: newX1,
+        y0: 0,
+        y1: safeYMax,
+        xValues
+      }
+
+      handleBrushChange(newBounds)
+
+      // Update the brush ref state directly to move the visual selection
+      if (brush.updateBrush) {
+        brush.updateBrush(() => ({
+          ...brush.state,
+          extent: {
+            x0: newX0,
+            x1: newX1,
+            y0: 0,
+            y1: safeYMax
+          },
+          start: { x: newX0, y: 0 },
+          end: { x: newX1, y: safeYMax }
+        }))
+
+        // Store the new extent as the previous extent for the next click
+        previousExtent.current = {
+          x0: newX0,
+          x1: newX1
+        }
+      }
+    }
+  }
+
+  // Ensure positive dimensions to avoid SVG errors
+  const safeXMax = Math.max(xMax, 100) // Minimum width of 100px
+  const safeYMax = Math.max(yMax, BRUSH_HEIGHT + BRUSH_PADDING * 2) // Minimum height with padding
+
+  // Calculate initial brush position
+  // Uses either the last X data points (if brushDefaultRecentDateCount is set) or 35% of width
+  const initialBrushPosition = useMemo(() => {
+    if (safeXMax > 0 && tableData.length > 0 && xScale) {
+      const domain = xScale.domain()
+      const brushDefaultRecentDateCount = config.xAxis.brushDefaultRecentDateCount
+
+      if (brushDefaultRecentDateCount && brushDefaultRecentDateCount > 0 && domain.length > 0) {
+        // Use exact count of most recent data points
+        const countToSelect = Math.min(brushDefaultRecentDateCount, domain.length)
+        const selectedValues = domain.slice(-countToSelect)
+
+        const firstSelectedPos = xScale(selectedValues[0])
+        const lastSelectedPos = xScale(selectedValues[selectedValues.length - 1])
+        const bandwidth = xScale.bandwidth()
+
+        const x0 = firstSelectedPos !== undefined ? firstSelectedPos : safeXMax * 0.65
+        const x1 = lastSelectedPos !== undefined ? lastSelectedPos + bandwidth : safeXMax
+
+        return {
+          start: { x: x0, y: 0 },
+          end: { x: x1, y: safeYMax }
+        }
+      }
+
+      // Default: 35% of the width
+      const initialWidth = safeXMax * 0.35
+      return {
+        start: { x: safeXMax - initialWidth, y: 0 },
+        end: { x: safeXMax, y: safeYMax }
+      }
+    }
+    return undefined
+  }, [safeXMax, safeYMax, tableData.length, xScale, config.xAxis.brushDefaultRecentDateCount])
+
+  // Calculate positions for accessible controls
+  const extent = accessibleExtent || getCurrentExtent()
+  const handleWidth = 24
+  // Selection spans from right edge of left handle to left edge of right handle
+  const selectionWidth = Math.max(extent.x1 - extent.x0 - handleWidth, 20)
+
+  return (
+    <div
+      ref={containerRef}
+      style={{
+        position: 'relative',
+        width: safeXMax,
+        height: safeYMax,
+        touchAction: 'none',
+        WebkitTouchCallout: 'none',
+        WebkitUserSelect: 'none',
+        userSelect: 'none'
+      }}
+      role='group'
+      aria-label='Date range selector'
+    >
+      <svg
+        width={safeXMax}
+        height={safeYMax}
+        style={{
+          display: 'block',
+          overflow: 'visible', // Ensure handles don't get clipped
+          touchAction: 'none', // Enable touch interactions for brush
+          WebkitTouchCallout: 'none',
+          WebkitUserSelect: 'none',
+          userSelect: 'none'
+        }}
+        aria-hidden='true'
+      >
+        {/* Pattern definition for brush selection */}
+        <defs>
+          <pattern id='brush_pattern' width='8' height='8' patternUnits='userSpaceOnUse'>
+            <path
+              d='M 0,8 l 8,-8 M -2,2 l 4,-4 M 6,10 l 4,-4'
+              stroke='#bdbdbd'
+              strokeWidth='1'
+              strokeLinecap='square'
+              shapeRendering='auto'
+            />
+          </pattern>
+        </defs>
+
+        {/* Mini chart preview */}
+        <Group top={BRUSH_PADDING}>
+          {safeXMax > 0 && tableData.length > 0 && (
+            <MiniChartPreview
+              series={series}
+              tableData={tableData}
+              dataKey={dataKey}
+              xScale={xScale}
+              miniYScale={miniYScale}
+              colorScale={colorScale}
+              config={config}
+              xMax={safeXMax}
+            />
+          )}
+        </Group>
+
+        {/* Brush component - positioned at the very top, no padding */}
+        {safeXMax > 0 && (
+          <Brush
+            xScale={xScale}
+            yScale={yScale}
+            width={safeXMax}
+            height={safeYMax}
+            brushDirection='horizontal'
+            onChange={handleBrushChange}
+            selectedBoxStyle={selectedBoxStyle}
+            useWindowMoveEvents={true} // Track mouse movements outside the brush area
+            resizeTriggerAreas={['left', 'right']} // Enable resize handles on both sides
+            innerRef={brushRef}
+            renderBrushHandle={props => <BrushHandle {...props} />}
+            initialBrushPosition={initialBrushPosition}
+            onClick={handleClick}
+            onBrushStart={handleBrushStart}
+            onBrushEnd={handleBrushEnd}
+            onMouseLeave={handleMouseLeave}
+          />
+        )}
+      </svg>
+
+      {/* Accessible keyboard controls - visually hidden but focusable, appear when focused */}
+      {safeXMax > 0 && hasInitialized.current && (
+        <div
+          style={{
+            position: 'absolute',
+            top: 0,
+            left: 0,
+            width: 0,
+            height: 0,
+            overflow: 'visible'
+          }}
+        >
+          {/* Left handle control - visually hidden until focused */}
+          <button
+            ref={leftHandleRef}
+            type='button'
+            aria-label='Left handle: Use arrow keys to adjust start of selection'
+            style={{
+              position: 'absolute',
+              left: `${extent.x0 - handleWidth / 2}px`,
+              top: 0,
+              width: focusedElement === 'left-handle' ? `${handleWidth}px` : '1px',
+              height: focusedElement === 'left-handle' ? `${safeYMax}px` : '1px',
+              background: focusedElement === 'left-handle' ? 'rgba(0, 102, 204, 0.3)' : 'transparent',
+              border: focusedElement === 'left-handle' ? '2px solid #0066cc' : 'none',
+              borderRadius: '4px',
+              pointerEvents: 'none',
+              outline: 'none',
+              padding: 0,
+              opacity: focusedElement === 'left-handle' ? 1 : 0,
+              clip: focusedElement === 'left-handle' ? 'auto' : 'rect(0, 0, 0, 0)'
+            }}
+            onFocus={() => setFocusedElement('left-handle')}
+            onBlur={() => setFocusedElement(null)}
+            onKeyDown={e => handleKeyDown(e, 'left-handle')}
+            tabIndex={0}
+          />
+
+          {/* Selection/center control - visually hidden until focused */}
+          <button
+            ref={selectionRef}
+            type='button'
+            aria-label='Selection: Use arrow keys to move entire selection'
+            style={{
+              position: 'absolute',
+              left: `${extent.x0 + handleWidth / 2}px`,
+              top: 0,
+              width: focusedElement === 'selection' ? `${selectionWidth}px` : '1px',
+              height: focusedElement === 'selection' ? `${safeYMax}px` : '1px',
+              background: focusedElement === 'selection' ? 'rgba(0, 102, 204, 0.2)' : 'transparent',
+              border: focusedElement === 'selection' ? '2px solid #0066cc' : 'none',
+              borderRadius: '4px',
+              pointerEvents: 'none',
+              outline: 'none',
+              padding: 0,
+              opacity: focusedElement === 'selection' ? 1 : 0,
+              clip: focusedElement === 'selection' ? 'auto' : 'rect(0, 0, 0, 0)'
+            }}
+            onFocus={() => setFocusedElement('selection')}
+            onBlur={() => setFocusedElement(null)}
+            onKeyDown={e => handleKeyDown(e, 'selection')}
+            tabIndex={0}
+          />
+
+          {/* Right handle control - visually hidden until focused */}
+          <button
+            ref={rightHandleRef}
+            type='button'
+            aria-label='Right handle: Use arrow keys to adjust end of selection'
+            style={{
+              position: 'absolute',
+              left: `${extent.x1 - handleWidth / 2}px`,
+              top: 0,
+              width: focusedElement === 'right-handle' ? `${handleWidth}px` : '1px',
+              height: focusedElement === 'right-handle' ? `${safeYMax}px` : '1px',
+              background: focusedElement === 'right-handle' ? 'rgba(0, 102, 204, 0.3)' : 'transparent',
+              border: focusedElement === 'right-handle' ? '2px solid #0066cc' : 'none',
+              borderRadius: '4px',
+              pointerEvents: 'none',
+              outline: 'none',
+              padding: 0,
+              opacity: focusedElement === 'right-handle' ? 1 : 0,
+              clip: focusedElement === 'right-handle' ? 'auto' : 'rect(0, 0, 0, 0)'
+            }}
+            onFocus={() => setFocusedElement('right-handle')}
+            onBlur={() => setFocusedElement(null)}
+            onKeyDown={e => handleKeyDown(e, 'right-handle')}
+            tabIndex={0}
+          />
+        </div>
+      )}
+
+      {/* Screen reader instructions */}
+      <div className='sr-only' style={{ position: 'absolute', left: '-9999px' }}>
+        Use Tab to navigate between left handle, selection, and right handle. Use Arrow keys to adjust. Hold Shift for
+        larger steps. Press Home to move to start, End to move to end.
+      </div>
+    </div>
+  )
+}
+
+export default memo(BrushSelector, (prev, next) => {
+  // Only re-render if dimensions change significantly (avoid micro-changes)
+  const xMaxChanged = Math.abs(prev.xMax - next.xMax) > 1
+  const yMaxChanged = Math.abs(prev.yMax - next.yMax) > 1
+
+  return !xMaxChanged && !yMaxChanged
+})