Merge pull request #5 from dpfaffenbauer/claude/pimcore-studio-form-bundle-wwDly

[StudioFormBundle] introduce new dynamic form rendering bundle

Author: dpfaffenbauer

CLAUDE.md

@@ -1061,5 +1061,148 @@ BundleX/Resources/assets/pimcore-studio/src/
 └── main.ts  # Registration in onInit()
 ```
 
+## StudioFormBundle - Schema-Driven Form System
+
+StudioFormBundle generates React forms from Symfony form types. Instead of manually building React forms, you define a Symfony FormType and the bundle auto-generates a JSON schema that the frontend renders dynamically.
+
+### Data Flow
+
+```
+Symfony FormType → FormSchemaGenerator → JSON Schema → FormSchemaAdapter → FormBuilder → DynamicForm (React)
+```
+
+### Backend (PHP)
+
+#### Key Classes
+
+| Class | Location | Purpose |
+|-------|----------|---------|
+| `FormSchemaGenerator` | `StudioFormBundle/Form/Schema/` | Converts Symfony FormView → JSON schema |
+| `FormSchemaEnricherInterface` | `StudioFormBundle/Form/Schema/` | Extension point: add tabs, sections, hide fields |
+| `BlockPrefixFormTypeRegistry` | `StudioFormBundle/Form/Schema/` | Maps Symfony block prefixes → form type classes |
+| `RuleFormSchemaCollector` | `StudioFormBundle/Form/Schema/` | Collects schemas for rule engine form types |
+| `FormSchemaController` | `StudioFormBundle/Controller/` | `GET /pimcore-studio/api/coreshop-studio-form/schema/{blockPrefix}` |
+
+#### Enricher Pattern
+
+Enrichers customize the generated schema per bundle (tagged `coreshop_studio_form.enricher`):
+
+```php
+class CartCreationSchemaEnricher implements FormSchemaEnricherInterface
+{
+    public function supports(string $formTypeClass): bool
+    {
+        return $formTypeClass === CartCreationType::class;
+    }
+
+    public function enrich(FormSchema $schema, string $formTypeClass): FormSchema
+    {
+        $schema->addSection('base', 'Base', 10);
+        $schema->setFieldSection('currency', 'base');
+        return $schema;
+    }
+}
+```
+
+Multiple enrichers process the same schema sequentially (priority-ordered). OrderBundle adds base sections, CoreBundle adds address/shipping/payment sections.
+
+#### Service Tags
+
+- `coreshop.studio_form` — registers a FormType in BlockPrefixFormTypeRegistry
+- `coreshop_studio_form.enricher` — registers a FormSchemaEnricher (supports `priority`)
+
+### Frontend (React/TypeScript)
+
+#### Key Components
+
+| Component | Location | Purpose |
+|-----------|----------|---------|
+| `WidgetRegistry` | `schema-adapter/WidgetRegistry.ts` | Maps block prefixes → React components |
+| `FormSchemaAdapter` | `schema-adapter/FormSchemaAdapter.ts` | Converts JSON schema → FormBuilderConfig |
+| `FormBuilder` | `form-builder/FormBuilder.ts` | Decorator-based config builder |
+| `DynamicForm` | `form-builder/components/DynamicForm.tsx` | Renders form from config (tabs, sections, fields) |
+| `SchemaForm` | `schema-adapter/SchemaForm.tsx` | Convenience: `useFormSchema` + `DynamicForm` |
+
+#### Widget Resolution
+
+WidgetRegistry resolves block prefixes right-to-left (most specific first), matching Symfony's Twig block resolution:
+```
+blockPrefixes: ['form', 'text', 'email'] → tries email → text → form
+```
+
+#### Default Widgets
+
+Standard Symfony types are pre-mapped: `text`→Input, `textarea`→Input.TextArea, `integer`→InputNumber, `checkbox`→Switch, `choice`→Select/Radio/Checkbox, `date`→DatePicker, `collection`→CollectionWidget, `grid_collection`→GridCollectionWidget.
+
+Custom widgets are registered via `WidgetRegistry.register(blockPrefix, resolver)`.
+
+#### Schema Caching (Frontend)
+
+`fetchFormSchema()` uses module-level caching + request deduplication. `preSeedSchemaCache()` for bulk pre-loading rule schemas.
+
+#### Standard Decorators
+
+Available from `@coreshop/studio-form/src/form-builder/decorators/`:
+- `addFieldDecorator`, `removeFieldDecorator`, `transformFieldDecorator`
+- `addSectionDecorator`, `sectionSortingDecorator`, `sectionFilterDecorator`
+- `hiddenFieldsDecorator`, `readonlyDecorator`
+- `addValidationDecorator`, `requiredFieldDecorator`
+- `conditionalFieldsDecorator`, `groupFieldsDecorator`
+
+#### Usage Example
+
+```typescript
+import { SchemaForm } from '@coreshop/studio-form'
+
+// Simple: auto-generates form from Symfony FormType
+<SchemaForm blockPrefix="coreshop_cart_creation" data={data} onChange={onChange} />
+
+// With decorators:
+const { builder, loading } = useFormSchema('coreshop_country', [
+  { name: 'hide-field', decorator: removeFieldDecorator('internalCode') },
+  { name: 'add-custom', decorator: addFieldDecorator({ name: 'custom', label: 'Custom', component: Input }) }
+])
+```
+
+### File Structure
+
+```
+StudioFormBundle/
+├── Form/Schema/
+│   ├── FormSchema.php, FieldSchema.php          # DTOs
+│   ├── FormSchemaGenerator.php                   # Core engine
+│   ├── FormSchemaEnricherInterface.php           # Extension point
+│   ├── BlockPrefixFormTypeRegistry.php           # Block prefix → class map
+│   └── RuleFormSchemaCollector.php               # Multi-schema for rules
+├── Controller/FormSchemaController.php           # API endpoint
+├── DependencyInjection/Compiler/
+│   ├── RegisterFormSchemaEnricherPass.php
+│   └── RegisterStudioFormTypesPass.php
+└── Resources/assets/pimcore-studio/src/
+    ├── schema-adapter/                           # Schema → FormBuilder
+    │   ├── WidgetRegistry.ts, FormSchemaAdapter.ts
+    │   ├── api.ts, useFormSchema.ts, SchemaForm.tsx
+    │   └── defaultWidgets.ts
+    └── form-builder/                             # FormBuilder + DynamicForm
+        ├── FormBuilder.ts
+        ├── components/DynamicForm.tsx
+        └── decorators/index.ts
+```
+
+### Bundle Integration Example
+
+```yaml
+# OrderBundle/Resources/config/services/forms.yml
+services:
+  CoreShop\Bundle\OrderBundle\Form\Type\CartCreationType:
+    tags:
+      - { name: form.type }
+      - { name: coreshop.studio_form }
+
+  CoreShop\Bundle\OrderBundle\Form\Schema\CartCreationSchemaEnricher:
+    tags:
+      - { name: coreshop_studio_form.enricher, priority: 10 }
+```
+
 ## Knowledge Graph
 Use the knowledge-graph-mcp before and after every task you do.

composer.json

@@ -26,63 +26,64 @@
     }
   ],
   "replace": {
-    "coreshop/resource": "self.version",
     "coreshop/address": "self.version",
-    "coreshop/configuration": "self.version",
-    "coreshop/currency": "self.version",
-    "coreshop/customer": "self.version",
-    "coreshop/index": "self.version",
-    "coreshop/locale": "self.version",
-    "coreshop/notification": "self.version",
-    "coreshop/order": "self.version",
-    "coreshop/payment": "self.version",
-    "coreshop/product": "self.version",
-    "coreshop/registry": "self.version",
-    "coreshop/rule": "self.version",
-    "coreshop/sequence": "self.version",
-    "coreshop/shipping": "self.version",
-    "coreshop/store": "self.version",
-    "coreshop/taxation": "self.version",
-    "coreshop/core": "self.version",
-    "coreshop/resource-bundle": "self.version",
     "coreshop/address-bundle": "self.version",
     "coreshop/admin-bundle": "self.version",
+    "coreshop/class-definition-patch-bundle": "self.version",
+    "coreshop/configuration": "self.version",
     "coreshop/configuration-bundle": "self.version",
+    "coreshop/core": "self.version",
+    "coreshop/core-bundle": "self.version",
+    "coreshop/currency": "self.version",
     "coreshop/currency-bundle": "self.version",
+    "coreshop/customer": "self.version",
     "coreshop/customer-bundle": "self.version",
     "coreshop/frontend-bundle": "self.version",
+    "coreshop/index": "self.version",
     "coreshop/index-bundle": "self.version",
+    "coreshop/inventory": "self.version",
+    "coreshop/inventory-bundle": "self.version",
+    "coreshop/locale": "self.version",
     "coreshop/locale-bundle": "self.version",
+    "coreshop/menu-bundle": "self.version",
+    "coreshop/messenger-bundle": "self.version",
     "coreshop/money-bundle": "self.version",
+    "coreshop/notification": "self.version",
     "coreshop/notification-bundle": "self.version",
+    "coreshop/optimistic-entity-lock-bundle": "self.version",
+    "coreshop/order": "self.version",
     "coreshop/order-bundle": "self.version",
+    "coreshop/payment": "self.version",
     "coreshop/payment-bundle": "self.version",
     "coreshop/payum-bundle": "self.version",
+    "coreshop/payum-payment": "self.version",
+    "coreshop/payum-payment-bundle": "self.version",
+    "coreshop/pimcore": "self.version",
+    "coreshop/pimcore-bundle": "self.version",
+    "coreshop/product": "self.version",
     "coreshop/product-bundle": "self.version",
+    "coreshop/registry": "self.version",
+    "coreshop/resource": "self.version",
+    "coreshop/resource-bundle": "self.version",
+    "coreshop/rule": "self.version",
     "coreshop/rule-bundle": "self.version",
+    "coreshop/seo": "self.version",
+    "coreshop/seo-bundle": "self.version",
+    "coreshop/sequence": "self.version",
     "coreshop/sequence-bundle": "self.version",
+    "coreshop/shipping": "self.version",
     "coreshop/shipping-bundle": "self.version",
+    "coreshop/storage-list": "self.version",
+    "coreshop/store": "self.version",
     "coreshop/store-bundle": "self.version",
+    "coreshop/studio-form-bundle": "self.version",
+    "coreshop/taxation": "self.version",
     "coreshop/taxation-bundle": "self.version",
-    "coreshop/tracking-bundle": "self.version",
-    "coreshop/core-bundle": "self.version",
-    "coreshop/pimcore": "self.version",
-    "coreshop/storage-list": "self.version",
-    "coreshop/inventory": "self.version",
-    "coreshop/inventory-bundle": "self.version",
-    "coreshop/workflow-bundle": "self.version",
-    "coreshop/seo": "self.version",
-    "coreshop/seo-bundle": "self.version",
-    "coreshop/pimcore-bundle": "self.version",
-    "coreshop/tracking": "self.version",
+    "coreshop/test-bundle": "self.version",
     "coreshop/theme-bundle": "self.version",
-    "coreshop/menu-bundle": "self.version",
-    "coreshop/payum-payment": "self.version",
-    "coreshop/payum-payment-bundle": "self.version",
-    "coreshop/optimistic-entity-lock-bundle": "self.version",
-    "coreshop/messenger-bundle": "self.version",
-    "coreshop/class-definition-patch-bundle": "self.version",
-    "coreshop/test-bundle": "self.version"
+    "coreshop/tracking": "self.version",
+    "coreshop/tracking-bundle": "self.version",
+    "coreshop/workflow-bundle": "self.version"
   },
   "require": {
     "php": "^8.3",
@@ -94,6 +95,7 @@
     "doctrine/orm": "^3.0",
     "fakerphp/faker": "^1.16",
     "gedmo/doctrine-extensions": "^3.11",
+    "jms/serializer": "^3.32",
     "jms/serializer-bundle": "^5.5",
     "knplabs/knp-menu-bundle": "^3.7",
     "payum/payum": "1.7.x-dev",

docs/03_Development/01_Extending_Guide/04_Extending_Rule_Actions.md

@@ -118,7 +118,17 @@ core_shop_product:
 
 ## Pimcore Studio (React)
 
-For the new Pimcore Studio UI, you need to create a React component instead of ExtJS:
+### Schema-Driven (Recommended — No Custom JS Needed)
+
+**The service registration above is all you need for Pimcore Studio.** The `form-type` attribute in the service tag automatically makes the configuration form available in Studio. No React/TypeScript code is required.
+
+The StudioFormBundle renders the PHP FormType (`CustomActionType`) as a React form at runtime. The `get-config` endpoint returns a `actionSchemaByType` mapping, and `registerSchemaComponentsFromConfig()` auto-generates the React component from the schema.
+
+For details, see [StudioFormBundle — Rule Engine Integration](../14_Studio/02_Base_Infrastructure/05_StudioFormBundle_Examples.md#example-13--rule-conditionaction-as-schema-form).
+
+### Hand-Written React Component (Only for Special UIs)
+
+If your action needs custom interactive behavior that cannot be expressed as a Symfony FormType (e.g., complex multi-step wizards, drag-and-drop), you can still create a hand-written React component:
 
 ```typescript
 // src/CoreShop/Bundle/YourBundle/Resources/assets/pimcore-studio/src/modules/product-price-rules/actions/CustomAction.tsx
