@tetrascience-npm/tetrascience-react-ui 0.7.0 → 1.0.0

package/dist/components/charts/BarChart/BarChart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BarChart.js","sources":["../../../../src/components/charts/BarChart/BarChart.tsx"],"sourcesContent":["import React, { useEffect, useRef, useMemo } from \"react\";\n\nimport { useChartTooltip } from \"../ChartTooltip\";\nimport { getLoadedPlotly, loadPlotly } from \"../plotly-loader\";\n\nimport { useElementSize } from \"@/hooks/use-element-size\";\nimport { CHART_FONT_FAMILY, usePlotlyTheme } from \"@/hooks/use-plotly-theme\";\nimport { cn } from \"@/lib/utils\";\nimport { seriesColor } from \"@/utils/colors\";\n\ninterface BarDataSeries {\n  x: number[];\n  y: number[];\n  name: string;\n  /** Optional color override (auto-assigned from CHART_COLORS if not provided) */\n  color?: string;\n  error_y?: {\n    type: \"data\";\n    array: number[];\n    visible: boolean;\n  };\n}\n\ntype BarChartVariant = \"group\" | \"stack\" | \"overlay\";\n\n/** Top margin reserving room for the 32px title; reduced when no title is set */\nconst TITLE_MARGIN_TOP = 60;\nconst NO_TITLE_MARGIN_TOP = 30;\n\ninterface BarChartProps {\n  dataSeries: BarDataSeries[];\n  /**\n   * Fixed width in pixels. When omitted, the chart fills its container and\n   * tracks the container's width via a `ResizeObserver`.\n   */\n  width?: number;\n  /**\n   * Fixed height in pixels. When omitted, the chart fills its container and\n   * tracks the container's height via a `ResizeObserver`.\n   */\n  height?: number;\n  xRange?: [number, number];\n  yRange?: [number, number];\n  variant?: BarChartVariant;\n  xTitle?: string;\n  yTitle?: string;\n  title?: string;\n  barWidth?: number;\n  /**\n   * Categorical labels for the x-axis ticks. When provided, the x data values\n   * still drive bar positioning but the displayed tick labels match these\n   * strings in order (e.g. [\"Mon\", \"Tue\", …]). Should align 1:1 with the\n   * unique, ordered x values across all series.\n   */\n  xTickText?: string[];\n}\n\nconst BarChart: React.FC<BarChartProps> = ({\n  dataSeries,\n  width,\n  height,\n  xRange,\n  yRange,\n  variant = \"group\",\n  xTitle,\n  yTitle,\n  title,\n  barWidth = 24,\n  xTickText,\n}) => {\n  const plotRef = useRef<HTMLDivElement>(null);\n  const theme = usePlotlyTheme();\n  const { bindTooltip, tooltipElement } = useChartTooltip({ xLabel: xTitle, yLabel: yTitle });\n\n  // Omitted width/height → fill the container and track its measured size;\n  // explicit pixel values override. See AreaPlot for the reference pattern.\n  const [containerRef, measured] = useElementSize<HTMLDivElement>();\n  const resolvedWidth = width ?? measured.width;\n  const resolvedHeight = height ?? measured.height;\n  const hasSize = resolvedWidth > 0 && resolvedHeight > 0;\n  // Fill is per-dimension: omit width to fill the container width, omit height\n  // to fill its height (so e.g. a fixed width with a container-driven height works).\n  const fillWidth = width === undefined;\n  const fillHeight = height === undefined;\n  const sizeRef = useRef({ width: resolvedWidth, height: resolvedHeight });\n  sizeRef.current = { width: resolvedWidth, height: resolvedHeight };\n  const plotInitedRef = useRef(false);\n  // Size last applied to the plot, so the resize effect can skip a redundant\n  // relayout right after newPlot already drew at that size.\n  const appliedSizeRef = useRef({ width: 0, height: 0 });\n\n  const { yMin, yMax } = useMemo(() => {\n    let minX = Number.MAX_VALUE;\n    let maxX = Number.MIN_VALUE;\n    let minY = Number.MAX_VALUE;\n    let maxY = Number.MIN_VALUE;\n\n    dataSeries.forEach((series) => {\n      series.x.forEach((x) => {\n        minX = Math.min(minX, x);\n        maxX = Math.max(maxX, x);\n      });\n      series.y.forEach((y) => {\n        minY = Math.min(minY, y);\n        maxY = Math.max(maxY, y);\n      });\n    });\n\n    const xPadding = (maxX - minX) * 0.1;\n    const yPadding = (maxY - minY) * 0.1;\n\n    return {\n      xMin: minX - xPadding,\n      xMax: maxX + xPadding,\n      yMin: variant === \"stack\" ? 0 : minY - yPadding,\n      yMax: maxY + yPadding,\n    };\n  }, [dataSeries, variant]);\n\n  const effectiveYRange = useMemo(\n    () => yRange || [yMin, yMax],\n    [yRange, yMin, yMax],\n  );\n\n  const xTicks = useMemo(\n    () => [...new Set(dataSeries.flatMap((s) => s.x))].sort((a, b) => a - b),\n    [dataSeries],\n  );\n\n  // Only apply categorical labels when they align 1:1 with the tick positions;\n  // a mismatch would silently mis-label ticks, so fall back to numeric ticks.\n  const useCategoricalX = !!xTickText && xTickText.length === xTicks.length;\n\n  const yTicks = useMemo(() => {\n    const range = effectiveYRange[1] - effectiveYRange[0];\n    let step = Math.pow(10, Math.floor(Math.log10(range)));\n\n    if (range / step > 10) step = step * 2;\n    if (range / step < 4) step = step / 2;\n\n    const ticks = [];\n    let current = Math.ceil(effectiveYRange[0] / step) * step;\n    while (current <= effectiveYRange[1]) {\n      ticks.push(current);\n      current += step;\n    }\n    return ticks;\n  }, [effectiveYRange]);\n\n  const barMode = useMemo((): \"group\" | \"stack\" | \"overlay\" => {\n    switch (variant) {\n      case \"stack\":\n        return \"stack\";\n      case \"overlay\":\n        return \"overlay\";\n      case \"group\":\n      default:\n        return \"group\";\n    }\n  }, [variant]);\n\n  const tickOptions = useMemo(\n    () => ({\n      tickcolor: theme.tickColor,\n      ticklen: 12,\n      tickwidth: 1,\n      ticks: \"outside\" as const,\n      tickfont: {\n        size: 16,\n        color: theme.textColor,\n        family: CHART_FONT_FAMILY,\n        weight: 400,\n      },\n      linecolor: theme.lineColor,\n      linewidth: 1,\n      position: 0,\n      zeroline: false,\n    }),\n    [theme],\n  );\n\n  useEffect(() => {\n    if (!plotRef.current || !hasSize) return;\n\n    const data = dataSeries.map((series, index) => ({\n      x: series.x,\n      y: series.y,\n      type: \"bar\" as const,\n      name: series.name,\n      hoverinfo: \"none\" as const,\n      marker: {\n        color: seriesColor(index, series.color),\n      },\n      width: barWidth,\n      error_y: series.error_y,\n    }));\n\n    const layout = {\n      ...(title\n        ? {\n            title: {\n              text: title,\n              font: {\n                size: 32,\n                family: CHART_FONT_FAMILY,\n                color: theme.textColor,\n              },\n            },\n          }\n        : {}),\n      width: sizeRef.current.width,\n      height: sizeRef.current.height,\n      margin: {\n        l: 80,\n        r: 30,\n        // Reserve room for tick labels, the x-axis title, and the\n        // container-anchored bottom legend stacked beneath them.\n        b: 96,\n        t: title ? TITLE_MARGIN_TOP : NO_TITLE_MARGIN_TOP,\n        pad: 0,\n      },\n      paper_bgcolor: theme.paperBg,\n      plot_bgcolor: theme.plotBg,\n      font: {\n        family: CHART_FONT_FAMILY,\n      },\n      barmode: barMode,\n      bargap: 0.15,\n      dragmode: false as const,\n      xaxis: {\n        title: {\n          text: xTitle,\n          font: {\n            size: 16,\n            color: theme.textSecondary,\n            family: CHART_FONT_FAMILY,\n            weight: 400,\n          },\n          standoff: 32,\n        },\n        gridcolor: theme.gridColor,\n        range: xRange,\n        autorange: !xRange,\n        tickmode: \"array\" as const,\n        tickvals: xTicks,\n        ...(useCategoricalX ? { ticktext: xTickText } : {}),\n        showgrid: true,\n        // Reserve space for tick labels + the axis title so the bottom legend\n        // can't overlap them at small sizes (SW-2157).\n        automargin: true,\n        ...tickOptions,\n      },\n      yaxis: {\n        title: {\n          text: yTitle,\n          font: {\n            size: 16,\n            color: theme.textSecondary,\n            family: CHART_FONT_FAMILY,\n            weight: 400,\n          },\n          standoff: 30,\n        },\n        gridcolor: theme.gridColor,\n        range: yRange,\n        autorange: !yRange,\n        tickmode: \"array\" as const,\n        tickvals: yTicks,\n        showgrid: true,\n        automargin: true,\n        ...tickOptions,\n      },\n      legend: {\n        // Anchor to the bottom of the container (not the plot area) so the\n        // legend always clears the x-axis tick labels + title — a paper-relative\n        // fractional offset collapses into the ticks at small heights (SW-2157).\n        x: 0.5,\n        y: 0,\n        xanchor: \"center\" as const,\n        yanchor: \"bottom\" as const,\n        yref: \"container\" as const,\n        orientation: \"h\" as const,\n        font: {\n          size: 16,\n          color: theme.legendColor,\n          family: CHART_FONT_FAMILY,\n          weight: 500,\n        },\n      },\n      showlegend: dataSeries.length > 1,\n    };\n\n    const config = {\n      // Sizing is driven from the measured container; disable Plotly's own\n      // window-resize responsiveness (it can't see container resizes).\n      responsive: false,\n      displayModeBar: false,\n      displaylogo: false,\n    };\n\n    // Plotly is loaded lazily so it stays out of the consumer's main chunk\n    // (SW-2007); the draw is skipped if the effect re-runs or unmounts first.\n    let cancelled = false;\n    let plotElement: HTMLDivElement | null = null;\n    void loadPlotly().then((plotly) => {\n      if (cancelled || !plotRef.current) return;\n      plotly.newPlot(plotRef.current, data, layout, config);\n      bindTooltip(plotRef.current);\n\n      // Capture ref value for cleanup\n      plotElement = plotRef.current;\n      plotInitedRef.current = true;\n      appliedSizeRef.current = { ...sizeRef.current };\n    });\n\n    return () => {\n      cancelled = true;\n      if (plotElement) {\n        getLoadedPlotly().purge(plotElement);\n        plotInitedRef.current = false;\n      }\n    };\n  }, [dataSeries, hasSize, xRange, yRange, xTitle, yTitle, title, barWidth, barMode, tickOptions, xTicks, yTicks, useCategoricalX, xTickText, theme, bindTooltip]);\n\n  // Resize in place when the measured/overridden size changes — cheaper than\n  // recreating the plot, and it preserves tooltip/event bindings.\n  useEffect(() => {\n    const plotElement = plotRef.current;\n    if (!plotElement || !plotInitedRef.current || resolvedWidth <= 0 || resolvedHeight <= 0) {\n      return;\n    }\n    // newPlot already drew at the current size; skip the redundant relayout\n    // (it would queue an automargin redraw that can reject if we unmount first).\n    if (\n      appliedSizeRef.current.width === resolvedWidth &&\n      appliedSizeRef.current.height === resolvedHeight\n    ) {\n      return;\n    }\n    appliedSizeRef.current = { width: resolvedWidth, height: resolvedHeight };\n    // Swallow rejections from a relayout that races an unmount/purge.\n    // plotInitedRef guarantees Plotly finished loading, so sync access is safe.\n    void getLoadedPlotly()\n      .relayout(plotElement, { width: resolvedWidth, height: resolvedHeight })\n      .catch(() => {});\n  }, [resolvedWidth, resolvedHeight]);\n\n  return (\n    <div\n      ref={containerRef}\n      className={cn(\"bar-graph-container relative\", fillWidth && \"w-full\", fillHeight && \"h-full\")}\n    >\n      <div ref={plotRef} style={{ width: \"100%\", height: \"100%\" }} />\n      {tooltipElement}\n    </div>\n  );\n};\n\nexport { BarChart };\nexport type { BarDataSeries, BarChartVariant, BarChartProps };\n"],"names":["TITLE_MARGIN_TOP","NO_TITLE_MARGIN_TOP","BarChart","dataSeries","width","height","xRange","yRange","variant","xTitle","yTitle","title","barWidth","xTickText","plotRef","useRef","theme","usePlotlyTheme","bindTooltip","tooltipElement","useChartTooltip","containerRef","measured","useElementSize","resolvedWidth","resolvedHeight","hasSize","fillWidth","fillHeight","sizeRef","plotInitedRef","appliedSizeRef","yMin","yMax","useMemo","minX","maxX","minY","maxY","series","x","y","xPadding","yPadding","effectiveYRange","xTicks","s","a","b","useCategoricalX","yTicks","range","step","ticks","current","barMode","tickOptions","CHART_FONT_FAMILY","useEffect","data","index","seriesColor","layout","config","cancelled","plotElement","loadPlotly","plotly","getLoadedPlotly","jsxs","cn","jsx"],"mappings":";;;;;;;;AA0BA,MAAMA,KAAmB,IACnBC,KAAsB,IA8BtBC,KAAoC,CAAC;AAAA,EACzC,YAAAC;AAAA,EACA,OAAAC;AAAA,EACA,QAAAC;AAAA,EACA,QAAAC;AAAA,EACA,QAAAC;AAAA,EACA,SAAAC,IAAU;AAAA,EACV,QAAAC;AAAA,EACA,QAAAC;AAAA,EACA,OAAAC;AAAA,EACA,UAAAC,IAAW;AAAA,EACX,WAAAC;AACF,MAAM;AACJ,QAAMC,IAAUC,EAAuB,IAAI,GACrCC,IAAQC,EAAA,GACR,EAAE,aAAAC,GAAa,gBAAAC,EAAA,IAAmBC,EAAgB,EAAE,QAAQX,GAAQ,QAAQC,GAAQ,GAIpF,CAACW,GAAcC,CAAQ,IAAIC,EAAA,GAC3BC,IAAgBpB,KAASkB,EAAS,OAClCG,IAAiBpB,KAAUiB,EAAS,QACpCI,IAAUF,IAAgB,KAAKC,IAAiB,GAGhDE,IAAYvB,MAAU,QACtBwB,IAAavB,MAAW,QACxBwB,IAAUd,EAAO,EAAE,OAAOS,GAAe,QAAQC,GAAgB;AACvE,EAAAI,EAAQ,UAAU,EAAE,OAAOL,GAAe,QAAQC,EAAA;AAClD,QAAMK,IAAgBf,EAAO,EAAK,GAG5BgB,IAAiBhB,EAAO,EAAE,OAAO,GAAG,QAAQ,GAAG,GAE/C,EAAE,MAAAiB,GAAM,MAAAC,EAAA,IAASC,EAAQ,MAAM;AACnC,QAAIC,IAAO,OAAO,WACdC,IAAO,OAAO,WACdC,IAAO,OAAO,WACdC,IAAO,OAAO;AAElB,IAAAnC,EAAW,QAAQ,CAACoC,MAAW;AAC7B,MAAAA,EAAO,EAAE,QAAQ,CAACC,MAAM;AACtB,QAAAL,IAAO,KAAK,IAAIA,GAAMK,CAAC,GACvBJ,IAAO,KAAK,IAAIA,GAAMI,CAAC;AAAA,MACzB,CAAC,GACDD,EAAO,EAAE,QAAQ,CAACE,MAAM;AACtB,QAAAJ,IAAO,KAAK,IAAIA,GAAMI,CAAC,GACvBH,IAAO,KAAK,IAAIA,GAAMG,CAAC;AAAA,MACzB,CAAC;AAAA,IACH,CAAC;AAED,UAAMC,KAAYN,IAAOD,KAAQ,KAC3BQ,KAAYL,IAAOD,KAAQ;AAEjC,WAAO;AAAA,MACL,MAAMF,IAAOO;AAAA,MACb,MAAMN,IAAOM;AAAA,MACb,MAAMlC,MAAY,UAAU,IAAI6B,IAAOM;AAAA,MACvC,MAAML,IAAOK;AAAA,IAAA;AAAA,EAEjB,GAAG,CAACxC,GAAYK,CAAO,CAAC,GAElBoC,IAAkBV;AAAA,IACtB,MAAM3B,KAAU,CAACyB,GAAMC,CAAI;AAAA,IAC3B,CAAC1B,GAAQyB,GAAMC,CAAI;AAAA,EAAA,GAGfY,IAASX;AAAA,IACb,MAAM,CAAC,GAAG,IAAI,IAAI/B,EAAW,QAAQ,CAAC2C,MAAMA,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAACC,GAAGC,MAAMD,IAAIC,CAAC;AAAA,IACvE,CAAC7C,CAAU;AAAA,EAAA,GAKP8C,IAAkB,CAAC,CAACpC,KAAaA,EAAU,WAAWgC,EAAO,QAE7DK,IAAShB,EAAQ,MAAM;AAC3B,UAAMiB,IAAQP,EAAgB,CAAC,IAAIA,EAAgB,CAAC;AACpD,QAAIQ,IAAO,KAAK,IAAI,IAAI,KAAK,MAAM,KAAK,MAAMD,CAAK,CAAC,CAAC;AAErD,IAAIA,IAAQC,IAAO,OAAIA,IAAOA,IAAO,IACjCD,IAAQC,IAAO,MAAGA,IAAOA,IAAO;AAEpC,UAAMC,IAAQ,CAAA;AACd,QAAIC,IAAU,KAAK,KAAKV,EAAgB,CAAC,IAAIQ,CAAI,IAAIA;AACrD,WAAOE,KAAWV,EAAgB,CAAC;AACjC,MAAAS,EAAM,KAAKC,CAAO,GAClBA,KAAWF;AAEb,WAAOC;AAAA,EACT,GAAG,CAACT,CAAe,CAAC,GAEdW,IAAUrB,EAAQ,MAAqC;AAC3D,YAAQ1B,GAAA;AAAA,MACN,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MAET;AACE,eAAO;AAAA,IAAA;AAAA,EAEb,GAAG,CAACA,CAAO,CAAC,GAENgD,IAActB;AAAA,IAClB,OAAO;AAAA,MACL,WAAWlB,EAAM;AAAA,MACjB,SAAS;AAAA,MACT,WAAW;AAAA,MACX,OAAO;AAAA,MACP,UAAU;AAAA,QACR,MAAM;AAAA,QACN,OAAOA,EAAM;AAAA,QACb,QAAQyC;AAAA,QACR,QAAQ;AAAA,MAAA;AAAA,MAEV,WAAWzC,EAAM;AAAA,MACjB,WAAW;AAAA,MACX,UAAU;AAAA,MACV,UAAU;AAAA,IAAA;AAAA,IAEZ,CAACA,CAAK;AAAA,EAAA;AAGR,SAAA0C,EAAU,MAAM;AACd,QAAI,CAAC5C,EAAQ,WAAW,CAACY,EAAS;AAElC,UAAMiC,IAAOxD,EAAW,IAAI,CAACoC,GAAQqB,OAAW;AAAA,MAC9C,GAAGrB,EAAO;AAAA,MACV,GAAGA,EAAO;AAAA,MACV,MAAM;AAAA,MACN,MAAMA,EAAO;AAAA,MACb,WAAW;AAAA,MACX,QAAQ;AAAA,QACN,OAAOsB,EAAYD,GAAOrB,EAAO,KAAK;AAAA,MAAA;AAAA,MAExC,OAAO3B;AAAA,MACP,SAAS2B,EAAO;AAAA,IAAA,EAChB,GAEIuB,IAAS;AAAA,MACb,GAAInD,IACA;AAAA,QACE,OAAO;AAAA,UACL,MAAMA;AAAA,UACN,MAAM;AAAA,YACJ,MAAM;AAAA,YACN,QAAQ8C;AAAA,YACR,OAAOzC,EAAM;AAAA,UAAA;AAAA,QACf;AAAA,MACF,IAEF,CAAA;AAAA,MACJ,OAAOa,EAAQ,QAAQ;AAAA,MACvB,QAAQA,EAAQ,QAAQ;AAAA,MACxB,QAAQ;AAAA,QACN,GAAG;AAAA,QACH,GAAG;AAAA;AAAA;AAAA,QAGH,GAAG;AAAA,QACH,GAAGlB,IAAQX,KAAmBC;AAAA,QAC9B,KAAK;AAAA,MAAA;AAAA,MAEP,eAAee,EAAM;AAAA,MACrB,cAAcA,EAAM;AAAA,MACpB,MAAM;AAAA,QACJ,QAAQyC;AAAA,MAAA;AAAA,MAEV,SAASF;AAAA,MACT,QAAQ;AAAA,MACR,UAAU;AAAA,MACV,OAAO;AAAA,QACL,OAAO;AAAA,UACL,MAAM9C;AAAA,UACN,MAAM;AAAA,YACJ,MAAM;AAAA,YACN,OAAOO,EAAM;AAAA,YACb,QAAQyC;AAAA,YACR,QAAQ;AAAA,UAAA;AAAA,UAEV,UAAU;AAAA,QAAA;AAAA,QAEZ,WAAWzC,EAAM;AAAA,QACjB,OAAOV;AAAA,QACP,WAAW,CAACA;AAAA,QACZ,UAAU;AAAA,QACV,UAAUuC;AAAA,QACV,GAAII,IAAkB,EAAE,UAAUpC,EAAA,IAAc,CAAA;AAAA,QAChD,UAAU;AAAA;AAAA;AAAA,QAGV,YAAY;AAAA,QACZ,GAAG2C;AAAA,MAAA;AAAA,MAEL,OAAO;AAAA,QACL,OAAO;AAAA,UACL,MAAM9C;AAAA,UACN,MAAM;AAAA,YACJ,MAAM;AAAA,YACN,OAAOM,EAAM;AAAA,YACb,QAAQyC;AAAA,YACR,QAAQ;AAAA,UAAA;AAAA,UAEV,UAAU;AAAA,QAAA;AAAA,QAEZ,WAAWzC,EAAM;AAAA,QACjB,OAAOT;AAAA,QACP,WAAW,CAACA;AAAA,QACZ,UAAU;AAAA,QACV,UAAU2C;AAAA,QACV,UAAU;AAAA,QACV,YAAY;AAAA,QACZ,GAAGM;AAAA,MAAA;AAAA,MAEL,QAAQ;AAAA;AAAA;AAAA;AAAA,QAIN,GAAG;AAAA,QACH,GAAG;AAAA,QACH,SAAS;AAAA,QACT,SAAS;AAAA,QACT,MAAM;AAAA,QACN,aAAa;AAAA,QACb,MAAM;AAAA,UACJ,MAAM;AAAA,UACN,OAAOxC,EAAM;AAAA,UACb,QAAQyC;AAAA,UACR,QAAQ;AAAA,QAAA;AAAA,MACV;AAAA,MAEF,YAAYtD,EAAW,SAAS;AAAA,IAAA,GAG5B4D,IAAS;AAAA;AAAA;AAAA,MAGb,YAAY;AAAA,MACZ,gBAAgB;AAAA,MAChB,aAAa;AAAA,IAAA;AAKf,QAAIC,IAAY,IACZC,IAAqC;AACzC,WAAKC,EAAA,EAAa,KAAK,CAACC,MAAW;AACjC,MAAIH,KAAa,CAAClD,EAAQ,YAC1BqD,EAAO,QAAQrD,EAAQ,SAAS6C,GAAMG,GAAQC,CAAM,GACpD7C,EAAYJ,EAAQ,OAAO,GAG3BmD,IAAcnD,EAAQ,SACtBgB,EAAc,UAAU,IACxBC,EAAe,UAAU,EAAE,GAAGF,EAAQ,QAAA;AAAA,IACxC,CAAC,GAEM,MAAM;AACX,MAAAmC,IAAY,IACRC,MACFG,EAAA,EAAkB,MAAMH,CAAW,GACnCnC,EAAc,UAAU;AAAA,IAE5B;AAAA,EACF,GAAG,CAAC3B,GAAYuB,GAASpB,GAAQC,GAAQE,GAAQC,GAAQC,GAAOC,GAAU2C,GAASC,GAAaX,GAAQK,GAAQD,GAAiBpC,GAAWG,GAAOE,CAAW,CAAC,GAI/JwC,EAAU,MAAM;AACd,UAAMO,IAAcnD,EAAQ;AAC5B,IAAI,CAACmD,KAAe,CAACnC,EAAc,WAAWN,KAAiB,KAAKC,KAAkB,KAMpFM,EAAe,QAAQ,UAAUP,KACjCO,EAAe,QAAQ,WAAWN,MAIpCM,EAAe,UAAU,EAAE,OAAOP,GAAe,QAAQC,EAAA,GAGpD2C,EAAA,EACF,SAASH,GAAa,EAAE,OAAOzC,GAAe,QAAQC,GAAgB,EACtE,MAAM,MAAM;AAAA,IAAC,CAAC;AAAA,EACnB,GAAG,CAACD,GAAeC,CAAc,CAAC,GAGhC,gBAAA4C;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,KAAKhD;AAAA,MACL,WAAWiD,EAAG,gCAAgC3C,KAAa,UAAUC,KAAc,QAAQ;AAAA,MAE3F,UAAA;AAAA,QAAA,gBAAA2C,EAAC,OAAA,EAAI,KAAKzD,GAAS,OAAO,EAAE,OAAO,QAAQ,QAAQ,OAAA,EAAO,CAAG;AAAA,QAC5DK;AAAA,MAAA;AAAA,IAAA;AAAA,EAAA;AAGP;"}

