@dcyfr/ai-code-gen 0.1.0

package/dist/templates/builtins.js

@@ -0,0 +1,275 @@
+/**
+ * @dcyfr/ai-code-gen - Built-in template definitions
+ *
+ * Pre-configured templates for common code generation patterns.
+ */
+// ─── React Component Template ───────────────────────────────────────
+export const REACT_COMPONENT_TEMPLATE = {
+    id: 'react-component',
+    name: 'React Component',
+    description: 'Generate a React functional component with TypeScript',
+    outputExtension: '.tsx',
+    variables: [
+        { name: 'name', type: 'string', description: 'Component name', required: true },
+        { name: 'props', type: 'array', description: 'Component props', required: false, defaultValue: [] },
+        { name: 'hasChildren', type: 'boolean', description: 'Include children prop', required: false, defaultValue: false },
+        { name: 'useClient', type: 'boolean', description: 'Add "use client" directive', required: false, defaultValue: false },
+        { name: 'description', type: 'string', description: 'Component description', required: false },
+    ],
+    source: `{{#if useClient}}'use client';
+
+{{/if}}/**
+ * {{pascalCase name}} component
+{{#if description}} * {{description}}
+{{/if}} */
+
+{{#if props.length}}interface {{pascalCase name}}Props {
+{{#each props}}  {{this.name}}{{#unless this.required}}?{{/unless}}: {{this.type}};
+{{/each}}{{#if hasChildren}}  children?: React.ReactNode;
+{{/if}}
+}
+{{else}}{{#if hasChildren}}interface {{pascalCase name}}Props {
+  children?: React.ReactNode;
+}
+{{/if}}{{/if}}
+export function {{pascalCase name}}({{#if props.length}}{ {{#each props}}{{this.name}}{{#unless @last}}, {{/unless}}{{/each}}{{#if hasChildren}}, children{{/if}} }: {{pascalCase name}}Props{{else}}{{#if hasChildren}}{ children }: {{pascalCase name}}Props{{/if}}{{/if}}) {
+  return (
+    <div>
+      <h2>{{pascalCase name}}</h2>
+{{#if hasChildren}}      {children}
+{{/if}}    </div>
+  );
+}
+`,
+};
+// ─── API Route Template ─────────────────────────────────────────────
+export const API_ROUTE_TEMPLATE = {
+    id: 'api-route',
+    name: 'API Route',
+    description: 'Generate a Next.js API route handler',
+    outputExtension: '.ts',
+    variables: [
+        { name: 'name', type: 'string', description: 'Route name', required: true },
+        { name: 'methods', type: 'array', description: 'HTTP methods', required: false, defaultValue: ['GET'] },
+        { name: 'hasAuth', type: 'boolean', description: 'Include auth middleware', required: false, defaultValue: false },
+        { name: 'description', type: 'string', description: 'Route description', required: false },
+    ],
+    source: `/**
+ * {{pascalCase name}} API Route
+{{#if description}} * {{description}}
+{{/if}} */
+
+import { NextRequest, NextResponse } from 'next/server';
+{{#if hasAuth}}
+// import { requireAuth } from '@/lib/auth';
+{{/if}}
+
+{{#each methods}}
+{{#if (eq this "GET")}}
+export async function GET(request: NextRequest) {
+  try {
+    const { searchParams } = new URL(request.url);
+    const id = searchParams.get('id');
+
+    // TODO: Implement {{../name}} GET logic
+    const data = { id, message: '{{../name}} GET endpoint' };
+
+    return NextResponse.json(data);
+  } catch (error) {
+    console.error('{{../name}} GET error:', error);
+    return NextResponse.json({ error: 'Internal Server Error' }, { status: 500 });
+  }
+}
+{{/if}}
+
+{{#if (eq this "POST")}}
+export async function POST(request: NextRequest) {
+  try {
+    const body = await request.json();
+
+    // Validate input
+    if (!body) {
+      return NextResponse.json({ error: 'Request body is required' }, { status: 400 });
+    }
+
+    // TODO: Implement {{../name}} POST logic
+    const result = { success: true, data: body };
+
+    return NextResponse.json(result, { status: 201 });
+  } catch (error) {
+    console.error('{{../name}} POST error:', error);
+    return NextResponse.json({ error: 'Internal Server Error' }, { status: 500 });
+  }
+}
+{{/if}}
+
+{{#if (eq this "PUT")}}
+export async function PUT(request: NextRequest) {
+  try {
+    const body = await request.json();
+    const { searchParams } = new URL(request.url);
+    const id = searchParams.get('id');
+
+    if (!id) {
+      return NextResponse.json({ error: 'ID is required' }, { status: 400 });
+    }
+
+    // TODO: Implement {{../name}} PUT logic
+    const result = { success: true, id, data: body };
+
+    return NextResponse.json(result);
+  } catch (error) {
+    console.error('{{../name}} PUT error:', error);
+    return NextResponse.json({ error: 'Internal Server Error' }, { status: 500 });
+  }
+}
+{{/if}}
+
+{{#if (eq this "DELETE")}}
+export async function DELETE(request: NextRequest) {
+  try {
+    const { searchParams } = new URL(request.url);
+    const id = searchParams.get('id');
+
+    if (!id) {
+      return NextResponse.json({ error: 'ID is required' }, { status: 400 });
+    }
+
+    // TODO: Implement {{../name}} DELETE logic
+
+    return NextResponse.json({ success: true, id });
+  } catch (error) {
+    console.error('{{../name}} DELETE error:', error);
+    return NextResponse.json({ error: 'Internal Server Error' }, { status: 500 });
+  }
+}
+{{/if}}
+{{/each}}
+`,
+};
+// ─── Data Model Template ────────────────────────────────────────────
+export const DATA_MODEL_TEMPLATE = {
+    id: 'data-model',
+    name: 'Data Model',
+    description: 'Generate a TypeScript data model with Zod schema validation',
+    outputExtension: '.ts',
+    variables: [
+        { name: 'name', type: 'string', description: 'Model name', required: true },
+        { name: 'fields', type: 'array', description: 'Model fields', required: true },
+        { name: 'hasTimestamps', type: 'boolean', description: 'Include createdAt/updatedAt', required: false, defaultValue: true },
+        { name: 'description', type: 'string', description: 'Model description', required: false },
+    ],
+    source: `/**
+ * {{pascalCase name}} data model
+{{#if description}} * {{description}}
+{{/if}} */
+
+import { z } from 'zod';
+
+// ─── Zod Schema ─────────────────────────────────────────────────────
+
+export const {{camelCase name}}Schema = z.object({
+  id: z.string().uuid(),
+{{#each fields}}  {{this.name}}: z.{{this.zodType}}(){{#if this.optional}}.optional(){{/if}},
+{{/each}}{{#if hasTimestamps}}  createdAt: z.date(),
+  updatedAt: z.date(),
+{{/if}}
+});
+
+export const create{{pascalCase name}}Schema = {{camelCase name}}Schema.omit({
+  id: true,
+{{#if hasTimestamps}}  createdAt: true,
+  updatedAt: true,
+{{/if}}
+});
+
+export const update{{pascalCase name}}Schema = create{{pascalCase name}}Schema.partial();
+
+// ─── Types ──────────────────────────────────────────────────────────
+
+export type {{pascalCase name}} = z.infer<typeof {{camelCase name}}Schema>;
+export type Create{{pascalCase name}} = z.infer<typeof create{{pascalCase name}}Schema>;
+export type Update{{pascalCase name}} = z.infer<typeof update{{pascalCase name}}Schema>;
+
+// ─── Factory ────────────────────────────────────────────────────────
+
+export function create{{pascalCase name}}(data: Create{{pascalCase name}}): {{pascalCase name}} {
+  const now = new Date();
+  return {
+    id: crypto.randomUUID(),
+    ...data,
+{{#if hasTimestamps}}    createdAt: now,
+    updatedAt: now,
+{{/if}}  };
+}
+`,
+};
+// ─── Test File Template ─────────────────────────────────────────────
+export const TEST_FILE_TEMPLATE = {
+    id: 'test-file',
+    name: 'Test File',
+    description: 'Generate a Vitest test file',
+    outputExtension: '.test.ts',
+    variables: [
+        { name: 'name', type: 'string', description: 'Module name to test', required: true },
+        { name: 'importPath', type: 'string', description: 'Import path', required: true },
+        { name: 'functions', type: 'array', description: 'Functions to test', required: false, defaultValue: [] },
+        { name: 'description', type: 'string', description: 'Test description', required: false },
+    ],
+    source: `/**
+ * Tests for {{pascalCase name}}
+ */
+
+import { describe, it, expect, beforeEach } from 'vitest';
+{{#if functions.length}}import { {{#each functions}}{{this}}{{#unless @last}}, {{/unless}}{{/each}} } from '{{importPath}}';
+{{else}}// import { ... } from '{{importPath}}';
+{{/if}}
+
+describe('{{pascalCase name}}', () => {
+{{#each functions}}
+  describe('{{this}}', () => {
+    it('should exist', () => {
+      expect({{this}}).toBeDefined();
+    });
+
+    it('should work correctly', () => {
+      // TODO: Implement test for {{this}}
+    });
+  });
+
+{{/each}}{{#unless functions.length}}
+  it('should be implemented', () => {
+    // TODO: Add tests for {{pascalCase name}}
+    expect(true).toBe(true);
+  });
+{{/unless}}
+});
+`,
+};
+// ─── Barrel Export Template ─────────────────────────────────────────
+export const BARREL_EXPORT_TEMPLATE = {
+    id: 'barrel-export',
+    name: 'Barrel Export',
+    description: 'Generate an index.ts barrel export file',
+    outputExtension: '.ts',
+    variables: [
+        { name: 'exports', type: 'array', description: 'Modules to export', required: true },
+        { name: 'description', type: 'string', description: 'Module description', required: false },
+    ],
+    source: `/**
+ * {{#if description}}{{description}}{{else}}Barrel exports{{/if}}
+ */
+
+{{#each exports}}export { {{#each this.names}}{{this}}{{#unless @last}}, {{/unless}}{{/each}} } from './{{../exports.[0]}}';
+{{/each}}
+`,
+};
+// ─── Export all built-in templates ──────────────────────────────────
+export const BUILTIN_TEMPLATES = [
+    REACT_COMPONENT_TEMPLATE,
+    API_ROUTE_TEMPLATE,
+    DATA_MODEL_TEMPLATE,
+    TEST_FILE_TEMPLATE,
+    BARREL_EXPORT_TEMPLATE,
+];
+//# sourceMappingURL=builtins.js.map

