Show enum values on hover

[twelvelabs]

Is your enhancement related to a problem? Please describe.

I maintain a JSON Schema document for a YAML config file. That document has a number of ENUMs, and when my users hover over those fields they see the title and description from the schema, but not the allowed values.

The values are shown on autocomplete, but that's much less discoverable that having it displayed on hover w/ the other documentation.

Describe the solution you would like

I would like to see enum options shown underneath the description on hover - much like how example values are displayed:

ENUM TITLE

Some description...


Allowed values:

- `ENUM1`
- `ENUM2`
- `ENUM3`

[twelvelabs]

Digging through the code, it looks like there is some logic to show enums

yaml-language-server/src/languageservice/services/yamlHover.ts

Lines 124 to 137 in ed03cbf

	if (s.schema.enum) {
	const idx = s.schema.enum.indexOf(getNodeValue(node));
	if (s.schema.markdownEnumDescriptions) {
	markdownEnumValueDescription = s.schema.markdownEnumDescriptions[idx];
	} else if (s.schema.enumDescriptions) {
	markdownEnumValueDescription = toMarkdown(s.schema.enumDescriptions[idx]);
	}
	if (markdownEnumValueDescription) {
	enumValue = s.schema.enum[idx];
	if (typeof enumValue !== 'string') {
	enumValue = JSON.stringify(enumValue);
	}
	}
	}

But:

• It requires the use of some non-standard properties (at least according to the JSON Schema spec): markdownEnumDescription, enumDescriptions.
• It only shows info for the currently selected enum - not the full list of available options.

What do y'all think about changing the behavior so that:

• It displays all enum options (maybe truncated to some upper bound w/ a "... plus N more" note).
• Keep the *Descriptions logic, but fall back to just showing the enum sans-description if no descriptions are present.