@famgia/omnify-types 0.0.77 → 0.0.78

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/i18n.ts"],"sourcesContent":["/**\n * @famgia/omnify-types\n * Core type definitions for omnify-schema\n *\n * This package provides shared TypeScript interfaces and types\n * used across all omnify packages.\n */\n\n// ============================================================================\n// Schema Types\n// ============================================================================\n\nexport type {\n  // Property types\n  BuiltInPropertyType,\n  PropertyType,\n  // Association types\n  AssociationRelation,\n  ReferentialAction,\n  PivotFieldDefinition,\n  AssociationDefinition,\n  // Validation rules\n  ValidationRules,\n  // Property definitions\n  BasePropertyDefinition,\n  CompoundFieldOverride,\n  StringPropertyDefinition,\n  NumericPropertyDefinition,\n  EnumPropertyDefinition,\n  EnumRefPropertyDefinition,\n  FilePropertyDefinition,\n  InlineEnumValue,\n  PropertyDefinition,\n  // Schema options\n  IdType,\n  IndexType,\n  IndexDefinition,\n  SchemaOptions,\n  // Schema definitions\n  SchemaKind,\n  SchemaDefinition,\n  LoadedSchema,\n  SchemaCollection,\n} from './schema.js';\n\n// ============================================================================\n// Configuration Types\n// ============================================================================\n\nexport type {\n  // Database config\n  DatabaseDriver,\n  DatabaseConfig,\n  // Output config\n  LaravelOutputConfig,\n  TypeScriptOutputConfig,\n  OutputConfig,\n  // Main config\n  OmnifyConfig,\n  ResolvedOmnifyConfig,\n} from './config.js';\n\n// ============================================================================\n// Plugin Types\n// ============================================================================\n\nexport type {\n  // Type definitions\n  SqlColumnDefinition,\n  TypeScriptTypeInfo,\n  ExpandedFieldDefinition,\n  CompoundTypeAccessor,\n  CustomTypeDefinition,\n  // Plugin interface\n  PluginContext,\n  PluginLogger,\n  OmnifyPlugin,\n  PluginFactory,\n  PluginEnumDefinition,\n  PluginEnumValue,\n  // Generator types\n  GeneratorOutputType,\n  GeneratorOutput,\n  GeneratorContext,\n  GeneratorDefinition,\n  // Schema change types\n  PropertySnapshot,\n  IndexSnapshot,\n  SchemaChangeType,\n  ColumnChange,\n  IndexChange,\n  SchemaChange,\n  // Plugin config schema (WordPress-like)\n  PluginConfigFieldType,\n  PluginConfigSelectOption,\n  PluginConfigField,\n  PluginConfigSchema,\n} from './plugin.js';\n\n// ============================================================================\n// Error Types\n// ============================================================================\n\nexport type {\n  ErrorCode,\n  ErrorLocation,\n  OmnifyErrorInfo,\n  Result,\n} from './errors.js';\n\nexport { ok, err } from './errors.js';\n\n// ============================================================================\n// Internationalization (i18n) Types\n// ============================================================================\n\nexport type {\n  LocaleCode,\n  LocaleMap,\n  LocalizedString,\n  LocaleConfig,\n  LocaleResolutionOptions,\n} from './i18n.js';\n\nexport {\n  DEFAULT_LOCALE_CONFIG,\n  isLocaleMap,\n  isLocalizedString,\n  resolveLocalizedString,\n  getAvailableLocales,\n  toLocaleMap,\n  mergeLocalizedStrings,\n} from './i18n.js';\n","/**\n * @famgia/omnify-types - Error Types\n *\n * Type definitions for omnify error handling.\n * Errors follow the format: file:line + message + suggestion\n */\n\n// ============================================================================\n// Error Codes\n// ============================================================================\n\n/**\n * Error code categories:\n * - E0xx: Configuration errors\n * - E1xx: Schema parsing errors\n * - E2xx: Schema validation errors\n * - E3xx: Plugin errors\n * - E4xx: Atlas/Database errors\n * - E5xx: Generation errors\n * - E9xx: Internal errors\n */\nexport type ErrorCode =\n  // Configuration errors (E0xx)\n  | 'E001' // Config file not found\n  | 'E002' // Invalid config format\n  | 'E003' // Missing required config field\n  | 'E004' // Invalid database driver\n  | 'E005' // Invalid output path\n  // Schema parsing errors (E1xx)\n  | 'E101' // Schema file not found\n  | 'E102' // Invalid YAML syntax\n  | 'E103' // Invalid JSON syntax\n  | 'E104' // Empty schema file\n  | 'E105' // Schema read error\n  // Schema validation errors (E2xx)\n  | 'E201' // Invalid property type\n  | 'E202' // Missing required field\n  | 'E203' // Invalid association target\n  | 'E204' // Circular reference detected\n  | 'E205' // Duplicate schema name\n  | 'E206' // Invalid schema options\n  | 'E207' // Invalid enum values\n  | 'E208' // Orphaned inverse relation\n  // Plugin errors (E3xx)\n  | 'E301' // Plugin not found\n  | 'E302' // Plugin load error\n  | 'E303' // Invalid plugin format\n  | 'E304' // Plugin type conflict\n  | 'E305' // Plugin setup error\n  // Atlas/Database errors (E4xx)\n  | 'E401' // Atlas CLI not found\n  | 'E402' // Atlas diff failed\n  | 'E403' // Database connection error\n  | 'E404' // HCL generation error\n  | 'E405' // Lock file error\n  // Generation errors (E5xx)\n  | 'E501' // Migration generation failed\n  | 'E502' // TypeScript generation failed\n  | 'E503' // Output write error\n  | 'E504' // Template error\n  // Internal errors (E9xx)\n  | 'E901' // Unexpected error\n  | 'E902'; // Not implemented\n\n// ============================================================================\n// Error Info\n// ============================================================================\n\n/**\n * Source location where an error occurred.\n */\nexport interface ErrorLocation {\n  /** File path where the error occurred */\n  readonly file?: string;\n  /** Line number (1-based) */\n  readonly line?: number;\n  /** Column number (1-based) */\n  readonly column?: number;\n}\n\n/**\n * Structured error information for omnify errors.\n */\nexport interface OmnifyErrorInfo {\n  /** Error code (e.g., 'E201') */\n  readonly code: ErrorCode;\n  /** Human-readable error message */\n  readonly message: string;\n  /** Location where the error occurred */\n  readonly location?: ErrorLocation;\n  /** Suggested fix for the error */\n  readonly suggestion?: string;\n  /** Additional context or details */\n  readonly details?: Record<string, unknown>;\n  /** Original error if this wraps another error */\n  readonly cause?: Error;\n}\n\n/**\n * Result type for operations that may fail.\n */\nexport type Result<T, E = OmnifyErrorInfo> =\n  | { readonly ok: true; readonly value: T }\n  | { readonly ok: false; readonly error: E };\n\n/**\n * Helper to create a successful result.\n */\nexport function ok<T>(value: T): Result<T, never> {\n  return { ok: true, value };\n}\n\n/**\n * Helper to create an error result.\n */\nexport function err<E>(error: E): Result<never, E> {\n  return { ok: false, error };\n}\n","/**\n * @famgia/omnify-types - Internationalization (i18n) Types\n *\n * Types for multi-language support in schema definitions.\n * Supports displayName, description, and other localizable strings.\n */\n\n// ============================================================================\n// Locale Types\n// ============================================================================\n\n/**\n * Supported locale code format (ISO 639-1 language codes).\n * Examples: 'en', 'ja', 'vi', 'zh', 'ko', 'fr', 'de', 'es', 'pt'\n */\nexport type LocaleCode = string;\n\n/**\n * Map of locale codes to localized strings.\n * @example { en: 'User Name', ja: 'ユーザー名', vi: 'Tên người dùng' }\n */\nexport type LocaleMap = Readonly<Record<LocaleCode, string>>;\n\n/**\n * Localized string - can be either a simple string (default locale)\n * or a map of locale codes to localized strings.\n *\n * @example\n * // Simple string (uses default locale)\n * displayName: \"User Name\"\n *\n * // Multi-language object\n * displayName:\n *   en: \"User Name\"\n *   ja: \"ユーザー名\"\n *   vi: \"Tên người dùng\"\n */\nexport type LocalizedString = string | LocaleMap;\n\n// ============================================================================\n// Locale Configuration\n// ============================================================================\n\n/**\n * Locale configuration for omnify projects.\n * Configured in .omnify.yaml or omnify.config.ts\n */\nexport interface LocaleConfig {\n  /**\n   * List of supported locale codes.\n   * @default ['en']\n   * @example ['en', 'ja', 'vi']\n   */\n  readonly locales: readonly LocaleCode[];\n\n  /**\n   * Default locale code used when:\n   * - displayName is a simple string\n   * - Requested locale is not found and no fallback matches\n   * @default 'en'\n   */\n  readonly defaultLocale: LocaleCode;\n\n  /**\n   * Fallback locale code used when requested locale is not found.\n   * If not set, falls back to defaultLocale.\n   * @example 'en' - If 'ko' not found, try 'en' before defaultLocale\n   */\n  readonly fallbackLocale?: LocaleCode;\n}\n\n/**\n * Default locale configuration.\n */\nexport const DEFAULT_LOCALE_CONFIG: LocaleConfig = {\n  locales: ['en'],\n  defaultLocale: 'en',\n};\n\n// ============================================================================\n// Resolution Options\n// ============================================================================\n\n/**\n * Options for resolving localized strings.\n */\nexport interface LocaleResolutionOptions {\n  /**\n   * Locale to resolve to.\n   * If not provided, uses defaultLocale from config.\n   */\n  readonly locale?: LocaleCode;\n\n  /**\n   * Locale configuration.\n   * If not provided, uses DEFAULT_LOCALE_CONFIG.\n   */\n  readonly config?: LocaleConfig;\n\n  /**\n   * Whether to throw an error if locale is not found.\n   * If false, returns undefined for missing locales.\n   * @default false\n   */\n  readonly strict?: boolean;\n}\n\n// ============================================================================\n// Utility Type Guards\n// ============================================================================\n\n/**\n * Check if a value is a LocaleMap (object with locale keys).\n */\nexport function isLocaleMap(value: unknown): value is LocaleMap {\n  if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n    return false;\n  }\n  // Check that all values are strings\n  return Object.values(value).every(v => typeof v === 'string');\n}\n\n/**\n * Check if a value is a LocalizedString.\n */\nexport function isLocalizedString(value: unknown): value is LocalizedString {\n  return typeof value === 'string' || isLocaleMap(value);\n}\n\n// ============================================================================\n// Resolution Functions\n// ============================================================================\n\n/**\n * Resolve a localized string to a specific locale.\n *\n * Resolution order:\n * 1. Requested locale (if provided)\n * 2. Fallback locale (if configured)\n * 3. Default locale\n * 4. First available locale (if none of the above match)\n * 5. undefined (if strict=false) or throws error (if strict=true)\n *\n * @param value - The localized string value\n * @param options - Resolution options\n * @returns The resolved string or undefined\n *\n * @example\n * // Simple string\n * resolveLocalizedString('Hello') // => 'Hello'\n *\n * // Multi-language with locale\n * resolveLocalizedString({ en: 'Hello', ja: 'こんにちは' }, { locale: 'ja' })\n * // => 'こんにちは'\n *\n * // Multi-language with fallback\n * resolveLocalizedString({ en: 'Hello', ja: 'こんにちは' }, { locale: 'ko' })\n * // => 'Hello' (falls back to defaultLocale)\n */\nexport function resolveLocalizedString(\n  value: LocalizedString | undefined | null,\n  options: LocaleResolutionOptions = {}\n): string | undefined {\n  if (value === undefined || value === null) {\n    return undefined;\n  }\n\n  // Simple string - return as-is\n  if (typeof value === 'string') {\n    return value;\n  }\n\n  const config = options.config ?? DEFAULT_LOCALE_CONFIG;\n  const requestedLocale = options.locale ?? config.defaultLocale;\n\n  // Try requested locale\n  if (requestedLocale in value) {\n    return value[requestedLocale];\n  }\n\n  // Try fallback locale\n  if (config.fallbackLocale && config.fallbackLocale in value) {\n    return value[config.fallbackLocale];\n  }\n\n  // Try default locale\n  if (config.defaultLocale in value) {\n    return value[config.defaultLocale];\n  }\n\n  // Try first available locale\n  const availableLocales = Object.keys(value);\n  const firstLocale = availableLocales[0];\n  if (firstLocale !== undefined) {\n    return value[firstLocale];\n  }\n\n  // No locale found\n  if (options.strict) {\n    throw new Error(\n      `Locale '${requestedLocale}' not found in localized string. ` +\n      `Available locales: none`\n    );\n  }\n\n  return undefined;\n}\n\n/**\n * Get all available locales from a localized string.\n *\n * @param value - The localized string value\n * @returns Array of available locale codes, or ['default'] for simple strings\n */\nexport function getAvailableLocales(\n  value: LocalizedString | undefined | null\n): readonly LocaleCode[] {\n  if (value === undefined || value === null) {\n    return [];\n  }\n\n  if (typeof value === 'string') {\n    return ['default'];\n  }\n\n  return Object.keys(value);\n}\n\n/**\n * Convert a localized string to a full LocaleMap.\n * Simple strings are converted to { [defaultLocale]: value }.\n *\n * @param value - The localized string value\n * @param defaultLocale - Default locale for simple strings\n * @returns LocaleMap or undefined\n */\nexport function toLocaleMap(\n  value: LocalizedString | undefined | null,\n  defaultLocale: LocaleCode = 'en'\n): LocaleMap | undefined {\n  if (value === undefined || value === null) {\n    return undefined;\n  }\n\n  if (typeof value === 'string') {\n    return { [defaultLocale]: value };\n  }\n\n  return value;\n}\n\n/**\n * Merge two localized strings, with the second taking precedence.\n *\n * @param base - Base localized string\n * @param override - Override localized string\n * @param defaultLocale - Default locale for simple strings\n * @returns Merged LocaleMap\n */\nexport function mergeLocalizedStrings(\n  base: LocalizedString | undefined | null,\n  override: LocalizedString | undefined | null,\n  defaultLocale: LocaleCode = 'en'\n): LocaleMap | undefined {\n  const baseMap = toLocaleMap(base, defaultLocale);\n  const overrideMap = toLocaleMap(override, defaultLocale);\n\n  if (!baseMap && !overrideMap) {\n    return undefined;\n  }\n\n  return {\n    ...baseMap,\n    ...overrideMap,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC4GO,SAAS,GAAM,OAA4B;AAChD,SAAO,EAAE,IAAI,MAAM,MAAM;AAC3B;AAKO,SAAS,IAAO,OAA4B;AACjD,SAAO,EAAE,IAAI,OAAO,MAAM;AAC5B;;;AC3CO,IAAM,wBAAsC;AAAA,EACjD,SAAS,CAAC,IAAI;AAAA,EACd,eAAe;AACjB;AAqCO,SAAS,YAAY,OAAoC;AAC9D,MAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,GAAG;AACvE,WAAO;AAAA,EACT;AAEA,SAAO,OAAO,OAAO,KAAK,EAAE,MAAM,OAAK,OAAO,MAAM,QAAQ;AAC9D;AAKO,SAAS,kBAAkB,OAA0C;AAC1E,SAAO,OAAO,UAAU,YAAY,YAAY,KAAK;AACvD;AAgCO,SAAS,uBACd,OACA,UAAmC,CAAC,GAChB;AACpB,MAAI,UAAU,UAAa,UAAU,MAAM;AACzC,WAAO;AAAA,EACT;AAGA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO;AAAA,EACT;AAEA,QAAM,SAAS,QAAQ,UAAU;AACjC,QAAM,kBAAkB,QAAQ,UAAU,OAAO;AAGjD,MAAI,mBAAmB,OAAO;AAC5B,WAAO,MAAM,eAAe;AAAA,EAC9B;AAGA,MAAI,OAAO,kBAAkB,OAAO,kBAAkB,OAAO;AAC3D,WAAO,MAAM,OAAO,cAAc;AAAA,EACpC;AAGA,MAAI,OAAO,iBAAiB,OAAO;AACjC,WAAO,MAAM,OAAO,aAAa;AAAA,EACnC;AAGA,QAAM,mBAAmB,OAAO,KAAK,KAAK;AAC1C,QAAM,cAAc,iBAAiB,CAAC;AACtC,MAAI,gBAAgB,QAAW;AAC7B,WAAO,MAAM,WAAW;AAAA,EAC1B;AAGA,MAAI,QAAQ,QAAQ;AAClB,UAAM,IAAI;AAAA,MACR,WAAW,eAAe;AAAA,IAE5B;AAAA,EACF;AAEA,SAAO;AACT;AAQO,SAAS,oBACd,OACuB;AACvB,MAAI,UAAU,UAAa,UAAU,MAAM;AACzC,WAAO,CAAC;AAAA,EACV;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,CAAC,SAAS;AAAA,EACnB;AAEA,SAAO,OAAO,KAAK,KAAK;AAC1B;AAUO,SAAS,YACd,OACA,gBAA4B,MACL;AACvB,MAAI,UAAU,UAAa,UAAU,MAAM;AACzC,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,EAAE,CAAC,aAAa,GAAG,MAAM;AAAA,EAClC;AAEA,SAAO;AACT;AAUO,SAAS,sBACd,MACA,UACA,gBAA4B,MACL;AACvB,QAAM,UAAU,YAAY,MAAM,aAAa;AAC/C,QAAM,cAAc,YAAY,UAAU,aAAa;AAEvD,MAAI,CAAC,WAAW,CAAC,aAAa;AAC5B,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,GAAG;AAAA,IACH,GAAG;AAAA,EACL;AACF;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/i18n.ts"],"sourcesContent":["/**\n * @famgia/omnify-types\n * Core type definitions for omnify-schema\n *\n * This package provides shared TypeScript interfaces and types\n * used across all omnify packages.\n */\n\n// ============================================================================\n// Schema Types\n// ============================================================================\n\nexport type {\n  // Property types\n  BuiltInPropertyType,\n  PropertyType,\n  // Association types\n  AssociationRelation,\n  ReferentialAction,\n  PivotFieldDefinition,\n  AssociationDefinition,\n  // Validation rules\n  ValidationRules,\n  // Property definitions\n  BasePropertyDefinition,\n  CompoundFieldOverride,\n  StringPropertyDefinition,\n  NumericPropertyDefinition,\n  EnumPropertyDefinition,\n  EnumRefPropertyDefinition,\n  FilePropertyDefinition,\n  InlineEnumValue,\n  PropertyDefinition,\n  // Schema options\n  IdType,\n  IndexType,\n  IndexDefinition,\n  SchemaOptions,\n  // Schema definitions\n  SchemaKind,\n  SchemaDefinition,\n  LoadedSchema,\n  SchemaCollection,\n} from './schema.js';\n\n// ============================================================================\n// Configuration Types\n// ============================================================================\n\nexport type {\n  // Database config\n  DatabaseDriver,\n  DatabaseConfig,\n  // Output config\n  LaravelOutputConfig,\n  TypeScriptOutputConfig,\n  OutputConfig,\n  // Main config\n  OmnifyConfig,\n  ResolvedOmnifyConfig,\n} from './config.js';\n\n// ============================================================================\n// Plugin Types\n// ============================================================================\n\nexport type {\n  // Type definitions\n  SqlColumnDefinition,\n  TypeScriptTypeInfo,\n  FieldValidationRules,\n  ExpandedFieldDefinition,\n  CompoundTypeAccessor,\n  CustomTypeDefinition,\n  // Plugin interface\n  PluginContext,\n  PluginLogger,\n  OmnifyPlugin,\n  PluginFactory,\n  PluginEnumDefinition,\n  PluginEnumValue,\n  // Generator types\n  GeneratorOutputType,\n  GeneratorOutput,\n  GeneratorContext,\n  GeneratorDefinition,\n  // Schema change types\n  PropertySnapshot,\n  IndexSnapshot,\n  SchemaChangeType,\n  ColumnChange,\n  IndexChange,\n  SchemaChange,\n  // Plugin config schema (WordPress-like)\n  PluginConfigFieldType,\n  PluginConfigSelectOption,\n  PluginConfigField,\n  PluginConfigSchema,\n} from './plugin.js';\n\n// ============================================================================\n// Error Types\n// ============================================================================\n\nexport type {\n  ErrorCode,\n  ErrorLocation,\n  OmnifyErrorInfo,\n  Result,\n} from './errors.js';\n\nexport { ok, err } from './errors.js';\n\n// ============================================================================\n// Internationalization (i18n) Types\n// ============================================================================\n\nexport type {\n  LocaleCode,\n  LocaleMap,\n  LocalizedString,\n  ValidationMessages,\n  LocaleConfig,\n  LocaleResolutionOptions,\n} from './i18n.js';\n\nexport {\n  DEFAULT_LOCALE_CONFIG,\n  isLocaleMap,\n  isLocalizedString,\n  resolveLocalizedString,\n  getAvailableLocales,\n  toLocaleMap,\n  mergeLocalizedStrings,\n} from './i18n.js';\n","/**\n * @famgia/omnify-types - Error Types\n *\n * Type definitions for omnify error handling.\n * Errors follow the format: file:line + message + suggestion\n */\n\n// ============================================================================\n// Error Codes\n// ============================================================================\n\n/**\n * Error code categories:\n * - E0xx: Configuration errors\n * - E1xx: Schema parsing errors\n * - E2xx: Schema validation errors\n * - E3xx: Plugin errors\n * - E4xx: Atlas/Database errors\n * - E5xx: Generation errors\n * - E9xx: Internal errors\n */\nexport type ErrorCode =\n  // Configuration errors (E0xx)\n  | 'E001' // Config file not found\n  | 'E002' // Invalid config format\n  | 'E003' // Missing required config field\n  | 'E004' // Invalid database driver\n  | 'E005' // Invalid output path\n  // Schema parsing errors (E1xx)\n  | 'E101' // Schema file not found\n  | 'E102' // Invalid YAML syntax\n  | 'E103' // Invalid JSON syntax\n  | 'E104' // Empty schema file\n  | 'E105' // Schema read error\n  // Schema validation errors (E2xx)\n  | 'E201' // Invalid property type\n  | 'E202' // Missing required field\n  | 'E203' // Invalid association target\n  | 'E204' // Circular reference detected\n  | 'E205' // Duplicate schema name\n  | 'E206' // Invalid schema options\n  | 'E207' // Invalid enum values\n  | 'E208' // Orphaned inverse relation\n  // Plugin errors (E3xx)\n  | 'E301' // Plugin not found\n  | 'E302' // Plugin load error\n  | 'E303' // Invalid plugin format\n  | 'E304' // Plugin type conflict\n  | 'E305' // Plugin setup error\n  // Atlas/Database errors (E4xx)\n  | 'E401' // Atlas CLI not found\n  | 'E402' // Atlas diff failed\n  | 'E403' // Database connection error\n  | 'E404' // HCL generation error\n  | 'E405' // Lock file error\n  // Generation errors (E5xx)\n  | 'E501' // Migration generation failed\n  | 'E502' // TypeScript generation failed\n  | 'E503' // Output write error\n  | 'E504' // Template error\n  // Internal errors (E9xx)\n  | 'E901' // Unexpected error\n  | 'E902'; // Not implemented\n\n// ============================================================================\n// Error Info\n// ============================================================================\n\n/**\n * Source location where an error occurred.\n */\nexport interface ErrorLocation {\n  /** File path where the error occurred */\n  readonly file?: string;\n  /** Line number (1-based) */\n  readonly line?: number;\n  /** Column number (1-based) */\n  readonly column?: number;\n}\n\n/**\n * Structured error information for omnify errors.\n */\nexport interface OmnifyErrorInfo {\n  /** Error code (e.g., 'E201') */\n  readonly code: ErrorCode;\n  /** Human-readable error message */\n  readonly message: string;\n  /** Location where the error occurred */\n  readonly location?: ErrorLocation;\n  /** Suggested fix for the error */\n  readonly suggestion?: string;\n  /** Additional context or details */\n  readonly details?: Record<string, unknown>;\n  /** Original error if this wraps another error */\n  readonly cause?: Error;\n}\n\n/**\n * Result type for operations that may fail.\n */\nexport type Result<T, E = OmnifyErrorInfo> =\n  | { readonly ok: true; readonly value: T }\n  | { readonly ok: false; readonly error: E };\n\n/**\n * Helper to create a successful result.\n */\nexport function ok<T>(value: T): Result<T, never> {\n  return { ok: true, value };\n}\n\n/**\n * Helper to create an error result.\n */\nexport function err<E>(error: E): Result<never, E> {\n  return { ok: false, error };\n}\n","/**\n * @famgia/omnify-types - Internationalization (i18n) Types\n *\n * Types for multi-language support in schema definitions.\n * Supports displayName, description, and other localizable strings.\n */\n\n// ============================================================================\n// Locale Types\n// ============================================================================\n\n/**\n * Supported locale code format (ISO 639-1 language codes).\n * Examples: 'en', 'ja', 'vi', 'zh', 'ko', 'fr', 'de', 'es', 'pt'\n */\nexport type LocaleCode = string;\n\n/**\n * Map of locale codes to localized strings.\n * @example { en: 'User Name', ja: 'ユーザー名', vi: 'Tên người dùng' }\n */\nexport type LocaleMap = Readonly<Record<LocaleCode, string>>;\n\n/**\n * Localized string - can be either a simple string (default locale)\n * or a map of locale codes to localized strings.\n *\n * @example\n * // Simple string (uses default locale)\n * displayName: \"User Name\"\n *\n * // Multi-language object\n * displayName:\n *   en: \"User Name\"\n *   ja: \"ユーザー名\"\n *   vi: \"Tên người dùng\"\n */\nexport type LocalizedString = string | LocaleMap;\n\n// ============================================================================\n// Locale Configuration\n// ============================================================================\n\n/**\n * Validation message templates.\n * Use placeholders: ${displayName}, ${min}, ${max}, ${length}, ${pattern}\n */\nexport interface ValidationMessages {\n  readonly required?: LocaleMap;\n  readonly minLength?: LocaleMap;\n  readonly maxLength?: LocaleMap;\n  readonly min?: LocaleMap;\n  readonly max?: LocaleMap;\n  readonly email?: LocaleMap;\n  readonly url?: LocaleMap;\n  readonly pattern?: LocaleMap;\n  readonly [key: string]: LocaleMap | undefined;\n}\n\n/**\n * Locale configuration for omnify projects.\n * Configured in .omnify.yaml or omnify.config.ts\n */\nexport interface LocaleConfig {\n  /**\n   * List of supported locale codes.\n   * @default ['en']\n   * @example ['en', 'ja', 'vi']\n   */\n  readonly locales: readonly LocaleCode[];\n\n  /**\n   * Default locale code used when:\n   * - displayName is a simple string\n   * - Requested locale is not found and no fallback matches\n   * @default 'en'\n   */\n  readonly defaultLocale: LocaleCode;\n\n  /**\n   * Fallback locale code used when requested locale is not found.\n   * If not set, falls back to defaultLocale.\n   * @example 'en' - If 'ko' not found, try 'en' before defaultLocale\n   */\n  readonly fallbackLocale?: LocaleCode;\n\n  /**\n   * Custom validation messages.\n   * Override default messages or add new languages.\n   *\n   * @example\n   * messages: {\n   *   required: {\n   *     ja: '${displayName}は必須です',\n   *     en: '${displayName} is required',\n   *     ko: '${displayName}은(는) 필수입니다',\n   *   },\n   *   maxLength: {\n   *     ja: '${displayName}は${max}文字以内で入力してください',\n   *     en: '${displayName} must be at most ${max} characters',\n   *   },\n   * }\n   */\n  readonly messages?: ValidationMessages;\n}\n\n/**\n * Default locale configuration.\n */\nexport const DEFAULT_LOCALE_CONFIG: LocaleConfig = {\n  locales: ['en'],\n  defaultLocale: 'en',\n};\n\n// ============================================================================\n// Resolution Options\n// ============================================================================\n\n/**\n * Options for resolving localized strings.\n */\nexport interface LocaleResolutionOptions {\n  /**\n   * Locale to resolve to.\n   * If not provided, uses defaultLocale from config.\n   */\n  readonly locale?: LocaleCode;\n\n  /**\n   * Locale configuration.\n   * If not provided, uses DEFAULT_LOCALE_CONFIG.\n   */\n  readonly config?: LocaleConfig;\n\n  /**\n   * Whether to throw an error if locale is not found.\n   * If false, returns undefined for missing locales.\n   * @default false\n   */\n  readonly strict?: boolean;\n}\n\n// ============================================================================\n// Utility Type Guards\n// ============================================================================\n\n/**\n * Check if a value is a LocaleMap (object with locale keys).\n */\nexport function isLocaleMap(value: unknown): value is LocaleMap {\n  if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n    return false;\n  }\n  // Check that all values are strings\n  return Object.values(value).every(v => typeof v === 'string');\n}\n\n/**\n * Check if a value is a LocalizedString.\n */\nexport function isLocalizedString(value: unknown): value is LocalizedString {\n  return typeof value === 'string' || isLocaleMap(value);\n}\n\n// ============================================================================\n// Resolution Functions\n// ============================================================================\n\n/**\n * Resolve a localized string to a specific locale.\n *\n * Resolution order:\n * 1. Requested locale (if provided)\n * 2. Fallback locale (if configured)\n * 3. Default locale\n * 4. First available locale (if none of the above match)\n * 5. undefined (if strict=false) or throws error (if strict=true)\n *\n * @param value - The localized string value\n * @param options - Resolution options\n * @returns The resolved string or undefined\n *\n * @example\n * // Simple string\n * resolveLocalizedString('Hello') // => 'Hello'\n *\n * // Multi-language with locale\n * resolveLocalizedString({ en: 'Hello', ja: 'こんにちは' }, { locale: 'ja' })\n * // => 'こんにちは'\n *\n * // Multi-language with fallback\n * resolveLocalizedString({ en: 'Hello', ja: 'こんにちは' }, { locale: 'ko' })\n * // => 'Hello' (falls back to defaultLocale)\n */\nexport function resolveLocalizedString(\n  value: LocalizedString | undefined | null,\n  options: LocaleResolutionOptions = {}\n): string | undefined {\n  if (value === undefined || value === null) {\n    return undefined;\n  }\n\n  // Simple string - return as-is\n  if (typeof value === 'string') {\n    return value;\n  }\n\n  const config = options.config ?? DEFAULT_LOCALE_CONFIG;\n  const requestedLocale = options.locale ?? config.defaultLocale;\n\n  // Try requested locale\n  if (requestedLocale in value) {\n    return value[requestedLocale];\n  }\n\n  // Try fallback locale\n  if (config.fallbackLocale && config.fallbackLocale in value) {\n    return value[config.fallbackLocale];\n  }\n\n  // Try default locale\n  if (config.defaultLocale in value) {\n    return value[config.defaultLocale];\n  }\n\n  // Try first available locale\n  const availableLocales = Object.keys(value);\n  const firstLocale = availableLocales[0];\n  if (firstLocale !== undefined) {\n    return value[firstLocale];\n  }\n\n  // No locale found\n  if (options.strict) {\n    throw new Error(\n      `Locale '${requestedLocale}' not found in localized string. ` +\n      `Available locales: none`\n    );\n  }\n\n  return undefined;\n}\n\n/**\n * Get all available locales from a localized string.\n *\n * @param value - The localized string value\n * @returns Array of available locale codes, or ['default'] for simple strings\n */\nexport function getAvailableLocales(\n  value: LocalizedString | undefined | null\n): readonly LocaleCode[] {\n  if (value === undefined || value === null) {\n    return [];\n  }\n\n  if (typeof value === 'string') {\n    return ['default'];\n  }\n\n  return Object.keys(value);\n}\n\n/**\n * Convert a localized string to a full LocaleMap.\n * Simple strings are converted to { [defaultLocale]: value }.\n *\n * @param value - The localized string value\n * @param defaultLocale - Default locale for simple strings\n * @returns LocaleMap or undefined\n */\nexport function toLocaleMap(\n  value: LocalizedString | undefined | null,\n  defaultLocale: LocaleCode = 'en'\n): LocaleMap | undefined {\n  if (value === undefined || value === null) {\n    return undefined;\n  }\n\n  if (typeof value === 'string') {\n    return { [defaultLocale]: value };\n  }\n\n  return value;\n}\n\n/**\n * Merge two localized strings, with the second taking precedence.\n *\n * @param base - Base localized string\n * @param override - Override localized string\n * @param defaultLocale - Default locale for simple strings\n * @returns Merged LocaleMap\n */\nexport function mergeLocalizedStrings(\n  base: LocalizedString | undefined | null,\n  override: LocalizedString | undefined | null,\n  defaultLocale: LocaleCode = 'en'\n): LocaleMap | undefined {\n  const baseMap = toLocaleMap(base, defaultLocale);\n  const overrideMap = toLocaleMap(override, defaultLocale);\n\n  if (!baseMap && !overrideMap) {\n    return undefined;\n  }\n\n  return {\n    ...baseMap,\n    ...overrideMap,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC4GO,SAAS,GAAM,OAA4B;AAChD,SAAO,EAAE,IAAI,MAAM,MAAM;AAC3B;AAKO,SAAS,IAAO,OAA4B;AACjD,SAAO,EAAE,IAAI,OAAO,MAAM;AAC5B;;;ACRO,IAAM,wBAAsC;AAAA,EACjD,SAAS,CAAC,IAAI;AAAA,EACd,eAAe;AACjB;AAqCO,SAAS,YAAY,OAAoC;AAC9D,MAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,GAAG;AACvE,WAAO;AAAA,EACT;AAEA,SAAO,OAAO,OAAO,KAAK,EAAE,MAAM,OAAK,OAAO,MAAM,QAAQ;AAC9D;AAKO,SAAS,kBAAkB,OAA0C;AAC1E,SAAO,OAAO,UAAU,YAAY,YAAY,KAAK;AACvD;AAgCO,SAAS,uBACd,OACA,UAAmC,CAAC,GAChB;AACpB,MAAI,UAAU,UAAa,UAAU,MAAM;AACzC,WAAO;AAAA,EACT;AAGA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO;AAAA,EACT;AAEA,QAAM,SAAS,QAAQ,UAAU;AACjC,QAAM,kBAAkB,QAAQ,UAAU,OAAO;AAGjD,MAAI,mBAAmB,OAAO;AAC5B,WAAO,MAAM,eAAe;AAAA,EAC9B;AAGA,MAAI,OAAO,kBAAkB,OAAO,kBAAkB,OAAO;AAC3D,WAAO,MAAM,OAAO,cAAc;AAAA,EACpC;AAGA,MAAI,OAAO,iBAAiB,OAAO;AACjC,WAAO,MAAM,OAAO,aAAa;AAAA,EACnC;AAGA,QAAM,mBAAmB,OAAO,KAAK,KAAK;AAC1C,QAAM,cAAc,iBAAiB,CAAC;AACtC,MAAI,gBAAgB,QAAW;AAC7B,WAAO,MAAM,WAAW;AAAA,EAC1B;AAGA,MAAI,QAAQ,QAAQ;AAClB,UAAM,IAAI;AAAA,MACR,WAAW,eAAe;AAAA,IAE5B;AAAA,EACF;AAEA,SAAO;AACT;AAQO,SAAS,oBACd,OACuB;AACvB,MAAI,UAAU,UAAa,UAAU,MAAM;AACzC,WAAO,CAAC;AAAA,EACV;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,CAAC,SAAS;AAAA,EACnB;AAEA,SAAO,OAAO,KAAK,KAAK;AAC1B;AAUO,SAAS,YACd,OACA,gBAA4B,MACL;AACvB,MAAI,UAAU,UAAa,UAAU,MAAM;AACzC,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,EAAE,CAAC,aAAa,GAAG,MAAM;AAAA,EAClC;AAEA,SAAO;AACT;AAUO,SAAS,sBACd,MACA,UACA,gBAA4B,MACL;AACvB,QAAM,UAAU,YAAY,MAAM,aAAa;AAC/C,QAAM,cAAc,YAAY,UAAU,aAAa;AAEvD,MAAI,CAAC,WAAW,CAAC,aAAa;AAC5B,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,GAAG;AAAA,IACH,GAAG;AAAA,EACL;AACF;","names":[]}