package/dist/templates/builtins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.js","sourceRoot":"","sources":["../../src/templates/builtins.ts"],"names":[],"mappings":"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"}

package/dist/templates/engine.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @dcyfr/ai-code-gen - Template engine
+ *
+ * Handlebars-based template engine with built-in helpers for code generation.
+ */
+import Handlebars from 'handlebars';
+import type { TemplateDefinition, TemplateContext, TemplateRenderResult, TemplateVariable } from '../types/index.js';
+/** Template engine for rendering code templates */
+export declare class TemplateEngine {
+    private readonly handlebars;
+    private readonly compiledCache;
+    private readonly definitions;
+    constructor();
+    /**
+     * Register built-in Handlebars helpers for code generation.
+     */
+    private registerBuiltinHelpers;
+    /**
+     * Register a template definition.
+     */
+    registerTemplate(definition: TemplateDefinition): void;
+    /**
+     * Register a custom Handlebars helper.
+     */
+    registerHelper(name: string, fn: Handlebars.HelperDelegate): void;
+    /**
+     * Register a partial template.
+     */
+    registerPartial(name: string, source: string): void;
+    /**
+     * Compile and render a template by ID.
+     */
+    render(templateId: string, context: TemplateContext): TemplateRenderResult;
+    /**
+     * Compile and render a raw template string.
+     */
+    renderSource(source: string, context: TemplateContext, cacheKey?: string): TemplateRenderResult;
+    /**
+     * Validate template variables against a definition.
+     */
+    validateVariables(templateId: string, context: TemplateContext): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * List all registered templates.
+     */
+    listTemplates(): TemplateDefinition[];
+    /**
+     * Get a specific template definition.
+     */
+    getTemplate(templateId: string): TemplateDefinition | undefined;
+    /**
+     * Clear all compiled template caches.
+     */
+    clearCache(): void;
+}
+/**
+ * Validate template variables against their definitions.
+ */
+export declare function validateTemplateVariables(variables: TemplateVariable[], context: TemplateContext): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Create and return a pre-configured TemplateEngine instance.
+ */
+export declare function createTemplateEngine(): TemplateEngine;
+//# sourceMappingURL=engine.d.ts.map

