SV::boolean() / SV::enum() - Boolean and Enum Types

---

SV::boolean()

Validates boolean values. In addition to true / false, also accepts "1" / "0" / "on" / "off" / "yes" / "no" as form input.

SV::boolean()

JSON Schema output:

{ "type": "boolean" }

Use case: Terms of service agreement checkbox, flag input.

$schema = SV::object([
  'agreement' => SV::boolean(),
  'newsletter' => SV::boolean()->optional(),
]);

{
  "properties": {
    "agreement":  { "type": "boolean" },
    "newsletter": { "type": "boolean" }
  },
  "required": ["agreement"]
}

Because HTML <input type="checkbox"> does not submit a value when unchecked, handle it server-side as $_POST['agreement'] ?? ''.

---

SV::enum(values)

Validates that the value is one of the defined choices.

SV::enum(array $values)

Parameter	Type	Description
$values	string[]	Array of allowed strings

JSON Schema output:

{ "type": "string", "enum": ["a", "b", "c"] }

Use case: <select> or radio button choices. Validating categorical values stored in a database.

// Inquiry type
SV::enum(['general', 'support', 'sales', 'other'])

// Optional status selection
SV::enum(['draft', 'published', 'archived'])->optional()

{ "type": "string", "enum": ["general", "support", "sales", "other"] }

Note: Handling empty strings

If a <select> element has a "Please select" option with value="", adding .optional() causes the empty string to skip validation. Do not use .optional() if selection is required.

// Empty string not allowed (selection required)
SV::enum(['general', 'support', 'other'])

// Empty string (no selection) is allowed
SV::enum(['general', 'support', 'other'])->optional()

---

Combination Examples

$schema = SV::object([
  'type'      => SV::enum(['question', 'feedback', 'bug']),
  'priority'  => SV::enum(['low', 'medium', 'high'])->optional(),
  'published' => SV::boolean(),
]);