[Toolkit] Introduce the UX Toolkit ✨

src/Toolkit/.gitattributes

@@ -0,0 +1,5 @@
+/.git* export-ignore
+/.symfony.bundle.yaml export-ignore
+/phpunit.xml.dist export-ignore
+/doc export-ignore
+/tests export-ignore

src/Toolkit/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,8 @@
+Please do not submit any Pull Requests here. They will be closed.
+---
+
+Please submit your PR here instead:
+https://github.com/symfony/ux
+
+This repository is what we call a "subtree split": a read-only subset of that main repository.
+We're looking forward to your PR there!

src/Toolkit/.github/workflows/close-pull-request.yml

@@ -0,0 +1,20 @@
+name: Close Pull Request
+
+on:
+  pull_request_target:
+    types: [opened]
+
+jobs:
+  run:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: superbrothers/close-pull-request@v3
+        with:
+          comment: |
+            Thanks for your Pull Request! We love contributions.
+
+            However, you should instead open your PR on the main repository:
+            https://github.com/symfony/ux
+
+            This repository is what we call a "subtree split": a read-only subset of that main repository.
+            We're looking forward to your PR there!

src/Toolkit/.gitignore

@@ -0,0 +1,6 @@
+vendor
+composer.lock
+.phpunit.result.cache
+var
+tests/ui/output
+tests/ui/screens

src/Toolkit/.symfony.bundle.yaml

@@ -0,0 +1,3 @@
+branches: ["2.x"]
+maintained_branches: ["2.x"]
+doc_dir: "doc"

src/Toolkit/CHANGELOG.md

@@ -0,0 +1,5 @@
+# CHANGELOG
+
+## 2.23
+
+-   Component added

src/Toolkit/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2025-present Fabien Potencier
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished
+to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

src/Toolkit/README.md

