@claudetools/tools 0.8.11 → 0.9.0

package/dist/codedna/kappa-zod-generator.js

@@ -0,0 +1,216 @@
+// =============================================================================
+// Kappa v2.5 Zod Schema Generator
+// =============================================================================
+//
+// Generates Zod validation schemas from Kappa entity blocks.
+// Creates insert/update schemas with proper constraints.
+//
+// =============================================================================
+// Generator Class
+// =============================================================================
+export class KappaZodGenerator {
+    provenance;
+    updateSchemas;
+    formSchemas;
+    constructor(options = {}) {
+        this.provenance = options.provenance ?? true;
+        this.updateSchemas = options.updateSchemas ?? true;
+        this.formSchemas = options.formSchemas ?? false;
+    }
+    /**
+     * Generate Zod schemas from entity blocks
+     */
+    generate(entities) {
+        const schemas = this.generateSchemasFile(entities);
+        return { schemas };
+    }
+    // ===========================================================================
+    // Schemas File Generation
+    // ===========================================================================
+    generateSchemasFile(entities) {
+        const lines = [];
+        // Header comment
+        if (this.provenance) {
+            lines.push('// Generated by Kappa v2.5 CodeDNA');
+            lines.push(`// Generated at: ${new Date().toISOString()}`);
+            lines.push('');
+        }
+        // Import Zod
+        lines.push("import { z } from 'zod';");
+        lines.push('');
+        // Generate schemas for each entity
+        for (const entity of entities) {
+            lines.push(this.generateEntitySchemas(entity));
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    generateEntitySchemas(entity) {
+        const lines = [];
+        const schemaName = `${entity.name}Schema`;
+        // Main schema (for select/read)
+        lines.push(`// ${entity.name} schemas`);
+        lines.push(`export const ${schemaName} = z.object({`);
+        for (const field of entity.fields) {
+            lines.push(`  ${field.name}: ${this.generateFieldSchema(field)},`);
+        }
+        lines.push('});');
+        lines.push('');
+        // Insert schema (excludes auto-generated fields)
+        const insertSchemaName = `Insert${entity.name}Schema`;
+        const insertFields = entity.fields.filter(f => !f.modifiers.includes('auto'));
+        lines.push(`export const ${insertSchemaName} = z.object({`);
+        for (const field of insertFields) {
+            const schema = this.generateFieldSchema(field, { forInsert: true });
+            lines.push(`  ${field.name}: ${schema},`);
+        }
+        lines.push('});');
+        // Update schema (all fields optional)
+        if (this.updateSchemas) {
+            lines.push('');
+            const updateSchemaName = `Update${entity.name}Schema`;
+            lines.push(`export const ${updateSchemaName} = ${insertSchemaName}.partial();`);
+        }
+        // Form schema (for frontend forms)
+        if (this.formSchemas) {
+            lines.push('');
+            const formSchemaName = `${entity.name}FormSchema`;
+            lines.push(`export const ${formSchemaName} = ${insertSchemaName};`);
+        }
+        // Type exports
+        lines.push('');
+        lines.push(`export type ${entity.name} = z.infer<typeof ${schemaName}>;`);
+        lines.push(`export type Insert${entity.name} = z.infer<typeof ${insertSchemaName}>;`);
+        if (this.updateSchemas) {
+            lines.push(`export type Update${entity.name} = z.infer<typeof Update${entity.name}Schema>;`);
+        }
+        return lines.join('\n');
+    }
+    generateFieldSchema(field, options = {}) {
+        const { type, modifiers } = field;
+        let schema = this.typeToZodSchema(type, field.name);
+        // Handle optional modifier
+        const isOptional = modifiers.includes('optional');
+        const isPrimary = modifiers.includes('primary');
+        const isAuto = modifiers.includes('auto');
+        // For insert schemas, primary keys with auto are optional
+        if (options.forInsert && isPrimary && isAuto) {
+            schema = `${schema}.optional()`;
+        }
+        else if (isOptional) {
+            schema = `${schema}.optional()`;
+        }
+        // Add nullable if needed (optional fields can be null)
+        if (isOptional) {
+            schema = `${schema}.nullable()`;
+        }
+        return schema;
+    }
+    typeToZodSchema(type, fieldName) {
+        switch (type.kind) {
+            case 'primitive':
+                return this.primitiveToZod(type.type, type.range, fieldName);
+            case 'enum':
+                const enumValues = type.values.map(v => `'${v}'`).join(', ');
+                return `z.enum([${enumValues}])`;
+            case 'reference':
+                // Reference fields are typically UUIDs
+                return "z.string().uuid()";
+            case 'array':
+                const itemSchema = this.typeToZodSchema(type.itemType, fieldName);
+                return `z.array(${itemSchema})`;
+            default:
+                return 'z.unknown()';
+        }
+    }
+    primitiveToZod(primitiveType, range, fieldName) {
+        let schema;
+        switch (primitiveType) {
+            case 'string':
+                schema = 'z.string()';
+                if (range) {
+                    if (range.min !== undefined) {
+                        schema += `.min(${range.min})`;
+                    }
+                    if (range.max !== undefined) {
+                        schema += `.max(${range.max})`;
+                    }
+                }
+                break;
+            case 'int':
+                schema = 'z.number().int()';
+                if (range) {
+                    if (range.min !== undefined) {
+                        schema += `.min(${range.min})`;
+                    }
+                    if (range.max !== undefined) {
+                        schema += `.max(${range.max})`;
+                    }
+                }
+                break;
+            case 'float':
+                schema = 'z.number()';
+                if (range) {
+                    if (range.min !== undefined) {
+                        schema += `.min(${range.min})`;
+                    }
+                    if (range.max !== undefined) {
+                        schema += `.max(${range.max})`;
+                    }
+                }
+                break;
+            case 'bool':
+                schema = 'z.boolean()';
+                break;
+            case 'email':
+                schema = 'z.string().email()';
+                break;
+            case 'url':
+                schema = 'z.string().url()';
+                break;
+            case 'uuid':
+                schema = 'z.string().uuid()';
+                break;
+            case 'phone':
+                // Basic phone validation - allows common formats
+                schema = "z.string().regex(/^\\+?[0-9\\s\\-()]+$/, 'Invalid phone number')";
+                break;
+            case 'slug':
+                // Slug validation - lowercase, hyphens, numbers
+                schema = "z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/, 'Invalid slug format')";
+                break;
+            case 'markdown':
+                schema = 'z.string()';
+                break;
+            case 'json':
+                schema = 'z.record(z.unknown())';
+                break;
+            case 'timestamp':
+                schema = 'z.date()';
+                break;
+            case 'date':
+                schema = 'z.string().date()';
+                break;
+            case 'time':
+                schema = 'z.string().time()';
+                break;
+            case 'duration':
+                // Duration as ISO 8601 string (e.g., "P1D", "PT1H30M")
+                schema = "z.string().regex(/^P(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?)?$/, 'Invalid duration')";
+                break;
+            default:
+                schema = 'z.string()';
+        }
+        return schema;
+    }
+}
+// =============================================================================
+// Convenience Function
+// =============================================================================
+/**
+ * Generate Zod schemas from Kappa entities
+ */
+export function generateZodSchemas(entities, options = {}) {
+    const generator = new KappaZodGenerator(options);
+    return generator.generate(entities);
+}

package/dist/handlers/kappa-handlers.d.ts

@@ -0,0 +1,116 @@
+import type { KappaSpec } from '../codedna/kappa-ast.js';
+export interface KappaGenerateResult {
+    success: boolean;
+    files?: Array<{
+        path: string;
+        content: string;
+    }>;
+    errors?: string[];
+    metadata?: {
+        filesGenerated: number;
+        linesOfCode: number;
+        estimatedTokensSaved: number;
+    };
+}
+/**
+ * Handle kappa_parse tool call
+ * Parses and validates a Kappa specification
+ */
+export declare function handleKappaParse(args: {
+    spec: string;
+}): Promise<{
+    success: boolean;
+    ast?: KappaSpec;
+    errors?: string[];
+    summary?: Record<string, unknown>;
+}>;
+/**
+ * Handle kappa_generate_schema tool call
+ * Generates Drizzle schema, Zod validators, and TypeScript types
+ */
+export declare function handleKappaGenerateSchema(args: {
+    spec: string;
+    outputs?: ('drizzle' | 'zod' | 'types')[];
+    options?: {
+        provenance?: boolean;
+        dbDialect?: 'sqlite' | 'postgres' | 'postgresql' | 'mysql';
+    };
+}): Promise<KappaGenerateResult>;
+/**
+ * Handle kappa_generate_api tool call
+ * Generates API routes from Kappa API blocks
+ */
+export declare function handleKappaGenerateApi(args: {
+    spec: string;
+    framework?: 'hono' | 'express' | 'trpc';
+    options?: {
+        provenance?: boolean;
+        typescript?: boolean;
+    };
+}): Promise<KappaGenerateResult>;
+/**
+ * Handle kappa_generate_pages tool call
+ * Generates page/route components for TanStack Start or Next.js
+ */
+export declare function handleKappaGeneratePages(args: {
+    spec: string;
+    framework?: 'tanstack-start' | 'nextjs';
+    options?: {
+        provenance?: boolean;
+        typescript?: boolean;
+    };
+}): Promise<KappaGenerateResult>;
+/**
+ * Handle kappa_generate_forms tool call
+ * Generates React forms with React Hook Form and Zod validation
+ */
+export declare function handleKappaGenerateForms(args: {
+    spec: string;
+    ui?: 'shadcn' | 'plain';
+    options?: {
+        provenance?: boolean;
+        typescript?: boolean;
+        zod?: boolean;
+    };
+}): Promise<KappaGenerateResult>;
+/**
+ * Handle kappa_generate_components tool call
+ * Generates React components including compound components
+ */
+export declare function handleKappaGenerateComponents(args: {
+    spec: string;
+    options?: {
+        provenance?: boolean;
+        typescript?: boolean;
+        forwardRef?: boolean;
+        basePath?: string;
+    };
+}): Promise<KappaGenerateResult>;
+/**
+ * Handle kappa_generate_design tool call
+ * Generates CSS variables and Tailwind config from design tokens
+ */
+export declare function handleKappaGenerateDesign(args: {
+    spec: string;
+    format?: 'css' | 'tailwind' | 'both';
+    options?: {
+        provenance?: boolean;
+        prefix?: string;
+        hsl?: boolean;
+    };
+}): Promise<KappaGenerateResult>;
+/**
+ * Handle kappa_generate_all tool call
+ * Generates complete full-stack application from Kappa specification
+ */
+export declare function handleKappaGenerateAll(args: {
+    spec: string;
+    options?: {
+        framework?: 'tanstack-start' | 'nextjs';
+        apiFramework?: 'hono' | 'express' | 'trpc';
+        ui?: 'shadcn' | 'plain';
+        dbDialect?: 'sqlite' | 'postgres' | 'postgresql' | 'mysql';
+        provenance?: boolean;
+        typescript?: boolean;
+    };
+}): Promise<KappaGenerateResult>;