Release v1.0.15: FormKit admin forms and Twig Extra (REQ-TWIG-004).

Author: HecFranco

.scripts/check-twig-extra.sh

@@ -0,0 +1,59 @@
+#!/usr/bin/env bash
+# REQ-TWIG-004 — fail when Twig applies but twig/extra-bundle (and demos) are not ready.
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+cd "$ROOT"
+
+has_twig=0
+if find src -type f -name '*.twig' 2>/dev/null | grep -q .; then
+  has_twig=1
+elif find templates Resources -type f -name '*.twig' 2>/dev/null | grep -q .; then
+  has_twig=1
+fi
+
+if [[ "$has_twig" -eq 0 ]]; then
+  echo "check-twig-extra: Twig does not apply (no templates) — OK"
+  exit 0
+fi
+
+fail=0
+
+if ! grep -q '"twig/extra-bundle"' composer.json; then
+  echo "ERROR: twig/extra-bundle missing from package composer.json require (REQ-TWIG-004)" >&2
+  fail=1
+fi
+
+if ! grep -q '"twig/string-extra"' composer.json; then
+  echo "ERROR: twig/string-extra missing from package composer.json require (REQ-TWIG-004 baseline)" >&2
+  fail=1
+fi
+
+shopt -s nullglob
+for demo_composer in demo/*/composer.json demo/*/*/composer.json; do
+  [[ -f "$demo_composer" ]] || continue
+  demo_dir="$(dirname "$demo_composer")"
+  # Skip demos that never render Twig (no bundles.php / no twig)
+  bundles_php="$demo_dir/config/bundles.php"
+  if [[ ! -f "$bundles_php" ]]; then
+    continue
+  fi
+  if ! grep -q 'TwigBundle' "$bundles_php" 2>/dev/null; then
+    continue
+  fi
+  if ! grep -q '"twig/extra-bundle"' "$demo_composer"; then
+    echo "ERROR: $demo_composer missing twig/extra-bundle (REQ-TWIG-004)" >&2
+    fail=1
+  fi
+  if ! grep -q 'Twig\\\\Extra\\\\TwigExtraBundle\\\\TwigExtraBundle' "$bundles_php" \
+    && ! grep -q 'Twig\\Extra\\TwigExtraBundle\\TwigExtraBundle' "$bundles_php"; then
+    echo "ERROR: $bundles_php missing TwigExtraBundle (REQ-TWIG-004)" >&2
+    fail=1
+  fi
+done
+
+if [[ "$fail" -ne 0 ]]; then
+  exit 1
+fi
+
+echo "check-twig-extra: OK"

.twig-cs-fixer.php

@@ -0,0 +1,30 @@
+<?php
+
+declare(strict_types=1);
+
+use TwigCsFixer\Config\Config;
+use TwigCsFixer\File\Finder;
+use TwigCsFixer\Ruleset\Ruleset;
+use TwigCsFixer\Standard\TwigCsFixer;
+
+$paths = [];
+foreach ([__DIR__ . '/src', __DIR__ . '/templates'] as $path) {
+    if (is_dir($path)) {
+        $paths[] = $path;
+    }
+}
+
+$finder = new Finder();
+foreach ($paths as $path) {
+    $finder->in($path);
+}
+$finder->exclude(['vendor', 'var', 'node_modules', 'coverage', 'demo']);
+
+$ruleset = new Ruleset();
+$ruleset->addStandard(new TwigCsFixer());
+
+$config = new Config();
+$config->setRuleset($ruleset);
+$config->setFinder($finder);
+
+return $config;

Makefile

@@ -11,7 +11,7 @@ endif
 COMPOSE     := $(COMPOSE_BIN) -f $(COMPOSE_FILE)
 SERVICE_PHP := php
 
-.PHONY: help up down down-dev build shell install assets test test-coverage cs-check cs-fix qa clean release-check release-check-demos composer-sync rector rector-dry phpstan update validate validate-translations check-no-cursor-coauthor check-open-prs strip-cursor-coauthor-from-history setup-hooks demo-smoke
+.PHONY: help up down down-dev build shell install assets test test-coverage cs-check cs-fix qa clean release-check release-check-demos composer-sync rector rector-dry phpstan update validate validate-translations check-no-cursor-coauthor check-open-prs strip-cursor-coauthor-from-history setup-hooks demo-smoke check-twig-extra
 
 help:
 	@echo "API Studio Bundle - Development Commands"
@@ -88,7 +88,12 @@ validate: ensure-up
 validate-translations: ensure-up
 	@$(COMPOSE) exec -T $(SERVICE_PHP) php vendor/bin/yaml-lint src/Resources/translations
 
-release-check: ensure-up check-no-cursor-coauthor check-open-prs composer-sync cs-fix cs-check rector-dry phpstan test-coverage validate-translations release-check-demos
+
+check-twig-extra:
+	@chmod +x .scripts/check-twig-extra.sh
+	@./.scripts/check-twig-extra.sh
+
+release-check: ensure-up check-no-cursor-coauthor check-open-prs check-twig-extra composer-sync cs-fix cs-check rector-dry phpstan test-coverage validate-translations release-check-demos
 
 # REQ-TEST-011 — boot demo stack and assert one HTTP 200
 demo-smoke:
