@claudetools/tools 0.9.0 → 0.9.2

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

@@ -0,0 +1,518 @@
+// =============================================================================
+// Kappa v2.5 Mantine Generator
+// =============================================================================
+//
+// Generates Mantine UI components and forms from Kappa ComponentBlock/FormBlock AST.
+// Supports @mantine/core components, @mantine/form, and @mantine/hooks.
+//
+// =============================================================================
+// Generator Class
+// =============================================================================
+export class KappaMantineGenerator {
+    provenance;
+    typescript;
+    zod;
+    forwardRef;
+    basePath;
+    constructor(options = {}) {
+        this.provenance = options.provenance ?? true;
+        this.typescript = options.typescript ?? true;
+        this.zod = options.zod ?? true;
+        this.forwardRef = options.forwardRef ?? false;
+        this.basePath = options.basePath ?? 'components';
+    }
+    /**
+     * Generate components from ComponentBlock AST nodes
+     */
+    generateComponents(components) {
+        const files = [];
+        for (const component of components) {
+            files.push(this.generateComponent(component));
+        }
+        return { files };
+    }
+    /**
+     * Generate forms from FormBlock AST nodes
+     */
+    generateForms(forms) {
+        const files = [];
+        for (const form of forms) {
+            files.push(this.generateForm(form));
+        }
+        return { files };
+    }
+    // ===========================================================================
+    // Component Generation
+    // ===========================================================================
+    generateComponent(component) {
+        const lines = [];
+        const ext = this.typescript ? 'tsx' : 'jsx';
+        // Header
+        if (this.provenance) {
+            lines.push('// Generated by Kappa v2.5 CodeDNA - Mantine');
+            lines.push(`// Component: ${component.name}`);
+            lines.push('');
+        }
+        // Imports
+        lines.push("import { Box, Stack, Group } from '@mantine/core';");
+        if (this.forwardRef) {
+            lines.push("import { forwardRef } from 'react';");
+        }
+        if (component.compound && component.compound.length > 0) {
+            lines.push("import { createContext, useContext } from 'react';");
+        }
+        lines.push('');
+        // Props interface
+        if (this.typescript) {
+            lines.push(this.generateComponentPropsInterface(component));
+            lines.push('');
+        }
+        // Component
+        if (component.compound && component.compound.length > 0) {
+            lines.push(this.generateCompoundComponent(component));
+        }
+        else if (this.forwardRef) {
+            lines.push(this.generateForwardRefComponent(component));
+        }
+        else {
+            lines.push(this.generateFunctionComponent(component));
+        }
+        return {
+            path: `${this.basePath}/${this.toKebabCase(component.name)}.${ext}`,
+            content: lines.join('\n'),
+        };
+    }
+    generateComponentPropsInterface(component) {
+        const lines = [];
+        const propsName = `${component.name}Props`;
+        lines.push(`export interface ${propsName} {`);
+        for (const prop of component.props) {
+            const optional = prop.optional ? '?' : '';
+            lines.push(`  ${prop.name}${optional}: ${this.mapPropType(prop.type)};`);
+        }
+        // Mantine style props
+        lines.push('  className?: string;');
+        lines.push('  style?: React.CSSProperties;');
+        lines.push('  children?: React.ReactNode;');
+        lines.push('}');
+        return lines.join('\n');
+    }
+    generateFunctionComponent(component) {
+        const lines = [];
+        const propsType = this.typescript ? `: ${component.name}Props` : '';
+        const destructuredProps = this.getDestructuredProps(component);
+        lines.push(`export function ${component.name}({ ${destructuredProps} }${propsType}) {`);
+        lines.push('  return (');
+        if (component.structure) {
+            lines.push(this.generateStructureJSX(component.structure, 4));
+        }
+        else {
+            lines.push(`    <Box className={className} style={style}>`);
+            lines.push('      {children}');
+            lines.push('    </Box>');
+        }
+        lines.push('  );');
+        lines.push('}');
+        return lines.join('\n');
+    }
+    generateForwardRefComponent(component) {
+        const lines = [];
+        const propsType = this.typescript ? `${component.name}Props` : '';
+        const refType = this.typescript ? 'HTMLDivElement' : '';
+        const destructuredProps = this.getDestructuredProps(component);
+        lines.push(`export const ${component.name} = forwardRef<${refType}${propsType ? `, ${propsType}` : ''}>(`);
+        lines.push(`  function ${component.name}({ ${destructuredProps} }, ref) {`);
+        lines.push('    return (');
+        if (component.structure) {
+            lines.push(this.generateStructureJSX(component.structure, 6, 'ref={ref}'));
+        }
+        else {
+            lines.push(`      <Box ref={ref} className={className} style={style}>`);
+            lines.push('        {children}');
+            lines.push('      </Box>');
+        }
+        lines.push('    );');
+        lines.push('  }');
+        lines.push(');');
+        return lines.join('\n');
+    }
+    generateCompoundComponent(component) {
+        const lines = [];
+        // Context
+        if (this.typescript) {
+            lines.push(`interface ${component.name}ContextValue {`);
+            for (const prop of component.props) {
+                lines.push(`  ${prop.name}${prop.optional ? '?' : ''}: ${this.mapPropType(prop.type)};`);
+            }
+            lines.push('}');
+            lines.push('');
+        }
+        const contextType = this.typescript ? `${component.name}ContextValue | null` : '';
+        lines.push(`const ${component.name}Context = createContext<${contextType}>(null);`);
+        lines.push('');
+        // Hook
+        lines.push(`function use${component.name}() {`);
+        lines.push(`  const context = useContext(${component.name}Context);`);
+        lines.push('  if (!context) {');
+        lines.push(`    throw new Error('${component.name} compound components must be used within ${component.name}');`);
+        lines.push('  }');
+        lines.push('  return context;');
+        lines.push('}');
+        lines.push('');
+        // Root component
+        const destructuredProps = this.getDestructuredProps(component);
+        const propsType = this.typescript ? `: ${component.name}Props` : '';
+        lines.push(`function ${component.name}Root({ ${destructuredProps} }${propsType}) {`);
+        const contextValue = component.props.map((p) => p.name).join(', ');
+        lines.push(`  const value = { ${contextValue} };`);
+        lines.push('');
+        lines.push('  return (');
+        lines.push(`    <${component.name}Context.Provider value={value}>`);
+        lines.push(`      <Box className={className} style={style}>`);
+        lines.push('        {children}');
+        lines.push('      </Box>');
+        lines.push(`    </${component.name}Context.Provider>`);
+        lines.push('  );');
+        lines.push('}');
+        lines.push('');
+        // Compound parts
+        for (const part of component.compound) {
+            lines.push(this.generateCompoundPart(component.name, part));
+            lines.push('');
+        }
+        // Export compound object
+        lines.push(`export const ${component.name} = Object.assign(${component.name}Root, {`);
+        for (const part of component.compound) {
+            lines.push(`  ${part.name}: ${component.name}${part.name},`);
+        }
+        lines.push('});');
+        return lines.join('\n');
+    }
+    generateCompoundPart(parentName, part) {
+        const lines = [];
+        const partName = `${parentName}${part.name}`;
+        if (this.typescript) {
+            lines.push(`interface ${partName}Props {`);
+            lines.push('  className?: string;');
+            lines.push('  style?: React.CSSProperties;');
+            lines.push('  children?: React.ReactNode;');
+            if (part.props) {
+                for (const prop of part.props) {
+                    lines.push(`  ${prop}?: string;`);
+                }
+            }
+            lines.push('}');
+            lines.push('');
+        }
+        const propsType = this.typescript ? `: ${partName}Props` : '';
+        const propsStr = part.props
+            ? `{ className, style, children, ${part.props.join(', ')} }`
+            : '{ className, style, children }';
+        lines.push(`function ${partName}(${propsStr}${propsType}) {`);
+        lines.push(`  const context = use${parentName}();`);
+        lines.push('');
+        lines.push('  return (');
+        lines.push(`    <Box component="${part.element}" className={className} style={style}>`);
+        lines.push('      {children}');
+        lines.push('    </Box>');
+        lines.push('  );');
+        lines.push('}');
+        return lines.join('\n');
+    }
+    generateStructureJSX(structure, indent, extraProps = '') {
+        const spaces = ' '.repeat(indent);
+        const lines = [];
+        const mantineComponent = this.mapToMantineComponent(structure.type);
+        const props = Object.entries(structure.props || {})
+            .map(([k, v]) => `${k}="${v}"`)
+            .join(' ');
+        const allProps = [extraProps, props, 'className={className}', 'style={style}'].filter(Boolean).join(' ');
+        if (structure.children && structure.children.length > 0) {
+            lines.push(`${spaces}<${mantineComponent} ${allProps}>`);
+            for (const child of structure.children) {
+                lines.push(this.generateStructureJSX(child, indent + 2));
+            }
+            lines.push(`${spaces}</${mantineComponent}>`);
+        }
+        else {
+            lines.push(`${spaces}<${mantineComponent} ${allProps}>{children}</${mantineComponent}>`);
+        }
+        return lines.join('\n');
+    }
+    getDestructuredProps(component) {
+        const propNames = component.props.map((p) => p.name);
+        propNames.push('className', 'style', 'children');
+        return propNames.join(', ');
+    }
+    // ===========================================================================
+    // Form Generation
+    // ===========================================================================
+    generateForm(form) {
+        const lines = [];
+        const ext = this.typescript ? 'tsx' : 'jsx';
+        const formName = form.name;
+        const componentName = `${formName}Form`;
+        // Header
+        if (this.provenance) {
+            lines.push('// Generated by Kappa v2.5 CodeDNA - Mantine');
+            lines.push(`// Form: ${formName}`);
+            lines.push('');
+        }
+        lines.push("'use client';");
+        lines.push('');
+        // Imports
+        lines.push("import { useForm } from '@mantine/form';");
+        if (this.zod) {
+            lines.push("import { zodResolver } from 'mantine-form-zod-resolver';");
+            lines.push("import { z } from 'zod';");
+        }
+        lines.push("import { useState } from 'react';");
+        lines.push("import { TextInput, Textarea, NumberInput, Select, Checkbox, Button, Stack, Group } from '@mantine/core';");
+        lines.push('');
+        // Generate Zod schema
+        if (this.zod) {
+            lines.push(this.generateZodSchema(form));
+            lines.push('');
+            if (this.typescript) {
+                lines.push(`type ${formName}FormData = z.infer<typeof ${this.toCamelCase(formName)}Schema>;`);
+                lines.push('');
+            }
+        }
+        // Component props type
+        if (this.typescript) {
+            lines.push(`interface ${componentName}Props {`);
+            lines.push(`  onSubmit: (data: ${this.zod ? `${formName}FormData` : 'Record<string, unknown>'}) => void | Promise<void>;`);
+            lines.push(`  initialValues?: Partial<${this.zod ? `${formName}FormData` : 'Record<string, unknown>'}>;`);
+            lines.push(`  isLoading?: boolean;`);
+            lines.push('}');
+            lines.push('');
+        }
+        // Component
+        const propsType = this.typescript ? `: ${componentName}Props` : '';
+        lines.push(`export function ${componentName}({ onSubmit, initialValues, isLoading }${propsType}) {`);
+        lines.push(`  const [submitting, setSubmitting] = useState(false);`);
+        lines.push('');
+        // Mantine form hook
+        lines.push(`  const form = useForm${this.typescript && this.zod ? `<${formName}FormData>` : ''}({`);
+        if (this.zod) {
+            lines.push(`    validate: zodResolver(${this.toCamelCase(formName)}Schema),`);
+        }
+        lines.push(`    initialValues: initialValues ?? ${this.getInitialValues(form)},`);
+        lines.push(`  });`);
+        lines.push('');
+        // Submit handler
+        lines.push(`  async function handleSubmit(data${this.typescript && this.zod ? `: ${formName}FormData` : ''}) {`);
+        lines.push(`    setSubmitting(true);`);
+        lines.push(`    try {`);
+        lines.push(`      await onSubmit(data);`);
+        if (form.submit.onSuccess) {
+            lines.push(`      // onSuccess: ${form.submit.onSuccess}`);
+        }
+        lines.push(`    } catch (error) {`);
+        if (form.submit.onError) {
+            lines.push(`      // onError: ${form.submit.onError}`);
+        }
+        lines.push(`      console.error('Form submission error:', error);`);
+        lines.push(`    } finally {`);
+        lines.push(`      setSubmitting(false);`);
+        lines.push(`    }`);
+        lines.push(`  }`);
+        lines.push('');
+        // JSX
+        lines.push('  return (');
+        lines.push('    <form onSubmit={form.onSubmit(handleSubmit)}>');
+        lines.push('      <Stack gap="md">');
+        // Render fields using layout or sequentially
+        if (form.layout.length > 0) {
+            for (const row of form.layout) {
+                lines.push(this.generateLayoutRow(row, form.fields));
+            }
+        }
+        else {
+            for (const field of form.fields) {
+                lines.push(this.generateMantineField(field, 8));
+            }
+        }
+        // Submit button
+        lines.push('        <Group justify="flex-end" mt="md">');
+        lines.push('          <Button type="submit" loading={submitting || isLoading}>');
+        lines.push(`            {submitting ? '${form.submit.loading || 'Submitting...'}' : '${form.submit.button}'}`);
+        lines.push('          </Button>');
+        lines.push('        </Group>');
+        lines.push('      </Stack>');
+        lines.push('    </form>');
+        lines.push('  );');
+        lines.push('}');
+        return {
+            path: `${this.basePath}/forms/${this.toKebabCase(formName)}-form.${ext}`,
+            content: lines.join('\n'),
+        };
+    }
+    generateZodSchema(form) {
+        const schemaName = `${this.toCamelCase(form.name)}Schema`;
+        const lines = [];
+        lines.push(`const ${schemaName} = z.object({`);
+        for (const field of form.fields) {
+            const zodType = this.fieldTypeToZod(field);
+            lines.push(`  ${field.name}: ${zodType},`);
+        }
+        lines.push('});');
+        return lines.join('\n');
+    }
+    fieldTypeToZod(field) {
+        let zodType;
+        switch (field.type) {
+            case 'email':
+                zodType = "z.string().email('Invalid email address')";
+                break;
+            case 'number':
+                zodType = 'z.number()';
+                break;
+            case 'checkbox':
+                zodType = 'z.boolean()';
+                break;
+            case 'date':
+            case 'time':
+            case 'datetime':
+                zodType = 'z.string()';
+                break;
+            case 'multiselect':
+                zodType = 'z.array(z.string())';
+                break;
+            case 'file':
+                zodType = 'z.any()';
+                break;
+            default:
+                zodType = 'z.string()';
+        }
+        if (field.required) {
+            // Add min(1) for string types that need non-empty validation
+            if (field.type === 'text' ||
+                field.type === 'textarea' ||
+                field.type === 'password' ||
+                field.type === 'email' ||
+                field.type === 'select') {
+                zodType += ".min(1, 'Required')";
+            }
+        }
+        else {
+            zodType += '.optional()';
+        }
+        return zodType;
+    }
+    getInitialValues(form) {
+        const values = {};
+        for (const field of form.fields) {
+            if (field.defaultValue !== undefined) {
+                // Use the default value directly (already properly typed)
+                values[field.name] = field.defaultValue;
+            }
+            else if (field.type === 'checkbox') {
+                values[field.name] = false;
+            }
+            else if (field.type === 'number') {
+                values[field.name] = 0;
+            }
+            else if (field.type === 'multiselect') {
+                values[field.name] = [];
+            }
+            else {
+                values[field.name] = '';
+            }
+        }
+        return JSON.stringify(values, null, 2);
+    }
+    generateLayoutRow(row, fields) {
+        const lines = [];
+        const columns = row.columns ?? row.fields.length;
+        lines.push(`        <Group grow align="flex-start">`);
+        for (const fieldName of row.fields) {
+            const field = fields.find((f) => f.name === fieldName);
+            if (field) {
+                lines.push(this.generateMantineField(field, 10));
+            }
+        }
+        lines.push('        </Group>');
+        return lines.join('\n');
+    }
+    generateMantineField(field, indent) {
+        const spaces = ' '.repeat(indent);
+        switch (field.type) {
+            case 'textarea':
+                return `${spaces}<Textarea label="${field.label}" placeholder="${field.placeholder || ''}" ${field.required ? 'required' : ''} {...form.getInputProps('${field.name}')} />`;
+            case 'select':
+                const options = (field.options || []).map((opt) => `{ value: '${opt.value}', label: '${opt.label}' }`).join(', ');
+                return `${spaces}<Select label="${field.label}" placeholder="${field.placeholder || 'Select...'}" ${field.required ? 'required' : ''} data={[${options}]} {...form.getInputProps('${field.name}')} />`;
+            case 'checkbox':
+                return `${spaces}<Checkbox label="${field.label}" {...form.getInputProps('${field.name}', { type: 'checkbox' })} />`;
+            case 'number':
+                return `${spaces}<NumberInput label="${field.label}" placeholder="${field.placeholder || ''}" ${field.required ? 'required' : ''} {...form.getInputProps('${field.name}')} />`;
+            case 'email':
+                return `${spaces}<TextInput type="email" label="${field.label}" placeholder="${field.placeholder || ''}" ${field.required ? 'required' : ''} {...form.getInputProps('${field.name}')} />`;
+            case 'password':
+                return `${spaces}<TextInput type="password" label="${field.label}" placeholder="${field.placeholder || ''}" ${field.required ? 'required' : ''} {...form.getInputProps('${field.name}')} />`;
+            case 'date':
+                return `${spaces}<TextInput type="date" label="${field.label}" ${field.required ? 'required' : ''} {...form.getInputProps('${field.name}')} />`;
+            case 'time':
+                return `${spaces}<TextInput type="time" label="${field.label}" ${field.required ? 'required' : ''} {...form.getInputProps('${field.name}')} />`;
+            case 'datetime':
+                return `${spaces}<TextInput type="datetime-local" label="${field.label}" ${field.required ? 'required' : ''} {...form.getInputProps('${field.name}')} />`;
+            case 'file':
+                return `${spaces}<TextInput type="file" label="${field.label}" {...form.getInputProps('${field.name}')} />`;
+            default:
+                return `${spaces}<TextInput label="${field.label}" placeholder="${field.placeholder || ''}" ${field.required ? 'required' : ''} {...form.getInputProps('${field.name}')} />`;
+        }
+    }
+    // ===========================================================================
+    // Helpers
+    // ===========================================================================
+    mapPropType(type) {
+        const typeMap = {
+            string: 'string',
+            number: 'number',
+            boolean: 'boolean',
+            node: 'React.ReactNode',
+            element: 'React.ReactElement',
+            func: '() => void',
+            array: 'unknown[]',
+            object: 'Record<string, unknown>',
+        };
+        return typeMap[type] || type;
+    }
+    mapToMantineComponent(type) {
+        const componentMap = {
+            div: 'Box',
+            section: 'Box',
+            header: 'Box',
+            footer: 'Box',
+            article: 'Box',
+            aside: 'Box',
+            main: 'Box',
+            nav: 'Box',
+        };
+        return componentMap[type] || 'Box';
+    }
+    toCamelCase(str) {
+        return str.charAt(0).toLowerCase() + str.slice(1);
+    }
+    toKebabCase(str) {
+        return str.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();
+    }
+}
+// =============================================================================
+// Convenience Functions
+// =============================================================================
+/**
+ * Generate Mantine components from Kappa ComponentBlock nodes
+ */
+export function generateMantineComponents(components, options = {}) {
+    const generator = new KappaMantineGenerator(options);
+    return generator.generateComponents(components);
+}
+/**
+ * Generate Mantine forms from Kappa FormBlock nodes
+ */
+export function generateMantineForms(forms, options = {}) {
+    const generator = new KappaMantineGenerator(options);
+    return generator.generateForms(forms);
+}

