@famgia/omnify 1.0.89 → 1.0.91

package/ai-guides/schema-guide.md

@@ -75,6 +75,10 @@ properties:
     displayName:
       ja: 名前
       en: Name
+    placeholder:             # Placeholder for form inputs (multi-language)
+      ja: 名前を入力
+      en: Enter name
+      vi: Nhập tên
     nullable: false          # Nullable (default: false)
     unique: true             # Unique constraint
     primary: true            # Primary key (use with options.id: false)
@@ -84,6 +88,40 @@ properties:
       maxLength: 255
 ```
 
+## Placeholder for Compound Types
+
+For compound types (like JapaneseName, JapaneseAddress), you can customize placeholders per field:
+
+```yaml
+properties:
+  name:
+    type: JapaneseName
+    displayName:
+      ja: 氏名
+      en: Full Name
+    fields:                  # Per-field overrides for compound types
+      Lastname:
+        placeholder:         # Override default placeholder
+          ja: 姓を入力
+          en: Enter last name
+      Firstname:
+        placeholder:
+          ja: 名を入力
+          en: Enter first name
+      KanaLastname:
+        nullable: true
+        placeholder:
+          ja: セイ（カナ）
+          en: Last name (Kana)
+      KanaFirstname:
+        nullable: true
+        placeholder:
+          ja: メイ（カナ）
+          en: First name (Kana)
+```
+
+**Note**: Compound types from plugins (like `@famgia/omnify-japan`) come with default placeholders for common locales (en, ja, vi). You can override them in your schema as shown above.
+
 ## Association Relations
 
 ### ManyToOne (N:1)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@famgia/omnify",
-  "version": "1.0.89",
+  "version": "1.0.91",
   "description": "Schema-driven database migration system with TypeScript types and Laravel migrations",
   "type": "module",
   "main": "./dist/index.js",
@@ -25,14 +25,14 @@
     "README.md"
   ],
   "dependencies": {
-    "@famgia/omnify-typescript": "0.0.67",
-    "@famgia/omnify-laravel": "0.0.88",
-    "@famgia/omnify-atlas": "0.0.73",
-    "@famgia/omnify-core": "0.0.79",
-    "@famgia/omnify-cli": "0.0.85",
-    "@famgia/omnify-types": "0.0.77",
-    "@famgia/omnify-mcp": "0.0.65",
-    "@famgia/omnify-japan": "0.0.72"
+    "@famgia/omnify-cli": "0.0.87",
+    "@famgia/omnify-core": "0.0.81",
+    "@famgia/omnify-types": "0.0.79",
+    "@famgia/omnify-laravel": "0.0.90",
+    "@famgia/omnify-typescript": "0.0.69",
+    "@famgia/omnify-mcp": "0.0.67",
+    "@famgia/omnify-atlas": "0.0.75",
+    "@famgia/omnify-japan": "0.0.74"
   },
   "keywords": [
     "omnify",

package/scripts/postinstall.js

@@ -1,5 +1,16 @@
 #!/usr/bin/env node
 
+/**
+ * @famgia/omnify postinstall
+ *
+ * Sets up AI assistant integration:
+ * 1. Generate combined JSON Schema (for YAML validation in editors)
+ * 2. Copy AI guides to .claude/omnify/
+ * 3. Create/update CLAUDE.md
+ * 4. Create .cursor/rules/omnify.md
+ * 5. Configure Claude MCP server
+ */
+
 import fs from 'fs';
 import path from 'path';
 import os from 'os';
@@ -8,7 +19,10 @@ import { fileURLToPath } from 'url';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
-// Content for CLAUDE.md
+// ============================================================================
+// Content Templates
+// ============================================================================
+
 const CLAUDE_MD_SECTION = `## Omnify
 
 This project uses Omnify for schema-driven code generation.
@@ -18,15 +32,13 @@ This project uses Omnify for schema-driven code generation.
 - \`config-guide.md\` - Configuration (omnify.config.ts)
 - \`laravel-guide.md\` - Laravel generator (if installed)
 - \`typescript-guide.md\` - TypeScript generator (if installed)
-- \`antdesign-guide.md\` - Ant Design Form integration (if installed)
 
 **Commands**:
 - \`npx omnify generate\` - Generate code from schemas
 - \`npx omnify validate\` - Validate schemas
 `;
 
