stackkit 0.2.3 → 0.2.7

package/dist/lib/constants.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_LANGUAGE = exports.DEFAULT_PACKAGE_MANAGER = exports.PACKAGE_NAME = exports.CLI_COLORS = exports.SUCCESS_MESSAGES = exports.ERROR_MESSAGES = exports.DISPLAY_NAMES = exports.ROUTER_TYPES = exports.ENV_PATTERNS = exports.RETRY_CONFIG = exports.TIMEOUTS = exports.EXCLUDE_FROM_COPY = exports.ENV_FILES = exports.FILE_NAMES = exports.DIRECTORY_NAMES = exports.MODULE_CATEGORIES = exports.LANGUAGES = exports.LOCK_FILES_ARRAY = exports.LOCK_FILES = exports.PACKAGE_MANAGERS = void 0;
+exports.PACKAGE_MANAGERS = {
+    PNPM: "pnpm",
+    NPM: "npm",
+    YARN: "yarn",
+    BUN: "bun",
+};
+exports.LOCK_FILES = {
+    [exports.PACKAGE_MANAGERS.PNPM]: "pnpm-lock.yaml",
+    [exports.PACKAGE_MANAGERS.YARN]: "yarn.lock",
+    [exports.PACKAGE_MANAGERS.BUN]: "bun.lockb",
+    [exports.PACKAGE_MANAGERS.NPM]: "package-lock.json",
+};
+// Array of lock files with package managers for iteration
+exports.LOCK_FILES_ARRAY = [
+    { file: exports.LOCK_FILES.pnpm, pm: exports.PACKAGE_MANAGERS.PNPM },
+    { file: exports.LOCK_FILES.yarn, pm: exports.PACKAGE_MANAGERS.YARN },
+    { file: exports.LOCK_FILES.bun, pm: exports.PACKAGE_MANAGERS.BUN },
+    { file: exports.LOCK_FILES.npm, pm: exports.PACKAGE_MANAGERS.NPM },
+];
+exports.LANGUAGES = {
+    TYPESCRIPT: "typescript",
+    JAVASCRIPT: "javascript",
+};
+exports.MODULE_CATEGORIES = {
+    DATABASE: "database",
+    AUTH: "auth",
+    FRAMEWORK: "framework",
+};
+exports.DIRECTORY_NAMES = {
+    MODULES: "modules",
+    TEMPLATES: "templates",
+    NODE_MODULES: "node_modules",
+    GIT: ".git",
+    PRISMA: "prisma",
+    FILES: "files",
+    SRC: "src",
+    DIST: "dist",
+    BIN: "bin",
+};
+exports.FILE_NAMES = {
+    PACKAGE_JSON: "package.json",
+    TSCONFIG_JSON: "tsconfig.json",
+    MODULE_JSON: "module.json",
+    GENERATOR_JSON: "generator.json",
+    TEMPLATE_JSON: "template.json",
+    CONFIG_JSON: "config.json",
+    ENV: ".env",
+    ENV_LOCAL: ".env.local",
+    ENV_EXAMPLE: ".env.example",
+    GITIGNORE: ".gitignore",
+    README: "README.md",
+    SCHEMA_PRISMA: "schema.prisma",
+};
+exports.ENV_FILES = [exports.FILE_NAMES.ENV, exports.FILE_NAMES.ENV_LOCAL];
+exports.EXCLUDE_FROM_COPY = [
+    exports.FILE_NAMES.TEMPLATE_JSON,
+    exports.FILE_NAMES.CONFIG_JSON,
+    exports.DIRECTORY_NAMES.NODE_MODULES,
+    exports.DIRECTORY_NAMES.GIT,
+];
+exports.TIMEOUTS = {
+    PACKAGE_INSTALL: 300000, // 5 minutes in milliseconds
+    GIT_INIT: 30000, // 30 seconds
+    RETRY_DELAY_BASE: 1000, // 1 second base delay for retries
+};
+exports.RETRY_CONFIG = {
+    MAX_ATTEMPTS: 2,
+    PACKAGE_ROOT_MAX_ATTEMPTS: 10,
+};
+exports.ENV_PATTERNS = {
+    KEY: /^[A-Z_][A-Z0-9_]*$/,
+    COMMENT: /^\s*#/,
+};
+exports.ROUTER_TYPES = {
+    APP: "app",
+    PAGES: "pages",
+};
+exports.DISPLAY_NAMES = {
+    [exports.MODULE_CATEGORIES.DATABASE]: "Database",
+    [exports.MODULE_CATEGORIES.AUTH]: "Auth",
+    [exports.MODULE_CATEGORIES.FRAMEWORK]: "Framework",
+};
+exports.ERROR_MESSAGES = {
+    NO_PACKAGE_JSON: "No package.json found in current directory or any parent directory.",
+    INVALID_DIRECTORY: "Target directory already exists and is not empty.",
+    INVALID_PROJECT_NAME: "Invalid project name. Please use a valid npm package name.",
+    UNKNOWN_MODULE_TYPE: (module) => `Unknown module type "${module}". Use "${exports.MODULE_CATEGORIES.DATABASE}" or "${exports.MODULE_CATEGORIES.AUTH}", or specify a provider directly.`,
+    MODULE_NOT_FOUND: (moduleName) => `Module "${moduleName}" not found.`,
+    TEMPLATE_NOT_FOUND: (framework) => `Base template not found for framework: ${framework}`,
+    GIT_INIT_FAILED: "Failed to initialize git repository",
+    PACKAGE_INSTALL_FAILED: "Failed to install dependencies",
+};
+exports.SUCCESS_MESSAGES = {
+    PROJECT_CREATED: "✨ Project created successfully!",
+    MODULE_ADDED: "✨ Module added successfully!",
+    DEPENDENCIES_INSTALLED: "✓ Dependencies installed",
+    GIT_INITIALIZED: "✓ Git repository initialized",
+};
+exports.CLI_COLORS = {
+    PRIMARY: "cyan",
+    SUCCESS: "green",
+    WARNING: "yellow",
+    ERROR: "red",
+    INFO: "blue",
+    HEADER: "magenta",
+};
+exports.PACKAGE_NAME = "stackkit";
+exports.DEFAULT_PACKAGE_MANAGER = exports.PACKAGE_MANAGERS.NPM;
+exports.DEFAULT_LANGUAGE = exports.LANGUAGES.TYPESCRIPT;

