@omnifyjp/ts 0.3.0

package/dist/zod-generator.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @omnify/ts — Zod Schema Generator
+ *
+ * Generates Zod schemas alongside TypeScript interfaces for form validation.
+ */
+import type { SchemaDefinition, ZodPropertySchema, SchemaDisplayNames, GeneratorOptions } from './types.js';
+/**
+ * Generate Zod schemas for all properties in a schema.
+ */
+export declare function generateZodSchemas(schema: SchemaDefinition, options: GeneratorOptions): ZodPropertySchema[];
+/**
+ * Generate display names and placeholders for a schema.
+ */
+export declare function generateDisplayNames(schema: SchemaDefinition, options: GeneratorOptions): SchemaDisplayNames;
+/**
+ * Get fields to exclude from create/update schemas.
+ */
+export declare function getExcludedFields(schema: SchemaDefinition): {
+    create: Set<string>;
+    update: Set<string>;
+};
+/**
+ * Format Zod schemas section for a base file.
+ */
+export declare function formatZodSchemasSection(schemaName: string, zodSchemas: ZodPropertySchema[], displayNames: SchemaDisplayNames, excludedFields: {
+    create: Set<string>;
+    update: Set<string>;
+}): string;
+/**
+ * Format user model file with Zod re-exports.
+ */
+export declare function formatZodModelFile(schemaName: string): string;

package/dist/zod-generator.js

