Enforce CamelCase Latin migration names

Author: KolesnikovKirill

CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All significant changes to this project will be documented in this file.
 
+## [1.4.2] - 2025-12-10
+
+### Changed
+
+-   **CLI make:migration:** Migration names must now be CamelCase Latin words (e.g., `CreateUsersTable`); invalid names are rejected with an error.
+
 ## [1.4.1] - 2025-12-10
 
 ### Added

README.md

@@ -8,13 +8,13 @@
 A lightweight, framework-agnostic database layer for PHP.  
 Part of the Codemonster ecosystem — but works fully standalone.
 
-## 📦 Installation
+## Installation
 
 ```bash
 composer require codemonster-ru/database
 ```
 
-## 🚀 Usage
+## Usage
 
 ### 1. Database Manager
 
@@ -232,7 +232,7 @@ transaction(fn() =>   // convenience wrapper
 
 Helpers are thin wrappers around `DatabaseManager` and the connection’s `schema()` / `transaction()` methods.
 
-## 📐 Schema Builder
+## Schema Builder
 
 The package includes a lightweight schema builder.
 
@@ -271,7 +271,7 @@ $db->schema()->drop('users');
 $db->schema()->dropIfExists('users');
 ```
 
-## 🗄 Supported Column Types
+## Supported Column Types
 
 -   Integers: `id`, `integer`, `bigInteger`, `mediumInteger`, `smallInteger`, `tinyInteger`
 -   Floats: `decimal`, `double`, `float`
@@ -283,7 +283,7 @@ $db->schema()->dropIfExists('users');
 -   Indexes: `index`, `unique`, `primary`
 -   Foreign keys with `foreign()` / `references()` / `on()` and `onDelete()` / `onUpdate()` helpers
 
-## 🚦 Migrations
+## Migrations
 
 The package includes a migration system (designed to be used via the CLI).
 
@@ -314,7 +314,7 @@ return new class extends Migration {
 };
 ```
 
-## 🧬 ORM (ActiveRecord / Eloquent‑style)
+## ORM (ActiveRecord / Eloquent‑style)
 
 **Since 1.3.0**, the package includes a complete ORM layer:
 
@@ -371,7 +371,7 @@ $user->save();
 $user->delete();
 ```
 
-## 🔗 Relationships
+## Relationships
 
 Available relations:
 
@@ -408,7 +408,7 @@ $user->posts;
 $user->load('posts');
 ```
 
-## 🧹 Soft Deletes
+## Soft Deletes
 
 ```php
 use Codemonster\Database\Traits\SoftDeletes;
@@ -423,7 +423,7 @@ class User extends Model {
 -   `User::onlyTrashed()`
 -   `User::withTrashed()`
 
-## 🧰 CLI Tool
+## CLI Tool
 
 A standalone CLI ships with the package:
 
@@ -455,6 +455,8 @@ vendor/bin/database migrate:status
 vendor/bin/database make:migration CreatePostsTable
 ```
 
+Migration names must be CamelCase using only Latin letters (e.g., `CreateUsersTable`). Names that include other symbols or casing styles are rejected.
+
 Default migrations directory:
 
 ```text
@@ -467,16 +469,16 @@ You can override paths via the migration kernel/path resolver:
 $kernel->getPathResolver()->addPath('/path/to/migrations');
 ```
 
-## 🧪 Tests
+## Tests
 
 ```bash
 composer test
 ```
 
-## 👨‍💻 Author
+## Author
 
 [**Kirill Kolesnikov**](https://github.com/KolesnikovKirill)
 
-## 📜 License
+## License
 
 [MIT](https://github.com/codemonster-ru/database/blob/main/LICENSE)

src/CLI/Commands/MakeMigrationCommand.php

@@ -35,6 +35,12 @@ public function handle(array $arguments): int
             return 1;
         }
 
+        if (!$this->isValidName($name)) {
+            fwrite(STDERR, "Migration name must be CamelCase, Latin letters only. Example: CreateUsersTable\n");
+
+            return 1;
+        }
+
         $path = $this->detectPath();
 
         if (!$path) {
@@ -76,11 +82,17 @@ protected function detectPath(): ?string
         return null;
     }
 
+    protected function isValidName(string $name): bool
+    {
+        return (bool) preg_match('/^[A-Z][a-z]*(?:[A-Z][a-z]*)*$/', $name);
+    }
+
     protected function buildFileName(string $name): string
     {
         $now = new \DateTimeImmutable('now');
         $timestamp = $now->format('Y_m_d_His');
-        $slug = preg_replace('/[^A-Za-z0-9]+/', '_', $name);
+        $slug = preg_replace('/(?<!^)([A-Z])/', '_$1', $name);
+        $slug = preg_replace('/[^A-Za-z0-9]+/', '_', $slug);
         $slug = trim($slug, '_');
         $slug = strtolower($slug);