feat(input_schema): Add enumSuggestedValues property to input schema

[mfori]

Solves https://github.com/apify/apify-core/issues/24101 - adds support for enumSuggestedValues property, that can be used instead of enum and it:

• wouldn't trigger enum validation, value can be anything
• would be used only on FE to render select which would accept inserting custom value

I put this to stringProperty, accepting now select editor (only if enumSuggestedValues is specified), because it supports also other validation keywords (pattern,...) which makes totally sense to put another constraints on the custom value. (But there's no reason to allow these additional validation keywords when using enum.)

Other things works still the same

• enum can be defined only if editor is not defined or is select
• enumSuggestedValues can be defined only if editor is select.
• only one of enum or enumSuggestedValues can (must) be defined if editor is select
• it works the same for arrays

Draft with changes to make this work in UI is ready here: https://github.com/apify/apify-core/pull/24164

[Copilot]

Pull Request Overview

This PR adds support for the enumSuggestedValues property to input schemas, providing an alternative to enum that allows custom values while providing UI suggestions.

Key changes:

• Added enumSuggestedValues property that acts as UI hints without enforcing validation
• Extended stringProperty and subSchemaStringProperty to support editor: 'select' with enumSuggestedValues
• Updated arrayItemsSelect to support either enum or enumSuggestedValues (mutually exclusive)
• Comprehensive test coverage for both string and array properties with various edge cases

Reviewed Changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 4 comments.

File	Description
test/input_schema.test.ts	Added 13 comprehensive test cases covering enumSuggestedValues usage with string and array properties, validation of mutual exclusivity with enum, and editor requirements
packages/json_schemas/schemas/input.schema.json	Added select editor support to stringProperty and subSchemaStringProperty with conditional enumSuggestedValues requirement; updated arrayItemsSelect to use oneOf for enum/enumSuggestedValues exclusivity; reordered editor enums consistently
packages/input_schema/src/types.ts	Added enumSuggestedValues property to StringFieldDefinition type

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.