{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "ds-waterfall-chart",
  "description": "Waterfall chart for cumulative positive/negative value bridges.",
  "dependencies": [
    "class-variance-authority",
    "recharts"
  ],
  "registryDependencies": [
    "@lema-ds/chart",
    "@lema-ds/skeleton",
    "@lema-ds/card",
    "@lema-ds/ui-i18n",
    "@lema-ds/format-utils",
    "@lema-ds/ds-locale-provider"
  ],
  "files": [
    {
      "path": "components/ds/ds-waterfall-chart.tsx",
      "content": "\"use client\"\n\nimport * as React from \"react\"\nimport {\n  Bar,\n  BarChart as RechartsBarChart,\n  CartesianGrid,\n  Cell,\n  XAxis,\n  YAxis,\n} from \"recharts\"\nimport { cva } from \"class-variance-authority\"\nimport { cn } from \"@/lib/utils\"\nimport { Skeleton } from \"@/components/ui/skeleton\"\nimport { UI_I18N, type UILocale } from \"@/lib/ui-i18n\"\nimport { useUILocale } from \"@/components/ui/ds-locale-provider\"\nimport { formatChartValue, type FormatPreset } from \"@/lib/format-utils\"\nimport {\n  Card,\n  CardContent,\n  CardDescription,\n  CardFooter,\n  CardHeader,\n  CardTitle,\n} from \"@/components/ui/card\"\nimport {\n  ChartContainer,\n  ChartTooltip,\n  ChartTooltipContent,\n} from \"@/components/ui/chart\"\n\n// ── Types ──────────────────────────────────────────────────────────────────\n\nexport type WaterfallEntryType = \"start\" | \"positive\" | \"negative\" | \"end\"\n\nexport interface WaterfallEntry {\n  name: string\n  value: number\n  /** \"start\" = first total bar, \"end\" = final total bar, \"positive\" = gain, \"negative\" = loss */\n  type?: WaterfallEntryType\n}\n\nexport interface WaterfallChartProps extends React.HTMLAttributes<HTMLDivElement> {\n  data: WaterfallEntry[]\n  title?: string\n  subtitle?: string\n  footer?: React.ReactNode\n  height?: number\n  showGrid?: boolean\n  showTooltip?: boolean\n  valueFormatter?: (value: number) => string\n  format?: FormatPreset\n  decimals?: number\n  currency?: string\n  abbreviate?: boolean\n  loading?: boolean\n  locale?: UILocale\n}\n\n// ── Variants ───────────────────────────────────────────────────────────────\n\nexport const waterfallChartContainerVariants = cva(\"w-full\", {\n  variants: {},\n})\n\n// ── Helpers ────────────────────────────────────────────────────────────────\n\ninterface WaterfallBarData {\n  name: string\n  value: number\n  type: WaterfallEntryType\n  /** Y offset for the floating bar */\n  base: number\n  /** Display value (absolute) for labels */\n  displayValue: number\n}\n\nfunction computeWaterfallData(entries: WaterfallEntry[]): WaterfallBarData[] {\n  let running = 0\n  return entries.map((entry, i) => {\n    const type = entry.type ?? (i === 0 ? \"start\" : \"positive\")\n    const isTotal = type === \"start\" || type === \"end\"\n\n    let base = 0\n    let value = entry.value\n\n    if (isTotal) {\n      base = 0\n      value = entry.value\n    } else if (type === \"positive\") {\n      base = running\n      value = entry.value\n    } else {\n      // negative\n      base = running + entry.value // entry.value is negative\n      value = -entry.value // height is positive\n    }\n\n    if (isTotal) {\n      running = entry.value\n    } else {\n      running += entry.value\n    }\n\n    return {\n      name: entry.name,\n      value,\n      type,\n      base,\n      displayValue: entry.value,\n    }\n  })\n}\n\n// ── WaterfallChart ─────────────────────────────────────────────────────────\n\nexport function WaterfallChart({\n  data,\n  title,\n  subtitle,\n  footer,\n  height = 320,\n  showGrid = true,\n  showTooltip = true,\n  valueFormatter,\n  format,\n  decimals = 0,\n  currency = \"USD\",\n  abbreviate = false,\n  loading = false,\n  locale: localeProp,\n  className,\n  ...props\n}: WaterfallChartProps) {\n  const locale = useUILocale(localeProp)\n  const formatValue = React.useCallback(\n    (v: number) => {\n      if (valueFormatter) return valueFormatter(v)\n      return formatChartValue(v, {\n        format,\n        decimals,\n        locale,\n        currency,\n        abbreviate,\n      })\n    },\n    [valueFormatter, format, decimals, locale, currency, abbreviate]\n  )\n\n  // ── Loading ─────────────────────────────────────────────────────────────\n\n  if (loading) {\n    return (\n      <Card className={cn(\"w-full\", className)} {...props}>\n        {(title || subtitle) && (\n          <CardHeader>\n            {title && <Skeleton className=\"h-5 w-48\" />}\n            {subtitle && <Skeleton className=\"mt-1 h-4 w-64\" />}\n          </CardHeader>\n        )}\n        <CardContent>\n          <Skeleton className=\"w-full rounded-lg\" style={{ height }} />\n        </CardContent>\n        {footer && <CardFooter>{footer}</CardFooter>}\n      </Card>\n    )\n  }\n\n  // ── Empty ────────────────────────────────────────────────────────────────\n\n  if (data.length === 0) {\n    return (\n      <Card className={cn(\"w-full\", className)} {...props}>\n        {(title || subtitle) && (\n          <CardHeader>\n            {title && <CardTitle>{title}</CardTitle>}\n            {subtitle && <CardDescription>{subtitle}</CardDescription>}\n          </CardHeader>\n        )}\n        <CardContent>\n          <div\n            className=\"flex items-center justify-center text-sm text-muted-foreground\"\n            style={{ height }}\n          >\n            {UI_I18N[locale].emptyState.noData}\n          </div>\n        </CardContent>\n        {footer && <CardFooter>{footer}</CardFooter>}\n      </Card>\n    )\n  }\n\n  // ── Compute ──────────────────────────────────────────────────────────────\n\n  const computed = computeWaterfallData(data)\n\n  const chartConfig: Record<string, { label: string; color: string }> = {\n    value: { label: \"Value\", color: \"var(--chart-1)\" },\n  }\n\n  // Recharts trick: use a \"base\" invisible bar (no fill) to shift the real bar\n  const rechartsData = computed.map((d) => ({\n    name: d.name,\n    base: d.base,\n    value: d.value,\n    type: d.type,\n    displayValue: d.displayValue,\n  }))\n\n  const getBarColor = (type: WaterfallEntryType) => {\n    if (type === \"start\" || type === \"end\") return \"var(--muted-foreground)\"\n    if (type === \"positive\") return \"var(--chart-1)\"\n    return \"var(--destructive)\"\n  }\n\n  return (\n    <Card className={cn(\"w-full\", className)} {...props}>\n      {(title || subtitle) && (\n        <CardHeader>\n          {title && <CardTitle>{title}</CardTitle>}\n          {subtitle && <CardDescription>{subtitle}</CardDescription>}\n        </CardHeader>\n      )}\n      <CardContent>\n        <ChartContainer config={chartConfig} style={{ height }}>\n          <RechartsBarChart\n            data={rechartsData}\n            margin={{ top: 16, right: 16, left: 0, bottom: 4 }}\n          >\n            {showGrid && (\n              <CartesianGrid\n                strokeDasharray=\"3 3\"\n                className=\"stroke-muted\"\n                vertical={false}\n              />\n            )}\n            <XAxis\n              dataKey=\"name\"\n              className=\"text-xs text-muted-foreground\"\n              tick={{ fontSize: 11 }}\n              axisLine={false}\n              tickLine={false}\n            />\n            <YAxis\n              tickFormatter={formatValue}\n              className=\"text-xs text-muted-foreground\"\n              tick={{ fontSize: 11 }}\n              axisLine={false}\n              tickLine={false}\n              width={60}\n            />\n            {showTooltip && (\n              <ChartTooltip\n                content={\n                  <ChartTooltipContent\n                    formatter={(value, name, item) => {\n                      const display = item.payload?.displayValue ?? value\n                      return formatValue(Number(display))\n                    }}\n                    labelClassName=\"font-medium text-foreground\"\n                  />\n                }\n              />\n            )}\n            {/* Invisible \"base\" bar to lift the real bar */}\n            <Bar dataKey=\"base\" stackId=\"waterfall\" fill=\"transparent\" />\n            {/* Real bar */}\n            <Bar dataKey=\"value\" stackId=\"waterfall\" radius={[3, 3, 0, 0]}>\n              {rechartsData.map((entry, i) => (\n                <Cell\n                  key={`cell-${i}`}\n                  fill={getBarColor(entry.type as WaterfallEntryType)}\n                  fillOpacity={\n                    entry.type === \"start\" || entry.type === \"end\" ? 0.6 : 1\n                  }\n                />\n              ))}\n            </Bar>\n          </RechartsBarChart>\n        </ChartContainer>\n      </CardContent>\n      {footer && <CardFooter>{footer}</CardFooter>}\n    </Card>\n  )\n}\n",
      "type": "registry:ui"
    }
  ],
  "type": "registry:ui"
}
