├── LICENSE
├── composer.json
└── src
    └── Spinner
        ├── Asynchronous
            ├── React
            │   ├── ReactLoopAdapter.php
            │   ├── ReactLoopCreator.php
            │   └── ReactLoopProbe.php
            ├── Revolt
            │   ├── RevoltLoopAdapter.php
            │   ├── RevoltLoopCreator.php
            │   └── RevoltLoopProbe.php
            └── bootstrap.php
        ├── Container
            ├── A
            │   └── AContainerEnclosure.php
            ├── Adapter
            │   └── ContainerAdapter.php
            ├── Builder
            │   ├── ServiceBuilder.php
            │   └── ServiceSpawnerBuilder.php
            ├── CircularDependencyDetector.php
            ├── Container.php
            ├── Contract
            │   ├── ICircularDependencyDetector.php
            │   ├── IContainer.php
            │   ├── IContainerFactory.php
            │   ├── IDefinitionRegistry.php
            │   ├── IIsStorableResolver.php
            │   ├── IService.php
            │   ├── IServiceBuilder.php
            │   ├── IServiceDefinition.php
            │   ├── IServiceFactory.php
            │   ├── IServiceSpawner.php
            │   ├── IServiceSpawnerBuilder.php
            │   └── IServiceSpawnerFactory.php
            ├── DefinitionRegistry.php
            ├── Exception
            │   ├── CircularDependencyDetected.php
            │   ├── ClassDoesNotExist.php
            │   ├── ContainerException.php
            │   ├── InvalidDefinitionArgument.php
            │   ├── InvalidOptionsArgument.php
            │   ├── NotFoundInContainer.php
            │   ├── SpawnFailed.php
            │   ├── SpawnerException.php
            │   ├── UnableToCreateInstance.php
            │   └── UnableToExtractType.php
            ├── Factory
            │   ├── ContainerFactory.php
            │   ├── ServiceFactory.php
            │   └── ServiceSpawnerFactory.php
            ├── Service.php
            ├── ServiceDefinition.php
            ├── ServiceIsStorableResolver.php
            └── ServiceSpawner.php
        ├── Contract
            ├── ICreator.php
            ├── IDeltaTimer.php
            ├── IFinalizable.php
            ├── IFrame.php
            ├── IHasEmptyState.php
            ├── IHasFrame.php
            ├── IHasInterval.php
            ├── IHasIsEnabled.php
            ├── IHasNullableInterval.php
            ├── IInitializable.php
            ├── IInterval.php
            ├── INowTimer.php
            ├── IObserver.php
            ├── IProcedure.php
            ├── IRenderable.php
            ├── ISubject.php
            ├── Mode
            │   ├── AutoStartMode.php
            │   ├── CursorVisibilityMode.php
            │   ├── DriverMode.php
            │   ├── InitializationMode.php
            │   ├── LinkerMode.php
            │   ├── NormalizerMode.php
            │   ├── RunMethodMode.php
            │   ├── SignalHandlingMode.php
            │   └── StylingMethodMode.php
            ├── Option
            │   ├── AutoStartOption.php
            │   ├── CursorVisibilityOption.php
            │   ├── DriverOption.php
            │   ├── InitializationOption.php
            │   ├── LinkerOption.php
            │   ├── NormalizerOption.php
            │   ├── RunMethodOption.php
            │   ├── SignalHandlingOption.php
            │   └── StylingMethodOption.php
            ├── Output
            │   ├── IBufferedOutput.php
            │   ├── IOutput.php
            │   └── IWritableStream.php
            ├── Pattern
            │   ├── IPattern.php
            │   └── IProceduralPattern.php
            └── Probe
            │   ├── ISignalHandlingOptionCreator.php
            │   ├── ISignalHandlingProbe.php
            │   ├── IStaticProbe.php
            │   ├── IStylingMethodOptionCreator.php
            │   └── IStylingMethodProbe.php
        ├── Core
            ├── A
            │   ├── ADriver.php
            │   ├── AFrame.php
            │   └── ASubject.php
            ├── Builder
            │   ├── ConsoleCursorBuilder.php
            │   ├── Contract
            │   │   ├── IConsoleCursorBuilder.php
            │   │   ├── IDeltaTimerBuilder.php
            │   │   ├── IIntegerNormalizerBuilder.php
            │   │   ├── ISequenceStateBuilder.php
            │   │   └── ISequenceStateWriterBuilder.php
            │   ├── DeltaTimerBuilder.php
            │   ├── DriverBuilder.php
            │   ├── IntegerNormalizerBuilder.php
            │   ├── SequenceStateBuilder.php
            │   └── SequenceStateWriterBuilder.php
            ├── CharFrame.php
            ├── Config
            │   ├── Builder
            │   │   ├── DriverConfigBuilder.php
            │   │   ├── GeneralConfigBuilder.php
            │   │   ├── LinkerConfigBuilder.php
            │   │   ├── LoopConfigBuilder.php
            │   │   ├── NormalizerConfigBuilder.php
            │   │   ├── OutputConfigBuilder.php
            │   │   ├── RevolverConfigBuilder.php
            │   │   └── WidgetRevolverConfigBuilder.php
            │   ├── Contract
            │   │   ├── Builder
            │   │   │   ├── IDriverConfigBuilder.php
            │   │   │   ├── IGeneralConfigBuilder.php
            │   │   │   ├── ILinkerConfigBuilder.php
            │   │   │   ├── ILoopConfigBuilder.php
            │   │   │   ├── INormalizerConfigBuilder.php
            │   │   │   ├── IOutputConfigBuilder.php
            │   │   │   ├── IRevolverConfigBuilder.php
            │   │   │   └── IWidgetRevolverConfigBuilder.php
            │   │   ├── Detector
            │   │   │   ├── IAutoStartModeDetector.php
            │   │   │   ├── IDriverModeDetector.php
            │   │   │   ├── IInitializationModeDetector.php
            │   │   │   └── ILinkerModeDetector.php
            │   │   ├── Factory
            │   │   │   ├── IDriverConfigFactory.php
            │   │   │   ├── IGeneralConfigFactory.php
            │   │   │   ├── IInitialRootWidgetConfigFactory.php
            │   │   │   ├── IInitialWidgetConfigFactory.php
            │   │   │   ├── ILinkerConfigFactory.php
            │   │   │   ├── ILoopConfigFactory.php
            │   │   │   ├── INormalizerConfigFactory.php
            │   │   │   ├── IOutputConfigFactory.php
            │   │   │   ├── IRevolverConfigFactory.php
            │   │   │   ├── IRootWidgetConfigFactory.php
            │   │   │   └── IWidgetConfigFactory.php
            │   │   ├── IConfigElement.php
            │   │   ├── IDriverConfig.php
            │   │   ├── IGeneralConfig.php
            │   │   ├── ILinkerConfig.php
            │   │   ├── ILoopConfig.php
            │   │   ├── INormalizerConfig.php
            │   │   ├── IOutputConfig.php
            │   │   ├── IRevolverConfig.php
            │   │   ├── IRootWidgetConfig.php
            │   │   ├── IWidgetConfig.php
            │   │   └── IWidgetRevolverConfig.php
            │   ├── Detector
            │   │   ├── AutoStartModeDetector.php
            │   │   ├── DriverModeDetector.php
            │   │   ├── InitializationModeDetector.php
            │   │   └── LinkerModeDetector.php
            │   ├── DriverConfig.php
            │   ├── Factory
            │   │   ├── DriverConfigFactory.php
            │   │   ├── GeneralConfigFactory.php
            │   │   ├── InitialRootWidgetConfigFactory.php
            │   │   ├── InitialWidgetConfigFactory.php
            │   │   ├── LinkerConfigFactory.php
            │   │   ├── LoopConfigFactory.php
            │   │   ├── NormalizerConfigFactory.php
            │   │   ├── OutputConfigFactory.php
            │   │   ├── RevolverConfigFactory.php
            │   │   ├── RootWidgetConfigFactory.php
            │   │   └── WidgetConfigFactory.php
            │   ├── GeneralConfig.php
            │   ├── LinkerConfig.php
            │   ├── LoopConfig.php
            │   ├── NormalizerConfig.php
            │   ├── OutputConfig.php
            │   ├── RevolverConfig.php
            │   ├── RootWidgetConfig.php
            │   ├── Solver
            │   │   ├── A
            │   │   │   └── ASolver.php
            │   │   ├── AutoStartModeSolver.php
            │   │   ├── Contract
            │   │   │   ├── IAutoStartModeSolver.php
            │   │   │   ├── ICursorVisibilityModeSolver.php
            │   │   │   ├── IDriverMessagesSolver.php
            │   │   │   ├── IDriverModeSolver.php
            │   │   │   ├── IInitializationModeSolver.php
            │   │   │   ├── ILinkerModeSolver.php
            │   │   │   ├── INormalizerModeSolver.php
            │   │   │   ├── IRootWidgetSettingsSolver.php
            │   │   │   ├── IRunMethodModeSolver.php
            │   │   │   ├── ISignalHandlersContainerSolver.php
            │   │   │   ├── ISignalHandlingModeSolver.php
            │   │   │   ├── ISolver.php
            │   │   │   ├── IStreamSolver.php
            │   │   │   ├── IStylingMethodModeSolver.php
            │   │   │   ├── IToleranceSolver.php
            │   │   │   └── IWidgetSettingsSolver.php
            │   │   ├── CursorVisibilityModeSolver.php
            │   │   ├── DriverMessagesSolver.php
            │   │   ├── DriverModeSolver.php
            │   │   ├── InitializationModeSolver.php
            │   │   ├── LinkerModeSolver.php
            │   │   ├── NormalizerModeSolver.php
            │   │   ├── RootWidgetSettingsSolver.php
            │   │   ├── RunMethodModeSolver.php
            │   │   ├── SignalHandlersContainerSolver.php
            │   │   ├── SignalHandlingModeSolver.php
            │   │   ├── StreamSolver.php
            │   │   ├── StylingMethodModeSolver.php
            │   │   ├── ToleranceSolver.php
            │   │   └── WidgetSettingsSolver.php
            │   ├── WidgetConfig.php
            │   └── WidgetRevolverConfig.php
            ├── Contract
            │   ├── ICharFrame.php
            │   ├── IDriver.php
            │   ├── IDriverBuilder.php
            │   ├── IDriverLinker.php
            │   ├── IDriverMessages.php
            │   ├── IDriverProvider.php
            │   ├── IDriverSetup.php
            │   ├── IFrameCollection.php
            │   ├── IIntegerNormalizer.php
            │   ├── IIntervalComparator.php
            │   ├── IIntervalNormalizer.php
            │   ├── IPoint.php
            │   ├── IPositionedSequenceState.php
            │   ├── IRenderer.php
            │   ├── ISequenceState.php
            │   ├── ISignalHandlersContainer.php
            │   ├── ISignalHandlingSetup.php
            │   ├── ISpinner.php
            │   ├── IStyleFrame.php
            │   ├── ITolerance.php
            │   └── IWeakMap.php
            ├── DeltaTimer.php
            ├── Driver.php
            ├── Driver
            │   └── Renderer.php
            ├── DriverLinker.php
            ├── DriverMessages.php
            ├── DriverProvider.php
            ├── DriverSetup.php
            ├── DummyDriverLinker.php
            ├── DummySignalHandlingSetup.php
            ├── Factory
            │   ├── A
            │   │   └── ADriverProviderFactory.php
            │   ├── CharFrameRevolverFactory.php
            │   ├── ConsoleCursorFactory.php
            │   ├── Contract
            │   │   ├── IAnsiColorConverterFactory.php
            │   │   ├── ICharFrameRevolverFactory.php
            │   │   ├── IConsoleCursorFactory.php
            │   │   ├── IDeltaTimerFactory.php
            │   │   ├── IDriverFactory.php
            │   │   ├── IDriverLinkerFactory.php
            │   │   ├── IDriverProviderFactory.php
            │   │   ├── IFrameCollectionFactory.php
            │   │   ├── IIntervalFactory.php
            │   │   ├── IIntervalNormalizerFactory.php
            │   │   ├── ILoopFactory.php
            │   │   ├── ILoopProviderFactory.php
            │   │   ├── ISequenceStateWriterFactory.php
            │   │   ├── ISignalHandlingSetupFactory.php
            │   │   ├── ISpinnerFactory.php
            │   │   └── IStyleFrameRevolverFactory.php
            │   ├── DeltaTimerFactory.php
            │   ├── DriverFactory.php
            │   ├── DriverLinkerFactory.php
            │   ├── DriverProviderFactory.php
            │   ├── FrameCollectionFactory.php
            │   ├── IntervalFactory.php
            │   ├── IntervalNormalizerFactory.php
            │   ├── SequenceStateWriterFactory.php
            │   ├── SignalHandlingSetupFactory.php
            │   ├── SpinnerFactory.php
            │   └── StyleFrameRevolverFactory.php
            ├── Feature
            │   └── Resolver
            │   │   ├── AutoStartResolver.php
            │   │   ├── Contract
            │   │       ├── IAutoStartResolver.php
            │   │       ├── IInitializationResolver.php
            │   │       └── ILinkerResolver.php
            │   │   ├── InitializationResolver.php
            │   │   └── LinkerResolver.php
            ├── FrameCollection.php
            ├── IntegerNormalizer.php
            ├── Interval.php
            ├── IntervalComparator.php
            ├── IntervalNormalizer.php
            ├── Loop
            │   ├── Contract
            │   │   ├── A
            │   │   │   ├── ALoopAdapter.php
            │   │   │   └── ALoopProbe.php
            │   │   ├── ILoop.php
            │   │   ├── ILoopCreator.php
            │   │   ├── ILoopCreatorClassExtractor.php
            │   │   ├── ILoopCreatorClassProvider.php
            │   │   ├── ILoopProbe.php
            │   │   ├── ILoopProvider.php
            │   │   └── ILoopSetup.php
            │   ├── Factory
            │   │   ├── LoopFactory.php
            │   │   └── LoopProviderFactory.php
            │   ├── LoopCreatorClassExtractor.php
            │   ├── LoopCreatorClassProvider.php
            │   ├── LoopProvider.php
            │   └── LoopSetup.php
            ├── Output
            │   ├── BufferedOutput.php
            │   ├── ConsoleCursor.php
            │   ├── Contract
            │   │   ├── Factory
            │   │   │   └── IResourceStreamFactory.php
            │   │   ├── IBuffer.php
            │   │   ├── IConsoleCursor.php
            │   │   └── ISequenceStateWriter.php
            │   ├── Factory
            │   │   └── ResourceStreamFactory.php
            │   ├── Output.php
            │   ├── SequenceStateWriter.php
            │   ├── StringBuffer.php
            │   └── WritableStream.php
            ├── Palette
            │   ├── A
            │   │   ├── ACharPalette.php
            │   │   ├── APalette.php
            │   │   └── AStylePalette.php
            │   ├── Contract
            │   │   ├── ICharPalette.php
            │   │   ├── IPalette.php
            │   │   ├── IPaletteMode.php
            │   │   ├── IPaletteOptions.php
            │   │   ├── IPaletteTemplate.php
            │   │   └── IStylePalette.php
            │   ├── Factory
            │   │   ├── Contract
            │   │   │   └── IPaletteModeFactory.php
            │   │   └── PaletteModeFactory.php
            │   ├── NoCharPalette.php
            │   ├── NoStylePalette.php
            │   ├── PaletteMode.php
            │   ├── PaletteOptions.php
            │   ├── PaletteTemplate.php
            │   ├── Rainbow.php
            │   └── Snake.php
            ├── Pattern
            │   ├── Factory
            │   │   ├── Contract
            │   │   │   └── IPatternFactory.php
            │   │   └── PatternFactory.php
            │   └── Pattern.php
            ├── Probe
            │   ├── SignalHandlingOptionCreator.php
            │   ├── SignalHandlingProbe.php
            │   ├── StylingMethodOptionCreator.php
            │   └── StylingMethodProbe.php
            ├── Revolver
            │   ├── A
            │   │   ├── ARevolver.php
            │   │   └── ARevolverBuilder.php
            │   ├── Contract
            │   │   ├── IFrameCollectionRevolver.php
            │   │   ├── IFrameRevolver.php
            │   │   ├── IFrameRevolverBuilder.php
            │   │   ├── IRevolver.php
            │   │   └── IRevolverBuilder.php
            │   ├── FrameCollectionRevolver.php
            │   ├── FrameRevolverBuilder.php
            │   └── Tolerance.php
            ├── SequenceState.php
            ├── Settings
            │   ├── Builder
            │   │   └── SettingsProviderBuilder.php
            │   ├── Contract
            │   │   ├── Builder
            │   │   │   └── ISettingsProviderBuilder.php
            │   │   ├── Detector
            │   │   │   ├── IDetector.php
            │   │   │   ├── ILoopSupportDetector.php
            │   │   │   ├── ISignalHandlingSupportDetector.php
            │   │   │   └── IStylingMethodDetector.php
            │   │   ├── Factory
            │   │   │   ├── IDefaultSettingsFactory.php
            │   │   │   ├── IDetectedSettingsFactory.php
            │   │   │   ├── ISettingsProviderFactory.php
            │   │   │   └── IUserSettingsFactory.php
            │   │   ├── IDriverSettings.php
            │   │   ├── IGeneralSettings.php
            │   │   ├── IHandlerCreator.php
            │   │   ├── ILinkerSettings.php
            │   │   ├── ILoopSettings.php
            │   │   ├── IMessages.php
            │   │   ├── INormalizerSettings.php
            │   │   ├── IOutputSettings.php
            │   │   ├── IRevolverSettings.php
            │   │   ├── IRootWidgetSettings.php
            │   │   ├── ISettings.php
            │   │   ├── ISettingsElement.php
            │   │   ├── ISettingsProvider.php
            │   │   ├── ISignalHandlerCreator.php
            │   │   ├── ISignalHandlerSettings.php
            │   │   ├── ISpinnerSettings.php
            │   │   └── IWidgetSettings.php
            │   ├── Detector
            │   │   ├── LoopSupportDetector.php
            │   │   ├── SignalHandlingSupportDetector.php
            │   │   └── StylingMethodDetector.php
            │   ├── DriverSettings.php
            │   ├── Factory
            │   │   ├── DefaultSettingsFactory.php
            │   │   ├── DetectedSettingsFactory.php
            │   │   ├── SettingsProviderFactory.php
            │   │   └── UserSettingsFactory.php
            │   ├── GeneralSettings.php
            │   ├── LinkerSettings.php
            │   ├── LoopSettings.php
            │   ├── Messages.php
            │   ├── NormalizerSettings.php
            │   ├── OutputSettings.php
            │   ├── RevolverSettings.php
            │   ├── RootWidgetSettings.php
            │   ├── Settings.php
            │   ├── SettingsProvider.php
            │   ├── SignalHandlerCreator.php
            │   ├── SignalHandlerSettings.php
            │   ├── SpinnerSettings.php
            │   └── WidgetSettings.php
            ├── SignalHandlersContainer.php
            ├── SignalHandlingSetup.php
            ├── Spinner.php
            ├── StyleFrame.php
            └── Widget
            │   ├── A
            │       └── AWidget.php
            │   ├── Builder
            │       ├── A
            │       │   └── AWidgetBuilder.php
            │       ├── WidgetBuilder.php
            │       └── WidgetRevolverBuilder.php
            │   ├── Contract
            │       ├── IHasWidgetContext.php
            │       ├── IWidget.php
            │       ├── IWidgetBuilder.php
            │       ├── IWidgetComposite.php
            │       ├── IWidgetContext.php
            │       ├── IWidgetRevolver.php
            │       └── IWidgetRevolverBuilder.php
            │   ├── Factory
            │       ├── Contract
            │       │   ├── IWidgetFactory.php
            │       │   └── IWidgetRevolverFactory.php
            │       ├── WidgetFactory.php
            │       └── WidgetRevolverFactory.php
            │   ├── Widget.php
            │   └── WidgetRevolver.php
        ├── Exception
            ├── DomainException.php
            ├── DriverCanNotBeReplaced.php
            ├── InvalidArgument.php
            ├── LogicException.php
            ├── LoopException.php
            ├── NotImplemented.php
            ├── ObserverCanNotBeOverwritten.php
            ├── RuntimeException.php
            └── WidgetIsNotAComposite.php
        ├── Facade.php
        ├── Probes.php
        ├── Root
            ├── A
            │   └── AFacade.php
            ├── Contract
            │   └── IFacade.php
            └── definitions.php
        └── bootstrap.php


/LICENSE:
--------------------------------------------------------------------------------
 1 | MIT License
 2 | 
 3 | Copyright (c) 2023 Alec
 4 | 
 5 | Permission is hereby granted, free of charge, to any person obtaining a copy
 6 | of this software and associated documentation files (the "Software"), to deal
 7 | in the Software without restriction, including without limitation the rights
 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 | 
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 | 
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 | 


--------------------------------------------------------------------------------
/src/Spinner/Asynchronous/React/ReactLoopCreator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Asynchronous\React;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Loop\Contract\ILoop;
 8 | use AlecRabbit\Spinner\Core\Loop\Contract\ILoopCreator;
 9 | use React\EventLoop\Loop;
