@famgia/omnify-cli 0.0.85 → 0.0.87

package/dist/cli.js

@@ -440,11 +440,14 @@ async function resolveConfig(userConfig, configPath2) {
     migrationsPath: userConfig.output?.laravel?.migrationsPath ?? "database/migrations"
   };
   const laravel = buildLaravelConfig(laravelConfig, userConfig.output?.laravel);
+  const tsConfig = userConfig.output?.typescript;
   const typescript = {
-    path: userConfig.output?.typescript?.path ?? "types",
-    singleFile: userConfig.output?.typescript?.singleFile ?? true,
-    generateEnums: userConfig.output?.typescript?.generateEnums ?? true,
-    generateRelationships: userConfig.output?.typescript?.generateRelationships ?? true
+    path: tsConfig?.path ?? "types",
+    schemasDir: tsConfig?.schemasDir ?? "schemas",
+    enumDir: tsConfig?.enumDir ?? "enum",
+    singleFile: tsConfig?.singleFile ?? true,
+    generateEnums: tsConfig?.generateEnums ?? true,
+    generateRelationships: tsConfig?.generateRelationships ?? true
   };
   const result = {
     schemasDir: userConfig.schemasDir ?? "./schemas",
@@ -676,8 +679,8 @@ function registerDiffCommand(program2) {
 }
 
 // src/commands/generate.ts
-import { existsSync as existsSync4, mkdirSync as mkdirSync3, writeFileSync as writeFileSync3, readdirSync } from "fs";
-import { resolve as resolve6, dirname as dirname4 } from "path";
+import { existsSync as existsSync4, mkdirSync as mkdirSync2, writeFileSync as writeFileSync3, readdirSync } from "fs";
+import { resolve as resolve6, dirname as dirname4, relative } from "path";
 import {
   loadSchemas as loadSchemas3,
   validateSchemas as validateSchemas3,
@@ -701,485 +704,34 @@ import {
   generateFactories,
   getFactoryPath
 } from "@famgia/omnify-laravel";
-import { generateTypeScript } from "@famgia/omnify-typescript";
+import { generateTypeScript, copyStubs, generateAIGuides as generateTypescriptAIGuides, shouldGenerateAIGuides as shouldGenerateTypescriptAIGuides } from "@famgia/omnify-typescript";
 
 // src/guides/index.ts
-import { existsSync as existsSync3, mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "fs";
+import { existsSync as existsSync3, writeFileSync as writeFileSync2 } from "fs";
 import { resolve as resolve5 } from "path";
 var CLAUDE_MD = `## Omnify
 
 This project uses Omnify for schema-driven code generation.
 
 **Documentation**: \`.claude/omnify/\`
-- \`schema-guide.md\` - Schema format and property types
-- \`laravel-guide.md\` - Laravel generator (if installed)
-- \`typescript-guide.md\` - TypeScript generator (if installed)
-- \`japan-guide.md\` - Japan plugin types (if installed)
+- \`guides/omnify/\` - Omnify tool docs (schema syntax, config)
+- \`guides/laravel/\` - Laravel implementation guides
+- \`guides/react/\` - React implementation guides
+- \`checklists/\` - Development checklists
+- \`workflows/\` - Workflow guides
+- \`agents/\` - AI agent prompts
 
 **Commands**:
 - \`npx omnify generate\` - Generate code from schemas
 - \`npx omnify validate\` - Validate schemas
 `;
-var SCHEMA_GUIDE = `# Omnify Schema Guide
-
-## Schema File Format
-
-Schemas are YAML files defining data models. Each file represents one entity.
-
-\`\`\`yaml
-name: User
-displayName:
-  ja: \u30E6\u30FC\u30B6\u30FC
-  en: User
-kind: object
-
-properties:
-  email:
-    type: Email
-    unique: true
-  name:
-    type: String
-  bio:
-    type: Text
-    nullable: true
-
-options:
-  timestamps: true
-  softDelete: true
-\`\`\`
-
-## Property Types
-
-### String Types
-- \`String\` - VARCHAR(255)
-- \`Text\` - TEXT
-- \`LongText\` - LONGTEXT
-- \`Email\` - VARCHAR(255) for email addresses
-- \`Password\` - VARCHAR(255), hidden in serialization
-
-### Numeric Types
-- \`Int\` - INTEGER
-- \`BigInt\` - BIGINT
-- \`TinyInt\` - TINYINT
-- \`Float\` - DOUBLE
-- \`Decimal\` - DECIMAL(precision, scale)
-
-### Date/Time Types
-- \`Date\` - DATE
-- \`Time\` - TIME
-- \`DateTime\` - DATETIME
-- \`Timestamp\` - TIMESTAMP
-
-### Other Types
-- \`Boolean\` - BOOLEAN
-- \`Json\` - JSON
-- \`Enum\` - ENUM with values
-- \`EnumRef\` - Reference to enum schema
-
-## Property Options
-
-\`\`\`yaml
-propertyName:
-  type: String
-  nullable: true       # Can be NULL
-  unique: true         # Unique constraint
-  default: "value"     # Default value
-  length: 100          # VARCHAR length
-  hidden: true         # Hide from JSON output
-  fillable: false      # Exclude from mass assignment
-\`\`\`
-
-## Associations
-
-\`\`\`yaml
-# Many-to-One (belongsTo)
-author:
-  type: Association
-  relation: ManyToOne
-  target: User
-  onDelete: CASCADE
-
-# One-to-Many (hasMany)
-posts:
-  type: Association
-  relation: OneToMany
-  target: Post
-
-# Many-to-Many (belongsToMany)
-tags:
-  type: Association
-  relation: ManyToMany
-  target: Tag
-  joinTable: post_tags
-
-# Polymorphic
-commentable:
-  type: Association
-  relation: MorphTo
-\`\`\`
-
-## Indexes
-
-\`\`\`yaml
-indexes:
-  - columns: [status, published_at]
-  - columns: [email]
-    unique: true
-\`\`\`
-
-## Schema Options
-
-\`\`\`yaml
-options:
-  timestamps: true   # Add created_at, updated_at
-  softDelete: true   # Add deleted_at
-  idType: BigInt     # Primary key type (Int, BigInt, Uuid)
-\`\`\`
-`;
-var LARAVEL_GUIDE = `# Laravel Generator Guide
-
-## Generated Files
-
-### Migrations
-Located in \`database/migrations/omnify/\`
-- Auto-generated from schema changes
-- Handles column additions, modifications, removals
-- Preserves manual migrations outside omnify folder
-
-### Models
-Two-tier model structure:
-- \`app/Models/OmnifyBase/*BaseModel.php\` - Auto-generated, DO NOT EDIT
-- \`app/Models/*.php\` - User models, extend base models, safe to customize
-
-### Factories
-Located in \`database/factories/\`
-- Generated once, safe to customize
-- Uses appropriate Faker methods for each type
-
-## Model Features
-
-### Fillable
-All schema properties are mass-assignable by default.
-Use \`fillable: false\` to exclude.
-
-### Hidden
-Use \`hidden: true\` to exclude from JSON/array output.
-
-\`\`\`yaml
-password:
-  type: Password
-  hidden: true
-\`\`\`
-
-### Casts
-Auto-generated based on property types:
-- \`Boolean\` \u2192 \`'boolean'\`
-- \`Json\` \u2192 \`'array'\`
-- \`Timestamp\` \u2192 \`'datetime'\`
-
-### Relationships
-Generated from Association properties:
-- \`ManyToOne\` \u2192 \`belongsTo()\`
-- \`OneToMany\` \u2192 \`hasMany()\`
-- \`ManyToMany\` \u2192 \`belongsToMany()\`
-- \`MorphTo\` \u2192 \`morphTo()\`
-- \`MorphMany\` \u2192 \`morphMany()\`
-
-## Commands
-
-\`\`\`bash
-# Generate migrations and models
-npx omnify generate
-
-# Force regeneration
-npx omnify generate --force
-
-# Validate schemas
-npx omnify validate
-\`\`\`
-`;
-var TYPESCRIPT_GUIDE = `# TypeScript Generator Guide
-
-## Generated Types
-
-Types are generated in the configured output directory.
-
-### Interface Generation
-
-Each schema generates a TypeScript interface:
-
-\`\`\`typescript
-export interface User {
-  id: number;
-  email: string;
-  name: string;
-  bio: string | null;
-  created_at: string;
-  updated_at: string;
-}
-\`\`\`
-
-### Type Mappings
-
-| Omnify Type | TypeScript Type |
-|-------------|-----------------|
-| String, Text | string |
-| Int, BigInt | number |
-| Float, Decimal | number |
-| Boolean | boolean |
-| Date, DateTime | string |
-| Json | Record<string, unknown> |
-| Enum | union of literals |
-
-### Nullable Types
-
-Nullable properties become \`T | null\`:
-
-\`\`\`typescript
-bio: string | null;
-\`\`\`
-
-### Associations
-
-Associations generate optional relation properties:
-
-\`\`\`typescript
-export interface Post {
-  id: number;
-  title: string;
-  author_id: number;
-  author?: User;       // Optional relation
-  comments?: Comment[]; // Optional array relation
-}
-\`\`\`
-`;
-var JAPAN_GUIDE = `# Japan Plugin Types Guide
-
-This project uses \`@famgia/omnify-japan\` plugin which provides Japan-specific types.
-
-## Available Types
-
-### Simple Types
-
-#### JapanesePhone
-Japanese phone number format (e.g., \`090-1234-5678\`, \`03-1234-5678\`)
-- SQL: \`VARCHAR(15)\`
-- Accepts with or without hyphens
-
-\`\`\`yaml
-phone:
-  type: JapanesePhone
-\`\`\`
-
-#### JapanesePostalCode
-Japanese postal code format (e.g., \`123-4567\`)
-- SQL: \`VARCHAR(8)\`
-- Accepts with or without hyphen
-
-\`\`\`yaml
-postal_code:
-  type: JapanesePostalCode
-  nullable: true
-\`\`\`
-
-### Compound Types
-
-Compound types expand into multiple database columns automatically.
-
-#### JapaneseName
-Japanese name with kanji and kana variants.
-
-**Expands to 4 columns:**
-- \`{property}_lastname\` - VARCHAR(50) - Family name (\u59D3)
-- \`{property}_firstname\` - VARCHAR(50) - Given name (\u540D)
-- \`{property}_kana_lastname\` - VARCHAR(100) - Family name in katakana
-- \`{property}_kana_firstname\` - VARCHAR(100) - Given name in katakana
-
-**Accessors generated:**
-- \`{property}_full_name\` - "\u59D3 \u540D" (space-separated)
-- \`{property}_full_name_kana\` - "\u30BB\u30A4 \u30E1\u30A4" (space-separated)
-
-\`\`\`yaml
-name:
-  type: JapaneseName
-  displayName:
-    ja: \u6C0F\u540D
-    en: Full Name
-  # Per-field overrides
-  fields:
-    KanaLastname:
-      nullable: true
-      hidden: true
-    KanaFirstname:
-      nullable: true
-      hidden: true
-\`\`\`
-
-#### JapaneseAddress
-Japanese address with postal code and prefecture ID.
-
-**Expands to 5 columns:**
-- \`{property}_postal_code\` - VARCHAR(8) - Postal code (\u90F5\u4FBF\u756A\u53F7)
-- \`{property}_prefecture_id\` - TINYINT UNSIGNED - Prefecture ID 1-47 (\u90FD\u9053\u5E9C\u770C)
-- \`{property}_address1\` - VARCHAR(255) - City/Ward (\u5E02\u533A\u753A\u6751)
-- \`{property}_address2\` - VARCHAR(255) - Street address (\u4E01\u76EE\u756A\u5730\u53F7)
-- \`{property}_address3\` - VARCHAR(255) NULLABLE - Building name (\u30D3\u30EB\u30FB\u30DE\u30F3\u30B7\u30E7\u30F3\u540D)
-
-**Accessors generated:**
-- \`{property}_full_address\` - Concatenation of address1 + address2 + address3
-
-\`\`\`yaml
-address:
-  type: JapaneseAddress
-  displayName:
-    ja: \u4F4F\u6240
-    en: Address
-  fields:
-    Address3:
-      nullable: true
-\`\`\`
-
-**Prefecture IDs (JIS X 0401):**
-| ID | Prefecture | ID | Prefecture | ID | Prefecture |
-|----|-----------|----|-----------|----|-----------|
-| 1 | \u5317\u6D77\u9053 | 17 | \u77F3\u5DDD\u770C | 33 | \u5CA1\u5C71\u770C |
-| 2 | \u9752\u68EE\u770C | 18 | \u798F\u4E95\u770C | 34 | \u5E83\u5CF6\u770C |
-| 3 | \u5CA9\u624B\u770C | 19 | \u5C71\u68A8\u770C | 35 | \u5C71\u53E3\u770C |
-| 4 | \u5BAE\u57CE\u770C | 20 | \u9577\u91CE\u770C | 36 | \u5FB3\u5CF6\u770C |
-| 5 | \u79CB\u7530\u770C | 21 | \u5C90\u961C\u770C | 37 | \u9999\u5DDD\u770C |
-| 6 | \u5C71\u5F62\u770C | 22 | \u9759\u5CA1\u770C | 38 | \u611B\u5A9B\u770C |
-| 7 | \u798F\u5CF6\u770C | 23 | \u611B\u77E5\u770C | 39 | \u9AD8\u77E5\u770C |
-| 8 | \u8328\u57CE\u770C | 24 | \u4E09\u91CD\u770C | 40 | \u798F\u5CA1\u770C |
-| 9 | \u6803\u6728\u770C | 25 | \u6ECB\u8CC0\u770C | 41 | \u4F50\u8CC0\u770C |
-| 10 | \u7FA4\u99AC\u770C | 26 | \u4EAC\u90FD\u5E9C | 42 | \u9577\u5D0E\u770C |
-| 11 | \u57FC\u7389\u770C | 27 | \u5927\u962A\u5E9C | 43 | \u718A\u672C\u770C |
-| 12 | \u5343\u8449\u770C | 28 | \u5175\u5EAB\u770C | 44 | \u5927\u5206\u770C |
-| 13 | \u6771\u4EAC\u90FD | 29 | \u5948\u826F\u770C | 45 | \u5BAE\u5D0E\u770C |
-| 14 | \u795E\u5948\u5DDD\u770C | 30 | \u548C\u6B4C\u5C71\u770C | 46 | \u9E7F\u5150\u5CF6\u770C |
-| 15 | \u65B0\u6F5F\u770C | 31 | \u9CE5\u53D6\u770C | 47 | \u6C96\u7E04\u770C |
-| 16 | \u5BCC\u5C71\u770C | 32 | \u5CF6\u6839\u770C | | |
-
-#### JapaneseBankAccount
-Japanese bank account information.
-
-**Expands to 5 columns:**
-- \`{property}_bank_code\` - VARCHAR(4) - Bank code (\u9280\u884C\u30B3\u30FC\u30C9)
-- \`{property}_branch_code\` - VARCHAR(3) - Branch code (\u652F\u5E97\u30B3\u30FC\u30C9)
-- \`{property}_account_type\` - ENUM - Account type: 1=\u666E\u901A, 2=\u5F53\u5EA7, 4=\u8CAF\u84C4
-- \`{property}_account_number\` - VARCHAR(7) - Account number (\u53E3\u5EA7\u756A\u53F7)
-- \`{property}_account_holder\` - VARCHAR(100) - Account holder name (\u53E3\u5EA7\u540D\u7FA9)
-
-\`\`\`yaml
-bank_account:
-  type: JapaneseBankAccount
-\`\`\`
-
-## Per-field Overrides
-
-All compound types support per-field overrides:
-
-\`\`\`yaml
-name:
-  type: JapaneseName
-  fields:
-    Lastname:
-      length: 100        # Override default VARCHAR length
-    Firstname:
-      length: 100
-    KanaLastname:
-      length: 200
-      nullable: true
-      hidden: true
-    KanaFirstname:
-      length: 200
-      nullable: true
-      hidden: true
-\`\`\`
-
-**Available overrides:**
-- \`length\` - VARCHAR length (override default)
-- \`nullable\` - Whether the field can be NULL
-- \`hidden\` - Exclude from JSON/array output
-- \`fillable\` - Control mass assignment
-
-## Factory Examples
-
-\`\`\`php
-$faker = fake('ja_JP');
-
-return [
-    // JapaneseName
-    'name_lastname' => $faker->lastName(),
-    'name_firstname' => $faker->firstName(),
-    'name_kana_lastname' => $faker->lastKanaName(),
-    'name_kana_firstname' => $faker->firstKanaName(),
-
-    // JapanesePhone
-    'phone' => $faker->phoneNumber(),
-
-    // JapanesePostalCode
-    'postal_code' => $faker->postcode(),
-
-    // JapaneseAddress
-    'address_postal_code' => $faker->postcode(),
-    'address_prefecture_id' => $faker->numberBetween(1, 47),
-    'address_address1' => $faker->city(),
-    'address_address2' => $faker->streetAddress(),
-    'address_address3' => $faker->optional(0.5)->secondaryAddress(),
-];
-\`\`\`
-
-## Model Accessors
-
-\`\`\`php
-// JapaneseName accessors
-$customer->name_full_name;      // "\u7530\u4E2D \u592A\u90CE"
-$customer->name_full_name_kana; // "\u30BF\u30CA\u30AB \u30BF\u30ED\u30A6"
-
-// JapaneseAddress accessor
-$customer->address_full_address; // "\u5343\u4EE3\u7530\u533A\u4E38\u306E\u51851-1-1\u30D3\u30EB5F"
-\`\`\`
-`;
-function isJapanPlugin(plugin) {
-  return plugin.name === "@famgia/omnify-japan";
-}
-function isLaravelPlugin(plugin) {
-  return plugin.name === "@famgia/omnify-laravel";
-}
-function isTypeScriptPlugin(plugin) {
-  return plugin.name === "@famgia/omnify-typescript";
-}
-function generateAIGuides(rootDir, plugins) {
-  const guidesDir = resolve5(rootDir, ".claude/omnify");
+function generateAIGuides(rootDir, _plugins) {
   let filesWritten = 0;
-  if (!existsSync3(guidesDir)) {
-    mkdirSync2(guidesDir, { recursive: true });
-  }
   const claudeMdPath = resolve5(rootDir, "CLAUDE.md");
   if (!existsSync3(claudeMdPath)) {
     writeFileSync2(claudeMdPath, CLAUDE_MD);
     filesWritten++;
   }
-  const schemaGuidePath = resolve5(guidesDir, "schema-guide.md");
-  writeFileSync2(schemaGuidePath, SCHEMA_GUIDE);
-  filesWritten++;
-  for (const plugin of plugins) {
-    if (isLaravelPlugin(plugin)) {
-      const laravelGuidePath = resolve5(guidesDir, "laravel-guide.md");
-      writeFileSync2(laravelGuidePath, LARAVEL_GUIDE);
-      filesWritten++;
-    }
-    if (isTypeScriptPlugin(plugin)) {
-      const tsGuidePath = resolve5(guidesDir, "typescript-guide.md");
-      writeFileSync2(tsGuidePath, TYPESCRIPT_GUIDE);
-      filesWritten++;
-    }
-    if (isJapanPlugin(plugin)) {
-      const japanGuidePath = resolve5(guidesDir, "japan-guide.md");
-      writeFileSync2(japanGuidePath, JAPAN_GUIDE);
-      filesWritten++;
-    }
-  }
   return filesWritten;
 }
 
@@ -1385,7 +937,7 @@ function writeGeneratorOutputs(outputs, rootDir) {
     const filePath = resolve6(rootDir, output.path);
     const dir = dirname4(filePath);
     if (!existsSync4(dir)) {
-      mkdirSync3(dir, { recursive: true });
+      mkdirSync2(dir, { recursive: true });
       logger.debug(`Created directory: ${dir}`);
     }
     if (output.skipIfExists && existsSync4(filePath)) {
@@ -1438,11 +990,19 @@ function runDirectGeneration(schemas, config, rootDir, options, changes) {
       }
     }
   }
+  const pluginEnumsMap = /* @__PURE__ */ new Map();
+  for (const plugin of config.plugins) {
+    if (plugin.enums) {
+      for (const enumDef of plugin.enums) {
+        pluginEnumsMap.set(enumDef.name, enumDef);
+      }
+    }
+  }
   if (!options.typesOnly && config.output.laravel) {
     logger.step("Generating Laravel migrations...");
     const migrationsDir = resolve6(rootDir, config.output.laravel.migrationsPath);
     if (!existsSync4(migrationsDir)) {
-      mkdirSync3(migrationsDir, { recursive: true });
+      mkdirSync2(migrationsDir, { recursive: true });
       logger.debug(`Created directory: ${migrationsDir}`);
     }
     const addedSchemaNames = new Set(
@@ -1487,10 +1047,10 @@ function runDirectGeneration(schemas, config, rootDir, options, changes) {
     const modelsDir = resolve6(rootDir, modelsPath);
     const baseModelsDir = resolve6(rootDir, baseModelsPath);
     if (!existsSync4(modelsDir)) {
-      mkdirSync3(modelsDir, { recursive: true });
+      mkdirSync2(modelsDir, { recursive: true });
     }
     if (!existsSync4(baseModelsDir)) {
-      mkdirSync3(baseModelsDir, { recursive: true });
+      mkdirSync2(baseModelsDir, { recursive: true });
     }
     const providersPath = config.output.laravel.providersPath ?? "app/Providers";
     const models = generateModels(schemas, {
@@ -1503,7 +1063,7 @@ function runDirectGeneration(schemas, config, rootDir, options, changes) {
       const filePath = resolve6(rootDir, getModelPath(model));
       const fileDir = dirname4(filePath);
       if (!existsSync4(fileDir)) {
-        mkdirSync3(fileDir, { recursive: true });
+        mkdirSync2(fileDir, { recursive: true });
       }
       if (!model.overwrite && existsSync4(filePath)) {
         logger.debug(`Skipped (exists): ${getModelPath(model)}`);
@@ -1520,7 +1080,7 @@ function runDirectGeneration(schemas, config, rootDir, options, changes) {
     const factoriesPath = config.output.laravel.factoriesPath;
     const factoriesDir = resolve6(rootDir, factoriesPath);
     if (!existsSync4(factoriesDir)) {
-      mkdirSync3(factoriesDir, { recursive: true });
+      mkdirSync2(factoriesDir, { recursive: true });
     }
     const factories = generateFactories(schemas, {
       factoryPath: factoriesPath
@@ -1529,7 +1089,7 @@ function runDirectGeneration(schemas, config, rootDir, options, changes) {
       const filePath = resolve6(rootDir, getFactoryPath(factory));
       const fileDir = dirname4(filePath);
       if (!existsSync4(fileDir)) {
-        mkdirSync3(fileDir, { recursive: true });
+        mkdirSync2(fileDir, { recursive: true });
       }
       if (!factory.overwrite && existsSync4(filePath)) {
         logger.debug(`Skipped (exists): ${getFactoryPath(factory)}`);
@@ -1543,25 +1103,35 @@ function runDirectGeneration(schemas, config, rootDir, options, changes) {
   }
   if (!options.migrationsOnly && config.output.typescript) {
     logger.step("Generating TypeScript types...");
-    const typesDir = resolve6(rootDir, config.output.typescript.path);
-    if (!existsSync4(typesDir)) {
-      mkdirSync3(typesDir, { recursive: true });
-      logger.debug(`Created directory: ${typesDir}`);
+    const tsConfig = config.output.typescript;
+    const basePath = resolve6(rootDir, tsConfig.path);
+    const schemasDir = resolve6(basePath, tsConfig.schemasDir ?? "schemas");
+    const enumDir = resolve6(basePath, tsConfig.enumDir ?? "enum");
+    const enumImportPrefix = relative(schemasDir, enumDir).replace(/\\/g, "/");
+    if (!existsSync4(schemasDir)) {
+      mkdirSync2(schemasDir, { recursive: true });
+      logger.debug(`Created directory: ${schemasDir}`);
+    }
+    if (!existsSync4(enumDir)) {
+      mkdirSync2(enumDir, { recursive: true });
+      logger.debug(`Created directory: ${enumDir}`);
     }
     const isMultiLocale = config.locale && config.locale.locales && config.locale.locales.length > 1;
-    const typescriptConfig = config.output.typescript;
     const typeFiles = generateTypeScript(schemas, {
       customTypes: customTypesMap,
+      pluginEnums: pluginEnumsMap,
       localeConfig: config.locale,
       multiLocale: isMultiLocale,
-      generateRules: typescriptConfig.generateRules ?? true,
-      validationTemplates: typescriptConfig.validationTemplates
+      generateRules: tsConfig.generateRules ?? true,
+      validationTemplates: tsConfig.validationTemplates,
+      enumImportPrefix
     });
     for (const file of typeFiles) {
-      const filePath = resolve6(typesDir, file.filePath);
+      const outputDir = file.category === "enum" ? enumDir : schemasDir;
+      const filePath = resolve6(outputDir, file.filePath);
       const fileDir = dirname4(filePath);
       if (!existsSync4(fileDir)) {
-        mkdirSync3(fileDir, { recursive: true });
+        mkdirSync2(fileDir, { recursive: true });
       }
       if (!file.overwrite && existsSync4(filePath)) {
         logger.debug(`Skipped (exists): ${file.filePath}`);
@@ -1572,6 +1142,13 @@ function runDirectGeneration(schemas, config, rootDir, options, changes) {
       typesGenerated++;
     }
     logger.success(`Generated ${typesGenerated} TypeScript file(s)`);
+    const stubsResult = copyStubs({
+      targetDir: basePath,
+      skipIfExists: true
+    });
+    if (stubsResult.copied.length > 0) {
+      logger.success(`Generated ${stubsResult.copied.length} React stub(s)`);
+    }
   }
   return { migrations: migrationsGenerated, types: typesGenerated, models: modelsGenerated, factories: factoriesGenerated };
 }
@@ -1618,7 +1195,9 @@ async function runGenerate(options) {
   const v2Lock = existingLock && isLockFileV2(existingLock) ? existingLock : null;
   const comparison = compareSchemasDeep(currentSnapshots, v2Lock);
   const skipMigrations = !comparison.hasChanges && !options.force;
-  if (skipMigrations && !config.output.laravel?.modelsPath) {
+  const pluginsHaveGenerators = config.plugins.some((p) => p.generators && p.generators.length > 0);
+  const hasTypescriptOutput = !!config.output.typescript;
+  if (skipMigrations && !config.output.laravel?.modelsPath && !pluginsHaveGenerators && !hasTypescriptOutput) {
     logger.success("No changes to generate");
     return;
   }
@@ -1641,6 +1220,14 @@ async function runGenerate(options) {
       }
     }
   }
+  const pluginEnumsMap = /* @__PURE__ */ new Map();
+  for (const plugin of config.plugins) {
+    if (plugin.enums) {
+      for (const enumDef of plugin.enums) {
+        pluginEnumsMap.set(enumDef.name, enumDef);
+      }
+    }
+  }
   if (usePlugins) {
     logger.step("Running plugin generators...");
     const counts = await runPluginGeneration(
@@ -1669,25 +1256,35 @@ async function runGenerate(options) {
     }
     if (!options.migrationsOnly && config.output.typescript && typesGenerated === 0) {
       logger.step("Generating TypeScript types...");
-      const typesDir = resolve6(rootDir, config.output.typescript.path);
-      if (!existsSync4(typesDir)) {
-        mkdirSync3(typesDir, { recursive: true });
-        logger.debug(`Created directory: ${typesDir}`);
+      const tsConfig2 = config.output.typescript;
+      const basePath2 = resolve6(rootDir, tsConfig2.path);
+      const schemasDir2 = resolve6(basePath2, tsConfig2.schemasDir ?? "schemas");
+      const enumDir2 = resolve6(basePath2, tsConfig2.enumDir ?? "enum");
+      const enumImportPrefix2 = relative(schemasDir2, enumDir2).replace(/\\/g, "/");
+      if (!existsSync4(schemasDir2)) {
+        mkdirSync2(schemasDir2, { recursive: true });
+        logger.debug(`Created directory: ${schemasDir2}`);
+      }
+      if (!existsSync4(enumDir2)) {
+        mkdirSync2(enumDir2, { recursive: true });
+        logger.debug(`Created directory: ${enumDir2}`);
       }
       const isMultiLocale = config.locale && config.locale.locales && config.locale.locales.length > 1;
-      const typescriptConfig = config.output.typescript;
       const typeFiles = generateTypeScript(schemas, {
         customTypes: customTypesMap,
+        pluginEnums: pluginEnumsMap,
         localeConfig: config.locale,
         multiLocale: isMultiLocale,
-        generateRules: typescriptConfig.generateRules ?? true,
-        validationTemplates: typescriptConfig.validationTemplates
+        generateRules: tsConfig2.generateRules ?? true,
+        validationTemplates: tsConfig2.validationTemplates,
+        enumImportPrefix: enumImportPrefix2
       });
       for (const file of typeFiles) {
-        const filePath = resolve6(typesDir, file.filePath);
+        const outputDir2 = file.category === "enum" ? enumDir2 : schemasDir2;
+        const filePath = resolve6(outputDir2, file.filePath);
         const fileDir = dirname4(filePath);
         if (!existsSync4(fileDir)) {
-          mkdirSync3(fileDir, { recursive: true });
+          mkdirSync2(fileDir, { recursive: true });
         }
         if (!file.overwrite && existsSync4(filePath)) {
           logger.debug(`Skipped (exists): ${file.filePath}`);
@@ -1698,6 +1295,22 @@ async function runGenerate(options) {
         typesGenerated++;
       }
       logger.success(`Generated ${typesGenerated} TypeScript file(s)`);
+      const stubsResult2 = copyStubs({
+        targetDir: basePath2,
+        skipIfExists: true
+      });
+      if (stubsResult2.copied.length > 0) {
+        logger.success(`Generated ${stubsResult2.copied.length} React stub(s)`);
+      }
+      if (shouldGenerateTypescriptAIGuides(rootDir)) {
+        const tsAIResult = generateTypescriptAIGuides(rootDir, {
+          typescriptPath: tsConfig2.path
+        });
+        const tsClaudeTotal = tsAIResult.claudeGuides + tsAIResult.claudeChecklists;
+        if (tsClaudeTotal > 0 || tsAIResult.cursorRules > 0) {
+          logger.debug(`Generated ${tsClaudeTotal} React Claude files, ${tsAIResult.cursorRules} Cursor rules`);
+        }
+      }
     }
   } else {
     const counts = runDirectGeneration(schemas, config, rootDir, options, comparison.changes);
@@ -1882,6 +1495,8 @@ async function runReset(options) {
   const typescriptPath = config.output.typescript?.path;
   const tsBasePath = typescriptPath ? resolve7(rootDir, typescriptPath) : null;
   const commonTsPaths = [
+    "resources/ts/omnify",
+    "resources/ts/omnify/schemas",
     "resources/ts/types/models",
     "frontend/src/types/model",
     "frontend/src/types/models",
@@ -1898,14 +1513,14 @@ async function runReset(options) {
     }
   }
   if (foundTsPath && existsSync5(foundTsPath)) {
-    const autoGeneratedDirs = ["base", "enum", "rules"];
+    const autoGeneratedDirs = ["base", "enum", "rules", "hooks", "lib"];
     for (const subDir of autoGeneratedDirs) {
       const subPath = join(foundTsPath, subDir);
       if (existsSync5(subPath)) {
         paths.push({ name: `TypeScript ${subDir}`, path: subPath, type: "dir" });
       }
     }
-    const autoGeneratedFiles = ["common.ts", "index.ts"];
+    const autoGeneratedFiles = ["common.ts", "index.ts", "i18n.ts"];
     for (const fileName of autoGeneratedFiles) {
       const filePath = join(foundTsPath, fileName);
       if (existsSync5(filePath)) {