Implement #192 — prefix-stripping DX for CwaFixtureBuilder uiComponent

layout() and page() now accept a suffix only and prepend the correct
framework prefix automatically:
  $cwa->layout('main', 'Primary')   → stores 'CwaLayoutPrimary'
  $cwa->page('home', 'Blog', ...)   → stores 'CwaPageBlog'

ComponentBuilder gains uiComponent(string $suffix) which derives the full
alt-component name from the entity class:
  $cwa->component($link)->uiComponent('YouTube')
  → stores 'CwaComponentNavigationLinkUiYouTube'

uiClassNames() on LayoutBuilder, PageBuilder, and ComponentBuilder is now
variadic: ->uiClassNames('bold', 'dark') instead of ->uiClassNames([...]).

GenerateFixturesCommand strips the CwaLayout/CwaPage prefix when emitting
fixture code so the generated output uses the new short-name API.

MakeCwaScaffold and skeleton template updated to use suffix-only names.

Author: silverbackdan

CLAUDE.md

@@ -352,19 +352,20 @@ Register `AppScaffold` as a service; it's ready to use as a Doctrine fixture wit
 
 ```
 CwaFixtureBuilder
-  ->layout(ref, uiComponent, ?uiClassNames): LayoutBuilder  (deduped by ref; returns same builder if called twice)
-  ->page(ref, uiComponent, layout, ?route, ?routeName, isTemplate=false, ?Closure, ?uiClassNames): PageBuilder
+  ->layout(ref, uiSuffix, ?uiClassNames): LayoutBuilder  (deduped by ref; prepends 'CwaLayout' to uiSuffix)
+  ->page(ref, uiSuffix, layout, ?route, ?routeName, isTemplate=false, ?Closure, ?uiClassNames): PageBuilder  (prepends 'CwaPage' to uiSuffix)
   ->pageData(AbstractPageData, ?template, ?route, ?routeName, ?Closure): PageDataBuilder
+  ->component(AbstractComponent): ComponentBuilder
   ->getRoute(routeName): Route                              (look up a named route already created)
 
 LayoutBuilder
   ->group(name, allow: [], ?Closure): GroupBuilder          (returns the GroupBuilder; same name = same group)
-  ->uiClassNames(array): self
+  ->uiClassNames(string ...$classes): self
 
 PageBuilder
   ->title(string): self
   ->metaDescription(string): self
-  ->uiClassNames(array): self
+  ->uiClassNames(string ...$classes): self
   ->group(name, ?Closure): GroupBuilder
   ->nested(Closure): void                                   (Closure receives CwaFixtureBuilder with parent context)
   ->getRoute(): ?Route                                      (route after builder flushes RouteGenerator)
@@ -374,6 +375,11 @@ PageDataBuilder
   ->onRoutesCreated(Closure): self                   (Closure receives array<PageBuilder> of direct child page builders; called after phaseThree so child route paths are available)
   ->getRoute(): ?Route
 
+ComponentBuilder
+  ->uiComponent(suffix): self                        (stores 'CwaComponent' + ShortClassName + 'Ui' + suffix)
+  ->uiClassNames(string ...$classes): self
+  ->group(name, allow: [], ?Closure): GroupBuilder
+
 GroupBuilder
   ->add(AbstractComponent, ?sort): self              (sort defaults to insertion order × 10)
   ->pageDataPosition(pageDataClass, propertyName, ?sort): self      (creates ComponentPosition with pageDataClass and pageDataProperty set)

src/Command/GenerateFixturesCommand.php

@@ -107,7 +107,7 @@ private function emitLayout(Layout $layout): string
     {
         $varName = '$layout_' . $this->toVar($layout->reference ?? 'layout');
         $ref = var_export($layout->reference, true);
-        $ui = var_export($layout->uiComponent, true);
+        $ui = var_export($this->stripUiPrefix($layout->uiComponent, 'CwaLayout'), true);
 
         $extra = '';
         if (null !== $layout->uiClassNames) {
@@ -207,7 +207,7 @@ private function emitPage(
         string $builderVar = '$cwa',
     ): string {
         $ref = var_export($page->reference, true);
-        $ui = var_export($page->uiComponent, true);
+        $ui = var_export($this->stripUiPrefix($page->uiComponent, 'CwaPage'), true);
         $layoutRef = var_export(isset($page->layout) ? $page->layout->reference : null, true);
 
         $args = "{$ref}, {$ui}, layout: {$layoutRef}";
@@ -403,6 +403,15 @@ private function exportArray(array $arr): string
         return '[' . $items . ']';
     }
 
+    private function stripUiPrefix(?string $value, string $prefix): ?string
+    {
+        if (null === $value) {
+            return null;
+        }
+
+        return str_starts_with($value, $prefix) ? substr($value, \strlen($prefix)) : $value;
+    }
+
     private function getRouteName(Route $route): ?string
     {
         $rp = (new \ReflectionClass($route))->getProperty('name');

src/Fixture/Builder/ComponentBuilder.php

@@ -22,6 +22,21 @@ public function __construct(private readonly AbstractComponent $component)
     {
     }
 
+    public function uiComponent(string $suffix): self
+    {
+        $shortName = (new \ReflectionClass($this->component))->getShortName();
+        $this->component->uiComponent = 'CwaComponent' . $shortName . 'Ui' . $suffix;
+
+        return $this;
+    }
+
+    public function uiClassNames(string ...$classes): self
+    {
+        $this->component->uiClassNames = $classes;
+
+        return $this;
+    }
+
     public function group(string $name, array $allow = [], ?\Closure $configure = null, ?string $locationReference = null): GroupBuilder
     {
         if (!isset($this->groupBuilders[$name])) {

src/Fixture/Builder/LayoutBuilder.php

@@ -34,7 +34,7 @@ public function group(string $name, array $allow = [], ?\Closure $configure = nu
         return $this->groupBuilders[$name];
     }
 
-    public function uiClassNames(array $classes): self
+    public function uiClassNames(string ...$classes): self
     {
         $this->layout->uiClassNames = $classes;
 

src/Fixture/Builder/PageBuilder.php

@@ -48,7 +48,7 @@ public function metaDescription(string $metaDescription): self
         return $this;
     }
 
-    public function uiClassNames(array $classes): self
+    public function uiClassNames(string ...$classes): self
     {
         $this->page->uiClassNames = $classes;
 

src/Fixture/CwaFixtureBuilder.php

@@ -101,7 +101,7 @@ public function layout(string $ref, string $uiComponent, ?array $uiClassNames =
         if (!isset($this->layoutBuilders[$ref])) {
             $layout = new Layout();
             $layout->reference = $ref;
-            $layout->uiComponent = $uiComponent;
+            $layout->uiComponent = '' !== $uiComponent ? 'CwaLayout' . $uiComponent : null;
             $layout->uiClassNames = $uiClassNames;
             $this->layoutBuilders[$ref] = new LayoutBuilder($layout);
         }
@@ -122,7 +122,7 @@ public function page(
         if (!isset($this->pageSpecs[$ref])) {
             $page = new Page();
             $page->reference = $ref;
-            $page->uiComponent = $uiComponent;
+            $page->uiComponent = '' !== $uiComponent ? 'CwaPage' . $uiComponent : null;
             $page->uiClassNames = $uiClassNames;
             $page->isTemplate = $isTemplate;
             if ($this->parentContext instanceof AbstractPageData) {

src/Maker/MakeCwaScaffold.php

@@ -42,7 +42,7 @@ public function configureCommand(Command $command, InputConfiguration $inputConf
         $command
             ->addArgument('name', InputArgument::OPTIONAL, 'The class name for your scaffold (e.g. <fg=yellow>AppScaffold</>)')
             ->addOption('layout-ref', null, InputOption::VALUE_REQUIRED, 'Layout reference key used in <comment>$cwa->layout()</comment>', 'main')
-            ->addOption('layout-component', null, InputOption::VALUE_REQUIRED, 'Layout UI component name (e.g. <comment>CwaLayoutPrimary</comment>)', 'CwaLayoutPrimary');
+            ->addOption('layout-component', null, InputOption::VALUE_REQUIRED, 'Layout UI component name (e.g. <comment>Primary</comment>)', 'Primary');
     }
 
     public function interact(InputInterface $input, ConsoleStyle $io, Command $command): void
@@ -52,8 +52,8 @@ public function interact(InputInterface $input, ConsoleStyle $io, Command $comma
             $input->setOption('layout-ref', $ref);
         }
 
-        if (!$input->getOption('layout-component') || 'CwaLayoutPrimary' === $input->getOption('layout-component')) {
-            $component = $io->ask('Layout UI component name', 'CwaLayoutPrimary');
+        if (!$input->getOption('layout-component') || 'Primary' === $input->getOption('layout-component')) {
+            $component = $io->ask('Layout UI component name', 'Primary');
             $input->setOption('layout-component', $component);
         }
     }

src/Resources/skeleton/scaffold/Scaffold.tpl.php

@@ -24,14 +24,14 @@ public function build(CwaFixtureBuilder $cwa): void
             ->group('top');
 
         // --- Pages ------------------------------------------------------------
-        $cwa->page('home', 'PrimaryPageTemplate', layout: '<?php echo $layout_ref; ?>', route: '/', routeName: 'home-page',
+        $cwa->page('home', 'PrimaryPage', layout: '<?php echo $layout_ref; ?>', route: '/', routeName: 'home-page',
             configure: fn (PageBuilder $page) => $page
                 ->title('Home')
                 ->group('primary')
         );
 
         // Add more pages here, e.g.:
-        // $cwa->page('about', 'PrimaryPageTemplate', layout: '<?php echo $layout_ref; ?>', route: '/about', routeName: 'about-page',
+        // $cwa->page('about', 'PrimaryPage', layout: '<?php echo $layout_ref; ?>', route: '/about', routeName: 'about-page',
         //     configure: fn (PageBuilder $page) => $page->title('About')->group('primary')
         // );
 

tests/Command/GenerateFixturesCommandTest.php

@@ -183,7 +183,8 @@ public function test_layout_appears_as_cwa_layout_call(): void
         $content = file_get_contents($this->outputFile);
         $this->assertStringContainsString('->layout(', $content);
         $this->assertStringContainsString("'main'", $content);
-        $this->assertStringContainsString("'CwaLayoutPrimary'", $content);
+        $this->assertStringContainsString("'Primary'", $content);
+        $this->assertStringNotContainsString("'CwaLayoutPrimary'", $content);
     }
 
     public function test_page_with_route_appears_as_cwa_page_call(): void