From 307cda30735caf8f47aaca967ecf8410c05a16c6 Mon Sep 17 00:00:00 2001
From: Oleksii <oleksii.druzhchenko@gmail.com>
Date: Mon, 4 Dec 2023 14:34:44 +0200
Subject: [PATCH 1/7] ~mv reversal to template class

---
 src/Spinner/Core/Palette/A/ACharPalette.php  | 13 +-------
 src/Spinner/Core/Palette/A/AStylePalette.php |  4 ++-
 src/Spinner/Core/Palette/PaletteTemplate.php | 14 +++++++++
 src/Spinner/Core/Palette/Rainbow.php         | 32 ++------------------
 4 files changed, 20 insertions(+), 43 deletions(-)

diff --git a/src/Spinner/Core/Palette/A/ACharPalette.php b/src/Spinner/Core/Palette/A/ACharPalette.php
index 537c6e93..609020c5 100644
--- a/src/Spinner/Core/Palette/A/ACharPalette.php
+++ b/src/Spinner/Core/Palette/A/ACharPalette.php
@@ -19,22 +19,11 @@ abstract class ACharPalette extends APalette implements ICharPalette
     protected function getEntries(?IPaletteMode $mode = null): Traversable
     {
         /** @var string $element */
-        foreach ($this->getSequence() as $element) {
+        foreach ($this->sequence() as $element) {
             yield $this->createFrame($element);
         }
     }
 
-    protected function getSequence(): Traversable
-    {
-        $sequence = $this->sequence();
-
-        if ($this->options->getReversed()) {
-            $sequence = array_reverse(iterator_to_array($sequence));
-        }
-
-        yield from $sequence;
-    }
-
     /**
      * @return Traversable<string>
      */
diff --git a/src/Spinner/Core/Palette/A/AStylePalette.php b/src/Spinner/Core/Palette/A/AStylePalette.php
index 80f78900..8bfc89d4 100644
--- a/src/Spinner/Core/Palette/A/AStylePalette.php
+++ b/src/Spinner/Core/Palette/A/AStylePalette.php
@@ -17,9 +17,11 @@ abstract class AStylePalette extends APalette implements IStylePalette
 {
     protected function getOptions(?IPaletteMode $mode = null): IPaletteOptions
     {
+        $interval = $this->options->getInterval() ?? $this->getInterval($this->extractStylingMode($mode));
+
         $this->options =
             new PaletteOptions(
-                interval: $this->options->getInterval() ?? $this->getInterval($this->extractStylingMode($mode)),
+                interval: $interval,
                 reversed: $this->options->getReversed(),
             );
 
diff --git a/src/Spinner/Core/Palette/PaletteTemplate.php b/src/Spinner/Core/Palette/PaletteTemplate.php
index ed24fc4a..79243583 100644
--- a/src/Spinner/Core/Palette/PaletteTemplate.php
+++ b/src/Spinner/Core/Palette/PaletteTemplate.php
@@ -29,6 +29,9 @@ public function __construct(
      */
     public function getEntries(): Traversable
     {
+        if ($this->options->getReversed()) {
+            return $this->reversed($this->entries);
+        }
         return $this->entries;
     }
 
@@ -36,4 +39,15 @@ public function getOptions(): IPaletteOptions
     {
         return $this->options;
     }
+
+    private function reversed(Traversable $entries): Traversable
+    {
+        $sequence = [];
+
+        foreach ($entries as $entry) {
+            $sequence[] = $entry;
+        }
+
+        yield from array_reverse($sequence);
+    }
 }
diff --git a/src/Spinner/Core/Palette/Rainbow.php b/src/Spinner/Core/Palette/Rainbow.php
index c7b461c1..02dd82da 100644
--- a/src/Spinner/Core/Palette/Rainbow.php
+++ b/src/Spinner/Core/Palette/Rainbow.php
@@ -28,14 +28,8 @@ protected function ansi4StyleFrames(): Traversable
      */
     protected function ansi8StyleFrames(): Traversable
     {
-        $sequence = $this->ansi8Sequence();
-
-        if ($this->options->getReversed()) {
-            $sequence = $this->reverseSequence($sequence);
-        }
-
         /** @var string $item */
-        foreach ($sequence as $item) {
+        foreach ($this->ansi8Sequence() as $item) {
             $element = sprintf("\e[38;5;%sm%%s\e[39m", $item);
             yield $this->createFrame($element);
         }
@@ -79,35 +73,13 @@ private function ansi8Sequence(): Traversable
         ];
     }
 
-    /**
-     * @param Traversable<string> $sequence
-     *
-     * @return iterable<string>
-     */
-    private function reverseSequence(Traversable $sequence): iterable
-    {
-        /** @var array<string> $s */
-        $s = [];
-        /** @var string $item */
-        foreach ($sequence as $item) {
-            $s[] = $item;
-        }
-        return array_reverse($s);
-    }
-
     /**
      * @return Traversable<IStyleFrame>
      */
     protected function ansi24StyleFrames(): Traversable
     {
-        $sequence = $this->ansi24Sequence();
-
-        if ($this->options->getReversed()) {
-            $sequence = $this->reverseSequence($sequence);
-        }
-
         /** @var string $item */
-        foreach ($sequence as $item) {
+        foreach ($this->ansi24Sequence() as $item) {
             $element = sprintf("\e[38;2;%sm%%s\e[39m", $item);
             yield $this->createFrame($element);
         }

From 8ee0620be4e754baa4b629639cdd060b40382e89 Mon Sep 17 00:00:00 2001
From: Oleksii <oleksii.druzhchenko@gmail.com>
Date: Mon, 4 Dec 2023 15:50:34 +0200
Subject: [PATCH 2/7] ~doc

---
 doc/usage.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/usage.md b/doc/usage.md
index e5a765cd..64f8dfb0 100644
--- a/doc/usage.md
+++ b/doc/usage.md
@@ -24,7 +24,7 @@ $driver = \AlecRabbit\Spinner\Facade::getDriver();
 
 while (true) {
     $driver->render();
-    usleep(100000);
+    // do some work 
 }
 ```
 

From a048e2af624b2fa09518d79690c3a89024389aba Mon Sep 17 00:00:00 2001
From: Oleksii <oleksii.druzhchenko@gmail.com>
Date: Mon, 4 Dec 2023 15:52:42 +0200
Subject: [PATCH 3/7] ~doc

---
 doc/usage.md | 10 ++--------
 1 file changed, 2 insertions(+), 8 deletions(-)

diff --git a/doc/usage.md b/doc/usage.md
index 64f8dfb0..b57e2775 100644
--- a/doc/usage.md
+++ b/doc/usage.md
@@ -49,13 +49,7 @@ class Dots extends ACharPalette {
     protected function sequence(): Traversable
     {
         // note the width of each element
-        $a = ['   ', '.  ', '.. ', '...', ' ..', '  .', '   ']; 
-
-        if ($this->options->getReversed()) {
-            $a = array_reverse($a);
-        }
-
-        yield from $a;
+        yield from ['   ', '.  ', '.. ', '...', ' ..', '  .', '   ']; 
     }
 }
 ```
@@ -67,7 +61,7 @@ class Greeny extends AStylePalette {
     protected function ansi4StyleFrames(): Traversable
     {
         yield from [
-            $this->createFrame("\e[92m%s\e[39m"),
+            $this->createFrame("\e[92m%s\e[39m"), // note the ANSI codes
         ];
     }
 

From 8a7d2bc1c158ab54b51fd2c51131e7d8226e762a Mon Sep 17 00:00:00 2001
From: Oleksii <oleksii.druzhchenko@gmail.com>
Date: Mon, 4 Dec 2023 16:24:53 +0200
Subject: [PATCH 4/7] ~

---
 .tools/.report/.build/coverage.txt            |  4 +--
 .tools/.report/.deptrac/.deptrac.report       |  2 +-
 .tools/.report/.phploc/.src.phploc.report     | 32 +++++++++----------
 .tools/.report/.phploc/.test.phploc.report    | 26 +++++++--------
 src/Spinner/Core/Palette/A/ACharPalette.php   |  8 +++--
 src/Spinner/Core/Palette/A/APalette.php       |  1 +
 src/Spinner/Core/Palette/PaletteTemplate.php  |  4 +++
 .../Unit/Core/Palette/A/ACharPaletteTest.php  | 28 ++++++++++++++++
 .../A/Override/ACharPaletteOverride.php       |  4 +--
 9 files changed, 72 insertions(+), 37 deletions(-)

diff --git a/.tools/.report/.build/coverage.txt b/.tools/.report/.build/coverage.txt
index 2481ad42..883202fd 100644
--- a/.tools/.report/.build/coverage.txt
+++ b/.tools/.report/.build/coverage.txt
@@ -2,6 +2,6 @@
 
 Code Coverage Report Summary: 
   Classes: 100.00% (207/207)  
-  Methods: 100.00% (737/737)  
-  Lines:   100.00% (3718/3718)
+  Methods: 100.00% (736/736)  
+  Lines:   100.00% (3714/3714)
 
diff --git a/.tools/.report/.deptrac/.deptrac.report b/.tools/.report/.deptrac/.deptrac.report
index ec201040..a6748baa 100644
--- a/.tools/.report/.deptrac/.deptrac.report
+++ b/.tools/.report/.deptrac/.deptrac.report
@@ -5,7 +5,7 @@
   Violations           0     
   Skipped violations   0     
   Uncovered            177   
-  Allowed              2543  
+  Allowed              2545  
   Warnings             0     
   Errors               0     
  -------------------- ------ 
diff --git a/.tools/.report/.phploc/.src.phploc.report b/.tools/.report/.phploc/.src.phploc.report
index 0464e897..f4e3b4c2 100644
--- a/.tools/.report/.phploc/.src.phploc.report
+++ b/.tools/.report/.phploc/.src.phploc.report
@@ -4,11 +4,11 @@ Directories                                         77
 Files                                              419
 
 Size
-  Lines of Code (LOC)                            13578
-  Comment Lines of Code (CLOC)                     739 (5.44%)
-  Non-Comment Lines of Code (NCLOC)              12839 (94.56%)
-  Logical Lines of Code (LLOC)                    1419 (10.45%)
-    Classes                                       1318 (92.88%)
+  Lines of Code (LOC)                            13571
+  Comment Lines of Code (CLOC)                     737 (5.43%)
+  Non-Comment Lines of Code (NCLOC)              12834 (94.57%)
+  Logical Lines of Code (LLOC)                    1418 (10.45%)
+    Classes                                       1317 (92.88%)
       Average Class Length                           3
         Minimum Class Length                         0
         Maximum Class Length                        27
@@ -24,7 +24,7 @@ Size
 
 Cyclomatic Complexity
   Average Complexity per LLOC                     0.33
-  Average Complexity per Class                    2.04
+  Average Complexity per Class                    2.03
     Minimum Class Complexity                      1.00
     Maximum Class Complexity                     21.00
   Average Complexity per Method                   1.49
@@ -36,12 +36,12 @@ Dependencies
     Global Constants                                 0 (0.00%)
     Global Variables                                 0 (0.00%)
     Super-Global Variables                           0 (0.00%)
-  Attribute Accesses                               604
-    Non-Static                                     588 (97.35%)
+  Attribute Accesses                               603
+    Non-Static                                     587 (97.35%)
     Static                                          16 (2.65%)
-  Method Calls                                     758
-    Non-Static                                     681 (89.84%)
-    Static                                          77 (10.16%)
+  Method Calls                                     755
+    Non-Static                                     678 (89.80%)
+    Static                                          77 (10.20%)
 
 Structure
   Namespaces                                        77
@@ -52,14 +52,14 @@ Structure
     Concrete Classes                               191 (93.17%)
       Final Classes                                 70 (36.65%)
       Non-Final Classes                            121 (63.35%)
-  Methods                                          968
+  Methods                                          969
     Scope
-      Non-Static Methods                           903 (93.29%)
+      Non-Static Methods                           904 (93.29%)
       Static Methods                                65 (6.71%)
     Visibility
-      Public Methods                               763 (78.82%)
-      Protected Methods                             64 (6.61%)
-      Private Methods                              141 (14.57%)
+      Public Methods                               764 (78.84%)
+      Protected Methods                             64 (6.60%)
+      Private Methods                              141 (14.55%)
   Functions                                         37
     Named Functions                                  7 (18.92%)
     Anonymous Functions                             30 (81.08%)
diff --git a/.tools/.report/.phploc/.test.phploc.report b/.tools/.report/.phploc/.test.phploc.report
index 35029606..db79f496 100644
--- a/.tools/.report/.phploc/.test.phploc.report
+++ b/.tools/.report/.phploc/.test.phploc.report
@@ -4,11 +4,11 @@ Directories                                         74
 Files                                              273
 
 Size
-  Lines of Code (LOC)                            30544
+  Lines of Code (LOC)                            30570
   Comment Lines of Code (CLOC)                     458 (1.50%)
-  Non-Comment Lines of Code (NCLOC)              30086 (98.50%)
-  Logical Lines of Code (LLOC)                    6687 (21.89%)
-    Classes                                       6679 (99.88%)
+  Non-Comment Lines of Code (NCLOC)              30112 (98.50%)
+  Logical Lines of Code (LLOC)                    6698 (21.91%)
+    Classes                                       6690 (99.88%)
       Average Class Length                          24
         Minimum Class Length                         0
         Maximum Class Length                       871
@@ -24,7 +24,7 @@ Size
 
 Cyclomatic Complexity
   Average Complexity per LLOC                     0.07
-  Average Complexity per Class                    2.60
+  Average Complexity per Class                    2.59
     Minimum Class Complexity                      1.00
     Maximum Class Complexity                     16.00
   Average Complexity per Method                   1.26
@@ -39,9 +39,9 @@ Dependencies
   Attribute Accesses                                28
     Non-Static                                      23 (82.14%)
     Static                                           5 (17.86%)
-  Method Calls                                    9132
-    Non-Static                                    5989 (65.58%)
-    Static                                        3143 (34.42%)
+  Method Calls                                    9142
+    Non-Static                                    5994 (65.57%)
+    Static                                        3148 (34.43%)
 
 Structure
   Namespaces                                        74
@@ -52,14 +52,14 @@ Structure
     Concrete Classes                               266 (98.52%)
       Final Classes                                248 (93.23%)
       Non-Final Classes                             18 (6.77%)
-  Methods                                         1724
+  Methods                                         1725
     Scope
-      Non-Static Methods                          1616 (93.74%)
+      Non-Static Methods                          1617 (93.74%)
       Static Methods                               108 (6.26%)
     Visibility
-      Public Methods                              1036 (60.09%)
-      Protected Methods                            313 (18.16%)
-      Private Methods                              375 (21.75%)
+      Public Methods                              1037 (60.12%)
+      Protected Methods                            313 (18.14%)
+      Private Methods                              375 (21.74%)
   Functions                                         90
     Named Functions                                  2 (2.22%)
     Anonymous Functions                             88 (97.78%)
diff --git a/src/Spinner/Core/Palette/A/ACharPalette.php b/src/Spinner/Core/Palette/A/ACharPalette.php
index 609020c5..2b376e71 100644
--- a/src/Spinner/Core/Palette/A/ACharPalette.php
+++ b/src/Spinner/Core/Palette/A/ACharPalette.php
@@ -18,14 +18,18 @@ abstract class ACharPalette extends APalette implements ICharPalette
      */
     protected function getEntries(?IPaletteMode $mode = null): Traversable
     {
-        /** @var string $element */
+        /** @var string|ICharFrame $element */
         foreach ($this->sequence() as $element) {
+            if ($element instanceof ICharFrame) {
+                yield $element;
+                continue;
+            }
             yield $this->createFrame($element);
         }
     }
 
     /**
-     * @return Traversable<string>
+     * @return Traversable<string|ICharFrame>
      */
     abstract protected function sequence(): Traversable;
 
diff --git a/src/Spinner/Core/Palette/A/APalette.php b/src/Spinner/Core/Palette/A/APalette.php
index 35d52b4a..7b17f469 100644
--- a/src/Spinner/Core/Palette/A/APalette.php
+++ b/src/Spinner/Core/Palette/A/APalette.php
@@ -20,6 +20,7 @@ public function __construct(
     ) {
     }
 
+    // FIXME (2023-12-04 16:9) [Alec Rabbit]: extract functionality to PaletteTemplateFactory->create($palette)
     public function getTemplate(?IPaletteMode $mode = null): IPaletteTemplate
     {
         return new PaletteTemplate(
diff --git a/src/Spinner/Core/Palette/PaletteTemplate.php b/src/Spinner/Core/Palette/PaletteTemplate.php
index 79243583..f9f44fd9 100644
--- a/src/Spinner/Core/Palette/PaletteTemplate.php
+++ b/src/Spinner/Core/Palette/PaletteTemplate.php
@@ -40,6 +40,10 @@ public function getOptions(): IPaletteOptions
         return $this->options;
     }
 
+    /**
+     * @param Traversable<IFrame> $entries
+     * @return Traversable<IFrame>
+     */
     private function reversed(Traversable $entries): Traversable
     {
         $sequence = [];
diff --git a/tests/Spinner/Unit/Core/Palette/A/ACharPaletteTest.php b/tests/Spinner/Unit/Core/Palette/A/ACharPaletteTest.php
index 944ed073..7671bc27 100644
--- a/tests/Spinner/Unit/Core/Palette/A/ACharPaletteTest.php
+++ b/tests/Spinner/Unit/Core/Palette/A/ACharPaletteTest.php
@@ -4,6 +4,7 @@
 
 namespace AlecRabbit\Tests\Spinner\Unit\Core\Palette\A;
 
+use AlecRabbit\Spinner\Core\CharFrame;
 use AlecRabbit\Spinner\Core\Palette\Contract\ICharPalette;
 use AlecRabbit\Spinner\Core\Palette\Contract\IPaletteOptions;
 use AlecRabbit\Spinner\Core\Palette\PaletteTemplate;
@@ -85,4 +86,31 @@ public function canGetTemplateTwo(): void
 
         self::assertSame(100, $template->getOptions()->getInterval());
     }
+
+    #[Test]
+    public function canGetTemplateThree(): void
+    {
+        $charFrame = new CharFrame('22', 2);
+
+        $entries = new \ArrayObject(['a', $charFrame, 'b']);
+
+        $options = $this->getPaletteOptionsMock();
+
+        $palette = $this->getTesteeInstance(
+            options: $options,
+            entries: $entries,
+        );
+
+        $template = $palette->getTemplate();
+
+        self::assertInstanceOf(PaletteTemplate::class, $template);
+
+        self::assertSame(100, $template->getOptions()->getInterval());
+
+        $templateEntries = iterator_to_array($template->getEntries());
+
+        self::assertEquals(new CharFrame('a', 1), $templateEntries[0]);
+        self::assertEquals(new CharFrame('b', 1), $templateEntries[2]);
+        self::assertSame($charFrame, $templateEntries[1]);
+    }
 }
diff --git a/tests/Spinner/Unit/Core/Palette/A/Override/ACharPaletteOverride.php b/tests/Spinner/Unit/Core/Palette/A/Override/ACharPaletteOverride.php
index 85fcd19a..4918bf7b 100644
--- a/tests/Spinner/Unit/Core/Palette/A/Override/ACharPaletteOverride.php
+++ b/tests/Spinner/Unit/Core/Palette/A/Override/ACharPaletteOverride.php
@@ -21,9 +21,7 @@ public function __construct(
 
     protected function sequence(): Traversable
     {
-        foreach ($this->entries as $element) {
-            yield $this->createFrame($element);
-        }
+        yield from $this->entries;
     }
 
     protected function createFrame(string $element): ICharFrame

From e54a4e908edc7f209f85670d6876515ae45af305 Mon Sep 17 00:00:00 2001
From: Oleksii <oleksii.druzhchenko@gmail.com>
Date: Mon, 4 Dec 2023 16:33:00 +0200
Subject: [PATCH 5/7] ~

---
 example/async/bootstrap.async.php             |  5 +--
 example/benchmark/container.php               | 34 +++++++---------
 example/benchmark/container.sync.php          |  3 --
 .../Contract/IDefinitionRegistry.php          |  2 +-
 src/Spinner/Container/DefinitionRegistry.php  |  6 ++-
 .../Unit/Container/DefinitionRegistryTest.php | 39 +++++++++++++++++++
 tests/TestCase/ContainerModifyingTestCase.php |  2 +-
 7 files changed, 61 insertions(+), 30 deletions(-)

diff --git a/example/async/bootstrap.async.php b/example/async/bootstrap.async.php
index 626a9d82..d58e1fe4 100644
--- a/example/async/bootstrap.async.php
+++ b/example/async/bootstrap.async.php
@@ -29,10 +29,7 @@ static function (IContainer $container): IDriverLinker {
         },
         IServiceDefinition::SINGLETON,
     ),
-);
-
-// Register driver linker with output factory
-$registry->bind(
+    // Register driver linker decorator factory
     new ServiceDefinition(IDriverLinkerDecoratorFactory::class, DriverLinkerDecoratorFactory::class),
 );
 
diff --git a/example/benchmark/container.php b/example/benchmark/container.php
index 14883390..6852e5d1 100644
--- a/example/benchmark/container.php
+++ b/example/benchmark/container.php
@@ -45,32 +45,28 @@
 
 $registry = DefinitionRegistry::getInstance();
 
-$registry->bind(new ServiceDefinition(ITimer::class, new MicrosecondTimer()));
-$registry->bind(new ServiceDefinition(IDriverProviderFactory::class, BenchmarkingDriverProviderFactory::class));
-$registry->bind(new ServiceDefinition(IResultMaker::class, ResultMaker::class));
-$registry->bind(new ServiceDefinition(IBenchmarkResultsFactory::class, BenchmarkResultsFactory::class));
-$registry->bind(new ServiceDefinition(IBenchmarkingDriverFactory::class, BenchmarkingDriverFactory::class));
-$registry->bind(new ServiceDefinition(IBenchmarkingDriverBuilder::class, BenchmarkingDriverBuilder::class));
-$registry->bind(new ServiceDefinition(IBenchmarkFactory::class, BenchmarkFactory::class));
-$registry->bind(new ServiceDefinition(IMeasurementFactory::class, MeasurementFactory::class));
-$registry->bind(new ServiceDefinition(IStopwatchBuilder::class, StopwatchBuilder::class));
-$registry->bind(new ServiceDefinition(IStopwatchFactory::class, StopwatchFactory::class));
-$registry->bind(new ServiceDefinition(IReportPrinterBuilder::class, ReportPrinterBuilder::class));
-$registry->bind(new ServiceDefinition(IReportFormatter::class, ReportFormatter::class));
-$registry->bind(new ServiceDefinition(IDatetimeFormatter::class, DatetimeFormatter::class));
-$registry->bind(new ServiceDefinition(IResultFormatter::class, ResultFormatter::class));
-$registry->bind(new ServiceDefinition(IKeyFormatter::class, KeyFormatter::class));
-
 $registry->bind(
+    new ServiceDefinition(ITimer::class, new MicrosecondTimer()),
+    new ServiceDefinition(IDriverProviderFactory::class, BenchmarkingDriverProviderFactory::class),
+    new ServiceDefinition(IResultMaker::class, ResultMaker::class),
+    new ServiceDefinition(IBenchmarkResultsFactory::class, BenchmarkResultsFactory::class),
+    new ServiceDefinition(IBenchmarkingDriverFactory::class, BenchmarkingDriverFactory::class),
+    new ServiceDefinition(IBenchmarkingDriverBuilder::class, BenchmarkingDriverBuilder::class),
+    new ServiceDefinition(IBenchmarkFactory::class, BenchmarkFactory::class),
+    new ServiceDefinition(IMeasurementFactory::class, MeasurementFactory::class),
+    new ServiceDefinition(IStopwatchBuilder::class, StopwatchBuilder::class),
+    new ServiceDefinition(IStopwatchFactory::class, StopwatchFactory::class),
+    new ServiceDefinition(IReportPrinterBuilder::class, ReportPrinterBuilder::class),
+    new ServiceDefinition(IReportFormatter::class, ReportFormatter::class),
+    new ServiceDefinition(IDatetimeFormatter::class, DatetimeFormatter::class),
+    new ServiceDefinition(IResultFormatter::class, ResultFormatter::class),
+    new ServiceDefinition(IKeyFormatter::class, KeyFormatter::class),
     new ServiceDefinition(
         IReportPrinter::class,
         static function (ContainerInterface $container): IReportPrinter {
             return $container->get(IReportPrinterFactory::class)->create();
         }
     ),
-);
-
-$registry->bind(
     new ServiceDefinition(
         IReportPrinterFactory::class,
         static function (ContainerInterface $container): IReportPrinterFactory {
diff --git a/example/benchmark/container.sync.php b/example/benchmark/container.sync.php
index 1ce2a127..3498ae33 100644
--- a/example/benchmark/container.sync.php
+++ b/example/benchmark/container.sync.php
@@ -22,9 +22,6 @@ public function write(Traversable $data): void
             }
         }
     ),
-);
-
-$registry->bind(
     new ServiceDefinition(
         IDeltaTimer::class,
         new class() implements IDeltaTimer {
diff --git a/src/Spinner/Container/Contract/IDefinitionRegistry.php b/src/Spinner/Container/Contract/IDefinitionRegistry.php
index a5c2c7e0..06371aa5 100644
--- a/src/Spinner/Container/Contract/IDefinitionRegistry.php
+++ b/src/Spinner/Container/Contract/IDefinitionRegistry.php
@@ -13,5 +13,5 @@ interface IDefinitionRegistry
      */
     public function load(): Traversable;
 
-    public function bind(IServiceDefinition $serviceDefinition): void;
+    public function bind(IServiceDefinition ...$serviceDefinitions): void;
 }
diff --git a/src/Spinner/Container/DefinitionRegistry.php b/src/Spinner/Container/DefinitionRegistry.php
index 45f4aeba..767a3b4b 100644
--- a/src/Spinner/Container/DefinitionRegistry.php
+++ b/src/Spinner/Container/DefinitionRegistry.php
@@ -36,8 +36,10 @@ public function load(): Traversable
         yield from $this->definitions;
     }
 
-    public function bind(IServiceDefinition $serviceDefinition): void
+    public function bind(IServiceDefinition ...$serviceDefinitions): void
     {
-        $this->definitions->offsetSet($serviceDefinition->getId(), $serviceDefinition);
+        foreach ($serviceDefinitions as $serviceDefinition) {
+            $this->definitions->offsetSet($serviceDefinition->getId(), $serviceDefinition);
+        }
     }
 }
diff --git a/tests/Spinner/Unit/Container/DefinitionRegistryTest.php b/tests/Spinner/Unit/Container/DefinitionRegistryTest.php
index ff09577f..273f00df 100644
--- a/tests/Spinner/Unit/Container/DefinitionRegistryTest.php
+++ b/tests/Spinner/Unit/Container/DefinitionRegistryTest.php
@@ -79,6 +79,45 @@ private function getServiceDefinitionMock(): MockObject&IServiceDefinition
         return $this->createMock(IServiceDefinition::class);
     }
 
+    #[Test]
+    public function definitionCanBeBoundAsMultipleParams(): void
+    {
+        $registry = $this->getTesteeInstance();
+
+        $serviceDefinition1 = $this->getServiceDefinitionMock();
+        $serviceDefinition1
+            ->expects(self::once())
+            ->method('getId')
+            ->willReturn('service1')
+        ;
+        $serviceDefinition2 = $this->getServiceDefinitionMock();
+        $serviceDefinition2
+            ->expects(self::once())
+            ->method('getId')
+            ->willReturn('service2')
+        ;
+        $serviceDefinition3 = $this->getServiceDefinitionMock();
+        $serviceDefinition3
+            ->expects(self::once())
+            ->method('getId')
+            ->willReturn('service3')
+        ;
+
+        $registry->bind(
+            $serviceDefinition1,
+            $serviceDefinition2,
+            $serviceDefinition3
+        );
+
+        $definitions = iterator_to_array($registry->load());
+
+        self::assertCount(3, $definitions);
+
+        self::assertSame($serviceDefinition1, $definitions['service1']);
+        self::assertSame($serviceDefinition2, $definitions['service2']);
+        self::assertSame($serviceDefinition3, $definitions['service3']);
+    }
+
     #[Test]
     public function definitionCanBeOverridden(): void
     {
diff --git a/tests/TestCase/ContainerModifyingTestCase.php b/tests/TestCase/ContainerModifyingTestCase.php
index 2e3e72ce..9d16f872 100644
--- a/tests/TestCase/ContainerModifyingTestCase.php
+++ b/tests/TestCase/ContainerModifyingTestCase.php
@@ -64,7 +64,7 @@ public function load(): Traversable
                 return $this->definitions;
             }
 
-            public function bind(IServiceDefinition $serviceDefinition): void
+            public function bind(IServiceDefinition ...$serviceDefinitions): void
             {
                 // do nothing
             }

From c36dd3b1870bda1d1a20013ac3dabed3a2e2d1ab Mon Sep 17 00:00:00 2001
From: Oleksii <oleksii.druzhchenko@gmail.com>
Date: Mon, 4 Dec 2023 16:46:58 +0200
Subject: [PATCH 6/7] ~

---
 .tools/.report/.build/coverage.txt         |  2 +-
 .tools/.report/.phploc/.src.phploc.report  |  6 +++---
 .tools/.report/.phploc/.test.phploc.report | 24 +++++++++++-----------
 3 files changed, 16 insertions(+), 16 deletions(-)

diff --git a/.tools/.report/.build/coverage.txt b/.tools/.report/.build/coverage.txt
index 883202fd..b7f73b28 100644
--- a/.tools/.report/.build/coverage.txt
+++ b/.tools/.report/.build/coverage.txt
@@ -3,5 +3,5 @@
 Code Coverage Report Summary: 
   Classes: 100.00% (207/207)  
   Methods: 100.00% (736/736)  
-  Lines:   100.00% (3714/3714)
+  Lines:   100.00% (3715/3715)
 
diff --git a/.tools/.report/.phploc/.src.phploc.report b/.tools/.report/.phploc/.src.phploc.report
index f4e3b4c2..3d9b3670 100644
--- a/.tools/.report/.phploc/.src.phploc.report
+++ b/.tools/.report/.phploc/.src.phploc.report
@@ -4,9 +4,9 @@ Directories                                         77
 Files                                              419
 
 Size
-  Lines of Code (LOC)                            13571
+  Lines of Code (LOC)                            13573
   Comment Lines of Code (CLOC)                     737 (5.43%)
-  Non-Comment Lines of Code (NCLOC)              12834 (94.57%)
+  Non-Comment Lines of Code (NCLOC)              12836 (94.57%)
   Logical Lines of Code (LLOC)                    1418 (10.45%)
     Classes                                       1317 (92.88%)
       Average Class Length                           3
@@ -24,7 +24,7 @@ Size
 
 Cyclomatic Complexity
   Average Complexity per LLOC                     0.33
-  Average Complexity per Class                    2.03
+  Average Complexity per Class                    2.04
     Minimum Class Complexity                      1.00
     Maximum Class Complexity                     21.00
   Average Complexity per Method                   1.49
diff --git a/.tools/.report/.phploc/.test.phploc.report b/.tools/.report/.phploc/.test.phploc.report
index db79f496..085b84a6 100644
--- a/.tools/.report/.phploc/.test.phploc.report
+++ b/.tools/.report/.phploc/.test.phploc.report
@@ -4,11 +4,11 @@ Directories                                         74
 Files                                              273
 
 Size
-  Lines of Code (LOC)                            30570
+  Lines of Code (LOC)                            30609
   Comment Lines of Code (CLOC)                     458 (1.50%)
-  Non-Comment Lines of Code (NCLOC)              30112 (98.50%)
-  Logical Lines of Code (LLOC)                    6698 (21.91%)
-    Classes                                       6690 (99.88%)
+  Non-Comment Lines of Code (NCLOC)              30151 (98.50%)
+  Logical Lines of Code (LLOC)                    6711 (21.92%)
+    Classes                                       6703 (99.88%)
       Average Class Length                          24
         Minimum Class Length                         0
         Maximum Class Length                       871
@@ -39,9 +39,9 @@ Dependencies
   Attribute Accesses                                28
     Non-Static                                      23 (82.14%)
     Static                                           5 (17.86%)
-  Method Calls                                    9142
-    Non-Static                                    5994 (65.57%)
-    Static                                        3148 (34.43%)
+  Method Calls                                    9164
+    Non-Static                                    6009 (65.57%)
+    Static                                        3155 (34.43%)
 
 Structure
   Namespaces                                        74
@@ -52,14 +52,14 @@ Structure
     Concrete Classes                               266 (98.52%)
       Final Classes                                248 (93.23%)
       Non-Final Classes                             18 (6.77%)
-  Methods                                         1725
+  Methods                                         1726
     Scope
-      Non-Static Methods                          1617 (93.74%)
+      Non-Static Methods                          1618 (93.74%)
       Static Methods                               108 (6.26%)
     Visibility
-      Public Methods                              1037 (60.12%)
-      Protected Methods                            313 (18.14%)
-      Private Methods                              375 (21.74%)
+      Public Methods                              1038 (60.14%)
+      Protected Methods                            313 (18.13%)
+      Private Methods                              375 (21.73%)
   Functions                                         90
     Named Functions                                  2 (2.22%)
     Anonymous Functions                             88 (97.78%)

From 02c12db7d753fefc771e769f42f34cc0c749f8e1 Mon Sep 17 00:00:00 2001
From: Oleksii <oleksii.druzhchenko@gmail.com>
Date: Mon, 4 Dec 2023 16:50:39 +0200
Subject: [PATCH 7/7] ~fix test when pcntl is not available

---
 .../Spinner/Complex/Config/SignalHandlingModeConfigTest.php | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/tests/Spinner/Complex/Config/SignalHandlingModeConfigTest.php b/tests/Spinner/Complex/Config/SignalHandlingModeConfigTest.php
index 3bede944..ea0b5a19 100644
--- a/tests/Spinner/Complex/Config/SignalHandlingModeConfigTest.php
+++ b/tests/Spinner/Complex/Config/SignalHandlingModeConfigTest.php
@@ -49,7 +49,11 @@ public function canSetLoopSignalHandlingOptionEnabled(): void
         /** @var ILoopConfig $loopConfig */
         $loopConfig = self::getRequiredConfig(ILoopConfig::class);
 
-        self::assertSame(SignalHandlingMode::ENABLED, $loopConfig->getSignalHandlingMode());
+        if (function_exists('pcntl_signal')) {
+            self::assertSame(SignalHandlingMode::ENABLED, $loopConfig->getSignalHandlingMode());
+        } else {
+            self::assertSame(SignalHandlingMode::DISABLED, $loopConfig->getSignalHandlingMode());
+        }
     }
 
     #[Test]