Hyde\Console\Helpers\ViewPublishGroup

Complexity

Total Complexity

8

Size/Duplication

Total Lines	68
Duplicated Lines	0 %

Importance

Changes	10
Bugs	0	Features	0

6 Methods

Rating	Name	Duplication	Size	Complexity
A	findFiles()	0	7	2
A	normalizePath()	0	4	2
A	__construct()	0	9	1
A	keyedArrayToTuple()	0	3	1
A	publishableFilesMap()	0	5	1
A	fromGroup()	0	8	1

<?php

declare(strict_types=1);

namespace Hyde\Console\Helpers;

use Hyde\Facades\Filesystem;
use Hyde\Foundation\Providers\ViewServiceProvider;
use Hyde\Hyde;
use Illuminate\Support\Str;

use function Hyde\path_join;
use function Hyde\unslash;

/**
 * @internal Helper object for publishable view groups.
 */
class ViewPublishGroup
{
    public readonly string $group;

    public readonly string $name;
    public readonly string $description;

    public readonly string $source;
    public readonly string $target;

    /** @var array<string> The filenames relative to the source directory. */
    public readonly array $files;

    /** @var class-string<\Hyde\Foundation\Providers\ViewServiceProvider> */

The doc comment class-string<\Hyde\Foundation\Providers\ViewServiceProvider> at position 0 could not be parsed: Unknown type name 'class-string' at position 0 in class-string<\Hyde\Foundation\Providers\ViewServiceProvider>.

    protected static string $provider = ViewServiceProvider::class;

    protected function __construct(string $group, string $source, string $target, array $files, ?string $name = null, ?string $description = null)
    {
        $this->group = $group;

The property group is declared read-only in Hyde\Console\Helpers\ViewPublishGroup.

        $this->source = $source;

The property source is declared read-only in Hyde\Console\Helpers\ViewPublishGroup.

        $this->target = $target;

The property target is declared read-only in Hyde\Console\Helpers\ViewPublishGroup.

        $this->files = $files;

The property files is declared read-only in Hyde\Console\Helpers\ViewPublishGroup.

        $this->name = $name ?? Hyde::makeTitle($group);

The property name is declared read-only in Hyde\Console\Helpers\ViewPublishGroup.

The method makeTitle() does not exist on Hyde\Hyde. Since you implemented __callStatic, consider adding a @method annotation.

        $this->description = $description ?? "Publish the '$group' files for customization.";

The property description is declared read-only in Hyde\Console\Helpers\ViewPublishGroup.

    }

    public static function fromGroup(string $group, ?string $name = null, ?string $description = null): static
    {
        [$source, $target] = static::keyedArrayToTuple(static::$provider::pathsToPublish(static::$provider, $group));
        [$source, $target] = [static::normalizePath($source), static::normalizePath($target)];

        $files = static::findFiles($source);

        return new static($group, $source, $target, $files, $name, $description);
    }

    /** @return array<string, string> The source file paths mapped to their target file paths. */
    public function publishableFilesMap(): array
    {
        return collect($this->files)->mapWithKeys(fn (string $file): array => [

$this->files of type array is incompatible with the type Illuminate\Contracts\Support\Arrayable expected by parameter $value of collect().

            path_join($this->source, $file) => path_join($this->target, $file),
        ])->all();
    }

    /**
     * @param  array<string, string>  $array
     * @return list<string>

The type Hyde\Console\Helpers\list was not found. Maybe you did not declare it correctly or list all dependencies?

     */
    protected static function keyedArrayToTuple(array $array): array
    {
        return [key($array), current($array)];
    }

    /** @return array<string> */
    protected static function findFiles(string $source): array
    {
        return Filesystem::findFiles($source, recursive: true)
            ->map(fn (string $file) => static::normalizePath($file))
            ->map(fn (string $file) => unslash(Str::after($file, $source)))
            ->sort(fn (string $a, string $b): int => substr_count($a, '/') <=> substr_count($b, '/') ?: strcmp($a, $b))
            ->all();
    }

    protected static function normalizePath(string $path): string
    {
        return Hyde::pathToRelative(

The method pathToRelative() does not exist on Hyde\Hyde. Since you implemented __callStatic, consider adding a @method annotation.

            Filesystem::exists($path) ? realpath($path) : $path
        );
    }
}