package/dist/codedna/kappa-mongoose-generator.d.ts

@@ -0,0 +1,44 @@
+import type { EntityBlock } from './kappa-ast.js';
+export interface MongooseGeneratorOptions {
+    /** Generate TypeScript interfaces (default: true) */
+    typescript?: boolean;
+    /** Add provenance comments (default: true) */
+    provenance?: boolean;
+    /** Generate separate types file (default: true) */
+    separateTypes?: boolean;
+}
+export interface GeneratedMongooseSchema {
+    /** Main schema file content */
+    schema: string;
+    /** TypeScript types file content (if separateTypes is true) */
+    types?: string;
+}
+export declare class KappaMongooseGenerator {
+    private typescript;
+    private provenance;
+    private separateTypes;
+    constructor(options?: MongooseGeneratorOptions);
+    /**
+     * Generate Mongoose schema from entity blocks
+     */
+    generate(entities: EntityBlock[]): GeneratedMongooseSchema;
+    private generateSchemaFile;
+    private generateSchemaImports;
+    private fieldUsesSchemaTypes;
+    private generateSchema;
+    private generateField;
+    private generateRelationshipField;
+    private generateValidators;
+    private getMongooseType;
+    private generateIndexes;
+    private generateVirtualRelationships;
+    private generateInterface;
+    private getTypeScriptType;
+    private generateTypesFile;
+    private toSnakeCase;
+    private toCamelCase;
+}
+/**
+ * Generate Mongoose schema from Kappa entities
+ */
+export declare function generateMongooseSchema(entities: EntityBlock[], options?: MongooseGeneratorOptions): GeneratedMongooseSchema;