feat(dashboards): Create HeatMapWidgetVisualization component

knip.config.ts

@@ -22,6 +22,8 @@ const productionEntryPoints = [
   'static/app/chartcuterie/**/*.{js,ts,tsx}',
   // TODO: Remove when used
   'static/app/views/seerExplorer/contexts/**/*.{js,ts,tsx}',
+  // TODO: Remove when integration into Explore has started
+  'static/app/views/dashboards/widgets/heatMapWidget/**/*.{ts,tsx}',
   // TODO: Remove when used
   'static/app/views/settings/organizationRepositories/connectProviderDropdown.tsx',
   'static/app/views/settings/organizationRepositories/noIntegrationsEmptyState.tsx',

static/app/views/dashboards/widgets/common/types.tsx

@@ -211,3 +211,113 @@ export interface CategoricalSeries {
    */
   groupBy?: CategoricalGroupBy[] | null;
 }
+
+/**
+ * The type of values in a heatmap series.
+ * This is the broadest set of types supported - any value type that can come
+ * from the API. The plottable layer constrains this to plottable types.
+ */
+type HeatMapValueType = AttributeValueType;
+export type HeatMapValueUnit = AttributeValueUnit;
+
+/**
+ * A single item in a heat map series.
+ */
+interface HeatMapItem {
+  /**
+   * The X-axis value
+   */
+  xAxis: number;
+  /**
+   * The Y-axis value
+   */
+  yAxis: number;
+  /**
+   * The Z-axis value. This can be null if the value is missing.
+   */
+  zAxis: number | null;
+}
+
+interface BoundedMeta {
+  /**
+   * The largest value of data on the axis
+   */
+  end: number;
+  /**
+   * The name of the series. Corresponds to what it's plotting. Could be `"time"` or something like `"count()"`
+   */
+  name: string;
+  /**
+   * The smallest value of data on the axis
+   */
+  start: number;
+}
+
+interface BucketedMeta {
+  /**
+   * The total count of buckets on this axis. Matches what was requested, if were requested
+   */
+  bucketCount: number;
+  /**
+   * The size of the buckets on this axis.
+   */
+  bucketSize: number;
+}
+
+interface NamedMeta {
+  /**
+   * The name of the series. Corresponds to what it's plotting. Could be `"time"` or something like `"count()"`
+   */
+  name: string;
+}
+
+/**
+ * Metadata for a heat map series X-axis. Right now this axis is always time.
+ */
+interface HeatMapSeriesXAxisMeta extends NamedMeta, BoundedMeta, BucketedMeta {}
+
+/**
+ * Metadata for a heat map series Y axis. Right now this is the only axis that is configurable by the user, so it returns the value type and unit.
+ */
+interface HeatMapSeriesYAxisMeta extends NamedMeta, BoundedMeta, BucketedMeta {
+  /**
+   * The type of the values (e.g., "duration", "number")
+   */
+  valueType: HeatMapValueType;
+  /**
+   * The unit of the values, if applicable.
+   */
+  valueUnit: DataUnit | null;
+}
+
+/**
+ * Metadata for a heat map series Z axis. Right now this is always a count.
+ */
+interface HeatMapSeriesZAxisMeta extends NamedMeta, BoundedMeta {}
+
+/**
+ * Metadata for a heat map series.
+ */
+interface HeatMapSeriesMeta {
+  xAxis: HeatMapSeriesXAxisMeta;
+  yAxis: HeatMapSeriesYAxisMeta;
+  zAxis: HeatMapSeriesZAxisMeta;
+}
+
+/**
+ * A heat map data series for heat map visualizations.
+ */
+export interface HeatMapSeries {
+  /**
+   * Metadata about the series.
+   */
+  meta: HeatMapSeriesMeta;
+  /**
+   * The data points in this series.
+   */
+  values: HeatMapItem[];
+  /**
+   * Represents the grouping information for the series, if applicable.
+   */
+  groupBy?: CategoricalGroupBy[] | null;
+}