NavigationDataFactory::getSubdirectoryName() - Code Metrics - Inspection of "Merge pull request #1565 from hydephp/2.x-dev" - hydephp/develop - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Push — master ( ad6b2a...b41ca0 )

by Caen
created 2025-05-18 15:00 UTC
NavigationDataFactory::getSubdirectoryName() A

↳ Parent: NavigationDataFactory
Complexity

Conditions	1
Paths	1
Size

Total Lines	3
Code Lines	1
Duplication

Lines	0
Ratio	0 %
Importance

Changes
Metric	Value
cc	1
eloc	1
nc	1
nop	0
dl	0
loc	3
rs	10
c	0
b	0
f	0
<?php

declare(strict_types=1);

namespace Hyde\Framework\Factories;

use Hyde\Facades\Config;
use Illuminate\Support\Str;
use Hyde\Pages\MarkdownPost;
use Hyde\Pages\DocumentationPage;
use Hyde\Markdown\Models\FrontMatter;
use Hyde\Framework\Factories\Concerns\CoreDataObject;
use Hyde\Framework\Features\Navigation\NavigationMenu;
use Hyde\Markdown\Contracts\FrontMatter\SubSchemas\NavigationSchema;
use Hyde\Framework\Features\Navigation\NumericalPageOrderingHelper;

use function basename;
use function array_flip;
use function in_array;
use function is_a;
use function array_key_exists;

/**
 * Discover data used for navigation menus and the documentation sidebar.
 */
class NavigationDataFactory extends Concerns\PageDataFactory implements NavigationSchema
{
    /**
     * The front matter properties supported by this factory.
     *
     * Note that this represents a sub-schema, and is used as part of the page schema.
     */
    final public const SCHEMA = NavigationSchema::NAVIGATION_SCHEMA;

    protected readonly ?string $label;
    protected readonly ?string $group;
    protected readonly ?bool $hidden;
    protected readonly ?int $priority;
    private readonly string $title;
    private readonly string $routeKey;
    private readonly string $pageClass;
    private readonly string $identifier;
    private readonly FrontMatter $matter;

    public function __construct(CoreDataObject $pageData, string $title)
    {
        $this->matter = $pageData->matter;

        $this->identifier = $pageData->identifier;

        $this->pageClass = $pageData->pageClass;

        $this->routeKey = $pageData->routeKey;

        $this->title = $title;


        $this->label = $this->makeLabel();

        $this->group = $this->makeGroup();

        $this->hidden = $this->makeHidden();

        $this->priority = $this->makePriority();

    }

    /**
     * @return array{label: string|null, group: string|null, hidden: bool|null, priority: int|null}
     */
    public function toArray(): array
    {
        return [

            'label' => $this->label,
            'group' => $this->group,
            'hidden' => $this->hidden,
            'priority' => $this->priority,
        ];
    }

    protected function makeLabel(): ?string
    {
        return $this->searchForLabelInFrontMatter()

            ?? $this->searchForLabelInConfigs()
            ?? $this->getMatter('title')
            ?? $this->title;
    }

    protected function makeGroup(): ?string
    {
        if ($this->pageIsInSubdirectory() && $this->canUseSubdirectoryForGroups()) {
            return NumericalPageOrderingHelper::hasNumericalPrefix($this->getSubdirectoryName())
                ? NumericalPageOrderingHelper::splitNumericPrefix($this->getSubdirectoryName())[1]
                : $this->getSubdirectoryName();
        }

        return $this->searchForGroupInFrontMatter();
    }

    protected function makeHidden(): bool
    {
        return $this->isInstanceOf(MarkdownPost::class)
            || $this->searchForHiddenInFrontMatter()
            || $this->searchForHiddenInConfigs()
            || $this->isNonDocumentationPageInHiddenSubdirectory();
    }

    protected function makePriority(): int
    {
        return $this->searchForPriorityInFrontMatter()
            ?? $this->searchForPriorityInConfigs()
            ?? $this->checkFilePrefixForOrder()
            ?? NavigationMenu::LAST;
    }

    private function searchForLabelInFrontMatter(): ?string
    {
        return $this->getMatter('navigation.label')

            ?? $this->getMatter('navigation.title');
    }

    private function searchForGroupInFrontMatter(): ?string
    {
        return $this->getMatter('navigation.group')

            ?? $this->getMatter('navigation.category');
    }

    private function searchForHiddenInFrontMatter(): ?bool
    {
        return $this->getMatter('navigation.hidden')

            ?? $this->invert($this->getMatter('navigation.visible'));
            ?? $this->invert(/** @scrutinizer ignore-type */ $this->getMatter('navigation.visible'));
    }

    private function searchForHiddenInConfigs(): ?bool
    {
        return $this->isInstanceOf(DocumentationPage::class)
            ? $this->isPageHiddenInSidebarConfiguration()
            : $this->isPageHiddenInNavigationConfiguration();
    }

    private function isPageHiddenInNavigationConfiguration(): bool
    {
        return in_array($this->routeKey, Config::getArray('hyde.navigation.exclude', ['404']));
    }

