switon/dict

Controlled value-set types for actions, validated inputs, and shared option rows for Switon Framework

v1.0.0 2026-06-06 13:43 UTC

Requires

• php: >=8.3
• switon/binding: ^1.0
• switon/core: ^1.0
• switon/validation: ^1.0

Requires (Dev)

• phpstan/extension-installer: ^1.4
• phpstan/phpstan: ^2.0
• switon/testing: ^1.0

MIT

• switon

• validation
• dictionary
• switon
• valuesets

README

Switon's dict boundary for typed action parameters and property values.

Highlights

• Type-based lookup: each dict class picks its own item set.
• Input mapping: routed input can become typed dict values.
• Fallback values: empty input can fall back to the type's default item.
• Validated values: scalar input can resolve to stored dict values through validation.
• Framework wiring: validator templates are bundled for app use.

Installation

composer require switon/dict

Quick Start

use Switon\Dict\Dict;
use Switon\Dict\Attribute\DictValue;

final class OrderStatus extends Dict
{
    public static function typeCode(): ?string
    {
        return 'order.status';
    }
}

final class OrderController
{
    public function updateAction(OrderStatus $status): void
    {
        $code = $status->getItemCode();
        $label = $status->getItemName();
        $value = $status->getValue();
    }
}

Docs: https://docs.switon.dev/latest/dict

License

MIT.