README

Laravel-first package that makes the PHP Standard Library (PSL) feel natural inside Laravel applications.

Status

Current v1 implementation includes:

• explicit bridge utilities for vec, dict, and Collection conversion
• opt-in list-safe Collection macros
• helper-driven typed coercion built on Psl\Type
• Laravel-friendly coercion exception wrapping
• PHPUnit and Testbench coverage

Requirements

• PHP 8.4+
• Laravel 13.x
• PSL 6.x

Installation

composer require entrepeneur4lyf/laravel-psl

Laravel package discovery registers the service provider automatically.

Configuration

Publish the config if you want to change runtime behavior:

php artisan vendor:publish --tag=laravel-psl-config

Current config:

return [
    'features' => [
        'collection_macros' => true,
    ],
];

Bridge Utilities

Use LaravelPsl\Support\PslBridge when you want explicit conversions between Laravel Collections and PSL-style array semantics.

use LaravelPsl\Support\PslBridge;

$collection = collect([
    'name' => 'Taylor',
    2 => 'Laravel',
]);

$vec = PslBridge::toVec($collection);
// ['Taylor', 'Laravel']

$dict = PslBridge::toDict($collection);
// ['name' => 'Taylor', 2 => 'Laravel']

$backToCollection = PslBridge::toCollection($dict);
// Collection(['name' => 'Taylor', 2 => 'Laravel'])

Bridge semantics:

• toVec() intentionally reindexes values.
• toDict() intentionally preserves runtime keys.
• Mixed array-key dictionaries are supported as PHP represents them at runtime.

Collection Macros

When features.collection_macros is enabled, these macros are registered on Illuminate\Support\Collection:

• pmap
• pfilter
• preduce
• pchunk
• psort
• ptoVec
• ptoDict

Example:

$users = collect($payload['users'])
    ->pfilter(fn (array $user): bool => $user['active'] ?? false)
    ->pmap(fn (array $user): array => [
        'email' => strtolower($user['email']),
        'name' => trim($user['name']),
    ]);

Macro semantics:

• pmap, pfilter, pchunk, and psort are list-safe operations.
• List-safe operations reindex values by design.
• preduce is terminal and returns the final accumulator.
• preduce always requires an explicit initial value.
• psort returns a reindexed Collection sorted by values.
• ptoVec() returns a plain list.
• ptoDict() returns a plain key-preserving array.

Examples:

$sum = collect(['a' => 1, 'b' => 2, 'c' => 3])
    ->preduce(fn (int $carry, int $value): int => $carry + $value, 0);
// 6

$sorted = collect(['c' => 3, 'a' => 1, 'b' => 2])->psort();
// Collection([1, 2, 3])

$vec = collect(['name' => 'Taylor', 2 => 'Laravel'])->ptoVec();
// ['Taylor', 'Laravel']

$dict = collect(['name' => 'Taylor', 2 => 'Laravel'])->ptoDict();
// ['name' => 'Taylor', 2 => 'Laravel']

Typed Coercion

Use LaravelPsl\Type\Coerce as a thin wrapper around Psl\Type.

use LaravelPsl\Type\Coerce;
use Psl\Type;

$user = Coerce::value(
    Type\shape([
        'name' => Type\non_empty_string(),
        'roles' => Type\vec(Type\string()),
    ]),
    $payload,
);

On failure, the package throws LaravelPsl\Exceptions\CoercionException and preserves the original Psl\Type\Exception\CoercionException as previous.

Usage Examples

Controller

use LaravelPsl\Type\Coerce;
use Psl\Type;

$input = Coerce::value(
    Type\shape([
        'email' => Type\non_empty_string(),
        'roles' => Type\vec(Type\string()),
    ]),
    $request->all(),
    ['source' => 'request', 'field' => 'user'],
);

Service

use LaravelPsl\Support\PslBridge;

$emails = PslBridge::toVec($users->pluck('email'));

Job

use LaravelPsl\Type\Coerce;
use Psl\Type;

$payload = Coerce::value(
    Type\shape([
        'user_id' => Type\positive_int(),
        'tags' => Type\vec(Type\string()),
    ]),
    $this->payload,
    ['source' => 'job', 'job' => static::class],
);

Command

$names = collect($this->argument('names'))
    ->pfilter()
    ->psort()
    ->ptoVec();

Disabled-Feature Behavior

If features.collection_macros is false:

• Collection macros are not registered.
• PslBridge remains available.
• Coerce remains available.

Out of Scope for V1

• dict-aware transform macros
• Form Request integration for coercion
• string adapters
• runtime-aware concurrency integration

Development

composer install
vendor/bin/phpunit

Auto-discovery smoke test:

composer test:discovery:install
composer test:discovery

See prd.md for the product definition and implementation-plan.md for the execution checklist.