@@ -0,0 +1,428 @@
+/**
+ * @omnify/ts — Zod Schema Generator
+ *
+ * Generates Zod schemas alongside TypeScript interfaces for form validation.
+ */
+import { toSnakeCase } from './interface-generator.js';
+/**
+ * Get localized display name as multi-locale object.
+ */
+function getMultiLocaleDisplayName(value, locales, fallbackLocale, defaultValue) {
+    if (!value) {
+        const result = {};
+        for (const locale of locales)
+            result[locale] = defaultValue;
+        return result;
+    }
+    if (typeof value === 'string') {
+        const result = {};
+        for (const locale of locales)
+            result[locale] = value;
+        return result;
+    }
+    const result = {};
+    for (const locale of locales) {
+        result[locale] = value[locale] ?? value[fallbackLocale] ?? value['en'] ?? defaultValue;
+    }
+    return result;
+}
+/**
+ * Generate Zod schema string for a property type.
+ */
+function getZodSchemaForType(propDef, _fieldName, options) {
+    const isNullable = propDef.nullable ?? false;
+    let schema = '';
+    // Check for simple custom types
+    const simpleType = options.customTypes.simple[propDef.type];
+    if (simpleType) {
+        schema = 'z.string()';
+        if (simpleType.length) {
+            schema += `.max(${simpleType.length})`;
+        }
+        if (isNullable) {
+            schema += '.optional().nullable()';
+        }
+        return schema;
+    }
+    switch (propDef.type) {
+        case 'String':
+        case 'Text':
+        case 'MediumText':
+        case 'LongText':
+        case 'Password':
+            schema = 'z.string()';
+            if (!isNullable)
+                schema += '.min(1)';
+            if (propDef.maxLength || propDef.length) {
+                schema += `.max(${propDef.maxLength ?? propDef.length})`;
+            }
+            if (propDef.minLength && propDef.minLength > 1) {
+                schema = schema.replace('.min(1)', `.min(${propDef.minLength})`);
+            }
+            break;
+        case 'Email':
+            schema = 'z.string().email()';
+            if (propDef.maxLength || propDef.length) {
+                schema += `.max(${propDef.maxLength ?? propDef.length ?? 255})`;
+            }
+            break;
+        case 'TinyInt':
+        case 'Int':
+        case 'BigInt':
+            schema = 'z.number().int()';
+            if (propDef.min !== undefined)
+                schema += `.gte(${propDef.min})`;
+            if (propDef.max !== undefined)
+                schema += `.lte(${propDef.max})`;
+            break;
+        case 'Float':
+        case 'Decimal':
+            schema = 'z.number()';
+            if (propDef.min !== undefined)
+                schema += `.gte(${propDef.min})`;
+            if (propDef.max !== undefined)
+                schema += `.lte(${propDef.max})`;
+            break;
+        case 'Boolean':
+            schema = 'z.boolean()';
+            break;
+        case 'Date':
+            schema = 'z.string().date()';
+            break;
+        case 'DateTime':
+        case 'Timestamp':
+            schema = 'z.string().datetime({ offset: true })';
+            break;
+        case 'Time':
+            schema = 'z.string().time()';
+            break;
+        case 'Json':
+            schema = 'z.unknown()';
+            break;
+        case 'EnumRef':
+            if (typeof propDef.enum === 'string') {
+                schema = `z.nativeEnum(${propDef.enum})`;
+            }
+            else {
+                schema = 'z.string()';
+            }
+            break;
+        case 'Enum':
+            if (typeof propDef.enum === 'string') {
+                schema = `z.nativeEnum(${propDef.enum})`;
+            }
+            else if (Array.isArray(propDef.enum)) {
+                const values = propDef.enum.map(v => `'${v}'`).join(', ');
+                schema = `z.enum([${values}])`;
+            }
+            else {
+                schema = 'z.string()';
+            }
+            break;
+        case 'Lookup':
+            schema = 'z.number().int().positive()';
+            break;
+        case 'Association':
+        case 'File':
+            return '';
+        default:
+            schema = 'z.string()';
+    }
+    if (isNullable && schema) {
+        schema += '.optional().nullable()';
+    }
+    if (propDef.pattern && schema) {
+        schema += `.regex(/${propDef.pattern}/)`;
+    }
+    return schema;
+}
+/**
+ * Generate Zod schemas for compound type expanded columns.
+ */
+function generateCompoundTypeSchemas(propName, schema, options) {
+    const expanded = schema.expandedProperties?.[propName];
+    if (!expanded)
+        return [];
+    const schemas = [];
+    const compoundDef = options.customTypes.compound[expanded.sourceType];
+    const propDef = schema.properties?.[propName];
+    const propFields = propDef?.fields;
+    for (const col of expanded.columns) {
+        const fieldOverride = propFields?.[col.suffix];
+        const compoundField = compoundDef?.fields.find(f => f.suffix === col.suffix);
+        const isNullable = col.nullable ?? compoundField?.nullable ?? false;
+        let zodSchema;
+        if (col.type === 'Enum' && compoundField?.enumRef) {
+            // Enum reference (e.g., Prefecture)
+            zodSchema = `z.nativeEnum(${compoundField.enumRef})`;
+            if (isNullable)
+                zodSchema += '.optional().nullable()';
+        }
+        else if (col.type === 'Enum' && col.enum) {
+            // Inline enum
+            const values = col.enum.map(v => `'${v}'`).join(', ');
+            zodSchema = `z.enum([${values}])`;
+            if (isNullable)
+                zodSchema += '.optional().nullable()';
+        }
+        else {
+            // String type with length
+            zodSchema = 'z.string()';
+            if (!isNullable)
+                zodSchema += '.min(1)';
+            const length = fieldOverride?.length ?? col.length;
+            if (length)
+                zodSchema += `.max(${length})`;
+            if (isNullable)
+                zodSchema += '.optional().nullable()';
+        }
+        schemas.push({
+            fieldName: col.name,
+            schema: zodSchema,
+            inCreate: true,
+            inUpdate: true,
+        });
+    }
+    return schemas;
+}
+/**
+ * Generate Zod schemas for all properties in a schema.
+ */
+export function generateZodSchemas(schema, options) {
+    const schemas = [];
+    if (!schema.properties)
+        return schemas;
+    const propNames = schema.propertyOrder ?? Object.keys(schema.properties);
+    for (const propName of propNames) {
+        const propDef = schema.properties[propName];
+        if (!propDef)
+            continue;
+        // Check for compound type expansion
+        if (schema.expandedProperties?.[propName]) {
+            schemas.push(...generateCompoundTypeSchemas(propName, schema, options));
+            continue;
+        }
+        const zodSchema = getZodSchemaForType(propDef, propName, options);
+        if (!zodSchema)
+            continue;
+        schemas.push({
+            fieldName: toSnakeCase(propName),
+            schema: zodSchema,
+            inCreate: true,
+            inUpdate: true,
+        });
+    }
+    return schemas;
+}
+/**
+ * Generate display names and placeholders for a schema.
+ */
+export function generateDisplayNames(schema, options) {
+    const { locales, fallbackLocale } = options;
+    const displayName = getMultiLocaleDisplayName(schema.displayName, locales, fallbackLocale, schema.name);
+    const propertyDisplayNames = {};
+    const propertyPlaceholders = {};
+    if (schema.properties) {
+        const propNames = schema.propertyOrder ?? Object.keys(schema.properties);
+        for (const propName of propNames) {
+            const propDef = schema.properties[propName];
+            if (!propDef)
+                continue;
+            const fieldName = toSnakeCase(propName);
+            // Compound type: expand to individual fields
+            if (schema.expandedProperties?.[propName]) {
+                const expanded = schema.expandedProperties[propName];
+                // Add compound-level displayName
+                if (propDef.displayName) {
+                    propertyDisplayNames[fieldName] = getMultiLocaleDisplayName(propDef.displayName, locales, fallbackLocale, propName);
+                }
+                for (const col of expanded.columns) {
+                    const fieldOverride = propDef.fields?.[col.suffix];
+                    // Display name for expanded field
+                    const labelSource = fieldOverride?.displayName;
+                    if (labelSource) {
+                        propertyDisplayNames[col.name] = getMultiLocaleDisplayName(labelSource, locales, fallbackLocale, col.suffix);
+                    }
+                    else {
+                        // Fallback: parent displayName + suffix
+                        const parentLabel = getMultiLocaleDisplayName(propDef.displayName, locales, fallbackLocale, propName);
+                        const suffixed = {};
+                        for (const locale of locales) {
+                            suffixed[locale] = `${parentLabel[locale]} (${col.suffix})`;
+                        }
+                        propertyDisplayNames[col.name] = suffixed;
+                    }
+                    // Placeholder for expanded field
+                    if (fieldOverride?.placeholder) {
+                        propertyPlaceholders[col.name] = getMultiLocaleDisplayName(fieldOverride.placeholder, locales, fallbackLocale, '');
+                    }
+                }
+                continue;
+            }
+            // Regular field display name
+            propertyDisplayNames[fieldName] = getMultiLocaleDisplayName(propDef.displayName, locales, fallbackLocale, propName);
+            // Placeholder
+            if (propDef.placeholder) {
+                propertyPlaceholders[fieldName] = getMultiLocaleDisplayName(propDef.placeholder, locales, fallbackLocale, '');
+            }
+        }
+    }
+    return { displayName, propertyDisplayNames, propertyPlaceholders };
+}
+/**
+ * Get fields to exclude from create/update schemas.
+ */
+export function getExcludedFields(schema) {
+    const createExclude = new Set();
+    const updateExclude = new Set();
+    if (schema.options?.id !== false) {
+        createExclude.add('id');
+        updateExclude.add('id');
+    }
+    if (schema.options?.timestamps !== false) {
+        for (const f of ['created_at', 'updated_at']) {
+            createExclude.add(f);
+            updateExclude.add(f);
+        }
+    }
+    if (schema.options?.softDelete) {
+        createExclude.add('deleted_at');
+        updateExclude.add('deleted_at');
+    }
+    return { create: createExclude, update: updateExclude };
+}
+/**
+ * Format Zod schemas section for a base file.
+ */
+export function formatZodSchemasSection(schemaName, zodSchemas, displayNames, excludedFields) {
+    const parts = [];
+    const lowerName = schemaName.charAt(0).toLowerCase() + schemaName.slice(1);
+    // I18n section
+    parts.push(`// ============================================================================\n`);
+    parts.push(`// I18n (Internationalization)\n`);
+    parts.push(`// ============================================================================\n\n`);
+    parts.push(`/**\n * Unified i18n object for ${schemaName}\n */\n`);
+    parts.push(`export const ${lowerName}I18n = {\n`);
+    parts.push(`  label: ${JSON.stringify(displayNames.displayName)},\n`);
+    parts.push(`  fields: {\n`);
+    for (const [propName, labelMap] of Object.entries(displayNames.propertyDisplayNames)) {
+        const placeholderMap = displayNames.propertyPlaceholders[propName];
+        parts.push(`    ${propName}: {\n`);
+        parts.push(`      label: ${JSON.stringify(labelMap)},\n`);
+        if (placeholderMap) {
+            parts.push(`      placeholder: ${JSON.stringify(placeholderMap)},\n`);
+        }
+        parts.push(`    },\n`);
+    }
+    parts.push(`  },\n`);
+    parts.push(`} as const;\n\n`);
+    // Zod Schemas section
+    parts.push(`// ============================================================================\n`);
+    parts.push(`// Zod Schemas\n`);
+    parts.push(`// ============================================================================\n\n`);
+    parts.push(`/** Field schemas for ${schemaName} */\n`);
+    parts.push(`export const base${schemaName}Schemas = {\n`);
+    for (const prop of zodSchemas) {
+        parts.push(`  ${prop.fieldName}: ${prop.schema},\n`);
+    }
+    parts.push(`} as const;\n\n`);
+    // Create Schema
+    const createFields = zodSchemas.filter(p => p.inCreate && !excludedFields.create.has(p.fieldName));
+    parts.push(`/** Create schema for ${schemaName} */\n`);
+    parts.push(`export const base${schemaName}CreateSchema = z.object({\n`);
+    for (const prop of createFields) {
+        parts.push(`  ${prop.fieldName}: base${schemaName}Schemas.${prop.fieldName},\n`);
+    }
+    parts.push(`});\n\n`);
+    // Update Schema
+    parts.push(`/** Update schema for ${schemaName} */\n`);
+    parts.push(`export const base${schemaName}UpdateSchema = base${schemaName}CreateSchema.partial();\n\n`);
+    // Inferred Types
+    parts.push(`// ============================================================================\n`);
+    parts.push(`// Inferred Types\n`);
+    parts.push(`// ============================================================================\n\n`);
+    parts.push(`export type Base${schemaName}Create = z.infer<typeof base${schemaName}CreateSchema>;\n`);
+    parts.push(`export type Base${schemaName}Update = z.infer<typeof base${schemaName}UpdateSchema>;\n\n`);
+    // Helper Functions
+    parts.push(`// ============================================================================\n`);
+    parts.push(`// I18n Helper Functions\n`);
+    parts.push(`// ============================================================================\n\n`);
+    parts.push(`/** Get model label for a specific locale */\n`);
+    parts.push(`export function get${schemaName}Label(locale: string): string {\n`);
+    parts.push(`  return ${lowerName}I18n.label[locale as keyof typeof ${lowerName}I18n.label] ?? ${lowerName}I18n.label['en'] ?? '${schemaName}';\n`);
+    parts.push(`}\n\n`);
+    parts.push(`/** Get field label for a specific locale */\n`);
+    parts.push(`export function get${schemaName}FieldLabel(field: string, locale: string): string {\n`);
+    parts.push(`  const fieldI18n = ${lowerName}I18n.fields[field as keyof typeof ${lowerName}I18n.fields];\n`);
+    parts.push(`  if (!fieldI18n) return field;\n`);
+    parts.push(`  return fieldI18n.label[locale as keyof typeof fieldI18n.label] ?? fieldI18n.label['en'] ?? field;\n`);
+    parts.push(`}\n\n`);
+    parts.push(`/** Get field placeholder for a specific locale */\n`);
+    parts.push(`export function get${schemaName}FieldPlaceholder(field: string, locale: string): string {\n`);
+    parts.push(`  const fieldI18n = ${lowerName}I18n.fields[field as keyof typeof ${lowerName}I18n.fields];\n`);
+    parts.push(`  if (!fieldI18n || !('placeholder' in fieldI18n)) return '';\n`);
+    parts.push(`  const placeholder = fieldI18n.placeholder as Record<string, string>;\n`);
+    parts.push(`  return placeholder[locale] ?? placeholder['en'] ?? '';\n`);
+    parts.push(`}\n`);
+    return parts.join('');
+}
+/**
+ * Format user model file with Zod re-exports.
+ */
+export function formatZodModelFile(schemaName) {
+    const lowerName = schemaName.charAt(0).toLowerCase() + schemaName.slice(1);
+    return `/**
+ * ${schemaName} Model
+ *
+ * This file extends the auto-generated base interface.
+ * You can add custom methods, computed properties, or override types/schemas here.
+ * This file will NOT be overwritten by the generator.
+ */
+
+import { z } from 'zod';
+import type { ${schemaName} as ${schemaName}Base } from './base/${schemaName}.js';
+import {
+  base${schemaName}Schemas,
+  base${schemaName}CreateSchema,
+  base${schemaName}UpdateSchema,
+  ${lowerName}I18n,
+  get${schemaName}Label,
+  get${schemaName}FieldLabel,
+  get${schemaName}FieldPlaceholder,
+} from './base/${schemaName}.js';
+
+// ============================================================================
+// Types (extend or re-export)
+// ============================================================================
+
+export interface ${schemaName} extends ${schemaName}Base {
+  // Add custom properties here
+}
+
+// ============================================================================
+// Schemas (extend or re-export)
+// ============================================================================
+
+export const ${lowerName}Schemas = { ...base${schemaName}Schemas };
+export const ${lowerName}CreateSchema = base${schemaName}CreateSchema;
+export const ${lowerName}UpdateSchema = base${schemaName}UpdateSchema;
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export type ${schemaName}Create = z.infer<typeof ${lowerName}CreateSchema>;
+export type ${schemaName}Update = z.infer<typeof ${lowerName}UpdateSchema>;
+
+// Re-export i18n and helpers
+export {
+  ${lowerName}I18n,
+  get${schemaName}Label,
+  get${schemaName}FieldLabel,
+  get${schemaName}FieldPlaceholder,
+};
+
+// Re-export base type for internal use
+export type { ${schemaName}Base };
+`;
+}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@omnifyjp/ts",
+  "version": "0.3.0",
+  "description": "TypeScript model type generator from Omnify schemas.json",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "omnify-ts": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "generate-l12": "node dist/cli.js --config ../../examples/l12/omnify.yaml",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "commander": "^13.0.0",
+    "yaml": "^2.7.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.18"
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT"
+}