@claudetools/tools 0.8.10 → 0.9.0

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

@@ -0,0 +1,365 @@
+// =============================================================================
+// Kappa v2.5 Design Generator
+// =============================================================================
+//
+// Generates CSS variables and Tailwind config from Kappa DesignBlock AST.
+// Supports light/dark themes, typography, spacing, borders, shadows, and motion.
+//
+// =============================================================================
+// Generator Class
+// =============================================================================
+export class KappaDesignGenerator {
+    format;
+    provenance;
+    prefix;
+    hsl;
+    constructor(options = {}) {
+        this.format = options.format ?? 'both';
+        this.provenance = options.provenance ?? true;
+        this.prefix = options.prefix ?? '';
+        this.hsl = options.hsl ?? false;
+    }
+    /**
+     * Generate design files from DesignBlock AST
+     */
+    generate(design) {
+        const result = {};
+        if (this.format === 'css' || this.format === 'both') {
+            result.css = this.generateCSS(design);
+        }
+        if (this.format === 'tailwind' || this.format === 'both') {
+            result.tailwind = this.generateTailwind(design);
+        }
+        return result;
+    }
+    // ===========================================================================
+    // CSS Generation
+    // ===========================================================================
+    generateCSS(design) {
+        const lines = [];
+        // Header
+        if (this.provenance) {
+            lines.push('/* Generated by Kappa v2.5 CodeDNA */');
+            lines.push('/* Design System Variables */');
+            lines.push('');
+        }
+        // Root variables (light mode)
+        lines.push(':root {');
+        lines.push(this.generateColorVariables(design.colors, 2));
+        if (design.typography) {
+            lines.push('');
+            lines.push(this.generateTypographyVariables(design.typography, 2));
+        }
+        if (design.spacing) {
+            lines.push('');
+            lines.push(this.generateSpacingVariables(design.spacing, 2));
+        }
+        if (design.borders) {
+            lines.push('');
+            lines.push(this.generateBorderVariables(design.borders, 2));
+        }
+        if (design.shadows) {
+            lines.push('');
+            lines.push(this.generateShadowVariables(design.shadows, 2));
+        }
+        if (design.motion) {
+            lines.push('');
+            lines.push(this.generateMotionVariables(design.motion, 2));
+        }
+        lines.push('}');
+        // Dark mode
+        if (design.darkColors) {
+            lines.push('');
+            lines.push('@media (prefers-color-scheme: dark) {');
+            lines.push('  :root {');
+            lines.push(this.generateColorVariables(design.darkColors, 4));
+            lines.push('  }');
+            lines.push('}');
+            lines.push('');
+            lines.push('.dark {');
+            lines.push(this.generateColorVariables(design.darkColors, 2));
+            lines.push('}');
+        }
+        return {
+            path: 'styles/design-tokens.css',
+            content: lines.join('\n'),
+        };
+    }
+    generateColorVariables(palette, indent) {
+        const spaces = ' '.repeat(indent);
+        const lines = [];
+        const prefix = this.prefix ? `${this.prefix}-` : '';
+        for (const [name, colorValue] of Object.entries(palette.colors)) {
+            const value = this.resolveColorValue(colorValue, palette);
+            const varName = `--${prefix}color-${this.toKebabCase(name)}`;
+            lines.push(`${spaces}${varName}: ${value};`);
+        }
+        return lines.join('\n');
+    }
+    resolveColorValue(colorValue, palette) {
+        if (!colorValue.isFunction) {
+            if (this.hsl) {
+                return this.hexToHsl(colorValue.value);
+            }
+            return colorValue.value;
+        }
+        // Handle color functions
+        const { functionName, functionArgs } = colorValue;
+        if (!functionName || !functionArgs) {
+            return colorValue.value;
+        }
+        // Resolve base color reference
+        const baseColorRef = functionArgs[0];
+        const baseColor = palette.colors[baseColorRef];
+        const amount = functionArgs[1];
+        if (!baseColor) {
+            return colorValue.value;
+        }
+        const baseHex = baseColor.value;
+        switch (functionName) {
+            case 'darken':
+                return this.adjustColor(baseHex, -amount);
+            case 'lighten':
+                return this.adjustColor(baseHex, amount);
+            case 'alpha':
+                return this.addAlpha(baseHex, amount);
+            default:
+                return colorValue.value;
+        }
+    }
+    generateTypographyVariables(typography, indent) {
+        const spaces = ' '.repeat(indent);
+        const lines = [];
+        const prefix = this.prefix ? `${this.prefix}-` : '';
+        lines.push(`${spaces}/* Typography */`);
+        if (typography.fontFamily) {
+            lines.push(`${spaces}--${prefix}font-family: ${typography.fontFamily};`);
+        }
+        if (typography.fontMono) {
+            lines.push(`${spaces}--${prefix}font-mono: ${typography.fontMono};`);
+        }
+        if (typography.scale) {
+            for (const [name, size] of Object.entries(typography.scale)) {
+                lines.push(`${spaces}--${prefix}font-size-${this.toKebabCase(name)}: ${size};`);
+            }
+        }
+        if (typography.weight) {
+            for (const [name, weight] of Object.entries(typography.weight)) {
+                lines.push(`${spaces}--${prefix}font-weight-${this.toKebabCase(name)}: ${weight};`);
+            }
+        }
+        return lines.join('\n');
+    }
+    generateSpacingVariables(spacing, indent) {
+        const spaces = ' '.repeat(indent);
+        const lines = [];
+        const prefix = this.prefix ? `${this.prefix}-` : '';
+        lines.push(`${spaces}/* Spacing */`);
+        if (spacing.unit) {
+            lines.push(`${spaces}--${prefix}spacing-unit: ${spacing.unit};`);
+        }
+        if (spacing.scale) {
+            for (let i = 0; i < spacing.scale.length; i++) {
+                const value = spacing.scale[i];
+                const unit = spacing.unit || 'rem';
+                lines.push(`${spaces}--${prefix}spacing-${i}: ${value}${unit};`);
+            }
+        }
+        return lines.join('\n');
+    }
+    generateBorderVariables(borders, indent) {
+        const spaces = ' '.repeat(indent);
+        const lines = [];
+        const prefix = this.prefix ? `${this.prefix}-` : '';
+        lines.push(`${spaces}/* Borders */`);
+        if (borders.radius) {
+            for (const [name, value] of Object.entries(borders.radius)) {
+                lines.push(`${spaces}--${prefix}radius-${this.toKebabCase(name)}: ${value};`);
+            }
+        }
+        return lines.join('\n');
+    }
+    generateShadowVariables(shadows, indent) {
+        const spaces = ' '.repeat(indent);
+        const lines = [];
+        const prefix = this.prefix ? `${this.prefix}-` : '';
+        lines.push(`${spaces}/* Shadows */`);
+        if (shadows.shadows) {
+            for (const [name, value] of Object.entries(shadows.shadows)) {
+                lines.push(`${spaces}--${prefix}shadow-${this.toKebabCase(name)}: ${value};`);
+            }
+        }
+        return lines.join('\n');
+    }
+    generateMotionVariables(motion, indent) {
+        const spaces = ' '.repeat(indent);
+        const lines = [];
+        const prefix = this.prefix ? `${this.prefix}-` : '';
+        lines.push(`${spaces}/* Motion */`);
+        if (motion.duration) {
+            for (const [name, value] of Object.entries(motion.duration)) {
+                lines.push(`${spaces}--${prefix}duration-${this.toKebabCase(name)}: ${value};`);
+            }
+        }
+        if (motion.easing) {
+            for (const [name, value] of Object.entries(motion.easing)) {
+                lines.push(`${spaces}--${prefix}ease-${this.toKebabCase(name)}: ${value};`);
+            }
+        }
+        return lines.join('\n');
+    }
+    // ===========================================================================
+    // Tailwind Generation
+    // ===========================================================================
+    generateTailwind(design) {
+        const lines = [];
+        // Header
+        if (this.provenance) {
+            lines.push('// Generated by Kappa v2.5 CodeDNA');
+            lines.push('// Tailwind Theme Extension');
+            lines.push('');
+        }
+        lines.push("import type { Config } from 'tailwindcss';");
+        lines.push('');
+        lines.push('const designTokens: Partial<Config["theme"]> = {');
+        lines.push('  extend: {');
+        // Colors
+        lines.push('    colors: {');
+        for (const [name, colorValue] of Object.entries(design.colors.colors)) {
+            const value = this.resolveColorValue(colorValue, design.colors);
+            lines.push(`      '${this.toKebabCase(name)}': '${value}',`);
+        }
+        lines.push('    },');
+        // Typography
+        if (design.typography) {
+            if (design.typography.fontFamily) {
+                lines.push('    fontFamily: {');
+                lines.push(`      sans: ['${design.typography.fontFamily}', 'sans-serif'],`);
+                if (design.typography.fontMono) {
+                    lines.push(`      mono: ['${design.typography.fontMono}', 'monospace'],`);
+                }
+                lines.push('    },');
+            }
+            if (design.typography.scale) {
+                lines.push('    fontSize: {');
+                for (const [name, size] of Object.entries(design.typography.scale)) {
+                    lines.push(`      '${this.toKebabCase(name)}': '${size}',`);
+                }
+                lines.push('    },');
+            }
+            if (design.typography.weight) {
+                lines.push('    fontWeight: {');
+                for (const [name, weight] of Object.entries(design.typography.weight)) {
+                    lines.push(`      '${this.toKebabCase(name)}': '${weight}',`);
+                }
+                lines.push('    },');
+            }
+        }
+        // Spacing
+        if (design.spacing?.scale) {
+            lines.push('    spacing: {');
+            for (let i = 0; i < design.spacing.scale.length; i++) {
+                const value = design.spacing.scale[i];
+                const unit = design.spacing.unit || 'rem';
+                lines.push(`      '${i}': '${value}${unit}',`);
+            }
+            lines.push('    },');
+        }
+        // Border radius
+        if (design.borders?.radius) {
+            lines.push('    borderRadius: {');
+            for (const [name, value] of Object.entries(design.borders.radius)) {
+                lines.push(`      '${this.toKebabCase(name)}': '${value}',`);
+            }
+            lines.push('    },');
+        }
+        // Shadows
+        if (design.shadows?.shadows) {
+            lines.push('    boxShadow: {');
+            for (const [name, value] of Object.entries(design.shadows.shadows)) {
+                lines.push(`      '${this.toKebabCase(name)}': '${value}',`);
+            }
+            lines.push('    },');
+        }
+        // Motion/Animation
+        if (design.motion) {
+            if (design.motion.duration) {
+                lines.push('    transitionDuration: {');
+                for (const [name, value] of Object.entries(design.motion.duration)) {
+                    lines.push(`      '${this.toKebabCase(name)}': '${value}',`);
+                }
+                lines.push('    },');
+            }
+            if (design.motion.easing) {
+                lines.push('    transitionTimingFunction: {');
+                for (const [name, value] of Object.entries(design.motion.easing)) {
+                    lines.push(`      '${this.toKebabCase(name)}': '${value}',`);
+                }
+                lines.push('    },');
+            }
+        }
+        lines.push('  },');
+        lines.push('};');
+        lines.push('');
+        lines.push('export default designTokens;');
+        return {
+            path: 'styles/tailwind-tokens.ts',
+            content: lines.join('\n'),
+        };
+    }
+    // ===========================================================================
+    // Color Utilities
+    // ===========================================================================
+    hexToHsl(hex) {
+        const r = parseInt(hex.slice(1, 3), 16) / 255;
+        const g = parseInt(hex.slice(3, 5), 16) / 255;
+        const b = parseInt(hex.slice(5, 7), 16) / 255;
+        const max = Math.max(r, g, b);
+        const min = Math.min(r, g, b);
+        let h = 0;
+        let s = 0;
+        const l = (max + min) / 2;
+        if (max !== min) {
+            const d = max - min;
+            s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+            switch (max) {
+                case r:
+                    h = ((g - b) / d + (g < b ? 6 : 0)) / 6;
+                    break;
+                case g:
+                    h = ((b - r) / d + 2) / 6;
+                    break;
+                case b:
+                    h = ((r - g) / d + 4) / 6;
+                    break;
+            }
+        }
+        return `hsl(${Math.round(h * 360)}, ${Math.round(s * 100)}%, ${Math.round(l * 100)}%)`;
+    }
+    adjustColor(hex, amount) {
+        // Simple brightness adjustment
+        const r = Math.min(255, Math.max(0, parseInt(hex.slice(1, 3), 16) + amount * 2.55));
+        const g = Math.min(255, Math.max(0, parseInt(hex.slice(3, 5), 16) + amount * 2.55));
+        const b = Math.min(255, Math.max(0, parseInt(hex.slice(5, 7), 16) + amount * 2.55));
+        return `#${Math.round(r).toString(16).padStart(2, '0')}${Math.round(g).toString(16).padStart(2, '0')}${Math.round(b).toString(16).padStart(2, '0')}`;
+    }
+    addAlpha(hex, alpha) {
+        const r = parseInt(hex.slice(1, 3), 16);
+        const g = parseInt(hex.slice(3, 5), 16);
+        const b = parseInt(hex.slice(5, 7), 16);
+        return `rgba(${r}, ${g}, ${b}, ${alpha})`;
+    }
+    toKebabCase(str) {
+        return str.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();
+    }
+}
+// =============================================================================
+// Convenience Function
+// =============================================================================
+/**
+ * Generate design system files from Kappa DesignBlock
+ */
+export function generateDesign(design, options = {}) {
+    const generator = new KappaDesignGenerator(options);
+    return generator.generate(design);
+}

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

