feat(scopes): manage scope via form select and humanize labels

AzGasim · AzGasim · commit f8930a4f8c5e · 2026-04-07T16:47:23.000+02:00
diff --git a/packages/category/src/Moox/Entities/Categories/Category/CategoryResource.php b/packages/category/src/Moox/Entities/Categories/Category/CategoryResource.php
@@ -120,6 +120,7 @@ public static function form(Schema $schema): Schema
                                     ]),
                                 Section::make('')
                                     ->schema([
+                                        static::getScopeSelectField(),
                                         static::getTranslationStatusSelect(),
                                         static::getPublishDateField(),
                                         static::getUnpublishDateField(),
diff --git a/packages/core/src/Entities/Items/Draft/Pages/BaseEditDraft.php b/packages/core/src/Entities/Items/Draft/Pages/BaseEditDraft.php
@@ -4,6 +4,7 @@
 
 use Astrotomic\Translatable\Contracts\Translatable as TranslatableContract;
 use Filament\Actions\Action;
+use Filament\Forms\Components\Select;
 use Filament\Resources\Pages\EditRecord;
 use Illuminate\Database\Eloquent\Model;
 use Moox\Core\Traits\CanResolveResourceClass;
diff --git a/packages/core/src/Entities/Items/Draft/Pages/BaseViewDraft.php b/packages/core/src/Entities/Items/Draft/Pages/BaseViewDraft.php
@@ -3,6 +3,7 @@
 namespace Moox\Core\Entities\Items\Draft\Pages;
 
 use Filament\Actions\Action;
+use Filament\Forms\Components\Select;
 use Filament\Resources\Pages\ViewRecord;
 use Illuminate\Database\Eloquent\Model;
 use Moox\Core\Traits\CanResolveResourceClass;
diff --git a/packages/core/src/Support/Resources/Concerns/HasScopedChildResource.php b/packages/core/src/Support/Resources/Concerns/HasScopedChildResource.php
@@ -10,6 +10,7 @@
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Support\Facades\Auth;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Support\Str;
 use Moox\Core\Models\Scope;
 use Moox\Core\Services\ScopeAssignmentValidator;
 use Moox\Core\Services\ScopeRegistry;
@@ -20,6 +21,124 @@ trait HasScopedChildResource
 {
     public const ASSIGN_GLOBAL_SCOPE = '__global__';
 
+    public static function canAssignScopes(): bool
+    {
+        return static::hasMultipleAssignableScopes();
+    }
+
+    public static function formatScopeForDisplay(?string $scope): string
+    {
+        if ($scope === null || $scope === '') {
+            return 'Global';
+        }
+
+        $parsed = ScopeValue::parse($scope);
+        if ($parsed === null) {
+            return $scope;
+        }
+
+        $origin = static::humanizeScopeSegment($parsed->origin());
+        $source = static::humanizeScopeSegment($parsed->source());
+        $context = static::humanizeScopeSegment($parsed->context());
+        $boundary = static::humanizeScopeSegment($parsed->boundary());
+
+        return "{$origin} → {$source} → {$context} ({$boundary})";
+    }
+
+    protected static function humanizeScopeSegment(string $value): string
+    {
+        return Str::headline(Str::snake($value));
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    public static function getAssignableScopeOptionsForRecord(?Model $record = null): array
+    {
+        return static::getAssignableScopeOptions();
+    }
+
+    public static function getDefaultAssignableScopeForRecord(?Model $record = null): string
+    {
+        if ($record && is_string($record->scope) && $record->scope !== '') {
+            $options = static::getAssignableScopeOptions();
+            if (array_key_exists($record->scope, $options)) {
+                return $record->scope;
+            }
+        }
+
+        if ($record && ($record->scope === null || $record->scope === '')) {
+            return static::ASSIGN_GLOBAL_SCOPE;
+        }
+
+        return static::getDefaultAssignableScope();
+    }
+
+    /**
+     * @return array{updated: bool, message?: string}
+     */
+    public static function assignScopeToRecord(Model $record, string $selectedScope): array
+    {
+        if (! static::recordSupportsScopeColumn($record)) {
+            return ['updated' => false, 'message' => 'This record is not scopable.'];
+        }
+
+        $actor = Auth::user();
+        $validator = app(ScopeAssignmentValidator::class);
+
+        $targetScope = $selectedScope === static::ASSIGN_GLOBAL_SCOPE ? '' : $selectedScope;
+
+        $validation = $validator->validate($record, $targetScope, $actor);
+        if (! ($validation['allowed'] ?? false)) {
+            return ['updated' => false, 'message' => 'Target scope was inactive or boundary rules were not fulfilled.'];
+        }
+
+        if ($selectedScope === static::ASSIGN_GLOBAL_SCOPE) {
+            $record->setAttribute('scope', null);
+        } else {
+            $record->setAttribute('scope', ScopeValue::toStringOrNull($selectedScope));
+        }
+
+        $record->save();
+
+        return ['updated' => true];
+    }
+
+    public static function getScopeSelectField(string $name = 'scope'): Select
+    {
+        return Select::make($name)
+            ->label('Scope')
+            ->dehydrated(false)
+            ->live()
+            ->options(fn (?Model $record) => static::getAssignableScopeOptionsForRecord($record))
+            ->default(fn (?Model $record) => static::getDefaultAssignableScopeForRecord($record))
+            ->afterStateUpdated(function ($state, ?Model $record, Select $component): void {
+                if (! $record) {
+                    return;
+                }
+
+                $result = static::assignScopeToRecord($record, (string) $state);
+
+                if (! ($result['updated'] ?? false)) {
+                    Notification::make()
+                        ->warning()
+                        ->title('Scope not allowed')
+                        ->body($result['message'] ?? 'Unable to update scope.')
+                        ->send();
+
+                    $record->refresh();
+                    $component->state(static::getDefaultAssignableScopeForRecord($record));
+
+                    return;
+                }
+
+                Notification::make()
+                    ->success()
+                    ->title('Scope updated')
+                    ->send();
+            });
+    }
+
     public static function scopeQuery(Builder $query): Builder
     {
         return ScopedResourceContext::applyScope($query, static::class);
@@ -170,8 +289,19 @@ protected static function getAssignableScopeOptions(): array
             ->toArray();
 
         foreach ($rows as $scope => $row) {
-            $base = $row['label'] ?: $row['scope'];
-            $options[$scope] = "{$base} — {$row['source']}/{$row['context']} ({$row['boundary']})";
+            $parsed = ScopeValue::parse($scope);
+            if ($parsed === null) {
+                $options[$scope] = $scope;
+
+                continue;
+            }
+
+            $originLabel = static::humanizeScopeSegment($parsed->origin());
+            $sourceLabel = static::humanizeScopeSegment($parsed->source());
+            $contextLabel = static::humanizeScopeSegment($parsed->context());
+            $boundaryLabel = static::humanizeScopeSegment($parsed->boundary());
+
+            $options[$scope] = "{$originLabel} → {$sourceLabel} → {$contextLabel} ({$boundaryLabel})";
         }
 
         return $options;
diff --git a/packages/draft/config/draft.php b/packages/draft/config/draft.php
@@ -163,6 +163,9 @@
     'navigation_group' => 'DEV',
 
     'scope_registry' => [
+        'origins' => [
+            'draft' => \Moox\Draft\Models\Draft::class,
+        ],
         'sources' => [
             'draft' => \Moox\Draft\Models\Draft::class,
         ],
diff --git a/packages/draft/src/Moox/Entities/Drafts/Draft/DraftResource.php b/packages/draft/src/Moox/Entities/Drafts/Draft/DraftResource.php
@@ -18,6 +18,7 @@
 use Filament\Tables\Table;
 use Illuminate\Validation\Rules\Unique;
 use Moox\Core\Entities\Items\Draft\BaseDraftResource;
+use Moox\Core\Support\Resources\Concerns\HasScopedChildResource;
 use Moox\Core\Traits\Tabs\HasResourceTabs;
 use Moox\Core\Traits\Taxonomy\HasResourceTaxonomy;
 use Moox\Draft\Models\Draft;
@@ -33,6 +34,7 @@ class DraftResource extends BaseDraftResource
 {
     use HasResourceTabs;
     use HasResourceTaxonomy;
+    use HasScopedChildResource;
 
     protected static ?string $model = Draft::class;
 
@@ -120,6 +122,7 @@ public static function form(Schema $form): Schema
                             Section::make('')
                                 ->schema([
                                     static::getTypeSelect(),
+                                    static::getScopeSelectField(),
                                     static::getTranslationStatusSelect(),
                                     static::getPublishDateField(),
                                     static::getUnpublishDateField(),
diff --git a/packages/media/src/Resources/MediaResource.php b/packages/media/src/Resources/MediaResource.php
@@ -411,6 +411,9 @@ public static function form(Schema $schema): Schema
                                         $record->save();
                                     }
                                 }),
+
+                            static::getScopeSelectField()
+                                ->disabled(fn ($record) => $record?->getOriginal('write_protected')),
                         ]),
                 ])
                 ->columnSpanFull(),
diff --git a/packages/tag/src/Resources/TagResource.php b/packages/tag/src/Resources/TagResource.php
@@ -107,6 +107,7 @@ public static function form(Schema $schema): Schema
                                     ]),
                                 Section::make('')
                                     ->schema([
+                                        static::getScopeSelectField(),
                                         static::getTranslationStatusSelect(),
                                         static::getPublishDateField(),
                                         static::getUnpublishDateField(),