package/dist/index.d.cts

@@ -29,6 +29,21 @@ type LocaleMap = Readonly<Record<LocaleCode, string>>;
  *   vi: "Tên người dùng"
  */
 type LocalizedString = string | LocaleMap;
+/**
+ * Validation message templates.
+ * Use placeholders: ${displayName}, ${min}, ${max}, ${length}, ${pattern}
+ */
+interface ValidationMessages {
+    readonly required?: LocaleMap;
+    readonly minLength?: LocaleMap;
+    readonly maxLength?: LocaleMap;
+    readonly min?: LocaleMap;
+    readonly max?: LocaleMap;
+    readonly email?: LocaleMap;
+    readonly url?: LocaleMap;
+    readonly pattern?: LocaleMap;
+    readonly [key: string]: LocaleMap | undefined;
+}
 /**
  * Locale configuration for omnify projects.
  * Configured in .omnify.yaml or omnify.config.ts
@@ -53,6 +68,24 @@ interface LocaleConfig {
      * @example 'en' - If 'ko' not found, try 'en' before defaultLocale
      */
     readonly fallbackLocale?: LocaleCode;
+    /**
+     * Custom validation messages.
+     * Override default messages or add new languages.
+     *
+     * @example
+     * messages: {
+     *   required: {
+     *     ja: '${displayName}は必須です',
+     *     en: '${displayName} is required',
+     *     ko: '${displayName}은(는) 필수입니다',
+     *   },
+     *   maxLength: {
+     *     ja: '${displayName}は${max}文字以内で入力してください',
+     *     en: '${displayName} must be at most ${max} characters',
+     *   },
+     * }
+     */
+    readonly messages?: ValidationMessages;
 }
 /**
  * Default locale configuration.
@@ -284,6 +317,20 @@ interface BasePropertyDefinition {
      * @default true (all non-association fields are fillable by default)
      */
     readonly fillable?: boolean;
