Skip to content

A reactive notebook for Python — run reproducible experiments, query with SQL, execute as a script, deploy as an app, and version with git. Stored as pure Python. All in a modern, AI-native editor.

3.2 KB
Raw Blame
/* Copyright 2026 Marimo. All rights reserved. */

import type { TopLevelSpec } from "vega-lite";
import type { TimeUnit } from "vega-lite/types_unstable/timeunit.js";
import type { CellId } from "@/core/cells/ids";
import type { CellRun } from "@/core/cells/runs";
import type { ResolvedTheme } from "@/theme/useTheme";

export const REACT_HOVERED_CELLID = "hoveredCellId";
export const VEGA_HOVER_SIGNAL = "cellHover";

export type ChartPosition = "sideBySide" | "above";
export interface ChartValues {
  cell: CellId;
  cellNum: number;
  startTimestamp: string;
  endTimestamp: string;
  elapsedTime: string;
  status: CellRun["status"];
}

const cellNumField = "cellNum" satisfies keyof ChartValues;
const cellField = "cell" satisfies keyof ChartValues;
const startTimestampField = "startTimestamp" satisfies keyof ChartValues;
const endTimestampField = "endTimestamp" satisfies keyof ChartValues;
const statusField = "status" satisfies keyof ChartValues;

export function createGanttBaseSpec(
  chartValues: ChartValues[],
  hiddenInputElementId: string,
  chartPosition: ChartPosition,
  theme: ResolvedTheme,
): Readonly<TopLevelSpec> {
  // @ts-expect-error - Supported by vega/vega-lite but invalid "TimeUnit" option from exported type
  const timeUnit: TimeUnit = "hoursminutessecondsmilliseconds";
  return {
    $schema: "https://vega.github.io/schema/vega-lite/v6.json",
    background: theme === "dark" ? "black" : undefined,
    mark: {
      type: "bar",
      cornerRadius: 2,
    },
    params: [
      {
        name: REACT_HOVERED_CELLID,
        bind: { element: `#${hiddenInputElementId}` },
      },
      {
        name: VEGA_HOVER_SIGNAL,
        select: {
          type: "point",
          on: "mouseover",
          fields: [cellField],
          clear: "mouseout",
        },
      },
    ],
    height: {
      step: chartPosition === "sideBySide" ? 26 : 21,
    },
    encoding: {
      y: {
        field: cellNumField,
        scale: { paddingInner: 0.2 },
        sort: { field: "sortPriority" },
        title: "cell",
        axis: chartPosition === "sideBySide" ? null : undefined,
      },
      x: {
        field: startTimestampField,
        type: "temporal",
        axis: { orient: "top", title: null },
      },
      x2: {
        field: endTimestampField,
        type: "temporal",
      },
      tooltip: [
        {
          field: startTimestampField,
          type: "temporal",
          timeUnit: timeUnit,
          title: "Start",
        },
        {
          field: endTimestampField,
          type: "temporal",
          timeUnit: timeUnit,
          title: "End",
        },
      ],
      size: {
        value: {
          expr: `${REACT_HOVERED_CELLID} == toString(datum.${cellField}) ? 19.5 : 18`,
        },
      },
      color: {
        field: statusField,
        scale: { domain: ["success", "error"], range: ["#37BE5F", "red"] },
        legend: null,
      },
    },
    data: {
      values: chartValues,
    },
    transform: [
      {
        // Sort queued cells to the bottom
        calculate: `datum.${statusField} === 'queued' ? 9999999999999 : datum.${startTimestampField}`,
        as: "sortPriority",
      },
    ],
    config: {
      view: {
        stroke: "transparent",
      },
    },
  };
}