feature: add timeout feature

[Gemorroj]

#620
usage (see tests/PackerTest.php testTimeoutException):

$packer = new Packer();
$packer->setTimeoutChecker(new DefaultTimeoutChecker(3.0));

for ($i = 0; $i < 100; ++$i) {
    $box = new TestBox(
        reference: 'box ' . $i,
        outerWidth: $i * 10,
        outerLength: $i * 10,
        outerDepth: $i * 10,
        emptyWeight: 1,
        innerWidth: $i * 10,
        innerLength: $i * 10,
        innerDepth: $i * 10,
        maxWeight: 10000
    );
    $packer->addBox($box);
}

$item = new TestItem(
    description: 'item 1',
    width: 100,
    length: 100,
    depth: 100,
    weight: 100,
    allowedRotation: Rotation::BestFit
);
$packer->addItem($item, 500);

// throw the TimeoutException
$packer->pack();

[Gemorroj]

@dvdoug hi. any chanses to approve this PR?

[dvdoug]

You've got a failing build there, I'll take a look once it's all passing 👍

[Gemorroj]

@dvdoug look https://github.com/dvdoug/BoxPacker/actions/runs/12469175365/job/34801790112 its not the PR problem.

[dvdoug]

It's failing on the code style checker you can see also see it on the Files changed view. You can run vendor/bin/php-cs-fixer fix

[Gemorroj]

@dvdoug ok. fixed it. sorry