package/dist/lib/conversion/js-conversion.js

@@ -7,6 +7,7 @@ exports.convertToJavaScript = convertToJavaScript;
 /* eslint-disable @typescript-eslint/no-require-imports */
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
+const logger_1 = require("../ui/logger");
 const package_root_1 = require("../utils/package-root");
 const baseDirs = {
     express: "./src",
@@ -41,6 +42,32 @@ async function convertToJavaScript(targetDir, framework) {
     };
     await removeDtsFiles(targetDir);
     const babel = require("@babel/core");
+    const checkModule = (name) => {
+        try {
+            require.resolve(name);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    const hasRecast = checkModule("recast");
+    const hasBabelParser = checkModule("@babel/parser");
+    const hasTransformTypescript = checkModule("@babel/plugin-transform-typescript");
+    if (!hasRecast || !hasBabelParser || !hasTransformTypescript) {
+        const packageRoot = (0, package_root_1.getPackageRoot)();
+        const missing = [];
+        if (!hasRecast)
+            missing.push("recast");
+        if (!hasBabelParser)
+            missing.push("@babel/parser");
+        if (!hasTransformTypescript)
+            missing.push("@babel/plugin-transform-typescript");
+        logger_1.logger.warn(`Optional tooling missing: ${missing.join(", ")}. Generated JavaScript may contain transformed JSX.`);
+        if (process.env.STACKKIT_VERBOSE === "1" || process.env.DEBUG) {
+            logger_1.logger.info(`To ensure generated JavaScript preserves JSX, add these to the CLI package dependencies or run 'pnpm install' in ${packageRoot}`);
+        }
+    }
     const transpileAllTsFiles = async (dir) => {
         const entries = await fs_extra_1.default.readdir(dir, { withFileTypes: true });
         for (const entry of entries) {
@@ -73,20 +100,10 @@ async function convertToJavaScript(targetDir, framework) {
                             },
                         ],
                     ];
-                    if (isTsx) {
-                        presets.push([
-                            require.resolve("@babel/preset-react"),
-                            {
-                                runtime: "automatic",
-                            },
-                        ]);
-                    }
-                    // Use recast + Babel AST transform (same approach as transform.tools)
                     try {
                         const recast = require("recast");
                         const { transformFromAstSync } = require("@babel/core");
                         const transformTypescript = require("@babel/plugin-transform-typescript");
-                        // getBabelOptions may be exported as default or directly
                         // eslint-disable-next-line @typescript-eslint/no-explicit-any
                         let getBabelOptions = require("recast/parsers/_babel_options");
                         if (getBabelOptions && getBabelOptions.default)
@@ -96,7 +113,6 @@ async function convertToJavaScript(targetDir, framework) {
                             parser: {
                                 parse: (source, options) => {
                                     const babelOptions = getBabelOptions(options || {});
-                                    // ensure typescript and jsx handling
                                     if (isTsx) {
                                         babelOptions.plugins.push("typescript", "jsx");
                                     }

package/dist/lib/discovery/installed-detection.js

@@ -44,7 +44,7 @@ async function collectModulePkgNames(modulePath) {
             }
         }
         catch {
-            // ignore
+            // ignore malformed module.json
         }
     }
     return Array.from(new Set(pkgNames));
@@ -70,7 +70,7 @@ async function detectAuthModules(packageJson) {
                                 moduleName = m.name;
                         }
                         catch {
-                            /* ignore */
+                            // ignore malformed module.json
                         }
                     }
                     for (const pkg of pkgNames) {
@@ -111,7 +111,7 @@ async function detectDatabaseModules(packageJson) {
                                 moduleName = m.name;
                         }
                         catch {
-                            /* ignore */
+                            // ignore malformed module.json
                         }
                     }
                     for (const pkg of pkgNames) {

package/dist/lib/discovery/module-discovery.d.ts

@@ -41,7 +41,7 @@ export declare function getValidAuthOptions(authModules: ModuleMetadata[]): stri
 /**
  * Get compatible auth options for given framework and database
  */
-export declare function getCompatibleAuthOptions(authModules: ModuleMetadata[], framework: string, database: string): Array<{
+export declare function getCompatibleAuthOptions(authModules: ModuleMetadata[], framework: string, database: string, frameworksMeta?: ModuleMetadata[]): Array<{
     name: string;
     value: string;
 }>;

package/dist/lib/discovery/module-discovery.js

@@ -52,7 +52,7 @@ async function discoverModules(modulesDir) {
                     });
                 }
                 catch {
-                    // Silently skip invalid templates
+                    // ignore invalid template
                 }
             }
         }
@@ -83,7 +83,7 @@ async function discoverModules(modulesDir) {
                     discovered.databases.push(metadata);
                 }
                 catch {
-                    // Silently skip invalid modules
+                    // ignore invalid module
                 }
             }
         }
