690991c526
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.
79 lines
2.3 KiB
PHP
79 lines
2.3 KiB
PHP
<?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);
|
|
}
|
|
}
|