package/dist/components/charts/BarChart/index.d.ts

@@ -0,0 +1,2 @@
+export { BarChart } from './BarChart';
+export type { BarDataSeries, BarChartVariant, BarChartProps } from './BarChart';

package/dist/components/charts/BoxPlot/BoxPlot.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const z=require("react/jsx-runtime"),r=require("react"),B=require("../ChartTooltip/ChartTooltip.cjs"),A=require("../plotly-loader.cjs"),S=require("../../../hooks/use-element-size.cjs"),h=require("../../../hooks/use-plotly-theme.cjs"),U=require("../../../lib/utils.cjs"),W=require("../../../utils/colors.cjs"),V=-1.8,D=({dataSeries:p,width:C,height:b,xRange:x,yRange:g,xTitle:M,yTitle:w,title:v="Box Plot",showPoints:L=!1})=>{const s=r.useRef(null),e=h.usePlotlyTheme(),{bindTooltip:F,tooltipElement:I}=B.useChartTooltip({xLabel:M,yLabel:w}),[Y,k]=S.useElementSize(),i=C??k.width,l=b??k.height,E=i>0&&l>0,q=C===void 0,H=b===void 0,m=r.useRef({width:i,height:l});m.current={width:i,height:l};const _=r.useRef(!1),y=r.useRef({width:0,height:0}),{yMin:N,yMax:O}=r.useMemo(()=>{let o=Number.MAX_VALUE,t=Number.MIN_VALUE;p.forEach(c=>{c.y.forEach(d=>{o=Math.min(o,d),t=Math.max(t,d)})});const a=(t-o)*.1;return{yMin:o-a,yMax:t+a}},[p]),f=r.useMemo(()=>g||[N,O],[g,N,O]),P=r.useMemo(()=>{const o=f[1]-f[0];let t=Math.pow(10,Math.floor(Math.log10(o)));o/t>10&&(t=t*2),o/t<4&&(t=t/2);const a=[];let c=Math.ceil(f[0]/t)*t;for(;c<=f[1];)a.push(c),c+=t;return a},[f]),T=r.useMemo(()=>({tickcolor:e.tickColor,ticklen:12,tickwidth:1,ticks:"outside",tickfont:{size:16,color:e.textColor,family:h.CHART_FONT_FAMILY,weight:400},linecolor:e.lineColor,linewidth:1,position:0,zeroline:!1}),[e]),R=r.useMemo(()=>({text:v,x:.5,y:.95,xanchor:"center",yanchor:"top",font:{size:32,weight:600,family:h.CHART_FONT_FAMILY,color:e.textColor,lineheight:1.2,standoff:30}}),[v,e]);return r.useEffect(()=>{if(!s.current||!E)return;const o=p.map((n,j)=>{const u=W.seriesColor(j,n.color);return{y:n.y,x:n.x,type:"box",name:n.name,hoverinfo:"none",marker:{color:u},line:{color:u},fillcolor:typeof u=="string"&&u.startsWith("#")&&u.length===7?`${u}40`:u,boxpoints:L?n.boxpoints||"outliers":!1,jitter:n.jitter||.3,pointpos:n.pointpos||V}}),t={width:m.current.width,height:m.current.height,title:R,margin:{l:80,r:40,b:96,t:80,pad:0},paper_bgcolor:e.paperBg,plot_bgcolor:e.plotBg,font:{family:h.CHART_FONT_FAMILY},dragmode:!1,xaxis:{title:{text:M,font:{size:16,color:e.textSecondary,family:h.CHART_FONT_FAMILY,weight:400},standoff:15},gridcolor:e.gridColor,range:x,autorange:!x,showgrid:!0,automargin:!0,...T},yaxis:{title:{text:w,font:{size:16,color:e.textSecondary,family:h.CHART_FONT_FAMILY,weight:400},standoff:15},gridcolor:e.gridColor,range:g,autorange:!g,tickmode:"array",tickvals:P,showgrid:!0,automargin:!0,...T},legend:{x:.5,y:0,xanchor:"center",yanchor:"bottom",yref:"container",orientation:"h",font:{size:13,color:e.legendColor,family:h.CHART_FONT_FAMILY,weight:500,lineheight:18}},showlegend:!0},a={responsive:!1,displayModeBar:!1,displaylogo:!1};let c=!1,d=null;return A.loadPlotly().then(n=>{c||!s.current||(n.newPlot(s.current,o,t,a),F(s.current),d=s.current,_.current=!0,y.current={...m.current})}),()=>{c=!0,d&&(A.getLoadedPlotly().purge(d),_.current=!1)}},[p,E,x,g,f,M,w,L,R,T,P,e,F]),r.useEffect(()=>{const o=s.current;!o||!_.current||i<=0||l<=0||y.current.width===i&&y.current.height===l||(y.current={width:i,height:l},A.getLoadedPlotly().relayout(o,{width:i,height:l}).catch(()=>{}))},[i,l]),z.jsxs("div",{ref:Y,className:U.cn("boxplot-container relative",q&&"w-full",H&&"h-full"),children:[z.jsx("div",{ref:s,style:{width:"100%",height:"100%"}}),I]})};exports.BoxPlot=D;
+//# sourceMappingURL=BoxPlot.cjs.map

