// Copyright 2024 The Go Authors. All rights reserved.
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.

// Package fillswitch identifies switches with missing cases.
//
// It reports a diagnostic for each type switch or 'enum' switch that
// has missing cases, and suggests a fix to fill them in.
//
// The possible cases are: for a type switch, each accessible named
// type T or pointer *T that is assignable to the interface type; and
// for an 'enum' switch, each accessible named constant of the same
// type as the switch value.
//
// For an 'enum' switch, it will suggest cases for all possible values of the
// type.
//
//	type Suit int8
//	const (
//		 Spades Suit = iota
//		 Hearts
//		 Diamonds
//		 Clubs
//	)
//
//	var s Suit
//	switch s {
//	case Spades:
//	}
//
// It will report a diagnostic with a suggested fix to fill in the remaining
// cases:
//
//	var s Suit
//	switch s {
//	case Spades:
//	case Hearts:
//	case Diamonds:
//	case Clubs:
//	default:
//		 panic(fmt.Sprintf("unexpected Suit: %v", s))
//	}
//
// For a type switch, it will suggest cases for all types that implement the
// interface.
//
//	var stmt ast.Stmt
//	switch stmt.(type) {
//	case *ast.IfStmt:
//	}
//
// It will report a diagnostic with a suggested fix to fill in the remaining
// cases:
//
//	var stmt ast.Stmt
//	switch stmt.(type) {
//	case *ast.IfStmt:
//	case *ast.ForStmt:
//	case *ast.RangeStmt:
//	case *ast.AssignStmt:
//	case *ast.GoStmt:
//	...
//	default:
//		 panic(fmt.Sprintf("unexpected ast.Stmt: %T", stmt))
//	}
package fillswitch