feat: release candidate

.cursor/rules/vuetify-standards.mdc

@@ -24,7 +24,7 @@ globs: vue/src/js/**/*.js, vue/src/js/**/*.vue
   - Implement Vue.js composition API for state management and component logic.
   - Use Vite for asset bundling and development server.
   - Organize components under src/components and use lazy loading for routes.
-  - Validate forms using Vuelidate and enhance UI with Vuetify components.
+  - Validate forms using useValidation (vue/src/js/hooks/useValidation.js) and enhance UI with Vuetify components.
 
   Key points
   - Follow Vue.js's component-driven design for clear separation of business logic, data, and presentation layers.
@@ -33,11 +33,11 @@ globs: vue/src/js/**/*.js, vue/src/js/**/*.vue
   - Use Vite for asset bundling and development server.
   - Organize components under vue/src/components
   - Organize composables under vue/src/hooks
-  - Organize behaviors under vue/src/behaviors
+  - Organize composables under vue/src/js/hooks (behaviors folder is deprecated)
   - Organize directives under vue/src/directives
   - Organize utilities under vue/src/utils
   - Organize stores under vue/src/stores
-  - Validate forms using Vuelidate and use vue/src/hooks/useValidation.js
+  - Validate forms using vue/src/js/hooks/useValidation.js (useValidation composable)
   - Use vue/src/hooks/useInput hook on input components under vue/src/components/inputs
 
 

.editorconfig

@@ -0,0 +1,20 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 4
+indent_style = space
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.{js,vue}]
+charset = utf-8
+end_of_line = lf
+indent_size = 2
+indent_style = space
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false

.github/workflows/tests.yml

@@ -115,5 +115,5 @@ jobs:
             composer require "laravel/framework:${{ matrix.laravel }}" "orchestra/testbench:${{ matrix.testbench }}" --no-interaction --no-update
             # composer update --prefer-dist --no-interaction
       - name: Execute Laravel tests
-        run: composer test
+        run: composer test:fast
 

.gitignore

@@ -46,3 +46,4 @@ all-coverage-clover.xml
 
 # AI
 .modulai/
+/tmp-modules/

AGENTS.md

@@ -10,6 +10,8 @@ You are an expert in Modularity package development. This is the unusualify/modu
 
 src/                      # Package source code (work here)
 ├── Console               # Artisan commands
+├── Hydrates/             # Schema hydrators (InputHydrator → *Hydrate)
+│   └── Inputs/           # Input-specific hydrates (type → schema)
 ├── Http/Controllers/     # Controllers
 ├── Providers/           # Service providers
 ├── Repositories/        # Repository pattern
@@ -18,7 +20,9 @@ src/                      # Package source code (work here)
 └── Entities/            # Models
 vue/src/                 # Frontend source
 ├── js/components/       # Vuetify components
-└── js/composables/      # Vue composables
+├── js/hooks/            # Vue composables
+├── js/utils/            # Utilities (helpers, schema, etc.)
+└── js/store/            # Vuex store
 
 ## PATTERNS TO ALWAYS USE
 2. **Use Traits**: ManageMedias, HasMedias, MediasTrait etc.
@@ -52,5 +56,63 @@ vue/src/                 # Frontend source
 - ❌ Hard-coded paths (use config)
 - ❌ Options API in Vue (use Composition API)
 - ❌ Plain HTML (use Vuetify components)