+    /**
+     * Placeholder text for form inputs (supports multi-language).
+     * Used in frontend forms to show hint text before user input.
+     *
+     * @example
+     * placeholder: "Enter your email"
+     *
+     * @example
+     * placeholder:
+     *   en: "Enter your email"
+     *   ja: "メールアドレスを入力"
+     *   vi: "Nhập email của bạn"
+     */
+    readonly placeholder?: LocalizedString;
     /**
      * Per-field settings for compound types.
      * Allows overriding nullable, hidden, fillable for specific expanded fields.
@@ -309,6 +356,34 @@ interface CompoundFieldOverride {
     readonly hidden?: boolean;
     /** Override fillable for this field */
     readonly fillable?: boolean;
+    /** Override length for string fields */
+    readonly length?: number;
+    /**
+     * Override display name (label) for this field (supports multi-language).
+     * If not specified, uses the default label from the plugin type definition.
+     *
+     * @example
+     * fields:
+     *   Lastname:
+     *     displayName:
+     *       en: "Last Name"
+     *       ja: "姓"
+     *       vi: "Họ"
+     */
+    readonly displayName?: LocalizedString;
+    /**
+     * Override placeholder for this field (supports multi-language).
+     * If not specified, uses the default placeholder from the plugin type definition.
+     *
+     * @example
+     * fields:
+     *   Lastname:
+     *     placeholder:
+     *       en: "e.g. Yamada"
+     *       ja: "例：山田"
+     *       vi: "VD: Nguyễn"
+     */
+    readonly placeholder?: LocalizedString;
 }
 /**
  * String property with length constraint.
@@ -518,6 +593,24 @@ interface TypeScriptTypeInfo {
         readonly name: string;
     };
 }
+/**
+ * Validation rules for a field.
+ * These are applied at the Zod schema level.
+ */
+interface FieldValidationRules {
+    /** Minimum length for strings */
+    readonly minLength?: number;
+    /** Maximum length for strings (defaults to sql.length if not set) */
+    readonly maxLength?: number;
+    /** Minimum value for numbers */
+    readonly min?: number;
+    /** Maximum value for numbers */
+    readonly max?: number;
+    /** Regex pattern for string validation */
+    readonly pattern?: string;
+    /** Built-in format validators */
+    readonly format?: 'email' | 'url' | 'phone' | 'postal_code';
+}
 /**
  * Expanded field definition for compound types.
  * Used when a single custom type expands to multiple database columns.
@@ -535,6 +628,42 @@ interface ExpandedFieldDefinition {
     readonly cast?: string;
     /** Default nullable for this field (can be overridden in schema) */
     readonly nullable?: boolean;
