Function normalizeChartSpec

packages/core/src/chart/index.ts:139–172

(raw: unknown)

}

export function normalizeChartSpec(raw: unknown): ChartSpec {
  if (!isRecord(raw)) throw new ChartValidationError('chartSpec must be an object')
  if (raw.version !== 1) throw new ChartValidationError('chartSpec.version must be 1')
  if (typeof raw.type !== 'string' || !CHART_TYPES.has(raw.type as ChartType)) {
    throw new ChartValidationError('chartSpec.type must be one of: bar, line, pie, heatmap')
  }
  if (typeof raw.title !== 'string' || raw.title.trim().length === 0) {
    throw new ChartValidationError('chartSpec.title must be a non-empty string')
  }
  if (!isRecord(raw.encoding)) throw new ChartValidationError('chartSpec.encoding must be an object')

  const spec = raw as unknown as ChartSpec
  switch (spec.type) {
    case 'bar':
    case 'line':
      asFieldName(spec.encoding.x, 'encoding.x')
      asFieldName(spec.encoding.y, 'encoding.y')
      break
    case 'pie':
      asFieldName(spec.encoding.label, 'encoding.label')
      asFieldName(spec.encoding.value, 'encoding.value')
      break
    case 'heatmap':
      asFieldName(spec.encoding.x, 'encoding.x')
      asFieldName(spec.encoding.y, 'encoding.y')
      asFieldName(spec.encoding.value, 'encoding.value')
      break
  }

  return {
    ...spec,
    title: spec.title.trim(),
  }
}

export function inferChartDataset(rows: Record<string, unknown>[], declaredFields?: ChartField[]): ChartDataset {
  const declared = new Map((declaredFields ?? []).map((field) => [field.name, field]))