    private function isPageHiddenInSidebarConfiguration(): ?bool
    {
        $config = Config::getArray('docs.sidebar.exclude', ['404']);

        return
            // Check if the page is hidden from the sidebar by route key or identifier.
            (in_array($this->routeKey, $config) || in_array($this->identifier, $config))
            // Check if the page is hidden from the main navigation by its route key.
            || $this->isPageHiddenInNavigationConfiguration();
    }

    private function isNonDocumentationPageInHiddenSubdirectory(): bool
    {
        return ! $this->isInstanceOf(DocumentationPage::class)
            && $this->pageIsInSubdirectory()
            && $this->getSubdirectoryConfiguration() === 'hidden'
            && basename($this->identifier) !== 'index';
    }

    private function searchForPriorityInFrontMatter(): ?int
    {
        return $this->getMatter('navigation.priority')

            ?? $this->getMatter('navigation.order');
    }

    private function searchForLabelInConfigs(): ?string
    {
        return $this->isInstanceOf(DocumentationPage::class)
            ? $this->searchForLabelInSidebarConfig()
            : $this->searchForLabelInNavigationConfig();
    }

    private function searchForLabelInNavigationConfig(): ?string
    {
        /** @var array<string, string> $config */
        $config = Config::getArray('hyde.navigation.labels', [
            'index' => 'Home',
            DocumentationPage::homeRouteName() => 'Docs',
        ]);

        return $config[$this->routeKey] ?? null;
    }

    private function searchForLabelInSidebarConfig(): ?string
    {
        /** @var array<string>|array<string, string> $config */
        $config = Config::getArray('docs.sidebar.labels', [
            DocumentationPage::homeRouteName() => 'Docs',
        ]);

        return $config[$this->routeKey] ?? $config[$this->identifier] ?? null;
    }

    private function searchForPriorityInConfigs(): ?int
    {
        return $this->isInstanceOf(DocumentationPage::class)
            ? $this->searchForPriorityInSidebarConfig()
            : $this->searchForPriorityInNavigationConfig();
    }

    private function searchForPriorityInSidebarConfig(): ?int
    {
        /** @var array<string>|array<string, int> $config */
        $config = Config::getArray('docs.sidebar.order', []);

        return
            // For consistency with the navigation config.
            $this->parseNavigationPriorityConfig($config, 'routeKey')
            // For backwards compatibility, and ease of use, as the route key prefix
            // is redundant due to it being the same for all documentation pages
            ?? $this->parseNavigationPriorityConfig($config, 'identifier');
    }

    private function searchForPriorityInNavigationConfig(): ?int
    {
        /** @var array<string, int>|array<string> $config */
        $config = Config::getArray('hyde.navigation.order', [
            'index' => 0,
            'posts' => 10,
            'docs/index' => 100,
        ]);

        return $this->parseNavigationPriorityConfig($config, 'routeKey');
    }

    /**
     * @param  array<string, int>|array<string>  $config
     * @param  'routeKey'|'identifier'  $pageKeyName

     */
    private function parseNavigationPriorityConfig(array $config, string $pageKeyName): ?int
    {
        /** @var string $pageKey */
        $pageKey = $this->{$pageKeyName};

        // Check if the config entry is a flat array or a keyed array.
        if (! array_key_exists($pageKey, $config)) {
            // Adding an offset makes so that pages with a front matter priority, or
            // explicit keyed priority selection that is lower can be shown first.
            // This is all to make it easier to mix ways of adding priorities.

            return $this->offset(
                array_flip($config)[$pageKey] ?? null,
                NavigationMenu::DEFAULT
            );
        }

        return $config[$pageKey] ?? null;
    }

    private function checkFilePrefixForOrder(): ?int
    {
        if (! $this->isInstanceOf(DocumentationPage::class)) {
            return null;
        }

        if (! NumericalPageOrderingHelper::hasNumericalPrefix($this->identifier)) {
            return null;
        }

        return NumericalPageOrderingHelper::splitNumericPrefix($this->identifier)[0];
    }

    private function canUseSubdirectoryForGroups(): bool
    {
        return $this->getSubdirectoryConfiguration() === 'dropdown'
            || $this->isInstanceOf(DocumentationPage::class);
    }

    private function pageIsInSubdirectory(): bool
    {
        return Str::contains($this->identifier, '/');
    }

    private function getSubdirectoryName(): string
    {
        return Str::before($this->identifier, '/');
    }

    protected function getSubdirectoryConfiguration(): string
    {
        return Config::getString('hyde.navigation.subdirectory_display', 'hidden');
    }

    /** @param class-string<\Hyde\Pages\Concerns\HydePage> $class */

    protected function isInstanceOf(string $class): bool
    {
        return is_a($this->pageClass, $class, true);
    }

    protected function invert(?bool $value): ?bool
    {
        return $value === null ? null : ! $value;
    }

    protected function offset(?int $value, int $offset): ?int
    {
        return $value === null ? null : $value + $offset;
    }

    protected function getMatter(string $key): string|null|int|bool
    {
        /** @var string|null|int|bool $value */
        $value = $this->matter->get($key);

        return $value;
    }
}

hydephp / develop

Push — master ( ad6b2a...b41ca0 )

NavigationDataFactory::getSubdirectoryName() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like
