v4.2.0: Version 4.2.0

Compare Source

What's Changed

• Add support for PHP 8.5 by @​veewee in #​549

Full Changelog: php-standard-library/php-standard-library@4.1.0...4.2.0

v4.1.0: Noise 4.1.0

Compare Source

Psl Noise - 4.1.0

This release introduces two major new data structure components to the PHP Standard Library: Tree and Graph. These additions bring powerful hierarchical and relational data manipulation tools to PHP developers with PSL's signature type-safe API.

What's Changed

• chore: upgrade to mago beta-31 by @​azjezz in #​538
• chore: upgrade to mago beta-32 by @​azjezz in #​539
• feat: add reflection-based type functions for class members by @​azjezz in #​543
• chore: migrate from make to just by @​azjezz in #​544
• chore(ga): bump extractions/setup-just from 2 to 3 by @​dependabot[bot] in #​545
• feat: add Tree component for hierarchical data structures by @​azjezz in #​546
• feat: add Graph component with directed and undirected graph support by @​azjezz in #​547
• chore: add veewee to GitHub sponsors by @​azjezz in #​548

✨ New Features

🌳 Psl\Tree Component

A comprehensive tree data structure implementation for working with hierarchical data.

Features: Immutable tree nodes, functional operations (map, filter, reduce, fold), traversal algorithms (pre-order, post-order, level-order), search utilities, and conversion functions.

use Psl\Tree;

// Create and manipulate trees
$tree = Tree\tree('root', [
    Tree\leaf('child1'),
    Tree\tree('child2', [Tree\leaf('grandchild')]),
]);

// Functional operations
$doubled = Tree\map($tree, fn($x) => $x . '!');
$values = Tree\pre_order($tree); // ['root', 'child1', 'child2', 'grandchild']
$count = Tree\count($tree); // 4

// Build from database records
$tree = Tree\from_list(
    $records,
    fn($r) => $r['id'],
    fn($r) => $r['parent_id'],
    fn($r) => $r['name']
);

Use Cases: File systems, organizational hierarchies, DOM structures, category trees, menu systems.

Full Documentation

🕸️ Psl\Graph Component

A robust graph data structure implementation supporting both directed and undirected graphs with algorithms for analysis and pathfinding.

Features: Immutable graphs, weighted/unweighted edges, BFS/DFS traversal, shortest path (Dijkstra/BFS), topological sorting, cycle detection, flexible node types.

use Psl\Graph;

// Create and traverse graphs
$graph = Graph\directed();
$graph = Graph\add_edge($graph, 'A', 'B');
$graph = Graph\add_edge($graph, 'B', 'C');

$path = Graph\shortest_path($graph, 'A', 'C'); // ['A', 'B', 'C']
$sorted = Graph\topological_sort($graph); // ['A', 'B', 'C']

// Weighted graphs
$graph = Graph\add_edge($graph, 'NYC', 'Boston', 215);
$graph = Graph\add_edge($graph, 'NYC', 'Philadelphia', 95);
$graph = Graph\add_edge($graph, 'Philadelphia', 'Boston', 310);
$route = Graph\shortest_path($graph, 'NYC', 'Boston'); // ['NYC', 'Boston']

// Undirected graphs
$social = Graph\undirected();
$social = Graph\add_edge($social, 'Alice', 'Bob');

Use Cases: Dependency resolution, route finding, social networks, state machines, task scheduling.

Full Documentation

🔍 Reflection-Based Type Functions

New type functions for runtime validation of class members using PHP's reflection API:

• Type\constant_name_of() - Validate constant names
• Type\enum_case_of() - Validate enum case names
• Type\method_name_of() - Validate method names (case-insensitive)
• Type\property_name_of() - Validate property names

Each includes visibility-specific variants (public_*, protected_*, private_*).

use Psl\Type;

Type\method_name_of(MyClass::class)->assert('someMethod');
Type\property_name_of(MyClass::class)->assert('someProperty');
Type\public_constant_name_of(MyClass::class)->assert('SOME_CONSTANT');

Full Documentation

🛠️ Tooling Updates

• Migration to just: Migrated from make to just for improved cross-platform compatibility and developer experience

⬆️ Dependency Updates

• mago updated to 1.0.0-beta.32
• actions/setup-just bumped from v2 to v3
• Various development dependency updates

🤝 Contributors

@​veewee has been added to GitHub sponsors

Full Changelog: 4.0.1...4.1.0

v4.0.1: Noise 4.0.1

Compare Source

What's Changed

• refactor: remove redundant @var tags from constants by @​azjezz in #​533
• chore: remove redundant tags by @​azjezz in #​536
• chore(deps): update dependencies, and fix coding standard issues by @​azjezz in #​537

Full Changelog: php-standard-library/php-standard-library@4.0.0...4.0.1

v4.0.0

Compare Source

breaking changes

• Psl\Result\wrap() no longer unwraps nested results - #​531 by @​azjezz
• Psl\Collection\Map, Psl\Collection\MutableMap, Psl\Collection\Set, and Psl\Collection\MutableSet now have a more natural JSON serialization - #​512 by @​josh-rai
• A large number of intersection interfaces in the Psl\IO and Psl\File namespaces have been removed to simplify the component's hierarchy - #​518 by @​azjezz
• Psl\sequence() function has been removed - #​519 by @​azjezz

features

• feat(type): add container type - #​513 by @​azjezz
• feat(type): add int_range type - #​510 by @​george-steel
• feat(type): add always_assert type - #​522 by @​azjezz
• feat(iter): add search_with_keys_opt and search_with_keys functions - #​490 by @​simon-podlipsky

fixes, and improvements

• refactor: improve type inference for non-empty lists - #​529 by @​azjezz
• refactor: improve type inference for Iter and Regex - #​528 by @​azjezz

other

• chore: migrate from psalm to mago - #​527 by @​azjezz
• chore: replace psalm-specific tags by generic tags - #​531 by @​azjezz