plot — 6.0.0

type Settings = {
  /** Static series color configuration. */
  color?: Colors;
  /** Fixed plot width or `auto` for active terminal columns. Defaults to an input-derived width. */
  width?: ChartWidth;
  /** Plot height in terminal rows. Defaults to an input-derived height unless `aspectRatio` applies. */
  height?: number;
  /** Desired physical width-to-height ratio used when height is derived. */
  aspectRatio?: number;
  /** Explicit numeric Y extent as `[minimum, maximum]`. */
  yRange?: [number, number];
  /** Line behavior outside explicit domains. Defaults to `discard`. */
  overflow?: Overflow;
  /** Plot-cell backend. Defaults to `ascii`. */
  renderer?: Renderer;
  /** Reserves enough width for complete Y-axis tick labels. */
  showTickLabel?: boolean;
  /** Hides the X-axis line, ticks, labels, and axis label. */
  hideXAxis?: boolean;
  /** Hides X-axis tick markers and labels while retaining the axis line. */
  hideXAxisTicks?: boolean;
  /** Hides the Y-axis line, ticks, labels, and axis label. */
  hideYAxis?: boolean;
  /** Hides Y-axis tick markers and labels while retaining the axis line. */
  hideYAxisTicks?: boolean;
  /** Explicit finite X-axis tick values. */
  customXAxisTicks?: number[];
  /** Explicit finite Y-axis tick values. */
  customYAxisTicks?: number[];
  /** Title rendered above the chart. */
  title?: string;
  /** ANSI color applied to the title. */
  titleColor?: Color;
  /** X-axis label. */
  xLabel?: string;
  /** Y-axis label. */
  yLabel?: string;
  /** Numeric horizontal and/or vertical reference lines. */
  thresholds?: Threshold[];
  /** Point overlays rendered in data coordinates. */
  points?: GraphPoint[];
  /** Fills the region between line series and the X-axis baseline. */
  fillArea?: boolean;
  /** Legend placement, labels, and ANSI color. */
  legend?: Legend;
  /** Explicit X/Y axis intersection; `undefined` preserves an inferred coordinate. */
  axisCenter?: MaybePoint;
  /** Shared numeric axis-label formatter. Structured axis formatters take precedence. */
  formatter?: Formatter;
  /** Custom glyph callback for occupied series cells. */
  lineFormatter?: (args: LineFormatterArgs) => CustomSymbol | CustomSymbol[];
  /** Per-call glyph overrides. */
  symbols?: Symbols;
  /** ANSI color applied to the configured border glyph. */
  borderColor?: Color;
  /** ANSI color applied to background glyphs. */
  backgroundColor?: Color;
  /** Graph primitive. Defaults to `line`. */
  mode?: GraphMode;
  /** Line-segment interpolation. Defaults to `step`. */
  interpolation?: Interpolation;
  /** Shared or per-series dynamic color strategy. */
  coloring?: Coloring | readonly (Coloring | undefined)[];
  /** Multi-series bar arrangement. Defaults to `overlap`. */
  barLayout?: BarLayout;
  /** Enables bar endpoint labels or configures their text and color. */
  valueLabels?: ChartValueLabels;
  /** Logs out-of-bounds drawing attempts for diagnostics. */
  debugMode?: boolean;
  /** Structured X-axis fields; each supplied field overrides its flat alias. */
  xAxis?: XAxis;
  /** Structured Y-axis fields; each supplied field overrides its flat alias. */
  yAxis?: YAxis;
};

type Legend = {
  /** Placement relative to the plot. Defaults to `bottom`. */
  position?: LegendPosition;
  /** One series label or labels indexed by source series. */
  series?: string | string[];
  /** One point label or labels indexed by overlay point. */
  points?: string | string[];
  /** One threshold label or labels indexed by threshold. */
  thresholds?: string | string[];
  /** ANSI color applied to legend labels. */
  color?: Color;
};

type Threshold = {
  /** X coordinate for a vertical reference line. */
  x?: number;
  /** Y coordinate for a horizontal reference line. */
  y?: number;
  /** ANSI color applied to the reference line. */
  color?: Color;
};

type GraphPoint = {
  /** Numeric X coordinate. */
  x: number;
  /** Numeric Y coordinate. */
  y: number;
  /** ANSI color applied to the point glyph. */
  color?: Color;
};

type XAxis = {
  /** Scale kind. Defaults to the kind inferred from X values. */
  scale?: XScale;
  /** Explicit category order or continuous scale extent. */
  domain?: XAxisDomain<X>;
  /** Exact native tick values or an exact tick count of at least two. */
  ticks?: number | readonly X[];
  /** Axis label rendered outside tick labels. */
  label?: string;
  /** Formatter called with native X values. */
  formatter?: AxisFormatter<X>;
  /** Hides the axis line, ticks, labels, and axis label. */
  hidden?: boolean;
  /** Hides tick markers and labels while retaining the axis line. */
  hideTicks?: boolean;
  /** Handling for labels that do not fit the available width. */
  labelCollision?: LabelCollisionPolicy;
  /** ANSI color applied to the axis line, ticks, tick labels, and label. */
  color?: Color;
};

type YAxis = {
  /** Explicit numeric extent as `[minimum, maximum]`. */
  domain?: readonly [number, number];
  /** Exact numeric tick values or an exact tick count of at least two. */
  ticks?: number | readonly number[];
  /** Axis label rendered outside tick labels. */
  label?: string;
  /** Formatter called for each numeric Y-axis tick. */
  formatter?: Formatter;
  /** Hides the axis line, ticks, labels, and axis label. */
  hidden?: boolean;
  /** Hides tick markers and labels while retaining the axis line. */
  hideTicks?: boolean;
  /** Reserves enough width for complete Y-axis tick labels. */
  showTickLabel?: boolean;
  /** ANSI color applied to the axis line, ticks, tick labels, and label. */
  color?: Color;
};

type Coloring = {
  /** Selects callback-based colors. */
  type: 'conditional';
  /** Returns a color or `undefined` to use the static series fallback. */
  getColor: (context: ColorContext) => Color | undefined;
} | {
  /** Selects equal-band palette coloring. */
  type: 'gradient';
  /** Data-space axis used to select a palette band. */
  by: 'x' | 'y';
  /** Nonempty ordered ANSI color palette. */
  colors: readonly Color[];
  /** Optional finite palette extent. Defaults to the resolved chart domain. */
  domain?: readonly [number, number];
};

type ChartValueLabels = boolean | {
  /** Formats the rendered value; normalized layouts receive a percentage. */
  formatter?: ValueLabelFormatter<X>;
  /** ANSI color applied to every value label. */
  color?: Color;
};