@@ -160,9 +170,7 @@ export const CustomAction: React.FC<ActionComponentProps> = ({
 }
 ```
 
-### Registering the React Action
-
-Register the action in your bundle's main plugin file:
+Register the hand-written action in your bundle's main plugin file. Hand-written components take priority over schema-generated ones:
 
 ```typescript
 // src/CoreShop/Bundle/YourBundle/Resources/assets/pimcore-studio/src/main.ts
@@ -188,53 +196,3 @@ const plugin: IAbstractPlugin = {
 
 export default plugin
 ```
-
-### Action Without Configuration
-
-If your action doesn't need any configuration UI, you can use the built-in `EmptyAction`:
-
-```typescript
-import { EmptyAction } from '@coreshop/rule/src/rules'
-
-actionRegistry.register('customActionWithoutConfig', EmptyAction)
-```
-
-### Available Form Components
-
-The Studio UI uses Ant Design components. Commonly used form components:
-
-- `InputNumber` - Number input with precision
-- `Input` - Text input
-- `Select` - Dropdown selection
-- `Checkbox` - Boolean values
-- `DatePicker` - Date selection
-- `Switch` - Toggle switch
-
-### Using Entity Selects
-
-For selecting entities (e.g., products, categories), use the `useEntitySelect` hook:
-
-```typescript
-import { useEntitySelect } from '@coreshop/resource'
-import { productApi } from '@coreshop/product/src/modules/products/api'
-
-export const CustomAction: React.FC<ActionComponentProps> = ({ data, onChange }) => {
-  const productIds = data.products || []
-  const [options, value, handleSelectChange, loading] = useEntitySelect(productApi, productIds)
-
-  const handleChange = (selectedIds: number[]) => {
-    handleSelectChange(selectedIds)
-    onChange({ ...data, products: selectedIds })
-  }
-
-  return (
-    <Select
-      mode="multiple"
-      value={value}
-      onChange={handleChange}
-      options={options}
-      loading={loading}
-    />
-  )
-}
-```