-// Cursor rules content
-const CURSORRULES_CONTENT = `# Omnify Schema Rules
+const CURSOR_RULES = `# Omnify Schema Rules
 
 This project uses Omnify for schema-driven code generation.
 Schemas are in \`schemas/\` directory with \`.yaml\` extension.
@@ -36,358 +48,213 @@ For detailed documentation, read these files:
 - .claude/omnify/config-guide.md - Configuration (omnify.config.ts)
 - .claude/omnify/laravel-guide.md - Laravel generator (if exists)
 - .claude/omnify/typescript-guide.md - TypeScript generator (if exists)
-- .claude/omnify/antdesign-guide.md - Ant Design Form integration (if exists)
 
 Commands:
 - npx omnify generate - Generate code from schemas
 - npx omnify validate - Validate all schemas
 `;
 
-const MCP_CONFIG = {
-  omnify: {
-    command: 'npx',
-    args: ['@famgia/omnify-mcp'],
-  },
-};
+// ============================================================================
+// Helper Functions
+// ============================================================================
+
+function findProjectRoot() {
+  let dir = process.env.INIT_CWD || process.cwd();
+  const idx = dir.indexOf('node_modules');
+  if (idx !== -1) dir = dir.substring(0, idx - 1);
+  return fs.existsSync(path.join(dir, 'package.json')) ? dir : null;
+}
+
+function copyFiles(srcDir, destDir) {
+  if (!fs.existsSync(srcDir)) return [];
+  if (!fs.existsSync(destDir)) fs.mkdirSync(destDir, { recursive: true });
+
+  const copied = [];
+  for (const file of fs.readdirSync(srcDir)) {
+    const src = path.join(srcDir, file);
+    if (fs.statSync(src).isFile()) {
+      fs.copyFileSync(src, path.join(destDir, file));
+      copied.push(file);
+    }
+  }
+  return copied;
+}
+
+// ============================================================================
+// Setup Functions
+// ============================================================================
 