@@ -0,0 +1,16 @@
+# Symfony UX Toolkit
+
+**EXPERIMENTAL** This component is currently experimental and is
+likely to change, or even change drastically.
+
+Symfony UX Toolkit provides a set of ready-to-use UI components for Symfony applications.
+
+**This repository is a READ-ONLY sub-tree split**. See
+https://github.com/symfony/ux to create issues or submit pull requests.
+
+## Resources
+
+-   [Documentation](https://symfony.com/bundles/ux-toolkit/current/index.html)
+-   [Report issues](https://github.com/symfony/ux/issues) and
+    [send Pull Requests](https://github.com/symfony/ux/pulls)
+    in the [main Symfony UX repository](https://github.com/symfony/ux)

src/Toolkit/bin/build-registry.php

@@ -0,0 +1,29 @@
+#!/usr/bin/env php
+<?php
+
+require_once __DIR__ . '/../vendor/autoload.php';
+
+use Symfony\Component\Filesystem\Filesystem;
+use Symfony\Component\Finder\Finder;
+use Symfony\UX\Toolkit\Registry\Registry;
+use Symfony\UX\Toolkit\Registry\RegistryItem;
+
+// --- Configuration
+$templateDir = __DIR__ . '/../templates';
+$registryDir = __DIR__ . '/../registry';
+// --- End of Configuration
+
+$registry = Registry::empty();
+$filesystem = new Filesystem();
+
+$finderTemplates = Finder::create()
+    ->files()
+    ->in($templateDir)
+    ->name('*.html.twig')
+    ->sortByName();
+
+foreach ($finderTemplates as $file) {
+    $registry->add(RegistryItem::fromFile($file));
+}
+
+$registry->save($registryDir, $filesystem);

src/Toolkit/composer.json

@@ -0,0 +1,69 @@
+{
+  "name": "symfony/ux-toolkit",
+  "type": "symfony-bundle",
+  "description": "Twig Toolkit for Symfony",
+  "keywords": [
+    "symfony-ux",
+    "twig",
+    "components"
+  ],
+  "homepage": "https://symfony.com",
+  "license": "MIT",
+  "authors": [
+    {
+      "name": "Symfony Community",
+      "homepage": "https://symfony.com/contributors"
+    },
+    {
+      "name": "Hugo Alliaume",
+      "email": "[email protected]"
+    },
+    {
+      "name": "Jean-François Lépine",
+      "email": "[email protected]"
+    },
+    {
+      "name": "Simon André",
+      "email": "[email protected]"
+    }
+  ],
+  "require": {
+    "php": ">=8.3",
+    "twig/extra-bundle": "^3.19|^4.0",
+    "twig/html-extra": "^3.19",
+    "twig/twig": "^2.12|^3.0",
+    "symfony/console": "^7.2",
+    "symfony/framework-bundle": "^6.4|^7.0",
+    "symfony/phpunit-bridge": "^6.4|^7.0",
+    "symfony/twig-bundle": "^6.4|^7.0",
+    "symfony/ux-twig-component": "^2.22",
+    "symfony/filesystem": "^7.2"
+  },
+  "require-dev": {
+    "symfony/finder": "6.4|^7.0",
+    "tales-from-a-dev/twig-tailwind-extra": "^0.3.0",
+    "zenstruck/console-test": "^1.7",
+    "symfony/http-client": "6.4|^7.0",
+    "symfony/stopwatch": "^7.2"
+  },
+  "autoload": {
+    "psr-4": {
+      "Symfony\\UX\\Toolkit\\": "src"
+    },
+    "exclude-from-classmap": []
+  },
+  "autoload-dev": {
+    "psr-4": {
+      "Symfony\\UX\\Toolkit\\Tests\\": "tests/"
+    }
+  },
+  "conflict": {
+    "symfony/ux-twig-component": "<2.21"
+  },
+  "extra": {
+    "thanks": {
+      "name": "symfony/ux",
+      "url": "https://github.com/symfony/ux"
+    }
+  }
+}

src/Toolkit/doc/index.rst

@@ -0,0 +1,28 @@
+Symfony UX Toolkit
+==================
+
+**EXPERIMENTAL** This component is currently experimental and is likely
+to change, or even change drastically.
+
+Symfony UX Toolkit provides a set of ready-to-use UI components for Symfony applications.
+It is part of `the Symfony UX initiative`_.
+
+Installation
+------------
+
+TODO
+
+Configuration
+-------------
+
+TODO
+
+Backward Compatibility promise
+------------------------------
+
+This bundle aims at following the same Backward Compatibility promise as
+the Symfony framework:
+https://symfony.com/doc/current/contributing/code/bc.html
+
+.. _`the Symfony UX initiative`: https://ux.symfony.com/
+#.. _`Twig Component`: https://symfony.com/bundles/ux-twig-component/current/index.html

src/Toolkit/phpunit.xml.dist

@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- https://phpunit.readthedocs.io/en/latest/configuration.html -->
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.5/phpunit.xsd" backupGlobals="false" colors="true" bootstrap="vendor/autoload.php" failOnRisky="true" failOnWarning="true" >
+  <php>
+    <ini name="display_errors" value="1"/>
+    <ini name="error_reporting" value="-1"/>
+    <server name="APP_ENV" value="test" force="true"/>
+    <server name="SHELL_VERBOSITY" value="-1"/>
+    <server name="SYMFONY_PHPUNIT_REMOVE" value=""/>
+    <server name="SYMFONY_PHPUNIT_VERSION" value="9.5"/>
+    <ini name="error_reporting" value="-1"/>
+    <server name="SYMFONY_DEPRECATIONS_HELPER" value="max[self]=0&amp;max[direct]=0"/>
+    <server name="KERNEL_CLASS" value="Symfony\UX\Toolkit\Tests\Fixtures\Kernel"/>
+    <ini name="error_reporting" value="-1" />
+    <server name="SYMFONY_DEPRECATIONS_HELPER" value="max[self]=0&amp;max[direct]=0"/>
+  </php>
+  <testsuites>
+    <testsuite name="UX Toolkit Test Suite">
+      <directory>tests</directory>
+    </testsuite>
+  </testsuites>
+  <listeners>
+    <listener class="Symfony\Bridge\PhpUnit\SymfonyTestsListener"/>
+  </listeners>
+</phpunit>

src/Toolkit/registry/default/components/Alert.json

@@ -0,0 +1,7 @@
+{
+    "name": "Alert",
+    "theme": "default",
+    "type": "component",
+    "code": "<div {{ attributes.without('class') }}\n    class=\"{{ (' ' ~ attributes.render('class'))|tailwind_merge }}\"\n>\n    <twig:Button>Dependency test</twig:Button>\n    {% block content %}Alert{% endblock %}\n</div>\n",
+    "dependencies": ["Button"]
+}

src/Toolkit/registry/default/components/Badge.json

@@ -0,0 +1,7 @@
+{
+    "name": "Badge",
+    "theme": "default",
+    "type": "component",
+    "code": "{%- props variant = 'default', outline = false -%}\n{%- set style = html_cva(\n    base: 'inline-flex items-center rounded-full border px-2.5 py-0.5 text-xs font-semibold transition-colors focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2',\n    variants: {\n        variant: {\n            default: \"border-transparent bg-primary text-primary-foreground hover:bg-primary/80\",\n            secondary: \"border-transparent bg-secondary text-secondary-foreground hover:bg-secondary/80\",\n            destructive: \"border-transparent bg-destructive text-destructive-foreground hover:bg-destructive/80\",\n        },\n        outline: {\n            true: \"text-foreground bg-white\",\n        }\n    },\n    compoundVariants: [{\n        variant: ['default'],\n        outline: ['true'],\n        class: 'border-primary',\n    }, {\n        variant: ['secondary'],\n        outline: ['true'],\n        class: 'border-secondary',\n    }, {\n        variant: ['destructive'],\n        outline: ['true'],\n        class: 'border-destructive',\n    },]\n) -%}\n\n<div\n    class=\"{{ style.apply({variant, outline}, attributes.render('class'))|tailwind_merge }}\"\n    {{ attributes.defaults({}).without('class') }}\n>\n    {% block content %}{% endblock %}\n</div>\n",
+    "dependencies": []
+}

src/Toolkit/registry/default/components/Button.json

@@ -0,0 +1,7 @@
+{
+    "name": "Button",
+    "theme": "default",
+    "type": "component",
+    "code": "<button {{ attributes.without('class') }}\n    class=\"{{ (' ' ~ attributes.render('class'))|tailwind_merge }}\"\n>\n    {% block content %}Button{% endblock %}\n</button>\n",
+    "dependencies": []
+}

src/Toolkit/registry/default/components/Card.json

@@ -0,0 +1,7 @@
+{
+    "name": "Card",
+    "theme": "default",
+    "type": "component",
+    "code": "<div {{ attributes.without('class') }}\n    class=\"{{ (' ' ~ attributes.render('class'))|tailwind_merge }}\"\n>\n    {% block content %}{% endblock %}\n</div>\n",
+    "dependencies": []
+}

src/Toolkit/registry/default/components/Navbar.json

@@ -0,0 +1,7 @@
+{
+    "name": "Navbar",
+    "theme": "default",
+    "type": "component",
+    "code": "<nav {{ attributes.without('class') }}\n    class=\"{{ (' ' ~ attributes.render('class'))|tailwind_merge }}\"\n>\n    {% block content %}{% endblock %}\n</nav>\n",
+    "dependencies": []
+}

src/Toolkit/registry/default/components/Table.json

@@ -0,0 +1,7 @@
+{
+    "name": "Table",
+    "theme": "default",
+    "type": "component",
+    "code": "{# ux:with{Row, Button} #}\n<table {{ attributes.without('class') }}\n    class=\"{{ (' ' ~ attributes.render('class'))|tailwind_merge }}\"\n>\n    {% block content %}{% endblock %}\n</table>\n",
+    "dependencies": ["Row"]
+}

src/Toolkit/registry/default/components/Table/Row.json

@@ -0,0 +1,7 @@
+{
+    "name": "Row",
+    "theme": "default",
+    "type": "component",
+    "code": "<tr {{ attributes.without('class') }}\n    class=\"{{ (' ' ~ attributes.render('class'))|tailwind_merge }}\"\n>\n    {% block content %}Row{% endblock %}\n</tr>\n",
+    "dependencies": []
+}

src/Toolkit/registry/default/examples/Badge.json

@@ -0,0 +1,7 @@
+{
+    "name": "Badge",
+    "theme": "default",
+    "type": "example",
+    "code": "<twig:Badge>Badge</twig:Badge>\n",
+    "dependencies": []
+}

src/Toolkit/registry/default/examples/BadgeOutline.json

@@ -0,0 +1,7 @@
+{
+    "name": "BadgeOutline",
+    "theme": "default",
+    "type": "example",
+    "code": "<twig:Badge outline>Badge</twig:Badge>\n<twig:Badge variant=\"primary\" outline>Badge</twig:Badge>\n<twig:Badge variant=\"secondary\" outline>Badge</twig:Badge>\n",
+    "dependencies": []
+}

src/Toolkit/registry/default/examples/Button.json

@@ -0,0 +1,7 @@
+{
+    "name": "Button",
+    "theme": "default",
+    "type": "example",
+    "code": "<twig:Button>Click me</twig:Button>\n",
+    "dependencies": []
+}

src/Toolkit/registry/default/registry.json

@@ -0,0 +1,25 @@
+{
+    "$schema": "https://ui.shadcn.com/schema/registry.json",
+    "name": "symfony",
+    "homepage": "https://symfony.com",
+    "items": [
+        {
+            "name": "badge",
+            "manifest": "components/Badge.json",
+            "type": "registry:component",
+            "title": "Badge",
+            "description": "A simple badge component",
+            "registryDependencies": [],
+            "files": []
+        },
+        {
+            "name": "button",
+            "manifest": "components/Button.json",
+            "type": "registry:component",
+            "title": "Button",
+            "description": "A Button component",
+            "registryDependencies": [],
+            "files": []
+        }
+    ]
+}