@famgia/omnify-laravel 0.0.118 → 0.0.119

package/dist/plugin.js

@@ -1,6 +1,6 @@
 import {
   laravelPlugin
-} from "./chunk-3YANFHE5.js";
+} from "./chunk-7I6UNXOD.js";
 export {
   laravelPlugin as default,
   laravelPlugin

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@famgia/omnify-laravel",
-  "version": "0.0.118",
+  "version": "0.0.119",
   "description": "Laravel migration and TypeScript type generator for omnify-schema",
   "type": "module",
   "main": "./dist/index.js",
@@ -25,9 +25,9 @@
     "README.md"
   ],
   "dependencies": {
-    "@famgia/omnify-types": "0.0.107",
-    "@famgia/omnify-core": "0.0.109",
-    "@famgia/omnify-atlas": "0.0.103"
+    "@famgia/omnify-types": "0.0.108",
+    "@famgia/omnify-core": "0.0.110",
+    "@famgia/omnify-atlas": "0.0.104"
   },
   "scripts": {
     "build": "tsup",

package/stubs/ai-guides/claude-rules/laravel-controllers.md.stub

@@ -0,0 +1,57 @@
+---
+paths:
+  - "{{LARAVEL_ROOT}}app/Http/Controllers/**/*.php"
+---
+
+# Laravel Controller Rules
+
+## Thin Controller Pattern
+
+Controllers should: Validate → Delegate → Respond
+
+```php
+public function store(StoreUserRequest $request): JsonResponse
+{
+    // ✅ Validate (via FormRequest)
+    $data = $request->validated();
+    
+    // ✅ Delegate (simple = Model, complex = Service)
+    $user = User::create($data);
+    
+    // ✅ Respond (via Resource)
+    return new UserResource($user);
+}
+```
+
+## ⚠️ CRITICAL: OpenAPI Paths
+
+**DO NOT add `/api` prefix!** The `api.php` route file already has it.
+
+```php
+// ❌ WRONG
+#[OA\Get(path: '/api/users')]
+
+// ✅ CORRECT
+#[OA\Get(path: '/users')]
+```
+
+## Security Rules
+
+- Always use `$request->validated()`, never `$request->all()`
+- Use route model binding for single resources
+- Use `authorize()` in FormRequest for authorization
+
+## Query Patterns
+
+```php
+// ✅ List with pagination and eager loading
+User::query()
+    ->with(['posts', 'profile'])
+    ->when($search, fn($q) => $q->where('name', 'like', "%{$search}%"))
+    ->latest()
+    ->paginate(15);
+```
+
+## Full Documentation
+
+See @.claude/omnify/guides/laravel/controller.md for complete patterns.

package/stubs/ai-guides/claude-rules/laravel-migrations.md.stub

@@ -0,0 +1,47 @@
+---
+paths:
+  - "{{LARAVEL_ROOT}}database/migrations/**/*.php"
+---
+
+# ⛔ STOP: Migration Rules
+
+## Auto-Generated Migrations (DO NOT EDIT)
+
+Files in `database/migrations/omnify/` are **AUTO-GENERATED** by Omnify.
+
+**ANY MANUAL CHANGES WILL BE OVERWRITTEN** on next `npx omnify generate`.
+
+## ✅ Correct Workflow
+
+### To add/modify columns:
+
+1. Edit schema YAML in `schemas/`
+2. Run `npx omnify generate`
+3. Run `php artisan migrate`
+
+### For custom migrations (outside Omnify):
+
+```bash
+php artisan make:migration add_custom_field_to_users_table
+# Creates: database/migrations/2026_xx_xx_xxxxxx_add_custom_field_to_users_table.php
+# This is SAFE - Omnify won't touch it
+```
+
+## File Structure
+
+```
+database/migrations/
+├── omnify/                    ← ⛔ AUTO-GENERATED - DO NOT EDIT
+│   ├── 2026_01_01_000000_create_users_table.php
+│   └── ...
+├── 2026_01_12_120000_add_custom_field.php  ← ✅ Safe to edit
+└── 2026_01_12_130000_custom_migration.php  ← ✅ Safe to edit
+```
+
+## Quick Reference
+
+| Want to... | Do this |
+|------------|---------|
+| Add column | Edit schema YAML → `npx omnify generate` |
+| Modify column | Edit schema YAML → `npx omnify generate` |
+| Custom migration | `php artisan make:migration` (outside omnify/) |

package/stubs/ai-guides/claude-rules/laravel-tests.md.stub

@@ -0,0 +1,52 @@
+---
+paths:
+  - "{{LARAVEL_ROOT}}tests/**/*.php"
+---
+
+# Testing Rules (PEST)
+
+## Test Naming Convention (Japanese Style)
+
+```php
+describe('UserController', function () {
+    // 正常系 (Happy Path)
+    describe('正常系', function () {
+        test('一覧が取得できる', function () { ... });
+        test('新規作成ができる', function () { ... });
+    });
+    
+    // 異常系 (Error Cases)
+    describe('異常系', function () {
+        test('認証なしで401', function () { ... });
+        test('存在しないIDで404', function () { ... });
+    });
+});
+```
+
+## Required Setup
+
+```php
+uses(RefreshDatabase::class);
+
+beforeEach(function () {
+    $this->user = User::factory()->create();
+    $this->actingAs($this->user);
+});
+```
+
+## Assertion Patterns
+
+```php
+// API Response
+$response->assertStatus(200)
+    ->assertJsonStructure(['data' => ['id', 'name']]);
+
+// Database
+$this->assertDatabaseHas('users', ['email' => 'test@example.com']);
+$this->assertDatabaseMissing('users', ['id' => $user->id]);
+$this->assertDatabaseCount('users', 3);
+```
+
+## Full Documentation
+
+See @.claude/omnify/guides/laravel/testing.md for complete patterns.

package/stubs/ai-guides/claude-rules/naming.md.stub

@@ -1,3 +1,8 @@
+---
+paths:
+  - "{{LARAVEL_ROOT}}app/**/*.php"
+---
+
 # Naming Conventions Guide
 
 > **Related:** [README](./README.md) | [Testing Guide](./testing-guide.md)

package/stubs/ai-guides/claude-rules/performance.md.stub

@@ -1,3 +1,8 @@
+---
+paths:
+  - "{{LARAVEL_ROOT}}app/**/*.php"
+---
+
 # Performance & Quality Rules
 
 > **Non-negotiable rules** for Laravel performance and code quality.

package/stubs/ai-guides/claude-rules/react-components.md.stub

@@ -0,0 +1,67 @@
+---
+paths:
+  - "{{TYPESCRIPT_BASE}}/**/*.tsx"
+---
+
+# React + Ant Design Rules
+
+## Core Patterns
+
+### Service Layer (API calls)
+
+```typescript
+// services/user.ts
+export const userService = {
+  list: (params?: UserListParams) => 
+    api.get("/api/users", { params }).then(r => r.data),
+  create: (input: UserCreate) => 
+    api.post("/api/users", input).then(r => r.data.data),
+};
+```
+
+### TanStack Query
+
+```typescript
+const { data, isLoading } = useQuery({
+  queryKey: queryKeys.users.list(filters),
+  queryFn: () => userService.list(filters),
+});
+
+const mutation = useMutation({
+  mutationFn: userService.create,
+  onSuccess: () => {
+    queryClient.invalidateQueries({ queryKey: queryKeys.users.all });
+    message.success(t("messages.created"));
+  },
+  onError: (error) => form.setFields(getFormErrors(error)),
+});
+```
+
+## ⚠️ Enum Usage (CRITICAL)
+
+```typescript
+// ✅ CORRECT - Import generated Enum
+import { ApprovalStatus, ApprovalStatusValues } from "@/omnify/enum/ApprovalStatus";
+
+// ✅ Use Enum values
+if (status === ApprovalStatus.Pending) { ... }
+
+// ❌ WRONG - Inline union types
+newFilter.status = status as "pending" | "approved";
+```
+
+## Ant Design Static Method Warning
+
+```typescript
+// ❌ Wrong - No context
+import { message } from "antd";
+message.success("Done");
+
+// ✅ Correct - Use App.useApp()
+const { message } = App.useApp();
+message.success("Done");
+```
+
+## Full Documentation
+
+See @.claude/omnify/guides/react/ for complete patterns.

package/stubs/ai-guides/claude-rules/schema-yaml.md.stub

@@ -0,0 +1,69 @@
+---
+paths:
+  - "schemas/**/*.yaml"
+  - "schemas/**/*.yml"
+---
+
+# Omnify Schema Rules
+
+## Schema Workflow
+
+1. Read @.claude/omnify/guides/omnify/schema-guide.md first
+2. Create/edit YAML schema
+3. Run `npx omnify generate`
+4. Validate generated code
+5. Run `php artisan migrate`
+
+## Basic Template
+
+```yaml
+name: ModelName
+kind: object
+
+displayName:
+  ja: モデル名
+  en: Model Name
+
+options:
+  timestamps: true
+
+properties:
+  name:
+    type: String
+    length: 100
+    displayName:
+      ja: 名前
+      en: Name
+```
+
+## ⚠️ CRITICAL: String Defaults
+
+```yaml
+# ❌ WRONG - produces curly quotes
+default: "'cloud'"
+
+# ✅ CORRECT - just the value
+default: cloud
+```
+
+## Property Types
+
+| Type | SQL | TypeScript |
+|------|-----|------------|
+| String | VARCHAR | string |
+| Text | TEXT | string |
+| Int | INT | number |
+| Boolean | BOOLEAN | boolean |
+| DateTime | DATETIME | string |
+
+## Relationships
+
+| Relation | Description |
+|----------|-------------|
+| belongsTo | Foreign key on THIS table |
+| hasMany | Foreign key on OTHER table |
+| belongsToMany | Pivot table |
+
+## Full Documentation
+
+See @.claude/omnify/guides/omnify/schema-guide.md for complete syntax.

package/stubs/ai-guides/claude-rules/security.md.stub

@@ -1,3 +1,8 @@
+---
+paths:
+  - "{{LARAVEL_ROOT}}app/**/*.php"
+---
+
 # Security Rules
 
 > **Non-negotiable rules** for Laravel security. Violations = vulnerabilities.