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.
105 lines
3.4 KiB
PHP
105 lines
3.4 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\Nodes\CollectionNode;
|
|
use phpDocumentor\Guides\Nodes\Node;
|
|
use phpDocumentor\Guides\ReferenceResolvers\AnchorNormalizer;
|
|
use phpDocumentor\Guides\RestructuredText\Nodes\ConfvalNode;
|
|
use phpDocumentor\Guides\RestructuredText\Parser\BlockContext;
|
|
use phpDocumentor\Guides\RestructuredText\Parser\Directive;
|
|
use phpDocumentor\Guides\RestructuredText\Parser\InlineParser;
|
|
use phpDocumentor\Guides\RestructuredText\Parser\Productions\Rule;
|
|
use phpDocumentor\Guides\RestructuredText\TextRoles\GenericLinkProvider;
|
|
use Psr\Log\LoggerInterface;
|
|
|
|
use function in_array;
|
|
use function trim;
|
|
|
|
/**
|
|
* The confval directive configuration values.
|
|
*
|
|
* https://sphinx-toolbox.readthedocs.io/en/stable/extensions/confval.html
|
|
*/
|
|
final class ConfvalDirective extends SubDirective
|
|
{
|
|
public const NAME = 'confval';
|
|
|
|
/** @param Rule<CollectionNode> $startingRule */
|
|
public function __construct(
|
|
protected Rule $startingRule,
|
|
GenericLinkProvider $genericLinkProvider,
|
|
private readonly AnchorNormalizer $anchorReducer,
|
|
private readonly InlineParser $inlineParser,
|
|
private readonly LoggerInterface|null $logger = null,
|
|
) {
|
|
parent::__construct($startingRule);
|
|
|
|
$genericLinkProvider->addGenericLink(self::NAME, ConfvalNode::LINK_TYPE, ConfvalNode::LINK_PREFIX);
|
|
}
|
|
|
|
public function getName(): string
|
|
{
|
|
return self::NAME;
|
|
}
|
|
|
|
/** {@inheritDoc}
|
|
*
|
|
* @param Directive $directive
|
|
*/
|
|
protected function processSub(
|
|
BlockContext $blockContext,
|
|
CollectionNode $collectionNode,
|
|
Directive $directive,
|
|
): Node|null {
|
|
$id = $directive->getData();
|
|
if ($directive->hasOption('name')) {
|
|
$id = (string) $directive->getOption('name')->getValue();
|
|
}
|
|
|
|
$id = $this->anchorReducer->reduceAnchor($id);
|
|
$type = null;
|
|
$required = false;
|
|
$default = null;
|
|
$additionalOptions = [];
|
|
if (trim($directive->getData()) === '') {
|
|
if ($this->logger !== null) {
|
|
$this->logger->warning('A directive must have a title: .. confval:: [some_title]', $blockContext->getLoggerInformation());
|
|
}
|
|
}
|
|
|
|
if ($directive->hasOption('type')) {
|
|
$type = $this->inlineParser->parse($directive->getOptionString('type'), $blockContext);
|
|
}
|
|
|
|
$required = $directive->getOptionBool('required');
|
|
|
|
if ($directive->hasOption('default')) {
|
|
$default = $this->inlineParser->parse($directive->getOptionString('default'), $blockContext);
|
|
}
|
|
|
|
$noindex = $directive->getOptionBool('noindex');
|
|
|
|
foreach ($directive->getOptions() as $option) {
|
|
if (in_array($option->getName(), ['type', 'required', 'default', 'noindex', 'name'], true)) {
|
|
continue;
|
|
}
|
|
|
|
$additionalOptions[$option->getName()] = $this->inlineParser->parse($option->toString(), $blockContext);
|
|
}
|
|
|
|
return new ConfvalNode($id, $directive->getData(), $type, $required, $default, $additionalOptions, $collectionNode->getChildren(), $noindex);
|
|
}
|
|
}
|