Breakpoint configuration (#18)

* add breakpoint config

Author: davidhoelzel

docs/BundleConfiguration.md

@@ -11,6 +11,10 @@ twig_doc:
     - '%twig.default_path%/components'
   categories:
     - name: Components
+  breakpoints:
+    small: 240
+    medium: 640
+    large: 768
 ```
 
 ### Directories
@@ -66,3 +70,16 @@ twig_doc:
 ```
 
 The default category is always merged into the configuration.
+
+
+### Breakpoints
+
+To use custom breakpoints, simply provide a breakpoint-config. You can name the breakpoints as you like:
+
+```yaml
+twig_doc:
+  breakpoints:
+    iphone: 598
+    unusual: 743
+...
+```

src/DependencyInjection/Configuration.php

@@ -19,6 +19,15 @@ public function getConfigTreeBuilder(): TreeBuilder
                         ->thenInvalid('The twig_doc documentation identifier must match \w (regex)')
                     ->end()
                 ->end()
+                ->arrayNode('breakpoints')
+                    ->defaultValue([
+                        'small' => 240,
+                        'medium' => 640,
+                        'large' => 768,
+                    ])
+                    ->integerPrototype()
+                    ->end()
+                ->end()
                 ->arrayNode('directories')->defaultValue(['%twig.default_path%/components'])
                     ->scalarPrototype()->end()
                 ->end()

src/DependencyInjection/TwigDocExtension.php

@@ -22,6 +22,7 @@ public function load(array $configs, ContainerBuilder $container): void
 
         $definition = $container->getDefinition('twig_doc.service.component');
         $definition->setArgument('$componentsConfig', $config['components']);
+        $definition->setArgument('$breakpointConfig', $config['components']);
         $definition->setArgument('$configReadTime', time());
 
         $categories = array_merge([['name' => ComponentCategory::DEFAULT_CATEGORY]], $config['categories']);

src/Service/ComponentService.php

@@ -18,6 +18,7 @@ public function __construct(
         private readonly ComponentItemFactory $itemFactory,
         private readonly array $componentsConfig,
         private readonly CacheInterface $cache,
+        private readonly array $breakpointConfig,
         private readonly int $configReadTime = 0
     ) {
     }
@@ -95,4 +96,9 @@ public function getComponent(string $name): ?ComponentItem
     {
         return array_values(array_filter((array) $this->getComponents(), fn (ComponentItem $c) => $c->getName() === $name))[0] ?? null;
     }
+
+    public function getBreakpoints(): array
+    {
+        return $this->breakpointConfig;
+    }
 }

tests/Functional/Service/ComponentServiceTest.php

@@ -67,7 +67,12 @@ public function testParsePerformance(): void
 
         $start = microtime(true);
 
-        $service = new ComponentService($factory, $this->getLargeConfig(), static::getContainer()->get(CacheInterface::class));
+        $service = new ComponentService(
+            $factory,
+            $this->getLargeConfig(),
+            static::getContainer()->get(CacheInterface::class),
+            []
+        );
 
         $service->getComponents();
 

tests/Unit/DependencyInjection/ConfigurationTest.php

@@ -18,7 +18,7 @@ public function testConfigTree(array $options, array $expectedResult)
         $configuration = new Configuration();
         $config = $processor->processConfiguration($configuration, [$options]);
 
-        $this->assertEqualsCanonicalizing($expectedResult, $config);
+        $this->assertEquals($expectedResult, $config);
     }
 
     public static function getTestConfiguration(): iterable
@@ -41,6 +41,11 @@ public static function getTestConfiguration(): iterable
             ],
             [
                 'doc_identifier' => 'TWIG_DOC',
+                'breakpoints' => [
+                    'small' => 240,
+                    'medium' => 640,
+                    'large' => 768,
+                ],
                 'directories' => [
                     __DIR__.'/../../TestApp/templates/components',
                     __DIR__.'/../../TestApp/templates/snippets',
@@ -100,6 +105,11 @@ public static function getTestConfiguration(): iterable
             ],
             [
                 'doc_identifier' => 'TWIG_DOC',
+                'breakpoints' => [
+                    'small' => 240,
+                    'medium' => 640,
+                    'large' => 768,
+                ],
                 'directories' => [
                     __DIR__.'/../../TestApp/templates/components',
                     __DIR__.'/../../TestApp/templates/snippets',
@@ -139,5 +149,28 @@ public static function getTestConfiguration(): iterable
                 ],
             ],
         ];
+
+        yield 'Breakpoint config' => [
+            [
+                'breakpoints' => [
+                    'iphone' => 568,
+                    'galaxy s10' => 658,
+                    'generic' => 896,
+                ],
+            ],
+            [
+                'breakpoints' => [
+                    'iphone' => 568,
+                    'galaxy s10' => 658,
+                    'generic' => 896,
+                ],
+                'doc_identifier' => 'TWIG_DOC',
+                'directories' => [
+                    '%twig.default_path%/components',
+                ],
+                'categories' => [],
+                'components' => [],
+            ],
+        ];
     }
 }