package/dist/components/charts/BoxPlot/BoxPlot.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoxPlot.cjs","sources":["../../../../src/components/charts/BoxPlot/BoxPlot.tsx"],"sourcesContent":["import React, { useEffect, useRef, useMemo } from \"react\";\n\nimport { useChartTooltip } from \"../ChartTooltip\";\nimport { getLoadedPlotly, loadPlotly } from \"../plotly-loader\";\n\nimport { useElementSize } from \"@/hooks/use-element-size\";\nimport { CHART_FONT_FAMILY, usePlotlyTheme } from \"@/hooks/use-plotly-theme\";\nimport { cn } from \"@/lib/utils\";\nimport { seriesColor } from \"@/utils/colors\";\n\n/** Default point position offset from the box edge */\nconst DEFAULT_POINT_POSITION = -1.8;\n\ninterface BoxDataSeries {\n  y: number[];\n  name: string;\n  /** Optional color override (auto-assigned from CHART_COLORS if not provided) */\n  color?: string;\n  x?: string[] | number[];\n  boxpoints?: \"all\" | \"outliers\" | \"suspectedoutliers\" | false;\n  jitter?: number;\n  pointpos?: number;\n}\n\ninterface BoxPlotProps {\n  dataSeries: BoxDataSeries[];\n  /**\n   * Fixed width in pixels. When omitted, the chart fills its container and\n   * tracks the container's width via a `ResizeObserver`.\n   */\n  width?: number;\n  /**\n   * Fixed height in pixels. When omitted, the chart fills its container and\n   * tracks the container's height via a `ResizeObserver`.\n   */\n  height?: number;\n  xRange?: [number, number];\n  yRange?: [number, number];\n  xTitle?: string;\n  yTitle?: string;\n  title?: string;\n  showPoints?: boolean;\n}\n\nconst BoxPlot: React.FC<BoxPlotProps> = ({\n  dataSeries,\n  width,\n  height,\n  xRange,\n  yRange,\n  xTitle,\n  yTitle,\n  title = \"Box Plot\",\n  showPoints = false,\n}) => {\n  const plotRef = useRef<HTMLDivElement>(null);\n  const theme = usePlotlyTheme();\n  const { bindTooltip, tooltipElement } = useChartTooltip({ xLabel: xTitle, yLabel: yTitle });\n\n  // Omitted width/height → fill the container and track its measured size;\n  // explicit pixel values override. See AreaPlot for the reference pattern.\n  const [containerRef, measured] = useElementSize<HTMLDivElement>();\n  const resolvedWidth = width ?? measured.width;\n  const resolvedHeight = height ?? measured.height;\n  const hasSize = resolvedWidth > 0 && resolvedHeight > 0;\n  // Fill is per-dimension: omit width to fill the container width, omit height\n  // to fill its height (so e.g. a fixed width with a container-driven height works).\n  const fillWidth = width === undefined;\n  const fillHeight = height === undefined;\n  const sizeRef = useRef({ width: resolvedWidth, height: resolvedHeight });\n  sizeRef.current = { width: resolvedWidth, height: resolvedHeight };\n  const plotInitedRef = useRef(false);\n  // Size last applied to the plot, so the resize effect can skip a redundant\n  // relayout right after newPlot already drew at that size.\n  const appliedSizeRef = useRef({ width: 0, height: 0 });\n\n  const { yMin, yMax } = useMemo(() => {\n    let minY = Number.MAX_VALUE;\n    let maxY = Number.MIN_VALUE;\n\n    dataSeries.forEach((series) => {\n      series.y.forEach((y) => {\n        minY = Math.min(minY, y);\n        maxY = Math.max(maxY, y);\n      });\n    });\n\n    const yPadding = (maxY - minY) * 0.1;\n\n    return {\n      yMin: minY - yPadding,\n      yMax: maxY + yPadding,\n    };\n  }, [dataSeries]);\n\n  const effectiveYRange = useMemo(\n    () => yRange || [yMin, yMax],\n    [yRange, yMin, yMax],\n  );\n\n  const yTicks = useMemo(() => {\n    const range = effectiveYRange[1] - effectiveYRange[0];\n    let step = Math.pow(10, Math.floor(Math.log10(range)));\n\n    if (range / step > 10) step = step * 2;\n    if (range / step < 4) step = step / 2;\n\n    const ticks = [];\n    let current = Math.ceil(effectiveYRange[0] / step) * step;\n    while (current <= effectiveYRange[1]) {\n      ticks.push(current);\n      current += step;\n    }\n    return ticks;\n  }, [effectiveYRange]);\n\n  const tickOptions = useMemo(\n    () => ({\n      tickcolor: theme.tickColor,\n      ticklen: 12,\n      tickwidth: 1,\n      ticks: \"outside\" as const,\n      tickfont: {\n        size: 16,\n        color: theme.textColor,\n        family: CHART_FONT_FAMILY,\n        weight: 400,\n      },\n      linecolor: theme.lineColor,\n      linewidth: 1,\n      position: 0,\n      zeroline: false,\n    }),\n    [theme],\n  );\n\n  const titleOptions = useMemo(\n    () => ({\n      text: title,\n      x: 0.5,\n      y: 0.95,\n      xanchor: \"center\" as const,\n      yanchor: \"top\" as const,\n      font: {\n        size: 32,\n        weight: 600,\n        family: CHART_FONT_FAMILY,\n        color: theme.textColor,\n        lineheight: 1.2,\n        standoff: 30,\n      },\n    }),\n    [title, theme],\n  );\n\n  useEffect(() => {\n    if (!plotRef.current || !hasSize) return;\n\n    const data = dataSeries.map((series, index) => {\n      const color = seriesColor(index, series.color);\n      return {\n        y: series.y,\n        x: series.x,\n        type: \"box\" as const,\n        name: series.name,\n        hoverinfo: \"none\" as const,\n        marker: {\n          color,\n        },\n        line: {\n          color,\n        },\n        fillcolor:\n          typeof color === \"string\" && color.startsWith(\"#\") && color.length === 7\n            ? `${color}40`\n            : color, // Add transparency for hex colors only\n        boxpoints: showPoints\n          ? series.boxpoints || \"outliers\"\n          : (false as const),\n        jitter: series.jitter || 0.3,\n        pointpos: series.pointpos || DEFAULT_POINT_POSITION,\n      };\n    });\n\n    const layout = {\n      width: sizeRef.current.width,\n      height: sizeRef.current.height,\n      title: titleOptions,\n      // Bottom margin reserves room for tick labels, the x-axis title, and the\n      // container-anchored bottom legend stacked beneath them.\n      margin: { l: 80, r: 40, b: 96, t: 80, pad: 0 },\n      paper_bgcolor: theme.paperBg,\n      plot_bgcolor: theme.plotBg,\n      font: {\n        family: CHART_FONT_FAMILY,\n      },\n      dragmode: false as const,\n      xaxis: {\n        title: {\n          text: xTitle,\n          font: {\n            size: 16,\n            color: theme.textSecondary,\n            family: CHART_FONT_FAMILY,\n            weight: 400,\n          },\n          standoff: 15,\n        },\n        gridcolor: theme.gridColor,\n        range: xRange,\n        autorange: !xRange,\n        showgrid: true,\n        // Reserve space for tick labels + the axis title so the bottom legend\n        // can't overlap them at small sizes (SW-2157).\n        automargin: true,\n        ...tickOptions,\n      },\n      yaxis: {\n        title: {\n          text: yTitle,\n          font: {\n            size: 16,\n            color: theme.textSecondary,\n            family: CHART_FONT_FAMILY,\n            weight: 400,\n          },\n          standoff: 15,\n        },\n        gridcolor: theme.gridColor,\n        range: yRange,\n        autorange: !yRange,\n        tickmode: \"array\" as const,\n        tickvals: yTicks,\n        showgrid: true,\n        automargin: true,\n        ...tickOptions,\n      },\n      legend: {\n        // Anchor to the bottom of the container (not the plot area) so the\n        // legend always clears the x-axis tick labels + title — a paper-relative\n        // fractional offset collapses into the ticks at small heights (SW-2157).\n        x: 0.5,\n        y: 0,\n        xanchor: \"center\" as const,\n        yanchor: \"bottom\" as const,\n        yref: \"container\" as const,\n        orientation: \"h\" as const,\n        font: {\n          size: 13,\n          color: theme.legendColor,\n          family: CHART_FONT_FAMILY,\n          weight: 500,\n          lineheight: 18,\n        },\n      },\n      showlegend: true,\n    };\n\n    const config = {\n      // Sizing is driven from the measured container; disable Plotly's own\n      // window-resize responsiveness (it can't see container resizes).\n      responsive: false,\n      displayModeBar: false,\n      displaylogo: false,\n    };\n\n    // Plotly is loaded lazily so it stays out of the consumer's main chunk\n    // (SW-2007); the draw is skipped if the effect re-runs or unmounts first.\n    let cancelled = false;\n    let plotElement: HTMLDivElement | null = null;\n    void loadPlotly().then((plotly) => {\n      if (cancelled || !plotRef.current) return;\n      plotly.newPlot(plotRef.current, data, layout, config);\n      bindTooltip(plotRef.current);\n\n      // Capture ref value for cleanup\n      plotElement = plotRef.current;\n      plotInitedRef.current = true;\n      appliedSizeRef.current = { ...sizeRef.current };\n    });\n\n    return () => {\n      cancelled = true;\n      if (plotElement) {\n        getLoadedPlotly().purge(plotElement);\n        plotInitedRef.current = false;\n      }\n    };\n  }, [dataSeries, hasSize, xRange, yRange, effectiveYRange, xTitle, yTitle, showPoints, titleOptions, tickOptions, yTicks, theme, bindTooltip]);\n\n  // Resize in place when the measured/overridden size changes — cheaper than\n  // recreating the plot, and it preserves tooltip/event bindings.\n  useEffect(() => {\n    const plotElement = plotRef.current;\n    if (!plotElement || !plotInitedRef.current || resolvedWidth <= 0 || resolvedHeight <= 0) {\n      return;\n    }\n    // newPlot already drew at the current size; skip the redundant relayout\n    // (it would queue an automargin redraw that can reject if we unmount first).\n    if (\n      appliedSizeRef.current.width === resolvedWidth &&\n      appliedSizeRef.current.height === resolvedHeight\n    ) {\n      return;\n    }\n    appliedSizeRef.current = { width: resolvedWidth, height: resolvedHeight };\n    // Swallow rejections from a relayout that races an unmount/purge.\n    // plotInitedRef guarantees Plotly finished loading, so sync access is safe.\n    void getLoadedPlotly()\n      .relayout(plotElement, { width: resolvedWidth, height: resolvedHeight })\n      .catch(() => {});\n  }, [resolvedWidth, resolvedHeight]);\n\n  return (\n    <div\n      ref={containerRef}\n      className={cn(\"boxplot-container relative\", fillWidth && \"w-full\", fillHeight && \"h-full\")}\n    >\n      <div ref={plotRef} style={{ width: \"100%\", height: \"100%\" }} />\n      {tooltipElement}\n    </div>\n  );\n};\n\nexport { BoxPlot };\nexport type { BoxDataSeries, BoxPlotProps };\n"],"names":["DEFAULT_POINT_POSITION","BoxPlot","dataSeries","width","height","xRange","yRange","xTitle","yTitle","title","showPoints","plotRef","useRef","theme","usePlotlyTheme","bindTooltip","tooltipElement","useChartTooltip","containerRef","measured","useElementSize","resolvedWidth","resolvedHeight","hasSize","fillWidth","fillHeight","sizeRef","plotInitedRef","appliedSizeRef","yMin","yMax","useMemo","minY","maxY","series","y","yPadding","effectiveYRange","yTicks","range","step","ticks","current","tickOptions","CHART_FONT_FAMILY","titleOptions","useEffect","data","index","color","seriesColor","layout","config","cancelled","plotElement","loadPlotly","plotly","getLoadedPlotly","jsxs","cn","jsx"],"mappings":"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"}

