Validácia, filtre a resources

use RoundlyConsulting\Tags\Rules\TagsRule;

public function rules(): array
{
    return [
        'category' => ['nullable', TagsRule::for('genre')],                          // single type: one value
        'labels' => ['array', TagsRule::for('label')->taggable($this->route('concert'))],
        'skills' => ['array', TagsRule::for('skill')->within($this->user()->team)->max(3)],
        'topic_ids' => ['array', TagsRule::for('topic')->byId()->taggable($this->route('article'))],
    ];
}

// Validated keys arrive as strings, and a string is a name to the tagging verbs:
// turn them into tags first, in the scopes the rule validated them in
$topics = Tags::for($article)->findMany($request->validated('topic_ids'), 'topic');   // a rule with taggable($article)
$article->syncTags($topics, 'topic');

$skills = Tags::type('skill')->within($team)->findMany($skillIds);                      // a rule with within($team)->byId()

// Names and slugs go straight through
$concert->syncTags($request->validated('labels'), 'label');

use RoundlyConsulting\QueryBuilder\AllowedFilter;
use RoundlyConsulting\QueryBuilder\QueryBuilder;
use RoundlyConsulting\Tags\Http\Filters\TagsFilter;

// GET /concerts?filter[category]=music&filter[labels]=live,outdoor
$concerts = QueryBuilder::for(Concert::class, $request)
    ->allowedFilters(
        AllowedFilter::custom('category', TagsFilter::any('genre')->withDescendants()),
        AllowedFilter::custom('labels', TagsFilter::all('label')),
        AllowedFilter::custom('without', TagsFilter::none('label')),
        AllowedFilter::custom('team_labels', TagsFilter::any('label')->within(fn () => $request->user()?->team)),
        AllowedFilter::custom('topic', TagsFilter::any('topic')->byId()),
    )
    ->paginate();

use Illuminate\Http\Request;
use Illuminate\Http\Resources\Json\JsonResource;
use RoundlyConsulting\Tags\Http\Resources\TagSummaryResource;

final class ConcertResource extends JsonResource
{
    public function toArray(Request $request): array
    {
        $genre = $this->resource->tagOf('genre');

        return [
            'id' => $this->resource->getKey(),
            'title' => $this->resource->title,
            'genre' => $genre === null ? null : new TagSummaryResource($genre),
            'labels' => TagSummaryResource::collection($this->resource->tagsOf('label')),
        ];
    }
}

// The controller: tags in one query, category ancestors in one more
$concerts = Concert::with('tags')->paginate(20);
Tags::loadAncestors($concerts->getCollection()->map(fn (Concert $concert) => $concert->tagOf('genre')));

return ConcertResource::collection($concerts);

{
  "id": 7,
  "title": "Night at the club",
  "genre": {
    "id": 2,
    "type": "genre",
    "name": "Jazz",
    "slug": "jazz",
    "color": null,
    "icon": "sax",
    "depth": 2,
    "ancestors": [
      { "id": 1, "type": "genre", "name": "Music", "slug": "music", "color": "#f24e29", "icon": null, "depth": 1 }
    ]
  },
  "labels": [
    { "id": 9, "type": "label", "name": "Live", "slug": "live", "color": null, "icon": null, "depth": 1 }
  ]
}