@scaffit/core

Core utilities for Scaffit - AST manipulation, file operations, and scaffold execution.

Features

• AST Engine: Parse, modify, and generate JavaScript/TypeScript code
• File Operations: Safe file reading/writing with project detection
• Template Engine: Variable replacement and conditional rendering
• Scaffold Executor: Common installation logic and dependency management
• Validation: Zod-based configuration validation

Usage

import { FileOperations, ASTEngine, ScaffoldExecutor } from '@scaffit/core';

// Detect project type
const projectInfo = FileOperations.detectProject('./my-project');

// Parse and modify files
const ast = ASTEngine.parseFile('./src/index.ts');
ASTEngine.addImport('./src/index.ts', 'react', ['useState']);

// Execute scaffold
const result = await ScaffoldExecutor.executeScaffold(scaffold, config, './my-project');

API

FileOperations

• detectProject(rootDir) - Detect framework and configuration
• readFile(filePath) - Safely read file
• writeFile(filePath, content) - Safely write file
• addDependency(rootDir, name, version, isDev) - Add package dependency
• addScript(rootDir, name, command) - Add npm script

ASTEngine

• parseFile(filePath) - Parse JS/TS to AST
• addImport(filePath, source, specifiers) - Add import statement
• addExport(filePath, name, value) - Add export statement
• addFunction(filePath, name, params, body) - Add function
• applyModifications(filePath, modifications) - Apply multiple changes

TemplateEngine

• renderTemplate(template, variables) - Simple variable replacement
• renderTemplateWithConditionals(template, variables) - With if/unless blocks
• generateFileContent(templatePath, variables) - Generate file content

ScaffoldExecutor

• executeScaffold(scaffold, config, projectRoot) - Run scaffold installation
• getScaffoldPreview(scaffold, config, projectRoot) - Preview changes
• createFileFromTemplate(filePath, templateName, variables) - Create file
• installDependencies(projectRoot, packageManager) - Install deps