http

type ChiOption func(*chiRouter)

type Middleware func(http.Handler) http.Handler

type RouteFilters struct {
	Method string
	Path   string
	SortBy string
}

type RouteInfo struct {
	Method      string
	Path        string
	Handler     string
	Middlewares []string
}

type RouteStats struct {
	Total   int
	Methods map[string]int
	Routes  []RouteInfo
}

type Router interface {
	// HTTP method handlers with optional route-specific middleware.
	// Middleware is applied in order: first middleware wraps outermost.
	//
	// Example:
	//   r.GET("/", handler)                                    // No middleware
	//   r.GET("/", handler, authMiddleware)                    // With auth
	//   r.GET("/", handler, authMiddleware, loggingMiddleware) // Multiple
	GET(path string, handler http.HandlerFunc, middlewares ...Middleware)
	POST(path string, handler http.HandlerFunc, middlewares ...Middleware)
	PUT(path string, handler http.HandlerFunc, middlewares ...Middleware)
	PATCH(path string, handler http.HandlerFunc, middlewares ...Middleware)
	DELETE(path string, handler http.HandlerFunc, middlewares ...Middleware)

	// Group creates a new route group with prefix and optional middleware.
	// Group middleware applies to all routes within the group.
	Group(prefix string, fn func(Router), middlewares ...Middleware)

	// Use adds middleware to the router (applies to all subsequent routes)
	Use(middlewares ...Middleware)

	// With returns a new Router with the given middleware applied.
	// Prefer using inline middleware in route methods instead.
	With(middlewares ...Middleware) Router

	// Handler returns the http.Handler for use with http.Server
	Handler() http.Handler

	// Walk iterates over all registered routes.
	// The callback receives method, path, and handler for each route.
	Walk(fn func(method, path string, handler http.Handler) error) error
}

type Server struct {
	// contains filtered or unexported fields
}

type ServerOption func(*Server)