{
  "title": "Direct Editable Milestone Event Range",
  "description": "Bidirectional drag handle and date picker event range adjuster.",
  "name": "tanstack-charts-editable-event-range",
  "dependencies": [
    "@tanstack/charts",
    "@tanstack/react-charts",
    "d3-scale"
  ],
  "registryDependencies": [
    "card",
    "button",
    "calendar",
    "popover"
  ],
  "type": "registry:block",
  "files": [
    {
      "path": "components/blocks/tanstack-charts/line/editable-event-range.tsx",
      "type": "registry:block",
      "content": "import { useMemo, useState } from \"react\";\n\nimport { type ChartPoint, defineChart, rect, text } from \"@tanstack/charts\";\nimport { handleX } from \"@tanstack/charts/interaction/handle\";\nimport { controlledSignal } from \"@tanstack/charts/interaction/signal\";\nimport { motion } from \"@tanstack/charts/motion\";\nimport { tooltip } from \"@tanstack/charts/tooltip\";\nimport { Chart } from \"@tanstack/react-charts/core\";\nimport { scaleBand, scaleUtc } from \"d3-scale\";\nimport { CalendarIcon, CalendarRange } from \"lucide-react\";\n\nimport { Button } from \"@/components/ui/button\";\nimport { Calendar } from \"@/components/ui/calendar\";\nimport { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from \"@/components/ui/card\";\nimport { Popover, PopoverContent, PopoverTrigger } from \"@/components/ui/popover\";\n\ninterface EditableEvent {\n    id: string;\n    lane: string;\n    label: string;\n    start: Date;\n    end: Date;\n}\n\nconst motionRenderer = motion({\n    initial: \"always\",\n    transition: { type: \"spring\", stiffness: 170, damping: 18, mass: 1 },\n});\n\nconst lanes = [\"Product\", \"Design\", \"Engineering\"];\n\nfunction generateInitialEvents(): EditableEvent[] {\n    const baseDate = new Date(Date.UTC(2024, 8, 1)).getTime();\n    const dayMs = 24 * 60 * 60 * 1000;\n\n    return [\n        {\n            id: \"discovery\",\n            lane: \"Product\",\n            label: \"Product Discovery\",\n            start: new Date(baseDate),\n            end: new Date(baseDate + 10 * dayMs),\n        },\n        {\n            id: \"design\",\n            lane: \"Design\",\n            label: \"UI/UX Specs\",\n            start: new Date(baseDate + 5 * dayMs),\n            end: new Date(baseDate + 18 * dayMs),\n        },\n        {\n            id: \"release\",\n            lane: \"Engineering\",\n            label: \"Production Release\",\n            start: new Date(baseDate + 12 * dayMs),\n            end: new Date(baseDate + 28 * dayMs),\n        },\n    ];\n}\n\nfunction shadcnTooltipContent<TDatum>(points: readonly ChartPoint<TDatum>[]) {\n    if (points.length === 0) return { title: \"\", rows: [] };\n    const d = points[0].datum as EditableEvent;\n    if (!d) return { title: \"\", rows: [] };\n    const fmt = (dt: Date) => dt.toLocaleDateString(\"en-US\", { month: \"short\", day: \"numeric\", timeZone: \"UTC\" });\n    return {\n        title: `${d.lane}: ${d.label}`,\n        rows: [{ label: \"Duration\", value: `${fmt(d.start)} - ${fmt(d.end)}`, color: \"var(--chart-1)\" }],\n    };\n}\n\nexport function EditableEventRange() {\n    const [releaseEnd, setReleaseEnd] = useState<Date>(new Date(Date.UTC(2024, 8, 29)));\n\n    const data = useMemo(() => {\n        const events = generateInitialEvents();\n        const releaseEvt = events.find((e) => e.id === \"release\");\n        if (releaseEvt) releaseEvt.end = releaseEnd;\n        return events;\n    }, [releaseEnd]);\n\n    const fullDomain = useMemo(() => {\n        return [new Date(Date.UTC(2024, 8, 1)), new Date(Date.UTC(2024, 9, 15))];\n    }, []);\n\n    const eventEndValues = useMemo(() => {\n        const result: Date[] = [];\n        const start = new Date(Date.UTC(2024, 8, 13)).getTime();\n        const end = new Date(Date.UTC(2024, 9, 15)).getTime();\n        const dayMs = 24 * 60 * 60 * 1000;\n        for (let t = start; t <= end; t += dayMs) {\n            result.push(new Date(t));\n        }\n        return result;\n    }, []);\n\n    const activeReleaseEnd = useMemo(() => {\n        const releaseTime = releaseEnd.getTime();\n        return eventEndValues.find((d) => d.getTime() === releaseTime) || eventEndValues[eventEndValues.length - 1];\n    }, [releaseEnd, eventEndValues]);\n\n    const calendarSelected = useMemo(() => {\n        return new Date(releaseEnd.getUTCFullYear(), releaseEnd.getUTCMonth(), releaseEnd.getUTCDate());\n    }, [releaseEnd]);\n\n    const definition = useMemo(\n        () =>\n            defineChart(\n                {\n                    renderer: motionRenderer,\n                    marks: [\n                        rect(data, {\n                            id: \"event-ranges\",\n                            x1: \"start\",\n                            x2: \"end\",\n                            y: \"lane\",\n                            color: \"id\",\n                            radius: 4,\n                            stroke: \"var(--background)\",\n                            strokeWidth: 1.5,\n                        }),\n                        text(data, {\n                            id: \"event-labels\",\n                            x: \"start\",\n                            y: \"lane\",\n                            text: \"label\",\n                            anchor: \"start\",\n                            dx: 8,\n                            fill: \"var(--foreground)\",\n                            fontSize: 11,\n                            fontWeight: 600,\n                        }),\n                    ],\n                    scales: {\n                        x: {\n                            scale: scaleUtc().domain(fullDomain),\n                            grid: true,\n                            axis: {\n                                ticks: {\n                                    format: (v: Date) =>\n                                        v.toLocaleDateString(\"en-US\", { month: \"short\", day: \"numeric\", timeZone: \"UTC\" }),\n                                },\n                            },\n                        },\n                        y: {\n                            scale: scaleBand<string>().domain(lanes).paddingInner(0.3),\n                            grid: false,\n                            axis: false,\n                        },\n                    },\n                    color: {\n                        domain: [\"discovery\", \"design\", \"release\"],\n                        range: [\"var(--chart-1)\", \"var(--chart-2)\", \"var(--chart-3)\"],\n                    },\n                    controls: [\n                        handleX({\n                            id: \"release-end\",\n                            value: controlledSignal<Date, any>(activeReleaseEnd, (next) =>\n                                setReleaseEnd(next instanceof Date ? next : new Date(next)),\n                            ),\n                            values: eventEndValues,\n                            cross: { value: \"Engineering\" as any },\n                            ruleStyle: { fill: \"var(--chart-3)\" },\n                            handleStyle: {\n                                fill: \"var(--chart-3)\",\n                                stroke: \"var(--background)\",\n                                strokeWidth: 2,\n                            },\n                            ariaLabel: \"Release end date handle scrubber\",\n                        } as any),\n                    ],\n                    margin: { top: 24, right: 24, bottom: 32, left: 90 },\n                    theme: {\n                        foreground: \"var(--muted-foreground)\",\n                        grid: \"var(--border)\",\n                        background: \"transparent\",\n                    },\n                },\n                {\n                    keyboard: true,\n                    tooltip: {\n                        use: tooltip,\n                        className:\n                            \"font-sans shadow-none rounded-md bg-popover text-popover-foreground border p-2 text-xs\",\n                        anchor: \"pointer\",\n                        placement: \"auto\",\n                        content: (points) => shadcnTooltipContent(points),\n                    },\n                },\n            ),\n        [data, fullDomain, releaseEnd],\n    );\n\n    const fmtDate = (d: Date) => d.toLocaleDateString(\"en-US\", { month: \"short\", day: \"numeric\", timeZone: \"UTC\" });\n\n    return (\n        <Card className=\"w-full max-w-xl\">\n            <CardHeader>\n                <CardTitle>Direct Editable Milestone Event Range</CardTitle>\n                <CardDescription>\n                    Bidirectional drag handle and date picker input synchronizing milestone durations\n                </CardDescription>\n            </CardHeader>\n            <CardContent className=\"space-y-3\">\n                <div className=\"flex items-center justify-between gap-3\">\n                    <span className=\"text-muted-foreground font-mono text-xs\">\n                        Release End: <strong className=\"text-foreground\">{fmtDate(releaseEnd)}</strong>\n                    </span>\n                    <div className=\"flex items-center gap-2\">\n                        <span className=\"text-muted-foreground text-xs font-medium\">Edit Date:</span>\n                        <Popover>\n                            <PopoverTrigger\n                                render={\n                                    <Button\n                                        variant=\"outline\"\n                                        size=\"sm\"\n                                        className=\"h-8 font-mono text-xs font-normal\">\n                                        <CalendarIcon className=\"mr-1.5 size-3.5 text-muted-foreground\" />\n                                        {fmtDate(releaseEnd)}\n                                    </Button>\n                                }\n                            />\n                            <PopoverContent className=\"w-auto p-0\" align=\"end\">\n                                <Calendar\n                                    mode=\"single\"\n                                    selected={calendarSelected}\n                                    onSelect={(date) => {\n                                        if (date) {\n                                            setReleaseEnd(\n                                                new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate())),\n                                            );\n                                        }\n                                    }}\n                                    defaultMonth={calendarSelected}\n                                    disabled={(date) => {\n                                        const utcTime = Date.UTC(date.getFullYear(), date.getMonth(), date.getDate());\n                                        return (\n                                            utcTime < Date.UTC(2024, 8, 13) ||\n                                            utcTime > Date.UTC(2024, 9, 15)\n                                        );\n                                    }}\n                                    autoFocus\n                                />\n                            </PopoverContent>\n                        </Popover>\n                    </div>\n                </div>\n                <div className=\"h-[210px] w-full\">\n                    <Chart\n                        definition={definition}\n                        renderer={motionRenderer}\n                        height={210}\n                        ariaLabel=\"Direct Editable Milestone Event Range Chart\"\n                    />\n                </div>\n            </CardContent>\n            <CardFooter className=\"flex-col items-start gap-2 text-sm\">\n                <div className=\"flex items-center gap-2 leading-none font-medium\">\n                    Drag the orange handle on Engineering lane to adjust release date{\" \"}\n                    <CalendarRange className=\"h-4 w-4 text-emerald-500\" />\n                </div>\n                <div className=\"text-muted-foreground leading-none\">\n                    `handleX` provides interactive endpoint manipulation synchronized with form controls\n                </div>\n            </CardFooter>\n        </Card>\n    );\n}\n\nexport default EditableEventRange;\n"
    }
  ],
  "mcp": {
    "description": "Renders responsive data visualization with dark mode styling and customizable tooltips. Bidirectional drag handle and date picker event range adjuster. Relies on card. Use when presenting data insights or analytics dashboards.",
    "tags": [
      "chart",
      "tanstack"
    ]
  }
}