package/dist/components/charts/BoxPlot/BoxPlot.d.ts

@@ -0,0 +1,33 @@
+import { default as React } from 'react';
+interface BoxDataSeries {
+    y: number[];
+    name: string;
+    /** Optional color override (auto-assigned from CHART_COLORS if not provided) */
+    color?: string;
+    x?: string[] | number[];
+    boxpoints?: "all" | "outliers" | "suspectedoutliers" | false;
+    jitter?: number;
+    pointpos?: number;
+}
+interface BoxPlotProps {
+    dataSeries: BoxDataSeries[];
+    /**
+     * Fixed width in pixels. When omitted, the chart fills its container and
+     * tracks the container's width via a `ResizeObserver`.
+     */
+    width?: number;
+    /**
+     * Fixed height in pixels. When omitted, the chart fills its container and
+     * tracks the container's height via a `ResizeObserver`.
+     */
+    height?: number;
+    xRange?: [number, number];
+    yRange?: [number, number];
+    xTitle?: string;
+    yTitle?: string;
+    title?: string;
+    showPoints?: boolean;
+}
+declare const BoxPlot: React.FC<BoxPlotProps>;
+export { BoxPlot };
+export type { BoxDataSeries, BoxPlotProps };

package/dist/components/charts/BoxPlot/BoxPlot.js

@@ -0,0 +1,208 @@
+import { jsxs as W, jsx as R } from "react/jsx-runtime";
+import { useRef as x, useMemo as m, useEffect as T } from "react";
+import { useChartTooltip as V } from "../ChartTooltip/ChartTooltip.js";
+import { loadPlotly as D, getLoadedPlotly as j } from "../plotly-loader.js";
+import { useElementSize as X } from "../../../hooks/use-element-size.js";
+import { usePlotlyTheme as $, CHART_FONT_FAMILY as u } from "../../../hooks/use-plotly-theme.js";
+import { cn as q } from "../../../lib/utils.js";
+import { seriesColor as G } from "../../../utils/colors.js";
+const J = -1.8, nt = ({
+  dataSeries: p,
+  width: z,
+  height: C,
+  xRange: w,
+  yRange: d,
+  xTitle: M,
+  yTitle: b,
+  title: E = "Box Plot",
+  showPoints: P = !1
+}) => {
+  const c = x(null), o = $(), { bindTooltip: _, tooltipElement: Y } = V({ xLabel: M, yLabel: b }), [F, L] = X(), i = z ?? L.width, n = C ?? L.height, N = i > 0 && n > 0, H = z === void 0, S = C === void 0, g = x({ width: i, height: n });
+  g.current = { width: i, height: n };
+  const v = x(!1), y = x({ width: 0, height: 0 }), { yMin: A, yMax: I } = m(() => {
+    let e = Number.MAX_VALUE, t = Number.MIN_VALUE;
+    p.forEach((l) => {
+      l.y.forEach((f) => {
+        e = Math.min(e, f), t = Math.max(t, f);
+      });
+    });
+    const a = (t - e) * 0.1;
+    return {
+      yMin: e - a,
+      yMax: t + a
+    };
+  }, [p]), h = m(
+    () => d || [A, I],
+    [d, A, I]
+  ), O = m(() => {
+    const e = h[1] - h[0];
+    let t = Math.pow(10, Math.floor(Math.log10(e)));
+    e / t > 10 && (t = t * 2), e / t < 4 && (t = t / 2);
+    const a = [];
+    let l = Math.ceil(h[0] / t) * t;
+    for (; l <= h[1]; )
+      a.push(l), l += t;
+    return a;
+  }, [h]), k = m(
+    () => ({
+      tickcolor: o.tickColor,
+      ticklen: 12,
+      tickwidth: 1,
+      ticks: "outside",
+      tickfont: {
+        size: 16,
+        color: o.textColor,
+        family: u,
+        weight: 400
+      },
+      linecolor: o.lineColor,
+      linewidth: 1,
+      position: 0,
+      zeroline: !1
+    }),
+    [o]
+  ), B = m(
+    () => ({
+      text: E,
+      x: 0.5,
+      y: 0.95,
+      xanchor: "center",
+      yanchor: "top",
+      font: {
+        size: 32,
+        weight: 600,
+        family: u,
+        color: o.textColor,
+        lineheight: 1.2,
+        standoff: 30
+      }
+    }),
+    [E, o]
+  );
+  return T(() => {
+    if (!c.current || !N) return;
+    const e = p.map((r, U) => {
+      const s = G(U, r.color);
+      return {
+        y: r.y,
+        x: r.x,
+        type: "box",
+        name: r.name,
+        hoverinfo: "none",
+        marker: {
+          color: s
+        },
+        line: {
+          color: s
+        },
+        fillcolor: typeof s == "string" && s.startsWith("#") && s.length === 7 ? `${s}40` : s,
+        // Add transparency for hex colors only
+        boxpoints: P ? r.boxpoints || "outliers" : !1,
+        jitter: r.jitter || 0.3,
+        pointpos: r.pointpos || J
+      };
+    }), t = {
+      width: g.current.width,
+      height: g.current.height,
+      title: B,
+      // Bottom margin reserves room for tick labels, the x-axis title, and the
+      // container-anchored bottom legend stacked beneath them.
+      margin: { l: 80, r: 40, b: 96, t: 80, pad: 0 },
+      paper_bgcolor: o.paperBg,
+      plot_bgcolor: o.plotBg,
+      font: {
+        family: u
+      },
+      dragmode: !1,
+      xaxis: {
+        title: {
+          text: M,
+          font: {
+            size: 16,
+            color: o.textSecondary,
+            family: u,
+            weight: 400
+          },
+          standoff: 15
+        },
+        gridcolor: o.gridColor,
+        range: w,
+        autorange: !w,
+        showgrid: !0,
+        // Reserve space for tick labels + the axis title so the bottom legend
+        // can't overlap them at small sizes (SW-2157).
+        automargin: !0,
+        ...k
+      },
+      yaxis: {
+        title: {
+          text: b,
+          font: {
+            size: 16,
+            color: o.textSecondary,
+            family: u,
+            weight: 400
+          },
+          standoff: 15
+        },
+        gridcolor: o.gridColor,
+        range: d,
+        autorange: !d,
+        tickmode: "array",
+        tickvals: O,
+        showgrid: !0,
+        automargin: !0,
+        ...k
+      },
+      legend: {
+        // Anchor to the bottom of the container (not the plot area) so the
+        // legend always clears the x-axis tick labels + title — a paper-relative
+        // fractional offset collapses into the ticks at small heights (SW-2157).
+        x: 0.5,
+        y: 0,
+        xanchor: "center",
+        yanchor: "bottom",
+        yref: "container",
+        orientation: "h",
+        font: {
+          size: 13,
+          color: o.legendColor,
+          family: u,
+          weight: 500,
+          lineheight: 18
+        }
+      },
+      showlegend: !0
+    }, a = {
+      // Sizing is driven from the measured container; disable Plotly's own
+      // window-resize responsiveness (it can't see container resizes).
+      responsive: !1,
+      displayModeBar: !1,
+      displaylogo: !1
+    };
+    let l = !1, f = null;
+    return D().then((r) => {
+      l || !c.current || (r.newPlot(c.current, e, t, a), _(c.current), f = c.current, v.current = !0, y.current = { ...g.current });
+    }), () => {
+      l = !0, f && (j().purge(f), v.current = !1);
+    };
+  }, [p, N, w, d, h, M, b, P, B, k, O, o, _]), T(() => {
+    const e = c.current;
+    !e || !v.current || i <= 0 || n <= 0 || y.current.width === i && y.current.height === n || (y.current = { width: i, height: n }, j().relayout(e, { width: i, height: n }).catch(() => {
+    }));
+  }, [i, n]), /* @__PURE__ */ W(
+    "div",
+    {
+      ref: F,
+      className: q("boxplot-container relative", H && "w-full", S && "h-full"),
+      children: [
+        /* @__PURE__ */ R("div", { ref: c, style: { width: "100%", height: "100%" } }),
+        Y
+      ]
+    }
+  );
+};
+export {
+  nt as BoxPlot
+};
+//# sourceMappingURL=BoxPlot.js.map

