Domphy

chartLineStep

A Charts block/component from shadcn/ui — clean-room reimplemented for Domphy (see methodology). Call chartLineStep() with no arguments for a working demo, or edit the code below live.

Implementation notes

Identical to chartLineDefault with LineSeriesOption.step (default 'start', exposed as a stepMode prop). Same mount-reveal approximation as chartLineDefault.

Status: ported · Reference: shadcn/ui original

// shadcn/ui "charts/line-step" block — clean-room reimplementation.
//
// Same single-series six-month chart as chartLineDefault, but rendered as a
// stepped/staircase line: the line holds each value horizontally then jumps
// vertically to the next one. Everything else — card chrome, grid, axis,
// tooltip and footer — is unchanged.
//
// Implemented purely from the block's public functional/visual spec — no
// upstream shadcn/ui source was viewed or copied.

import type { DomphyElement } from "@domphy/core";
import type { ThemeColor } from "@domphy/theme";
import type { ChartOption, LineSeriesOption } from "@domphy/chart";
import {
  DEFAULT_LINE_GRID,
  MONTHLY_VISITOR_DATA,
  type MonthlyPoint,
  bareValueTooltipFormatter,
  chartCard,
  chartPlot,
  computeYDomain,
  hiddenLabelYAxis,
  monthCategoryXAxis,
  trendFooter,
} from "./chart-line-shared.js";

/** Props for {@link chartLineStep}. */
export interface ChartLineStepProps {
  title?: string;
  description?: string;
  seriesLabel?: string;
  seriesColor?: ThemeColor;
  data?: MonthlyPoint[];
  /** Where the vertical jump sits relative to each pair of points. Defaults to "start". */
  stepMode?: NonNullable<LineSeriesOption["step"]>;
  trendHeadline?: string;
  trendSubtitle?: string;
  trendDirection?: "up" | "down";
}

/**
 * shadcn/ui "charts/line-step" — the default single-line chart rendered as a
 * staircase. Call with no arguments for a fully working demo.
 */
function chartLineStep(props: ChartLineStepProps = {}): DomphyElement<"div"> {
  const {
    title = "Line Chart - Step",
    description = "January - June 2026",
    seriesLabel = "Desktop",
    seriesColor = "primary",
    data = MONTHLY_VISITOR_DATA,
    stepMode = "start",
    trendHeadline = "Trending up by 5.2% this month",
    trendSubtitle = "Showing total visitors for the last 6 months",
    trendDirection = "up",
  } = props;

  const categories = data.map((point) => point.month);
  const values = data.map((point) => point.desktop);
  const yDomain = computeYDomain(values);

  const option: ChartOption = {
    grid: DEFAULT_LINE_GRID,
    xAxis: monthCategoryXAxis(categories),
    yAxis: hiddenLabelYAxis(yDomain),
    tooltip: {
      trigger: "axis",
      axisPointer: { type: "none" },
      formatter: bareValueTooltipFormatter,
    },
    series: [
      {
        type: "line",
        name: seriesLabel,
        data: values,
        smooth: false,
        step: stepMode,
        showSymbol: false,
        lineStyle: { width: 2 },
        color: seriesColor,
      },
    ],
  };

  return chartCard({
    title,
    description,
    plot: chartPlot({ option }),
    footer: trendFooter({
      headline: trendHeadline,
      subtitle: trendSubtitle,
      direction: trendDirection,
    }),
  });
}

export { chartLineStep };

← Back to shadcn/ui catalog