Core Base, Item wip

Author: adrolli

packages/audit/src/Resources/AuditResource.php

@@ -17,14 +17,14 @@
 use Moox\Audit\Resources\AuditResource\Pages\ListAudits;
 use Moox\Audit\Resources\AuditResource\Pages\ViewAudit;
 use Moox\Core\Traits\Base\BaseInResource;
-use Moox\Core\Traits\Tabs\TabsInResource;
+use Moox\Core\Traits\Tabs\HasResourceTabs;
 use Override;
 use Spatie\Activitylog\Models\Activity;
 
 class AuditResource extends Resource
 {
     use BaseInResource;
-    use TabsInResource;
+    use HasResourceTabs;
 
     protected static ?string $model = Activity::class;
 

packages/audit/src/Resources/AuditResource/Pages/ListAudits.php

@@ -4,12 +4,12 @@
 
 use Filament\Resources\Pages\ListRecords;
 use Moox\Audit\Resources\AuditResource;
-use Moox\Core\Traits\Tabs\TabsInListPage;
+use Moox\Core\Traits\Tabs\HasListPageTabs;
 use Spatie\Activitylog\Models\Activity;
 
 class ListAudits extends ListRecords
 {
-    use TabsInListPage;
+    use HasListPageTabs;
 
     protected static string $resource = AuditResource::class;
 

packages/category/src/Resources/CategoryResource.php

@@ -34,15 +34,15 @@
 use Moox\Category\Resources\CategoryResource\Pages\ListCategories;
 use Moox\Category\Resources\CategoryResource\Pages\ViewCategory;
 use Moox\Core\Traits\Base\BaseInResource;
-use Moox\Core\Traits\Tabs\TabsInResource;
+use Moox\Core\Traits\Tabs\HasResourceTabs;
 use Override;
 
 // use Moox\Core\Forms\Components\TitleWithSlugInput;
 
 class CategoryResource extends Resource
 {
     use BaseInResource;
-    use TabsInResource;
+    use HasResourceTabs;
 
     protected static ?string $model = Category::class;
 

packages/category/src/Resources/CategoryResource/Pages/ListCategories.php

@@ -10,12 +10,12 @@
 use Filament\Resources\Pages\ListRecords;
 use Moox\Category\Models\Category;
 use Moox\Category\Resources\CategoryResource;
-use Moox\Core\Traits\Tabs\TabsInListPage;
+use Moox\Core\Traits\Tabs\HasListPageTabs;
 use Override;
 
 class ListCategories extends ListRecords
 {
-    use TabsInListPage;
+    use HasListPageTabs;
 
     public static string $resource = CategoryResource::class;
 

packages/core/README.md

@@ -47,7 +47,7 @@ Moox Core requires these packages:
 
 ## Traits
 
-### TabsInListPage
+### HasListPageTabs
 
 This trait provides functionality for creating dynamic tabs in Filament resources.
 
@@ -60,11 +60,11 @@ This trait provides functionality for creating dynamic tabs in Filament resource
 The DynamicTabs trait is already implemented in all Moox packages including Moox Builder. If you want to implement this feature in your existing package:
 
 ```php
-use Moox\Core\Traits\Tabs\TabsInListPage;
+use Moox\Core\Traits\Tabs\HasListPageTabs;
 
 class ListItems extends ListRecords
 {
-    use TabsInListPage;
+    use HasListPageTabs;
 
     public function getTabs(): array
     {
@@ -345,7 +345,7 @@ And finally the most-known mistake, throws "Cannot access offset of type string
 
 So don't forget to put the query in an extra array, even if it is a single query.
 
-As mentioned, the QueriesInConfig trait is used in TabsInListPage, another Trait in Moox Core. Please code dive there, to see how to implement the Feature from outside Moox.
+As mentioned, the QueriesInConfig trait is used in HasListPageTabs, another Trait in Moox Core. Please code dive there, to see how to implement the Feature from outside Moox.
 
 ### TranslatableConfig
 
@@ -447,7 +447,7 @@ As [Google Material Design Icons](https://blade-ui-kit.com/blade-icons?set=20) p
 
 You can disable Google Icons and use the Filament default icons instead, see [config](#Config).
 
-### TaxonomyInModel
+### HasModelTaxonomy
 
 This trait provides functionality for models to work with dynamic taxonomies.
 
@@ -459,11 +459,11 @@ This trait provides functionality for models to work with dynamic taxonomies.
 #### Usage
 
 ```php
-use Moox\Core\Traits\Taxonomy\TaxonomyInModel;
+use Moox\Core\Traits\Taxonomy\HasModelTaxonomy;
 
 class YourItem extends Model
 {
-    use TaxonomyInModel;
+    use HasModelTaxonomy;
 
     protected function getResourceName(): string
     {
@@ -499,7 +499,7 @@ class YourItem extends Model
 > We do not soft-delete the polymorphics, so if you restore a Taxonomy, these are lost.
 ```
 
-### TaxonomyInResource
+### HasResourceTaxonomy
 
 This trait provides methods for generating Filament form fields, table columns, and filters for dynamic taxonomies.
 
@@ -513,11 +513,11 @@ This trait provides methods for generating Filament form fields, table columns,
 #### Usage
 
 ```php
-use Moox\Core\Traits\Taxonomy\TaxonomyInResource;
+use Moox\Core\Traits\Taxonomy\HasResourceTaxonomy;
 
 class YourResource extends Resource
 {
-    use TaxonomyInResource;
+    use HasResourceTaxonomy;
 
     public static function form(Form $form): Form
     {
@@ -542,7 +542,7 @@ class YourResource extends Resource
 }
 ```
 
-### TaxonomyInPages
+### HasPagesTaxonomy
 
 This trait provides methods for handling dynamic taxonomies in Filament resource pages.
 
@@ -555,11 +555,11 @@ This trait provides methods for handling dynamic taxonomies in Filament resource
 #### Usage
 
 ```php
-use Moox\Core\Traits\Taxonomy\TaxonomyInPages;
+use Moox\Core\Traits\Taxonomy\HasPagesTaxonomy;
 
 class EditYourModel extends EditRecord
 {
-    use TaxonomyInPages;
+    use HasPagesTaxonomy;
 
     // ... other page code ...
 }

packages/core/docs/Implementation.md

@@ -0,0 +1,80 @@
+# Implementation
+
+The implementation guide covers all the possible ways to implement the Moox Core package.
+
+## Base Entities
+
+Moox Core ships base entities that can be used to create new entities:
+
+### Item Entity
+
+The Item Entity is implemented in our Single Entity Package [Moox Item](https://github.com/mooxphp/item). You can use the `php artisan moox:build` command to create a new item entity. This is the manual way to implement the Item Entity:
+
+#### Item Model
+
+```php
+use Moox\Core\Entities\Items\Item\MooxModel;
+
+class Item extends MooxModel {}
+```
+
+### Item Resource
+
+```php
+use Moox\Core\Entities\BaseResource;
+
+class ItemResource extends Resource
+{
+    // your resource
+}
+```
+
+### Item Pages
+
+```php
+use Moox\Core\Entities\Items\Item\Pages\MooxCreatePage;
+use Moox\Item\Moox\Entities\Items\ItemResource;
+
+class CreatePage extends MooxCreatePage
+{
+    protected static string $resource = ItemResource::class;
+}
+```
+
+```php
+use Moox\Core\Entities\Items\Item\Pages\MooxEditPage;
+use Moox\Item\Moox\Entities\Items\ItemResource;
+
+class EditPage extends MooxEditPage
+{
+    protected static string $resource = ItemResource::class;
+}
+```
+
+```php
+use Moox\Core\Entities\Items\Item\Pages\MooxListPage;
+use Moox\Item\Moox\Entities\Items\ItemResource;
+
+class ListPage extends MooxListPage
+{
+    protected static string $resource = ItemResource::class;
+}
+```
+
+```php
+use Moox\Core\Entities\Items\Item\Pages\MooxViewPage;
+use Moox\Item\Moox\Entities\Items\ItemResource;
+
+class ViewPage extends MooxViewPage
+{
+    protected static string $resource = ItemResource::class;
+}
+```
+
+## Core Traits
+
+Moox Core ships with multiple traits that can be used to add functionality to entities:
+
+### Has Tabs
+
+### Has Taxonomy

…s/core/src/Entities/MooxBaseResource.php …kages/core/src/Entities/BaseResource.phppackages/core/src/Entities/MooxBaseResource.php renamed to packages/core/src/Entities/BaseResource.php packages/core/src/Entities/MooxBaseResource.php renamed to packages/core/src/Entities/BaseResource.php

@@ -16,7 +16,7 @@
 use Illuminate\Database\Eloquent\SoftDeletes;
 use Illuminate\Database\Eloquent\SoftDeletingScope;
 
-abstract class MooxBaseResource extends Resource
+abstract class BaseResource extends Resource
 {
     protected static function modifyEloquentQuery(Builder $query): Builder
     {

…re/src/Entities/Items/Item/MooxModel.php …re/src/Entities/Items/Item/ItemModel.phppackages/core/src/Entities/Items/Item/MooxModel.php renamed to packages/core/src/Entities/Items/Item/ItemModel.php packages/core/src/Entities/Items/Item/MooxModel.php renamed to packages/core/src/Entities/Items/Item/ItemModel.php

@@ -4,7 +4,7 @@
 
 use Illuminate\Database\Eloquent\Model;
 
-class MooxModel extends Model
+class ItemModel extends Model
 {
     // nothing for now
 }

…src/Entities/Items/Item/MooxResource.php …src/Entities/Items/Item/ItemResource.phppackages/core/src/Entities/Items/Item/MooxResource.php renamed to packages/core/src/Entities/Items/Item/ItemResource.php packages/core/src/Entities/Items/Item/MooxResource.php renamed to packages/core/src/Entities/Items/Item/ItemResource.php

@@ -3,12 +3,12 @@
 namespace Moox\Core\Entities\Items\Item;
 
 use Filament\Forms\Components\Actions;
-use Moox\Core\Entities\MooxBaseResource;
-use Moox\Core\Traits\Tabs\TabsInResource;
+use Moox\Core\Entities\BaseResource;
+use Moox\Core\Traits\Tabs\HasResourceTabs;
 
-abstract class MooxResource extends MooxBaseResource
+class ItemResource extends BaseResource
 {
-    use TabsInResource;
+    use HasResourceTabs;
 
     public static function enableCreate(): bool
     {

…ties/Items/Item/Pages/MooxCreatePage.php …ties/Items/Item/Pages/ItemCreatePage.phppackages/core/src/Entities/Items/Item/Pages/MooxCreatePage.php renamed to packages/core/src/Entities/Items/Item/Pages/ItemCreatePage.php packages/core/src/Entities/Items/Item/Pages/MooxCreatePage.php renamed to packages/core/src/Entities/Items/Item/Pages/ItemCreatePage.php

@@ -7,7 +7,7 @@
 use Illuminate\Database\Eloquent\SoftDeletes;
 use Illuminate\Database\Eloquent\SoftDeletingScope;
 
-abstract class MooxCreatePage extends CreateRecord
+abstract class ItemCreatePage extends CreateRecord
 {
     protected function resolveRecord($key): Model
     {