parsers

type ParsedPathContent struct {
	Method, Path, ID string
	Tags             []string
	Remaining        *ast.CommentGroup

	// Pos is the position of the matched route/operation annotation
	// line (the comment group's start). Used to anchor diagnostics
	// such as the stripped-regex warning.
	// Pos is the (coarse) source position of the matched route/operation annotation line — the comment's Slash.
	//
	// Used as:
	// - anchor for diagnostics, such as the stripped-regex warning.
	// - the cross-ref anchor for the /paths/{path}/{method} node. Invalid when no annotation matched.
	Pos token.Pos

	// StrippedParams names the path parameters whose inline regex
	// constraint (gorilla/chi style, e.g. `{id:[0-9]+}`) was stripped
	// to the bare `{id}` template form. OpenAPI 2.0 path templating
	// supports only RFC 6570 URI Template Level-1 expansion (simple
	// `{var}` substitution), so any `:regex` constraint is dropped and
	// surfaced to the author by the route/operation builder.
	StrippedParams []string
}