package/dist/components/charts/BoxPlot/BoxPlot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoxPlot.js","sources":["../../../../src/components/charts/BoxPlot/BoxPlot.tsx"],"sourcesContent":["import React, { useEffect, useRef, useMemo } from \"react\";\n\nimport { useChartTooltip } from \"../ChartTooltip\";\nimport { getLoadedPlotly, loadPlotly } from \"../plotly-loader\";\n\nimport { useElementSize } from \"@/hooks/use-element-size\";\nimport { CHART_FONT_FAMILY, usePlotlyTheme } from \"@/hooks/use-plotly-theme\";\nimport { cn } from \"@/lib/utils\";\nimport { seriesColor } from \"@/utils/colors\";\n\n/** Default point position offset from the box edge */\nconst DEFAULT_POINT_POSITION = -1.8;\n\ninterface BoxDataSeries {\n  y: number[];\n  name: string;\n  /** Optional color override (auto-assigned from CHART_COLORS if not provided) */\n  color?: string;\n  x?: string[] | number[];\n  boxpoints?: \"all\" | \"outliers\" | \"suspectedoutliers\" | false;\n  jitter?: number;\n  pointpos?: number;\n}\n\ninterface BoxPlotProps {\n  dataSeries: BoxDataSeries[];\n  /**\n   * Fixed width in pixels. When omitted, the chart fills its container and\n   * tracks the container's width via a `ResizeObserver`.\n   */\n  width?: number;\n  /**\n   * Fixed height in pixels. When omitted, the chart fills its container and\n   * tracks the container's height via a `ResizeObserver`.\n   */\n  height?: number;\n  xRange?: [number, number];\n  yRange?: [number, number];\n  xTitle?: string;\n  yTitle?: string;\n  title?: string;\n  showPoints?: boolean;\n}\n\nconst BoxPlot: React.FC<BoxPlotProps> = ({\n  dataSeries,\n  width,\n  height,\n  xRange,\n  yRange,\n  xTitle,\n  yTitle,\n  title = \"Box Plot\",\n  showPoints = false,\n}) => {\n  const plotRef = useRef<HTMLDivElement>(null);\n  const theme = usePlotlyTheme();\n  const { bindTooltip, tooltipElement } = useChartTooltip({ xLabel: xTitle, yLabel: yTitle });\n\n  // Omitted width/height → fill the container and track its measured size;\n  // explicit pixel values override. See AreaPlot for the reference pattern.\n  const [containerRef, measured] = useElementSize<HTMLDivElement>();\n  const resolvedWidth = width ?? measured.width;\n  const resolvedHeight = height ?? measured.height;\n  const hasSize = resolvedWidth > 0 && resolvedHeight > 0;\n  // Fill is per-dimension: omit width to fill the container width, omit height\n  // to fill its height (so e.g. a fixed width with a container-driven height works).\n  const fillWidth = width === undefined;\n  const fillHeight = height === undefined;\n  const sizeRef = useRef({ width: resolvedWidth, height: resolvedHeight });\n  sizeRef.current = { width: resolvedWidth, height: resolvedHeight };\n  const plotInitedRef = useRef(false);\n  // Size last applied to the plot, so the resize effect can skip a redundant\n  // relayout right after newPlot already drew at that size.\n  const appliedSizeRef = useRef({ width: 0, height: 0 });\n\n  const { yMin, yMax } = useMemo(() => {\n    let minY = Number.MAX_VALUE;\n    let maxY = Number.MIN_VALUE;\n\n    dataSeries.forEach((series) => {\n      series.y.forEach((y) => {\n        minY = Math.min(minY, y);\n        maxY = Math.max(maxY, y);\n      });\n    });\n\n    const yPadding = (maxY - minY) * 0.1;\n\n    return {\n      yMin: minY - yPadding,\n      yMax: maxY + yPadding,\n    };\n  }, [dataSeries]);\n\n  const effectiveYRange = useMemo(\n    () => yRange || [yMin, yMax],\n    [yRange, yMin, yMax],\n  );\n\n  const yTicks = useMemo(() => {\n    const range = effectiveYRange[1] - effectiveYRange[0];\n    let step = Math.pow(10, Math.floor(Math.log10(range)));\n\n    if (range / step > 10) step = step * 2;\n    if (range / step < 4) step = step / 2;\n\n    const ticks = [];\n    let current = Math.ceil(effectiveYRange[0] / step) * step;\n    while (current <= effectiveYRange[1]) {\n      ticks.push(current);\n      current += step;\n    }\n    return ticks;\n  }, [effectiveYRange]);\n\n  const tickOptions = useMemo(\n    () => ({\n      tickcolor: theme.tickColor,\n      ticklen: 12,\n      tickwidth: 1,\n      ticks: \"outside\" as const,\n      tickfont: {\n        size: 16,\n        color: theme.textColor,\n        family: CHART_FONT_FAMILY,\n        weight: 400,\n      },\n      linecolor: theme.lineColor,\n      linewidth: 1,\n      position: 0,\n      zeroline: false,\n    }),\n    [theme],\n  );\n\n  const titleOptions = useMemo(\n    () => ({\n      text: title,\n      x: 0.5,\n      y: 0.95,\n      xanchor: \"center\" as const,\n      yanchor: \"top\" as const,\n      font: {\n        size: 32,\n        weight: 600,\n        family: CHART_FONT_FAMILY,\n        color: theme.textColor,\n        lineheight: 1.2,\n        standoff: 30,\n      },\n    }),\n    [title, theme],\n  );\n\n  useEffect(() => {\n    if (!plotRef.current || !hasSize) return;\n\n    const data = dataSeries.map((series, index) => {\n      const color = seriesColor(index, series.color);\n      return {\n        y: series.y,\n        x: series.x,\n        type: \"box\" as const,\n        name: series.name,\n        hoverinfo: \"none\" as const,\n        marker: {\n          color,\n        },\n        line: {\n          color,\n        },\n        fillcolor:\n          typeof color === \"string\" && color.startsWith(\"#\") && color.length === 7\n            ? `${color}40`\n            : color, // Add transparency for hex colors only\n        boxpoints: showPoints\n          ? series.boxpoints || \"outliers\"\n          : (false as const),\n        jitter: series.jitter || 0.3,\n        pointpos: series.pointpos || DEFAULT_POINT_POSITION,\n      };\n    });\n\n    const layout = {\n      width: sizeRef.current.width,\n      height: sizeRef.current.height,\n      title: titleOptions,\n      // Bottom margin reserves room for tick labels, the x-axis title, and the\n      // container-anchored bottom legend stacked beneath them.\n      margin: { l: 80, r: 40, b: 96, t: 80, pad: 0 },\n      paper_bgcolor: theme.paperBg,\n      plot_bgcolor: theme.plotBg,\n      font: {\n        family: CHART_FONT_FAMILY,\n      },\n      dragmode: false as const,\n      xaxis: {\n        title: {\n          text: xTitle,\n          font: {\n            size: 16,\n            color: theme.textSecondary,\n            family: CHART_FONT_FAMILY,\n            weight: 400,\n          },\n          standoff: 15,\n        },\n        gridcolor: theme.gridColor,\n        range: xRange,\n        autorange: !xRange,\n        showgrid: true,\n        // Reserve space for tick labels + the axis title so the bottom legend\n        // can't overlap them at small sizes (SW-2157).\n        automargin: true,\n        ...tickOptions,\n      },\n      yaxis: {\n        title: {\n          text: yTitle,\n          font: {\n            size: 16,\n            color: theme.textSecondary,\n            family: CHART_FONT_FAMILY,\n            weight: 400,\n          },\n          standoff: 15,\n        },\n        gridcolor: theme.gridColor,\n        range: yRange,\n        autorange: !yRange,\n        tickmode: \"array\" as const,\n        tickvals: yTicks,\n        showgrid: true,\n        automargin: true,\n        ...tickOptions,\n      },\n      legend: {\n        // Anchor to the bottom of the container (not the plot area) so the\n        // legend always clears the x-axis tick labels + title — a paper-relative\n        // fractional offset collapses into the ticks at small heights (SW-2157).\n        x: 0.5,\n        y: 0,\n        xanchor: \"center\" as const,\n        yanchor: \"bottom\" as const,\n        yref: \"container\" as const,\n        orientation: \"h\" as const,\n        font: {\n          size: 13,\n          color: theme.legendColor,\n          family: CHART_FONT_FAMILY,\n          weight: 500,\n          lineheight: 18,\n        },\n      },\n      showlegend: true,\n    };\n\n    const config = {\n      // Sizing is driven from the measured container; disable Plotly's own\n      // window-resize responsiveness (it can't see container resizes).\n      responsive: false,\n      displayModeBar: false,\n      displaylogo: false,\n    };\n\n    // Plotly is loaded lazily so it stays out of the consumer's main chunk\n    // (SW-2007); the draw is skipped if the effect re-runs or unmounts first.\n    let cancelled = false;\n    let plotElement: HTMLDivElement | null = null;\n    void loadPlotly().then((plotly) => {\n      if (cancelled || !plotRef.current) return;\n      plotly.newPlot(plotRef.current, data, layout, config);\n      bindTooltip(plotRef.current);\n\n      // Capture ref value for cleanup\n      plotElement = plotRef.current;\n      plotInitedRef.current = true;\n      appliedSizeRef.current = { ...sizeRef.current };\n    });\n\n    return () => {\n      cancelled = true;\n      if (plotElement) {\n        getLoadedPlotly().purge(plotElement);\n        plotInitedRef.current = false;\n      }\n    };\n  }, [dataSeries, hasSize, xRange, yRange, effectiveYRange, xTitle, yTitle, showPoints, titleOptions, tickOptions, yTicks, theme, bindTooltip]);\n\n  // Resize in place when the measured/overridden size changes — cheaper than\n  // recreating the plot, and it preserves tooltip/event bindings.\n  useEffect(() => {\n    const plotElement = plotRef.current;\n    if (!plotElement || !plotInitedRef.current || resolvedWidth <= 0 || resolvedHeight <= 0) {\n      return;\n    }\n    // newPlot already drew at the current size; skip the redundant relayout\n    // (it would queue an automargin redraw that can reject if we unmount first).\n    if (\n      appliedSizeRef.current.width === resolvedWidth &&\n      appliedSizeRef.current.height === resolvedHeight\n    ) {\n      return;\n    }\n    appliedSizeRef.current = { width: resolvedWidth, height: resolvedHeight };\n    // Swallow rejections from a relayout that races an unmount/purge.\n    // plotInitedRef guarantees Plotly finished loading, so sync access is safe.\n    void getLoadedPlotly()\n      .relayout(plotElement, { width: resolvedWidth, height: resolvedHeight })\n      .catch(() => {});\n  }, [resolvedWidth, resolvedHeight]);\n\n  return (\n    <div\n      ref={containerRef}\n      className={cn(\"boxplot-container relative\", fillWidth && \"w-full\", fillHeight && \"h-full\")}\n    >\n      <div ref={plotRef} style={{ width: \"100%\", height: \"100%\" }} />\n      {tooltipElement}\n    </div>\n  );\n};\n\nexport { BoxPlot };\nexport type { BoxDataSeries, BoxPlotProps };\n"],"names":["DEFAULT_POINT_POSITION","BoxPlot","dataSeries","width","height","xRange","yRange","xTitle","yTitle","title","showPoints","plotRef","useRef","theme","usePlotlyTheme","bindTooltip","tooltipElement","useChartTooltip","containerRef","measured","useElementSize","resolvedWidth","resolvedHeight","hasSize","fillWidth","fillHeight","sizeRef","plotInitedRef","appliedSizeRef","yMin","yMax","useMemo","minY","maxY","series","y","yPadding","effectiveYRange","yTicks","range","step","ticks","current","tickOptions","CHART_FONT_FAMILY","titleOptions","useEffect","data","index","color","seriesColor","layout","config","cancelled","plotElement","loadPlotly","plotly","getLoadedPlotly","jsxs","cn","jsx"],"mappings":"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"}

package/dist/components/charts/BoxPlot/index.d.ts

@@ -0,0 +1,2 @@
+export { BoxPlot } from './BoxPlot';
+export type { BoxDataSeries, BoxPlotProps } from './BoxPlot';