-/**
- * Generate combined JSON Schema from base schema + all plugin contributions
- */
 function generateCombinedSchema(projectRoot) {
-  const nodeModulesDir = path.join(projectRoot, 'node_modules');
-  const outputDir = path.join(nodeModulesDir, '.omnify');
+  const nodeModules = path.join(projectRoot, 'node_modules');
+  const outputDir = path.join(nodeModules, '.omnify');
   const outputPath = path.join(outputDir, 'combined-schema.json');
 
-  try {
-    // Read base schema from @famgia/omnify-types
-    const possiblePaths = [
-      path.join(nodeModulesDir, '@famgia/omnify-types/schemas/omnify-schema.json'),
-      path.join(nodeModulesDir, '@famgia/omnify/node_modules/@famgia/omnify-types/schemas/omnify-schema.json'),
-    ];
-
-    let baseSchemaPath = null;
-    for (const p of possiblePaths) {
-      if (fs.existsSync(p)) {
-        baseSchemaPath = p;
-        break;
-      }
-    }
+  // Find base schema
+  const searchPaths = [
+    path.join(nodeModules, '@famgia/omnify-types/schemas/omnify-schema.json'),
+    path.join(nodeModules, '@famgia/omnify/node_modules/@famgia/omnify-types/schemas/omnify-schema.json'),
+  ];
 
-    // Try pnpm hoisted location
-    if (!baseSchemaPath) {
-      const pnpmDir = path.join(nodeModulesDir, '.pnpm');
-      if (fs.existsSync(pnpmDir)) {
-        const matches = fs.readdirSync(pnpmDir).filter(f => f.startsWith('@famgia+omnify-types@'));
-        if (matches.length > 0) {
-          const matchPath = path.join(pnpmDir, matches[0], 'node_modules/@famgia/omnify-types/schemas/omnify-schema.json');
-          if (fs.existsSync(matchPath)) {
-            baseSchemaPath = matchPath;
-          }
-        }
-      }
+  // Also check pnpm hoisted location
+  const pnpmDir = path.join(nodeModules, '.pnpm');
+  if (fs.existsSync(pnpmDir)) {
+    const match = fs.readdirSync(pnpmDir).find(f => f.startsWith('@famgia+omnify-types@'));
+    if (match) {
+      searchPaths.push(path.join(pnpmDir, match, 'node_modules/@famgia/omnify-types/schemas/omnify-schema.json'));
     }
+  }
 
-    if (!baseSchemaPath) {
-      console.log('  Note: Base schema not found, skipping combined schema generation');
-      return false;
-    }
+  const baseSchemaPath = searchPaths.find(p => fs.existsSync(p));
+  if (!baseSchemaPath) return false;
 
+  try {
     const baseSchema = JSON.parse(fs.readFileSync(baseSchemaPath, 'utf-8'));
 
-    // Find all @famgia/omnify-* plugins with schema contributions
-    const famgiaDirs = [
-      path.join(nodeModulesDir, '@famgia'),
-      path.join(nodeModulesDir, '@famgia/omnify/node_modules/@famgia'),
-    ];
-    const pluginContributions = [];
-    const processedPlugins = new Set();
-
-    for (const famgiaDir of famgiaDirs) {
-      if (!fs.existsSync(famgiaDir)) continue;
-
-      const packages = fs.readdirSync(famgiaDir);
-      for (const pkg of packages) {
-        if (!pkg.startsWith('omnify-') || pkg === 'omnify-types' || pkg === 'omnify-mcp') {
-          continue;
-        }
-        if (processedPlugins.has(pkg)) continue;
+    // Find plugin schema contributions
+    const famgiaDir = path.join(nodeModules, '@famgia');
+    if (fs.existsSync(famgiaDir)) {
+      for (const pkg of fs.readdirSync(famgiaDir)) {
+        if (!pkg.startsWith('omnify-') || pkg === 'omnify-types' || pkg === 'omnify-mcp') continue;
 
         const contributionPath = path.join(famgiaDir, pkg, 'schemas/schema-contribution.json');
         if (fs.existsSync(contributionPath)) {
           try {
             const contribution = JSON.parse(fs.readFileSync(contributionPath, 'utf-8'));
-            pluginContributions.push({ name: pkg, contribution });
-            processedPlugins.add(pkg);
-          } catch {
-            // Invalid JSON, skip
-          }
-        }
-      }
-    }
 
-    // Merge contributions into base schema
-    for (const { name, contribution } of pluginContributions) {
-      if (contribution.definitions) {
-        for (const [defName, defValue] of Object.entries(contribution.definitions)) {
-          baseSchema.definitions[defName] = defValue;
-        }
-      }
+            // Merge definitions
+            if (contribution.definitions) {
+              Object.assign(baseSchema.definitions, contribution.definitions);
+            }
 
-      if (contribution.propertyTypes && baseSchema.definitions.PropertyDefinition) {
-        for (const typeName of contribution.propertyTypes) {
-          baseSchema.definitions.PropertyDefinition.oneOf.push({
-            "$ref": `#/definitions/${typeName}`
-          });
+            // Add property types
+            if (contribution.propertyTypes && baseSchema.definitions.PropertyDefinition) {
+              for (const typeName of contribution.propertyTypes) {
+                baseSchema.definitions.PropertyDefinition.oneOf.push({
+                  "$ref": `#/definitions/${typeName}`
+                });
+              }
+            }
+          } catch { /* skip invalid */ }
         }
       }
-
-      console.log(`  Added schema contributions from @famgia/${name}`);
     }
 
     baseSchema.$id = 'omnify://combined-schema.json';
-    baseSchema.description = baseSchema.description + ' (Combined with plugin contributions)';
-
-    if (!fs.existsSync(outputDir)) {
-      fs.mkdirSync(outputDir, { recursive: true });
-    }
-
-    fs.writeFileSync(outputPath, JSON.stringify(baseSchema, null, 2), 'utf-8');
-    console.log('  Generated combined JSON schema at node_modules/.omnify/combined-schema.json');
-
+    if (!fs.existsSync(outputDir)) fs.mkdirSync(outputDir, { recursive: true });
+    fs.writeFileSync(outputPath, JSON.stringify(baseSchema, null, 2));
     return true;
-  } catch (error) {
-    console.log('  Note: Could not generate combined schema');
+  } catch {
     return false;
   }
 }
 
-function findProjectRoot() {
-  let dir = process.env.INIT_CWD || process.cwd();
-  const nodeModulesIndex = dir.indexOf('node_modules');
-  if (nodeModulesIndex !== -1) {
-    dir = dir.substring(0, nodeModulesIndex - 1);
-  }
-  const packageJsonPath = path.join(dir, 'package.json');
-  if (fs.existsSync(packageJsonPath)) {
-    return dir;
-  }
-  return null;
+function copyAiGuides(projectRoot) {
+  const src = path.join(__dirname, '..', 'ai-guides');
+  const dest = path.join(projectRoot, '.claude', 'omnify');
+  return copyFiles(src, dest);
 }
 
-/**
- * Find all @famgia/omnify-* packages with ai-guides directories
- */
-function findPluginAiGuides(projectRoot) {
-  const nodeModulesDir = path.join(projectRoot, 'node_modules');
-  const aiGuidesDirs = [];
-
-  // Check @famgia directory
-  const famgiaDir = path.join(nodeModulesDir, '@famgia');
-  if (fs.existsSync(famgiaDir)) {
-    const packages = fs.readdirSync(famgiaDir);
-    for (const pkg of packages) {
-      if (pkg.startsWith('omnify')) {
-        const aiGuidesPath = path.join(famgiaDir, pkg, 'ai-guides');
-        if (fs.existsSync(aiGuidesPath)) {
-          aiGuidesDirs.push(aiGuidesPath);
-        }
-      }
-    }
-  }
+function setupClaudeMd(projectRoot) {
+  const filePath = path.join(projectRoot, 'CLAUDE.md');
 
-  // Also check pnpm hoisted location (.pnpm/@famgia+omnify-xxx@version/node_modules/@famgia/omnify-xxx)
-  const pnpmDir = path.join(nodeModulesDir, '.pnpm');
-  if (fs.existsSync(pnpmDir)) {
-    try {
-      const pnpmPackages = fs.readdirSync(pnpmDir);
-      for (const pkg of pnpmPackages) {
-        if (pkg.startsWith('@famgia+omnify')) {
-          // Extract package name from pnpm folder name (e.g., @famgia+omnify-laravel@0.0.70 -> omnify-laravel)
-          const match = pkg.match(/@famgia\+([^@]+)@/);
-          if (match) {
-            const pkgName = match[1]; // e.g., omnify-laravel
-            const aiGuidesPath = path.join(pnpmDir, pkg, 'node_modules/@famgia', pkgName, 'ai-guides');
-            if (fs.existsSync(aiGuidesPath)) {
-              aiGuidesDirs.push(aiGuidesPath);
-            }
-          }
-        }
-      }
-    } catch {
-      // Ignore errors reading pnpm directory
-    }
-  }
-
-  return aiGuidesDirs;
-}
-
-function copyAiGuidesToProject(projectRoot) {
-  const omnifyDir = path.join(projectRoot, '.claude', 'omnify');
-
-  try {
-    // Create .claude/omnify directory
-    if (!fs.existsSync(omnifyDir)) {
-      fs.mkdirSync(omnifyDir, { recursive: true });
-    }
-
-    // Track copied files to avoid duplicates
-    const copiedFiles = new Set();
-
-    // Helper to copy files without duplicates
-    const copyWithoutDuplicates = (srcDir) => {
-      if (!fs.existsSync(srcDir)) return;
-      const files = fs.readdirSync(srcDir);
-      for (const file of files) {
-        if (copiedFiles.has(file)) continue;
-        const srcPath = path.join(srcDir, file);
-        const destPath = path.join(omnifyDir, file);
-        if (fs.statSync(srcPath).isFile()) {
-          fs.copyFileSync(srcPath, destPath);
-          copiedFiles.add(file);
-          console.log(`  Created .claude/omnify/${file}`);
-        }
-      }
-    };
-
-    // Copy from main omnify package first
-    const mainAiGuidesDir = path.join(__dirname, '..', 'ai-guides');
-    copyWithoutDuplicates(mainAiGuidesDir);
-
-    // Copy from all @famgia/omnify-* plugin packages
-    const pluginDirs = findPluginAiGuides(projectRoot);
-    for (const pluginDir of pluginDirs) {
-      copyWithoutDuplicates(pluginDir);
-    }
-
-    return true;
-  } catch {
-    return false;
-  }
-}
+  if (fs.existsSync(filePath)) {
+    let content = fs.readFileSync(filePath, 'utf-8');
+    const match = content.match(/## Omnify[^\n]*/);
 
-function createClaudeMd(projectRoot) {
-  const claudeMdPath = path.join(projectRoot, 'CLAUDE.md');
-  const SECTION_START = '## Omnify';
-  const SECTION_END_MARKERS = ['## ', '---', '# '];  // Next section indicators
-
-  if (fs.existsSync(claudeMdPath)) {
-    let content = fs.readFileSync(claudeMdPath, 'utf-8');
-
-    // Find existing Omnify section (## Omnify or ## Omnify Schema Integration, etc.)
-    const omnifyMatch = content.match(/## Omnify[^\n]*/);
-    if (omnifyMatch) {
-      const startIdx = content.indexOf(omnifyMatch[0]);
-      // Find the end of the section (next ## heading or --- or end of file)
+    if (match) {
+      // Replace existing section
+      const startIdx = content.indexOf(match[0]);
       let endIdx = content.length;
-      const afterStart = content.substring(startIdx + omnifyMatch[0].length);
+      const after = content.substring(startIdx + match[0].length);
 
-      for (const marker of SECTION_END_MARKERS) {
-        const markerIdx = afterStart.indexOf('\n' + marker);
-        if (markerIdx !== -1 && markerIdx < endIdx - startIdx - omnifyMatch[0].length) {
-          endIdx = startIdx + omnifyMatch[0].length + markerIdx + 1;
+      for (const marker of ['## ', '---', '# ']) {
+        const idx = after.indexOf('\n' + marker);
+        if (idx !== -1 && idx < endIdx - startIdx - match[0].length) {
+          endIdx = startIdx + match[0].length + idx + 1;
         }
       }
 
-      // Replace the old section with new content
-      const before = content.substring(0, startIdx);
-      const after = content.substring(endIdx);
-      content = before + CLAUDE_MD_SECTION + after;
-      fs.writeFileSync(claudeMdPath, content, 'utf-8');
-      console.log('  Updated Omnify section in CLAUDE.md');
-      return true;
+      content = content.substring(0, startIdx) + CLAUDE_MD_SECTION + content.substring(endIdx);
+    } else {
+      // Append section
+      content = content.trimEnd() + '\n\n' + CLAUDE_MD_SECTION;
     }
 
-    // No Omnify section found, append
-    const newContent = content.trimEnd() + '\n\n' + CLAUDE_MD_SECTION;
-    fs.writeFileSync(claudeMdPath, newContent, 'utf-8');
-    console.log('  Appended Omnify section to CLAUDE.md');
-    return true;
+    fs.writeFileSync(filePath, content);
+  } else {
+    fs.writeFileSync(filePath, CLAUDE_MD_SECTION);
   }
-
-  fs.writeFileSync(claudeMdPath, CLAUDE_MD_SECTION, 'utf-8');
-  console.log('  Created CLAUDE.md');
-  return true;
 }
 
-function createCursorRules(projectRoot) {
-  const cursorDir = path.join(projectRoot, '.cursor', 'rules');
-  const cursorRulesPath = path.join(cursorDir, 'omnify.md');
-
-  try {
-    if (!fs.existsSync(cursorDir)) {
-      fs.mkdirSync(cursorDir, { recursive: true });
-    }
-
-    fs.writeFileSync(cursorRulesPath, CURSORRULES_CONTENT, 'utf-8');
-    console.log('  Updated .cursor/rules/omnify.md');
-    return true;
-  } catch {
-    return false;
-  }
+function setupCursorRules(projectRoot) {
+  const dir = path.join(projectRoot, '.cursor', 'rules');
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+  fs.writeFileSync(path.join(dir, 'omnify.md'), CURSOR_RULES);
 }
 
-function configureClaudeMcp() {
-  const homeDir = os.homedir();
-  const claudeDir = path.join(homeDir, '.claude');
-  const configPath = path.join(claudeDir, 'claude_desktop_config.json');
+function setupClaudeMcp() {
+  const configPath = path.join(os.homedir(), '.claude', 'claude_desktop_config.json');
 
   try {
-    if (!fs.existsSync(claudeDir)) {
-      fs.mkdirSync(claudeDir, { recursive: true });
-    }
+    const dir = path.dirname(configPath);
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
 
     let config = { mcpServers: {} };
-
     if (fs.existsSync(configPath)) {
       try {
-        const content = fs.readFileSync(configPath, 'utf-8');
-        config = JSON.parse(content);
-        if (!config.mcpServers) {
-          config.mcpServers = {};
-        }
-      } catch {
-        config = { mcpServers: {} };
-      }
+        config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+        config.mcpServers = config.mcpServers || {};
+      } catch { /* use default */ }
     }
 
-    if (config.mcpServers.omnify) {
-      console.log('  Omnify MCP already configured');
-      return false;
+    if (!config.mcpServers.omnify) {
+      config.mcpServers.omnify = { command: 'npx', args: ['@famgia/omnify-mcp'] };
+      fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
     }
-
-    config.mcpServers.omnify = MCP_CONFIG.omnify;
-    fs.writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
-    console.log('  Configured Omnify MCP server in ~/.claude/claude_desktop_config.json');
-    return true;
-  } catch (error) {
-    console.log('  Note: Could not auto-configure MCP (optional)');
-    return false;
-  }
+  } catch { /* optional, ignore errors */ }
 }
 
+// ============================================================================
+// Main
+// ============================================================================
+
 function main() {
-  if (process.env.CI || process.env.CONTINUOUS_INTEGRATION) {
-    return;
-  }
+  // Skip in CI
+  if (process.env.CI || process.env.CONTINUOUS_INTEGRATION) return;
 
+  // Skip in monorepo source (but allow examples/)
   const projectDir = process.env.INIT_CWD || process.cwd();
-  if (projectDir.includes('omnify-ts') && !projectDir.includes('omnify-ts/examples')) {
-    return;
-  }
-
-  console.log('\n🔧 Omnify: Setting up Claude Code integration...\n');
+  if (projectDir.includes('omnify-ts') && !projectDir.includes('omnify-ts/examples')) return;
 
   const projectRoot = findProjectRoot();
+  if (!projectRoot) return;
+
+  console.log('\n🔧 Omnify: Setting up AI integration...\n');
+
+  const results = [];
 
-  if (projectRoot) {
-    generateCombinedSchema(projectRoot);
-    copyAiGuidesToProject(projectRoot);
-    createClaudeMd(projectRoot);
-    createCursorRules(projectRoot);
+  if (generateCombinedSchema(projectRoot)) {
+    results.push('✓ Generated combined JSON schema');
   }
 
-  configureClaudeMcp();
+  const guides = copyAiGuides(projectRoot);
+  if (guides.length > 0) {
+    results.push(`✓ Copied ${guides.length} AI guides to .claude/omnify/`);
+  }
+
+  try {
+    setupClaudeMd(projectRoot);
+    results.push('✓ Updated CLAUDE.md');
+  } catch { /* ignore */ }
+
+  try {
+    setupCursorRules(projectRoot);
+    results.push('✓ Updated .cursor/rules/omnify.md');
+  } catch { /* ignore */ }
+
+  setupClaudeMcp();
 
+  for (const r of results) console.log(`  ${r}`);
   console.log('\n✅ Omnify setup complete!\n');
 }