@famgia/omnify-laravel 0.0.118 → 0.0.120

package/dist/plugin.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@famgia/omnify-laravel",
-  "version": "0.0.118",
+  "version": "0.0.120",
   "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.109",
+    "@famgia/omnify-core": "0.0.111",
+    "@famgia/omnify-atlas": "0.0.105"
   },
   "scripts": {
     "build": "tsup",

package/stubs/ai-guides/claude-checklists/react.md.stub

@@ -0,0 +1,108 @@
+# Checklists
+
+> **Related:** [README](./README.md)
+
+## After Writing Code
+
+> **IMPORTANT**: Always run these commands after writing/modifying code:
+
+```bash
+# 1. Type check
+npm run typecheck
+
+# 2. Lint check
+npm run lint
+
+# Or combined
+npm run typecheck && npm run lint
+```
+
+---
+
+## Adding New Resource
+
+When adding a new resource (e.g., `posts`), follow these steps:
+
+### 1. Service Layer (Always in `services/`)
+
+```bash
+# Create: services/posts.ts
+```
+
+- [ ] Import types: `import type { Post, PostCreate, PostUpdate } from "@/types/model"`
+- [ ] Define only `PostListParams` (Create/Update come from Omnify)
+- [ ] Create `postService` object with CRUD methods
+- [ ] Add JSDoc comments for each method
+
+### 2. Query Keys
+
+```bash
+# Update: lib/queryKeys.ts
+```
+
+- [ ] Add `posts` object to `queryKeys`
+
+```typescript
+posts: {
+  all: ["posts"] as const,
+  lists: () => [...queryKeys.posts.all, "list"] as const,
+  list: (params?: PostListParams) => [...queryKeys.posts.lists(), params] as const,
+  details: () => [...queryKeys.posts.all, "detail"] as const,
+  detail: (id: number) => [...queryKeys.posts.details(), id] as const,
+},
+```
+
+### 3. Feature Components (in `features/posts/`)
+
+```bash
+# Create: features/posts/
+```
+
+- [ ] `PostTable.tsx` - Table component
+- [ ] `PostForm.tsx` - Form component
+- [ ] `usePostFilters.ts` - Feature-specific hooks (if needed)
+
+### 4. Pages
+
+```bash
+# Create pages in app/(dashboard)/posts/
+```
+
+- [ ] `page.tsx` - List page (imports from `features/posts/`)
+- [ ] `new/page.tsx` - Create form
+- [ ] `[id]/page.tsx` - Detail view
+- [ ] `[id]/edit/page.tsx` - Edit form
+
+### 5. Shared Components (only if reused)
+
+- [ ] If component used in 2+ features → move to `components/common/`
+
+### 6. Translations
+
+- [ ] Add labels to `src/i18n/messages/*.json` if needed
+
+### 7. Final Check
+
+- [ ] Run `npm run typecheck && npm run lint`
+- [ ] Test create, read, update, delete operations
+
+---
+
+## Adding New Language
+
+- [ ] Create message file: `src/i18n/messages/{locale}.json`
+- [ ] Add locale to `src/i18n/config.ts`
+- [ ] Import Ant Design locale in `src/components/AntdThemeProvider.tsx`
+- [ ] Test with `LocaleSwitcher` component
+
+---
+
+## Before Commit
+
+- [ ] `npm run typecheck` passes
+- [ ] `npm run lint` passes
+- [ ] No console warnings about deprecated props
+- [ ] No hardcoded strings (use i18n)
+- [ ] Forms handle loading state (`isPending`)
+- [ ] Forms handle validation errors (`getFormErrors`)
+- [ ] Mutations invalidate related queries

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.