refactor: Cleanup git state - commit all staged changes

Major refactoring cleanup:
- Add new controller architecture (class-controller-*.php)
- Add new settings-v2 UI (views/settings-v2/)
- Add new CSS architecture (agentic-sidebar.css, tokens)
- Add esbuild build pipeline (scripts/build.js, package.json)
- Add composer dependencies (vendor/)
- Add frontend src directory (assets/js/src/index.jsx)
- Add documentation files
- Remove old/obsolete files (class-settings.php, old CSS)

This commits all pending changes from previous refactoring efforts.

vendor/phpdocumentor/guides-restructured-text/src/RestructuredText/Directives/RoleDirective.php

@@ -0,0 +1,78 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * This file is part of phpDocumentor.
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ *
+ * @link https://phpdoc.org
+ */
+
+namespace phpDocumentor\Guides\RestructuredText\Directives;
+
+use phpDocumentor\Guides\RestructuredText\Parser\BlockContext;
+use phpDocumentor\Guides\RestructuredText\Parser\Directive;
+use phpDocumentor\Guides\RestructuredText\TextRoles\BaseTextRole;
+use phpDocumentor\Guides\RestructuredText\TextRoles\GenericTextRole;
+use Psr\Log\LoggerInterface;
+
+use function is_string;
+use function preg_match;
+use function sprintf;
+use function trim;
+
+/**
+ * The "role" directive dynamically creates a custom interpreted text role and registers it with the parser.
+ *
+ * https://docutils.sourceforge.io/docs/ref/rst/directives.html#role
+ */
+final class RoleDirective extends ActionDirective
+{
+    public function __construct(
+        private readonly LoggerInterface $logger,
+    ) {
+    }
+
+    public function getName(): string
+    {
+        return 'role';
+    }
+
+    public function processAction(
+        BlockContext $blockContext,
+        Directive $directive,
+    ): void {
+        $name = $directive->getData();
+        $role = 'span';
+        if (preg_match('/^([A-Za-z-]*)\(([A-Za-z-]*)\)$/', trim($name), $match) === 1) {
+            $name = $match[1];
+            $role = $match[2];
+        }
+
+        $baseRole = $blockContext->getDocumentParserContext()->getTextRoleFactoryForDocument()->getTextRole($role);
+        if (!$baseRole instanceof BaseTextRole) {
+            $this->logger->error(
+                sprintf('Text role "%s", class %s cannot be extended. ', $role, $baseRole::class),
+                $blockContext->getLoggerInformation(),
+            );
+
+            return;
+        }
+
+        $customRole = $baseRole->withName($name);
+        if (is_string($directive->getOption('class')->getValue())) {
+            $customRole->setClass($directive->getOption('class')->getValue());
+        } else {
+            $customRole->setClass($name);
+        }
+
+        if ($customRole instanceof GenericTextRole) {
+            $customRole->setBaseRole($role);
+        }
+
+        $blockContext->getDocumentParserContext()->getTextRoleFactoryForDocument()->replaceTextRole($customRole);
+    }
+}