Function appendKnownFieldValidValuesHint

pkg/parser/schema_errors.go:353–370

appendKnownFieldValidValuesHint appends a "Valid values: …" hint, "Did you mean?" suggestions, and a documentation link to message when the jsonPath matches a well-known field and the message is an unknown-property error. It returns the message unchanged for unknown paths or non-additional-propertie

(message string, jsonPath string)

// It returns the message unchanged for unknown paths or non-additional-properties messages.
// The second return value is true if a hint was actually appended to the message.
func appendKnownFieldValidValuesHint(message string, jsonPath string) (string, bool) {
	// Use truncated prefix "unknown propert" to match both singular ("Unknown property")
	// and plural ("Unknown properties") forms produced by rewriteAdditionalPropertiesError.
	if !strings.Contains(strings.ToLower(message), "unknown propert") {
		return message, false
	}
	schemaErrorsLog.Printf("Appending known field hint for path: %s", jsonPath)

	hint, scopes, docsURL, hintOK := knownFieldHintForPath(jsonPath)
	if !hintOK {
		return message, false
	}

	result := message + " (" + hint + ")"
	result = appendKnownFieldSuggestions(result, message, scopes)
	result = appendKnownFieldDocsURL(result, docsURL)
	return result, true
}

func knownFieldHintForPath(jsonPath string) (string, []string, string, bool) {
	if hint, ok := knownFieldValidValues[jsonPath]; ok {