10 | 
11 | final class ReactLoopCreator implements ILoopCreator
12 | {
13 |     public function create(): ILoop
14 |     {
15 |         return new ReactLoopAdapter(Loop::get());
16 |     }
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Spinner/Asynchronous/React/ReactLoopProbe.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Asynchronous\React;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Loop\Contract\A\ALoopProbe;
 8 | use React\EventLoop\Loop;
 9 | 
10 | use function class_exists;
11 | 
12 | final class ReactLoopProbe extends ALoopProbe
13 | {
14 |     public static function isSupported(): bool
15 |     {
16 |         return class_exists(Loop::class);
17 |     }
18 | 
19 |     public static function getCreatorClass(): string
20 |     {
21 |         return ReactLoopCreator::class;
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Spinner/Asynchronous/Revolt/RevoltLoopCreator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Asynchronous\Revolt;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Loop\Contract\ILoop;
 8 | use AlecRabbit\Spinner\Core\Loop\Contract\ILoopCreator;
 9 | use Revolt\EventLoop;
10 | 
11 | final class RevoltLoopCreator implements ILoopCreator
12 | {
13 |     public function create(): ILoop
14 |     {
15 |         return new RevoltLoopAdapter(EventLoop::getDriver());
16 |     }
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Spinner/Asynchronous/Revolt/RevoltLoopProbe.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Asynchronous\Revolt;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Loop\Contract\A\ALoopProbe;
 8 | use Revolt\EventLoop;
 9 | 
10 | use function class_exists;
11 | 
12 | final class RevoltLoopProbe extends ALoopProbe
13 | {
14 |     public static function isSupported(): bool
15 |     {
16 |         return class_exists(EventLoop::class);
17 |     }
18 | 
19 |     public static function getCreatorClass(): string
20 |     {
21 |         return RevoltLoopCreator::class;
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Spinner/Asynchronous/bootstrap.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | use AlecRabbit\Spinner\Asynchronous\React\ReactLoopProbe;
 6 | use AlecRabbit\Spinner\Asynchronous\Revolt\RevoltLoopProbe;
 7 | use AlecRabbit\Spinner\Probes;
 8 | 
 9 | // @codeCoverageIgnoreStart
10 | 
11 | Probes::register(
12 |     ReactLoopProbe::class,
13 |     RevoltLoopProbe::class,
14 | );
15 | 
16 | // @codeCoverageIgnoreEnd
17 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/Adapter/ContainerAdapter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container\Adapter;
 6 | 
 7 | use AlecRabbit\Spinner\Container\Contract\IContainer;
 8 | use Psr\Container\ContainerInterface;
 9 | 
10 | final readonly class ContainerAdapter implements IContainer
11 | {
12 |     public function __construct(
13 |         private ContainerInterface $container,
14 |     ) {
15 |     }
16 | 
17 |     /**
18 |      * @inheritDoc
19 |      *
20 |      * @psalm-suppress MixedInferredReturnType
21 |      */
22 |     public function get(string $id)
23 |     {
24 |         /** @psalm-suppress MixedReturnStatement */
25 |         return $this->container->get($id);
26 |     }
27 | 
28 |     /** @inheritDoc */
29 |     public function has(string $id): bool
30 |     {
31 |         return $this->container->has($id);
32 |     }
33 | }
34 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/CircularDependencyDetector.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container;
 6 | 
 7 | use AlecRabbit\Spinner\Container\Contract\ICircularDependencyDetector;
 8 | use AlecRabbit\Spinner\Container\Exception\CircularDependencyDetected;
 9 | use ArrayObject;
10 | 
11 | use function in_array;
12 | 
13 | final readonly class CircularDependencyDetector implements ICircularDependencyDetector
14 | {
15 |     public function __construct(
16 |         private ArrayObject $stack = new ArrayObject(),
17 |     ) {
18 |     }
19 | 
20 |     public function push(string $id): void
21 |     {
22 |         if (in_array($id, $this->stack->getArrayCopy(), true)) {
23 |             throw new CircularDependencyDetected($this->stack);
24 |         }
25 | 
26 |         $this->stack->append($id);
27 |     }
28 | 
29 |     public function pop(): void
30 |     {
31 |         $key = array_key_last($this->stack->getArrayCopy());
32 | 
33 |         if ($key !== null && $this->stack->offsetExists($key)) {
34 |             $this->stack->offsetUnset($key);
35 |         }
36 |     }
37 | }
38 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/Contract/ICircularDependencyDetector.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container\Contract;
 6 | 
 7 | interface ICircularDependencyDetector
 8 | {
 9 |     public function push(string $id): void;
10 | 
11 |     public function pop(): void;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/Contract/IContainer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container\Contract;
 6 | 
 7 | use Psr\Container\ContainerExceptionInterface;
 8 | use Psr\Container\ContainerInterface;
 9 | use Psr\Container\NotFoundExceptionInterface;
10 | 
11 | interface IContainer extends ContainerInterface
12 | {
13 |     /**
14 |      * Finds an entry of the container by its identifier and returns it.
15 |      *
16 |      * @template T of object
17 |      *
18 |      * @param class-string<T> $id
19 |      *
20 |      * @psalm-return T
21 |      *
22 |      * @throws ContainerExceptionInterface Error while retrieving the entry.
23 |      * @throws NotFoundExceptionInterface  No entry was found for **this** identifier.
24 |      *
25 |      * @psalm-suppress MoreSpecificImplementedParamType
26 |      */
27 |     public function get(string $id);
28 | 
29 |     public function has(string $id): bool;
30 | }
31 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/Contract/IContainerFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container\Contract;
 6 | 
 7 | interface IContainerFactory
 8 | {
 9 |     public function create(IDefinitionRegistry $definitionRegistry): IContainer;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/Contract/IDefinitionRegistry.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container\Contract;
 6 | 
 7 | use Traversable;
 8 | 
 9 | interface IDefinitionRegistry
10 | {
11 |     /**
12 |      * @return Traversable<string, IServiceDefinition>
13 |      */
14 |     public function load(): Traversable;
15 | 
16 |     public function bind(IServiceDefinition ...$serviceDefinitions): void;
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/Contract/IIsStorableResolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container\Contract;
 6 | 
 7 | interface IIsStorableResolver
 8 | {
 9 |     public function isStorable(IServiceDefinition $definition): bool;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/Contract/IService.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container\Contract;
 6 | 
 7 | interface IService
 8 | {
 9 |     public function getValue(): mixed;
10 | 
11 |     public function isStorable(): bool;
12 | 
13 |     public function getId(): string;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/Contract/IServiceBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container\Contract;
 6 | 
 7 | interface IServiceBuilder
 8 | {
 9 |     public function build(): IService;
10 | 
11 |     public function withValue(mixed $value): IServiceBuilder;
12 | 
13 |     public function withId(string $id): IServiceBuilder;
14 | 
15 |     public function withIsStorable(bool $isStorable): IServiceBuilder;
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/Contract/IServiceDefinition.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container\Contract;
 6 | 
 7 | interface IServiceDefinition
 8 | {
 9 |     final public const SINGLETON = 0; // same instance every time, default
10 |     final public const TRANSIENT = 1; // new instance every time
11 | 
12 |     public function getId(): string;
13 | 
14 |     /**
15 |      * @return object|callable|class-string
16 |      */
17 |     public function getDefinition(): object|callable|string;
18 | 
19 |     public function getOptions(): int;
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/Contract/IServiceFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container\Contract;
 6 | 
 7 | interface IServiceFactory
 8 | {
 9 |     public function create(mixed $value, IServiceDefinition $serviceDefinition): IService;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/Contract/IServiceSpawner.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container\Contract;
 6 | 
 7 | use Psr\Container\ContainerExceptionInterface;
 8 | use Psr\Container\NotFoundExceptionInterface;
 9 | use ReflectionException;
10 | 
11 | interface IServiceSpawner
12 | {
13 |     /**
14 |      * @throws ContainerExceptionInterface
15 |      * @throws NotFoundExceptionInterface
16 |      * @throws ReflectionException
17 |      */
18 |     public function spawn(IServiceDefinition $serviceDefinition): IService;
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/Contract/IServiceSpawnerBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container\Contract;
 6 | 
 7 | interface IServiceSpawnerBuilder
 8 | {
 9 |     public function withContainer(IContainer $container): IServiceSpawnerBuilder;
10 | 
11 |     public function withCircularDependencyDetector(ICircularDependencyDetector $detector): IServiceSpawnerBuilder;
12 | 
13 |     public function build(): IServiceSpawner;
14 | 
15 |     public function withServiceObjectFactory(IServiceFactory $serviceObjectFactory): IServiceSpawnerBuilder;
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/Contract/IServiceSpawnerFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container\Contract;
 6 | 
 7 | interface IServiceSpawnerFactory
 8 | {
 9 |     public function create(IContainer $container): IServiceSpawner;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/DefinitionRegistry.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container;
 6 | 
 7 | use AlecRabbit\Spinner\Container\Contract\IDefinitionRegistry;
 8 | use AlecRabbit\Spinner\Container\Contract\IServiceDefinition;
 9 | use ArrayObject;
10 | use Traversable;
11 | 
12 | final class DefinitionRegistry implements IDefinitionRegistry
13 | {
14 |     private static ?IDefinitionRegistry $instance = null;
15 | 
16 |     /** @var ArrayObject<string, IServiceDefinition> */
17 |     private readonly ArrayObject $definitions;
18 | 
19 |     private function __construct(
20 |         ArrayObject $definitions = new ArrayObject(),
21 |     ) {
22 |         /** @var ArrayObject<string, IServiceDefinition> $definitions */
23 |         $this->definitions = $definitions;
24 |     }
25 | 
26 |     public static function getInstance(): IDefinitionRegistry
27 |     {
28 |         if (self::$instance === null) {
29 |             self::$instance = new self();
30 |         }
31 |         return self::$instance;
32 |     }
33 | 
34 |     public function load(): Traversable
35 |     {
36 |         yield from $this->definitions;
37 |     }
38 | 
39 |     public function bind(IServiceDefinition ...$serviceDefinitions): void
40 |     {
41 |         foreach ($serviceDefinitions as $serviceDefinition) {
42 |             $this->definitions->offsetSet($serviceDefinition->getId(), $serviceDefinition);
43 |         }
44 |     }
45 | }
46 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/Exception/CircularDependencyDetected.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container\Exception;
 6 | 
 7 | use ArrayObject;
 8 | use Throwable;
 9 | 
10 | /**
11 |  * @codeCoverageIgnore
12 |  */
13 | final class CircularDependencyDetected extends ContainerException
14 | {
15 |     public function __construct(ArrayObject $dependencyStack, ?Throwable $previous = null)
16 |     {
17 |         $message = 'Circular dependency detected!' . $this->formatStack($dependencyStack);
18 |         parent::__construct($message, previous: $previous);
19 |     }
20 | 
21 |     private function formatStack(ArrayObject $stack): string
22 |     {
23 |         /** @psalm-suppress MixedArgumentTypeCoercion */
24 |         return PHP_EOL . implode(' ➜ ', $stack->getArrayCopy());
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/Exception/ClassDoesNotExist.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container\Exception;
 6 | 
 7 | final class ClassDoesNotExist extends ContainerException
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/Exception/ContainerException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container\Exception;
 6 | 
 7 | use Psr\Container\ContainerExceptionInterface;
 8 | use RuntimeException;
 9 | 
10 | class ContainerException extends RuntimeException implements ContainerExceptionInterface
11 | {
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/Exception/InvalidDefinitionArgument.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container\Exception;
 6 | 
 7 | use InvalidArgumentException;
 8 | 
 9 | class InvalidDefinitionArgument extends InvalidArgumentException
10 | {
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/Exception/InvalidOptionsArgument.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container\Exception;
 6 | 
 7 | use InvalidArgumentException;
 8 | 
 9 | class InvalidOptionsArgument extends InvalidArgumentException
10 | {
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/Exception/NotFoundInContainer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container\Exception;
 6 | 
 7 | use Psr\Container\NotFoundExceptionInterface;
 8 | 
 9 | final class NotFoundInContainer extends ContainerException implements NotFoundExceptionInterface
10 | {
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/Exception/SpawnFailed.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container\Exception;
 6 | 
 7 | final class SpawnFailed extends SpawnerException
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/Exception/SpawnerException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container\Exception;
 6 | 
 7 | class SpawnerException extends ContainerException
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/Exception/UnableToCreateInstance.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container\Exception;
 6 | 
 7 | final class UnableToCreateInstance extends SpawnerException
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/Exception/UnableToExtractType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container\Exception;
 6 | 
 7 | final class UnableToExtractType extends SpawnerException
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/Factory/ContainerFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Container\Container;
 8 | use AlecRabbit\Spinner\Container\Contract\IContainer;
 9 | use AlecRabbit\Spinner\Container\Contract\IContainerFactory;
10 | use AlecRabbit\Spinner\Container\Contract\IDefinitionRegistry;
11 | use AlecRabbit\Spinner\Container\Contract\IServiceSpawnerFactory;
12 | 
13 | final readonly class ContainerFactory implements IContainerFactory
14 | {
15 |     public function __construct(
16 |         private IServiceSpawnerFactory $spawnerFactory = new ServiceSpawnerFactory(),
17 |     ) {
18 |     }
19 | 
20 |     public function create(IDefinitionRegistry $definitionRegistry): IContainer
21 |     {
22 |         return new Container(
23 |             spawnerFactory: $this->spawnerFactory,
24 |             definitions: $definitionRegistry->load(),
25 |         );
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/Factory/ServiceFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Container\Builder\ServiceBuilder;
 8 | use AlecRabbit\Spinner\Container\Contract\IIsStorableResolver;
 9 | use AlecRabbit\Spinner\Container\Contract\IService;
10 | use AlecRabbit\Spinner\Container\Contract\IServiceBuilder;
11 | use AlecRabbit\Spinner\Container\Contract\IServiceDefinition;
12 | use AlecRabbit\Spinner\Container\Contract\IServiceFactory;
13 | use AlecRabbit\Spinner\Container\ServiceIsStorableResolver;
14 | 
15 | final readonly class ServiceFactory implements IServiceFactory
16 | {
17 |     public function __construct(
18 |         private IIsStorableResolver $isStorableResolver = new ServiceIsStorableResolver(),
19 |         private IServiceBuilder $serviceBuilder = new ServiceBuilder(),
20 |     ) {
21 |     }
22 | 
23 |     public function create(mixed $value, IServiceDefinition $serviceDefinition): IService
24 |     {
25 |         $id = $serviceDefinition->getId();
26 |         $isStorable = $this->isStorableResolver->isStorable($serviceDefinition);
27 | 
28 |         return $this->serviceBuilder
29 |             ->withValue($value)
30 |             ->withId($id)
31 |             ->withIsStorable($isStorable)
32 |             ->build()
33 |         ;
34 |     }
35 | }
36 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/Service.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container;
 6 | 
 7 | use AlecRabbit\Spinner\Container\Contract\IService;
 8 | 
 9 | final readonly class Service implements IService
10 | {
11 |     public function __construct(
12 |         private mixed $value,
13 |         private bool $storable,
14 |         private string $id,
15 |     ) {
16 |     }
17 | 
18 |     public function getValue(): mixed
19 |     {
20 |         return $this->value;
21 |     }
22 | 
23 |     public function isStorable(): bool
24 |     {
25 |         return $this->storable;
26 |     }
27 | 
28 |     public function getId(): string
29 |     {
30 |         return $this->id;
31 |     }
32 | }
33 | 


--------------------------------------------------------------------------------
/src/Spinner/Container/ServiceIsStorableResolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Container;
 6 | 
 7 | use AlecRabbit\Spinner\Container\Contract\IIsStorableResolver;
 8 | use AlecRabbit\Spinner\Container\Contract\IServiceDefinition;
 9 | 
10 | final readonly class ServiceIsStorableResolver implements IIsStorableResolver
11 | {
12 |     public function isStorable(IServiceDefinition $definition): bool
13 |     {
14 |         return $definition->getOptions() === IServiceDefinition::SINGLETON;
15 |     }
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/ICreator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract;
 6 | 
 7 | interface ICreator
 8 | {
 9 |     public function create(): object;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/IDeltaTimer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract;
 6 | 
 7 | interface IDeltaTimer
 8 | {
 9 |     public function getDelta(): float;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/IFinalizable.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract;
 6 | 
 7 | interface IFinalizable
 8 | {
 9 |     public function finalize(?string $finalMessage = null): void;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/IFrame.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract;
 6 | 
 7 | interface IFrame
 8 | {
 9 |     public function getSequence(): string;
10 | 
11 |     public function getWidth(): int;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/IHasEmptyState.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract;
 6 | 
 7 | interface IHasEmptyState
 8 | {
 9 |     public function isEmpty(): bool;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/IHasFrame.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract;
 6 | 
 7 | interface IHasFrame
 8 | {
 9 |     /**
10 |      * @param float|null $dt delta time(milliseconds), time passed since last update
11 |      */
12 |     public function getFrame(?float $dt = null): IFrame;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/IHasInterval.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract;
 6 | 
 7 | interface IHasInterval extends IHasNullableInterval
 8 | {
 9 |     public function getInterval(): IInterval;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/IHasIsEnabled.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract;
 6 | 
 7 | interface IHasIsEnabled
 8 | {
 9 |     public function isEnabled(): bool;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/IHasNullableInterval.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract;
 6 | 
 7 | interface IHasNullableInterval
 8 | {
 9 |     public function getInterval(): ?IInterval;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/IInitializable.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract;
 6 | 
 7 | interface IInitializable
 8 | {
 9 |     public function initialize(): void;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/IInterval.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract;
 6 | 
 7 | interface IInterval
 8 | {
 9 |     final public const MIN_INTERVAL_MILLISECONDS = 10;
10 |     final public const MAX_INTERVAL_MILLISECONDS = 900000;  // 15 minutes
11 | 
12 |     public function toMicroseconds(): float;
13 | 
14 |     public function toMilliseconds(): float;
15 | 
16 |     public function toSeconds(): float;
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/INowTimer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract;
 6 | 
 7 | interface INowTimer
 8 | {
 9 |     public function now(): float;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/IObserver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract;
 6 | 
 7 | interface IObserver
 8 | {
 9 |     /**
10 |      * Receive update from subject.
11 |      */
12 |     public function update(ISubject $subject): void;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/IProcedure.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract;
 6 | 
 7 | interface IProcedure extends IHasFrame
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/IRenderable.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract;
 6 | 
 7 | interface IRenderable
 8 | {
 9 |     /**
10 |      * @param float|null $dt Delta time. If null, internal timer will be used do determine delta time.
11 |      */
12 |     public function render(?float $dt = null): void;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/ISubject.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Exception\InvalidArgument;
 8 | use AlecRabbit\Spinner\Exception\LogicException;
 9 | 
10 | interface ISubject
11 | {
12 |     /**
13 |      * Attach an observer to the subject.
14 |      *
15 |      * @throws LogicException
16 |      * @throws InvalidArgument
17 |      */
18 |     public function attach(IObserver $observer): void;
19 | 
20 |     /**
21 |      * Detach an observer from the subject.
22 |      */
23 |     public function detach(IObserver $observer): void;
24 | 
25 |     /**
26 |      * Notify all observers about an event.
27 |      */
28 |     public function notify(): void;
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/Mode/AutoStartMode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract\Mode;
 6 | 
 7 | enum AutoStartMode
 8 | {
 9 |     case ENABLED;
10 |     case DISABLED;
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/Mode/CursorVisibilityMode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract\Mode;
 6 | 
 7 | enum CursorVisibilityMode
 8 | {
 9 |     case VISIBLE;
10 |     case HIDDEN;
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/Mode/DriverMode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract\Mode;
 6 | 
 7 | enum DriverMode
 8 | {
 9 |     case ENABLED;
10 |     case DISABLED;
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/Mode/InitializationMode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract\Mode;
 6 | 
 7 | enum InitializationMode
 8 | {
 9 |     case ENABLED;
10 |     case DISABLED;
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/Mode/LinkerMode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract\Mode;
 6 | 
 7 | enum LinkerMode
 8 | {
 9 |     case ENABLED;
10 |     case DISABLED;
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/Mode/NormalizerMode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract\Mode;
 6 | 
 7 | enum NormalizerMode
 8 | {
 9 |     case SMOOTH;
10 |     case BALANCED;
11 |     case PERFORMANCE;
12 |     case SLOW;
13 |     case STILL;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/Mode/RunMethodMode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract\Mode;
 6 | 
 7 | enum RunMethodMode
 8 | {
 9 |     case SYNCHRONOUS; // long value name for readability
10 | 
11 |     case ASYNC;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/Mode/SignalHandlingMode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract\Mode;
 6 | 
 7 | enum SignalHandlingMode
 8 | {
 9 |     case ENABLED;
10 |     case DISABLED;
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/Mode/StylingMethodMode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract\Mode;
 6 | 
 7 | enum StylingMethodMode: int
 8 | {
 9 |     case NONE = 0;
10 |     case ANSI4 = 16;
11 |     case ANSI8 = 256;
12 |     case ANSI24 = 65535;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/Option/AutoStartOption.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract\Option;
 6 | 
 7 | enum AutoStartOption
 8 | {
 9 |     case AUTO;
10 |     case ENABLED;
11 |     case DISABLED;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/Option/CursorVisibilityOption.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract\Option;
 6 | 
 7 | enum CursorVisibilityOption
 8 | {
 9 |     case AUTO;
10 |     case VISIBLE;
11 |     case HIDDEN;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/Option/DriverOption.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract\Option;
 6 | 
 7 | enum DriverOption
 8 | {
 9 |     case AUTO;
10 |     case ENABLED;
11 |     case DISABLED;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/Option/InitializationOption.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract\Option;
 6 | 
 7 | enum InitializationOption
 8 | {
 9 |     case AUTO;
10 |     case ENABLED;
11 |     case DISABLED;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/Option/LinkerOption.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract\Option;
 6 | 
 7 | enum LinkerOption
 8 | {
 9 |     case AUTO;
10 |     case ENABLED;
11 |     case DISABLED;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/Option/NormalizerOption.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract\Option;
 6 | 
 7 | enum NormalizerOption
 8 | {
 9 |     case AUTO;
10 |     case SMOOTH;
11 |     case BALANCED;
12 |     case PERFORMANCE;
13 |     case SLOW;
14 |     case STILL;
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/Option/RunMethodOption.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract\Option;
 6 | 
 7 | enum RunMethodOption
 8 | {
 9 |     case AUTO;
10 | 
11 |     case SYNCHRONOUS; // long value name for readability
12 | 
13 |     case ASYNC;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/Option/SignalHandlingOption.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract\Option;
 6 | 
 7 | enum SignalHandlingOption
 8 | {
 9 |     case AUTO;
10 |     case ENABLED;
11 |     case DISABLED;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/Option/StylingMethodOption.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract\Option;
 6 | 
 7 | enum StylingMethodOption: int
 8 | {
 9 |     case AUTO = -1;
10 |     case NONE = 0;
11 |     case ANSI4 = 16;
12 |     case ANSI8 = 256;
13 |     case ANSI24 = 65535;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/Output/IBufferedOutput.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract\Output;
 6 | 
 7 | interface IBufferedOutput
 8 | {
 9 |     /**
10 |      * Flushes the output buffer.
11 |      */
12 |     public function flush(): void;
13 | 
14 |     /**
15 |      * Appends message to output buffer.
16 |      *
17 |      * @psalm-param iterable<string>|string $messages
18 |      */
19 |     public function append(iterable|string $messages): IBufferedOutput;
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/Output/IOutput.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract\Output;
 6 | 
 7 | interface IOutput
 8 | {
 9 |     /**
10 |      * Writes a message or messages to the output and adds a newline at the end.
11 |      *
12 |      * @param string|iterable $messages Message or messages to write
13 |      * @param int $options A bitmask of options
14 |      */
15 |     public function writeln(string|iterable $messages, int $options = 0): void;
16 | 
17 |     /**
18 |      * Writes a message or messages to the output.
19 |      *
20 |      * @param string|iterable $messages Message or messages to write
21 |      * @param bool $newline Whether to add a newline
22 |      * @param int $options A bitmask of options
23 |      */
24 |     public function write(string|iterable $messages, bool $newline = false, int $options = 0): void;
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/Output/IWritableStream.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract\Output;
 6 | 
 7 | use Traversable;
 8 | 
 9 | interface IWritableStream
10 | {
11 |     /**
12 |      * @param Traversable<string> $data
13 |      */
14 |     public function write(Traversable $data): void;
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/Pattern/IPattern.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract\Pattern;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IInterval;
 8 | use Traversable;
 9 | 
10 | interface IPattern
11 | {
12 |     public function getInterval(): IInterval;
13 | 
14 |     public function getFrames(): Traversable;
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/Pattern/IProceduralPattern.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract\Pattern;
 6 | 
 7 | interface IProceduralPattern extends IPattern
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/Probe/ISignalHandlingOptionCreator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract\Probe;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\ICreator;
 8 | use AlecRabbit\Spinner\Contract\Option\SignalHandlingOption;
 9 | 
10 | interface ISignalHandlingOptionCreator extends ICreator
11 | {
12 |     public function create(): SignalHandlingOption;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/Probe/ISignalHandlingProbe.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract\Probe;
 6 | 
 7 | interface ISignalHandlingProbe extends IStaticProbe
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/Probe/IStaticProbe.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract\Probe;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\ICreator;
 8 | 
 9 | interface IStaticProbe
10 | {
11 |     public static function isSupported(): bool;
12 | 
13 |     /**
14 |      * @return class-string<ICreator>
15 |      */
16 |     public static function getCreatorClass(): string;
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/Probe/IStylingMethodOptionCreator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract\Probe;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\ICreator;
 8 | use AlecRabbit\Spinner\Contract\Option\StylingMethodOption;
 9 | 
10 | interface IStylingMethodOptionCreator extends ICreator
11 | {
12 |     public function create(): StylingMethodOption;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Spinner/Contract/Probe/IStylingMethodProbe.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Contract\Probe;
 6 | 
 7 | interface IStylingMethodProbe extends IStaticProbe
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/A/AFrame.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\A;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IFrame;
 8 | 
 9 | abstract readonly class AFrame implements IFrame
10 | {
11 |     public function __construct(
12 |         protected string $sequence,
13 |         protected int $width,
14 |     ) {
15 |     }
16 | 
17 |     public function getSequence(): string
18 |     {
19 |         return $this->sequence;
20 |     }
21 | 
22 |     public function getWidth(): int
23 |     {
24 |         return $this->width;
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Builder/Contract/IConsoleCursorBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Builder\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\CursorVisibilityMode;
 8 | use AlecRabbit\Spinner\Core\Output\Contract\IBuffer;
 9 | use AlecRabbit\Spinner\Core\Output\Contract\IConsoleCursor;
10 | 
11 | interface IConsoleCursorBuilder
12 | {
13 |     public function build(): IConsoleCursor;
14 | 
15 |     public function withCursorVisibilityMode(CursorVisibilityMode $cursorVisibilityMode): IConsoleCursorBuilder;
16 | 
17 |     public function withBuffer(IBuffer $buffer): IConsoleCursorBuilder;
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Builder/Contract/IDeltaTimerBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Builder\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IDeltaTimer;
 8 | use AlecRabbit\Spinner\Contract\INowTimer;
 9 | 
10 | interface IDeltaTimerBuilder
11 | {
12 |     public function build(): IDeltaTimer;
13 | 
14 |     public function withStartTime(float $time): IDeltaTimerBuilder;
15 | 
16 |     public function withNowTimer(INowTimer $now): IDeltaTimerBuilder;
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Builder/Contract/IIntegerNormalizerBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Builder\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Contract\IIntegerNormalizer;
 8 | 
 9 | interface IIntegerNormalizerBuilder
10 | {
11 |     public function build(): IIntegerNormalizer;
12 | 
13 |     public function withDivisor(int $divisor): IIntegerNormalizerBuilder;
14 | 
15 |     public function withMin(int $min): IIntegerNormalizerBuilder;
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Builder/Contract/ISequenceStateBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Builder\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Contract\ISequenceState;
 8 | use AlecRabbit\Spinner\Exception\LogicException;
 9 | 
10 | interface ISequenceStateBuilder
11 | {
12 |     public function withSequence(string $sequence): ISequenceStateBuilder;
13 | 
14 |     public function withWidth(int $width): ISequenceStateBuilder;
15 | 
16 |     public function withPreviousWidth(int $previousWidth): ISequenceStateBuilder;
17 | 
18 |     /**
19 |      * @throws LogicException
20 |      */
21 |     public function build(): ISequenceState;
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Builder/Contract/ISequenceStateWriterBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Builder\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Output\IBufferedOutput;
 8 | use AlecRabbit\Spinner\Core\Feature\Resolver\Contract\IInitializationResolver;
 9 | use AlecRabbit\Spinner\Core\Output\Contract\IConsoleCursor;
10 | use AlecRabbit\Spinner\Core\Output\Contract\ISequenceStateWriter;
11 | 
12 | interface ISequenceStateWriterBuilder
13 | {
14 |     public function build(): ISequenceStateWriter;
15 | 
16 |     public function withOutput(IBufferedOutput $bufferedOutput): ISequenceStateWriterBuilder;
17 | 
18 |     public function withCursor(IConsoleCursor $cursor): ISequenceStateWriterBuilder;
19 | 
20 |     public function withInitializationResolver(
21 |         IInitializationResolver $initializationResolver
22 |     ): ISequenceStateWriterBuilder;
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/CharFrame.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core;
 6 | 
 7 | use AlecRabbit\Spinner\Core\A\AFrame;
 8 | use AlecRabbit\Spinner\Core\Contract\ICharFrame;
 9 | 
10 | final readonly class CharFrame extends AFrame implements ICharFrame
11 | {
12 |     public static function createEmpty(): ICharFrame
13 |     {
14 |         return new CharFrame('', 0);
15 |     }
16 | 
17 |     public static function createSpace(): ICharFrame
18 |     {
19 |         return new CharFrame(' ', 1);
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Builder/GeneralConfigBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Builder;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\RunMethodMode;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\Builder\IGeneralConfigBuilder;
 9 | use AlecRabbit\Spinner\Core\Config\Contract\IGeneralConfig;
10 | use AlecRabbit\Spinner\Core\Config\GeneralConfig;
11 | use AlecRabbit\Spinner\Exception\LogicException;
12 | 
13 | /**
14 |  * @psalm-suppress PossiblyNullArgument
15 |  */
16 | final class GeneralConfigBuilder implements IGeneralConfigBuilder
17 | {
18 |     private ?RunMethodMode $runMethodMode = null;
19 | 
20 |     public function build(): IGeneralConfig
21 |     {
22 |         $this->validate();
23 | 
24 |         return new GeneralConfig(
25 |             runMethodMode: $this->runMethodMode,
26 |         );
27 |     }
28 | 
29 |     private function validate(): void
30 |     {
31 |         match (true) {
32 |             $this->runMethodMode === null => throw new LogicException('RunMethodMode is not set.'),
33 |             default => null,
34 |         };
35 |     }
36 | 
37 |     public function withRunMethodMode(RunMethodMode $runMethodMode): IGeneralConfigBuilder
38 |     {
39 |         $clone = clone $this;
40 |         $clone->runMethodMode = $runMethodMode;
41 |         return $clone;
42 |     }
43 | }
44 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Builder/LinkerConfigBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Builder;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\LinkerMode;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\Builder\ILinkerConfigBuilder;
 9 | use AlecRabbit\Spinner\Core\Config\Contract\ILinkerConfig;
10 | use AlecRabbit\Spinner\Core\Config\LinkerConfig;
11 | use AlecRabbit\Spinner\Exception\LogicException;
12 | 
13 | /**
14 |  * @psalm-suppress PossiblyNullArgument
15 |  */
16 | final class LinkerConfigBuilder implements ILinkerConfigBuilder
17 | {
18 |     private ?LinkerMode $linkerMode = null;
19 | 
20 |     public function build(): ILinkerConfig
21 |     {
22 |         $this->validate();
23 | 
24 |         return new LinkerConfig(
25 |             linkerMode: $this->linkerMode,
26 |         );
27 |     }
28 | 
29 |     /**
30 |      * @throws LogicException
31 |      */
32 |     private function validate(): void
33 |     {
34 |         match (true) {
35 |             $this->linkerMode === null => throw new LogicException('LinkerMode is not set.'),
36 |             default => null,
37 |         };
38 |     }
39 | 
40 |     public function withLinkerMode(LinkerMode $linkerMode): ILinkerConfigBuilder
41 |     {
42 |         $clone = clone $this;
43 |         $clone->linkerMode = $linkerMode;
44 |         return $clone;
45 |     }
46 | }
47 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Builder/NormalizerConfigBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Builder;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\NormalizerMode;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\Builder\INormalizerConfigBuilder;
 9 | use AlecRabbit\Spinner\Core\Config\Contract\INormalizerConfig;
10 | use AlecRabbit\Spinner\Core\Config\NormalizerConfig;
11 | use AlecRabbit\Spinner\Exception\LogicException;
12 | 
13 | /**
14 |  * @psalm-suppress PossiblyNullArgument
15 |  */
16 | final class NormalizerConfigBuilder implements INormalizerConfigBuilder
17 | {
18 |     private ?NormalizerMode $normalizerMode = null;
19 | 
20 |     public function build(): INormalizerConfig
21 |     {
22 |         $this->validate();
23 | 
24 |         return new NormalizerConfig(
25 |             normalizerMode: $this->normalizerMode,
26 |         );
27 |     }
28 | 
29 |     private function validate(): void
30 |     {
31 |         match (true) {
32 |             $this->normalizerMode === null => throw new LogicException('NormalizerMode is not set.'),
33 |             default => null,
34 |         };
35 |     }
36 | 
37 |     public function withNormalizerMode(NormalizerMode $normalizerMode): INormalizerConfigBuilder
38 |     {
39 |         $clone = clone $this;
40 |         $clone->normalizerMode = $normalizerMode;
41 |         return $clone;
42 |     }
43 | }
44 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Builder/RevolverConfigBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Builder;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Contract\Builder\IRevolverConfigBuilder;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\IRevolverConfig;
 9 | use AlecRabbit\Spinner\Core\Config\RevolverConfig;
10 | use AlecRabbit\Spinner\Core\Contract\ITolerance;
11 | use AlecRabbit\Spinner\Exception\LogicException;
12 | 
13 | /**
14 |  * @psalm-suppress PossiblyNullArgument
15 |  */
16 | final class RevolverConfigBuilder implements IRevolverConfigBuilder
17 | {
18 |     private ?ITolerance $tolerance = null;
19 | 
20 |     public function build(): IRevolverConfig
21 |     {
22 |         $this->validate();
23 | 
24 |         return new RevolverConfig(
25 |             tolerance: $this->tolerance,
26 |         );
27 |     }
28 | 
29 |     /**
30 |      * @throws LogicException
31 |      */
32 |     private function validate(): void
33 |     {
34 |         match (true) {
35 |             $this->tolerance === null => throw new LogicException('Tolerance is not set.'),
36 |             default => null,
37 |         };
38 |     }
39 | 
40 |     public function withTolerance(ITolerance $tolerance): IRevolverConfigBuilder
41 |     {
42 |         $clone = clone $this;
43 |         $clone->tolerance = $tolerance;
44 |         return $clone;
45 |     }
46 | }
47 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/Builder/IDriverConfigBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract\Builder;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\DriverMode;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\IDriverConfig;
 9 | use AlecRabbit\Spinner\Core\Contract\IDriverMessages;
10 | use AlecRabbit\Spinner\Exception\LogicException;
11 | 
12 | interface IDriverConfigBuilder
13 | {
14 |     /**
15 |      * @throws LogicException
16 |      */
17 |     public function build(): IDriverConfig;
18 | 
19 |     public function withDriverMessages(IDriverMessages $driverMessages): IDriverConfigBuilder;
20 | 
21 |     public function withDriverMode(DriverMode $driverMode): IDriverConfigBuilder;
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/Builder/IGeneralConfigBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract\Builder;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\RunMethodMode;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\IGeneralConfig;
 9 | use AlecRabbit\Spinner\Exception\LogicException;
10 | 
11 | interface IGeneralConfigBuilder
12 | {
13 |     /**
14 |      * @throws LogicException
15 |      */
16 |     public function build(): IGeneralConfig;
17 | 
18 |     public function withRunMethodMode(RunMethodMode $runMethodMode): IGeneralConfigBuilder;
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/Builder/ILinkerConfigBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract\Builder;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\LinkerMode;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\ILinkerConfig;
 9 | use AlecRabbit\Spinner\Exception\LogicException;
10 | 
11 | interface ILinkerConfigBuilder
12 | {
13 |     /**
14 |      * @throws LogicException
15 |      */
16 |     public function build(): ILinkerConfig;
17 | 
18 |     public function withLinkerMode(LinkerMode $linkerMode): ILinkerConfigBuilder;
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/Builder/ILoopConfigBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract\Builder;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\AutoStartMode;
 8 | use AlecRabbit\Spinner\Contract\Mode\SignalHandlingMode;
 9 | use AlecRabbit\Spinner\Core\Config\Contract\ILoopConfig;
10 | use AlecRabbit\Spinner\Core\Contract\ISignalHandlersContainer;
11 | use AlecRabbit\Spinner\Exception\LogicException;
12 | 
13 | interface ILoopConfigBuilder
14 | {
15 |     /**
16 |      * @throws LogicException
17 |      */
18 |     public function build(): ILoopConfig;
19 | 
20 |     public function withSignalHandlingMode(SignalHandlingMode $signalHandlersMode): ILoopConfigBuilder;
21 | 
22 |     public function withAutoStartMode(AutoStartMode $autoStartMode): ILoopConfigBuilder;
23 | 
24 |     public function withSignalHandlersContainer(ISignalHandlersContainer $signalHandlersContainer): ILoopConfigBuilder;
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/Builder/INormalizerConfigBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract\Builder;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\NormalizerMode;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\INormalizerConfig;
 9 | use AlecRabbit\Spinner\Exception\LogicException;
10 | 
11 | interface INormalizerConfigBuilder
12 | {
13 |     /**
14 |      * @throws LogicException
15 |      */
16 |     public function build(): INormalizerConfig;
17 | 
18 |     public function withNormalizerMode(NormalizerMode $normalizerMode): INormalizerConfigBuilder;
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/Builder/IOutputConfigBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract\Builder;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\CursorVisibilityMode;
 8 | use AlecRabbit\Spinner\Contract\Mode\InitializationMode;
 9 | use AlecRabbit\Spinner\Contract\Mode\StylingMethodMode;
10 | use AlecRabbit\Spinner\Core\Config\Contract\IOutputConfig;
11 | use AlecRabbit\Spinner\Exception\LogicException;
12 | 
13 | interface IOutputConfigBuilder
14 | {
15 |     /**
16 |      * @throws LogicException
17 |      */
18 |     public function build(): IOutputConfig;
19 | 
20 |     public function withCursorVisibilityMode(CursorVisibilityMode $cursorVisibilityMode): IOutputConfigBuilder;
21 | 
22 |     public function withStylingMethodMode(StylingMethodMode $stylingMethodMode): IOutputConfigBuilder;
23 | 
24 |     public function withInitializationMode(InitializationMode $initializationMode): IOutputConfigBuilder;
25 | 
26 |     public function withStream(mixed $stream): IOutputConfigBuilder;
27 | }
28 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/Builder/IRevolverConfigBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract\Builder;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Contract\IRevolverConfig;
 8 | use AlecRabbit\Spinner\Core\Contract\ITolerance;
 9 | use AlecRabbit\Spinner\Exception\LogicException;
10 | 
11 | interface IRevolverConfigBuilder
12 | {
13 |     /**
14 |      * @throws LogicException
15 |      */
16 |     public function build(): IRevolverConfig;
17 | 
18 |     public function withTolerance(ITolerance $tolerance): IRevolverConfigBuilder;
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/Builder/IWidgetRevolverConfigBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract\Builder;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Contract\IRevolverConfig;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\IWidgetRevolverConfig;
 9 | use AlecRabbit\Spinner\Core\Palette\Contract\IPalette;
10 | use AlecRabbit\Spinner\Exception\LogicException;
11 | 
12 | interface IWidgetRevolverConfigBuilder
13 | {
14 |     /**
15 |      * @throws LogicException
16 |      */
17 |     public function build(): IWidgetRevolverConfig;
18 | 
19 |     public function withStylePalette(IPalette $palette): IWidgetRevolverConfigBuilder;
20 | 
21 |     public function withCharPalette(IPalette $palette): IWidgetRevolverConfigBuilder;
22 | 
23 |     public function withRevolverConfig(IRevolverConfig $revolverConfig): IWidgetRevolverConfigBuilder;
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/Detector/IAutoStartModeDetector.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract\Detector;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IHasIsEnabled;
 8 | 
 9 | interface IAutoStartModeDetector extends IHasIsEnabled
10 | {
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/Detector/IDriverModeDetector.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract\Detector;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IHasIsEnabled;
 8 | 
 9 | interface IDriverModeDetector extends IHasIsEnabled
10 | {
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/Detector/IInitializationModeDetector.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract\Detector;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IHasIsEnabled;
 8 | 
 9 | interface IInitializationModeDetector extends IHasIsEnabled
10 | {
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/Detector/ILinkerModeDetector.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract\Detector;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IHasIsEnabled;
 8 | 
 9 | interface ILinkerModeDetector extends IHasIsEnabled
10 | {
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/Factory/IDriverConfigFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Contract\IDriverConfig;
 8 | 
 9 | interface IDriverConfigFactory
10 | {
11 |     public function create(): IDriverConfig;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/Factory/IGeneralConfigFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Contract\IGeneralConfig;
 8 | 
 9 | interface IGeneralConfigFactory
10 | {
11 |     public function create(): IGeneralConfig;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/Factory/IInitialRootWidgetConfigFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Contract\IRootWidgetConfig;
 8 | 
 9 | interface IInitialRootWidgetConfigFactory extends IInitialWidgetConfigFactory
10 | {
11 |     public function create(): IRootWidgetConfig;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/Factory/IInitialWidgetConfigFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Contract\IWidgetConfig;
 8 | 
 9 | interface IInitialWidgetConfigFactory
10 | {
11 |     public function create(): IWidgetConfig;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/Factory/ILinkerConfigFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Contract\ILinkerConfig;
 8 | 
 9 | interface ILinkerConfigFactory
10 | {
11 |     public function create(): ILinkerConfig;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/Factory/ILoopConfigFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Contract\ILoopConfig;
 8 | 
 9 | interface ILoopConfigFactory
10 | {
11 |     public function create(): ILoopConfig;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/Factory/INormalizerConfigFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Contract\INormalizerConfig;
 8 | 
 9 | interface INormalizerConfigFactory
10 | {
11 |     public function create(): INormalizerConfig;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/Factory/IOutputConfigFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Contract\IOutputConfig;
 8 | 
 9 | interface IOutputConfigFactory
10 | {
11 |     public function create(): IOutputConfig;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/Factory/IRevolverConfigFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Contract\IRevolverConfig;
 8 | 
 9 | interface IRevolverConfigFactory
10 | {
11 |     public function create(): IRevolverConfig;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/Factory/IRootWidgetConfigFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Contract\IRootWidgetConfig;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\IWidgetConfig;
 9 | use AlecRabbit\Spinner\Core\Settings\Contract\IWidgetSettings;
10 | 
11 | interface IRootWidgetConfigFactory extends IInitialRootWidgetConfigFactory
12 | {
13 |     public function create(IWidgetConfig|IWidgetSettings|null $widgetSettings = null): IRootWidgetConfig;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/Factory/IWidgetConfigFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Contract\IWidgetConfig;
 8 | use AlecRabbit\Spinner\Core\Settings\Contract\IWidgetSettings;
 9 | 
10 | interface IWidgetConfigFactory extends IInitialWidgetConfigFactory
11 | {
12 |     public function create(IWidgetConfig|IWidgetSettings|null $widgetSettings = null): IWidgetConfig;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/IConfigElement.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract;
 6 | 
 7 | interface IConfigElement
 8 | {
 9 |     /**
10 |      * @return class-string<IConfigElement>
11 |      */
12 |     public function getIdentifier(): string;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/IDriverConfig.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\DriverMode;
 8 | use AlecRabbit\Spinner\Core\Contract\IDriverMessages;
 9 | 
10 | interface IDriverConfig extends IConfigElement
11 | {
12 |     public function getDriverMessages(): IDriverMessages;
13 | 
14 |     public function getDriverMode(): DriverMode;
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/IGeneralConfig.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\RunMethodMode;
 8 | 
 9 | interface IGeneralConfig extends IConfigElement
10 | {
11 |     public function getRunMethodMode(): RunMethodMode;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/ILinkerConfig.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\LinkerMode;
 8 | 
 9 | interface ILinkerConfig extends IConfigElement
10 | {
11 |     public function getLinkerMode(): LinkerMode;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/ILoopConfig.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\AutoStartMode;
 8 | use AlecRabbit\Spinner\Contract\Mode\SignalHandlingMode;
 9 | use AlecRabbit\Spinner\Core\Contract\ISignalHandlersContainer;
10 | 
11 | interface ILoopConfig extends IConfigElement
12 | {
13 |     public function getSignalHandlingMode(): SignalHandlingMode;
14 | 
15 |     public function getAutoStartMode(): AutoStartMode;
16 | 
17 |     public function getSignalHandlersContainer(): ISignalHandlersContainer;
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/INormalizerConfig.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\NormalizerMode;
 8 | 
 9 | interface INormalizerConfig extends IConfigElement
10 | {
11 |     public function getNormalizerMode(): NormalizerMode;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/IOutputConfig.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\CursorVisibilityMode;
 8 | use AlecRabbit\Spinner\Contract\Mode\InitializationMode;
 9 | use AlecRabbit\Spinner\Contract\Mode\StylingMethodMode;
10 | 
11 | interface IOutputConfig extends IConfigElement
12 | {
13 |     public function getCursorVisibilityMode(): CursorVisibilityMode;
14 | 
15 |     public function getStylingMethodMode(): StylingMethodMode;
16 | 
17 |     public function getInitializationMode(): InitializationMode;
18 | 
19 |     public function getStream(): mixed;
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/IRevolverConfig.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Contract\ITolerance;
 8 | 
 9 | interface IRevolverConfig
10 | {
11 |     public function getTolerance(): ITolerance;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/IRootWidgetConfig.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract;
 6 | 
 7 | interface IRootWidgetConfig extends IWidgetConfig
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/IWidgetConfig.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IFrame;
 8 | 
 9 | interface IWidgetConfig extends IConfigElement
10 | {
11 |     public function getLeadingSpacer(): IFrame;
12 | 
13 |     public function getTrailingSpacer(): IFrame;
14 | 
15 |     public function getWidgetRevolverConfig(): IWidgetRevolverConfig;
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Contract/IWidgetRevolverConfig.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Palette\Contract\IPalette;
 8 | 
 9 | interface IWidgetRevolverConfig
10 | {
11 |     public function getStylePalette(): IPalette;
12 | 
13 |     public function getCharPalette(): IPalette;
14 | 
15 |     public function getRevolverConfig(): IRevolverConfig;
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Detector/AutoStartModeDetector.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Detector;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\AutoStartMode;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\Detector\IAutoStartModeDetector;
 9 | use AlecRabbit\Spinner\Core\Config\Contract\ILoopConfig;
10 | 
11 | final readonly class AutoStartModeDetector implements IAutoStartModeDetector
12 | {
13 |     public function __construct(
14 |         private ILoopConfig $loopConfig,
15 |     ) {
16 |     }
17 | 
18 |     public function isEnabled(): bool
19 |     {
20 |         return $this->loopConfig->getAutoStartMode() === AutoStartMode::ENABLED;
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Detector/DriverModeDetector.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Detector;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\DriverMode;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\Detector\IDriverModeDetector;
 9 | use AlecRabbit\Spinner\Core\Config\Contract\IDriverConfig;
10 | 
11 | final readonly class DriverModeDetector implements IDriverModeDetector
12 | {
13 |     public function __construct(
14 |         private IDriverConfig $driverConfig,
15 |     ) {
16 |     }
17 | 
18 |     public function isEnabled(): bool
19 |     {
20 |         return $this->driverConfig->getDriverMode() === DriverMode::ENABLED;
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Detector/InitializationModeDetector.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Detector;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\InitializationMode;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\Detector\IInitializationModeDetector;
 9 | use AlecRabbit\Spinner\Core\Config\Contract\IOutputConfig;
10 | 
11 | final readonly class InitializationModeDetector implements IInitializationModeDetector
12 | {
13 |     public function __construct(
14 |         private IOutputConfig $outputConfig,
15 |     ) {
16 |     }
17 | 
18 |     public function isEnabled(): bool
19 |     {
20 |         return $this->outputConfig->getInitializationMode() === InitializationMode::ENABLED;
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Detector/LinkerModeDetector.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Detector;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\LinkerMode;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\Detector\ILinkerModeDetector;
 9 | use AlecRabbit\Spinner\Core\Config\Contract\ILinkerConfig;
10 | 
11 | final readonly class LinkerModeDetector implements ILinkerModeDetector
12 | {
13 |     public function __construct(
14 |         private ILinkerConfig $linkerConfig,
15 |     ) {
16 |     }
17 | 
18 |     public function isEnabled(): bool
19 |     {
20 |         return $this->linkerConfig->getLinkerMode() === LinkerMode::ENABLED;
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/DriverConfig.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\DriverMode;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\IDriverConfig;
 9 | use AlecRabbit\Spinner\Core\Contract\IDriverMessages;
10 | 
11 | final readonly class DriverConfig implements IDriverConfig
12 | {
13 |     public function __construct(
14 |         private IDriverMessages $driverMessages,
15 |         private DriverMode $driverMode,
16 |     ) {
17 |     }
18 | 
19 |     public function getIdentifier(): string
20 |     {
21 |         return IDriverConfig::class;
22 |     }
23 | 
24 |     public function getDriverMessages(): IDriverMessages
25 |     {
26 |         return $this->driverMessages;
27 |     }
28 | 
29 |     public function getDriverMode(): DriverMode
30 |     {
31 |         return $this->driverMode;
32 |     }
33 | }
34 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Factory/DriverConfigFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Contract\Builder\IDriverConfigBuilder;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\Factory\IDriverConfigFactory;
 9 | use AlecRabbit\Spinner\Core\Config\Contract\IDriverConfig;
10 | use AlecRabbit\Spinner\Core\Config\Solver\Contract\IDriverMessagesSolver;
11 | use AlecRabbit\Spinner\Core\Config\Solver\Contract\IDriverModeSolver;
12 | 
13 | final readonly class DriverConfigFactory implements IDriverConfigFactory
14 | {
15 |     public function __construct(
16 |         protected IDriverConfigBuilder $driverConfigBuilder,
17 |         protected IDriverMessagesSolver $driverMessagesSolver,
18 |         protected IDriverModeSolver $driverModeSolver,
19 |     ) {
20 |     }
21 | 
22 |     public function create(): IDriverConfig
23 |     {
24 |         return $this->driverConfigBuilder
25 |             ->withDriverMessages(
26 |                 $this->driverMessagesSolver->solve()
27 |             )
28 |             ->withDriverMode(
29 |                 $this->driverModeSolver->solve()
30 |             )
31 |             ->build()
32 |         ;
33 |     }
34 | }
35 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Factory/GeneralConfigFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Contract\Builder\IGeneralConfigBuilder;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\Factory\IGeneralConfigFactory;
 9 | use AlecRabbit\Spinner\Core\Config\Contract\IGeneralConfig;
10 | use AlecRabbit\Spinner\Core\Config\Solver\Contract\IRunMethodModeSolver;
11 | 
12 | final readonly class GeneralConfigFactory implements IGeneralConfigFactory
13 | {
14 |     public function __construct(
15 |         protected IRunMethodModeSolver $runMethodModeSolver,
16 |         protected IGeneralConfigBuilder $generalConfigBuilder,
17 |     ) {
18 |     }
19 | 
20 |     public function create(): IGeneralConfig
21 |     {
22 |         return $this->generalConfigBuilder
23 |             ->withRunMethodMode(
24 |                 $this->runMethodModeSolver->solve()
25 |             )
26 |             ->build()
27 |         ;
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Factory/LinkerConfigFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Contract\Builder\ILinkerConfigBuilder;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\Factory\ILinkerConfigFactory;
 9 | use AlecRabbit\Spinner\Core\Config\Contract\ILinkerConfig;
10 | use AlecRabbit\Spinner\Core\Config\Solver\Contract\ILinkerModeSolver;
11 | 
12 | final readonly class LinkerConfigFactory implements ILinkerConfigFactory
13 | {
14 |     public function __construct(
15 |         protected ILinkerModeSolver $linkerModeSolver,
16 |         protected ILinkerConfigBuilder $linkerConfigBuilder,
17 |     ) {
18 |     }
19 | 
20 |     public function create(): ILinkerConfig
21 |     {
22 |         return $this->linkerConfigBuilder
23 |             ->withLinkerMode(
24 |                 $this->linkerModeSolver->solve(),
25 |             )
26 |             ->build()
27 |         ;
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Factory/NormalizerConfigFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Contract\Builder\INormalizerConfigBuilder;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\Factory\INormalizerConfigFactory;
 9 | use AlecRabbit\Spinner\Core\Config\Contract\INormalizerConfig;
10 | use AlecRabbit\Spinner\Core\Config\Solver\Contract\INormalizerModeSolver;
11 | 
12 | final readonly class NormalizerConfigFactory implements INormalizerConfigFactory
13 | {
14 |     public function __construct(
15 |         protected INormalizerModeSolver $normalizerModeSolver,
16 |         protected INormalizerConfigBuilder $normalizerConfigBuilder,
17 |     ) {
18 |     }
19 | 
20 |     public function create(): INormalizerConfig
21 |     {
22 |         return $this->normalizerConfigBuilder
23 |             ->withNormalizerMode(
24 |                 $this->normalizerModeSolver->solve()
25 |             )
26 |             ->build()
27 |         ;
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Factory/RevolverConfigFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Contract\Builder\IRevolverConfigBuilder;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\Factory\IRevolverConfigFactory;
 9 | use AlecRabbit\Spinner\Core\Config\Contract\IRevolverConfig;
10 | use AlecRabbit\Spinner\Core\Config\Solver\Contract\IToleranceSolver;
11 | 
12 | final readonly class RevolverConfigFactory implements IRevolverConfigFactory
13 | {
14 |     public function __construct(
15 |         protected IToleranceSolver $toleranceSolver,
16 |         protected IRevolverConfigBuilder $revolverConfigBuilder,
17 |     ) {
18 |     }
19 | 
20 |     public function create(): IRevolverConfig
21 |     {
22 |         return $this->revolverConfigBuilder
23 |             ->withTolerance(
24 |                 $this->toleranceSolver->solve()
25 |             )
26 |             ->build()
27 |         ;
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/GeneralConfig.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\RunMethodMode;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\IGeneralConfig;
 9 | 
10 | final readonly class GeneralConfig implements IGeneralConfig
11 | {
12 |     public function __construct(
13 |         protected RunMethodMode $runMethodMode,
14 |     ) {
15 |     }
16 | 
17 |     public function getRunMethodMode(): RunMethodMode
18 |     {
19 |         return $this->runMethodMode;
20 |     }
21 | 
22 |     /**
23 |      * @return class-string<IGeneralConfig>
24 |      */
25 |     public function getIdentifier(): string
26 |     {
27 |         return IGeneralConfig::class;
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/LinkerConfig.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\LinkerMode;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\ILinkerConfig;
 9 | 
10 | final readonly class LinkerConfig implements ILinkerConfig
11 | {
12 |     public function __construct(
13 |         protected LinkerMode $linkerMode,
14 |     ) {
15 |     }
16 | 
17 |     public function getLinkerMode(): LinkerMode
18 |     {
19 |         return $this->linkerMode;
20 |     }
21 | 
22 |     /**
23 |      * @return class-string<ILinkerConfig>
24 |      */
25 |     public function getIdentifier(): string
26 |     {
27 |         return ILinkerConfig::class;
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/LoopConfig.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\AutoStartMode;
 8 | use AlecRabbit\Spinner\Contract\Mode\SignalHandlingMode;
 9 | use AlecRabbit\Spinner\Core\Config\Contract\ILoopConfig;
10 | use AlecRabbit\Spinner\Core\Contract\ISignalHandlersContainer;
11 | 
12 | final readonly class LoopConfig implements ILoopConfig
13 | {
14 |     public function __construct(
15 |         protected AutoStartMode $autoStartMode,
16 |         protected SignalHandlingMode $signalHandlersMode,
17 |         protected ISignalHandlersContainer $signalHandlersContainer,
18 |     ) {
19 |     }
20 | 
21 |     public function getAutoStartMode(): AutoStartMode
22 |     {
23 |         return $this->autoStartMode;
24 |     }
25 | 
26 |     public function getSignalHandlingMode(): SignalHandlingMode
27 |     {
28 |         return $this->signalHandlersMode;
29 |     }
30 | 
31 |     /**
32 |      * @return class-string<ILoopConfig>
33 |      */
34 |     public function getIdentifier(): string
35 |     {
36 |         return ILoopConfig::class;
37 |     }
38 | 
39 |     public function getSignalHandlersContainer(): ISignalHandlersContainer
40 |     {
41 |         return $this->signalHandlersContainer;
42 |     }
43 | }
44 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/NormalizerConfig.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\NormalizerMode;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\INormalizerConfig;
 9 | 
10 | final readonly class NormalizerConfig implements INormalizerConfig
11 | {
12 |     public function __construct(
13 |         protected NormalizerMode $normalizerMode,
14 |     ) {
15 |     }
16 | 
17 |     public function getNormalizerMode(): NormalizerMode
18 |     {
19 |         return $this->normalizerMode;
20 |     }
21 | 
22 |     /**
23 |      * @return class-string<INormalizerConfig>
24 |      */
25 |     public function getIdentifier(): string
26 |     {
27 |         return INormalizerConfig::class;
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/OutputConfig.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\CursorVisibilityMode;
 8 | use AlecRabbit\Spinner\Contract\Mode\InitializationMode;
 9 | use AlecRabbit\Spinner\Contract\Mode\StylingMethodMode;
10 | use AlecRabbit\Spinner\Core\Config\Contract\IOutputConfig;
11 | 
12 | final readonly class OutputConfig implements IOutputConfig
13 | {
14 |     public function __construct(
15 |         private StylingMethodMode $stylingMethodMode,
16 |         private CursorVisibilityMode $cursorVisibilityMode,
17 |         private InitializationMode $initializationMode,
18 |         private mixed $stream,
19 |     ) {
20 |     }
21 | 
22 |     public function getStylingMethodMode(): StylingMethodMode
23 |     {
24 |         return $this->stylingMethodMode;
25 |     }
26 | 
27 |     public function getCursorVisibilityMode(): CursorVisibilityMode
28 |     {
29 |         return $this->cursorVisibilityMode;
30 |     }
31 | 
32 |     public function getInitializationMode(): InitializationMode
33 |     {
34 |         return $this->initializationMode;
35 |     }
36 | 
37 |     public function getStream(): mixed
38 |     {
39 |         return $this->stream;
40 |     }
41 | 
42 |     /**
43 |      * @return class-string<IOutputConfig>
44 |      */
45 |     public function getIdentifier(): string
46 |     {
47 |         return IOutputConfig::class;
48 |     }
49 | }
50 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/RevolverConfig.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Contract\IRevolverConfig;
 8 | use AlecRabbit\Spinner\Core\Contract\ITolerance;
 9 | use AlecRabbit\Spinner\Core\Revolver\Tolerance;
10 | 
11 | final readonly class RevolverConfig implements IRevolverConfig
12 | {
13 |     public function __construct(
14 |         protected ITolerance $tolerance = new Tolerance(),
15 |     ) {
16 |     }
17 | 
18 |     public function getTolerance(): ITolerance
19 |     {
20 |         return $this->tolerance;
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/RootWidgetConfig.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IFrame;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\IRootWidgetConfig;
 9 | use AlecRabbit\Spinner\Core\Config\Contract\IWidgetRevolverConfig;
10 | 
11 | final readonly class RootWidgetConfig implements IRootWidgetConfig
12 | {
13 |     public function __construct(
14 |         protected IFrame $leadingSpacer,
15 |         protected IFrame $trailingSpacer,
16 |         protected IWidgetRevolverConfig $revolverConfig,
17 |     ) {
18 |     }
19 | 
20 |     public function getLeadingSpacer(): IFrame
21 |     {
22 |         return $this->leadingSpacer;
23 |     }
24 | 
25 |     public function getTrailingSpacer(): IFrame
26 |     {
27 |         return $this->trailingSpacer;
28 |     }
29 | 
30 |     public function getWidgetRevolverConfig(): IWidgetRevolverConfig
31 |     {
32 |         return $this->revolverConfig;
33 |     }
34 | 
35 |     /**
36 |      * @return class-string<IRootWidgetConfig>
37 |      */
38 |     public function getIdentifier(): string
39 |     {
40 |         return IRootWidgetConfig::class;
41 |     }
42 | }
43 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Solver/A/ASolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Solver\A;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Solver\Contract\ISolver;
 8 | use AlecRabbit\Spinner\Core\Settings\Contract\ISettings;
 9 | use AlecRabbit\Spinner\Core\Settings\Contract\ISettingsElement;
10 | use AlecRabbit\Spinner\Core\Settings\Contract\ISettingsProvider;
11 | 
12 | abstract readonly class ASolver implements ISolver
13 | {
14 |     public function __construct(
15 |         protected ISettingsProvider $settingsProvider,
16 |     ) {
17 |     }
18 | 
19 |     abstract public function solve(): mixed;
20 | 
21 |     /**
22 |      * @psalm-template T of ISettingsElement
23 |      *
24 |      * @psalm-param ISettings $settings
25 |      * @psalm-param class-string<T> $id
26 |      *
27 |      * @psalm-return T|null
28 |      */
29 |     protected function extractSettingsElement(ISettings $settings, string $id): ?ISettingsElement
30 |     {
31 |         return $settings->get($id);
32 |     }
33 | }
34 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Solver/Contract/IAutoStartModeSolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Solver\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\AutoStartMode;
 8 | 
 9 | interface IAutoStartModeSolver extends ISolver
10 | {
11 |     public function solve(): AutoStartMode;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Solver/Contract/ICursorVisibilityModeSolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Solver\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\CursorVisibilityMode;
 8 | 
 9 | interface ICursorVisibilityModeSolver extends ISolver
10 | {
11 |     public function solve(): CursorVisibilityMode;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Solver/Contract/IDriverMessagesSolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Solver\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Contract\IDriverMessages;
 8 | 
 9 | interface IDriverMessagesSolver extends ISolver
10 | {
11 |     public function solve(): IDriverMessages;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Solver/Contract/IDriverModeSolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Solver\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\DriverMode;
 8 | 
 9 | interface IDriverModeSolver extends ISolver
10 | {
11 |     public function solve(): DriverMode;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Solver/Contract/IInitializationModeSolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Solver\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\InitializationMode;
 8 | 
 9 | interface IInitializationModeSolver extends ISolver
10 | {
11 |     public function solve(): InitializationMode;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Solver/Contract/ILinkerModeSolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Solver\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\LinkerMode;
 8 | 
 9 | interface ILinkerModeSolver extends ISolver
10 | {
11 |     public function solve(): LinkerMode;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Solver/Contract/INormalizerModeSolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Solver\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\NormalizerMode;
 8 | 
 9 | interface INormalizerModeSolver extends ISolver
10 | {
11 |     public function solve(): NormalizerMode;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Solver/Contract/IRootWidgetSettingsSolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Solver\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Settings\Contract\IRootWidgetSettings;
 8 | 
 9 | interface IRootWidgetSettingsSolver extends ISolver
10 | {
11 |     public function solve(): IRootWidgetSettings;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Solver/Contract/IRunMethodModeSolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Solver\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\RunMethodMode;
 8 | 
 9 | interface IRunMethodModeSolver extends ISolver
10 | {
11 |     public function solve(): RunMethodMode;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Solver/Contract/ISignalHandlersContainerSolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Solver\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Contract\ISignalHandlersContainer;
 8 | 
 9 | interface ISignalHandlersContainerSolver extends ISolver
10 | {
11 |     public function solve(): ISignalHandlersContainer;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Solver/Contract/ISignalHandlingModeSolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Solver\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\SignalHandlingMode;
 8 | 
 9 | interface ISignalHandlingModeSolver extends ISolver
10 | {
11 |     public function solve(): SignalHandlingMode;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Solver/Contract/ISolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Solver\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Exception\InvalidArgument;
 8 | use AlecRabbit\Spinner\Exception\LogicException;
 9 | 
10 | interface ISolver
11 | {
12 |     /**
13 |      * @throws InvalidArgument
14 |      * @throws LogicException
15 |      */
16 |     public function solve(): mixed;
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Solver/Contract/IStreamSolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Solver\Contract;
 6 | 
 7 | interface IStreamSolver extends ISolver
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Solver/Contract/IStylingMethodModeSolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Solver\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\StylingMethodMode;
 8 | 
 9 | interface IStylingMethodModeSolver extends ISolver
10 | {
11 |     public function solve(): StylingMethodMode;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Solver/Contract/IToleranceSolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Solver\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Contract\ITolerance;
 8 | 
 9 | interface IToleranceSolver extends ISolver
10 | {
11 |     public function solve(): ITolerance;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Solver/Contract/IWidgetSettingsSolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Solver\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Settings\Contract\IWidgetSettings;
 8 | 
 9 | interface IWidgetSettingsSolver extends ISolver
10 | {
11 |     public function solve(): IWidgetSettings;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/Solver/StreamSolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config\Solver;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Solver\A\ASolver;
 8 | use AlecRabbit\Spinner\Core\Settings\Contract\IOutputSettings;
 9 | use AlecRabbit\Spinner\Core\Settings\Contract\ISettings;
10 | use AlecRabbit\Spinner\Exception\InvalidArgument;
11 | 
12 | final readonly class StreamSolver extends ASolver implements Contract\IStreamSolver
13 | {
14 |     public function solve(): mixed
15 |     {
16 |         return $this->doSolve(
17 |             $this->extractStream($this->settingsProvider->getUserSettings()),
18 |             $this->extractStream($this->settingsProvider->getDetectedSettings()),
19 |             $this->extractStream($this->settingsProvider->getDefaultSettings()),
20 |         );
21 |     }
22 | 
23 |     private function doSolve(
24 |         mixed $userStream,
25 |         mixed $detectedStream,
26 |         mixed $defaultStream
27 |     ): mixed {
28 |         return $userStream
29 |             ?? $detectedStream
30 |             ?? $defaultStream
31 |             ?? throw new InvalidArgument(
32 |                 'Unable to solve "stream".'
33 |             );
34 |     }
35 | 
36 |     protected function extractStream(ISettings $settings): mixed
37 |     {
38 |         return $this->extractSettingsElement($settings, IOutputSettings::class)?->getStream();
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/WidgetConfig.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IFrame;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\IWidgetConfig;
 9 | use AlecRabbit\Spinner\Core\Config\Contract\IWidgetRevolverConfig;
10 | 
11 | final readonly class WidgetConfig implements IWidgetConfig
12 | {
13 |     public function __construct(
14 |         protected IFrame $leadingSpacer,
15 |         protected IFrame $trailingSpacer,
16 |         protected IWidgetRevolverConfig $revolverConfig,
17 |     ) {
18 |     }
19 | 
20 |     public function getLeadingSpacer(): IFrame
21 |     {
22 |         return $this->leadingSpacer;
23 |     }
24 | 
25 |     public function getTrailingSpacer(): IFrame
26 |     {
27 |         return $this->trailingSpacer;
28 |     }
29 | 
30 |     public function getWidgetRevolverConfig(): IWidgetRevolverConfig
31 |     {
32 |         return $this->revolverConfig;
33 |     }
34 | 
35 |     /**
36 |      * @return class-string<IWidgetConfig>
37 |      */
38 |     public function getIdentifier(): string
39 |     {
40 |         return IWidgetConfig::class;
41 |     }
42 | }
43 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Config/WidgetRevolverConfig.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Config;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Contract\IRevolverConfig;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\IWidgetRevolverConfig;
 9 | use AlecRabbit\Spinner\Core\Palette\Contract\IPalette;
10 | 
11 | final readonly class WidgetRevolverConfig implements IWidgetRevolverConfig
12 | {
13 |     public function __construct(
14 |         protected IPalette $stylePalette,
15 |         protected IPalette $charPalette,
16 |         protected IRevolverConfig $revolverConfig,
17 |     ) {
18 |     }
19 | 
20 |     public function getStylePalette(): IPalette
21 |     {
22 |         return $this->stylePalette;
23 |     }
24 | 
25 |     public function getCharPalette(): IPalette
26 |     {
27 |         return $this->charPalette;
28 |     }
29 | 
30 |     public function getRevolverConfig(): IRevolverConfig
31 |     {
32 |         return $this->revolverConfig;
33 |     }
34 | }
35 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Contract/ICharFrame.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IFrame;
 8 | 
 9 | interface ICharFrame extends IFrame
10 | {
11 |     public static function createEmpty(): ICharFrame;
12 | 
13 |     public static function createSpace(): ICharFrame;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Contract/IDriver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IFinalizable;
 8 | use AlecRabbit\Spinner\Contract\IHasInterval;
 9 | use AlecRabbit\Spinner\Contract\IInitializable;
10 | use AlecRabbit\Spinner\Contract\IObserver;
11 | use AlecRabbit\Spinner\Contract\IRenderable;
12 | use AlecRabbit\Spinner\Contract\ISubject;
13 | use Closure;
14 | 
15 | interface IDriver extends IObserver,
16 |                           ISubject,
17 |                           IRenderable,
18 |                           IHasInterval,
19 |                           IInitializable,
20 |                           IFinalizable
21 | {
22 |     /**
23 |      * Adds spinner to the driver.
24 |      */
25 |     public function add(ISpinner $spinner): void;
26 | 
27 |     /**
28 |      * Checks if spinner is in the driver.
29 |      */
30 |     public function has(ISpinner $spinner): bool;
31 | 
32 |     /**
33 |      * Removes spinner from the driver. Fails silently if spinner is not in the driver.
34 |      */
35 |     public function remove(ISpinner $spinner): void;
36 | 
37 |     public function interrupt(?string $interruptMessage = null): void;
38 | 
39 |     /**
40 |      * Wraps a user callback with erase and render methods calls. Returns wrapped callback.
41 |      *
42 |      * @return Closure(): void
43 |      */
44 |     public function wrap(Closure $callback): Closure;
45 | }
46 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Contract/IDriverBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IDeltaTimer;
 8 | use AlecRabbit\Spinner\Contract\IInterval;
 9 | use AlecRabbit\Spinner\Contract\IObserver;
10 | use AlecRabbit\Spinner\Exception\LogicException;
11 | 
12 | interface IDriverBuilder
13 | {
14 |     /**
15 |      * @throws LogicException
16 |      */
17 |     public function build(): IDriver;
18 | 
19 |     public function withInitialInterval(IInterval $interval): IDriverBuilder;
20 | 
21 |     public function withDeltaTimer(IDeltaTimer $timer): IDriverBuilder;
22 | 
23 |     public function withObserver(IObserver $observer): IDriverBuilder;
24 | 
25 |     public function withIntervalComparator(IIntervalComparator $intervalComparator): IDriverBuilder;
26 | 
27 |     public function withDriverMessages(IDriverMessages $driverMessages): IDriverBuilder;
28 | 
29 |     public function withRenderer(IRenderer $renderer): IDriverBuilder;
30 | }
31 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Contract/IDriverLinker.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IObserver;
 8 | use AlecRabbit\Spinner\Exception\InvalidArgument;
 9 | use AlecRabbit\Spinner\Exception\LogicException;
10 | 
11 | interface IDriverLinker extends IObserver
12 | {
13 |     /**
14 |      * @throws LogicException
15 |      * @throws InvalidArgument
16 |      */
17 |     public function link(IDriver $driver): void;
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Contract/IDriverMessages.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Contract;
 6 | 
 7 | interface IDriverMessages
 8 | {
 9 |     public function getFinalMessage(): string;
10 | 
11 |     public function getInterruptionMessage(): string;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Contract/IDriverProvider.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Contract;
 6 | 
 7 | interface IDriverProvider
 8 | {
 9 |     public function getDriver(): IDriver;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Contract/IDriverSetup.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Contract;
 6 | 
 7 | interface IDriverSetup
 8 | {
 9 |     public function setup(IDriver $driver): void;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Contract/IFrameCollection.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IFrame;
 8 | use ArrayAccess;
 9 | use Countable;
10 | 
11 | /**
12 |  * @template T of IFrame
13 |  *
14 |  * @extends ArrayAccess<int,T>
15 |  */
16 | interface IFrameCollection extends Countable, ArrayAccess
17 | {
18 |     /**
19 |      * @psalm-return T
20 |      */
21 |     public function get(int $index): IFrame;
22 | 
23 |     public function lastIndex(): int;
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Contract/IIntegerNormalizer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Contract;
 6 | 
 7 | interface IIntegerNormalizer
 8 | {
 9 |     public function normalize(int $interval): int;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Contract/IIntervalComparator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IInterval;
 8 | 
 9 | interface IIntervalComparator
10 | {
11 |     public function smallest(IInterval $first, ?IInterval ...$other): IInterval;
12 | 
13 |     public function largest(IInterval $first, ?IInterval ...$other): IInterval;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Contract/IIntervalNormalizer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IInterval;
 8 | 
 9 | interface IIntervalNormalizer
10 | {
11 |     public function normalize(IInterval $interval): IInterval;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Contract/IPoint.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Contract;
 6 | 
 7 | interface IPoint
 8 | {
 9 |     public function getX(): int;
10 | 
11 |     public function getY(): int;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Contract/IPositionedSequenceState.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Contract;
 6 | 
 7 | interface IPositionedSequenceState extends ISequenceState
 8 | {
 9 |     public function getPosition(): IPoint;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Contract/IRenderer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IFinalizable;
 8 | use AlecRabbit\Spinner\Contract\IInitializable;
 9 | 
10 | interface IRenderer extends IInitializable, IFinalizable
11 | {
12 |     public function render(ISpinner $spinner, ?float $dt = null): void;
13 | 
14 |     public function erase(ISpinner $spinner): void;
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Contract/ISequenceState.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Contract;
 6 | 
 7 | interface ISequenceState
 8 | {
 9 |     public function getPreviousWidth(): int;
10 | 
11 |     public function getSequence(): string;
12 | 
13 |     public function getWidth(): int;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Contract/ISignalHandlersContainer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Settings\Contract\IHandlerCreator;
 8 | use Traversable;
 9 | 
10 | interface ISignalHandlersContainer
11 | {
12 |     /**
13 |      * @return Traversable<int, IHandlerCreator>
14 |      */
15 |     public function getHandlerCreators(): Traversable;
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Contract/ISignalHandlingSetup.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Contract;
 6 | 
 7 | interface ISignalHandlingSetup
 8 | {
 9 |     public function setup(IDriver $driver): void;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Contract/ISpinner.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IHasFrame;
 8 | use AlecRabbit\Spinner\Contract\IHasInterval;
 9 | use AlecRabbit\Spinner\Contract\IObserver;
10 | use AlecRabbit\Spinner\Contract\ISubject;
11 | use AlecRabbit\Spinner\Core\Widget\Contract\IWidgetContext;
12 | 
13 | interface ISpinner extends IObserver,
14 |                            ISubject,
15 |                            IHasInterval,
16 |                            IHasFrame
17 | {
18 |     public function add(IWidgetContext $element): IWidgetContext;
19 | 
20 |     public function remove(IWidgetContext $element): void;
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Contract/IStyleFrame.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IFrame;
 8 | 
 9 | interface IStyleFrame extends IFrame
10 | {
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Contract/ITolerance.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Contract;
 6 | 
 7 | interface ITolerance
 8 | {
 9 |     final public const DEFAULT_VALUE = 5; // milliseconds
10 | 
11 |     public function toMilliseconds(): int;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Contract/IWeakMap.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Contract;
 6 | 
 7 | use ArrayAccess;
 8 | use Countable;
 9 | use IteratorAggregate;
10 | 
11 | /**
12 |  * @template TKey
13 |  * @template TValue
14 |  *
15 |  * @extends ArrayAccess<TKey, TValue>
16 |  * @extends IteratorAggregate<TKey, TValue>
17 |  */
18 | interface IWeakMap extends ArrayAccess, Countable, IteratorAggregate
19 | {
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/DeltaTimer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IDeltaTimer;
 8 | use AlecRabbit\Spinner\Contract\INowTimer;
 9 | 
10 | final class DeltaTimer implements IDeltaTimer
11 | {
12 |     private float $current;
13 | 
14 |     public function __construct(
15 |         private readonly INowTimer $nowTimer,
16 |         float $startTime = 0.0,
17 |     ) {
18 |         $this->current = $startTime;
19 |     }
20 | 
21 |     public function getDelta(): float
22 |     {
23 |         $last = $this->current;
24 |         $this->current = $this->nowTimer->now();
25 |         return $this->current - $last;
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/DriverMessages.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Contract\IDriverMessages;
 8 | 
 9 | final readonly class DriverMessages implements IDriverMessages
10 | {
11 |     public function __construct(
12 |         private string $finalMessage,
13 |         private string $interruptionMessage,
14 |     ) {
15 |     }
16 | 
17 |     public function getFinalMessage(): string
18 |     {
19 |         return $this->finalMessage;
20 |     }
21 | 
22 |     public function getInterruptionMessage(): string
23 |     {
24 |         return $this->interruptionMessage;
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/DriverProvider.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Contract\IDriver;
 8 | use AlecRabbit\Spinner\Core\Contract\IDriverProvider;
 9 | 
10 | final readonly class DriverProvider implements IDriverProvider
11 | {
12 |     public function __construct(
13 |         private IDriver $driver,
14 |     ) {
15 |     }
16 | 
17 |     public function getDriver(): IDriver
18 |     {
19 |         return $this->driver;
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/DriverSetup.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Contract\IDriver;
 8 | use AlecRabbit\Spinner\Core\Contract\IDriverLinker;
 9 | use AlecRabbit\Spinner\Core\Contract\IDriverSetup;
10 | use AlecRabbit\Spinner\Core\Contract\ISignalHandlingSetup;
11 | 
12 | final readonly class DriverSetup implements IDriverSetup
13 | {
14 |     public function __construct(
15 |         private IDriverLinker $driverLinker,
16 |         private ISignalHandlingSetup $signalHandlingSetup,
17 |     ) {
18 |     }
19 | 
20 |     public function setup(IDriver $driver): void
21 |     {
22 |         $this->driverLinker->link($driver);
23 | 
24 |         $this->signalHandlingSetup->setup($driver);
25 | 
26 |         $driver->initialize();
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/DummyDriverLinker.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\ISubject;
 8 | use AlecRabbit\Spinner\Core\Contract\IDriver;
 9 | use AlecRabbit\Spinner\Core\Contract\IDriverLinker;
10 | 
11 | /**
12 |  * @codeCoverageIgnore
13 |  */
14 | final class DummyDriverLinker implements IDriverLinker
15 | {
16 |     public function link(IDriver $driver): void
17 |     {
18 |         // do nothing
19 |     }
20 | 
21 |     public function update(ISubject $subject): void
22 |     {
23 |         // do nothing
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/DummySignalHandlingSetup.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Contract\IDriver;
 8 | use AlecRabbit\Spinner\Core\Contract\ISignalHandlingSetup;
 9 | 
10 | /**
11 |  * @codeCoverageIgnore
12 |  */
13 | final class DummySignalHandlingSetup implements ISignalHandlingSetup
14 | {
15 |     public function setup(IDriver $driver): void
16 |     {
17 |         // do nothing
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Factory/A/ADriverProviderFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Factory\A;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Contract\IDriverProvider;
 8 | use AlecRabbit\Spinner\Core\Contract\IDriverSetup;
 9 | use AlecRabbit\Spinner\Core\DriverProvider;
10 | use AlecRabbit\Spinner\Core\Factory\Contract\IDriverFactory;
11 | use AlecRabbit\Spinner\Core\Factory\Contract\IDriverProviderFactory;
12 | 
13 | abstract class ADriverProviderFactory implements IDriverProviderFactory
14 | {
15 |     public function __construct(
16 |         protected IDriverFactory $driverFactory,
17 |         protected IDriverSetup $driverSetup,
18 |     ) {
19 |     }
20 | 
21 |     public function create(): IDriverProvider
22 |     {
23 |         $driver = $this->driverFactory->create();
24 | 
25 |         $driverProvider =
26 |             new DriverProvider(
27 |                 driver: $driver,
28 |             );
29 | 
30 |         $this->driverSetup->setup($driver);
31 | 
32 |         return $driverProvider;
33 |     }
34 | }
35 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Factory/ConsoleCursorFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Builder\Contract\IConsoleCursorBuilder;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\IOutputConfig;
 9 | use AlecRabbit\Spinner\Core\Factory\Contract\IConsoleCursorFactory;
10 | use AlecRabbit\Spinner\Core\Output\Contract\IBuffer;
11 | use AlecRabbit\Spinner\Core\Output\Contract\IConsoleCursor;
12 | 
13 | final class ConsoleCursorFactory implements IConsoleCursorFactory
14 | {
15 |     public function __construct(
16 |         protected IBuffer $buffer,
17 |         protected IConsoleCursorBuilder $cursorBuilder,
18 |         protected IOutputConfig $outputConfig,
19 |     ) {
20 |     }
21 | 
22 |     public function create(): IConsoleCursor
23 |     {
24 |         return $this->cursorBuilder
25 |             ->withBuffer(
26 |                 $this->buffer
27 |             )
28 |             ->withCursorVisibilityMode(
29 |                 $this->outputConfig->getCursorVisibilityMode()
30 |             )
31 |             ->build()
32 |         ;
33 |     }
34 | }
35 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Factory/Contract/IAnsiColorConverterFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Factory\Contract;
 6 | 
 7 | interface IAnsiColorConverterFactory
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Factory/Contract/ICharFrameRevolverFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Factory\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Pattern\IPattern;
 8 | use AlecRabbit\Spinner\Core\Revolver\Contract\IFrameRevolver;
 9 | 
10 | interface ICharFrameRevolverFactory
11 | {
12 |     public function create(IPattern $pattern): IFrameRevolver;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Factory/Contract/IConsoleCursorFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Factory\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Output\Contract\IConsoleCursor;
 8 | 
 9 | interface IConsoleCursorFactory
10 | {
11 |     public function create(): IConsoleCursor;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Factory/Contract/IDeltaTimerFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Factory\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IDeltaTimer;
 8 | 
 9 | interface IDeltaTimerFactory
10 | {
11 |     public function create(): IDeltaTimer;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Factory/Contract/IDriverFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Factory\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Contract\IDriver;
 8 | 
 9 | interface IDriverFactory
10 | {
11 |     public function create(): IDriver;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Factory/Contract/IDriverLinkerFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Factory\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Contract\IDriverLinker;
 8 | 
 9 | interface IDriverLinkerFactory
10 | {
11 |     public function create(): IDriverLinker;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Factory/Contract/IDriverProviderFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Factory\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Contract\IDriverProvider;
 8 | 
 9 | interface IDriverProviderFactory
10 | {
11 |     public function create(): IDriverProvider;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Factory/Contract/IFrameCollectionFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Factory\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Contract\IFrameCollection;
 8 | use Traversable;
 9 | 
10 | interface IFrameCollectionFactory
11 | {
12 |     public function create(Traversable $frames): IFrameCollection;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Factory/Contract/IIntervalFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Factory\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IInterval;
 8 | 
 9 | interface IIntervalFactory
10 | {
11 |     public function createDefault(): IInterval;
12 | 
13 |     public function createNormalized(?int $interval): IInterval;
14 | 
15 |     public function createStill(): IInterval;
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Factory/Contract/IIntervalNormalizerFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Factory\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Contract\IIntervalNormalizer;
 8 | 
 9 | interface IIntervalNormalizerFactory
10 | {
11 |     public function create(): IIntervalNormalizer;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Factory/Contract/ILoopFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Factory\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Loop\Contract\ILoop;
 8 | 
 9 | interface ILoopFactory
10 | {
11 |     public function create(): ILoop;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Factory/Contract/ILoopProviderFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Factory\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Loop\Contract\ILoopProvider;
 8 | 
 9 | interface ILoopProviderFactory
10 | {
11 |     public function create(): ILoopProvider;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Factory/Contract/ISequenceStateWriterFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Factory\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Output\Contract\ISequenceStateWriter;
 8 | 
 9 | interface ISequenceStateWriterFactory
10 | {
11 |     public function create(): ISequenceStateWriter;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Factory/Contract/ISignalHandlingSetupFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Factory\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Contract\ISignalHandlingSetup;
 8 | 
 9 | interface ISignalHandlingSetupFactory
10 | {
11 |     public function create(): ISignalHandlingSetup;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Factory/Contract/ISpinnerFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Factory\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Contract\ISpinner;
 8 | use AlecRabbit\Spinner\Core\Settings\Contract\ISpinnerSettings;
 9 | 
10 | interface ISpinnerFactory
11 | {
12 |     public function create(?ISpinnerSettings $spinnerSettings = null): ISpinner;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Factory/Contract/IStyleFrameRevolverFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Factory\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Pattern\IPattern;
 8 | use AlecRabbit\Spinner\Core\Revolver\Contract\IFrameRevolver;
 9 | 
10 | interface IStyleFrameRevolverFactory
11 | {
12 |     public function create(IPattern $pattern): IFrameRevolver;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Factory/DeltaTimerFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IDeltaTimer;
 8 | use AlecRabbit\Spinner\Contract\INowTimer;
 9 | use AlecRabbit\Spinner\Core\Builder\Contract\IDeltaTimerBuilder;
10 | use AlecRabbit\Spinner\Core\Factory\Contract\IDeltaTimerFactory;
11 | 
12 | final readonly class DeltaTimerFactory implements IDeltaTimerFactory
13 | {
14 |     public function __construct(
15 |         private IDeltaTimerBuilder $timerBuilder,
16 |         private INowTimer $nowTimer,
17 |         private float $startTime = 0.0,
18 |     ) {
19 |     }
20 | 
21 |     public function create(): IDeltaTimer
22 |     {
23 |         return $this->timerBuilder
24 |             ->withStartTime($this->startTime)
25 |             ->withNowTimer($this->nowTimer)
26 |             ->build()
27 |         ;
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Factory/DriverLinkerFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Contract\IDriverLinker;
 8 | use AlecRabbit\Spinner\Core\DriverLinker;
 9 | use AlecRabbit\Spinner\Core\DummyDriverLinker;
10 | use AlecRabbit\Spinner\Core\Factory\Contract\IDriverLinkerFactory;
11 | use AlecRabbit\Spinner\Core\Feature\Resolver\Contract\ILinkerResolver;
12 | use AlecRabbit\Spinner\Core\Loop\Contract\ILoopProvider;
13 | 
14 | final readonly class DriverLinkerFactory implements IDriverLinkerFactory
15 | {
16 |     public function __construct(
17 |         private ILoopProvider $loopProvider,
18 |         private ILinkerResolver $linkerResolver,
19 |     ) {
20 |     }
21 | 
22 |     public function create(): IDriverLinker
23 |     {
24 |         if ($this->isLinkerEnabled()) {
25 |             return new DriverLinker(
26 |                 loop: $this->loopProvider->getLoop(),
27 |             );
28 |         }
29 | 
30 |         return new DummyDriverLinker();
31 |     }
32 | 
33 |     private function isLinkerEnabled(): bool
34 |     {
35 |         return $this->loopProvider->hasLoop() && $this->linkerResolver->isEnabled();
36 |     }
37 | }
38 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Factory/DriverProviderFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Factory\A\ADriverProviderFactory;
 8 | 
 9 | final class DriverProviderFactory extends ADriverProviderFactory
10 | {
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Factory/FrameCollectionFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Contract\IFrameCollection;
 8 | use AlecRabbit\Spinner\Core\Factory\Contract\IFrameCollectionFactory;
 9 | use AlecRabbit\Spinner\Core\FrameCollection;
10 | use Traversable;
11 | 
12 | final class FrameCollectionFactory implements IFrameCollectionFactory
13 | {
14 |     public function create(Traversable $frames): IFrameCollection
15 |     {
16 |         return new FrameCollection($frames);
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Factory/SignalHandlingSetupFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\SignalHandlingMode;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\ILoopConfig;
 9 | use AlecRabbit\Spinner\Core\Contract\ISignalHandlingSetup;
10 | use AlecRabbit\Spinner\Core\DummySignalHandlingSetup;
11 | use AlecRabbit\Spinner\Core\Loop\Contract\ILoopProvider;
12 | use AlecRabbit\Spinner\Core\SignalHandlingSetup;
13 | 
14 | final class SignalHandlingSetupFactory implements Contract\ISignalHandlingSetupFactory
15 | {
16 |     public function __construct(
17 |         protected ILoopProvider $loopProvider,
18 |         protected ILoopConfig $loopConfig,
19 |     ) {
20 |     }
21 | 
22 |     public function create(): ISignalHandlingSetup
23 |     {
24 |         if ($this->loopProvider->hasLoop() && $this->isSignalHandlingEnabled()) {
25 |             return new SignalHandlingSetup(
26 |                 $this->loopProvider->getLoop(),
27 |                 $this->loopConfig,
28 |             );
29 |         }
30 | 
31 |         return new DummySignalHandlingSetup();
32 |     }
33 | 
34 |     private function isSignalHandlingEnabled(): bool
35 |     {
36 |         return $this->loopConfig->getSignalHandlingMode() === SignalHandlingMode::ENABLED;
37 |     }
38 | }
39 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Feature/Resolver/AutoStartResolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Feature\Resolver;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Contract\Detector\IAutoStartModeDetector;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\Detector\IDriverModeDetector;
 9 | use AlecRabbit\Spinner\Core\Feature\Resolver\Contract\IAutoStartResolver;
10 | 
11 | final readonly class AutoStartResolver implements IAutoStartResolver
12 | {
13 |     public function __construct(
14 |         private IDriverModeDetector $driverModeDetector,
15 |         private IAutoStartModeDetector $autoStartModeDetector,
16 |     ) {
17 |     }
18 | 
19 |     public function isEnabled(): bool
20 |     {
21 |         return $this->driverModeDetector->isEnabled() && $this->autoStartModeDetector->isEnabled();
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Feature/Resolver/Contract/IAutoStartResolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Feature\Resolver\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IHasIsEnabled;
 8 | 
 9 | interface IAutoStartResolver extends IHasIsEnabled
10 | {
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Feature/Resolver/Contract/IInitializationResolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Feature\Resolver\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IHasIsEnabled;
 8 | 
 9 | interface IInitializationResolver extends IHasIsEnabled
10 | {
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Feature/Resolver/Contract/ILinkerResolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Feature\Resolver\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IHasIsEnabled;
 8 | 
 9 | interface ILinkerResolver extends IHasIsEnabled
10 | {
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Feature/Resolver/InitializationResolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Feature\Resolver;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Contract\Detector\IDriverModeDetector;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\Detector\IInitializationModeDetector;
 9 | use AlecRabbit\Spinner\Core\Feature\Resolver\Contract\IInitializationResolver;
10 | 
11 | final readonly class InitializationResolver implements IInitializationResolver
12 | {
13 |     public function __construct(
14 |         private IDriverModeDetector $driverModeDetector,
15 |         private IInitializationModeDetector $initializationModeDetector,
16 |     ) {
17 |     }
18 | 
19 |     public function isEnabled(): bool
20 |     {
21 |         return $this->driverModeDetector->isEnabled() && $this->initializationModeDetector->isEnabled();
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Feature/Resolver/LinkerResolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Feature\Resolver;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Contract\Detector\IDriverModeDetector;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\Detector\ILinkerModeDetector;
 9 | use AlecRabbit\Spinner\Core\Feature\Resolver\Contract\ILinkerResolver;
10 | 
11 | final readonly class LinkerResolver implements ILinkerResolver
12 | {
13 |     public function __construct(
14 |         private ILinkerModeDetector $linkerModeDetector,
15 |         private IDriverModeDetector $driverModeDetector,
16 |     ) {
17 |     }
18 | 
19 |     public function isEnabled(): bool
20 |     {
21 |         return $this->linkerModeDetector->isEnabled() && $this->driverModeDetector->isEnabled();
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/IntervalComparator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IInterval;
 8 | use AlecRabbit\Spinner\Core\Contract\IIntervalComparator;
 9 | 
10 | final readonly class IntervalComparator implements IIntervalComparator
11 | {
12 |     public function smallest(IInterval $first, ?IInterval ...$other): IInterval
13 |     {
14 |         $smallest = $first;
15 | 
16 |         foreach ($other as $interval) {
17 |             if ($interval instanceof IInterval && $interval->toMicroseconds() < $smallest->toMicroseconds()) {
18 |                 $smallest = $interval;
19 |             }
20 |         }
21 | 
22 |         return $smallest;
23 |     }
24 | 
25 |     public function largest(IInterval $first, ?IInterval ...$other): IInterval
26 |     {
27 |         $largest = $first;
28 | 
29 |         foreach ($other as $interval) {
30 |             if ($interval instanceof IInterval && $interval->toMicroseconds() > $largest->toMicroseconds()) {
31 |                 $largest = $interval;
32 |             }
33 |         }
34 | 
35 |         return $largest;
36 |     }
37 | }
38 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/IntervalNormalizer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IInterval;
 8 | use AlecRabbit\Spinner\Core\Contract\IIntegerNormalizer;
 9 | use AlecRabbit\Spinner\Core\Contract\IIntervalNormalizer;
10 | 
11 | final readonly class IntervalNormalizer implements IIntervalNormalizer
12 | {
13 |     public function __construct(
14 |         private IIntegerNormalizer $integerNormalizer,
15 |     ) {
16 |     }
17 | 
18 |     public function normalize(IInterval $interval): IInterval
19 |     {
20 |         return new Interval(
21 |             $this->integerNormalizer->normalize((int)$interval->toMilliseconds())
22 |         );
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Loop/Contract/A/ALoopAdapter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Loop\Contract\A;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Loop\Contract\ILoop;
 8 | 
 9 | /**
10 |  * @codeCoverageIgnore
11 |  */
12 | abstract class ALoopAdapter implements ILoop
13 | {
14 |     protected static function error(): bool
15 |     {
16 |         // [889ad594-ca28-4770-bb38-fd5bd8cb1777]:
17 |         // will be `null` if error handler set by `set_error_handler()` successfully handled the error
18 |         $error = error_get_last();
19 | 
20 |         return (bool)(($error['type'] ?? 0)
21 |             &
22 |             (E_ERROR | E_CORE_ERROR | E_COMPILE_ERROR | E_USER_ERROR | E_RECOVERABLE_ERROR));
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Loop/Contract/A/ALoopProbe.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Loop\Contract\A;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Loop\Contract\ILoopCreator;
 8 | use AlecRabbit\Spinner\Core\Loop\Contract\ILoopProbe;
 9 | 
10 | /**
11 |  * @codeCoverageIgnore
12 |  */
13 | abstract class ALoopProbe implements ILoopProbe
14 | {
15 |     abstract public static function isSupported(): bool;
16 | 
17 |     /**
18 |      * @return class-string<ILoopCreator>
19 |      */
20 |     abstract public static function getCreatorClass(): string;
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Loop/Contract/ILoop.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Loop\Contract;
 6 | 
 7 | use Closure;
 8 | 
 9 | interface ILoop
10 | {
11 |     public function run(): void;
12 | 
13 |     public function stop(): void;
14 | 
15 |     public function repeat(float $interval, Closure $closure): mixed;
16 | 
17 |     public function cancel(mixed $timer): void;
18 | 
19 |     public function delay(float $delay, Closure $closure): void;
20 | 
21 |     public function onSignal(int $signal, Closure $closure): void;
22 | 
23 |     public function autoStart(): void;
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Loop/Contract/ILoopCreator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Loop\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\ICreator;
 8 | 
 9 | interface ILoopCreator extends ICreator
10 | {
11 |     public function create(): ILoop;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Loop/Contract/ILoopCreatorClassExtractor.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Loop\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\ICreator;
 8 | use AlecRabbit\Spinner\Contract\Probe\IStaticProbe;
 9 | use Traversable;
10 | 
11 | interface ILoopCreatorClassExtractor
12 | {
13 |     /**
14 |      * @psalm-param Traversable<class-string<IStaticProbe>> $probes
15 |      *
16 |      * @psalm-return class-string<ICreator>|null
17 |      */
18 |     public function extract(Traversable $probes): ?string;
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Loop/Contract/ILoopCreatorClassProvider.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Loop\Contract;
 6 | 
 7 | interface ILoopCreatorClassProvider
 8 | {
 9 |     /** @return class-string<ILoopCreator>|null */
10 |     public function getCreatorClass(): ?string;
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Loop/Contract/ILoopProbe.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Loop\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Probe\IStaticProbe;
 8 | 
 9 | interface ILoopProbe extends IStaticProbe
10 | {
11 |     /**
12 |      * @return class-string<ILoopCreator>
13 |      */
14 |     public static function getCreatorClass(): string;
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Loop/Contract/ILoopProvider.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Loop\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Exception\DomainException;
 8 | 
 9 | interface ILoopProvider
10 | {
11 |     /**
12 |      * @throws DomainException
13 |      */
14 |     public function getLoop(): ILoop;
15 | 
16 |     public function hasLoop(): bool;
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Loop/Contract/ILoopSetup.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Loop\Contract;
 6 | 
 7 | interface ILoopSetup
 8 | {
 9 |     public function setup(ILoop $loop): void;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Loop/LoopCreatorClassExtractor.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Loop;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Probe\IStaticProbe;
 8 | use AlecRabbit\Spinner\Core\Loop\Contract\ILoopCreatorClassExtractor;
 9 | use AlecRabbit\Spinner\Core\Loop\Contract\ILoopProbe;
10 | use AlecRabbit\Spinner\Exception\InvalidArgument;
11 | use Traversable;
12 | 
13 | final class LoopCreatorClassExtractor implements ILoopCreatorClassExtractor
14 | {
15 |     public function extract(Traversable $probes): ?string
16 |     {
17 |         /** @var IStaticProbe $probe */
18 |         foreach ($probes as $probe) {
19 |             self::assertProbe($probe);
20 |             if ($probe::isSupported()) {
21 |                 return $probe::getCreatorClass();
22 |             }
23 |         }
24 |         return null;
25 |     }
26 | 
27 |     private static function assertProbe(mixed $probe): void
28 |     {
29 |         if (!is_a($probe, ILoopProbe::class, true)) {
30 |             throw new InvalidArgument(
31 |                 sprintf(
32 |                     'Probe must be an instance of "%s" interface.',
33 |                     ILoopProbe::class
34 |                 )
35 |             );
36 |         }
37 |     }
38 | }
39 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Loop/LoopProvider.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Loop;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Loop\Contract\ILoop;
 8 | use AlecRabbit\Spinner\Core\Loop\Contract\ILoopProvider;
 9 | use AlecRabbit\Spinner\Exception\DomainException;
10 | 
11 | final readonly class LoopProvider implements ILoopProvider
12 | {
13 |     public function __construct(
14 |         protected ?ILoop $loop,
15 |     ) {
16 |     }
17 | 
18 |     public function hasLoop(): bool
19 |     {
20 |         return $this->loop instanceof ILoop;
21 |     }
22 | 
23 |     public function getLoop(): ILoop
24 |     {
25 |         return $this->loop ?? throw new DomainException('Loop is not set.');
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Loop/LoopSetup.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Loop;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Feature\Resolver\Contract\IAutoStartResolver;
 8 | use AlecRabbit\Spinner\Core\Loop\Contract\ILoop;
 9 | use AlecRabbit\Spinner\Core\Loop\Contract\ILoopSetup;
10 | 
11 | final readonly class LoopSetup implements ILoopSetup
12 | {
13 |     public function __construct(
14 |         private IAutoStartResolver $autoStartResolver,
15 |     ) {
16 |     }
17 | 
18 |     public function setup(ILoop $loop): void
19 |     {
20 |         if ($this->autoStartResolver->isEnabled()) {
21 |             $loop->autoStart();
22 |         }
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Output/BufferedOutput.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Output;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Output\IBufferedOutput;
 8 | use AlecRabbit\Spinner\Contract\Output\IOutput;
 9 | use AlecRabbit\Spinner\Core\Output\Contract\IBuffer;
10 | 
11 | final readonly class BufferedOutput implements IBufferedOutput
12 | {
13 |     public function __construct(
14 |         protected IOutput $output,
15 |         protected IBuffer $buffer,
16 |     ) {
17 |     }
18 | 
19 |     public function flush(): void
20 |     {
21 |         $this->output->write($this->buffer->flush());
22 |     }
23 | 
24 |     public function append(iterable|string $messages): IBufferedOutput
25 |     {
26 |         $this->buffer->append($messages);
27 | 
28 |         return $this;
29 |     }
30 | }
31 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Output/Contract/Factory/IResourceStreamFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Output\Contract\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Output\IWritableStream;
 8 | 
 9 | interface IResourceStreamFactory
10 | {
11 |     public function create(): IWritableStream;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Output/Contract/IBuffer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Output\Contract;
 6 | 
 7 | use Traversable;
 8 | 
 9 | interface IBuffer
10 | {
11 |     /**
12 |      * Appends message to buffer.
13 |      *
14 |      * @psalm-param iterable<string>|string $message
15 |      */
16 |     public function append(iterable|string $message): IBuffer;
17 | 
18 |     /**
19 |      * Yields buffer content and clears buffer.
20 |      *
21 |      * @return Traversable<string>
22 |      */
23 |     public function flush(): Traversable;
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Output/Contract/IConsoleCursor.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Output\Contract;
 6 | 
 7 | interface IConsoleCursor
 8 | {
 9 |     /**
10 |      * Show cursor.
11 |      */
12 |     public function show(): IConsoleCursor;
13 | 
14 |     /**
15 |      * Hide cursor.
16 |      */
17 |     public function hide(): IConsoleCursor;
18 | 
19 |     /**
20 |      * Move cursor left by $columns.
21 |      */
22 |     public function moveLeft(int $columns = 1): IConsoleCursor;
23 | 
24 |     /**
25 |      * Erase $width characters from the current position.
26 |      */
27 |     public function erase(int $width): IConsoleCursor;
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Output/Contract/ISequenceStateWriter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Output\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IFinalizable;
 8 | use AlecRabbit\Spinner\Contract\IInitializable;
 9 | use AlecRabbit\Spinner\Core\Contract\ISequenceState;
10 | 
11 | interface ISequenceStateWriter extends IInitializable, IFinalizable
12 | {
13 |     public function erase(ISequenceState $state): void;
14 | 
15 |     public function write(ISequenceState $state): void;
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Output/Factory/ResourceStreamFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Output\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Output\IWritableStream;
 8 | use AlecRabbit\Spinner\Core\Config\Contract\IOutputConfig;
 9 | use AlecRabbit\Spinner\Core\Output\Contract\Factory\IResourceStreamFactory;
10 | use AlecRabbit\Spinner\Core\Output\WritableStream;
11 | 
12 | final class ResourceStreamFactory implements IResourceStreamFactory
13 | {
14 |     public function __construct(
15 |         protected IOutputConfig $outputConfig,
16 |     ) {
17 |     }
18 | 
19 |     public function create(): IWritableStream
20 |     {
21 |         return new WritableStream(
22 |             $this->outputConfig->getStream()
23 |         );
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Output/Output.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Output;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Output\IOutput;
 8 | use AlecRabbit\Spinner\Contract\Output\IWritableStream;
 9 | use Traversable;
10 | 
11 | final readonly class Output implements IOutput
12 | {
13 |     public function __construct(
14 |         protected IWritableStream $stream,
15 |     ) {
16 |     }
17 | 
18 |     public function writeln(iterable|string $messages, int $options = 0): void
19 |     {
20 |         $this->write($messages, true, $options);
21 |     }
22 | 
23 |     public function write(iterable|string $messages, bool $newline = false, int $options = 0): void
24 |     {
25 |         $this->stream->write(
26 |             $this->homogenize($messages, $newline)
27 |         );
28 |     }
29 | 
30 |     /**
31 |      * @return Traversable<string>
32 |      */
33 |     private function homogenize(iterable|string $messages, bool $newline = false): Traversable
34 |     {
35 |         if (!is_iterable($messages)) {
36 |             $messages = [$messages];
37 |         }
38 | 
39 |         /** @psalm-suppress MixedAssignment */
40 |         foreach ($messages as $message) {
41 |             if (is_string($message)) {
42 |                 if ($newline) {
43 |                     $message .= PHP_EOL;
44 |                 }
45 |                 yield $message;
46 |             }
47 |         }
48 |     }
49 | }
50 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Output/StringBuffer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Output;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Output\Contract\IBuffer;
 8 | use Generator;
 9 | 
10 | use function is_iterable;
11 | 
12 | final class StringBuffer implements IBuffer
13 | {
14 |     public function __construct(
15 |         protected string $buffer = '',
16 |     ) {
17 |     }
18 | 
19 |     public function flush(): Generator
20 |     {
21 |         yield $this->buffer;
22 |         $this->buffer = '';
23 |     }
24 | 
25 |     public function append(iterable|string $message): IBuffer
26 |     {
27 |         if (!is_iterable($message)) {
28 |             $message = [$message];
29 |         }
30 |         /** @var string $item */
31 |         foreach ($message as $item) {
32 |             $this->buffer .= $item;
33 |         }
34 |         return $this;
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Output/WritableStream.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Output;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Output\IWritableStream;
 8 | use AlecRabbit\Spinner\Exception\InvalidArgument;
 9 | use AlecRabbit\Spinner\Exception\RuntimeException;
10 | use Traversable;
11 | 
12 | final class WritableStream implements IWritableStream
13 | {
14 |     /**
15 |      * @var resource
16 |      */
17 |     private $stream;
18 | 
19 |     /**
20 |      * @throws InvalidArgument
21 |      */
22 |     public function __construct(mixed $stream)
23 |     {
24 |         if (!is_resource($stream) || get_resource_type($stream) !== 'stream') {
25 |             throw new InvalidArgument(
26 |                 sprintf(
27 |                     'Argument is expected to be a stream(resource), "%s" given.',
28 |                     get_debug_type($stream)
29 |                 )
30 |             );
31 |         }
32 | 
33 |         $this->stream = $stream;
34 |     }
35 | 
36 |     /**
37 |      * @codeCoverageIgnore
38 |      *
39 |      * @inheritDoc
40 |      */
41 |     public function write(Traversable $data): void
42 |     {
43 |         /** @var string $item */
44 |         foreach ($data as $item) {
45 |             if (fwrite($this->stream, $item) === false) {
46 |                 throw new RuntimeException('Was unable to write to a stream.');
47 |             }
48 |         }
49 |         // fflush($this->stream);
50 |     }
51 | }
52 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Palette/A/APalette.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Palette\A;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IFrame;
 8 | use AlecRabbit\Spinner\Core\Palette\Contract\IPalette;
 9 | use AlecRabbit\Spinner\Core\Palette\Contract\IPaletteMode;
10 | use AlecRabbit\Spinner\Core\Palette\Contract\IPaletteOptions;
11 | use AlecRabbit\Spinner\Core\Palette\Contract\IPaletteTemplate;
12 | use AlecRabbit\Spinner\Core\Palette\PaletteOptions;
13 | use AlecRabbit\Spinner\Core\Palette\PaletteTemplate;
14 | use Traversable;
15 | 
16 | abstract class APalette implements IPalette
17 | {
18 |     public function __construct(
19 |         protected IPaletteOptions $options = new PaletteOptions(),
20 |     ) {
21 |     }
22 | 
23 |     // FIXME (2023-12-04 16:9) [Alec Rabbit]: extract functionality to PaletteTemplateFactory->create($palette)
24 |     public function getTemplate(?IPaletteMode $mode = null): IPaletteTemplate
25 |     {
26 |         return new PaletteTemplate(
27 |             $this->getEntries($mode),
28 |             $this->getOptions($mode),
29 |         );
30 |     }
31 | 
32 |     /**
33 |      * @return Traversable<IFrame>
34 |      */
35 |     abstract protected function getEntries(?IPaletteMode $mode = null): Traversable;
36 | 
37 |     protected function getOptions(?IPaletteMode $mode = null): IPaletteOptions
38 |     {
39 |         return $this->options;
40 |     }
41 | }
42 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Palette/Contract/ICharPalette.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Palette\Contract;
 6 | 
 7 | interface ICharPalette extends IPalette
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Palette/Contract/IPalette.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Palette\Contract;
 6 | 
 7 | interface IPalette
 8 | {
 9 |     public function getTemplate(?IPaletteMode $mode = null): IPaletteTemplate;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Palette/Contract/IPaletteMode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Palette\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\StylingMethodMode;
 8 | 
 9 | interface IPaletteMode
10 | {
11 |     public function getStylingMode(): StylingMethodMode;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Palette/Contract/IPaletteOptions.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Palette\Contract;
 6 | 
 7 | interface IPaletteOptions
 8 | {
 9 |     public function getReversed(): ?bool;
10 | 
11 |     public function getInterval(): ?int;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Palette/Contract/IPaletteTemplate.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Palette\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IFrame;
 8 | use Traversable;
 9 | 
10 | interface IPaletteTemplate
11 | {
12 |     /**
13 |      * @return Traversable<IFrame>
14 |      */
15 |     public function getEntries(): Traversable;
16 | 
17 |     public function getOptions(): IPaletteOptions;
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Palette/Contract/IStylePalette.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Palette\Contract;
 6 | 
 7 | interface IStylePalette extends IPalette
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Palette/Factory/Contract/IPaletteModeFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Palette\Factory\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Palette\Contract\IPaletteMode;
 8 | 
 9 | interface IPaletteModeFactory
10 | {
11 |     public function create(): IPaletteMode;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Palette/Factory/PaletteModeFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Palette\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Contract\IOutputConfig;
 8 | use AlecRabbit\Spinner\Core\Palette\Contract\IPaletteMode;
 9 | use AlecRabbit\Spinner\Core\Palette\Factory\Contract\IPaletteModeFactory;
10 | use AlecRabbit\Spinner\Core\Palette\PaletteMode;
11 | 
12 | final readonly class PaletteModeFactory implements IPaletteModeFactory
13 | {
14 |     public function __construct(
15 |         protected IOutputConfig $outputConfig,
16 |     ) {
17 |     }
18 | 
19 |     public function create(): IPaletteMode
20 |     {
21 |         return new PaletteMode(
22 |             stylingMode: $this->outputConfig->getStylingMethodMode(),
23 |         );
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Palette/NoCharPalette.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Palette;
 6 | 
 7 | use AlecRabbit\Spinner\Core\CharFrame;
 8 | use AlecRabbit\Spinner\Core\Palette\A\APalette;
 9 | use AlecRabbit\Spinner\Core\Palette\Contract\ICharPalette;
10 | use AlecRabbit\Spinner\Core\Palette\Contract\IPaletteMode;
11 | use Traversable;
12 | 
13 | final class NoCharPalette extends APalette implements ICharPalette
14 | {
15 |     protected function getEntries(?IPaletteMode $mode = null): Traversable
16 |     {
17 |         yield from [
18 |             new CharFrame('', 0),
19 |         ];
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Palette/NoStylePalette.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Palette;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Palette\A\APalette;
 8 | use AlecRabbit\Spinner\Core\Palette\Contract\IPaletteMode;
 9 | use AlecRabbit\Spinner\Core\Palette\Contract\IStylePalette;
10 | use AlecRabbit\Spinner\Core\StyleFrame;
11 | use Traversable;
12 | 
13 | final class NoStylePalette extends APalette implements IStylePalette
14 | {
15 |     protected function getEntries(?IPaletteMode $mode = null): Traversable
16 |     {
17 |         yield from [
18 |             new StyleFrame('%s', 0),
19 |         ];
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Palette/PaletteMode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Palette;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Mode\StylingMethodMode;
 8 | use AlecRabbit\Spinner\Core\Palette\Contract\IPaletteMode;
 9 | 
10 | final readonly class PaletteMode implements IPaletteMode
11 | {
12 |     public function __construct(
13 |         protected StylingMethodMode $stylingMode,
14 |     ) {
15 |     }
16 | 
17 |     public function getStylingMode(): StylingMethodMode
18 |     {
19 |         return $this->stylingMode;
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Palette/PaletteOptions.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Palette;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Palette\Contract\IPaletteOptions;
 8 | 
 9 | final readonly class PaletteOptions implements IPaletteOptions
10 | {
11 |     public function __construct(
12 |         protected ?int $interval = null,
13 |         protected ?bool $reversed = null,
14 |     ) {
15 |     }
16 | 
17 |     public function getReversed(): ?bool
18 |     {
19 |         return $this->reversed;
20 |     }
21 | 
22 |     public function getInterval(): ?int
23 |     {
24 |         return $this->interval;
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Palette/Snake.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Palette;
 6 | 
 7 | use AlecRabbit\Spinner\Core\CharFrame;
 8 | use AlecRabbit\Spinner\Core\Contract\ICharFrame;
 9 | use AlecRabbit\Spinner\Core\Palette\A\ACharPalette;
10 | use Traversable;
11 | 
12 | use function array_reverse;
13 | 
14 | final class Snake extends ACharPalette
15 | {
16 |     protected function sequence(): Traversable
17 |     {
18 |         yield from ['⠏', '⠛', '⠹', '⢸', '⣰', '⣤', '⣆', '⡇'];
19 |     }
20 | 
21 |     protected function createFrame(string $element): ICharFrame
22 |     {
23 |         return new CharFrame($element, 1);
24 |     }
25 | 
26 |     protected function getInterval(): ?int
27 |     {
28 |         return 80;
29 |     }
30 | }
31 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Pattern/Factory/Contract/IPatternFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Pattern\Factory\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Pattern\IPattern;
 8 | use AlecRabbit\Spinner\Core\Palette\Contract\IPalette;
 9 | 
10 | interface IPatternFactory
11 | {
12 |     public function create(IPalette $palette): IPattern;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Pattern/Factory/PatternFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Pattern\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Pattern\IPattern;
 8 | use AlecRabbit\Spinner\Core\Factory\Contract\IIntervalFactory;
 9 | use AlecRabbit\Spinner\Core\Palette\Contract\IPalette;
10 | use AlecRabbit\Spinner\Core\Palette\Factory\Contract\IPaletteModeFactory;
11 | use AlecRabbit\Spinner\Core\Pattern\Factory\Contract\IPatternFactory;
12 | use AlecRabbit\Spinner\Core\Pattern\Pattern;
13 | 
14 | final readonly class PatternFactory implements IPatternFactory
15 | {
16 |     public function __construct(
17 |         protected IIntervalFactory $intervalFactory,
18 |         protected IPaletteModeFactory $paletteModeFactory,
19 |     ) {
20 |     }
21 | 
22 |     public function create(IPalette $palette): IPattern
23 |     {
24 |         $mode = $this->paletteModeFactory->create();
25 | 
26 |         $template = $palette->getTemplate($mode);
27 | 
28 |         $interval =
29 |             $this->intervalFactory->createNormalized(
30 |                 $template->getOptions()->getInterval()
31 |             );
32 | 
33 |         return new Pattern(
34 |             interval: $interval,
35 |             frames: $template->getEntries(),
36 |         );
37 |     }
38 | }
39 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Pattern/Pattern.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Pattern;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IInterval;
 8 | use AlecRabbit\Spinner\Contract\Pattern\IPattern;
 9 | use Traversable;
10 | 
11 | final readonly class Pattern implements IPattern
12 | {
13 |     public function __construct(
14 |         protected IInterval $interval,
15 |         protected Traversable $frames,
16 |     ) {
17 |     }
18 | 
19 |     public function getInterval(): IInterval
20 |     {
21 |         return $this->interval;
22 |     }
23 | 
24 |     public function getFrames(): Traversable
25 |     {
26 |         return $this->frames;
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Probe/SignalHandlingOptionCreator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Probe;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Option\SignalHandlingOption;
 8 | use AlecRabbit\Spinner\Contract\Probe\ISignalHandlingOptionCreator;
 9 | 
10 | final class SignalHandlingOptionCreator implements ISignalHandlingOptionCreator
11 | {
12 |     private const SIGNAL_PROCESSING_EXTENSION = 'pcntl';
13 | 
14 |     public function create(): SignalHandlingOption
15 |     {
16 |         return extension_loaded(self::SIGNAL_PROCESSING_EXTENSION)
17 |             ? SignalHandlingOption::ENABLED
18 |             : SignalHandlingOption::DISABLED;
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Probe/SignalHandlingProbe.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Probe;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Probe\ISignalHandlingOptionCreator;
 8 | use AlecRabbit\Spinner\Contract\Probe\ISignalHandlingProbe;
 9 | 
10 | final class SignalHandlingProbe implements ISignalHandlingProbe
11 | {
12 |     public static function isSupported(): bool
13 |     {
14 |         return true;
15 |     }
16 | 
17 |     /**
18 |      * @return class-string<ISignalHandlingOptionCreator>
19 |      */
20 |     public static function getCreatorClass(): string
21 |     {
22 |         return SignalHandlingOptionCreator::class;
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Probe/StylingMethodOptionCreator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Probe;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Option\StylingMethodOption;
 8 | use AlecRabbit\Spinner\Contract\Probe\IStylingMethodOptionCreator;
 9 | 
10 | final readonly class StylingMethodOptionCreator implements IStylingMethodOptionCreator
11 | {
12 |     public function create(): StylingMethodOption
13 |     {
14 |         return StylingMethodOption::AUTO;
15 |     }
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Probe/StylingMethodProbe.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Probe;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Probe\IStylingMethodOptionCreator;
 8 | use AlecRabbit\Spinner\Contract\Probe\IStylingMethodProbe;
 9 | 
10 | final class StylingMethodProbe implements IStylingMethodProbe
11 | {
12 |     public static function isSupported(): bool
13 |     {
14 |         return true;
15 |     }
16 | 
17 |     /**
18 |      * @return class-string<IStylingMethodOptionCreator>
19 |      */
20 |     public static function getCreatorClass(): string
21 |     {
22 |         return StylingMethodOptionCreator::class;
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Revolver/A/ARevolverBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Revolver\A;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Revolver\Contract\IRevolver;
 8 | 
 9 | abstract class ARevolverBuilder
10 | {
11 |     abstract public function build(): IRevolver;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Revolver/Contract/IFrameCollectionRevolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Revolver\Contract;
 6 | 
 7 | interface IFrameCollectionRevolver extends IFrameRevolver
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Revolver/Contract/IFrameRevolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Revolver\Contract;
 6 | 
 7 | interface IFrameRevolver extends IRevolver
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Revolver/Contract/IFrameRevolverBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Revolver\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IInterval;
 8 | use AlecRabbit\Spinner\Core\Contract\IFrameCollection;
 9 | use AlecRabbit\Spinner\Core\Contract\ITolerance;
10 | 
11 | interface IFrameRevolverBuilder
12 | {
13 |     public function build(): IFrameRevolver;
14 | 
15 |     public function withFrameCollection(IFrameCollection $frames): IFrameRevolverBuilder;
16 | 
17 |     public function withInterval(IInterval $interval): IFrameRevolverBuilder;
18 | 
19 |     public function withTolerance(ITolerance $tolerance): IFrameRevolverBuilder;
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Revolver/Contract/IRevolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Revolver\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IHasFrame;
 8 | use AlecRabbit\Spinner\Contract\IHasInterval;
 9 | 
10 | interface IRevolver extends IHasFrame, IHasInterval
11 | {
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Revolver/Contract/IRevolverBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Revolver\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Exception\InvalidArgument;
 8 | use AlecRabbit\Spinner\Exception\LogicException;
 9 | 
10 | interface IRevolverBuilder
11 | {
12 |     /**
13 |      * @throws LogicException
14 |      * @throws InvalidArgument
15 |      */
16 |     public function build(): IRevolver;
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Revolver/Tolerance.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Revolver;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Contract\ITolerance;
 8 | use AlecRabbit\Spinner\Exception\InvalidArgument;
 9 | 
10 | final readonly class Tolerance implements ITolerance
11 | {
12 |     public function __construct(
13 |         protected int $value = self::DEFAULT_VALUE
14 |     ) {
15 |         self::assertValue($value);
16 |     }
17 | 
18 |     private static function assertValue(int $value): void
19 |     {
20 |         match (true) {
21 |             $value < 0 => throw new InvalidArgument('Tolerance value must be positive integer.'),
22 |             default => null,
23 |         };
24 |     }
25 | 
26 |     public function toMilliseconds(): int
27 |     {
28 |         return $this->value;
29 |     }
30 | }
31 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/SequenceState.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Contract\ISequenceState;
 8 | 
 9 | final readonly class SequenceState implements ISequenceState
10 | {
11 |     public function __construct(
12 |         private string $sequence,
13 |         private int $width,
14 |         private int $previousWidth,
15 |     ) {
16 |     }
17 | 
18 |     public function getSequence(): string
19 |     {
20 |         return $this->sequence;
21 |     }
22 | 
23 |     public function getWidth(): int
24 |     {
25 |         return $this->width;
26 |     }
27 | 
28 |     public function getPreviousWidth(): int
29 |     {
30 |         return $this->previousWidth;
31 |     }
32 | }
33 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Contract/Builder/ISettingsProviderBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Contract\Builder;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Settings\Contract\ISettings;
 8 | use AlecRabbit\Spinner\Core\Settings\Contract\ISettingsProvider;
 9 | use AlecRabbit\Spinner\Exception\LogicException;
10 | 
11 | interface ISettingsProviderBuilder
12 | {
13 |     /**
14 |      * @throws LogicException
15 |      */
16 |     public function build(): ISettingsProvider;
17 | 
18 |     public function withSettings(ISettings $settings): ISettingsProviderBuilder;
19 | 
20 |     public function withDefaultSettings(ISettings $settings): ISettingsProviderBuilder;
21 | 
22 |     public function withDetectedSettings(ISettings $settings): ISettingsProviderBuilder;
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Contract/Detector/IDetector.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Contract\Detector;
 6 | 
 7 | interface IDetector
 8 | {
 9 |     public function getSupportValue(): mixed;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Contract/Detector/ILoopSupportDetector.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Contract\Detector;
 6 | 
 7 | interface ILoopSupportDetector extends IDetector
 8 | {
 9 |     public function getSupportValue(): bool;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Contract/Detector/ISignalHandlingSupportDetector.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Contract\Detector;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Option\SignalHandlingOption;
 8 | 
 9 | interface ISignalHandlingSupportDetector extends IDetector
10 | {
11 |     public function getSupportValue(): SignalHandlingOption;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Contract/Detector/IStylingMethodDetector.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Contract\Detector;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Option\StylingMethodOption;
 8 | 
 9 | interface IStylingMethodDetector extends IDetector
10 | {
11 |     public function getSupportValue(): StylingMethodOption;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Contract/Factory/IDefaultSettingsFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Contract\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Settings\Contract\ISettings;
 8 | 
 9 | interface IDefaultSettingsFactory
10 | {
11 |     public function create(): ISettings;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Contract/Factory/IDetectedSettingsFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Contract\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Settings\Contract\ISettings;
 8 | 
 9 | interface IDetectedSettingsFactory
10 | {
11 |     public function create(): ISettings;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Contract/Factory/ISettingsProviderFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Contract\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Settings\Contract\ISettingsProvider;
 8 | 
 9 | interface ISettingsProviderFactory
10 | {
11 |     public function create(): ISettingsProvider;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Contract/Factory/IUserSettingsFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Contract\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Settings\Contract\ISettings;
 8 | 
 9 | interface IUserSettingsFactory
10 | {
11 |     public function create(): ISettings;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Contract/IDriverSettings.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Option\DriverOption;
 8 | 
 9 | interface IDriverSettings extends ISettingsElement
10 | {
11 |     public function getMessages(): ?IMessages;
12 | 
13 |     public function getDriverOption(): DriverOption;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Contract/IGeneralSettings.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Option\RunMethodOption;
 8 | 
 9 | interface IGeneralSettings extends ISettingsElement
10 | {
11 |     public function getRunMethodOption(): RunMethodOption;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Contract/IHandlerCreator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Contract\IDriver;
 8 | use AlecRabbit\Spinner\Core\Loop\Contract\ILoop;
 9 | use Closure;
10 | 
11 | interface IHandlerCreator
12 | {
13 |     public function createHandler(IDriver $driver, ILoop $loop): Closure;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Contract/ILinkerSettings.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Option\LinkerOption;
 8 | 
 9 | interface ILinkerSettings extends ISettingsElement
10 | {
11 |     public function getLinkerOption(): LinkerOption;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Contract/ILoopSettings.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Option\AutoStartOption;
 8 | use AlecRabbit\Spinner\Contract\Option\SignalHandlingOption;
 9 | 
10 | interface ILoopSettings extends ISettingsElement
11 | {
12 |     public function getAutoStartOption(): AutoStartOption;
13 | 
14 |     public function getSignalHandlingOption(): SignalHandlingOption;
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Contract/IMessages.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Contract;
 6 | 
 7 | interface IMessages
 8 | {
 9 |     public function getFinalMessage(): ?string;
10 | 
11 |     public function getInterruptionMessage(): ?string;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Contract/INormalizerSettings.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Option\NormalizerOption;
 8 | 
 9 | interface INormalizerSettings extends ISettingsElement
10 | {
11 |     public function getNormalizerOption(): NormalizerOption;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Contract/IOutputSettings.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Option\CursorVisibilityOption;
 8 | use AlecRabbit\Spinner\Contract\Option\InitializationOption;
 9 | use AlecRabbit\Spinner\Contract\Option\StylingMethodOption;
10 | 
11 | interface IOutputSettings extends ISettingsElement
12 | {
13 |     public function getCursorVisibilityOption(): CursorVisibilityOption;
14 | 
15 |     public function getStylingMethodOption(): StylingMethodOption;
16 | 
17 |     public function getInitializationOption(): InitializationOption;
18 | 
19 |     public function getStream(): mixed;
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Contract/IRevolverSettings.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Contract\ITolerance;
 8 | 
 9 | interface IRevolverSettings extends ISettingsElement
10 | {
11 |     public function getTolerance(): ?ITolerance;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Contract/IRootWidgetSettings.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Contract;
 6 | 
 7 | interface IRootWidgetSettings extends IWidgetSettings
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Contract/ISettings.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Contract;
 6 | 
 7 | interface ISettings
 8 | {
 9 |     public function set(ISettingsElement ...$settingsElements): void;
10 | 
11 |     /**
12 |      * @param class-string<ISettingsElement> $id
13 |      */
14 |     public function get(string $id): ?ISettingsElement;
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Contract/ISettingsElement.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Contract;
 6 | 
 7 | interface ISettingsElement
 8 | {
 9 |     /**
10 |      * @return class-string<ISettingsElement>
11 |      */
12 |     public function getIdentifier(): string;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Contract/ISettingsProvider.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Contract;
 6 | 
 7 | interface ISettingsProvider
 8 | {
 9 |     public function getUserSettings(): ISettings;
10 | 
11 |     public function getDefaultSettings(): ISettings;
12 | 
13 |     public function getDetectedSettings(): ISettings;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Contract/ISignalHandlerCreator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Contract;
 6 | 
 7 | interface ISignalHandlerCreator
 8 | {
 9 |     public function getSignal(): int;
10 | 
11 |     public function getHandlerCreator(): IHandlerCreator;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Contract/ISignalHandlerSettings.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Contract;
 6 | 
 7 | use Traversable;
 8 | 
 9 | interface ISignalHandlerSettings extends ISettingsElement
10 | {
11 |     public function getCreators(): Traversable;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Contract/ISpinnerSettings.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Contract;
 6 | 
 7 | interface ISpinnerSettings
 8 | {
 9 |     public function getWidgetSettings(): ?IWidgetSettings;
10 | 
11 |     public function isAutoAttach(): bool;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Contract/IWidgetSettings.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IFrame;
 8 | use AlecRabbit\Spinner\Core\Palette\Contract\IPalette;
 9 | 
10 | interface IWidgetSettings extends ISettingsElement
11 | {
12 |     public function getLeadingSpacer(): ?IFrame;
13 | 
14 |     public function getTrailingSpacer(): ?IFrame;
15 | 
16 |     public function getStylePalette(): ?IPalette;
17 | 
18 |     public function getCharPalette(): ?IPalette;
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Detector/LoopSupportDetector.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Detector;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Loop\Contract\ILoopCreator;
 8 | use AlecRabbit\Spinner\Core\Settings\Contract\Detector\ILoopSupportDetector;
 9 | 
10 | final readonly class LoopSupportDetector implements ILoopSupportDetector
11 | {
12 |     public function __construct(
13 |         protected ?string $creatorClass,
14 |     ) {
15 |     }
16 | 
17 |     public function getSupportValue(): bool
18 |     {
19 |         if ($this->creatorClass === null) {
20 |             return false;
21 |         }
22 |         return is_subclass_of($this->creatorClass, ILoopCreator::class);
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/DriverSettings.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Option\DriverOption;
 8 | use AlecRabbit\Spinner\Core\Settings\Contract\IDriverSettings;
 9 | use AlecRabbit\Spinner\Core\Settings\Contract\IMessages;
10 | 
11 | final readonly class DriverSettings implements IDriverSettings
12 | {
13 |     public function __construct(
14 |         private ?IMessages $messages = null,
15 |         private DriverOption $driverOption = DriverOption::AUTO,
16 |     ) {
17 |     }
18 | 
19 |     public function getIdentifier(): string
20 |     {
21 |         return IDriverSettings::class;
22 |     }
23 | 
24 |     public function getMessages(): ?IMessages
25 |     {
26 |         return $this->messages;
27 |     }
28 | 
29 |     public function getDriverOption(): DriverOption
30 |     {
31 |         return $this->driverOption;
32 |     }
33 | }
34 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Factory/SettingsProviderFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Settings\Contract\Builder\ISettingsProviderBuilder;
 8 | use AlecRabbit\Spinner\Core\Settings\Contract\Factory\IDefaultSettingsFactory;
 9 | use AlecRabbit\Spinner\Core\Settings\Contract\Factory\IDetectedSettingsFactory;
10 | use AlecRabbit\Spinner\Core\Settings\Contract\Factory\ISettingsProviderFactory;
11 | use AlecRabbit\Spinner\Core\Settings\Contract\Factory\IUserSettingsFactory;
12 | use AlecRabbit\Spinner\Core\Settings\Contract\ISettingsProvider;
13 | 
14 | final readonly class SettingsProviderFactory implements ISettingsProviderFactory
15 | {
16 |     public function __construct(
17 |         protected ISettingsProviderBuilder $builder,
18 |         protected IUserSettingsFactory $userSettingsFactory,
19 |         protected IDetectedSettingsFactory $detectedSettingsFactory,
20 |         protected IDefaultSettingsFactory $defaultSettingsFactory,
21 |     ) {
22 |     }
23 | 
24 |     public function create(): ISettingsProvider
25 |     {
26 |         return $this->builder
27 |             ->withSettings($this->userSettingsFactory->create())
28 |             ->withDefaultSettings($this->defaultSettingsFactory->create())
29 |             ->withDetectedSettings($this->detectedSettingsFactory->create())
30 |             ->build()
31 |         ;
32 |     }
33 | }
34 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Factory/UserSettingsFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings\Factory;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Settings\Contract\Factory\IUserSettingsFactory;
 8 | use AlecRabbit\Spinner\Core\Settings\Contract\ISettings;
 9 | use AlecRabbit\Spinner\Core\Settings\Settings;
10 | 
11 | final readonly class UserSettingsFactory implements IUserSettingsFactory
12 | {
13 |     public function create(): ISettings
14 |     {
15 |         return new Settings();
16 |     }
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/GeneralSettings.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Option\RunMethodOption;
 8 | use AlecRabbit\Spinner\Core\Settings\Contract\IGeneralSettings;
 9 | 
10 | final readonly class GeneralSettings implements IGeneralSettings
11 | {
12 |     public function __construct(
13 |         private RunMethodOption $runMethodOption = RunMethodOption::AUTO,
14 |     ) {
15 |     }
16 | 
17 |     public function getRunMethodOption(): RunMethodOption
18 |     {
19 |         return $this->runMethodOption;
20 |     }
21 | 
22 |     public function getIdentifier(): string
23 |     {
24 |         return IGeneralSettings::class;
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/LinkerSettings.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Option\LinkerOption;
 8 | use AlecRabbit\Spinner\Core\Settings\Contract\ILinkerSettings;
 9 | 
10 | final readonly class LinkerSettings implements ILinkerSettings
11 | {
12 |     public function __construct(
13 |         private LinkerOption $linkerOption = LinkerOption::AUTO,
14 |     ) {
15 |     }
16 | 
17 |     public function getLinkerOption(): LinkerOption
18 |     {
19 |         return $this->linkerOption;
20 |     }
21 | 
22 |     public function getIdentifier(): string
23 |     {
24 |         return ILinkerSettings::class;
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/LoopSettings.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Option\AutoStartOption;
 8 | use AlecRabbit\Spinner\Contract\Option\SignalHandlingOption;
 9 | use AlecRabbit\Spinner\Core\Settings\Contract\ILoopSettings;
10 | 
11 | final readonly class LoopSettings implements ILoopSettings
12 | {
13 |     public function __construct(
14 |         private AutoStartOption $autoStartOption = AutoStartOption::AUTO,
15 |         private SignalHandlingOption $signalHandlingOption = SignalHandlingOption::AUTO,
16 |     ) {
17 |     }
18 | 
19 |     public function getAutoStartOption(): AutoStartOption
20 |     {
21 |         return $this->autoStartOption;
22 |     }
23 | 
24 |     public function getSignalHandlingOption(): SignalHandlingOption
25 |     {
26 |         return $this->signalHandlingOption;
27 |     }
28 | 
29 |     public function getIdentifier(): string
30 |     {
31 |         return ILoopSettings::class;
32 |     }
33 | }
34 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/Messages.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Settings\Contract\IMessages;
 8 | 
 9 | final readonly class Messages implements IMessages
10 | {
11 |     public function __construct(
12 |         private ?string $finalMessage = null,
13 |         private ?string $interruptionMessage = null,
14 |     ) {
15 |     }
16 | 
17 |     public function getFinalMessage(): ?string
18 |     {
19 |         return $this->finalMessage;
20 |     }
21 | 
22 |     public function getInterruptionMessage(): ?string
23 |     {
24 |         return $this->interruptionMessage;
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/NormalizerSettings.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\Option\NormalizerOption;
 8 | use AlecRabbit\Spinner\Core\Settings\Contract\INormalizerSettings;
 9 | 
10 | final readonly class NormalizerSettings implements INormalizerSettings
11 | {
12 |     public function __construct(
13 |         private NormalizerOption $normalizerOption = NormalizerOption::AUTO,
14 |     ) {
15 |     }
16 | 
17 |     public function getNormalizerOption(): NormalizerOption
18 |     {
19 |         return $this->normalizerOption;
20 |     }
21 | 
22 |     public function getIdentifier(): string
23 |     {
24 |         return INormalizerSettings::class;
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/RevolverSettings.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Contract\ITolerance;
 8 | use AlecRabbit\Spinner\Core\Settings\Contract\IRevolverSettings;
 9 | 
10 | final readonly class RevolverSettings implements IRevolverSettings
11 | {
12 |     public function __construct(
13 |         private ITolerance $tolerance,
14 |     ) {
15 |     }
16 | 
17 |     public function getTolerance(): ?ITolerance
18 |     {
19 |         return $this->tolerance;
20 |     }
21 | 
22 |     public function getIdentifier(): string
23 |     {
24 |         return IRevolverSettings::class;
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/RootWidgetSettings.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IFrame;
 8 | use AlecRabbit\Spinner\Core\Palette\Contract\IPalette;
 9 | use AlecRabbit\Spinner\Core\Settings\Contract\IRootWidgetSettings;
10 | 
11 | final readonly class RootWidgetSettings implements IRootWidgetSettings
12 | {
13 |     public function __construct(
14 |         private ?IFrame $leadingSpacer = null,
15 |         private ?IFrame $trailingSpacer = null,
16 |         private ?IPalette $stylePalette = null,
17 |         private ?IPalette $charPalette = null,
18 |     ) {
19 |     }
20 | 
21 |     public function getLeadingSpacer(): ?IFrame
22 |     {
23 |         return $this->leadingSpacer;
24 |     }
25 | 
26 |     public function getTrailingSpacer(): ?IFrame
27 |     {
28 |         return $this->trailingSpacer;
29 |     }
30 | 
31 |     public function getStylePalette(): ?IPalette
32 |     {
33 |         return $this->stylePalette;
34 |     }
35 | 
36 |     public function getCharPalette(): ?IPalette
37 |     {
38 |         return $this->charPalette;
39 |     }
40 | 
41 |     public function getIdentifier(): string
42 |     {
43 |         return IRootWidgetSettings::class;
44 |     }
45 | }
46 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/SettingsProvider.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Settings\Contract\ISettings;
 8 | use AlecRabbit\Spinner\Core\Settings\Contract\ISettingsProvider;
 9 | 
10 | final readonly class SettingsProvider implements ISettingsProvider
11 | {
12 |     public function __construct(
13 |         private ISettings $userSettings,
14 |         private ISettings $defaultSettings,
15 |         private ISettings $detectedSettings,
16 |     ) {
17 |     }
18 | 
19 |     public function getUserSettings(): ISettings
20 |     {
21 |         return $this->userSettings;
22 |     }
23 | 
24 |     public function getDefaultSettings(): ISettings
25 |     {
26 |         return $this->defaultSettings;
27 |     }
28 | 
29 |     public function getDetectedSettings(): ISettings
30 |     {
31 |         return $this->detectedSettings;
32 |     }
33 | }
34 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/SignalHandlerCreator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Settings\Contract\IHandlerCreator;
 8 | use AlecRabbit\Spinner\Core\Settings\Contract\ISignalHandlerCreator;
 9 | 
10 | final readonly class SignalHandlerCreator implements ISignalHandlerCreator
11 | {
12 |     public function __construct(
13 |         private int $signal,
14 |         private IHandlerCreator $handlerCreator,
15 |     ) {
16 |     }
17 | 
18 |     public function getSignal(): int
19 |     {
20 |         return $this->signal;
21 |     }
22 | 
23 |     public function getHandlerCreator(): IHandlerCreator
24 |     {
25 |         return $this->handlerCreator;
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/SignalHandlerSettings.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Settings\Contract\ISignalHandlerCreator;
 8 | use AlecRabbit\Spinner\Core\Settings\Contract\ISignalHandlerSettings;
 9 | use ArrayObject;
10 | use Traversable;
11 | 
12 | final readonly class SignalHandlerSettings implements ISignalHandlerSettings
13 | {
14 |     private Traversable $creators;
15 | 
16 |     public function __construct(ISignalHandlerCreator ...$creators)
17 |     {
18 |         $this->creators = new ArrayObject($creators);
19 |     }
20 | 
21 |     /**
22 |      * @return class-string<ISignalHandlerSettings>
23 |      */
24 |     public function getIdentifier(): string
25 |     {
26 |         return ISignalHandlerSettings::class;
27 |     }
28 | 
29 |     public function getCreators(): Traversable
30 |     {
31 |         return $this->creators;
32 |     }
33 | }
34 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/SpinnerSettings.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Settings\Contract\ISpinnerSettings;
 8 | use AlecRabbit\Spinner\Core\Settings\Contract\IWidgetSettings;
 9 | 
10 | final readonly class SpinnerSettings implements ISpinnerSettings
11 | {
12 |     public function __construct(
13 |         private ?IWidgetSettings $widgetSettings = null,
14 |         private bool $autoAttach = true,
15 |     ) {
16 |     }
17 | 
18 |     public function getWidgetSettings(): ?IWidgetSettings
19 |     {
20 |         return $this->widgetSettings;
21 |     }
22 | 
23 |     public function isAutoAttach(): bool
24 |     {
25 |         return $this->autoAttach;
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Settings/WidgetSettings.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Settings;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IFrame;
 8 | use AlecRabbit\Spinner\Core\Palette\Contract\IPalette;
 9 | use AlecRabbit\Spinner\Core\Settings\Contract\IWidgetSettings;
10 | 
11 | final readonly class WidgetSettings implements IWidgetSettings
12 | {
13 |     public function __construct(
14 |         private ?IFrame $leadingSpacer = null,
15 |         private ?IFrame $trailingSpacer = null,
16 |         private ?IPalette $stylePalette = null,
17 |         private ?IPalette $charPalette = null,
18 |     ) {
19 |     }
20 | 
21 |     public function getLeadingSpacer(): ?IFrame
22 |     {
23 |         return $this->leadingSpacer;
24 |     }
25 | 
26 |     public function getTrailingSpacer(): ?IFrame
27 |     {
28 |         return $this->trailingSpacer;
29 |     }
30 | 
31 |     public function getStylePalette(): ?IPalette
32 |     {
33 |         return $this->stylePalette;
34 |     }
35 | 
36 |     public function getCharPalette(): ?IPalette
37 |     {
38 |         return $this->charPalette;
39 |     }
40 | 
41 |     /**
42 |      * @return class-string<IWidgetSettings>
43 |      */
44 |     public function getIdentifier(): string
45 |     {
46 |         return IWidgetSettings::class;
47 |     }
48 | }
49 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/SignalHandlersContainer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Contract\ISignalHandlersContainer;
 8 | use AlecRabbit\Spinner\Core\Settings\Contract\IHandlerCreator;
 9 | use Traversable;
10 | 
11 | final readonly class SignalHandlersContainer implements ISignalHandlersContainer
12 | {
13 |     /**
14 |      * @param Traversable<int, IHandlerCreator> $signalHandlers
15 |      */
16 |     public function __construct(
17 |         private Traversable $signalHandlers,
18 |     ) {
19 |     }
20 | 
21 |     public function getHandlerCreators(): Traversable
22 |     {
23 |         return $this->signalHandlers;
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/SignalHandlingSetup.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Contract\ILoopConfig;
 8 | use AlecRabbit\Spinner\Core\Contract\IDriver;
 9 | use AlecRabbit\Spinner\Core\Contract\ISignalHandlingSetup;
10 | use AlecRabbit\Spinner\Core\Loop\Contract\ILoop;
11 | use AlecRabbit\Spinner\Core\Settings\Contract\IHandlerCreator;
12 | use Traversable;
13 | 
14 | final readonly class SignalHandlingSetup implements ISignalHandlingSetup
15 | {
16 |     public function __construct(
17 |         private ILoop $loop,
18 |         private ILoopConfig $loopConfig,
19 |     ) {
20 |     }
21 | 
22 |     public function setup(IDriver $driver): void
23 |     {
24 |         /**
25 |          * @var int $signal
26 |          * @var IHandlerCreator $creator
27 |          */
28 |         foreach ($this->getHandlers() as $signal => $creator) {
29 |             $handler = $creator->createHandler($driver, $this->loop);
30 | 
31 |             $this->loop->onSignal(
32 |                 $signal,
33 |                 $handler,
34 |             );
35 |         }
36 |     }
37 | 
38 |     private function getHandlers(): Traversable
39 |     {
40 |         return $this->loopConfig->getSignalHandlersContainer()
41 |             ->getHandlerCreators()
42 |         ;
43 |     }
44 | }
45 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/StyleFrame.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core;
 6 | 
 7 | use AlecRabbit\Spinner\Core\A\AFrame;
 8 | use AlecRabbit\Spinner\Core\Contract\IStyleFrame;
 9 | 
10 | final readonly class StyleFrame extends AFrame implements IStyleFrame
11 | {
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Widget/Builder/A/AWidgetBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Widget\Builder\A;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IFrame;
 8 | use AlecRabbit\Spinner\Core\Widget\Contract\IWidgetRevolver;
 9 | use AlecRabbit\Spinner\Exception\LogicException;
10 | 
11 | abstract class AWidgetBuilder
12 | {
13 |     protected ?IFrame $leadingSpacer = null;
14 |     protected ?IFrame $trailingSpacer = null;
15 |     protected ?IWidgetRevolver $revolver = null;
16 | 
17 |     protected function validate(): void
18 |     {
19 |         match (true) {
20 |             $this->revolver === null => throw new LogicException('Revolver is not set.'),
21 |             $this->leadingSpacer === null => throw new LogicException('Leading spacer is not set.'),
22 |             $this->trailingSpacer === null => throw new LogicException('Trailing spacer is not set.'),
23 |             default => null,
24 |         };
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Widget/Contract/IHasWidgetContext.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Widget\Contract;
 6 | 
 7 | interface IHasWidgetContext
 8 | {
 9 |     public function getContext(): IWidgetContext;
10 | 
11 |     public function envelopWithContext(IWidgetContext $context): void;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Widget/Contract/IWidget.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Widget\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IHasFrame;
 8 | use AlecRabbit\Spinner\Contract\IHasInterval;
 9 | use AlecRabbit\Spinner\Contract\ISubject;
10 | 
11 | interface IWidget extends ISubject,
12 |                           IHasInterval,
13 |                           IHasFrame
14 | {
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Widget/Contract/IWidgetBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Widget\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IFrame;
 8 | use AlecRabbit\Spinner\Exception\InvalidArgument;
 9 | use AlecRabbit\Spinner\Exception\LogicException;
10 | 
11 | interface IWidgetBuilder
12 | {
13 |     /**
14 |      * @throws LogicException
15 |      * @throws InvalidArgument
16 |      */
17 |     public function build(): IWidget;
18 | 
19 |     public function withWidgetRevolver(IWidgetRevolver $revolver): IWidgetBuilder;
20 | 
21 |     public function withLeadingSpacer(IFrame $leadingSpacer): IWidgetBuilder;
22 | 
23 |     public function withTrailingSpacer(IFrame $trailingSpacer): IWidgetBuilder;
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Widget/Contract/IWidgetComposite.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Widget\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IObserver;
 8 | 
 9 | interface IWidgetComposite extends IWidget,
10 |                                    IObserver
11 | {
12 |     public function add(IWidgetContext $context): IWidgetContext;
13 | 
14 |     public function remove(IWidgetContext $context): void;
15 | 
16 |     public function getContext(): IWidgetContext;
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Widget/Contract/IWidgetContext.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Widget\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Contract\IHasNullableInterval;
 8 | use AlecRabbit\Spinner\Contract\IObserver;
 9 | use AlecRabbit\Spinner\Contract\ISubject;
10 | 
11 | interface IWidgetContext extends IObserver,
12 |                                  ISubject,
13 |                                  IHasNullableInterval
14 | {
15 |     public function setWidget(?IWidget $widget): void;
16 | 
17 |     public function getWidget(): ?IWidget;
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Widget/Contract/IWidgetRevolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Widget\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Revolver\Contract\IRevolver;
 8 | 
 9 | interface IWidgetRevolver extends IRevolver
10 | {
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Widget/Contract/IWidgetRevolverBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Widget\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Contract\ITolerance;
 8 | use AlecRabbit\Spinner\Core\Revolver\Contract\IFrameRevolver;
 9 | use AlecRabbit\Spinner\Core\Revolver\Contract\IRevolverBuilder;
10 | 
11 | interface IWidgetRevolverBuilder extends IRevolverBuilder
12 | {
13 |     public function build(): IWidgetRevolver;
14 | 
15 |     public function withCharRevolver(IFrameRevolver $charRevolver): IWidgetRevolverBuilder;
16 | 
17 |     public function withStyleRevolver(IFrameRevolver $styleRevolver): IWidgetRevolverBuilder;
18 | 
19 |     public function withTolerance(ITolerance $tolerance): IWidgetRevolverBuilder;
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Widget/Factory/Contract/IWidgetFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Widget\Factory\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Contract\IWidgetConfig;
 8 | use AlecRabbit\Spinner\Core\Settings\Contract\IWidgetSettings;
 9 | use AlecRabbit\Spinner\Core\Widget\Contract\IWidget;
10 | 
11 | interface IWidgetFactory
12 | {
13 |     public function create(IWidgetConfig|IWidgetSettings|null $widgetSettings = null): IWidget;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Widget/Factory/Contract/IWidgetRevolverFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Widget\Factory\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Config\Contract\IWidgetRevolverConfig;
 8 | use AlecRabbit\Spinner\Core\Widget\Contract\IWidgetRevolver;
 9 | 
10 | interface IWidgetRevolverFactory
11 | {
12 |     public function create(IWidgetRevolverConfig $widgetRevolverConfig): IWidgetRevolver;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Spinner/Core/Widget/Widget.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Core\Widget;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Widget\A\AWidget;
 8 | 
 9 | final class Widget extends AWidget
10 | {
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Spinner/Exception/DomainException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Exception;
 6 | 
 7 | class DomainException extends LogicException
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Spinner/Exception/DriverCanNotBeReplaced.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Exception;
 6 | 
 7 | final class DriverCanNotBeReplaced extends DomainException
 8 | {
 9 | 
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Spinner/Exception/InvalidArgument.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Exception;
 6 | 
 7 | class InvalidArgument extends RuntimeException
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Spinner/Exception/LogicException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Exception;
 6 | 
 7 | use Exception;
 8 | 
 9 | class LogicException extends Exception
10 | {
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Spinner/Exception/LoopException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Exception;
 6 | 
 7 | class LoopException extends RuntimeException
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Spinner/Exception/NotImplemented.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Exception;
 6 | 
 7 | final class NotImplemented extends RuntimeException
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Spinner/Exception/ObserverCanNotBeOverwritten.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Exception;
 6 | 
 7 | final class ObserverCanNotBeOverwritten extends LogicException
 8 | {
 9 | 
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Spinner/Exception/RuntimeException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Exception;
 6 | 
 7 | use Exception;
 8 | 
 9 | class RuntimeException extends Exception
10 | {
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Spinner/Exception/WidgetIsNotAComposite.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Exception;
 6 | 
 7 | final class WidgetIsNotAComposite extends DomainException
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Spinner/Facade.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner;
 6 | 
 7 | use AlecRabbit\Spinner\Root\A\AFacade;
 8 | use AlecRabbit\Spinner\Root\Contract\IFacade;
 9 | 
10 | final class Facade extends AFacade implements IFacade
11 | {
12 | 
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Spinner/Root/Contract/IFacade.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace AlecRabbit\Spinner\Root\Contract;
 6 | 
 7 | use AlecRabbit\Spinner\Core\Contract\IDriver;
 8 | use AlecRabbit\Spinner\Core\Contract\ISpinner;
 9 | use AlecRabbit\Spinner\Core\Loop\Contract\ILoop;
10 | use AlecRabbit\Spinner\Core\Settings\Contract\ISettings;
11 | use AlecRabbit\Spinner\Core\Settings\Contract\ISpinnerSettings;
12 | use AlecRabbit\Spinner\Exception\DomainException;
13 | 
14 | interface IFacade
15 | {
16 |     public static function getDriver(): IDriver;
17 | 
18 |     /**
19 |      * @throws DomainException
20 |      */
21 |     public static function getSettings(): ISettings;
22 | 
23 |     /**
24 |      * @throws DomainException
25 |      */
26 |     public static function getLoop(): ILoop;
27 | 
28 |     public static function createSpinner(?ISpinnerSettings $spinnerSettings = null): ISpinner;
29 | }
30 | 


--------------------------------------------------------------------------------