+    /**
+     * Validation rules for this field.
+     * Can be overridden in schema via fields.{suffix}.rules
+     *
+     * @example
+     * rules: {
+     *   minLength: 1,
+     *   maxLength: 100,
+     *   pattern: '^[ァ-ヶー]+$'  // Katakana only
+     * }
+     */
+    readonly rules?: FieldValidationRules;
+    /**
+     * Default label for this field (supports multi-language).
+     * Can be overridden in schema via fields.{suffix}.displayName
+     *
+     * @example
+     * label: {
+     *   en: "Last Name",
+     *   ja: "姓",
+     *   vi: "Họ"
+     * }
+     */
+    readonly label?: LocalizedString;
+    /**
+     * Default placeholder for this field (supports multi-language).
+     * Can be overridden in schema via fields.{suffix}.placeholder
+     *
+     * @example
+     * placeholder: {
+     *   en: "e.g. Yamada",
+     *   ja: "例：山田",
+     *   vi: "VD: Nguyễn"
+     * }
+     */
+    readonly placeholder?: LocalizedString;
 }
 /**
  * Accessor definition for compound types.
@@ -675,8 +804,8 @@ interface PluginLogger {
 interface PluginEnumDefinition {
     /** Enum name (used as schema name) */
     readonly name: string;
-    /** Human-readable display name */
-    readonly displayName?: string;
+    /** Human-readable display name (supports multi-language) */
+    readonly displayName?: LocalizedString;
     /** Description of the enum */
     readonly description?: string;
     /** Enum values */
@@ -688,8 +817,8 @@ interface PluginEnumDefinition {
 interface PluginEnumValue {
     /** Value stored in database */
     readonly value: string;
-    /** Human-readable label */
-    readonly label: string;
+    /** Human-readable label (supports multi-language) */
+    readonly label: LocalizedString;
     /** Extra properties for this enum value */
     readonly extra?: Record<string, string | number | boolean>;
 }
@@ -851,6 +980,8 @@ interface GeneratorContext {
     readonly previousOutputs: ReadonlyMap<string, readonly GeneratorOutput[]>;
     /** Custom types registered by all plugins (for compound type expansion) */
     readonly customTypes: ReadonlyMap<string, CustomTypeDefinition>;
+    /** Enums registered by all plugins (e.g., Prefecture, BankAccountType) */
+    readonly pluginEnums: ReadonlyMap<string, PluginEnumDefinition>;
     /** Locale configuration for multi-language support */
     readonly localeConfig?: LocaleConfig | undefined;
 }
@@ -980,8 +1111,26 @@ interface LaravelOutputConfig {
  * TypeScript output configuration.
  */
 interface TypeScriptOutputConfig {
-    /** Output file or directory for TypeScript types */
+    /**
+     * Base output directory for all TypeScript files.
+     * Schemas and enums will be placed in subdirectories.
+     * @example 'resources/ts/omnify'
+     */
     readonly path: string;
+    /**
+     * Subdirectory for schema files (interfaces, Zod schemas, i18n).
+     * Relative to `path`.
+     * @default 'schemas'
+     * @example 'models' - places schemas at {path}/models/
+     */
+    readonly schemasDir?: string;
+    /**
+     * Subdirectory for enum files.
+     * Relative to `path`.
+     * @default 'enum'
+     * @example 'enums' - places enums at {path}/enums/
+     */
+    readonly enumDir?: string;
     /** Whether to generate a single file or multiple files */
     readonly singleFile?: boolean;
     /** Whether to generate enum types */
@@ -1117,4 +1266,4 @@ declare function ok<T>(value: T): Result<T, never>;
  */
 declare function err<E>(error: E): Result<never, E>;
 
-export { type AssociationDefinition, type AssociationRelation, type BasePropertyDefinition, type BuiltInPropertyType, type ColumnChange, type CompoundFieldOverride, type CompoundTypeAccessor, type CustomTypeDefinition, DEFAULT_LOCALE_CONFIG, type DatabaseConfig, type DatabaseDriver, type EnumPropertyDefinition, type EnumRefPropertyDefinition, type ErrorCode, type ErrorLocation, type ExpandedFieldDefinition, type FilePropertyDefinition, type GeneratorContext, type GeneratorDefinition, type GeneratorOutput, type GeneratorOutputType, type IdType, type IndexChange, type IndexDefinition, type IndexSnapshot, type IndexType, type InlineEnumValue, type LaravelOutputConfig, type LoadedSchema, type LocaleCode, type LocaleConfig, type LocaleMap, type LocaleResolutionOptions, type LocalizedString, type NumericPropertyDefinition, type OmnifyConfig, type OmnifyErrorInfo, type OmnifyPlugin, type OutputConfig, type PivotFieldDefinition, type PluginConfigField, type PluginConfigFieldType, type PluginConfigSchema, type PluginConfigSelectOption, type PluginContext, type PluginEnumDefinition, type PluginEnumValue, type PluginFactory, type PluginLogger, type PropertyDefinition, type PropertySnapshot, type PropertyType, type ReferentialAction, type ResolvedOmnifyConfig, type Result, type SchemaChange, type SchemaChangeType, type SchemaCollection, type SchemaDefinition, type SchemaKind, type SchemaOptions, type SqlColumnDefinition, type StringPropertyDefinition, type TypeScriptOutputConfig, type TypeScriptTypeInfo, type ValidationRules, err, getAvailableLocales, isLocaleMap, isLocalizedString, mergeLocalizedStrings, ok, resolveLocalizedString, toLocaleMap };
+export { type AssociationDefinition, type AssociationRelation, type BasePropertyDefinition, type BuiltInPropertyType, type ColumnChange, type CompoundFieldOverride, type CompoundTypeAccessor, type CustomTypeDefinition, DEFAULT_LOCALE_CONFIG, type DatabaseConfig, type DatabaseDriver, type EnumPropertyDefinition, type EnumRefPropertyDefinition, type ErrorCode, type ErrorLocation, type ExpandedFieldDefinition, type FieldValidationRules, type FilePropertyDefinition, type GeneratorContext, type GeneratorDefinition, type GeneratorOutput, type GeneratorOutputType, type IdType, type IndexChange, type IndexDefinition, type IndexSnapshot, type IndexType, type InlineEnumValue, type LaravelOutputConfig, type LoadedSchema, type LocaleCode, type LocaleConfig, type LocaleMap, type LocaleResolutionOptions, type LocalizedString, type NumericPropertyDefinition, type OmnifyConfig, type OmnifyErrorInfo, type OmnifyPlugin, type OutputConfig, type PivotFieldDefinition, type PluginConfigField, type PluginConfigFieldType, type PluginConfigSchema, type PluginConfigSelectOption, type PluginContext, type PluginEnumDefinition, type PluginEnumValue, type PluginFactory, type PluginLogger, type PropertyDefinition, type PropertySnapshot, type PropertyType, type ReferentialAction, type ResolvedOmnifyConfig, type Result, type SchemaChange, type SchemaChangeType, type SchemaCollection, type SchemaDefinition, type SchemaKind, type SchemaOptions, type SqlColumnDefinition, type StringPropertyDefinition, type TypeScriptOutputConfig, type TypeScriptTypeInfo, type ValidationMessages, type ValidationRules, err, getAvailableLocales, isLocaleMap, isLocalizedString, mergeLocalizedStrings, ok, resolveLocalizedString, toLocaleMap };

package/dist/index.d.ts

@@ -29,6 +29,21 @@ type LocaleMap = Readonly<Record<LocaleCode, string>>;
  *   vi: "Tên người dùng"
  */
 type LocalizedString = string | LocaleMap;
+/**
+ * Validation message templates.
+ * Use placeholders: ${displayName}, ${min}, ${max}, ${length}, ${pattern}
+ */
+interface ValidationMessages {
+    readonly required?: LocaleMap;
+    readonly minLength?: LocaleMap;
+    readonly maxLength?: LocaleMap;
+    readonly min?: LocaleMap;
+    readonly max?: LocaleMap;
+    readonly email?: LocaleMap;
+    readonly url?: LocaleMap;
+    readonly pattern?: LocaleMap;
+    readonly [key: string]: LocaleMap | undefined;
+}
 /**
  * Locale configuration for omnify projects.
  * Configured in .omnify.yaml or omnify.config.ts
@@ -53,6 +68,24 @@ interface LocaleConfig {
      * @example 'en' - If 'ko' not found, try 'en' before defaultLocale
      */
     readonly fallbackLocale?: LocaleCode;
+    /**
+     * Custom validation messages.
+     * Override default messages or add new languages.
+     *
+     * @example
+     * messages: {
+     *   required: {
+     *     ja: '${displayName}は必須です',
+     *     en: '${displayName} is required',
+     *     ko: '${displayName}은(는) 필수입니다',
+     *   },
+     *   maxLength: {
+     *     ja: '${displayName}は${max}文字以内で入力してください',
+     *     en: '${displayName} must be at most ${max} characters',
+     *   },
+     * }
+     */
+    readonly messages?: ValidationMessages;
 }
 /**
  * Default locale configuration.
@@ -284,6 +317,20 @@ interface BasePropertyDefinition {
      * @default true (all non-association fields are fillable by default)
      */
     readonly fillable?: boolean;
+    /**
+     * Placeholder text for form inputs (supports multi-language).
+     * Used in frontend forms to show hint text before user input.
+     *
+     * @example
+     * placeholder: "Enter your email"
+     *
+     * @example
+     * placeholder:
+     *   en: "Enter your email"
+     *   ja: "メールアドレスを入力"
+     *   vi: "Nhập email của bạn"
+     */
+    readonly placeholder?: LocalizedString;
     /**
      * Per-field settings for compound types.
      * Allows overriding nullable, hidden, fillable for specific expanded fields.
@@ -309,6 +356,34 @@ interface CompoundFieldOverride {
     readonly hidden?: boolean;
     /** Override fillable for this field */
     readonly fillable?: boolean;
+    /** Override length for string fields */
+    readonly length?: number;
+    /**
+     * Override display name (label) for this field (supports multi-language).
+     * If not specified, uses the default label from the plugin type definition.
+     *
+     * @example
+     * fields:
+     *   Lastname:
+     *     displayName:
+     *       en: "Last Name"
+     *       ja: "姓"
+     *       vi: "Họ"
+     */
+    readonly displayName?: LocalizedString;
+    /**
+     * Override placeholder for this field (supports multi-language).
+     * If not specified, uses the default placeholder from the plugin type definition.
+     *
+     * @example
+     * fields:
+     *   Lastname:
+     *     placeholder:
+     *       en: "e.g. Yamada"
+     *       ja: "例：山田"
+     *       vi: "VD: Nguyễn"
+     */
+    readonly placeholder?: LocalizedString;
 }
 /**
  * String property with length constraint.
@@ -518,6 +593,24 @@ interface TypeScriptTypeInfo {
         readonly name: string;
     };
 }
+/**
+ * Validation rules for a field.
+ * These are applied at the Zod schema level.
+ */
+interface FieldValidationRules {
+    /** Minimum length for strings */
+    readonly minLength?: number;
+    /** Maximum length for strings (defaults to sql.length if not set) */
+    readonly maxLength?: number;
+    /** Minimum value for numbers */
+    readonly min?: number;
+    /** Maximum value for numbers */
+    readonly max?: number;
+    /** Regex pattern for string validation */
+    readonly pattern?: string;
+    /** Built-in format validators */
+    readonly format?: 'email' | 'url' | 'phone' | 'postal_code';
+}
 /**
  * Expanded field definition for compound types.
  * Used when a single custom type expands to multiple database columns.
@@ -535,6 +628,42 @@ interface ExpandedFieldDefinition {
     readonly cast?: string;
     /** Default nullable for this field (can be overridden in schema) */
     readonly nullable?: boolean;
+    /**
+     * Validation rules for this field.
+     * Can be overridden in schema via fields.{suffix}.rules
+     *
+     * @example
+     * rules: {
+     *   minLength: 1,
+     *   maxLength: 100,
+     *   pattern: '^[ァ-ヶー]+$'  // Katakana only
+     * }
+     */
+    readonly rules?: FieldValidationRules;
+    /**
+     * Default label for this field (supports multi-language).
+     * Can be overridden in schema via fields.{suffix}.displayName
+     *
+     * @example
+     * label: {
+     *   en: "Last Name",
+     *   ja: "姓",
+     *   vi: "Họ"
+     * }
+     */
+    readonly label?: LocalizedString;
+    /**
+     * Default placeholder for this field (supports multi-language).
+     * Can be overridden in schema via fields.{suffix}.placeholder
+     *
+     * @example
+     * placeholder: {
+     *   en: "e.g. Yamada",
+     *   ja: "例：山田",
+     *   vi: "VD: Nguyễn"
+     * }
+     */
+    readonly placeholder?: LocalizedString;
 }
 /**
  * Accessor definition for compound types.
@@ -675,8 +804,8 @@ interface PluginLogger {
 interface PluginEnumDefinition {
     /** Enum name (used as schema name) */
     readonly name: string;
