@famgia/omnify-laravel 0.0.89 → 0.0.90

package/dist/plugin.js

@@ -1,6 +1,6 @@
 import {
   laravelPlugin
-} from "./chunk-V7LWJ6OM.js";
+} from "./chunk-2QSKZS63.js";
 export {
   laravelPlugin as default,
   laravelPlugin

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@famgia/omnify-laravel",
-  "version": "0.0.89",
+  "version": "0.0.90",
   "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.78",
-    "@famgia/omnify-atlas": "0.0.74",
-    "@famgia/omnify-core": "0.0.80"
+    "@famgia/omnify-types": "0.0.79",
+    "@famgia/omnify-core": "0.0.81",
+    "@famgia/omnify-atlas": "0.0.75"
   },
   "scripts": {
     "build": "tsup",

package/stubs/ai-guides/README.md.stub

@@ -0,0 +1,95 @@
+# .claude/omnify Documentation
+
+> AI-focused documentation for Omnify projects. Navigate by PURPOSE.
+
+## Quick Navigation
+
+| Purpose                  | Folder                       | When to Read                      |
+| ------------------------ | ---------------------------- | --------------------------------- |
+| **AI Personas**          | [agents/](./agents/)         | Select agent for task             |
+| **HOW to do tasks**      | [workflows/](./workflows/)   | New feature, bug fix, code review |
+| **WHAT rules to follow** | [rules/](./rules/)           | Security, performance, naming     |
+| **HOW to implement**     | [guides/](./guides/)         | Controller, Resource, Testing     |
+| **Quick verify**         | [checklists/](./checklists/) | Before commit, PR review          |
+
+## Agents
+
+| Agent                               | Role           | When to Use               |
+| ----------------------------------- | -------------- | ------------------------- |
+| [@developer](./agents/developer.md) | Implementation | Writing code, features    |
+| [@reviewer](./agents/reviewer.md)   | Code Review    | PR review, security audit |
+| [@architect](./agents/architect.md) | System Design  | Schema, API design        |
+| [@tester](./agents/tester.md)       | Testing        | Writing tests             |
+
+---
+
+## Structure
+
+```
+.claude/omnify/
+├── agents/              # AI Personas (WHO)
+│   ├── developer.md     # Implementation agent
+│   ├── reviewer.md      # Code review agent
+│   ├── architect.md     # System design agent
+│   └── tester.md        # Testing agent
+│
+├── workflows/           # Step-by-step processes (HOW)
+│   ├── new-feature.md   # Create new feature
+│   ├── bug-fix.md       # Fix a bug
+│   └── code-review.md   # Review PR
+│
+├── rules/               # Must-follow rules (WHAT)
+│   ├── security.md      # Security rules
+│   ├── performance.md   # Performance & quality rules
+│   └── naming.md        # Naming conventions
+│
+├── guides/              # Implementation guides (REFERENCE)
+│   ├── omnify/          # Omnify tool documentation
+│   ├── laravel/         # Laravel implementation
+│   └── react/           # React implementation
+│
+└── checklists/          # Quick verification (QA)
+    ├── backend.md
+    └── react.md
+```
+
+---
+
+## By Task Type
+
+### New Feature
+
+1. Read [workflows/new-feature.md](./workflows/new-feature.md)
+2. Follow step-by-step: Schema → API → Tests → OpenAPI → Frontend
+
+### Bug Fix
+
+1. Read [workflows/bug-fix.md](./workflows/bug-fix.md)
+2. Reproduce → Locate → Test → Fix → Verify
+
+### Code Review
+
+1. Read [workflows/code-review.md](./workflows/code-review.md)
+2. Security → Performance → Quality → Tests → Approve
+
+---
+
+## Debugging Quick Reference
+
+| Issue                  | Check                          |
+| ---------------------- | ------------------------------ |
+| API returns wrong data | `guides/laravel/resource.md`   |
+| Validation fails       | `guides/laravel/request.md`    |
+| 404 error              | Route + Model binding          |
+| N+1 queries            | `rules/performance.md`         |
+| Security concern       | `rules/security.md`            |
+
+---
+
+## Key Principles
+
+1. **Schema-First**: Start with `schemas/` folder
+2. **Thin Controllers**: Validate → Delegate → Respond
+3. **UTC Everywhere**: Store UTC, send ISO 8601
+4. **Test Everything**: 正常系 + 異常系
+5. **Don't Over-Engineer**: Simple CRUD = Controller + Model

package/stubs/ai-guides/claude-omnify/react-form-guide.md.stub

@@ -0,0 +1,259 @@
+# Omnify React Form Guide
+
+This guide explains how to build forms using Omnify generated schemas with **Ant Design** and **TanStack Query**.
+
+## Quick Start
+
+```tsx
+import { Form } from 'antd';
+import { useFormMutation } from '@/omnify/hooks';
+import { type CustomerCreate } from '@/omnify/schemas';
+import { CustomerForm } from '@/features/customers';
+import { api } from '@/lib/api';
+
+function CreateCustomerPage() {
+  const [form] = Form.useForm<CustomerCreate>();
+
+  const mutation = useFormMutation<CustomerCreate>({
+    form,
+    mutationFn: (data) => api.post('/customers', data),
+    invalidateKeys: [['customers']],
+    successMessage: 'Customer created successfully',
+    onSuccess: () => form.resetFields(),
+  });
+
+  return (
+    <CustomerForm
+      form={form}
+      onSubmit={mutation.mutate}
+      loading={mutation.isPending}
+    />
+  );
+}
+```
+
+## useFormMutation Hook
+
+Location: `resources/ts/omnify/hooks/use-form-mutation.ts`
+
+### Usage with Types
+
+```tsx
+import { useFormMutation } from '@/omnify/hooks';
+import { type CustomerCreate } from '@/omnify/schemas';
+
+// With type parameter for type safety
+const mutation = useFormMutation<CustomerCreate>({
+  form,
+  mutationFn: (data) => api.post('/customers', data),
+  invalidateKeys: [['customers']],
+  successMessage: 'Saved successfully',
+  onSuccess: () => form.resetFields(),
+});
+```
+
+### Options
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `form` | `FormInstance<T>` | Ant Design form instance (required) |
+| `mutationFn` | `(data: T) => Promise` | API call function (required) |
+| `invalidateKeys` | `string[][]` | Query keys to invalidate on success |
+| `successMessage` | `string` | Toast message on success |
+| `onSuccess` | `(data) => void` | Callback after success |
+| `onError` | `(error) => void` | Callback after error |
+
+### Laravel Error Handling
+
+The hook automatically handles Laravel validation errors (422):
+
+```json
+{
+  "message": "The given data was invalid.",
+  "errors": {
+    "email": ["The email has already been taken."]
+  }
+}
+```
+
+## Japanese Form Components
+
+Omnify provides specialized components for Japanese data input.
+
+### OmnifyForm.JapaneseName
+
+```tsx
+import { OmnifyForm } from '@/omnify/components';
+
+<OmnifyForm.JapaneseName
+  schemas={customerSchemas}
+  i18n={customerI18n}
+  prefix="name"        // name_lastname, name_firstname, etc.
+  required             // Show required asterisk
+  showKana={true}      // Show kana fields (default)
+/>
+```
+
+**Fields:** `{prefix}_lastname`, `{prefix}_firstname`, `{prefix}_kana_lastname`, `{prefix}_kana_firstname`
+
+### OmnifyForm.JapaneseAddress
+
+```tsx
+import { OmnifyForm } from '@/omnify/components';
+
+<OmnifyForm.JapaneseAddress
+  form={form}
+  schemas={customerSchemas}
+  i18n={customerI18n}
+  prefix="address"
+  enablePostalLookup={true}  // Postal code → address lookup
+/>
+```
+
+**Fields:** `{prefix}_postal_code`, `{prefix}_prefecture`, `{prefix}_address1`, `{prefix}_address2`, `{prefix}_address3`
+
+**Options:**
+- `enablePostalLookup` - Enable postal code search
+- `autoSearch` - Auto-search when 7 digits entered
+- `usePrefectureId` - Use numeric ID instead of string enum
+
+### OmnifyForm.JapaneseBank
+
+```tsx
+import { OmnifyForm } from '@/omnify/components';
+
+<OmnifyForm.JapaneseBank
+  schemas={customerSchemas}
+  i18n={customerI18n}
+  prefix="bank"
+/>
+```
+
+**Fields:** `{prefix}_bank_code`, `{prefix}_branch_code`, `{prefix}_account_type`, `{prefix}_account_number`, `{prefix}_account_holder`
+
+Account type options auto-loaded from `BankAccountType` enum with i18n.
+
+## Complete Form Example
+
+```tsx
+import { Form, Input, Button, Card, Space, Divider } from 'antd';
+import type { FormInstance } from 'antd';
+import { zodRule, setZodLocale } from '@/omnify/lib';
+import { OmnifyForm } from '@/omnify/components';
+import {
+  type Customer, type CustomerCreate,
+  customerSchemas, customerI18n,
+  getCustomerFieldLabel, getCustomerFieldPlaceholder,
+} from '@/omnify/schemas';
+
+const LOCALE = 'ja';
+
+interface CustomerFormProps {
+  form: FormInstance<CustomerCreate>;
+  initialValues?: Partial<Customer>;
+  onSubmit: (values: CustomerCreate) => void;
+  loading?: boolean;
+  isEdit?: boolean;
+}
+
+export function CustomerForm({ form, initialValues, onSubmit, loading, isEdit }: CustomerFormProps) {
+  setZodLocale(LOCALE);
+
+  const label = (key: string) => getCustomerFieldLabel(key, LOCALE);
+  const placeholder = (key: string) => getCustomerFieldPlaceholder(key, LOCALE);
+  const rule = (key: keyof typeof customerSchemas) => zodRule(customerSchemas[key], label(key));
+
+  return (
+    <Card>
+      <Form form={form} layout="horizontal" labelCol={{ span: 6 }} wrapperCol={{ span: 18 }}
+            initialValues={initialValues} onFinish={onSubmit} style={{ maxWidth: 800 }}>
+        
+        <Divider orientation="left">Name</Divider>
+        <OmnifyForm.JapaneseName schemas={customerSchemas} i18n={customerI18n} prefix="name" required />
+
+        <Divider orientation="left">Contact</Divider>
+        <Form.Item name="phone" label={label('phone')} rules={[rule('phone')]}>
+          <Input placeholder={placeholder('phone')} />
+        </Form.Item>
+        <Form.Item name="email" label={label('email')} rules={[rule('email')]}>
+          <Input type="email" placeholder={placeholder('email')} />
+        </Form.Item>
+
+        <Divider orientation="left">Address</Divider>
+        <OmnifyForm.JapaneseAddress form={form} schemas={customerSchemas} i18n={customerI18n}
+                              prefix="address" enablePostalLookup={true} />
+
+        <Divider orientation="left">Bank Account</Divider>
+        <OmnifyForm.JapaneseBank schemas={customerSchemas} i18n={customerI18n} prefix="bank" />
+
+        <Form.Item wrapperCol={{ offset: 6, span: 18 }}>
+          <Space>
+            <Button type="primary" htmlType="submit" loading={loading}>
+              {isEdit ? 'Update' : 'Create'}
+            </Button>
+          </Space>
+        </Form.Item>
+      </Form>
+    </Card>
+  );
+}
+```
+
+## Zod Validation with i18n
+
+```tsx
+import { zodRule, setZodLocale } from '@/omnify/lib';
+
+// Set locale once at component level
+setZodLocale('ja');
+
+// Use zodRule for field validation
+<Form.Item name="email" label={label('email')} rules={[zodRule(customerSchemas.email, label('email'))]}>
+  <Input />
+</Form.Item>
+```
+
+## Kana Validation Rules
+
+```tsx
+import { kanaString, KATAKANA_PATTERN } from '@/omnify/lib/rules';
+
+// Full-width katakana (default)
+const kanaSchema = kanaString();
+
+// Custom options
+const kanaSchema = kanaString({
+  fullWidthKatakana: true,
+  hiragana: true,
+  allowNumbers: true,
+});
+```
+
+## File Structure
+
+```
+resources/ts/omnify/
+├── components/
+│   ├── JapaneseNameField.tsx
+│   ├── JapaneseAddressField.tsx
+│   └── JapaneseBankField.tsx
+├── enum/
+│   └── plugin/
+│       ├── Prefecture.ts
+│       └── BankAccountType.ts
+├── hooks/
+│   └── use-form-mutation.ts
+├── lib/
+│   ├── form-validation.ts
+│   ├── zod-i18n.ts
+│   └── rules/kana.ts
+└── schemas/
+```
+
+## Tips
+
+1. **Use type generics** - `useFormMutation<CustomerCreate>` for type safety
+2. **Use `setZodLocale`** - Call once for localized validation messages
+3. **Use OmnifyForm.* components** - Built-in i18n, validation, postal lookup
+4. **Set `invalidateKeys`** - Auto-refresh lists after mutations
+5. **Don't pass `form` to Name/Bank components** - Only Address needs it for postal lookup

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

@@ -0,0 +1,58 @@
+---
+description: "Omnify schema-driven code generation rules"
+globs: ["schemas/**/*.yaml", "omnify.config.ts"]
+alwaysApply: false
+---
+
+# Omnify Schema Rules
+
+This project uses Omnify for schema-driven code generation.
+
+## Documentation
+
+Read these files in `.claude/omnify/guides/omnify/`:
+
+| File                  | Content                          |
+| --------------------- | -------------------------------- |
+| `schema-guide.md`     | Base schema format               |
+| `config-guide.md`     | Configuration (omnify.config.ts) |
+| `laravel-guide.md`    | Laravel generator                |
+| `typescript-guide.md` | TypeScript generator             |
+| `japan-guide.md`      | Japanese field types             |
+
+## Commands
+
+```bash
+npx omnify generate  # Generate code from schemas
+npx omnify validate  # Validate all schemas
+```
+
+## Important
+
+- **DO NOT** manually edit files in `database/migrations/omnify/`
+- **DO NOT** manually edit files in `resources/ts/omnify/schemas/base/`
+- **DO NOT** manually edit files in `app/Models/OmnifyBase/`
+- Schema changes → Run `npx omnify generate`
+
+## Schema Quick Reference
+
+```yaml
+name: User
+displayName:
+  ja: ユーザー
+  en: User
+
+properties:
+  email:
+    type: Email
+    unique: true
+  name:
+    type: String
+  role:
+    type: EnumRef
+    target: UserRole
+
+options:
+  timestamps: true
+  softDelete: true
+```