@@ -0,0 +1,45 @@
+import type { EntityBlock } from './kappa-ast.js';
+export type DrizzleDialect = 'postgresql' | 'mysql' | 'sqlite';
+export interface DrizzleGeneratorOptions {
+    /** Database dialect (default: postgresql) */
+    dialect?: DrizzleDialect;
+    /** Generate relations file (default: true) */
+    relations?: boolean;
+    /** Add provenance comments (default: true) */
+    provenance?: boolean;
+}
+export interface GeneratedSchema {
+    /** Main schema file content */
+    schema: string;
+    /** Relations file content (if enabled) */
+    relations?: string;
+    /** TypeScript types file content */
+    types: string;
+}
+export declare class KappaDrizzleGenerator {
+    private dialect;
+    private provenance;
+    private generateRelations;
+    constructor(options?: DrizzleGeneratorOptions);
+    /**
+     * Generate Drizzle schema from entity blocks
+     */
+    generate(entities: EntityBlock[]): GeneratedSchema;
+    private generateSchemaFile;
+    private generateSchemaImports;
+    private getTableFunction;
+    private generateTable;
+    private generateColumn;
+    private generateForeignKeyColumn;
+    private getColumnTypeFunction;
+    private getColumnTypeCall;
+    private generateIndexes;
+    private generateRelationsFile;
+    private generateEntityRelations;
+    private generateTypesFile;
+    private toSnakeCase;
+}
+/**
+ * Generate Drizzle schema from Kappa entities
+ */
+export declare function generateDrizzleSchema(entities: EntityBlock[], options?: DrizzleGeneratorOptions): GeneratedSchema;