-    /** Human-readable display name */
-    readonly displayName?: string;
+    /** Human-readable display name (supports multi-language) */
+    readonly displayName?: LocalizedString;
     /** Description of the enum */
     readonly description?: string;
     /** Enum values */
@@ -688,8 +817,8 @@ interface PluginEnumDefinition {
 interface PluginEnumValue {
     /** Value stored in database */
     readonly value: string;
-    /** Human-readable label */
-    readonly label: string;
+    /** Human-readable label (supports multi-language) */
+    readonly label: LocalizedString;
     /** Extra properties for this enum value */
     readonly extra?: Record<string, string | number | boolean>;
 }
@@ -851,6 +980,8 @@ interface GeneratorContext {
     readonly previousOutputs: ReadonlyMap<string, readonly GeneratorOutput[]>;
     /** Custom types registered by all plugins (for compound type expansion) */
     readonly customTypes: ReadonlyMap<string, CustomTypeDefinition>;
+    /** Enums registered by all plugins (e.g., Prefecture, BankAccountType) */
+    readonly pluginEnums: ReadonlyMap<string, PluginEnumDefinition>;
     /** Locale configuration for multi-language support */
     readonly localeConfig?: LocaleConfig | undefined;
 }
@@ -980,8 +1111,26 @@ interface LaravelOutputConfig {
  * TypeScript output configuration.
  */
 interface TypeScriptOutputConfig {
-    /** Output file or directory for TypeScript types */
+    /**
+     * Base output directory for all TypeScript files.
+     * Schemas and enums will be placed in subdirectories.
+     * @example 'resources/ts/omnify'
+     */
     readonly path: string;
+    /**
+     * Subdirectory for schema files (interfaces, Zod schemas, i18n).
+     * Relative to `path`.
+     * @default 'schemas'
+     * @example 'models' - places schemas at {path}/models/
+     */
+    readonly schemasDir?: string;
+    /**
+     * Subdirectory for enum files.
+     * Relative to `path`.
+     * @default 'enum'
+     * @example 'enums' - places enums at {path}/enums/
+     */
+    readonly enumDir?: string;
     /** Whether to generate a single file or multiple files */
     readonly singleFile?: boolean;
     /** Whether to generate enum types */
@@ -1117,4 +1266,4 @@ declare function ok<T>(value: T): Result<T, never>;
  */
 declare function err<E>(error: E): Result<never, E>;
 
-export { type AssociationDefinition, type AssociationRelation, type BasePropertyDefinition, type BuiltInPropertyType, type ColumnChange, type CompoundFieldOverride, type CompoundTypeAccessor, type CustomTypeDefinition, DEFAULT_LOCALE_CONFIG, type DatabaseConfig, type DatabaseDriver, type EnumPropertyDefinition, type EnumRefPropertyDefinition, type ErrorCode, type ErrorLocation, type ExpandedFieldDefinition, type FilePropertyDefinition, type GeneratorContext, type GeneratorDefinition, type GeneratorOutput, type GeneratorOutputType, type IdType, type IndexChange, type IndexDefinition, type IndexSnapshot, type IndexType, type InlineEnumValue, type LaravelOutputConfig, type LoadedSchema, type LocaleCode, type LocaleConfig, type LocaleMap, type LocaleResolutionOptions, type LocalizedString, type NumericPropertyDefinition, type OmnifyConfig, type OmnifyErrorInfo, type OmnifyPlugin, type OutputConfig, type PivotFieldDefinition, type PluginConfigField, type PluginConfigFieldType, type PluginConfigSchema, type PluginConfigSelectOption, type PluginContext, type PluginEnumDefinition, type PluginEnumValue, type PluginFactory, type PluginLogger, type PropertyDefinition, type PropertySnapshot, type PropertyType, type ReferentialAction, type ResolvedOmnifyConfig, type Result, type SchemaChange, type SchemaChangeType, type SchemaCollection, type SchemaDefinition, type SchemaKind, type SchemaOptions, type SqlColumnDefinition, type StringPropertyDefinition, type TypeScriptOutputConfig, type TypeScriptTypeInfo, type ValidationRules, err, getAvailableLocales, isLocaleMap, isLocalizedString, mergeLocalizedStrings, ok, resolveLocalizedString, toLocaleMap };
+export { type AssociationDefinition, type AssociationRelation, type BasePropertyDefinition, type BuiltInPropertyType, type ColumnChange, type CompoundFieldOverride, type CompoundTypeAccessor, type CustomTypeDefinition, DEFAULT_LOCALE_CONFIG, type DatabaseConfig, type DatabaseDriver, type EnumPropertyDefinition, type EnumRefPropertyDefinition, type ErrorCode, type ErrorLocation, type ExpandedFieldDefinition, type FieldValidationRules, type FilePropertyDefinition, type GeneratorContext, type GeneratorDefinition, type GeneratorOutput, type GeneratorOutputType, type IdType, type IndexChange, type IndexDefinition, type IndexSnapshot, type IndexType, type InlineEnumValue, type LaravelOutputConfig, type LoadedSchema, type LocaleCode, type LocaleConfig, type LocaleMap, type LocaleResolutionOptions, type LocalizedString, type NumericPropertyDefinition, type OmnifyConfig, type OmnifyErrorInfo, type OmnifyPlugin, type OutputConfig, type PivotFieldDefinition, type PluginConfigField, type PluginConfigFieldType, type PluginConfigSchema, type PluginConfigSelectOption, type PluginContext, type PluginEnumDefinition, type PluginEnumValue, type PluginFactory, type PluginLogger, type PropertyDefinition, type PropertySnapshot, type PropertyType, type ReferentialAction, type ResolvedOmnifyConfig, type Result, type SchemaChange, type SchemaChangeType, type SchemaCollection, type SchemaDefinition, type SchemaKind, type SchemaOptions, type SqlColumnDefinition, type StringPropertyDefinition, type TypeScriptOutputConfig, type TypeScriptTypeInfo, type ValidationMessages, type ValidationRules, err, getAvailableLocales, isLocaleMap, isLocalizedString, mergeLocalizedStrings, ok, resolveLocalizedString, toLocaleMap };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/i18n.ts"],"sourcesContent":["/**\n * @famgia/omnify-types - Error Types\n *\n * Type definitions for omnify error handling.\n * Errors follow the format: file:line + message + suggestion\n */\n\n// ============================================================================\n// Error Codes\n// ============================================================================\n\n/**\n * Error code categories:\n * - E0xx: Configuration errors\n * - E1xx: Schema parsing errors\n * - E2xx: Schema validation errors\n * - E3xx: Plugin errors\n * - E4xx: Atlas/Database errors\n * - E5xx: Generation errors\n * - E9xx: Internal errors\n */\nexport type ErrorCode =\n  // Configuration errors (E0xx)\n  | 'E001' // Config file not found\n  | 'E002' // Invalid config format\n  | 'E003' // Missing required config field\n  | 'E004' // Invalid database driver\n  | 'E005' // Invalid output path\n  // Schema parsing errors (E1xx)\n  | 'E101' // Schema file not found\n  | 'E102' // Invalid YAML syntax\n  | 'E103' // Invalid JSON syntax\n  | 'E104' // Empty schema file\n  | 'E105' // Schema read error\n  // Schema validation errors (E2xx)\n  | 'E201' // Invalid property type\n  | 'E202' // Missing required field\n  | 'E203' // Invalid association target\n  | 'E204' // Circular reference detected\n  | 'E205' // Duplicate schema name\n  | 'E206' // Invalid schema options\n  | 'E207' // Invalid enum values\n  | 'E208' // Orphaned inverse relation\n  // Plugin errors (E3xx)\n  | 'E301' // Plugin not found\n  | 'E302' // Plugin load error\n  | 'E303' // Invalid plugin format\n  | 'E304' // Plugin type conflict\n  | 'E305' // Plugin setup error\n  // Atlas/Database errors (E4xx)\n  | 'E401' // Atlas CLI not found\n  | 'E402' // Atlas diff failed\n  | 'E403' // Database connection error\n  | 'E404' // HCL generation error\n  | 'E405' // Lock file error\n  // Generation errors (E5xx)\n  | 'E501' // Migration generation failed\n  | 'E502' // TypeScript generation failed\n  | 'E503' // Output write error\n  | 'E504' // Template error\n  // Internal errors (E9xx)\n  | 'E901' // Unexpected error\n  | 'E902'; // Not implemented\n\n// ============================================================================\n// Error Info\n// ============================================================================\n\n/**\n * Source location where an error occurred.\n */\nexport interface ErrorLocation {\n  /** File path where the error occurred */\n  readonly file?: string;\n  /** Line number (1-based) */\n  readonly line?: number;\n  /** Column number (1-based) */\n  readonly column?: number;\n}\n\n/**\n * Structured error information for omnify errors.\n */\nexport interface OmnifyErrorInfo {\n  /** Error code (e.g., 'E201') */\n  readonly code: ErrorCode;\n  /** Human-readable error message */\n  readonly message: string;\n  /** Location where the error occurred */\n  readonly location?: ErrorLocation;\n  /** Suggested fix for the error */\n  readonly suggestion?: string;\n  /** Additional context or details */\n  readonly details?: Record<string, unknown>;\n  /** Original error if this wraps another error */\n  readonly cause?: Error;\n}\n\n/**\n * Result type for operations that may fail.\n */\nexport type Result<T, E = OmnifyErrorInfo> =\n  | { readonly ok: true; readonly value: T }\n  | { readonly ok: false; readonly error: E };\n\n/**\n * Helper to create a successful result.\n */\nexport function ok<T>(value: T): Result<T, never> {\n  return { ok: true, value };\n}\n\n/**\n * Helper to create an error result.\n */\nexport function err<E>(error: E): Result<never, E> {\n  return { ok: false, error };\n}\n","/**\n * @famgia/omnify-types - Internationalization (i18n) Types\n *\n * Types for multi-language support in schema definitions.\n * Supports displayName, description, and other localizable strings.\n */\n\n// ============================================================================\n// Locale Types\n// ============================================================================\n\n/**\n * Supported locale code format (ISO 639-1 language codes).\n * Examples: 'en', 'ja', 'vi', 'zh', 'ko', 'fr', 'de', 'es', 'pt'\n */\nexport type LocaleCode = string;\n\n/**\n * Map of locale codes to localized strings.\n * @example { en: 'User Name', ja: 'ユーザー名', vi: 'Tên người dùng' }\n */\nexport type LocaleMap = Readonly<Record<LocaleCode, string>>;\n\n/**\n * Localized string - can be either a simple string (default locale)\n * or a map of locale codes to localized strings.\n *\n * @example\n * // Simple string (uses default locale)\n * displayName: \"User Name\"\n *\n * // Multi-language object\n * displayName:\n *   en: \"User Name\"\n *   ja: \"ユーザー名\"\n *   vi: \"Tên người dùng\"\n */\nexport type LocalizedString = string | LocaleMap;\n\n// ============================================================================\n// Locale Configuration\n// ============================================================================\n\n/**\n * Locale configuration for omnify projects.\n * Configured in .omnify.yaml or omnify.config.ts\n */\nexport interface LocaleConfig {\n  /**\n   * List of supported locale codes.\n   * @default ['en']\n   * @example ['en', 'ja', 'vi']\n   */\n  readonly locales: readonly LocaleCode[];\n\n  /**\n   * Default locale code used when:\n   * - displayName is a simple string\n   * - Requested locale is not found and no fallback matches\n   * @default 'en'\n   */\n  readonly defaultLocale: LocaleCode;\n\n  /**\n   * Fallback locale code used when requested locale is not found.\n   * If not set, falls back to defaultLocale.\n   * @example 'en' - If 'ko' not found, try 'en' before defaultLocale\n   */\n  readonly fallbackLocale?: LocaleCode;\n}\n\n/**\n * Default locale configuration.\n */\nexport const DEFAULT_LOCALE_CONFIG: LocaleConfig = {\n  locales: ['en'],\n  defaultLocale: 'en',\n};\n\n// ============================================================================\n// Resolution Options\n// ============================================================================\n\n/**\n * Options for resolving localized strings.\n */\nexport interface LocaleResolutionOptions {\n  /**\n   * Locale to resolve to.\n   * If not provided, uses defaultLocale from config.\n   */\n  readonly locale?: LocaleCode;\n\n  /**\n   * Locale configuration.\n   * If not provided, uses DEFAULT_LOCALE_CONFIG.\n   */\n  readonly config?: LocaleConfig;\n\n  /**\n   * Whether to throw an error if locale is not found.\n   * If false, returns undefined for missing locales.\n   * @default false\n   */\n  readonly strict?: boolean;\n}\n\n// ============================================================================\n// Utility Type Guards\n// ============================================================================\n\n/**\n * Check if a value is a LocaleMap (object with locale keys).\n */\nexport function isLocaleMap(value: unknown): value is LocaleMap {\n  if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n    return false;\n  }\n  // Check that all values are strings\n  return Object.values(value).every(v => typeof v === 'string');\n}\n\n/**\n * Check if a value is a LocalizedString.\n */\nexport function isLocalizedString(value: unknown): value is LocalizedString {\n  return typeof value === 'string' || isLocaleMap(value);\n}\n\n// ============================================================================\n// Resolution Functions\n// ============================================================================\n\n/**\n * Resolve a localized string to a specific locale.\n *\n * Resolution order:\n * 1. Requested locale (if provided)\n * 2. Fallback locale (if configured)\n * 3. Default locale\n * 4. First available locale (if none of the above match)\n * 5. undefined (if strict=false) or throws error (if strict=true)\n *\n * @param value - The localized string value\n * @param options - Resolution options\n * @returns The resolved string or undefined\n *\n * @example\n * // Simple string\n * resolveLocalizedString('Hello') // => 'Hello'\n *\n * // Multi-language with locale\n * resolveLocalizedString({ en: 'Hello', ja: 'こんにちは' }, { locale: 'ja' })\n * // => 'こんにちは'\n *\n * // Multi-language with fallback\n * resolveLocalizedString({ en: 'Hello', ja: 'こんにちは' }, { locale: 'ko' })\n * // => 'Hello' (falls back to defaultLocale)\n */\nexport function resolveLocalizedString(\n  value: LocalizedString | undefined | null,\n  options: LocaleResolutionOptions = {}\n): string | undefined {\n  if (value === undefined || value === null) {\n    return undefined;\n  }\n\n  // Simple string - return as-is\n  if (typeof value === 'string') {\n    return value;\n  }\n\n  const config = options.config ?? DEFAULT_LOCALE_CONFIG;\n  const requestedLocale = options.locale ?? config.defaultLocale;\n\n  // Try requested locale\n  if (requestedLocale in value) {\n    return value[requestedLocale];\n  }\n\n  // Try fallback locale\n  if (config.fallbackLocale && config.fallbackLocale in value) {\n    return value[config.fallbackLocale];\n  }\n\n  // Try default locale\n  if (config.defaultLocale in value) {\n    return value[config.defaultLocale];\n  }\n\n  // Try first available locale\n  const availableLocales = Object.keys(value);\n  const firstLocale = availableLocales[0];\n  if (firstLocale !== undefined) {\n    return value[firstLocale];\n  }\n\n  // No locale found\n  if (options.strict) {\n    throw new Error(\n      `Locale '${requestedLocale}' not found in localized string. ` +\n      `Available locales: none`\n    );\n  }\n\n  return undefined;\n}\n\n/**\n * Get all available locales from a localized string.\n *\n * @param value - The localized string value\n * @returns Array of available locale codes, or ['default'] for simple strings\n */\nexport function getAvailableLocales(\n  value: LocalizedString | undefined | null\n): readonly LocaleCode[] {\n  if (value === undefined || value === null) {\n    return [];\n  }\n\n  if (typeof value === 'string') {\n    return ['default'];\n  }\n\n  return Object.keys(value);\n}\n\n/**\n * Convert a localized string to a full LocaleMap.\n * Simple strings are converted to { [defaultLocale]: value }.\n *\n * @param value - The localized string value\n * @param defaultLocale - Default locale for simple strings\n * @returns LocaleMap or undefined\n */\nexport function toLocaleMap(\n  value: LocalizedString | undefined | null,\n  defaultLocale: LocaleCode = 'en'\n): LocaleMap | undefined {\n  if (value === undefined || value === null) {\n    return undefined;\n  }\n\n  if (typeof value === 'string') {\n    return { [defaultLocale]: value };\n  }\n\n  return value;\n}\n\n/**\n * Merge two localized strings, with the second taking precedence.\n *\n * @param base - Base localized string\n * @param override - Override localized string\n * @param defaultLocale - Default locale for simple strings\n * @returns Merged LocaleMap\n */\nexport function mergeLocalizedStrings(\n  base: LocalizedString | undefined | null,\n  override: LocalizedString | undefined | null,\n  defaultLocale: LocaleCode = 'en'\n): LocaleMap | undefined {\n  const baseMap = toLocaleMap(base, defaultLocale);\n  const overrideMap = toLocaleMap(override, defaultLocale);\n\n  if (!baseMap && !overrideMap) {\n    return undefined;\n  }\n\n  return {\n    ...baseMap,\n    ...overrideMap,\n  };\n}\n"],"mappings":";AA4GO,SAAS,GAAM,OAA4B;AAChD,SAAO,EAAE,IAAI,MAAM,MAAM;AAC3B;AAKO,SAAS,IAAO,OAA4B;AACjD,SAAO,EAAE,IAAI,OAAO,MAAM;AAC5B;;;AC3CO,IAAM,wBAAsC;AAAA,EACjD,SAAS,CAAC,IAAI;AAAA,EACd,eAAe;AACjB;AAqCO,SAAS,YAAY,OAAoC;AAC9D,MAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,GAAG;AACvE,WAAO;AAAA,EACT;AAEA,SAAO,OAAO,OAAO,KAAK,EAAE,MAAM,OAAK,OAAO,MAAM,QAAQ;AAC9D;AAKO,SAAS,kBAAkB,OAA0C;AAC1E,SAAO,OAAO,UAAU,YAAY,YAAY,KAAK;AACvD;AAgCO,SAAS,uBACd,OACA,UAAmC,CAAC,GAChB;AACpB,MAAI,UAAU,UAAa,UAAU,MAAM;AACzC,WAAO;AAAA,EACT;AAGA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO;AAAA,EACT;AAEA,QAAM,SAAS,QAAQ,UAAU;AACjC,QAAM,kBAAkB,QAAQ,UAAU,OAAO;AAGjD,MAAI,mBAAmB,OAAO;AAC5B,WAAO,MAAM,eAAe;AAAA,EAC9B;AAGA,MAAI,OAAO,kBAAkB,OAAO,kBAAkB,OAAO;AAC3D,WAAO,MAAM,OAAO,cAAc;AAAA,EACpC;AAGA,MAAI,OAAO,iBAAiB,OAAO;AACjC,WAAO,MAAM,OAAO,aAAa;AAAA,EACnC;AAGA,QAAM,mBAAmB,OAAO,KAAK,KAAK;AAC1C,QAAM,cAAc,iBAAiB,CAAC;AACtC,MAAI,gBAAgB,QAAW;AAC7B,WAAO,MAAM,WAAW;AAAA,EAC1B;AAGA,MAAI,QAAQ,QAAQ;AAClB,UAAM,IAAI;AAAA,MACR,WAAW,eAAe;AAAA,IAE5B;AAAA,EACF;AAEA,SAAO;AACT;AAQO,SAAS,oBACd,OACuB;AACvB,MAAI,UAAU,UAAa,UAAU,MAAM;AACzC,WAAO,CAAC;AAAA,EACV;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,CAAC,SAAS;AAAA,EACnB;AAEA,SAAO,OAAO,KAAK,KAAK;AAC1B;AAUO,SAAS,YACd,OACA,gBAA4B,MACL;AACvB,MAAI,UAAU,UAAa,UAAU,MAAM;AACzC,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,EAAE,CAAC,aAAa,GAAG,MAAM;AAAA,EAClC;AAEA,SAAO;AACT;AAUO,SAAS,sBACd,MACA,UACA,gBAA4B,MACL;AACvB,QAAM,UAAU,YAAY,MAAM,aAAa;AAC/C,QAAM,cAAc,YAAY,UAAU,aAAa;AAEvD,MAAI,CAAC,WAAW,CAAC,aAAa;AAC5B,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,GAAG;AAAA,IACH,GAAG;AAAA,EACL;AACF;","names":[]}
+{"version":3,"sources":["../src/errors.ts","../src/i18n.ts"],"sourcesContent":["/**\n * @famgia/omnify-types - Error Types\n *\n * Type definitions for omnify error handling.\n * Errors follow the format: file:line + message + suggestion\n */\n\n// ============================================================================\n// Error Codes\n// ============================================================================\n\n/**\n * Error code categories:\n * - E0xx: Configuration errors\n * - E1xx: Schema parsing errors\n * - E2xx: Schema validation errors\n * - E3xx: Plugin errors\n * - E4xx: Atlas/Database errors\n * - E5xx: Generation errors\n * - E9xx: Internal errors\n */\nexport type ErrorCode =\n  // Configuration errors (E0xx)\n  | 'E001' // Config file not found\n  | 'E002' // Invalid config format\n  | 'E003' // Missing required config field\n  | 'E004' // Invalid database driver\n  | 'E005' // Invalid output path\n  // Schema parsing errors (E1xx)\n  | 'E101' // Schema file not found\n  | 'E102' // Invalid YAML syntax\n  | 'E103' // Invalid JSON syntax\n  | 'E104' // Empty schema file\n  | 'E105' // Schema read error\n  // Schema validation errors (E2xx)\n  | 'E201' // Invalid property type\n  | 'E202' // Missing required field\n  | 'E203' // Invalid association target\n  | 'E204' // Circular reference detected\n  | 'E205' // Duplicate schema name\n  | 'E206' // Invalid schema options\n  | 'E207' // Invalid enum values\n  | 'E208' // Orphaned inverse relation\n  // Plugin errors (E3xx)\n  | 'E301' // Plugin not found\n  | 'E302' // Plugin load error\n  | 'E303' // Invalid plugin format\n  | 'E304' // Plugin type conflict\n  | 'E305' // Plugin setup error\n  // Atlas/Database errors (E4xx)\n  | 'E401' // Atlas CLI not found\n  | 'E402' // Atlas diff failed\n  | 'E403' // Database connection error\n  | 'E404' // HCL generation error\n  | 'E405' // Lock file error\n  // Generation errors (E5xx)\n  | 'E501' // Migration generation failed\n  | 'E502' // TypeScript generation failed\n  | 'E503' // Output write error\n  | 'E504' // Template error\n  // Internal errors (E9xx)\n  | 'E901' // Unexpected error\n  | 'E902'; // Not implemented\n\n// ============================================================================\n// Error Info\n// ============================================================================\n\n/**\n * Source location where an error occurred.\n */\nexport interface ErrorLocation {\n  /** File path where the error occurred */\n  readonly file?: string;\n  /** Line number (1-based) */\n  readonly line?: number;\n  /** Column number (1-based) */\n  readonly column?: number;\n}\n\n/**\n * Structured error information for omnify errors.\n */\nexport interface OmnifyErrorInfo {\n  /** Error code (e.g., 'E201') */\n  readonly code: ErrorCode;\n  /** Human-readable error message */\n  readonly message: string;\n  /** Location where the error occurred */\n  readonly location?: ErrorLocation;\n  /** Suggested fix for the error */\n  readonly suggestion?: string;\n  /** Additional context or details */\n  readonly details?: Record<string, unknown>;\n  /** Original error if this wraps another error */\n  readonly cause?: Error;\n}\n\n/**\n * Result type for operations that may fail.\n */\nexport type Result<T, E = OmnifyErrorInfo> =\n  | { readonly ok: true; readonly value: T }\n  | { readonly ok: false; readonly error: E };\n\n/**\n * Helper to create a successful result.\n */\nexport function ok<T>(value: T): Result<T, never> {\n  return { ok: true, value };\n}\n\n/**\n * Helper to create an error result.\n */\nexport function err<E>(error: E): Result<never, E> {\n  return { ok: false, error };\n}\n","/**\n * @famgia/omnify-types - Internationalization (i18n) Types\n *\n * Types for multi-language support in schema definitions.\n * Supports displayName, description, and other localizable strings.\n */\n\n// ============================================================================\n// Locale Types\n// ============================================================================\n\n/**\n * Supported locale code format (ISO 639-1 language codes).\n * Examples: 'en', 'ja', 'vi', 'zh', 'ko', 'fr', 'de', 'es', 'pt'\n */\nexport type LocaleCode = string;\n\n/**\n * Map of locale codes to localized strings.\n * @example { en: 'User Name', ja: 'ユーザー名', vi: 'Tên người dùng' }\n */\nexport type LocaleMap = Readonly<Record<LocaleCode, string>>;\n\n/**\n * Localized string - can be either a simple string (default locale)\n * or a map of locale codes to localized strings.\n *\n * @example\n * // Simple string (uses default locale)\n * displayName: \"User Name\"\n *\n * // Multi-language object\n * displayName:\n *   en: \"User Name\"\n *   ja: \"ユーザー名\"\n *   vi: \"Tên người dùng\"\n */\nexport type LocalizedString = string | LocaleMap;\n\n// ============================================================================\n// Locale Configuration\n// ============================================================================\n\n/**\n * Validation message templates.\n * Use placeholders: ${displayName}, ${min}, ${max}, ${length}, ${pattern}\n */\nexport interface ValidationMessages {\n  readonly required?: LocaleMap;\n  readonly minLength?: LocaleMap;\n  readonly maxLength?: LocaleMap;\n  readonly min?: LocaleMap;\n  readonly max?: LocaleMap;\n  readonly email?: LocaleMap;\n  readonly url?: LocaleMap;\n  readonly pattern?: LocaleMap;\n  readonly [key: string]: LocaleMap | undefined;\n}\n\n/**\n * Locale configuration for omnify projects.\n * Configured in .omnify.yaml or omnify.config.ts\n */\nexport interface LocaleConfig {\n  /**\n   * List of supported locale codes.\n   * @default ['en']\n   * @example ['en', 'ja', 'vi']\n   */\n  readonly locales: readonly LocaleCode[];\n\n  /**\n   * Default locale code used when:\n   * - displayName is a simple string\n   * - Requested locale is not found and no fallback matches\n   * @default 'en'\n   */\n  readonly defaultLocale: LocaleCode;\n\n  /**\n   * Fallback locale code used when requested locale is not found.\n   * If not set, falls back to defaultLocale.\n   * @example 'en' - If 'ko' not found, try 'en' before defaultLocale\n   */\n  readonly fallbackLocale?: LocaleCode;\n\n  /**\n   * Custom validation messages.\n   * Override default messages or add new languages.\n   *\n   * @example\n   * messages: {\n   *   required: {\n   *     ja: '${displayName}は必須です',\n   *     en: '${displayName} is required',\n   *     ko: '${displayName}은(는) 필수입니다',\n   *   },\n   *   maxLength: {\n   *     ja: '${displayName}は${max}文字以内で入力してください',\n   *     en: '${displayName} must be at most ${max} characters',\n   *   },\n   * }\n   */\n  readonly messages?: ValidationMessages;\n}\n\n/**\n * Default locale configuration.\n */\nexport const DEFAULT_LOCALE_CONFIG: LocaleConfig = {\n  locales: ['en'],\n  defaultLocale: 'en',\n};\n\n// ============================================================================\n// Resolution Options\n// ============================================================================\n\n/**\n * Options for resolving localized strings.\n */\nexport interface LocaleResolutionOptions {\n  /**\n   * Locale to resolve to.\n   * If not provided, uses defaultLocale from config.\n   */\n  readonly locale?: LocaleCode;\n\n  /**\n   * Locale configuration.\n   * If not provided, uses DEFAULT_LOCALE_CONFIG.\n   */\n  readonly config?: LocaleConfig;\n\n  /**\n   * Whether to throw an error if locale is not found.\n   * If false, returns undefined for missing locales.\n   * @default false\n   */\n  readonly strict?: boolean;\n}\n\n// ============================================================================\n// Utility Type Guards\n// ============================================================================\n\n/**\n * Check if a value is a LocaleMap (object with locale keys).\n */\nexport function isLocaleMap(value: unknown): value is LocaleMap {\n  if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n    return false;\n  }\n  // Check that all values are strings\n  return Object.values(value).every(v => typeof v === 'string');\n}\n\n/**\n * Check if a value is a LocalizedString.\n */\nexport function isLocalizedString(value: unknown): value is LocalizedString {\n  return typeof value === 'string' || isLocaleMap(value);\n}\n\n// ============================================================================\n// Resolution Functions\n// ============================================================================\n\n/**\n * Resolve a localized string to a specific locale.\n *\n * Resolution order:\n * 1. Requested locale (if provided)\n * 2. Fallback locale (if configured)\n * 3. Default locale\n * 4. First available locale (if none of the above match)\n * 5. undefined (if strict=false) or throws error (if strict=true)\n *\n * @param value - The localized string value\n * @param options - Resolution options\n * @returns The resolved string or undefined\n *\n * @example\n * // Simple string\n * resolveLocalizedString('Hello') // => 'Hello'\n *\n * // Multi-language with locale\n * resolveLocalizedString({ en: 'Hello', ja: 'こんにちは' }, { locale: 'ja' })\n * // => 'こんにちは'\n *\n * // Multi-language with fallback\n * resolveLocalizedString({ en: 'Hello', ja: 'こんにちは' }, { locale: 'ko' })\n * // => 'Hello' (falls back to defaultLocale)\n */\nexport function resolveLocalizedString(\n  value: LocalizedString | undefined | null,\n  options: LocaleResolutionOptions = {}\n): string | undefined {\n  if (value === undefined || value === null) {\n    return undefined;\n  }\n\n  // Simple string - return as-is\n  if (typeof value === 'string') {\n    return value;\n  }\n\n  const config = options.config ?? DEFAULT_LOCALE_CONFIG;\n  const requestedLocale = options.locale ?? config.defaultLocale;\n\n  // Try requested locale\n  if (requestedLocale in value) {\n    return value[requestedLocale];\n  }\n\n  // Try fallback locale\n  if (config.fallbackLocale && config.fallbackLocale in value) {\n    return value[config.fallbackLocale];\n  }\n\n  // Try default locale\n  if (config.defaultLocale in value) {\n    return value[config.defaultLocale];\n  }\n\n  // Try first available locale\n  const availableLocales = Object.keys(value);\n  const firstLocale = availableLocales[0];\n  if (firstLocale !== undefined) {\n    return value[firstLocale];\n  }\n\n  // No locale found\n  if (options.strict) {\n    throw new Error(\n      `Locale '${requestedLocale}' not found in localized string. ` +\n      `Available locales: none`\n    );\n  }\n\n  return undefined;\n}\n\n/**\n * Get all available locales from a localized string.\n *\n * @param value - The localized string value\n * @returns Array of available locale codes, or ['default'] for simple strings\n */\nexport function getAvailableLocales(\n  value: LocalizedString | undefined | null\n): readonly LocaleCode[] {\n  if (value === undefined || value === null) {\n    return [];\n  }\n\n  if (typeof value === 'string') {\n    return ['default'];\n  }\n\n  return Object.keys(value);\n}\n\n/**\n * Convert a localized string to a full LocaleMap.\n * Simple strings are converted to { [defaultLocale]: value }.\n *\n * @param value - The localized string value\n * @param defaultLocale - Default locale for simple strings\n * @returns LocaleMap or undefined\n */\nexport function toLocaleMap(\n  value: LocalizedString | undefined | null,\n  defaultLocale: LocaleCode = 'en'\n): LocaleMap | undefined {\n  if (value === undefined || value === null) {\n    return undefined;\n  }\n\n  if (typeof value === 'string') {\n    return { [defaultLocale]: value };\n  }\n\n  return value;\n}\n\n/**\n * Merge two localized strings, with the second taking precedence.\n *\n * @param base - Base localized string\n * @param override - Override localized string\n * @param defaultLocale - Default locale for simple strings\n * @returns Merged LocaleMap\n */\nexport function mergeLocalizedStrings(\n  base: LocalizedString | undefined | null,\n  override: LocalizedString | undefined | null,\n  defaultLocale: LocaleCode = 'en'\n): LocaleMap | undefined {\n  const baseMap = toLocaleMap(base, defaultLocale);\n  const overrideMap = toLocaleMap(override, defaultLocale);\n\n  if (!baseMap && !overrideMap) {\n    return undefined;\n  }\n\n  return {\n    ...baseMap,\n    ...overrideMap,\n  };\n}\n"],"mappings":";AA4GO,SAAS,GAAM,OAA4B;AAChD,SAAO,EAAE,IAAI,MAAM,MAAM;AAC3B;AAKO,SAAS,IAAO,OAA4B;AACjD,SAAO,EAAE,IAAI,OAAO,MAAM;AAC5B;;;ACRO,IAAM,wBAAsC;AAAA,EACjD,SAAS,CAAC,IAAI;AAAA,EACd,eAAe;AACjB;AAqCO,SAAS,YAAY,OAAoC;AAC9D,MAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,GAAG;AACvE,WAAO;AAAA,EACT;AAEA,SAAO,OAAO,OAAO,KAAK,EAAE,MAAM,OAAK,OAAO,MAAM,QAAQ;AAC9D;AAKO,SAAS,kBAAkB,OAA0C;AAC1E,SAAO,OAAO,UAAU,YAAY,YAAY,KAAK;AACvD;AAgCO,SAAS,uBACd,OACA,UAAmC,CAAC,GAChB;AACpB,MAAI,UAAU,UAAa,UAAU,MAAM;AACzC,WAAO;AAAA,EACT;AAGA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO;AAAA,EACT;AAEA,QAAM,SAAS,QAAQ,UAAU;AACjC,QAAM,kBAAkB,QAAQ,UAAU,OAAO;AAGjD,MAAI,mBAAmB,OAAO;AAC5B,WAAO,MAAM,eAAe;AAAA,EAC9B;AAGA,MAAI,OAAO,kBAAkB,OAAO,kBAAkB,OAAO;AAC3D,WAAO,MAAM,OAAO,cAAc;AAAA,EACpC;AAGA,MAAI,OAAO,iBAAiB,OAAO;AACjC,WAAO,MAAM,OAAO,aAAa;AAAA,EACnC;AAGA,QAAM,mBAAmB,OAAO,KAAK,KAAK;AAC1C,QAAM,cAAc,iBAAiB,CAAC;AACtC,MAAI,gBAAgB,QAAW;AAC7B,WAAO,MAAM,WAAW;AAAA,EAC1B;AAGA,MAAI,QAAQ,QAAQ;AAClB,UAAM,IAAI;AAAA,MACR,WAAW,eAAe;AAAA,IAE5B;AAAA,EACF;AAEA,SAAO;AACT;AAQO,SAAS,oBACd,OACuB;AACvB,MAAI,UAAU,UAAa,UAAU,MAAM;AACzC,WAAO,CAAC;AAAA,EACV;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,CAAC,SAAS;AAAA,EACnB;AAEA,SAAO,OAAO,KAAK,KAAK;AAC1B;AAUO,SAAS,YACd,OACA,gBAA4B,MACL;AACvB,MAAI,UAAU,UAAa,UAAU,MAAM;AACzC,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,EAAE,CAAC,aAAa,GAAG,MAAM;AAAA,EAClC;AAEA,SAAO;AACT;AAUO,SAAS,sBACd,MACA,UACA,gBAA4B,MACL;AACvB,QAAM,UAAU,YAAY,MAAM,aAAa;AAC/C,QAAM,cAAc,YAAY,UAAU,aAAa;AAEvD,MAAI,CAAC,WAAW,CAAC,aAAa;AAC5B,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,GAAG;AAAA,IACH,GAAG;AAAA,EACL;AACF;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@famgia/omnify-types",
-  "version": "0.0.77",
+  "version": "0.0.78",
   "description": "Shared TypeScript types for omnify-schema",
   "type": "module",
   "main": "./dist/index.js",

package/schemas/omnify-schema.json

@@ -11,7 +11,10 @@
     },
     "kind": {
       "type": "string",
-      "enum": ["object", "enum"],
+      "enum": [
+        "object",
+        "enum"
+      ],
       "default": "object",
       "description": "Schema kind - 'object' for database tables, 'enum' for enumeration types"
     },
@@ -41,8 +44,12 @@
       "type": "array",
       "items": {
         "oneOf": [
-          { "type": "string" },
-          { "$ref": "#/definitions/EnumValue" }
+          {
+            "type": "string"
+          },
+          {
+            "$ref": "#/definitions/EnumValue"
+          }
         ]
       },
       "description": "Enum values (only when kind is 'enum')"
@@ -51,10 +58,14 @@
   "definitions": {
     "LocalizedString": {
       "oneOf": [
-        { "type": "string" },
+        {
+          "type": "string"
+        },
         {
           "type": "object",
-          "additionalProperties": { "type": "string" },
+          "additionalProperties": {
+            "type": "string"
+          },
           "description": "Locale map (e.g., { ja: '日本語', en: 'English', vi: 'Tiếng Việt' })"
         }
       ],
@@ -70,7 +81,12 @@
         },
         "idType": {
           "type": "string",
-          "enum": ["BigInt", "Int", "Uuid", "String"],
+          "enum": [
+            "BigInt",
+            "Int",
+            "Uuid",
+            "String"
+          ],
           "default": "BigInt",
           "description": "Type of the auto-generated 'id' column"
         },
@@ -95,7 +111,9 @@
         },
         "indexes": {
           "type": "array",
-          "items": { "$ref": "#/definitions/IndexDefinition" },
+          "items": {
+            "$ref": "#/definitions/IndexDefinition"
+          },
           "description": "Database indexes for query optimization"
         },
         "hidden": {
@@ -107,11 +125,15 @@
     },
     "IndexDefinition": {
       "type": "object",
-      "required": ["columns"],
+      "required": [
+        "columns"
+      ],
       "properties": {
         "columns": {
           "type": "array",
-          "items": { "type": "string" },
+          "items": {
+            "type": "string"
+          },
           "description": "Columns to include in the index"
         },
         "unique": {
@@ -125,24 +147,53 @@
         },
         "type": {
           "type": "string",
-          "enum": ["btree", "hash", "fulltext", "spatial", "gin", "gist"],
+          "enum": [
+            "btree",
+            "hash",
+            "fulltext",
+            "spatial",
+            "gin",
+            "gist"
+          ],
           "description": "Index type"
         }
       }
     },
     "PropertyDefinition": {
       "oneOf": [
-        { "$ref": "#/definitions/StringProperty" },
-        { "$ref": "#/definitions/NumericProperty" },
-        { "$ref": "#/definitions/BooleanProperty" },
-        { "$ref": "#/definitions/TextProperty" },
-        { "$ref": "#/definitions/DateTimeProperty" },
-        { "$ref": "#/definitions/TimestampProperty" },
-        { "$ref": "#/definitions/JsonProperty" },
-        { "$ref": "#/definitions/EnumProperty" },
-        { "$ref": "#/definitions/EnumRefProperty" },
-        { "$ref": "#/definitions/FileProperty" },
-        { "$ref": "#/definitions/AssociationProperty" }
+        {
+          "$ref": "#/definitions/StringProperty"
+        },
+        {
+          "$ref": "#/definitions/NumericProperty"
+        },
+        {
+          "$ref": "#/definitions/BooleanProperty"
+        },
+        {
+          "$ref": "#/definitions/TextProperty"
+        },
+        {
+          "$ref": "#/definitions/DateTimeProperty"
+        },
+        {
+          "$ref": "#/definitions/TimestampProperty"
+        },
+        {
+          "$ref": "#/definitions/JsonProperty"
+        },
+        {
+          "$ref": "#/definitions/EnumProperty"
+        },
+        {
+          "$ref": "#/definitions/EnumRefProperty"
+        },
+        {
+          "$ref": "#/definitions/FileProperty"
+        },
+        {
+          "$ref": "#/definitions/AssociationProperty"
+        }
       ]
     },
     "ValidationRules": {
@@ -179,6 +230,10 @@
           "$ref": "#/definitions/LocalizedString",
           "description": "Field description/comment"
         },
+        "placeholder": {
+          "$ref": "#/definitions/LocalizedString",
+          "description": "Placeholder text for form inputs (supports multi-language)"
+        },
         "nullable": {
           "type": "boolean",
           "default": false,
@@ -200,19 +255,78 @@
         "rules": {
           "$ref": "#/definitions/ValidationRules",
           "description": "Validation rules (application-level only, NOT database)"
+        },
+        "hidden": {
+          "type": "boolean",
+          "default": false,
+          "description": "Whether this field should be hidden in API responses/serialization"
+        },
+        "fillable": {
+          "type": "boolean",
+          "default": true,
+          "description": "Whether this field is mass assignable (Laravel)"
+        },
+        "fields": {
+          "$ref": "#/definitions/CompoundFieldOverrides",
+          "description": "Per-field settings for compound types (nullable, hidden, fillable, placeholder overrides)"
+        }
+      }
+    },
+    "CompoundFieldOverrides": {
+      "type": "object",
+      "additionalProperties": {
+        "$ref": "#/definitions/CompoundFieldOverride"
+      },
+      "description": "Per-field overrides for compound types. Keys are field suffixes (e.g., 'Lastname', 'PostalCode')"
+    },
+    "CompoundFieldOverride": {
+      "type": "object",
+      "properties": {
+        "nullable": {
+          "type": "boolean",
+          "description": "Override nullable for this field"
+        },
+        "hidden": {
+          "type": "boolean",
+          "description": "Override hidden for this field"
+        },
+        "fillable": {
+          "type": "boolean",
+          "description": "Override fillable for this field"
+        },
+        "length": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Override length for string fields"
+        },
+        "displayName": {
+          "$ref": "#/definitions/LocalizedString",
+          "description": "Override display name (label) for this field (supports multi-language)"
+        },
+        "placeholder": {
+          "$ref": "#/definitions/LocalizedString",
+          "description": "Override placeholder for this field (supports multi-language)"
         }
       }
     },
     "StringProperty": {
       "allOf": [
-        { "$ref": "#/definitions/BaseProperty" },
+        {
+          "$ref": "#/definitions/BaseProperty"
+        },
         {
           "type": "object",
-          "required": ["type"],
+          "required": [
+            "type"
+          ],
           "properties": {
             "type": {
               "type": "string",
-              "enum": ["String", "Email", "Password"],
+              "enum": [
+                "String",
+                "Email",
+                "Password"
+              ],
               "description": "String type"
             },
             "length": {
@@ -228,14 +342,24 @@
     },
     "NumericProperty": {
       "allOf": [
-        { "$ref": "#/definitions/BaseProperty" },
+        {
+          "$ref": "#/definitions/BaseProperty"
+        },
         {
           "type": "object",
-          "required": ["type"],
+          "required": [
+            "type"
+          ],
           "properties": {
             "type": {
               "type": "string",
-              "enum": ["TinyInt", "Int", "BigInt", "Float", "Decimal"],
+              "enum": [
+                "TinyInt",
+                "Int",
+                "BigInt",
+                "Float",
+                "Decimal"
+              ],
               "description": "Numeric type - TinyInt (8-bit), Int (32-bit), BigInt (64-bit)"
             },
             "unsigned": {
@@ -257,10 +381,14 @@
     },
     "BooleanProperty": {
       "allOf": [
-        { "$ref": "#/definitions/BaseProperty" },
+        {
+          "$ref": "#/definitions/BaseProperty"
+        },
         {
           "type": "object",
-          "required": ["type"],
+          "required": [
+            "type"
+          ],
           "properties": {
             "type": {
               "const": "Boolean",
@@ -272,14 +400,22 @@
     },
     "TextProperty": {
       "allOf": [
-        { "$ref": "#/definitions/BaseProperty" },
+        {
+          "$ref": "#/definitions/BaseProperty"
+        },
         {
           "type": "object",
-          "required": ["type"],
+          "required": [
+            "type"
+          ],
           "properties": {
             "type": {
               "type": "string",
-              "enum": ["Text", "MediumText", "LongText"],
+              "enum": [
+                "Text",
+                "MediumText",
+                "LongText"
+              ],
               "description": "Text type - Text (~65KB), MediumText (~16MB), LongText (~4GB)"
             }
           }
@@ -288,14 +424,22 @@
     },
     "DateTimeProperty": {
       "allOf": [
-        { "$ref": "#/definitions/BaseProperty" },
+        {
+          "$ref": "#/definitions/BaseProperty"
+        },
         {
           "type": "object",
-          "required": ["type"],
+          "required": [
+            "type"
+          ],
           "properties": {
             "type": {
               "type": "string",
-              "enum": ["Date", "DateTime", "Time"],
+              "enum": [
+                "Date",
+                "DateTime",
+                "Time"
+              ],
               "description": "Date/Time type"
             }
           }
@@ -304,10 +448,14 @@
     },
     "TimestampProperty": {
       "allOf": [
-        { "$ref": "#/definitions/BaseProperty" },
+        {
+          "$ref": "#/definitions/BaseProperty"
+        },
         {
           "type": "object",
-          "required": ["type"],
+          "required": [
+            "type"
+          ],
           "properties": {
             "type": {
               "const": "Timestamp",
@@ -329,10 +477,14 @@
     },
     "JsonProperty": {
       "allOf": [
-        { "$ref": "#/definitions/BaseProperty" },
+        {
+          "$ref": "#/definitions/BaseProperty"
+        },
         {
           "type": "object",
-          "required": ["type"],
+          "required": [
+            "type"
+          ],
           "properties": {
             "type": {
               "const": "Json",
@@ -344,10 +496,15 @@
     },
     "EnumProperty": {
       "allOf": [
-        { "$ref": "#/definitions/BaseProperty" },
+        {
+          "$ref": "#/definitions/BaseProperty"
+        },
         {
           "type": "object",
-          "required": ["type", "enum"],
+          "required": [
+            "type",
+            "enum"
+          ],
           "properties": {
             "type": {
               "const": "Enum",
@@ -357,8 +514,12 @@
               "type": "array",
               "items": {
                 "oneOf": [
-                  { "type": "string" },
-                  { "$ref": "#/definitions/EnumValue" }
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "$ref": "#/definitions/EnumValue"
+                  }
                 ]
               },
               "description": "Inline enum values"
@@ -369,10 +530,15 @@
     },
     "EnumRefProperty": {
       "allOf": [
-        { "$ref": "#/definitions/BaseProperty" },
+        {
+          "$ref": "#/definitions/BaseProperty"
+        },
         {
           "type": "object",
-          "required": ["type", "enum"],
+          "required": [
+            "type",
+            "enum"
+          ],
           "properties": {
             "type": {
               "const": "EnumRef",
@@ -388,7 +554,9 @@
     },
     "EnumValue": {
       "type": "object",
-      "required": ["value"],
+      "required": [
+        "value"
+      ],
       "properties": {
         "value": {
           "type": "string",
@@ -406,10 +574,14 @@
     },
     "FileProperty": {
       "allOf": [
-        { "$ref": "#/definitions/BaseProperty" },
+        {
+          "$ref": "#/definitions/BaseProperty"
+        },
         {
           "type": "object",
-          "required": ["type"],
+          "required": [
+            "type"
+          ],
           "properties": {
             "type": {
               "const": "File",
@@ -426,7 +598,9 @@
             },
             "accept": {
               "type": "array",
-              "items": { "type": "string" },
+              "items": {
+                "type": "string"
+              },
               "description": "Accepted file extensions (e.g., ['jpg', 'png', 'pdf'])"
             },
             "maxSize": {
@@ -439,7 +613,10 @@
     },
     "AssociationProperty": {
       "type": "object",
-      "required": ["type", "relation"],
+      "required": [
+        "type",
+        "relation"
+      ],
       "properties": {
         "type": {
           "const": "Association",
@@ -470,12 +647,24 @@
         },
         "onDelete": {
           "type": "string",
-          "enum": ["CASCADE", "SET NULL", "SET DEFAULT", "RESTRICT", "NO ACTION"],
+          "enum": [
+            "CASCADE",
+            "SET NULL",
+            "SET DEFAULT",
+            "RESTRICT",
+            "NO ACTION"
+          ],
           "description": "Action when referenced record is deleted"
         },
         "onUpdate": {
           "type": "string",
-          "enum": ["CASCADE", "SET NULL", "SET DEFAULT", "RESTRICT", "NO ACTION"],
+          "enum": [
+            "CASCADE",
+            "SET NULL",
+            "SET DEFAULT",
+            "RESTRICT",
+            "NO ACTION"
+          ],
           "description": "Action when referenced record is updated"
         },
         "joinTable": {
@@ -492,7 +681,9 @@
         },
         "targets": {
           "type": "array",
-          "items": { "type": "string" },
+          "items": {
+            "type": "string"
+          },
           "description": "Target schema names for MorphTo (e.g., ['Post', 'Video'])"
         },
         "morphName": {
@@ -521,12 +712,18 @@
       "properties": {
         "name": {
           "type": "String",
-          "displayName": { "ja": "氏名", "en": "Full Name" }
+          "displayName": {
+            "ja": "氏名",
+            "en": "Full Name"
+          }
         },
         "email": {
           "type": "Email",
           "unique": true,
-          "displayName": { "ja": "メールアドレス", "en": "Email" }
+          "displayName": {
+            "ja": "メールアドレス",
+            "en": "Email"
+          }
         },
         "password": {
           "type": "Password"
@@ -547,18 +744,33 @@
       "options": {
         "softDelete": true,
         "indexes": [
-          { "columns": ["published_at"] },
-          { "columns": ["status", "published_at"] }
+          {
+            "columns": [
+              "published_at"
+            ]
+          },
+          {
+            "columns": [
+              "status",
+              "published_at"
+            ]
+          }
         ]
       },
       "properties": {
         "title": {
           "type": "String",
-          "displayName": { "ja": "タイトル", "en": "Title" }
+          "displayName": {
+            "ja": "タイトル",
+            "en": "Title"
+          }
         },
         "content": {
           "type": "LongText",
-          "displayName": { "ja": "本文", "en": "Content" }
+          "displayName": {
+            "ja": "本文",
+            "en": "Content"
+          }
         },
         "status": {
           "type": "EnumRef",
@@ -581,9 +793,27 @@
         "en": "Post Status"
       },
       "values": [
-        { "value": "draft", "label": { "ja": "下書き", "en": "Draft" } },
-        { "value": "published", "label": { "ja": "公開済み", "en": "Published" } },
-        { "value": "archived", "label": { "ja": "アーカイブ", "en": "Archived" } }
+        {
+          "value": "draft",
+          "label": {
+            "ja": "下書き",
+            "en": "Draft"
+          }
+        },
+        {
+          "value": "published",
+          "label": {
+            "ja": "公開済み",
+            "en": "Published"
+          }
+        },
+        {
+          "value": "archived",
+          "label": {
+            "ja": "アーカイブ",
+            "en": "Archived"
+          }
+        }
       ]
     },
     {
@@ -600,17 +830,26 @@
         "key": {
           "type": "String",
           "primary": true,
-          "displayName": { "ja": "キー", "en": "Key" }
+          "displayName": {
+            "ja": "キー",
+            "en": "Key"
+          }
         },
         "value": {
           "type": "Text",
-          "displayName": { "ja": "値", "en": "Value" }
+          "displayName": {
+            "ja": "値",
+            "en": "Value"
+          }
         },
         "expiration": {
           "type": "Int",
-          "displayName": { "ja": "有効期限", "en": "Expiration" }
+          "displayName": {
+            "ja": "有効期限",
+            "en": "Expiration"
+          }
         }
       }
     }
   ]
-}
+}