package/dist/components/charts/ChartTooltip/ChartTooltip.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const m=require("react/jsx-runtime"),j=require("plotly.js-dist"),u=require("react"),O=require("react-dom"),A=require("./lines.cjs"),L=require("../../../lib/utils.cjs"),X=20,q=150,H=200,y=8,W=10,I={top:"bottom",bottom:"top",left:"right",right:"left"},z={top:{wrapper:"-translate-x-1/2 -translate-y-[calc(100%+10px)]",arrow:"-bottom-1 left-1/2 -translate-x-1/2"},bottom:{wrapper:"-translate-x-1/2 translate-y-[10px]",arrow:"-top-1 left-1/2 -translate-x-1/2"},left:{wrapper:"-translate-y-1/2 -translate-x-[calc(100%+10px)]",arrow:"-right-1 top-1/2 -translate-y-1/2"},right:{wrapper:"-translate-y-1/2 translate-x-[10px]",arrow:"-left-1 top-1/2 -translate-y-1/2"}},k=(t,o,n,r)=>{const e=y,s=W,i={top:o.top-s-r>=e,bottom:o.top+s+r<=window.innerHeight-e,left:o.left-s-n>=e,right:o.left+s+n<=window.innerWidth-e};return!i[t]&&i[I[t]]?I[t]:t};function N({anchor:t,bubbleRef:o}){const n=u.useRef(null),r=t?.side??"top",[e,s]=u.useState(r),i=u.useCallback(l=>{n.current=l,typeof o=="function"?o(l):o&&(o.current=l)},[o]);if(u.useLayoutEffect(()=>{const l=n.current;if(!t||!l)return;const c=k(r,t,l.offsetWidth,l.offsetHeight);s(x=>x===c?x:c)},[t,r]),!t)return null;const p=z[e];return O.createPortal(m.jsx("div",{"data-slot":"chart-tooltip-anchor",className:"pointer-events-none fixed z-50",style:{left:t.left,top:t.top},children:m.jsx("div",{ref:i,className:L.cn("w-max",p.wrapper),children:m.jsxs("div",{role:"tooltip","data-slot":"tooltip-content","data-side":e,className:L.cn("relative w-fit max-w-xs rounded-md bg-foreground px-3 py-1.5 text-xs text-background",t.closing?"animate-out fade-out zoom-out-95 fill-mode-forwards":"animate-in fade-in-0 zoom-in-95"),children:[t.lines.map((l,c)=>m.jsx("div",{children:l},`${c}-${l}`)),m.jsx("span",{"aria-hidden":!0,className:L.cn("absolute size-2.5 rotate-45 rounded-[2px] bg-foreground",p.arrow)})]})})}),document.body)}const G=(t,o,n,r)=>{const e=n/2,s=Math.min(Math.max(t,e+y),window.innerWidth-e-y),i=Math.min(Math.max(o,r+10+y),window.innerHeight-y);return{left:s,top:i}};function Y(t={}){const[o,n]=u.useState(null),r=u.useRef(void 0),e=u.useRef(t);e.current=t;const s=u.useRef(null),i=u.useRef(null),p=u.useRef(null);return{bindTooltip:u.useCallback(c=>{if(!c)return;p.current?.(),p.current=null,n(null),i.current=null,j.relayout(c,{hoverdistance:e.current.hoverDistance??X});const x=c,M=(a,f,w)=>{const T=s.current,{left:v,top:R}=G(f,w,T?.offsetWidth??0,T?.offsetHeight??0);n({left:v,top:R,lines:a,side:e.current.side})};x.on("plotly_hover",a=>{const f=a.points??[],{getLines:w,xLabel:T,yLabel:v,followCursor:R}=e.current,g=w?w(f):A.chartTooltipLines(f,{xLabel:T,yLabel:v});if(g.length===0)return;clearTimeout(r.current);const h=a.event;if(R){i.current=g,M(g,h?.clientX??0,h?.clientY??0);return}const b=f[0],d=b?.bbox;let E=0,S=0;if(d){const C=c.getBoundingClientRect();E=C.left+(d.x0+d.x1)/2;const _=b?.yaxis;d.y0===d.y1&&typeof b?.y=="number"&&typeof _?.l2p=="function"&&typeof _._offset=="number"?S=C.top+_._offset+_.l2p(b.y):S=C.top+Math.min(d.y0,d.y1)}else h&&(E=h.clientX,S=h.clientY);n({left:E,top:S,lines:g,side:e.current.side})});const P=a=>{if(!e.current.followCursor)return;const f=i.current;f&&M(f,a.clientX,a.clientY)};c.addEventListener("mousemove",P),p.current=()=>c.removeEventListener("mousemove",P),x.on("plotly_unhover",()=>{clearTimeout(r.current),i.current=null,r.current=setTimeout(()=>{n(a=>a&&{...a,closing:!0}),r.current=setTimeout(()=>n(null),H)},q)})},[]),tooltipElement:m.jsx(N,{anchor:o,bubbleRef:s})}}exports.chartTooltipLines=A.chartTooltipLines;exports.ChartTooltip=N;exports.useChartTooltip=Y;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const m=require("react/jsx-runtime"),u=require("react"),j=require("react-dom"),O=require("../plotly-loader.cjs"),A=require("./lines.cjs"),C=require("../../../lib/utils.cjs"),X=20,q=150,H=200,y=8,W=10,I={top:"bottom",bottom:"top",left:"right",right:"left"},z={top:{wrapper:"-translate-x-1/2 -translate-y-[calc(100%+10px)]",arrow:"-bottom-1 left-1/2 -translate-x-1/2"},bottom:{wrapper:"-translate-x-1/2 translate-y-[10px]",arrow:"-top-1 left-1/2 -translate-x-1/2"},left:{wrapper:"-translate-y-1/2 -translate-x-[calc(100%+10px)]",arrow:"-right-1 top-1/2 -translate-y-1/2"},right:{wrapper:"-translate-y-1/2 translate-x-[10px]",arrow:"-left-1 top-1/2 -translate-y-1/2"}},k=(t,o,n,r)=>{const e=y,s=W,i={top:o.top-s-r>=e,bottom:o.top+s+r<=window.innerHeight-e,left:o.left-s-n>=e,right:o.left+s+n<=window.innerWidth-e};return!i[t]&&i[I[t]]?I[t]:t};function N({anchor:t,bubbleRef:o}){const n=u.useRef(null),r=t?.side??"top",[e,s]=u.useState(r),i=u.useCallback(l=>{n.current=l,typeof o=="function"?o(l):o&&(o.current=l)},[o]);if(u.useLayoutEffect(()=>{const l=n.current;if(!t||!l)return;const c=k(r,t,l.offsetWidth,l.offsetHeight);s(x=>x===c?x:c)},[t,r]),!t)return null;const p=z[e];return j.createPortal(m.jsx("div",{"data-slot":"chart-tooltip-anchor",className:"pointer-events-none fixed z-50",style:{left:t.left,top:t.top},children:m.jsx("div",{ref:i,className:C.cn("w-max",p.wrapper),children:m.jsxs("div",{role:"tooltip","data-slot":"tooltip-content","data-side":e,className:C.cn("relative w-fit max-w-xs rounded-md bg-foreground px-3 py-1.5 text-xs text-background",t.closing?"animate-out fade-out zoom-out-95 fill-mode-forwards":"animate-in fade-in-0 zoom-in-95"),children:[t.lines.map((l,c)=>m.jsx("div",{children:l},`${c}-${l}`)),m.jsx("span",{"aria-hidden":!0,className:C.cn("absolute size-2.5 rotate-45 rounded-[2px] bg-foreground",p.arrow)})]})})}),document.body)}const G=(t,o,n,r)=>{const e=n/2,s=Math.min(Math.max(t,e+y),window.innerWidth-e-y),i=Math.min(Math.max(o,r+10+y),window.innerHeight-y);return{left:s,top:i}};function Y(t={}){const[o,n]=u.useState(null),r=u.useRef(void 0),e=u.useRef(t);e.current=t;const s=u.useRef(null),i=u.useRef(null),p=u.useRef(null);return{bindTooltip:u.useCallback(c=>{if(!c)return;p.current?.(),p.current=null,n(null),i.current=null,O.getLoadedPlotly().relayout(c,{hoverdistance:e.current.hoverDistance??X});const x=c,M=(a,f,w)=>{const T=s.current,{left:v,top:L}=G(f,w,T?.offsetWidth??0,T?.offsetHeight??0);n({left:v,top:L,lines:a,side:e.current.side})};x.on("plotly_hover",a=>{const f=a.points??[],{getLines:w,xLabel:T,yLabel:v,followCursor:L}=e.current,g=w?w(f):A.chartTooltipLines(f,{xLabel:T,yLabel:v});if(g.length===0)return;clearTimeout(r.current);const h=a.event;if(L){i.current=g,M(g,h?.clientX??0,h?.clientY??0);return}const b=f[0],d=b?.bbox;let R=0,S=0;if(d){const E=c.getBoundingClientRect();R=E.left+(d.x0+d.x1)/2;const _=b?.yaxis;d.y0===d.y1&&typeof b?.y=="number"&&typeof _?.l2p=="function"&&typeof _._offset=="number"?S=E.top+_._offset+_.l2p(b.y):S=E.top+Math.min(d.y0,d.y1)}else h&&(R=h.clientX,S=h.clientY);n({left:R,top:S,lines:g,side:e.current.side})});const P=a=>{if(!e.current.followCursor)return;const f=i.current;f&&M(f,a.clientX,a.clientY)};c.addEventListener("mousemove",P),p.current=()=>c.removeEventListener("mousemove",P),x.on("plotly_unhover",()=>{clearTimeout(r.current),i.current=null,r.current=setTimeout(()=>{n(a=>a&&{...a,closing:!0}),r.current=setTimeout(()=>n(null),H)},q)})},[]),tooltipElement:m.jsx(N,{anchor:o,bubbleRef:s})}}exports.chartTooltipLines=A.chartTooltipLines;exports.ChartTooltip=N;exports.useChartTooltip=Y;
 //# sourceMappingURL=ChartTooltip.cjs.map