package/dist/templates/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/templates/engine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAW3B,mDAAmD;AACnD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsD;IACpF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA8C;;IAO1E;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA4C9B;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI;IAMtD;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,CAAC,cAAc,GAAG,IAAI;IAIjE;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAInD;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,oBAAoB;IAS1E;;OAEG;IACH,YAAY,CACV,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,EACxB,QAAQ,CAAC,EAAE,MAAM,GAChB,oBAAoB;IAqBvB;;OAEG;IACH,iBAAiB,CACf,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,eAAe,GACvB;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IASvC;;OAEG;IACH,aAAa,IAAI,kBAAkB,EAAE;IAIrC;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAI/D;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,gBAAgB,EAAE,EAC7B,OAAO,EAAE,eAAe,GACvB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAsBtC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAErD"}

package/dist/templates/engine.js

@@ -0,0 +1,154 @@
+/**
+ * @dcyfr/ai-code-gen - Template engine
+ *
+ * Handlebars-based template engine with built-in helpers for code generation.
+ */
+import Handlebars from 'handlebars';
+import { toPascalCase, toCamelCase, toKebabCase, toSnakeCase, toConstantCase, pluralize, indent, } from '../lib/strings.js';
+/** Template engine for rendering code templates */
+export class TemplateEngine {
+    handlebars;
+    compiledCache = new Map();
+    definitions = new Map();
+    constructor() {
+        this.handlebars = Handlebars.create();
+        this.registerBuiltinHelpers();
+    }
+    /**
+     * Register built-in Handlebars helpers for code generation.
+     */
+    registerBuiltinHelpers() {
+        // Case conversion helpers
+        this.handlebars.registerHelper('pascalCase', (str) => toPascalCase(str));
+        this.handlebars.registerHelper('camelCase', (str) => toCamelCase(str));
+        this.handlebars.registerHelper('kebabCase', (str) => toKebabCase(str));
+        this.handlebars.registerHelper('snakeCase', (str) => toSnakeCase(str));
+        this.handlebars.registerHelper('constantCase', (str) => toConstantCase(str));
+        this.handlebars.registerHelper('upperCase', (str) => str.toUpperCase());
+        this.handlebars.registerHelper('lowerCase', (str) => str.toLowerCase());
+        // Pluralization
+        this.handlebars.registerHelper('pluralize', (str) => pluralize(str));
+        // Indentation
+        this.handlebars.registerHelper('indent', (str, spaces) => typeof spaces === 'number' ? indent(str, spaces) : indent(str, 2));
+        // Conditional helpers
+        this.handlebars.registerHelper('eq', (a, b) => a === b);
+        this.handlebars.registerHelper('neq', (a, b) => a !== b);
+        this.handlebars.registerHelper('or', (a, b) => a || b);
+        this.handlebars.registerHelper('and', (a, b) => a && b);
+        this.handlebars.registerHelper('not', (a) => !a);
+        // String helpers
+        this.handlebars.registerHelper('join', (arr, sep) => Array.isArray(arr) ? arr.join(typeof sep === 'string' ? sep : ', ') : '');
+        // Timestamp
+        this.handlebars.registerHelper('timestamp', () => new Date().toISOString());
+        this.handlebars.registerHelper('year', () => new Date().getFullYear().toString());
+        // Code generation helpers
+        this.handlebars.registerHelper('typeAnnotation', (type) => type ? `: ${type}` : '');
+        this.handlebars.registerHelper('genericType', (base, param) => param ? `${base}<${param}>` : base);
+    }
+    /**
+     * Register a template definition.
+     */
+    registerTemplate(definition) {
+        this.definitions.set(definition.id, definition);
+        // Invalidate cache for this template
+        this.compiledCache.delete(definition.id);
+    }
+    /**
+     * Register a custom Handlebars helper.
+     */
+    registerHelper(name, fn) {
+        this.handlebars.registerHelper(name, fn);
+    }
+    /**
+     * Register a partial template.
+     */
+    registerPartial(name, source) {
+        this.handlebars.registerPartial(name, source);
+    }
+    /**
+     * Compile and render a template by ID.
+     */
+    render(templateId, context) {
+        const definition = this.definitions.get(templateId);
+        if (!definition) {
+            throw new Error(`Template not found: ${templateId}`);
+        }
+        return this.renderSource(definition.source, context, templateId);
+    }
+    /**
+     * Compile and render a raw template string.
+     */
+    renderSource(source, context, cacheKey) {
+        let compiled;
+        if (cacheKey && this.compiledCache.has(cacheKey)) {
+            compiled = this.compiledCache.get(cacheKey);
+        }
+        else {
+            compiled = this.handlebars.compile(source, { noEscape: true });
+            if (cacheKey) {
+                this.compiledCache.set(cacheKey, compiled);
+            }
+        }
+        const content = compiled(context);
+        return {
+            content,
+            templateId: cacheKey ?? 'inline',
+            variables: { ...context },
+        };
+    }
+    /**
+     * Validate template variables against a definition.
+     */
+    validateVariables(templateId, context) {
+        const definition = this.definitions.get(templateId);
+        if (!definition) {
+            return { valid: false, errors: [`Template not found: ${templateId}`] };
+        }
+        return validateTemplateVariables(definition.variables, context);
+    }
+    /**
+     * List all registered templates.
+     */
+    listTemplates() {
+        return Array.from(this.definitions.values());
+    }
+    /**
+     * Get a specific template definition.
+     */
+    getTemplate(templateId) {
+        return this.definitions.get(templateId);
+    }
+    /**
+     * Clear all compiled template caches.
+     */
+    clearCache() {
+        this.compiledCache.clear();
+    }
+}
+/**
+ * Validate template variables against their definitions.
+ */
+export function validateTemplateVariables(variables, context) {
+    const errors = [];
+    for (const variable of variables) {
+        const value = context[variable.name];
+        if (variable.required && (value === undefined || value === null)) {
+            errors.push(`Required variable '${variable.name}' is missing`);
+            continue;
+        }
+        if (value !== undefined && value !== null) {
+            const actualType = Array.isArray(value) ? 'array' : typeof value;
+            if (actualType !== variable.type) {
+                errors.push(`Variable '${variable.name}' expected type '${variable.type}', got '${actualType}'`);
+            }
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Create and return a pre-configured TemplateEngine instance.
+ */
+export function createTemplateEngine() {
+    return new TemplateEngine();
+}
+//# sourceMappingURL=engine.js.map

package/dist/templates/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/templates/engine.ts"],"names":[],"mappings":"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"}

package/dist/templates/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @dcyfr/ai-code-gen - Template module exports
+ */
+export { TemplateEngine, createTemplateEngine, validateTemplateVariables } from './engine.js';
+export { BUILTIN_TEMPLATES, REACT_COMPONENT_TEMPLATE, API_ROUTE_TEMPLATE, DATA_MODEL_TEMPLATE, TEST_FILE_TEMPLATE, BARREL_EXPORT_TEMPLATE, } from './builtins.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/templates/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAC9F,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,eAAe,CAAC"}

package/dist/templates/index.js

@@ -0,0 +1,6 @@
+/**
+ * @dcyfr/ai-code-gen - Template module exports
+ */
+export { TemplateEngine, createTemplateEngine, validateTemplateVariables } from './engine.js';
+export { BUILTIN_TEMPLATES, REACT_COMPONENT_TEMPLATE, API_ROUTE_TEMPLATE, DATA_MODEL_TEMPLATE, TEST_FILE_TEMPLATE, BARREL_EXPORT_TEMPLATE, } from './builtins.js';
+//# sourceMappingURL=index.js.map

package/dist/templates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAC9F,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,eAAe,CAAC"}