version: "1.0.1" name: create-composite description: Generates Composite pattern for PHP 8.4. Creates tree structures with uniform treatment of individual and composite objects. Includes unit tests.

Composite Pattern Generator

Creates Composite pattern infrastructure for treating individual objects and compositions uniformly.

When to Use

Component Characteristics

Component Interface

• Defines operations for all objects
• Shared by leaf and composite
• Enables uniform treatment

Leaf

• Represents individual object
• No children
• Implements component operations

Composite

• Contains children (leaf or composite)
• Delegates operations to children
• Implements component operations

Generation Process

Step 1: Generate Component Interface

Path: src/Domain/{BoundedContext}/

1. {Name}Interface.php — Operations contract

Step 2: Generate Leaf

Path: src/Domain/{BoundedContext}/

1. {Name}Leaf.php — Individual object

Step 3: Generate Composite

Path: src/Domain/{BoundedContext}/

1. {Name}Composite.php — Container for children

Step 4: Generate Tests

1. {ClassName}Test.php — Component behavior verification

File Placement

Naming Conventions

Quick Template Reference

Component Interface

interface {Name}Interface
{
    public function {operation}(): {returnType};
}

Leaf

final readonly class {Name} implements {Name}Interface
{
    public function {operation}(): {returnType}
    {
        return {leafBehavior};
    }
}

Composite

final class {Name}Composite implements {Name}Interface
{
    private array $children = [];
 
    public function add({Name}Interface $child): void
    {
        $this->children[] = $child;
    }
 
    public function {operation}(): {returnType}
    {
        $result = {initialValue};
 
        foreach ($this->children as $child) {
            $result {combineOperation} $child->{operation}();
        }
 
        return $result;
    }
}

Usage Example

$menu = new MenuComposite('Products');
$menu->add(new MenuItem('Laptops'));
 
$submenu = new MenuComposite('Accessories');
$submenu->add(new MenuItem('Mouse'));
$submenu->add(new MenuItem('Keyboard'));
 
$menu->add($submenu);
 
// Uniform treatment
$menu->render();

Common Composites

Anti-patterns to Avoid

References

For complete PHP templates and examples, see:

• references/templates.md — Component interface, leaf, composite templates
• references/examples.md — Menu, permission, price rule composites with unit tests