package/dist/components/charts/ChartTooltip/ChartTooltip.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ChartTooltip.cjs","sources":["../../../../src/components/charts/ChartTooltip/ChartTooltip.tsx"],"sourcesContent":["import Plotly from \"plotly.js-dist\";\nimport { useCallback, useLayoutEffect, useRef, useState } from \"react\";\nimport { createPortal } from \"react-dom\";\n\nimport { chartTooltipLines } from \"./lines\";\n\nimport type { ChartTooltipHoverPoint } from \"./lines\";\nimport type { Ref } from \"react\";\n\nimport { cn } from \"@/lib/utils\";\n\nexport { chartTooltipLines } from \"./lines\";\nexport type { ChartTooltipHoverPoint } from \"./lines\";\n\n/**\n * How far (px) from a point Plotly still reports a hover. Matches Plotly's\n * default — a larger radius makes tooltips snap to neighbors in dense plots\n */\nconst HOVER_DISTANCE_PX = 20;\n/** Grace period before hiding, so the tooltip survives gaps between points */\nconst HIDE_GRACE_MS = 150;\n/** How long the exit animation plays before the tooltip unmounts */\nconst EXIT_ANIMATION_MS = 200;\n\n/** Which edge of the point the tooltip is placed against (matches Radix). */\nexport type ChartTooltipSide = \"top\" | \"bottom\" | \"left\" | \"right\";\n\nexport interface ChartTooltipAnchor {\n  left: number;\n  top: number;\n  lines: string[];\n  /** Preferred placement side; auto-flips to the opposite when it won't fit */\n  side?: ChartTooltipSide;\n  /** Plays the exit animation before the tooltip unmounts */\n  closing?: boolean;\n}\n\n/** Keep an anchor point this far from the viewport edges when clamping */\nconst VIEWPORT_PADDING_PX = 8;\n/** Gap (px) between the anchor point and the bubble on every side */\nconst TOOLTIP_GAP_PX = 10;\n\n/** The opposite side to flip to when the preferred one has no room */\nconst OPPOSITE_SIDE: Record<ChartTooltipSide, ChartTooltipSide> = {\n  top: \"bottom\",\n  bottom: \"top\",\n  left: \"right\",\n  right: \"left\",\n};\n\n/**\n * Per-side transforms. The wrapper carries positioning transforms (kept off\n * the bubble so they don't clobber the entry/exit animation), and the arrow\n * sits on the edge facing the point.\n */\nconst SIDE_CLASSES: Record<ChartTooltipSide, { wrapper: string; arrow: string }> = {\n  top: {\n    wrapper: \"-translate-x-1/2 -translate-y-[calc(100%+10px)]\",\n    arrow: \"-bottom-1 left-1/2 -translate-x-1/2\",\n  },\n  bottom: {\n    wrapper: \"-translate-x-1/2 translate-y-[10px]\",\n    arrow: \"-top-1 left-1/2 -translate-x-1/2\",\n  },\n  left: {\n    wrapper: \"-translate-y-1/2 -translate-x-[calc(100%+10px)]\",\n    arrow: \"-right-1 top-1/2 -translate-y-1/2\",\n  },\n  right: {\n    wrapper: \"-translate-y-1/2 translate-x-[10px]\",\n    arrow: \"-left-1 top-1/2 -translate-y-1/2\",\n  },\n};\n\ninterface ChartTooltipEmitter {\n  on: (event: string, handler: (data: ChartTooltipHoverEvent) => void) => void;\n}\n\ninterface ChartTooltipHoverEvent {\n  points?: ChartTooltipHoverPoint[];\n  event?: MouseEvent;\n}\n\nexport interface ChartTooltipProps {\n  /** Anchor position (viewport coordinates) and content lines */\n  anchor: ChartTooltipAnchor | null;\n  /** Ref to the bubble node, used by cursor-following charts to clamp it on-screen */\n  bubbleRef?: Ref<HTMLDivElement>;\n}\n\n/**\n * Resolve the side the bubble actually renders on: keep the preferred side\n * when it fits in the viewport, otherwise flip to the opposite side.\n */\nconst resolveSide = (\n  preferred: ChartTooltipSide,\n  anchor: { left: number; top: number },\n  width: number,\n  height: number,\n): ChartTooltipSide => {\n  const pad = VIEWPORT_PADDING_PX;\n  const reach = TOOLTIP_GAP_PX;\n  const fits: Record<ChartTooltipSide, boolean> = {\n    top: anchor.top - reach - height >= pad,\n    bottom: anchor.top + reach + height <= window.innerHeight - pad,\n    left: anchor.left - reach - width >= pad,\n    right: anchor.left + reach + width <= window.innerWidth - pad,\n  };\n  // Flip only when the preferred side overflows and the opposite has room\n  if (!fits[preferred] && fits[OPPOSITE_SIDE[preferred]]) {\n    return OPPOSITE_SIDE[preferred];\n  }\n  return preferred;\n};\n\n/**\n * The design-system tooltip anchored at a chart position; drive it with\n * `useChartTooltip`.\n *\n * Renders the same visual as the ui `TooltipContent` (bubble + arrow) but\n * positions it directly from the anchor coordinates — Radix's popper\n * repositions asynchronously and mis-measures animated content, which made\n * tooltips drift on charts. Placement supports all four sides with\n * Radix-style collision flipping.\n */\nexport function ChartTooltip({ anchor, bubbleRef }: ChartTooltipProps) {\n  const wrapperRef = useRef<HTMLDivElement>(null);\n  const preferredSide = anchor?.side ?? \"top\";\n  const [resolvedSide, setResolvedSide] = useState<ChartTooltipSide>(preferredSide);\n\n  // Forward the wrapper node to both the internal measure ref and the\n  // optional external ref (used by cursor-following charts to clamp it)\n  const setBubbleNode = useCallback(\n    (node: HTMLDivElement | null) => {\n      wrapperRef.current = node;\n      if (typeof bubbleRef === \"function\") bubbleRef(node);\n      else if (bubbleRef) {\n        (bubbleRef as { current: HTMLDivElement | null }).current = node;\n      }\n    },\n    [bubbleRef],\n  );\n\n  // Measure before paint and flip to the opposite side if needed\n  useLayoutEffect(() => {\n    const node = wrapperRef.current;\n    if (!anchor || !node) return;\n    const next = resolveSide(\n      preferredSide,\n      anchor,\n      node.offsetWidth,\n      node.offsetHeight,\n    );\n    setResolvedSide((current) => (current === next ? current : next));\n  }, [anchor, preferredSide]);\n\n  if (!anchor) return null;\n  const side = SIDE_CLASSES[resolvedSide];\n  return createPortal(\n    <div\n      data-slot=\"chart-tooltip-anchor\"\n      className=\"pointer-events-none fixed z-50\"\n      style={{ left: anchor.left, top: anchor.top }}\n    >\n      {/* Positioning transforms live on this node; animations (which also\n          drive `transform`) live on the bubble below so they can't clobber\n          each other */}\n      <div ref={setBubbleNode} className={cn(\"w-max\", side.wrapper)}>\n        <div\n          role=\"tooltip\"\n          data-slot=\"tooltip-content\"\n          data-side={resolvedSide}\n          className={cn(\n            \"relative w-fit max-w-xs rounded-md bg-foreground px-3 py-1.5 text-xs text-background\",\n            anchor.closing\n              ? \"animate-out fade-out zoom-out-95 fill-mode-forwards\"\n              : \"animate-in fade-in-0 zoom-in-95\",\n          )}\n        >\n          {anchor.lines.map((line, index) => (\n            <div key={`${index}-${line}`}>{line}</div>\n          ))}\n          <span\n            aria-hidden\n            className={cn(\n              \"absolute size-2.5 rotate-45 rounded-[2px] bg-foreground\",\n              side.arrow,\n            )}\n          />\n        </div>\n      </div>\n    </div>,\n    document.body,\n  );\n}\n\nexport interface UseChartTooltipOptions {\n  /** Axis label used for the default x line (falls back to \"X\") */\n  xLabel?: string;\n  /** Axis label used for the default y line (falls back to \"Y\") */\n  yLabel?: string;\n  /** Override the default line builder entirely */\n  getLines?: (points: ChartTooltipHoverPoint[]) => string[];\n  /**\n   * Track the cursor instead of anchoring to the hovered point's bounds, and\n   * keep the tooltip clamped inside the viewport. Use for traces with large\n   * hover targets (e.g. pie slices) where a fixed anchor feels disconnected.\n   */\n  followCursor?: boolean;\n  /**\n   * Override Plotly's hover hit radius (px). A larger radius makes big markers\n   * (e.g. heatmap circles) hoverable across their whole face.\n   */\n  hoverDistance?: number;\n  /**\n   * Preferred side to place the tooltip on relative to the point. Auto-flips to\n   * the opposite side when there isn't room (Radix-style). Defaults to \"top\".\n   */\n  side?: ChartTooltipSide;\n}\n\n/** Clamp an anchor point so a bubble of `width`×`height` stays on-screen */\nconst clampAnchor = (\n  left: number,\n  top: number,\n  width: number,\n  height: number,\n): { left: number; top: number } => {\n  const halfWidth = width / 2;\n  const clampedLeft = Math.min(\n    Math.max(left, halfWidth + VIEWPORT_PADDING_PX),\n    window.innerWidth - halfWidth - VIEWPORT_PADDING_PX,\n  );\n  // The bubble sits above the anchor; keep its top edge inside the viewport\n  const clampedTop = Math.min(\n    Math.max(top, height + 10 + VIEWPORT_PADDING_PX),\n    window.innerHeight - VIEWPORT_PADDING_PX,\n  );\n  return { left: clampedLeft, top: clampedTop };\n};\n\n/**\n * Drives the design-system tooltip from Plotly hover events.\n *\n * ```tsx\n * const { bindTooltip, tooltipElement } = useChartTooltip({ xLabel, yLabel });\n * // after Plotly.newPlot(...): set trace hoverinfo to \"none\", then\n * bindTooltip(plotRef.current);\n * // anywhere in the chart markup:\n * {tooltipElement}\n * ```\n */\nexport function useChartTooltip(options: UseChartTooltipOptions = {}) {\n  const [anchor, setAnchor] = useState<ChartTooltipAnchor | null>(null);\n  const hideTimerRef = useRef<ReturnType<typeof setTimeout>>(undefined);\n  const optionsRef = useRef(options);\n  optionsRef.current = options;\n  // Measured bubble node, used to clamp the cursor-following tooltip on-screen\n  const bubbleRef = useRef<HTMLDivElement>(null);\n  // Active lines while a cursor-following tooltip is shown; null when hidden\n  const cursorLinesRef = useRef<string[] | null>(null);\n  // Removes the mousemove listener registered by the previous bindTooltip call\n  const detachMouseMoveRef = useRef<(() => void) | null>(null);\n\n  const bindTooltip = useCallback((plotDiv: HTMLElement | null) => {\n    if (!plotDiv) return;\n    // The chart effect can re-run (size/theme/props changes) and call this\n    // again on the same node; drop the prior mousemove listener so they don't\n    // accumulate. (Plotly's own hover/unhover handlers are cleared by newPlot.)\n    detachMouseMoveRef.current?.();\n    detachMouseMoveRef.current = null;\n    setAnchor(null);\n    cursorLinesRef.current = null;\n\n    // A larger hover radius makes the tooltip easier to acquire and keep\n    void Plotly.relayout(plotDiv, {\n      hoverdistance: optionsRef.current.hoverDistance ?? HOVER_DISTANCE_PX,\n    });\n\n    const emitter = plotDiv as unknown as ChartTooltipEmitter;\n\n    // Place the cursor-following tooltip at the (clamped) cursor position\n    const positionAtCursor = (lines: string[], clientX: number, clientY: number) => {\n      const bubble = bubbleRef.current;\n      const { left, top } = clampAnchor(\n        clientX,\n        clientY,\n        bubble?.offsetWidth ?? 0,\n        bubble?.offsetHeight ?? 0,\n      );\n      setAnchor({ left, top, lines, side: optionsRef.current.side });\n    };\n\n    emitter.on(\"plotly_hover\", (eventData) => {\n      const points = eventData.points ?? [];\n      const { getLines, xLabel, yLabel, followCursor } = optionsRef.current;\n      const lines = getLines\n        ? getLines(points)\n        : chartTooltipLines(points, { xLabel, yLabel });\n      if (lines.length === 0) return;\n\n      clearTimeout(hideTimerRef.current);\n\n      const mouse = eventData.event;\n      if (followCursor) {\n        cursorLinesRef.current = lines;\n        positionAtCursor(lines, mouse?.clientX ?? 0, mouse?.clientY ?? 0);\n        return;\n      }\n\n      // Anchor to the hovered point's bounds (in plot-div pixels) when\n      // Plotly provides them; fall back to the mouse position. The anchor\n      // is position:fixed, so viewport coordinates are used directly.\n      const point = points[0];\n      const bbox = point?.bbox;\n      let left = 0;\n      let top = 0;\n      if (bbox) {\n        const rect = plotDiv.getBoundingClientRect();\n        left = rect.left + (bbox.x0 + bbox.x1) / 2;\n        // Bars report a zero-height bbox that sits below their visual top;\n        // anchor to the bar's true top via the axis projection instead.\n        const yaxis = point?.yaxis;\n        if (\n          bbox.y0 === bbox.y1 &&\n          typeof point?.y === \"number\" &&\n          typeof yaxis?.l2p === \"function\" &&\n          typeof yaxis._offset === \"number\"\n        ) {\n          top = rect.top + yaxis._offset + yaxis.l2p(point.y);\n        } else {\n          top = rect.top + Math.min(bbox.y0, bbox.y1);\n        }\n      } else if (mouse) {\n        left = mouse.clientX;\n        top = mouse.clientY;\n      }\n      setAnchor({ left, top, lines, side: optionsRef.current.side });\n    });\n\n    // While following the cursor, keep the tooltip glued to the pointer even\n    // when Plotly does not re-fire hover within the same point (e.g. a slice)\n    const handleMouseMove = (event: MouseEvent) => {\n      if (!optionsRef.current.followCursor) return;\n      const lines = cursorLinesRef.current;\n      if (!lines) return;\n      positionAtCursor(lines, event.clientX, event.clientY);\n    };\n    plotDiv.addEventListener(\"mousemove\", handleMouseMove);\n    detachMouseMoveRef.current = () =>\n      plotDiv.removeEventListener(\"mousemove\", handleMouseMove);\n\n    emitter.on(\"plotly_unhover\", () => {\n      clearTimeout(hideTimerRef.current);\n      cursorLinesRef.current = null;\n      // After the grace period, play the exit animation, then unmount\n      hideTimerRef.current = setTimeout(() => {\n        setAnchor((previous) =>\n          previous ? { ...previous, closing: true } : previous,\n        );\n        hideTimerRef.current = setTimeout(() => setAnchor(null), EXIT_ANIMATION_MS);\n      }, HIDE_GRACE_MS);\n    });\n  }, []);\n\n  return {\n    bindTooltip,\n    tooltipElement: <ChartTooltip anchor={anchor} bubbleRef={bubbleRef} />,\n  };\n}\n"],"names":["HOVER_DISTANCE_PX","HIDE_GRACE_MS","EXIT_ANIMATION_MS","VIEWPORT_PADDING_PX","TOOLTIP_GAP_PX","OPPOSITE_SIDE","SIDE_CLASSES","resolveSide","preferred","anchor","width","height","pad","reach","fits","ChartTooltip","bubbleRef","wrapperRef","useRef","preferredSide","resolvedSide","setResolvedSide","useState","setBubbleNode","useCallback","node","useLayoutEffect","next","current","side","createPortal","jsx","cn","jsxs","line","index","clampAnchor","left","top","halfWidth","clampedLeft","clampedTop","useChartTooltip","options","setAnchor","hideTimerRef","optionsRef","cursorLinesRef","detachMouseMoveRef","plotDiv","Plotly","emitter","positionAtCursor","lines","clientX","clientY","bubble","eventData","points","getLines","xLabel","yLabel","followCursor","chartTooltipLines","mouse","point","bbox","rect","yaxis","handleMouseMove","event","previous"],"mappings":"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"}
+{"version":3,"file":"ChartTooltip.cjs","sources":["../../../../src/components/charts/ChartTooltip/ChartTooltip.tsx"],"sourcesContent":["import { useCallback, useLayoutEffect, useRef, useState } from \"react\";\nimport { createPortal } from \"react-dom\";\n\nimport { getLoadedPlotly } from \"../plotly-loader\";\n\nimport { chartTooltipLines } from \"./lines\";\n\nimport type { ChartTooltipHoverPoint } from \"./lines\";\nimport type { Ref } from \"react\";\n\nimport { cn } from \"@/lib/utils\";\n\nexport { chartTooltipLines } from \"./lines\";\nexport type { ChartTooltipHoverPoint } from \"./lines\";\n\n/**\n * How far (px) from a point Plotly still reports a hover. Matches Plotly's\n * default — a larger radius makes tooltips snap to neighbors in dense plots\n */\nconst HOVER_DISTANCE_PX = 20;\n/** Grace period before hiding, so the tooltip survives gaps between points */\nconst HIDE_GRACE_MS = 150;\n/** How long the exit animation plays before the tooltip unmounts */\nconst EXIT_ANIMATION_MS = 200;\n\n/** Which edge of the point the tooltip is placed against (matches Radix). */\nexport type ChartTooltipSide = \"top\" | \"bottom\" | \"left\" | \"right\";\n\nexport interface ChartTooltipAnchor {\n  left: number;\n  top: number;\n  lines: string[];\n  /** Preferred placement side; auto-flips to the opposite when it won't fit */\n  side?: ChartTooltipSide;\n  /** Plays the exit animation before the tooltip unmounts */\n  closing?: boolean;\n}\n\n/** Keep an anchor point this far from the viewport edges when clamping */\nconst VIEWPORT_PADDING_PX = 8;\n/** Gap (px) between the anchor point and the bubble on every side */\nconst TOOLTIP_GAP_PX = 10;\n\n/** The opposite side to flip to when the preferred one has no room */\nconst OPPOSITE_SIDE: Record<ChartTooltipSide, ChartTooltipSide> = {\n  top: \"bottom\",\n  bottom: \"top\",\n  left: \"right\",\n  right: \"left\",\n};\n\n/**\n * Per-side transforms. The wrapper carries positioning transforms (kept off\n * the bubble so they don't clobber the entry/exit animation), and the arrow\n * sits on the edge facing the point.\n */\nconst SIDE_CLASSES: Record<ChartTooltipSide, { wrapper: string; arrow: string }> = {\n  top: {\n    wrapper: \"-translate-x-1/2 -translate-y-[calc(100%+10px)]\",\n    arrow: \"-bottom-1 left-1/2 -translate-x-1/2\",\n  },\n  bottom: {\n    wrapper: \"-translate-x-1/2 translate-y-[10px]\",\n    arrow: \"-top-1 left-1/2 -translate-x-1/2\",\n  },\n  left: {\n    wrapper: \"-translate-y-1/2 -translate-x-[calc(100%+10px)]\",\n    arrow: \"-right-1 top-1/2 -translate-y-1/2\",\n  },\n  right: {\n    wrapper: \"-translate-y-1/2 translate-x-[10px]\",\n    arrow: \"-left-1 top-1/2 -translate-y-1/2\",\n  },\n};\n\ninterface ChartTooltipEmitter {\n  on: (event: string, handler: (data: ChartTooltipHoverEvent) => void) => void;\n}\n\ninterface ChartTooltipHoverEvent {\n  points?: ChartTooltipHoverPoint[];\n  event?: MouseEvent;\n}\n\nexport interface ChartTooltipProps {\n  /** Anchor position (viewport coordinates) and content lines */\n  anchor: ChartTooltipAnchor | null;\n  /** Ref to the bubble node, used by cursor-following charts to clamp it on-screen */\n  bubbleRef?: Ref<HTMLDivElement>;\n}\n\n/**\n * Resolve the side the bubble actually renders on: keep the preferred side\n * when it fits in the viewport, otherwise flip to the opposite side.\n */\nconst resolveSide = (\n  preferred: ChartTooltipSide,\n  anchor: { left: number; top: number },\n  width: number,\n  height: number,\n): ChartTooltipSide => {\n  const pad = VIEWPORT_PADDING_PX;\n  const reach = TOOLTIP_GAP_PX;\n  const fits: Record<ChartTooltipSide, boolean> = {\n    top: anchor.top - reach - height >= pad,\n    bottom: anchor.top + reach + height <= window.innerHeight - pad,\n    left: anchor.left - reach - width >= pad,\n    right: anchor.left + reach + width <= window.innerWidth - pad,\n  };\n  // Flip only when the preferred side overflows and the opposite has room\n  if (!fits[preferred] && fits[OPPOSITE_SIDE[preferred]]) {\n    return OPPOSITE_SIDE[preferred];\n  }\n  return preferred;\n};\n\n/**\n * The design-system tooltip anchored at a chart position; drive it with\n * `useChartTooltip`.\n *\n * Renders the same visual as the ui `TooltipContent` (bubble + arrow) but\n * positions it directly from the anchor coordinates — Radix's popper\n * repositions asynchronously and mis-measures animated content, which made\n * tooltips drift on charts. Placement supports all four sides with\n * Radix-style collision flipping.\n */\nexport function ChartTooltip({ anchor, bubbleRef }: ChartTooltipProps) {\n  const wrapperRef = useRef<HTMLDivElement>(null);\n  const preferredSide = anchor?.side ?? \"top\";\n  const [resolvedSide, setResolvedSide] = useState<ChartTooltipSide>(preferredSide);\n\n  // Forward the wrapper node to both the internal measure ref and the\n  // optional external ref (used by cursor-following charts to clamp it)\n  const setBubbleNode = useCallback(\n    (node: HTMLDivElement | null) => {\n      wrapperRef.current = node;\n      if (typeof bubbleRef === \"function\") bubbleRef(node);\n      else if (bubbleRef) {\n        (bubbleRef as { current: HTMLDivElement | null }).current = node;\n      }\n    },\n    [bubbleRef],\n  );\n\n  // Measure before paint and flip to the opposite side if needed\n  useLayoutEffect(() => {\n    const node = wrapperRef.current;\n    if (!anchor || !node) return;\n    const next = resolveSide(\n      preferredSide,\n      anchor,\n      node.offsetWidth,\n      node.offsetHeight,\n    );\n    setResolvedSide((current) => (current === next ? current : next));\n  }, [anchor, preferredSide]);\n\n  if (!anchor) return null;\n  const side = SIDE_CLASSES[resolvedSide];\n  return createPortal(\n    <div\n      data-slot=\"chart-tooltip-anchor\"\n      className=\"pointer-events-none fixed z-50\"\n      style={{ left: anchor.left, top: anchor.top }}\n    >\n      {/* Positioning transforms live on this node; animations (which also\n          drive `transform`) live on the bubble below so they can't clobber\n          each other */}\n      <div ref={setBubbleNode} className={cn(\"w-max\", side.wrapper)}>\n        <div\n          role=\"tooltip\"\n          data-slot=\"tooltip-content\"\n          data-side={resolvedSide}\n          className={cn(\n            \"relative w-fit max-w-xs rounded-md bg-foreground px-3 py-1.5 text-xs text-background\",\n            anchor.closing\n              ? \"animate-out fade-out zoom-out-95 fill-mode-forwards\"\n              : \"animate-in fade-in-0 zoom-in-95\",\n          )}\n        >\n          {anchor.lines.map((line, index) => (\n            <div key={`${index}-${line}`}>{line}</div>\n          ))}\n          <span\n            aria-hidden\n            className={cn(\n              \"absolute size-2.5 rotate-45 rounded-[2px] bg-foreground\",\n              side.arrow,\n            )}\n          />\n        </div>\n      </div>\n    </div>,\n    document.body,\n  );\n}\n\nexport interface UseChartTooltipOptions {\n  /** Axis label used for the default x line (falls back to \"X\") */\n  xLabel?: string;\n  /** Axis label used for the default y line (falls back to \"Y\") */\n  yLabel?: string;\n  /** Override the default line builder entirely */\n  getLines?: (points: ChartTooltipHoverPoint[]) => string[];\n  /**\n   * Track the cursor instead of anchoring to the hovered point's bounds, and\n   * keep the tooltip clamped inside the viewport. Use for traces with large\n   * hover targets (e.g. pie slices) where a fixed anchor feels disconnected.\n   */\n  followCursor?: boolean;\n  /**\n   * Override Plotly's hover hit radius (px). A larger radius makes big markers\n   * (e.g. heatmap circles) hoverable across their whole face.\n   */\n  hoverDistance?: number;\n  /**\n   * Preferred side to place the tooltip on relative to the point. Auto-flips to\n   * the opposite side when there isn't room (Radix-style). Defaults to \"top\".\n   */\n  side?: ChartTooltipSide;\n}\n\n/** Clamp an anchor point so a bubble of `width`×`height` stays on-screen */\nconst clampAnchor = (\n  left: number,\n  top: number,\n  width: number,\n  height: number,\n): { left: number; top: number } => {\n  const halfWidth = width / 2;\n  const clampedLeft = Math.min(\n    Math.max(left, halfWidth + VIEWPORT_PADDING_PX),\n    window.innerWidth - halfWidth - VIEWPORT_PADDING_PX,\n  );\n  // The bubble sits above the anchor; keep its top edge inside the viewport\n  const clampedTop = Math.min(\n    Math.max(top, height + 10 + VIEWPORT_PADDING_PX),\n    window.innerHeight - VIEWPORT_PADDING_PX,\n  );\n  return { left: clampedLeft, top: clampedTop };\n};\n\n/**\n * Drives the design-system tooltip from Plotly hover events.\n *\n * ```tsx\n * const { bindTooltip, tooltipElement } = useChartTooltip({ xLabel, yLabel });\n * // after Plotly.newPlot(...): set trace hoverinfo to \"none\", then\n * bindTooltip(plotRef.current);\n * // anywhere in the chart markup:\n * {tooltipElement}\n * ```\n */\nexport function useChartTooltip(options: UseChartTooltipOptions = {}) {\n  const [anchor, setAnchor] = useState<ChartTooltipAnchor | null>(null);\n  const hideTimerRef = useRef<ReturnType<typeof setTimeout>>(undefined);\n  const optionsRef = useRef(options);\n  optionsRef.current = options;\n  // Measured bubble node, used to clamp the cursor-following tooltip on-screen\n  const bubbleRef = useRef<HTMLDivElement>(null);\n  // Active lines while a cursor-following tooltip is shown; null when hidden\n  const cursorLinesRef = useRef<string[] | null>(null);\n  // Removes the mousemove listener registered by the previous bindTooltip call\n  const detachMouseMoveRef = useRef<(() => void) | null>(null);\n\n  const bindTooltip = useCallback((plotDiv: HTMLElement | null) => {\n    if (!plotDiv) return;\n    // The chart effect can re-run (size/theme/props changes) and call this\n    // again on the same node; drop the prior mousemove listener so they don't\n    // accumulate. (Plotly's own hover/unhover handlers are cleared by newPlot.)\n    detachMouseMoveRef.current?.();\n    detachMouseMoveRef.current = null;\n    setAnchor(null);\n    cursorLinesRef.current = null;\n\n    // A larger hover radius makes the tooltip easier to acquire and keep.\n    // bindTooltip is documented as \"call after Plotly.newPlot(...)\", so the\n    // lazily-loaded Plotly module is guaranteed to be available here.\n    void getLoadedPlotly().relayout(plotDiv, {\n      hoverdistance: optionsRef.current.hoverDistance ?? HOVER_DISTANCE_PX,\n    });\n\n    const emitter = plotDiv as unknown as ChartTooltipEmitter;\n\n    // Place the cursor-following tooltip at the (clamped) cursor position\n    const positionAtCursor = (lines: string[], clientX: number, clientY: number) => {\n      const bubble = bubbleRef.current;\n      const { left, top } = clampAnchor(\n        clientX,\n        clientY,\n        bubble?.offsetWidth ?? 0,\n        bubble?.offsetHeight ?? 0,\n      );\n      setAnchor({ left, top, lines, side: optionsRef.current.side });\n    };\n\n    emitter.on(\"plotly_hover\", (eventData) => {\n      const points = eventData.points ?? [];\n      const { getLines, xLabel, yLabel, followCursor } = optionsRef.current;\n      const lines = getLines\n        ? getLines(points)\n        : chartTooltipLines(points, { xLabel, yLabel });\n      if (lines.length === 0) return;\n\n      clearTimeout(hideTimerRef.current);\n\n      const mouse = eventData.event;\n      if (followCursor) {\n        cursorLinesRef.current = lines;\n        positionAtCursor(lines, mouse?.clientX ?? 0, mouse?.clientY ?? 0);\n        return;\n      }\n\n      // Anchor to the hovered point's bounds (in plot-div pixels) when\n      // Plotly provides them; fall back to the mouse position. The anchor\n      // is position:fixed, so viewport coordinates are used directly.\n      const point = points[0];\n      const bbox = point?.bbox;\n      let left = 0;\n      let top = 0;\n      if (bbox) {\n        const rect = plotDiv.getBoundingClientRect();\n        left = rect.left + (bbox.x0 + bbox.x1) / 2;\n        // Bars report a zero-height bbox that sits below their visual top;\n        // anchor to the bar's true top via the axis projection instead.\n        const yaxis = point?.yaxis;\n        if (\n          bbox.y0 === bbox.y1 &&\n          typeof point?.y === \"number\" &&\n          typeof yaxis?.l2p === \"function\" &&\n          typeof yaxis._offset === \"number\"\n        ) {\n          top = rect.top + yaxis._offset + yaxis.l2p(point.y);\n        } else {\n          top = rect.top + Math.min(bbox.y0, bbox.y1);\n        }\n      } else if (mouse) {\n        left = mouse.clientX;\n        top = mouse.clientY;\n      }\n      setAnchor({ left, top, lines, side: optionsRef.current.side });\n    });\n\n    // While following the cursor, keep the tooltip glued to the pointer even\n    // when Plotly does not re-fire hover within the same point (e.g. a slice)\n    const handleMouseMove = (event: MouseEvent) => {\n      if (!optionsRef.current.followCursor) return;\n      const lines = cursorLinesRef.current;\n      if (!lines) return;\n      positionAtCursor(lines, event.clientX, event.clientY);\n    };\n    plotDiv.addEventListener(\"mousemove\", handleMouseMove);\n    detachMouseMoveRef.current = () =>\n      plotDiv.removeEventListener(\"mousemove\", handleMouseMove);\n\n    emitter.on(\"plotly_unhover\", () => {\n      clearTimeout(hideTimerRef.current);\n      cursorLinesRef.current = null;\n      // After the grace period, play the exit animation, then unmount\n      hideTimerRef.current = setTimeout(() => {\n        setAnchor((previous) =>\n          previous ? { ...previous, closing: true } : previous,\n        );\n        hideTimerRef.current = setTimeout(() => setAnchor(null), EXIT_ANIMATION_MS);\n      }, HIDE_GRACE_MS);\n    });\n  }, []);\n\n  return {\n    bindTooltip,\n    tooltipElement: <ChartTooltip anchor={anchor} bubbleRef={bubbleRef} />,\n  };\n}\n"],"names":["HOVER_DISTANCE_PX","HIDE_GRACE_MS","EXIT_ANIMATION_MS","VIEWPORT_PADDING_PX","TOOLTIP_GAP_PX","OPPOSITE_SIDE","SIDE_CLASSES","resolveSide","preferred","anchor","width","height","pad","reach","fits","ChartTooltip","bubbleRef","wrapperRef","useRef","preferredSide","resolvedSide","setResolvedSide","useState","setBubbleNode","useCallback","node","useLayoutEffect","next","current","side","createPortal","jsx","cn","jsxs","line","index","clampAnchor","left","top","halfWidth","clampedLeft","clampedTop","useChartTooltip","options","setAnchor","hideTimerRef","optionsRef","cursorLinesRef","detachMouseMoveRef","plotDiv","getLoadedPlotly","emitter","positionAtCursor","lines","clientX","clientY","bubble","eventData","points","getLines","xLabel","yLabel","followCursor","chartTooltipLines","mouse","point","bbox","rect","yaxis","handleMouseMove","event","previous"],"mappings":"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"}

