@famgia/omnify-laravel 0.0.117 → 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.117",
+  "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.106",
-    "@famgia/omnify-core": "0.0.108",
-    "@famgia/omnify-atlas": "0.0.102"
+    "@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.

package/stubs/ai-guides/cursor/laravel-controller.mdc.stub

@@ -1,6 +1,6 @@
 ---
-description: "Controller development rules - thin controller, query builder, OpenAPI"
-globs: ["{{LARAVEL_BASE}}/Http/Controllers/**"]
+description: "Laravel controller patterns: thin controllers with query builder, OpenAPI documentation (NO /api prefix!), validation with $request->validated(), and proper Resource usage. Apply when creating or editing controllers."
+globs: ["{{LARAVEL_BASE}}/app/Http/Controllers/**/*.php"]
 alwaysApply: false
 ---
 

package/stubs/ai-guides/cursor/laravel-request.mdc.stub

@@ -1,6 +1,6 @@
 ---
-description: "FormRequest rules - OpenAPI Schema must match validation rules"
-globs: ["{{LARAVEL_BASE}}/Http/Requests/**"]
+description: "Laravel FormRequest rules: OpenAPI schema MUST match schemaRules(), extend OmnifyBase for auto-generated validation, never use $request->all(). Apply when editing Request classes."
+globs: ["{{LARAVEL_BASE}}/app/Http/Requests/**/*.php"]
 alwaysApply: false
 ---
 

package/stubs/ai-guides/cursor/laravel-resource.mdc.stub

@@ -1,6 +1,6 @@
 ---
-description: "Resource class rules - OpenAPI Schema must match actual output"
-globs: ["{{LARAVEL_BASE}}/Http/Resources/**"]
+description: "Laravel API Resource rules: OpenAPI schema MUST match toArray() output, extend OmnifyBase for auto-generated fields, use whenLoaded() for relations. Apply when editing Resource classes."
+globs: ["{{LARAVEL_BASE}}/app/Http/Resources/**/*.php"]
 alwaysApply: false
 ---
 

package/stubs/ai-guides/cursor/laravel-review.mdc.stub

@@ -1,5 +1,5 @@
 ---
-description: "Code review checklist - security, performance, quality"
+description: "Code review checklist for Laravel: security ($request->validated, SQL injection), performance (eager loading, N+1), and quality standards. Mention @laravel-review in chat to invoke."
 globs: []
 alwaysApply: false
 ---

package/stubs/ai-guides/cursor/laravel-testing.mdc.stub

@@ -1,6 +1,6 @@
 ---
-description: "PEST testing rules - 正常系/異常系, naming conventions"
-globs: ["tests/**", "**/*Test.php"]
+description: "PEST testing guide: 正常系 (happy path) + 異常系 (error cases), Japanese naming conventions, RefreshDatabase trait, and factory usage. Apply when writing or reviewing tests."
+globs: ["{{LARAVEL_BASE}}/tests/**/*.php"]
 alwaysApply: false
 ---
 

package/stubs/ai-guides/cursor/laravel.mdc.stub

@@ -1,6 +1,6 @@
 ---
-description: "Laravel backend development rules - security, performance, patterns"
-globs: ["{{LARAVEL_BASE}}/**"]
+description: "Laravel backend rules for Omnify projects: schema-first migrations, thin controllers, security patterns, and code generation. Apply when working with Laravel controllers, models, migrations, or API endpoints."
+globs: ["{{LARAVEL_BASE}}/**/*.php"]
 alwaysApply: false
 ---
 

package/stubs/ai-guides/cursor/migrations-workflow.mdc.stub

@@ -1,5 +1,5 @@
 ---
-description: "CRITICAL: Use Omnify Schema for migrations - DO NOT create migrations manually"
+description: "Schema-first workflow for database changes. NEVER use php artisan make:migration - always edit schemas/*.yaml and run npx omnify generate instead. This rule enforces the correct workflow when working with migrations."
 globs: ["{{LARAVEL_BASE}}/database/migrations/**"]
 alwaysApply: true
 ---

package/stubs/ai-guides/cursor/omnify-migrations.mdc.stub

@@ -1,6 +1,6 @@
 ---
-description: "CRITICAL: Auto-generated Omnify migrations - DO NOT EDIT"
-globs: ["{{LARAVEL_BASE}}/migrations/omnify/**"]
+description: "STOP! These are auto-generated Omnify migrations. DO NOT EDIT these files - edit schemas/*.yaml instead and run npx omnify generate"
+globs: ["{{LARAVEL_BASE}}/database/migrations/omnify/**"]
 alwaysApply: true
 ---
 

package/stubs/ai-guides/cursor/omnify.mdc.stub

@@ -1,6 +1,6 @@
 ---
-description: "Omnify schema-driven code generation rules"
-globs: ["schemas/**/*.yaml", "omnify.config.ts"]
+description: "Omnify schema-driven code generation: YAML schema syntax, configuration (omnify.config.ts), and generation workflow. Apply when editing schema files or config."
+globs: ["schemas/**/*.yaml", "schemas/**/*.yml", "omnify.config.ts"]
 alwaysApply: false
 ---