+- ❌ window.__* helpers in new code (use import from @/utils/helpers)
+
+## HELPERS
+- Prefer `import { isObject, dataGet } from '@/utils/helpers'` over `window.__isObject`, `window.__data_get`
+- window.__* is deprecated; kept for backward compatibility during migration
+
+---
+
+## HYDRATE ↔ INPUT ADAPTER
+
+The backend (PHP Hydrates) and frontend (Vue Inputs) communicate via a **schema contract**. Hydrates produce schema; Input components consume it.
+
+### Data Flow
+
+```
+Module config (type: 'checklist') → InputHydrator → ChecklistHydrate → schema { type: 'input-checklist', ... }
+                                                                              ↓
+FormBase/FormBaseField → mapTypeToComponent('input-checklist') → VInputChecklist (Checklist.vue)
+```
+
+### Naming Convention
+
+| Hydrate class      | Config type | Output type (schema) | Vue component   | File              |
+|--------------------|-------------|----------------------|-----------------|-------------------|
+| ChecklistHydrate  | checklist   | input-checklist      | VInputChecklist | Checklist.vue     |
+| TaggerHydrate      | tagger      | input-tagger         | VInputTagger    | Tagger.vue        |
+| SelectHydrate      | select      | select (or input-select-scroll) | v-select | (Vuetify) |
+| FileHydrate        | file        | input-file           | VInputFile      | File.vue          |
+| ImageHydrate       | image       | input-image          | VInputImage     | Image.vue         |
+| ...                | ...         | input-{kebab}        | VInput{Studly}  | {Studly}.vue      |
+
+- **Hydrate**: `studlyName($input['type']) . 'Hydrate'` → e.g. `checklist` → `ChecklistHydrate`
+- **Output type**: Hydrate sets `$input['type'] = 'input-{kebab}'` (e.g. `input-checklist`)
+- **Vue component**: `registerComponents(..., 'inputs', 'VInput')` → `Checklist.vue` → `VInputChecklist`
+- **Resolution**: `mapTypeToComponent('input-checklist')` → `v-input-checklist` (kebab of VInputChecklist)
+
+### When Adding a New Input
+
+1. **PHP**: Create `src/Hydrates/Inputs/{Studly}Hydrate.php` extending `InputHydrate`
+   - Set `$input['type'] = 'input-{kebab}'` in `hydrate()`
+   - Define `$requirements` for default schema keys
+2. **Vue**: Create `vue/src/js/components/inputs/{Studly}.vue`
+   - Use `useInput`, `makeInputProps`, `makeInputEmits` from `@/hooks`
+   - Component registers as `VInput{Studly}` via `includeFormInputs` glob
+3. **Registry** (optional): Add to `hydrateTypeMap` in `registry.js` for explicit mapping
+
+### Schema Contract
+
+Vue inputs expect schema props via `obj.schema` or `boundProps`:
+
+- **Common**: `name`, `label`, `default`, `rules`, `items`, `itemValue`, `itemTitle`
+- **Selectable**: `cascadeKey`, `cascades`, `repository`, `endpoint`
+- **Files**: `accept`, `maxFileSize`, `translated`, `max`
+- **Hydrate-only** (stripped before frontend): `route`, `model`, `repository`, `cascades`, `connector`
+
+### Hydrate Types → Vue Components
+
+See `vue/src/js/components/inputs/registry.js` → `hydrateTypeMap` for the full mapping.
 
 Always ask for clarification if the request is ambiguous.

FRONTEND_SUGGESTIONS.md

@@ -0,0 +1,91 @@
+# Frontend Enhancement Suggestions
+
+For your review when you're back. Respond to what you'd like to prioritize.
+
+---
+
+## 1. Options API → Composition API Migration
+
+**Current**: ~90% of components use Options API; AGENTS.md mandates Composition API.
+
+**Suggestions**:
+- Migrate high-traffic components first: Form.vue, Auth.vue, Datatable.vue
+- Add ESLint rule to enforce Composition API for new components
+- Create migration script for incremental conversion
+
+---
+
+## 2. Replace Mixins with Composables
+
+**Current**: Mixins (Locale, Modal, Input, MediaLibrary) overlap with composables.
+
+**Suggestions**:
+- Audit `grep -r "mixins:" vue/src`
+- Replace each mixin with equivalent composable
+- ~~Deprecate `mixins/` folder~~ ✓ Done – refactored to hooks, folder removed
+
+---
+
+## 3. Complete CustomFormBase Extraction
+
+**Current**: Input Registry and InputRenderer exist; CustomFormBase still has inline type blocks.
+
+**Suggestions**:
+- Extract each schema type (preview, title, radio, array, wrap/group, etc.) into `schema-types/Input*.vue`
+- CustomFormBase becomes a loop over `<InputRenderer :schema="obj" />` with slot passthrough
+- Reduces CustomFormBase from ~1400 to ~200 lines
+
+---
+
+## 4. Add CSRF Meta to Vitest Setup
+
+**Current**: Some tests fail because `document.querySelector('meta[name="csrf-token"]')` returns null in jsdom.
+
+**Suggestions**:
+- Add `<meta name="csrf-token" content="test">` to vitest-setup jsdom
+- Or mock Document in affected tests
+
+---
+
+## 5. TypeScript Migration
+
+**Current**: All .js and .vue; no type safety.
+
+**Suggestions**:
+- Migrate utils/helpers.js to TypeScript first
+- Add types for store, API responses
+- Incremental migration for new files
+
+---
+
+## 6. Labs Component Flag
+
+**Current**: `components/labs/` mixed with production.
+
+**Suggestions**:
+- Add `VUE_ENABLE_LABS=true` to conditionally load labs in build
+- Exclude labs from production bundle when flag is false
+
+---
+
+## 7. Replace window.__* Usage in Componables
+
+**Current**: Many composables still use `window.__isObject`, `window.__isset`, etc.
+
+**Suggestions**:
+- Replace with `import { isObject, isset } from '@/utils/helpers'` in composables
+- Remove window.__* assignments from init.js once migration is complete
+
+---
+
+## 8. Vuex → Pinia Migration
+
+**Current**: Vuex 4; Pinia recommended for Vue 3.
+
+**Suggestions**:
+- See docs/PINIA_MIGRATION.md
+- Plan for v4.x; create Pinia stores alongside Vuex
+
+---
+
+**Priority order** (suggested): 4 (fix tests) → 7 (finish helpers migration) → 1 (Composition API) → 3 (CustomFormBase extraction) → 2 (mixins) → 5 (TypeScript) → 6 (labs) → 8 (Pinia)

