@famgia/omnify-typescript 0.0.67 → 0.0.69

package/dist/plugin.d.cts

@@ -41,6 +41,12 @@ interface TypeScriptPluginOptions {
      * @default true
      */
     generateZodSchemas?: boolean;
+    /**
+     * Path for React utility stubs (hooks, components, lib).
+     * Set to false to disable stub generation.
+     * @default 'omnify'
+     */
+    stubsPath?: string | false;
 }
 /**
  * Creates the TypeScript plugin with the specified options.

package/dist/plugin.d.ts

@@ -41,6 +41,12 @@ interface TypeScriptPluginOptions {
      * @default true
      */
     generateZodSchemas?: boolean;
+    /**
+     * Path for React utility stubs (hooks, components, lib).
+     * Set to false to disable stub generation.
+     * @default 'omnify'
+     */
+    stubsPath?: string | false;
 }
 /**
  * Creates the TypeScript plugin with the specified options.

package/dist/plugin.js

@@ -1,8 +1,13 @@
 import {
   generateTypeScript
-} from "./chunk-4L77AHAC.js";
+} from "./chunk-6I4O23X6.js";
 
 // src/plugin.ts
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = path.dirname(__filename);
 var TYPESCRIPT_CONFIG_SCHEMA = {
   fields: [
     {
@@ -20,15 +25,38 @@ var TYPESCRIPT_CONFIG_SCHEMA = {
       description: "Generate Zod schemas alongside TypeScript types for form validation",
       default: true,
       group: "output"
+    },
+    {
+      key: "stubsPath",
+      type: "path",
+      label: "React Stubs Path",
+      description: "Directory for React utility stubs (hooks, components). Leave empty to disable.",
+      default: "omnify",
+      group: "output"
     }
   ]
 };
 function resolveOptions(options) {
   return {
     modelsPath: options?.modelsPath ?? "types/schemas",
-    generateZodSchemas: options?.generateZodSchemas ?? true
+    generateZodSchemas: options?.generateZodSchemas ?? true,
+    stubsPath: options?.stubsPath ?? "omnify"
   };
 }
+var STUB_FILES = [
+  {
+    stub: "CompoundField.tsx.stub",
+    output: "components/CompoundField.tsx"
+  },
+  {
+    stub: "use-form-mutation.ts.stub",
+    output: "hooks/use-form-mutation.ts"
+  },
+  {
+    stub: "form-validation.ts.stub",
+    output: "lib/form-validation.ts"
+  }
+];
 function typescriptPlugin(options) {
   const resolved = resolveOptions(options);
   return {
@@ -43,17 +71,74 @@ function typescriptPlugin(options) {
           const files = generateTypeScript(ctx.schemas, {
             generateZodSchemas: resolved.generateZodSchemas,
             localeConfig: ctx.localeConfig,
-            customTypes: ctx.customTypes
+            customTypes: ctx.customTypes,
+            pluginEnums: ctx.pluginEnums
           });
-          return files.map((file) => ({
-            path: `${resolved.modelsPath}/${file.filePath}`,
-            content: file.content,
-            type: "type",
-            overwrite: file.overwrite,
-            metadata: {
-              types: file.types
+          return files.map((file) => {
+            let outputPath;
+            if (file.category === "enum") {
+              const enumPath = resolved.modelsPath.replace(/\/schemas\/?$/, "/enum");
+              outputPath = `${enumPath}/${file.filePath}`;
+            } else {
+              outputPath = `${resolved.modelsPath}/${file.filePath}`;
             }
-          }));
+            return {
+              path: outputPath,
+              content: file.content,
+              type: "type",
+              skipIfExists: !file.overwrite,
+              // Invert: overwrite=true means skipIfExists=false
+              metadata: {
+                types: file.types
+              }
+            };
+          });
+        }
+      },
+      {
+        name: "typescript-stubs",
+        description: "Generate React utility stubs (hooks, components)",
+        generate: async () => {
+          if (resolved.stubsPath === false) {
+            return [];
+          }
+          const outputs = [];
+          const stubsDir = path.join(__dirname, "..", "stubs");
+          for (const { stub, output } of STUB_FILES) {
+            const stubPath = path.join(stubsDir, stub);
+            if (fs.existsSync(stubPath)) {
+              const content = fs.readFileSync(stubPath, "utf-8");
+              outputs.push({
+                path: `${resolved.stubsPath}/${output}`,
+                content,
+                type: "other",
+                skipIfExists: true
+                // Never overwrite - user can customize
+              });
+            }
+          }
+          outputs.push({
+            path: `${resolved.stubsPath}/components/index.ts`,
+            content: `export { CompoundField, type FieldConfig } from './CompoundField';
+`,
+            type: "other",
+            skipIfExists: true
+          });
+          outputs.push({
+            path: `${resolved.stubsPath}/hooks/index.ts`,
+            content: `export { useFormMutation } from './use-form-mutation';
+`,
+            type: "other",
+            skipIfExists: true
+          });
+          outputs.push({
+            path: `${resolved.stubsPath}/lib/index.ts`,
+            content: `export { zodRule, requiredRule } from './form-validation';
+`,
+            type: "other",
+            skipIfExists: true
+          });
+          return outputs;
         }
       }
     ]

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/plugin.ts"],"sourcesContent":["/**\n * @famgia/omnify-typescript - Plugin\n *\n * Plugin for generating TypeScript type definitions and Zod schemas from Omnify schemas.\n *\n * Output structure:\n * - types/schemas/base/[SchemaName].ts - Auto-generated base interfaces + Zod schemas, always overwritten\n * - types/schemas/enum/[EnumName].ts - Auto-generated enums/type aliases, always overwritten\n * - types/schemas/[SchemaName].ts - Extends base, user can customize, never overwritten\n * - types/schemas/index.ts - Re-exports, always overwritten\n *\n * @example\n * ```typescript\n * import { defineConfig } from '@famgia/omnify';\n * import typescript from '@famgia/omnify-typescript/plugin';\n *\n * export default defineConfig({\n *   plugins: [\n *     typescript({\n *       modelsPath: 'types/schemas', // default\n *       generateZodSchemas: true,    // default\n *     }),\n *   ],\n * });\n * ```\n */\n\nimport type { OmnifyPlugin, GeneratorOutput, GeneratorContext, PluginConfigSchema } from '@famgia/omnify-types';\nimport { generateTypeScript } from './generator.js';\n\n/**\n * Configuration schema for TypeScript plugin UI settings\n */\nconst TYPESCRIPT_CONFIG_SCHEMA: PluginConfigSchema = {\n  fields: [\n    {\n      key: 'modelsPath',\n      type: 'path',\n      label: 'Schemas Output Path',\n      description: 'Directory for generated TypeScript types and Zod schemas',\n      default: 'types/schemas',\n      group: 'output',\n    },\n    {\n      key: 'generateZodSchemas',\n      type: 'boolean',\n      label: 'Generate Zod Schemas',\n      description: 'Generate Zod schemas alongside TypeScript types for form validation',\n      default: true,\n      group: 'output',\n    },\n  ],\n};\n\n/**\n * Options for the TypeScript plugin.\n */\nexport interface TypeScriptPluginOptions {\n  /**\n   * Path for TypeScript model files.\n   * @default 'types/schemas'\n   */\n  modelsPath?: string;\n  /**\n   * Generate Zod schemas alongside TypeScript types.\n   * @default true\n   */\n  generateZodSchemas?: boolean;\n}\n\n/**\n * Resolved options with defaults applied.\n */\ninterface ResolvedOptions {\n  modelsPath: string;\n  generateZodSchemas: boolean;\n}\n\n/**\n * Resolves options with defaults.\n */\nfunction resolveOptions(options?: TypeScriptPluginOptions): ResolvedOptions {\n  return {\n    modelsPath: options?.modelsPath ?? 'types/schemas',\n    generateZodSchemas: options?.generateZodSchemas ?? true,\n  };\n}\n\n/**\n * Creates the TypeScript plugin with the specified options.\n *\n * @param options - Plugin configuration options\n * @returns OmnifyPlugin configured for TypeScript generation\n */\nexport default function typescriptPlugin(options?: TypeScriptPluginOptions): OmnifyPlugin {\n  const resolved = resolveOptions(options);\n\n  return {\n    name: '@famgia/omnify-typescript',\n    version: '0.0.1',\n    configSchema: TYPESCRIPT_CONFIG_SCHEMA,\n\n    generators: [\n      {\n        name: 'typescript-models',\n        description: 'Generate TypeScript model definitions',\n\n        generate: async (ctx: GeneratorContext): Promise<GeneratorOutput[]> => {\n          const files = generateTypeScript(ctx.schemas, {\n            generateZodSchemas: resolved.generateZodSchemas,\n            localeConfig: ctx.localeConfig,\n            customTypes: ctx.customTypes,\n          });\n\n          return files.map((file) => ({\n            path: `${resolved.modelsPath}/${file.filePath}`,\n            content: file.content,\n            type: 'type' as const,\n            overwrite: file.overwrite,\n            metadata: {\n              types: file.types,\n            },\n          }));\n        },\n      },\n    ],\n  };\n}\n\n// Named export for flexibility\nexport { typescriptPlugin };\n"],"mappings":";;;;;AAiCA,IAAM,2BAA+C;AAAA,EACnD,QAAQ;AAAA,IACN;AAAA,MACE,KAAK;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,aAAa;AAAA,MACb,SAAS;AAAA,MACT,OAAO;AAAA,IACT;AAAA,IACA;AAAA,MACE,KAAK;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,aAAa;AAAA,MACb,SAAS;AAAA,MACT,OAAO;AAAA,IACT;AAAA,EACF;AACF;AA6BA,SAAS,eAAe,SAAoD;AAC1E,SAAO;AAAA,IACL,YAAY,SAAS,cAAc;AAAA,IACnC,oBAAoB,SAAS,sBAAsB;AAAA,EACrD;AACF;AAQe,SAAR,iBAAkC,SAAiD;AACxF,QAAM,WAAW,eAAe,OAAO;AAEvC,SAAO;AAAA,IACL,MAAM;AAAA,IACN,SAAS;AAAA,IACT,cAAc;AAAA,IAEd,YAAY;AAAA,MACV;AAAA,QACE,MAAM;AAAA,QACN,aAAa;AAAA,QAEb,UAAU,OAAO,QAAsD;AACrE,gBAAM,QAAQ,mBAAmB,IAAI,SAAS;AAAA,YAC5C,oBAAoB,SAAS;AAAA,YAC7B,cAAc,IAAI;AAAA,YAClB,aAAa,IAAI;AAAA,UACnB,CAAC;AAED,iBAAO,MAAM,IAAI,CAAC,UAAU;AAAA,YAC1B,MAAM,GAAG,SAAS,UAAU,IAAI,KAAK,QAAQ;AAAA,YAC7C,SAAS,KAAK;AAAA,YACd,MAAM;AAAA,YACN,WAAW,KAAK;AAAA,YAChB,UAAU;AAAA,cACR,OAAO,KAAK;AAAA,YACd;AAAA,UACF,EAAE;AAAA,QACJ;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../src/plugin.ts"],"sourcesContent":["/**\n * @famgia/omnify-typescript - Plugin\n *\n * Plugin for generating TypeScript type definitions and Zod schemas from Omnify schemas.\n *\n * Output structure:\n * - types/schemas/base/[SchemaName].ts - Auto-generated base interfaces + Zod schemas, always overwritten\n * - types/schemas/enum/[EnumName].ts - Auto-generated enums/type aliases, always overwritten\n * - types/schemas/[SchemaName].ts - Extends base, user can customize, never overwritten\n * - types/schemas/index.ts - Re-exports, always overwritten\n *\n * @example\n * ```typescript\n * import { defineConfig } from '@famgia/omnify';\n * import typescript from '@famgia/omnify-typescript/plugin';\n *\n * export default defineConfig({\n *   plugins: [\n *     typescript({\n *       modelsPath: 'types/schemas', // default\n *       generateZodSchemas: true,    // default\n *     }),\n *   ],\n * });\n * ```\n */\n\nimport type { OmnifyPlugin, GeneratorOutput, GeneratorContext, PluginConfigSchema } from '@famgia/omnify-types';\nimport { generateTypeScript } from './generator.js';\nimport fs from 'fs';\nimport path from 'path';\nimport { fileURLToPath } from 'url';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\n/**\n * Configuration schema for TypeScript plugin UI settings\n */\nconst TYPESCRIPT_CONFIG_SCHEMA: PluginConfigSchema = {\n  fields: [\n    {\n      key: 'modelsPath',\n      type: 'path',\n      label: 'Schemas Output Path',\n      description: 'Directory for generated TypeScript types and Zod schemas',\n      default: 'types/schemas',\n      group: 'output',\n    },\n    {\n      key: 'generateZodSchemas',\n      type: 'boolean',\n      label: 'Generate Zod Schemas',\n      description: 'Generate Zod schemas alongside TypeScript types for form validation',\n      default: true,\n      group: 'output',\n    },\n    {\n      key: 'stubsPath',\n      type: 'path',\n      label: 'React Stubs Path',\n      description: 'Directory for React utility stubs (hooks, components). Leave empty to disable.',\n      default: 'omnify',\n      group: 'output',\n    },\n  ],\n};\n\n/**\n * Options for the TypeScript plugin.\n */\nexport interface TypeScriptPluginOptions {\n  /**\n   * Path for TypeScript model files.\n   * @default 'types/schemas'\n   */\n  modelsPath?: string;\n  /**\n   * Generate Zod schemas alongside TypeScript types.\n   * @default true\n   */\n  generateZodSchemas?: boolean;\n  /**\n   * Path for React utility stubs (hooks, components, lib).\n   * Set to false to disable stub generation.\n   * @default 'omnify'\n   */\n  stubsPath?: string | false;\n}\n\n/**\n * Resolved options with defaults applied.\n */\ninterface ResolvedOptions {\n  modelsPath: string;\n  generateZodSchemas: boolean;\n  stubsPath: string | false;\n}\n\n/**\n * Resolves options with defaults.\n */\nfunction resolveOptions(options?: TypeScriptPluginOptions): ResolvedOptions {\n  return {\n    modelsPath: options?.modelsPath ?? 'types/schemas',\n    generateZodSchemas: options?.generateZodSchemas ?? true,\n    stubsPath: options?.stubsPath ?? 'omnify',\n  };\n}\n\n/**\n * Stub file definitions for React utilities.\n */\nconst STUB_FILES = [\n  {\n    stub: 'CompoundField.tsx.stub',\n    output: 'components/CompoundField.tsx',\n  },\n  {\n    stub: 'use-form-mutation.ts.stub',\n    output: 'hooks/use-form-mutation.ts',\n  },\n  {\n    stub: 'form-validation.ts.stub',\n    output: 'lib/form-validation.ts',\n  },\n];\n\n/**\n * Creates the TypeScript plugin with the specified options.\n *\n * @param options - Plugin configuration options\n * @returns OmnifyPlugin configured for TypeScript generation\n */\nexport default function typescriptPlugin(options?: TypeScriptPluginOptions): OmnifyPlugin {\n  const resolved = resolveOptions(options);\n\n  return {\n    name: '@famgia/omnify-typescript',\n    version: '0.0.1',\n    configSchema: TYPESCRIPT_CONFIG_SCHEMA,\n\n    generators: [\n      {\n        name: 'typescript-models',\n        description: 'Generate TypeScript model definitions',\n\n        generate: async (ctx: GeneratorContext): Promise<GeneratorOutput[]> => {\n          const files = generateTypeScript(ctx.schemas, {\n            generateZodSchemas: resolved.generateZodSchemas,\n            localeConfig: ctx.localeConfig,\n            customTypes: ctx.customTypes,\n            pluginEnums: ctx.pluginEnums,\n          });\n\n          return files.map((file) => {\n            // Determine output path based on category\n            let outputPath: string;\n            if (file.category === 'enum') {\n              // Enum files go to ../enum/ folder (sibling to schemas)\n              const enumPath = resolved.modelsPath.replace(/\\/schemas\\/?$/, '/enum');\n              outputPath = `${enumPath}/${file.filePath}`;\n            } else {\n              outputPath = `${resolved.modelsPath}/${file.filePath}`;\n            }\n\n            return {\n              path: outputPath,\n              content: file.content,\n              type: 'type' as const,\n              skipIfExists: !file.overwrite, // Invert: overwrite=true means skipIfExists=false\n              metadata: {\n                types: file.types,\n              },\n            };\n          });\n        },\n      },\n      {\n        name: 'typescript-stubs',\n        description: 'Generate React utility stubs (hooks, components)',\n\n        generate: async (): Promise<GeneratorOutput[]> => {\n          // Skip if stubs disabled\n          if (resolved.stubsPath === false) {\n            return [];\n          }\n\n          const outputs: GeneratorOutput[] = [];\n          const stubsDir = path.join(__dirname, '..', 'stubs');\n\n          for (const { stub, output } of STUB_FILES) {\n            const stubPath = path.join(stubsDir, stub);\n            if (fs.existsSync(stubPath)) {\n              const content = fs.readFileSync(stubPath, 'utf-8');\n              outputs.push({\n                path: `${resolved.stubsPath}/${output}`,\n                content,\n                type: 'other' as const,\n                skipIfExists: true, // Never overwrite - user can customize\n              });\n            }\n          }\n\n          // Generate index files\n          outputs.push({\n            path: `${resolved.stubsPath}/components/index.ts`,\n            content: `export { CompoundField, type FieldConfig } from './CompoundField';\\n`,\n            type: 'other' as const,\n            skipIfExists: true,\n          });\n\n          outputs.push({\n            path: `${resolved.stubsPath}/hooks/index.ts`,\n            content: `export { useFormMutation } from './use-form-mutation';\\n`,\n            type: 'other' as const,\n            skipIfExists: true,\n          });\n\n          outputs.push({\n            path: `${resolved.stubsPath}/lib/index.ts`,\n            content: `export { zodRule, requiredRule } from './form-validation';\\n`,\n            type: 'other' as const,\n            skipIfExists: true,\n          });\n\n          return outputs;\n        },\n      },\n    ],\n  };\n}\n\n// Named export for flexibility\nexport { typescriptPlugin };\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@famgia/omnify-typescript",
-  "version": "0.0.67",
+  "version": "0.0.69",
   "description": "TypeScript type definitions generator for Omnify schemas",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -31,7 +31,7 @@
   "files": [
     "dist",
     "scripts",
-    "ai-guides"
+    "stubs"
   ],
   "keywords": [
     "omnify",
@@ -48,7 +48,7 @@
     "directory": "packages/typescript-generator"
   },
   "dependencies": {
-    "@famgia/omnify-types": "0.0.77"
+    "@famgia/omnify-types": "0.0.79"
   },
   "peerDependencies": {
     "zod": "^3.0.0"

package/scripts/postinstall.js

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
 
+/**
+ * @famgia/omnify-typescript postinstall
+ * Copies TypeScript AI guides to .claude/omnify/
+ */
+
 import fs from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
@@ -7,64 +12,48 @@ import { fileURLToPath } from 'url';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
-function findProjectRoot() {
-  // npm/pnpm set INIT_CWD to the directory where the install was run
-  let dir = process.env.INIT_CWD || process.cwd();
+function main() {
+  // Skip in CI
+  if (process.env.CI || process.env.CONTINUOUS_INTEGRATION) {
+    return;
+  }
+
+  // Skip in monorepo source (but allow examples/)
+  const projectDir = process.env.INIT_CWD || process.cwd();
+  if (projectDir.includes('omnify-ts') && !projectDir.includes('omnify-ts/examples')) {
+    return;
+  }
+
+  // Find project root
+  let dir = projectDir;
   const nodeModulesIndex = dir.indexOf('node_modules');
   if (nodeModulesIndex !== -1) {
     dir = dir.substring(0, nodeModulesIndex - 1);
   }
-  const packageJsonPath = path.join(dir, 'package.json');
-  if (fs.existsSync(packageJsonPath)) {
-    return dir;
+  if (!fs.existsSync(path.join(dir, 'package.json'))) {
+    return;
   }
-  return null;
-}
 
-function copyAiGuidesToProject(projectRoot) {
-  const omnifyDir = path.join(projectRoot, '.claude', 'omnify');
+  // Copy ai-guides to .claude/omnify/
+  const omnifyDir = path.join(dir, '.claude', 'omnify');
   const aiGuidesDir = path.join(__dirname, '..', 'ai-guides');
 
   try {
-    // Create target directory
     if (!fs.existsSync(omnifyDir)) {
       fs.mkdirSync(omnifyDir, { recursive: true });
     }
 
-    // Copy all files from ai-guides directory
     if (fs.existsSync(aiGuidesDir)) {
-      const files = fs.readdirSync(aiGuidesDir);
-      for (const file of files) {
-        const srcPath = path.join(aiGuidesDir, file);
-        const destPath = path.join(omnifyDir, file);
-
-        if (fs.statSync(srcPath).isFile()) {
-          fs.copyFileSync(srcPath, destPath);
-          console.log(`  Created .claude/omnify/${file}`);
+      for (const file of fs.readdirSync(aiGuidesDir)) {
+        const src = path.join(aiGuidesDir, file);
+        const dest = path.join(omnifyDir, file);
+        if (fs.statSync(src).isFile()) {
+          fs.copyFileSync(src, dest);
         }
       }
     }
-
-    return true;
   } catch {
-    return false;
-  }
-}
-
-function main() {
-  if (process.env.CI || process.env.CONTINUOUS_INTEGRATION) {
-    return;
-  }
-
-  // Skip if in omnify-ts monorepo (source code), but allow examples/
-  const projectDir = process.env.INIT_CWD || process.cwd();
-  if (projectDir.includes('omnify-ts') && !projectDir.includes('omnify-ts/examples')) {
-    return;
-  }
-
-  const projectRoot = findProjectRoot();
-  if (projectRoot) {
-    copyAiGuidesToProject(projectRoot);
+    // Silent fail
   }
 }
 

package/stubs/JapaneseAddressField.tsx.stub

@@ -0,0 +1,289 @@
+/**
+ * JapaneseAddressField - Japanese address input component
+ * Handles postal code, prefecture, address fields with postal code lookup
+ */
+import { useState, useCallback } from 'react';
+import { Form, Input, Select, Button, message } from 'antd';
+import { SearchOutlined, LoadingOutlined } from '@ant-design/icons';
+import type { FormInstance } from 'antd';
+import type { RuleObject } from 'antd/es/form';
+import { zodRule } from '../lib/form-validation';
+import { getZodLocale } from '../lib/zod-i18n';
+import { Prefecture, PrefectureValues, getPrefectureLabel, getPrefectureExtra } from '../enum/plugin/Prefecture';
+
+interface I18nConfig {
+    fields: Record<string, { label?: Record<string, string>; placeholder?: Record<string, string> }>;
+}
+
+interface SelectOption {
+    value: string | number;
+    label: string;
+}
+
+interface PostalLookupResult {
+    prefecture?: string;
+    prefectureCode?: string;
+    prefectureName?: string;
+    address1?: string;
+    address2?: string;
+}
+
+interface JapaneseAddressFieldProps {
+    form: FormInstance;
+    schemas: Record<string, unknown>;
+    i18n: I18nConfig;
+    prefix?: string;
+    usePrefectureId?: boolean;
+    prefectureOptions?: SelectOption[];
+    enablePostalLookup?: boolean;
+    showSearchButton?: boolean;
+    autoSearch?: boolean;
+    onPostalLookup?: (postalCode: string) => Promise<PostalLookupResult | null>;
+}
+
+function getLabel(i18n: I18nConfig, field: string, locale: string): string {
+    return i18n.fields[field]?.label?.[locale] ?? i18n.fields[field]?.label?.['en'] ?? field;
+}
+
+function getPlaceholder(i18n: I18nConfig, field: string, locale: string): string {
+    return i18n.fields[field]?.placeholder?.[locale] ?? i18n.fields[field]?.placeholder?.['en'] ?? '';
+}
+
+// Build prefecture code to string key mapping from generated enum
+const PREFECTURE_CODE_TO_KEY: Record<string, string> = Object.fromEntries(
+    PrefectureValues.map((key) => {
+        const extra = getPrefectureExtra(key);
+        return [String(extra?.code ?? ''), key];
+    })
+);
+
+// Build default prefecture options from generated enum
+function buildPrefectureOptions(locale: string): SelectOption[] {
+    return PrefectureValues.map((key) => ({
+        value: key,
+        label: getPrefectureLabel(key, locale),
+    }));
+}
+
+// Default postal lookup function using zipcloud API
+async function lookupPostalCode(postalCode: string): Promise<PostalLookupResult | null> {
+    try {
+        const response = await fetch(`https://zipcloud.ibsnet.co.jp/api/search?zipcode=${postalCode}`);
+        const data = await response.json();
+
+        if (data.results && data.results.length > 0) {
+            const result = data.results[0];
+            const prefectureKey = PREFECTURE_CODE_TO_KEY[result.prefcode];
+            return {
+                prefecture: prefectureKey,
+                prefectureCode: result.prefcode,
+                prefectureName: result.address1,
+                address1: result.address2,
+                address2: result.address3,
+            };
+        }
+        return null;
+    } catch (error) {
+        console.error('Postal code lookup failed:', error);
+        return null;
+    }
+}
+
+// Localized messages
+const MESSAGES = {
+    ja: {
+        searchAddress: '住所検索',
+        searching: '検索中...',
+        notFound: '郵便番号が見つかりませんでした',
+        error: '住所検索に失敗しました',
+        invalidFormat: '郵便番号の形式が正しくありません（例：123-4567）',
+    },
+    en: {
+        searchAddress: 'Search Address',
+        searching: 'Searching...',
+        notFound: 'Postal code not found',
+        error: 'Address lookup failed',
+        invalidFormat: 'Invalid postal code format (e.g., 123-4567)',
+    },
+    vi: {
+        searchAddress: 'Tìm địa chỉ',
+        searching: 'Đang tìm...',
+        notFound: 'Không tìm thấy mã bưu điện',
+        error: 'Tìm địa chỉ thất bại',
+        invalidFormat: 'Định dạng mã bưu điện không hợp lệ (VD: 123-4567)',
+    },
+} as const;
+
+function getMessage(key: keyof typeof MESSAGES.ja, locale: string): string {
+    return (MESSAGES as any)[locale]?.[key] ?? MESSAGES.ja[key];
+}
+
+export function JapaneseAddressField({
+    form,
+    schemas,
+    i18n,
+    prefix = 'address',
+    usePrefectureId = false,
+    prefectureOptions,
+    enablePostalLookup = true,
+    showSearchButton = true,
+    autoSearch = true,
+    onPostalLookup,
+}: JapaneseAddressFieldProps) {
+    const locale = getZodLocale();
+    const [isSearching, setIsSearching] = useState(false);
+
+    // Field names
+    const postalCodeField = `${prefix}_postal_code`;
+    const prefectureField = usePrefectureId
+        ? `${prefix}_prefecture_id`
+        : `${prefix}_prefecture`;
+    const address1Field = `${prefix}_address1`;
+    const address2Field = `${prefix}_address2`;
+    const address3Field = `${prefix}_address3`;
+
+    // Use generated prefecture options
+    const options = prefectureOptions ?? buildPrefectureOptions(locale);
+
+    // Get rules from schemas
+    const getRule = (field: string): RuleObject[] => {
+        const schema = schemas[field];
+        if (!schema) return [];
+        return [zodRule(schema as any, getLabel(i18n, field, locale))];
+    };
+
+    // Check if a field is required by examining its Zod schema description
+    const isRequired = (field: string): boolean => {
+        const schema = schemas[field];
+        if (!schema) return false;
+        // Check if schema has .optional() or .nullable() - these make it not required
+        const schemaDesc = (schema as any)?._def?.typeName;
+        const inner = (schema as any)?._def?.innerType;
+        // ZodOptional or ZodNullable means not required
+        if (schemaDesc === 'ZodOptional' || schemaDesc === 'ZodNullable') return false;
+        if (inner?._def?.typeName === 'ZodOptional' || inner?._def?.typeName === 'ZodNullable') return false;
+        return true;
+    };
+
+    // Lookup address from postal code
+    const doLookup = useCallback(async (postalCode: string) => {
+        const digits = postalCode.replace(/[^0-9]/g, '');
+        if (digits.length !== 7) {
+            message.warning(getMessage('invalidFormat', locale));
+            return;
+        }
+
+        setIsSearching(true);
+        try {
+            const lookupFn = onPostalLookup ?? lookupPostalCode;
+            const result = await lookupFn(postalCode);
+
+            if (result) {
+                const prefectureValue = usePrefectureId ? result.prefectureCode : result.prefecture;
+                form.setFieldsValue({
+                    [prefectureField]: prefectureValue,
+                    [address1Field]: result.address1,
+                    [address2Field]: result.address2,
+                });
+            } else {
+                message.info(getMessage('notFound', locale));
+            }
+        } catch (error) {
+            message.error(getMessage('error', locale));
+            console.error('Postal code lookup failed:', error);
+        } finally {
+            setIsSearching(false);
+        }
+    }, [form, locale, onPostalLookup, prefectureField, address1Field, address2Field, usePrefectureId]);
+
+    const handlePostalCodeChange = async (e: React.ChangeEvent<HTMLInputElement>) => {
+        const postalCode = e.target.value.replace(/[^0-9]/g, '');
+        if (autoSearch && enablePostalLookup && postalCode.length === 7) {
+            await doLookup(postalCode);
+        }
+    };
+
+    const handleSearchClick = async () => {
+        const postalCode = form.getFieldValue(postalCodeField);
+        if (postalCode) {
+            await doLookup(postalCode);
+        }
+    };
+
+    return (
+        <>
+            {/* 郵便番号 */}
+            <Form.Item
+                name={postalCodeField}
+                label={getLabel(i18n, postalCodeField, locale)}
+                rules={getRule(postalCodeField)}
+                required={isRequired(postalCodeField)}
+            >
+                <Input
+                    placeholder={getPlaceholder(i18n, postalCodeField, locale)}
+                    style={{ width: enablePostalLookup && showSearchButton ? 'calc(100% - 110px)' : 150 }}
+                    onChange={handlePostalCodeChange}
+                    addonAfter={
+                        enablePostalLookup && showSearchButton && (
+                            <Button
+                                type="text"
+                                size="small"
+                                icon={isSearching ? <LoadingOutlined /> : <SearchOutlined />}
+                                onClick={handleSearchClick}
+                                disabled={isSearching}
+                            >
+                                {getMessage('searchAddress', locale)}
+                            </Button>
+                        )
+                    }
+                />
+            </Form.Item>
+
+            {/* 都道府県 */}
+            <Form.Item
+                name={prefectureField}
+                label={getLabel(i18n, prefectureField, locale)}
+                rules={getRule(prefectureField)}
+                required={isRequired(prefectureField)}
+            >
+                <Select
+                    placeholder={getPlaceholder(i18n, prefectureField, locale)}
+                    options={options}
+                    style={{ width: 200 }}
+                    showSearch
+                    optionFilterProp="label"
+                />
+            </Form.Item>
+
+            {/* 市区町村 */}
+            <Form.Item
+                name={address1Field}
+                label={getLabel(i18n, address1Field, locale)}
+                rules={getRule(address1Field)}
+                required={isRequired(address1Field)}
+            >
+                <Input placeholder={getPlaceholder(i18n, address1Field, locale)} />
+            </Form.Item>
+
+            {/* 番地 */}
+            <Form.Item
+                name={address2Field}
+                label={getLabel(i18n, address2Field, locale)}
+                rules={getRule(address2Field)}
+                required={isRequired(address2Field)}
+            >
+                <Input placeholder={getPlaceholder(i18n, address2Field, locale)} />
+            </Form.Item>
+
+            {/* 建物名・部屋番号 */}
+            <Form.Item
+                name={address3Field}
+                label={getLabel(i18n, address3Field, locale)}
+                rules={getRule(address3Field)}
+                required={isRequired(address3Field)}
+            >
+                <Input placeholder={getPlaceholder(i18n, address3Field, locale)} />
+            </Form.Item>
+        </>
+    );
+}