@@ -105,7 +105,7 @@ async function discoverModules(modulesDir) {
                     discovered.auth.push(metadata);
                 }
                 catch {
-                    // Silently skip invalid modules
+                    // ignore invalid module
                 }
             }
         }
@@ -149,7 +149,7 @@ function getValidAuthOptions(authModules) {
 /**
  * Get compatible auth options for given framework and database
  */
-function getCompatibleAuthOptions(authModules, framework, database) {
+function getCompatibleAuthOptions(authModules, framework, database, frameworksMeta) {
     const compatible = [];
     for (const auth of authModules) {
         // Check if auth supports the framework
@@ -159,10 +159,26 @@ function getCompatibleAuthOptions(authModules, framework, database) {
         // Normalize database option (handle prisma-<provider> values)
         const parsedDb = (0, shared_1.parseDatabaseOption)(database || "").database;
         // If module provides explicit compatibility matrix, use it
+        let dbCompatible = true;
         if (auth.compatibility && auth.compatibility.databases) {
-            if (!auth.compatibility.databases.includes(parsedDb))
-                continue;
+            dbCompatible = auth.compatibility.databases.includes(parsedDb);
         }
+        // If the framework template explicitly lists this auth as compatible,
+        // allow it even if the auth module's database compatibility would normally
+        // exclude the current database selection (covers cases like React where
+        // the framework can support auth without a DB).
+        let explicitlyAllowedByFramework = false;
+        if (frameworksMeta && Array.isArray(frameworksMeta)) {
+            const fw = frameworksMeta.find((f) => f.name === framework);
+            if (fw && fw.compatibility) {
+                const authList = fw.compatibility.auth;
+                if (Array.isArray(authList) && authList.includes(auth.name)) {
+                    explicitlyAllowedByFramework = true;
+                }
+            }
+        }
+        if (!dbCompatible && !explicitlyAllowedByFramework)
+            continue;
         compatible.push({
             name: auth.displayName,
             value: auth.name,

package/dist/lib/env/env-editor.js

@@ -7,94 +7,88 @@ exports.addEnvVariables = addEnvVariables;
 exports.removeEnvVariables = removeEnvVariables;
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
+const constants_1 = require("../constants");
 const logger_1 = require("../ui/logger");
 async function addEnvVariables(projectRoot, variables, options = {}) {
-    const envExamplePath = path_1.default.join(projectRoot, ".env.example");
-    const envPath = path_1.default.join(projectRoot, ".env");
-    await appendToEnvFile(envExamplePath, variables, "example", options);
-    const envExists = await fs_extra_1.default.pathExists(envPath);
-    if (envExists || options.force) {
-        await appendToEnvFile(envPath, variables, "local", options);
+    validateEnvVariables(variables);
+    const envExamplePath = path_1.default.join(projectRoot, constants_1.FILE_NAMES.ENV_EXAMPLE);
+    const envPath = path_1.default.join(projectRoot, constants_1.FILE_NAMES.ENV);
+    await appendToEnvFile(envExamplePath, variables, options);
+    if ((await fs_extra_1.default.pathExists(envPath)) || options.force) {
+        await appendToEnvFile(envPath, variables, options);
     }
     logger_1.logger.success("Environment variables added");
 }
-async function appendToEnvFile(filePath, variables, fileType, options = {}) {
-    // Validate environment variable keys
+async function removeEnvVariables(projectRoot, keys) {
+    const envExamplePath = path_1.default.join(projectRoot, constants_1.FILE_NAMES.ENV_EXAMPLE);
+    const envPath = path_1.default.join(projectRoot, constants_1.FILE_NAMES.ENV);
+    await removeFromEnvFile(envExamplePath, keys);
+    if (await fs_extra_1.default.pathExists(envPath)) {
+        await removeFromEnvFile(envPath, keys);
+    }
+}
+function validateEnvVariables(variables) {
     for (const variable of variables) {
-        if (!/^[A-Z_][A-Z0-9_]*$/.test(variable.key)) {
-            throw new Error(`Invalid environment variable key: ${variable.key}`);
+        if (!constants_1.ENV_PATTERNS.KEY.test(variable.key)) {
+            throw new Error(`Invalid environment variable key: ${variable.key}. ` +
+                `Must match pattern: ${constants_1.ENV_PATTERNS.KEY}`);
         }
     }
+}
+async function appendToEnvFile(filePath, variables, options = {}) {
     let content = "";
     if (await fs_extra_1.default.pathExists(filePath)) {
         content = await fs_extra_1.default.readFile(filePath, "utf-8");
     }
-    // If force, remove existing keys first to avoid duplicates
     if (options.force) {
         const keysToRemove = variables.map((v) => v.key);
         await removeFromEnvFile(filePath, keysToRemove);
-        if (await fs_extra_1.default.pathExists(filePath)) {
-            content = await fs_extra_1.default.readFile(filePath, "utf-8");
-        }
-        else {
-            content = "";
-        }
-    }
-    // Check if variables already exist (after potential removal)
-    const existingKeys = new Set();
-    const lines = content.split("\n");
-    for (const line of lines) {
-        const match = line.match(/^([A-Z_][A-Z0-9_]*)=/);
-        if (match) {
-            existingKeys.add(match[1]);
-        }
+        content = (await fs_extra_1.default.pathExists(filePath)) ? await fs_extra_1.default.readFile(filePath, "utf-8") : "";
     }
+    const existingKeys = extractExistingKeys(content);
     const newVariables = variables.filter((v) => !existingKeys.has(v.key));
-    if (newVariables.length === 0) {
+    if (newVariables.length === 0)
         return;
-    }
-    // Ensure file ends with newline
     if (content && !content.endsWith("\n")) {
         content += "\n";
     }
-    // Append variables
     for (const variable of newVariables) {
-        const value = fileType === "example" ? variable.value || "" : variable.value || "";
-        content += `${variable.key}=${value}\n`;
+        content += `${variable.key}=${variable.value || ""}\n`;
     }
     await fs_extra_1.default.ensureDir(path_1.default.dirname(filePath));
     await fs_extra_1.default.writeFile(filePath, content, "utf-8");
 }
-async function removeEnvVariables(projectRoot, keys) {
-    const envExamplePath = path_1.default.join(projectRoot, ".env.example");
-    const envPath = path_1.default.join(projectRoot, ".env");
-    await removeFromEnvFile(envExamplePath, keys);
-    if (await fs_extra_1.default.pathExists(envPath)) {
-        await removeFromEnvFile(envPath, keys);
-    }
-}
 async function removeFromEnvFile(filePath, keys) {
-    if (!(await fs_extra_1.default.pathExists(filePath))) {
+    if (!(await fs_extra_1.default.pathExists(filePath)))
         return;
-    }
     try {
         const content = await fs_extra_1.default.readFile(filePath, "utf-8");
         const lines = content.split("\n");
         const newLines = [];
         for (const line of lines) {
             const match = line.match(/^([A-Z_][A-Z0-9_]*)=/);
-            if (match && keys.includes(match[1])) {
-                continue;
+            if (!match || !keys.includes(match[1])) {
+                newLines.push(line);
             }
-            newLines.push(line);
         }
         while (newLines.length > 0 && newLines[newLines.length - 1].trim() === "") {
             newLines.pop();
         }
-        await fs_extra_1.default.writeFile(filePath, newLines.join("\n"), "utf-8");
+        await fs_extra_1.default.writeFile(filePath, newLines.join("\n") + (newLines.length > 0 ? "\n" : ""), "utf-8");
     }
     catch (error) {
-        logger_1.logger.error(`Failed to remove env variables from ${filePath}: ${error}`);
+        logger_1.logger.error(`Failed to remove env variables from ${filePath}`);
         throw error;
     }
 }
+function extractExistingKeys(content) {
+    const existingKeys = new Set();
+    const lines = content.split("\n");
+    for (const line of lines) {
+        const match = line.match(/^([A-Z_][A-Z0-9_]*)=/);
+        if (match) {
+            existingKeys.add(match[1]);
+        }
+    }
+    return existingKeys;
+}

package/dist/lib/fs/files.d.ts

@@ -6,7 +6,6 @@ export interface PackageJsonConfig {
 export declare function copyBaseFramework(templatesDir: string, targetDir: string, framework: string): Promise<void>;
 export declare function mergePackageJson(targetDir: string, config: PackageJsonConfig): Promise<void>;
 export declare function mergeEnvFile(targetDir: string, envVars: Record<string, string>): Promise<void>;
-export declare function copyTemplate(templatePath: string, targetPath: string, projectName: string): Promise<void>;
 export declare function createFile(targetPath: string, content: string, options?: {
     force?: boolean;
 }): Promise<void>;

package/dist/lib/fs/files.js

@@ -6,12 +6,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.copyBaseFramework = copyBaseFramework;
 exports.mergePackageJson = mergePackageJson;
 exports.mergeEnvFile = mergeEnvFile;
-exports.copyTemplate = copyTemplate;
 exports.createFile = createFile;
 exports.readFile = readFile;
 exports.fileExists = fileExists;
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
+const constants_1 = require("../constants");
 const logger_1 = require("../ui/logger");
 async function copyBaseFramework(templatesDir, targetDir, framework) {
     const baseDir = path_1.default.join(templatesDir, framework);
@@ -19,17 +19,13 @@ async function copyBaseFramework(templatesDir, targetDir, framework) {
         throw new Error(`Base template not found for framework: ${framework}\n` + `Expected at: ${baseDir}`);
     }
     await fs_extra_1.default.copy(baseDir, targetDir, {
-        filter: (src) => {
-            const basename = path_1.default.basename(src);
-            return !["template.json", "config.json", "node_modules", ".git"].includes(basename);
-        },
+        filter: (src) => !constants_1.EXCLUDE_FROM_COPY.includes(path_1.default.basename(src)),
     });
 }
 async function mergePackageJson(targetDir, config) {
-    const pkgPath = path_1.default.join(targetDir, "package.json");
-    if (!(await fs_extra_1.default.pathExists(pkgPath))) {
+    const pkgPath = path_1.default.join(targetDir, constants_1.FILE_NAMES.PACKAGE_JSON);
+    if (!(await fs_extra_1.default.pathExists(pkgPath)))
         return;
-    }
     const pkg = await fs_extra_1.default.readJson(pkgPath);
     if (config.dependencies) {
         pkg.dependencies = { ...pkg.dependencies, ...config.dependencies };
@@ -43,46 +39,22 @@ async function mergePackageJson(targetDir, config) {
     await fs_extra_1.default.writeJson(pkgPath, pkg, { spaces: 2 });
 }
 async function mergeEnvFile(targetDir, envVars) {
-    const envPath = path_1.default.join(targetDir, ".env");
-    let existingEnv = "";
+    const envPath = path_1.default.join(targetDir, constants_1.FILE_NAMES.ENV);
+    let content = "";
     if (await fs_extra_1.default.pathExists(envPath)) {
-        existingEnv = await fs_extra_1.default.readFile(envPath, "utf-8");
+        content = await fs_extra_1.default.readFile(envPath, "utf-8");
     }
-    const envLines = existingEnv.split("\n").filter((line) => line.trim() !== "");
-    // Add new variables
+    const lines = content.split("\n").filter((line) => line.trim() !== "");
     for (const [key, value] of Object.entries(envVars)) {
-        const existingIndex = envLines.findIndex((line) => line.startsWith(`${key}=`));
+        const existingIndex = lines.findIndex((line) => line.startsWith(`${key}=`));
         if (existingIndex !== -1) {
-            envLines[existingIndex] = `${key}=${value}`;
+            lines[existingIndex] = `${key}=${value}`;
         }
         else {
-            envLines.push(`${key}=${value}`);
+            lines.push(`${key}=${value}`);
         }
     }
-    await fs_extra_1.default.writeFile(envPath, envLines.join("\n") + "\n", "utf-8");
-}
-async function copyTemplate(templatePath, targetPath, projectName) {
-    if (!(await fs_extra_1.default.pathExists(templatePath))) {
-        throw new Error(`Template not found: ${templatePath}`);
-    }
-    // Create target directory
-    await fs_extra_1.default.ensureDir(targetPath);
-    // Copy all files
-    await fs_extra_1.default.copy(templatePath, targetPath, {
-        filter: (src) => {
-            const basename = path_1.default.basename(src);
-            // Skip template.json metadata file and node_modules
-            return basename !== "template.json" && basename !== "node_modules";
-        },
-    });
-    // Update package.json with project name
-    const packageJsonPath = path_1.default.join(targetPath, "package.json");
-    if (await fs_extra_1.default.pathExists(packageJsonPath)) {
-        const packageJson = await fs_extra_1.default.readJSON(packageJsonPath);
-        packageJson.name = projectName;
-        await fs_extra_1.default.writeJSON(packageJsonPath, packageJson, { spaces: 2 });
-    }
-    logger_1.logger.success(`Template copied to ${targetPath}`);
+    await fs_extra_1.default.writeFile(envPath, lines.join("\n") + "\n", "utf-8");
 }
 async function createFile(targetPath, content, options = {}) {
     const exists = await fs_extra_1.default.pathExists(targetPath);

package/dist/lib/generation/code-generator.d.ts

@@ -4,6 +4,8 @@ export interface GenerationContext {
     database?: string;
     auth?: string;
     features?: string[];
+    combo?: string;
+    prismaProvider?: string;
     [key: string]: unknown;
 }
 export interface TemplateCondition {
@@ -31,7 +33,7 @@ export interface PatchOperation {
     type: "add-import" | "add-code" | "replace-code" | "add-to-top" | "add-to-bottom";
     condition?: TemplateCondition;
     imports?: string[];
-    code?: string;
+    code?: string | string[];
     after?: string;
     before?: string;
     replace?: string;
@@ -58,6 +60,7 @@ export declare class AdvancedCodeGenerator {
     loadGenerators(modulesPath: string): Promise<void>;
     private evaluateCondition;
     private processTemplate;
+    private renderHeadingFromExpr;
     private processVariableDefinitions;
     private processTemplateRecursive;
     generate(selectedModules: {