@@ -138,3 +143,6 @@ check-open-prs:
 strip-cursor-coauthor-from-history:
 	@chmod +x .scripts/strip-cursor-coauthor-from-history.sh
 	@./.scripts/strip-cursor-coauthor-from-history.sh main
+
+twig-lint: ensure-up
+	@$(COMPOSE) exec -T $(SERVICE_PHP) composer twig:lint || $(COMPOSE) exec -T $(SERVICE_PHP) ./vendor/bin/twig-cs-fixer lint --config=.twig-cs-fixer.php

README.md

@@ -29,11 +29,14 @@ This bundle is **FrankenPHP worker mode friendly**.
 composer require nowo-tech/api-studio-bundle
 ```
 
-Register the bundle:
+Register the bundle and hard dependencies (Flex usually does this):
 
 ```php
 // config/bundles.php
 Nowo\ApiStudioBundle\ApiStudioBundle::class => ['all' => true],
+Nowo\UiKitBundle\NowoUiKitBundle::class => ['all' => true],
+Nowo\FormKitBundle\NowoFormKitBundle::class => ['all' => true],
+Twig\Extra\TwigExtraBundle\TwigExtraBundle::class => ['all' => true],
 ```
 
 Install the Asset component (required for Twig `asset()` in the request console):
@@ -81,6 +84,9 @@ Open `/api-studio` in your browser.
 - Doctrine ORM
 - `ext-json`
 - `ext-soap` (optional, for SOAP execution)
+- [UiKitBundle](https://github.com/nowo-tech/UiKitBundle) `^1.4`
+- [FormKitBundle](https://github.com/nowo-tech/FormKitBundle) `^2.0`
+- `twig/extra-bundle` + `twig/string-extra` `^3.12` (REQ-TWIG-004)
 
 ## Browser scripts (pre/post-request)
 

composer.json

@@ -1,6 +1,6 @@
 {
     "name": "nowo-tech/api-studio-bundle",
-    "description": "Symfony bundle for managing, documenting, and testing REST, SOAP, and GraphQL APIs — your own Postman/Apidog inside Symfony.",
+    "description": "Symfony bundle for managing, documenting, and testing REST, SOAP, and GraphQL APIs \u2014 your own Postman/Apidog inside Symfony.",
     "type": "symfony-bundle",
     "license": "MIT",
     "keywords": [
@@ -24,7 +24,7 @@
     },
     "authors": [
         {
-            "name": "Héctor Franco Aceituno",
+            "name": "H\u00e9ctor Franco Aceituno",
             "email": "hectorfranco@nowo.tech",
             "homepage": "https://github.com/HecFranco",
             "role": "Developer"
@@ -35,10 +35,12 @@
         }
     ],
     "require": {
-        "php": ">=8.2 <8.6",
         "doctrine/doctrine-bundle": "^2.10 || ^3.0",
         "doctrine/orm": "^2.15 || ^3.0",
         "ext-json": "*",
+        "nowo-tech/form-kit-bundle": "^2.0",
+        "nowo-tech/ui-kit-bundle": "^1.4",
+        "php": ">=8.2 <8.6",
         "symfony/asset": "^7.0 || ^8.0",
         "symfony/config": "^7.0 || ^8.0",
         "symfony/dependency-injection": "^7.0 || ^8.0",
@@ -49,11 +51,12 @@
         "symfony/routing": "^7.0 || ^8.0",
         "symfony/security-bundle": "^7.0 || ^8.0",
         "symfony/security-csrf": "^7.0 || ^8.0",
-        "symfony/twig-bundle": "^7.0 || ^8.0",
         "symfony/translation": "^7.0 || ^8.0",
+        "symfony/twig-bundle": "^7.0 || ^8.0",
         "symfony/validator": "^7.0 || ^8.0",
         "symfony/yaml": "^7.0 || ^8.0",
-        "nowo-tech/ui-kit-bundle": "^1.4"
+        "twig/extra-bundle": "^3.12",
+        "twig/string-extra": "^3.12"
     },
     "require-dev": {
         "friendsofphp/php-cs-fixer": "^3.0",
@@ -64,7 +67,8 @@
         "phpstan/phpstan-symfony": "^2.0",
         "phpunit/phpunit": "^10.0 || ^11.0",
         "rector/rector": "^2.0",
-        "symfony/browser-kit": "^7.0 || ^8.0"
+        "symfony/browser-kit": "^7.0 || ^8.0",
+        "vincentlanglet/twig-cs-fixer": "^3.0"
     },
     "autoload": {
         "psr-4": {
@@ -77,7 +81,10 @@
         }
     },
     "archive": {
-        "exclude": ["/demo", "/.cursor"]
+        "exclude": [
+            "/demo",
+            "/.cursor"
+        ]
     },
     "config": {
         "sort-packages": true,
@@ -107,7 +114,10 @@
         "qa": [
             "@cs-check",
             "@test"
-        ]
+        ],
+        "twig:lint": "twig-cs-fixer lint --config=.twig-cs-fixer.php",
+        "twig:fix": "twig-cs-fixer fix --config=.twig-cs-fixer.php",
+        "twig:fix:check": "twig-cs-fixer lint --config=.twig-cs-fixer.php --fix"
     },
     "scripts-descriptions": {
         "test": "Run PHPUnit tests",