package/dist/components/charts/ChartTooltip/ChartTooltip.d.ts

@@ -0,0 +1,71 @@
+import { ChartTooltipHoverPoint } from './lines';
+import { Ref } from 'react';
+export { chartTooltipLines } from './lines';
+export type { ChartTooltipHoverPoint } from './lines';
+/** Which edge of the point the tooltip is placed against (matches Radix). */
+export type ChartTooltipSide = "top" | "bottom" | "left" | "right";
+export interface ChartTooltipAnchor {
+    left: number;
+    top: number;
+    lines: string[];
+    /** Preferred placement side; auto-flips to the opposite when it won't fit */
+    side?: ChartTooltipSide;
+    /** Plays the exit animation before the tooltip unmounts */
+    closing?: boolean;
+}
+export interface ChartTooltipProps {
+    /** Anchor position (viewport coordinates) and content lines */
+    anchor: ChartTooltipAnchor | null;
+    /** Ref to the bubble node, used by cursor-following charts to clamp it on-screen */
+    bubbleRef?: Ref<HTMLDivElement>;
+}
+/**
+ * The design-system tooltip anchored at a chart position; drive it with
+ * `useChartTooltip`.
+ *
+ * Renders the same visual as the ui `TooltipContent` (bubble + arrow) but
+ * positions it directly from the anchor coordinates — Radix's popper
+ * repositions asynchronously and mis-measures animated content, which made
+ * tooltips drift on charts. Placement supports all four sides with
+ * Radix-style collision flipping.
+ */
+export declare function ChartTooltip({ anchor, bubbleRef }: ChartTooltipProps): import('react').ReactPortal | null;
+export interface UseChartTooltipOptions {
+    /** Axis label used for the default x line (falls back to "X") */
+    xLabel?: string;
+    /** Axis label used for the default y line (falls back to "Y") */
+    yLabel?: string;
+    /** Override the default line builder entirely */
+    getLines?: (points: ChartTooltipHoverPoint[]) => string[];
+    /**
+     * Track the cursor instead of anchoring to the hovered point's bounds, and
+     * keep the tooltip clamped inside the viewport. Use for traces with large
+     * hover targets (e.g. pie slices) where a fixed anchor feels disconnected.
+     */
+    followCursor?: boolean;
+    /**
+     * Override Plotly's hover hit radius (px). A larger radius makes big markers
+     * (e.g. heatmap circles) hoverable across their whole face.
+     */
+    hoverDistance?: number;
+    /**
+     * Preferred side to place the tooltip on relative to the point. Auto-flips to
+     * the opposite side when there isn't room (Radix-style). Defaults to "top".
+     */
+    side?: ChartTooltipSide;
+}
+/**
+ * Drives the design-system tooltip from Plotly hover events.
+ *
+ * ```tsx
+ * const { bindTooltip, tooltipElement } = useChartTooltip({ xLabel, yLabel });
+ * // after Plotly.newPlot(...): set trace hoverinfo to "none", then
+ * bindTooltip(plotRef.current);
+ * // anywhere in the chart markup:
+ * {tooltipElement}
+ * ```
+ */
+export declare function useChartTooltip(options?: UseChartTooltipOptions): {
+    bindTooltip: (plotDiv: HTMLElement | null) => void;
+    tooltipElement: import("react/jsx-runtime").JSX.Element;
+};