Hyde\Framework\Factories\NavigationDataFactory

Complexity

Total Complexity

41

Size/Duplication

Total Lines	223
Duplicated Lines	0 %

Importance

Changes	5
Bugs	0	Features	0

26 Methods

Rating	Name	Duplication	Size	Complexity
A	toArray()	0	7	1
A	searchForLabelInConfig()	0	9	1
A	isInstanceOf()	0	3	1
A	searchForGroupInFrontMatter()	0	4	1
A	searchForPriorityInFrontMatter()	0	4	1
A	__construct()	0	12	1
A	isPageHiddenInNavigationConfiguration()	0	3	1
A	parseNavigationPriorityConfig()	0	19	3
A	makeLabel()	0	6	1
A	searchForPriorityInNavigationConfig()	0	10	1
A	searchForLabelInFrontMatter()	0	4	1
A	getMatter()	0	3	1
A	searchForPriorityInSidebarConfig()	0	6	1
A	getSubdirectoryName()	0	3	1
A	pageIsInSubdirectory()	0	3	1
A	makeGroup()	0	7	3
A	canUseSubdirectoryForGroups()	0	4	2
A	invert()	0	3	2
A	makeHidden()	0	6	4
A	makePriority()	0	5	1
A	searchForHiddenInFrontMatter()	0	4	1
A	defaultGroup()	0	3	2
A	searchForPriorityInConfigs()	0	5	2
A	getSubdirectoryConfiguration()	0	3	1
A	isNonDocumentationPageInHiddenSubdirectory()	0	6	4
A	offset()	0	3	2

<?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\Markdown\Contracts\FrontMatter\SubSchemas\NavigationSchema;

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 const FALLBACK_PRIORITY = 999;
    protected const CONFIG_OFFSET = 500;

    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;

The property matter is declared read-only in Hyde\Framework\Factories\NavigationDataFactory.

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

The property identifier is declared read-only in Hyde\Framework\Factories\NavigationDataFactory.

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

The property pageClass is declared read-only in Hyde\Framework\Factories\NavigationDataFactory.

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

The property routeKey is declared read-only in Hyde\Framework\Factories\NavigationDataFactory.

        $this->title = $title;

The property title is declared read-only in Hyde\Framework\Factories\NavigationDataFactory.

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

The property label is declared read-only in Hyde\Framework\Factories\NavigationDataFactory.

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

The property group is declared read-only in Hyde\Framework\Factories\NavigationDataFactory.

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

The property hidden is declared read-only in Hyde\Framework\Factories\NavigationDataFactory.

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

The property priority is declared read-only in Hyde\Framework\Factories\NavigationDataFactory.

    }

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

The expression return array('label' => $this->label, 'group' => $this->group, 'hidden' => $this->hidden, 'priority' => $this->priority) returns an array which contains values of type boolean|integer|string which are incompatible with the return type Illuminate\Contracts\Support\TValue mandated by Illuminate\Contracts\Support\Arrayable::toArray().

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

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

The expression return $this->searchForLabelInFrontMatter() ?? $this->searchForLabelInConfig() ?? $this->getMatter('title') ?? $this->title could return the type boolean which is incompatible with the type-hinted return null|string. Consider adding an additional type-check to rule them out.

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

    protected function makeGroup(): ?string
    {
        if ($this->pageIsInSubdirectory() && $this->canUseSubdirectoryForGroups()) {
            return $this->getSubdirectoryName();
        }

        return $this->searchForGroupInFrontMatter() ?? $this->defaultGroup();
    }

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

    protected function makePriority(): int
    {
        return $this->searchForPriorityInFrontMatter()
            ?? $this->searchForPriorityInConfigs()
            ?? self::FALLBACK_PRIORITY;
    }

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

The expression return $this->getMatter('navigation.label') ?? $this->getMatter('navigation.title') could return the type boolean which is incompatible with the type-hinted return null|string. Consider adding an additional type-check to rule them out.

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

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

The expression return $this->getMatter('navigation.group') ?? $this->getMatter('navigation.category') could return the type boolean which is incompatible with the type-hinted return null|string. Consider adding an additional type-check to rule them out.

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

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

The expression return $this->getMatter('navigation.hidden') ?? $this->invert($this->getMatter('navigation.visible')) could return the type integer|string which is incompatible with the type-hinted return boolean|null. Consider adding an additional type-check to rule them out.

            ?? $this->invert($this->getMatter('navigation.visible'));

It seems like $this->getMatter('navigation.visible') can also be of type integer and string; however, parameter $value of Hyde\Framework\Factories\NavigationDataFactory::invert() does only seem to accept boolean|null, maybe add an additional type check?

    }

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

    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')

The expression return $this->getMatter('navigation.priority') ?? $this->getMatter('navigation.order') could return the type boolean|string which is incompatible with the type-hinted return integer|null. Consider adding an additional type-check to rule them out.

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

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

        return $config[$this->routeKey] ?? 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 $this->parseNavigationPriorityConfig($config);
    }

    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);
    }

    /** @param array<string, int>|array<string> $config */
    private function parseNavigationPriorityConfig(array $config): ?int
    {
        $pageKey = $this->isInstanceOf(DocumentationPage::class)
            ? $this->identifier // Required for backwards compatibility.
            : $this->routeKey;

        // 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,
                self::CONFIG_OFFSET
            );
        }

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

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

    private function defaultGroup(): ?string
    {
        return $this->isInstanceOf(DocumentationPage::class) ? 'other' : null;
    }

    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.subdirectories', 'hidden');
    }

    /** @param class-string $class */

The doc comment class-string at position 0 could not be parsed: Unknown type name 'class-string' at position 0 in class-string.

    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
    {
        return $this->matter->get($key);
    }
}