composer.json

@@ -67,12 +67,13 @@
         "wikimedia/composer-merge-plugin": "^2.1"
     },
     "require-dev": {
+        "brianium/paratest": "^7.4",
         "doctrine/dbal": "^3.9",
         "fakerphp/faker": "^1.9.1",
-        "laravel/pint": "^1.18",
-        "orchestra/testbench": "^7.0|^8.23.4|^9.0",
         "larastan/larastan": "^2.0",
+        "laravel/pint": "^1.18",
         "laravel/sanctum": "^3.3",
+        "orchestra/testbench": "^7.0|^8.23.4|^9.0",
         "phpunit/phpunit": "^9.0|^10.0.7|^11.0"
     },
     "extra": {
@@ -109,13 +110,37 @@
             "Unusualify\\Modularity\\Tests\\": "tests",
             "Workbench\\App\\": "workbench/app/",
             "Workbench\\Database\\Factories\\": "workbench/database/factories/",
-            "Workbench\\Database\\Seeders\\": "workbench/database/seeders/"
+            "Workbench\\Database\\Seeders\\": "workbench/database/seeders/",
+            "Modules\\": "tests/Stubs/Modules",
+            "TestModules\\": "test-modules"
         }
     },
     "scripts": {
         "test": "vendor/bin/phpunit  --stop-on-defect --no-coverage",
+        "test-clean": [
+            "@php -r \"foreach(glob('vendor/orchestra/testbench-core/laravel/bootstrap/cache/*.php') as \\$f) unlink(\\$f);\"",
+            "echo 'Test cache cleared'"
+        ],
+        "test:parallel": [
+            "@test-clean",
+            "@php -d memory_limit=1G vendor/bin/paratest --processes=2 --stop-on-defect --no-coverage"
+        ],
+        "test:parallel:coverage": [
+            "@test-clean",
+            "@php -d memory_limit=1G vendor/bin/paratest --processes=2 --stop-on-defect --coverage-html coverage-html"
+        ],
+        "test:fast": [
+            "@test-clean",
+            "@php -d memory_limit=1G vendor/bin/paratest --processes=4 --stop-on-defect --no-coverage"
+        ],
+        "test:fast:coverage": [
+            "@test-clean",
+            "@php -d memory_limit=1G vendor/bin/paratest --processes=4 --stop-on-defect --coverage-html coverage-html"
+        ],
         "test:brokers": "vendor/bin/phpunit --stop-on-defect --no-coverage tests/Brokers",
         "test:events": "vendor/bin/phpunit --stop-on-defect --no-coverage tests/Events",
+        "test:exceptions": "vendor/bin/phpunit --stop-on-defect --no-coverage tests/Exceptions",
+        "test:facades": "vendor/bin/phpunit --stop-on-defect --no-coverage tests/Facades",
         "test:helpers": "vendor/bin/phpunit --stop-on-defect --no-coverage tests/Helpers",
         "test:http": "vendor/bin/phpunit --stop-on-defect --no-coverage tests/Http",
         "test:models": "vendor/bin/phpunit --stop-on-defect --no-coverage tests/Models",