create-krispya 0.8.0 → 0.10.0

package/dist/index.cjs

@@ -1,23 +1,60 @@
 'use strict';
 
-const index = require('./chunks/index.cjs');
+const workspace = require('./shared/create-krispya.DTHeUlq4.cjs');
 require('fs/promises');
 require('fs');
 require('path');
 require('chalk');
 
+const emptyPlan = () => ({
+  files: {},
+  dependencies: {},
+  devDependencies: {},
+  peerDependencies: {},
+  scripts: {},
+  vscodeSettings: {},
+  vscodeExtensions: [],
+  injections: [],
+  replacements: [],
+  warnings: []
+});
+function mergePartialPlans(...plans) {
+  const merged = emptyPlan();
+  for (const plan of plans) {
+    if (plan == null) continue;
+    Object.assign(merged.files, plan.files);
+    Object.assign(merged.dependencies, plan.dependencies);
+    Object.assign(merged.devDependencies, plan.devDependencies);
+    Object.assign(merged.peerDependencies, plan.peerDependencies);
+    Object.assign(merged.scripts, plan.scripts);
+    Object.assign(merged.vscodeSettings, plan.vscodeSettings);
+    merged.vscodeExtensions.push(...plan.vscodeExtensions ?? []);
+    merged.injections.push(...plan.injections ?? []);
+    merged.replacements.push(...plan.replacements ?? []);
+    merged.warnings.push(...plan.warnings ?? []);
+  }
+  merged.vscodeExtensions = [...new Set(merged.vscodeExtensions)];
+  return merged;
+}
 
-
-exports.detectTooling = index.detectTooling;
-exports.generate = index.generate;
-exports.generateMonorepo = index.generateMonorepo;
-exports.generateRandomName = index.generateRandomName;
-exports.getBaseTemplate = index.getBaseTemplate;
-exports.getLanguageFromTemplate = index.getLanguageFromTemplate;
-exports.getLatestNodeVersion = index.getLatestNodeVersion;
-exports.getLatestNpmCliVersion = index.getLatestNpmCliVersion;
-exports.getLatestNpmVersion = index.getLatestNpmVersion;
-exports.getLatestPnpmVersion = index.getLatestPnpmVersion;
-exports.getLatestYarnVersion = index.getLatestYarnVersion;
-exports.parseWorkspaceYamlContent = index.parseWorkspaceYamlContent;
-exports.validatePackageName = index.validatePackageName;
+exports.detectTooling = workspace.detectTooling;
+exports.generateRandomName = workspace.generateRandomName;
+exports.getBaseTemplate = workspace.getBaseTemplate;
+exports.getLanguageFromTemplate = workspace.getLanguageFromTemplate;
+exports.getLatestNodeVersion = workspace.getLatestNodeVersion;
+exports.getLatestNpmCliVersion = workspace.getLatestNpmCliVersion;
+exports.getLatestNpmMajorVersion = workspace.getLatestNpmMajorVersion;
+exports.getLatestNpmVersion = workspace.getLatestNpmVersion;
+exports.getLatestPnpmVersion = workspace.getLatestPnpmVersion;
+exports.getLatestYarnVersion = workspace.getLatestYarnVersion;
+exports.merge = workspace.merge;
+exports.parseWorkspaceYamlContent = workspace.parseWorkspaceYamlContent;
+exports.planProject = workspace.planProject;
+exports.planWorkspace = workspace.planWorkspace;
+exports.projectPlanInputToOptions = workspace.projectPlanInputToOptions;
+exports.resolveProjectPlanInput = workspace.resolveProjectPlanInput;
+exports.resolveWorkspacePlanInput = workspace.resolveWorkspacePlanInput;
+exports.unique = workspace.unique;
+exports.validatePackageName = workspace.validatePackageName;
+exports.workspacePlanInputToMonorepoParams = workspace.workspacePlanInputToMonorepoParams;
+exports.mergePartialPlans = mergePartialPlans;

package/dist/index.d.cts

@@ -1,91 +1,36 @@
-type Template = 'vanilla' | 'vanilla-js' | 'react' | 'react-js' | 'r3f' | 'r3f-js';
-type BaseTemplate = 'vanilla' | 'react' | 'r3f';
-type ProjectType = 'app' | 'library' | 'monorepo';
-type LibraryBundler = 'unbuild' | 'tsdown';
-type PackageManagerName = 'pnpm' | 'npm' | 'yarn';
-type PackageManagerSpec = {
-    name: PackageManagerName;
-    version?: string;
-};
-type EngineName = string;
-type EngineSpec = {
-    name: EngineName;
-    version?: string;
-};
-type PackageVersions = Record<string, string>;
-type VersionRangePrefix = '^' | '~' | '';
-type DependencyVersionOptions = {
-    prefix?: VersionRangePrefix;
-    version?: string;
-};
-type File = {
-    type: 'text';
-    content: string;
-} | {
-    type: 'remote';
-    url: string;
+import { F as FormatterMetaConfig, L as LinterMetaConfig, V as VirtualFileMap, C as CodeInjectionLocation, P as ProjectType, a as ConfigStrategy, E as EngineSpec, b as PackageVersions, c as Linter, d as Formatter, T as Testing, e as LibraryBundler, I as Ide, f as PackageManagerSpec, g as ProjectPlanInput, h as ProjectOptions, A as AiPlatform, W as WorkspacePlanInput } from './shared/create-krispya.to8NBxeJ.cjs';
+export { i as AiAgentsMetaConfig, B as BaseTemplate, D as DependencyVersionOptions, j as EditorMetaConfig, k as EngineName, l as FeatureSelections, m as FileRenderer, n as LibraryBundlerMetaConfig, o as PackageManagerMetaConfig, p as PackageManagerName, q as PlanBuilder, r as PlanDreiOptions, s as PlanFiberOptions, t as PlanGithubPagesOptions, u as PlanHandleOptions, v as PlanKootaOptions, w as PlanLevaOptions, x as PlanOffscreenOptions, y as PlanPostprocessingOptions, z as PlanRapierOptions, G as PlanTriplexOptions, H as PlanUikitOptions, J as PlanViverseOptions, K as PlanXrOptions, M as PlanZustandOptions, N as ProjectMetaConfig, O as ProjectPlanContext, Q as Template, R as TestingMetaConfig, S as ToolConfig, U as TypeScriptMetaConfig, X as VersionRangePrefix, Y as VirtualFile, Z as WorkspacePlanContext, _ as getBaseTemplate, $ as getLanguageFromTemplate } from './shared/create-krispya.to8NBxeJ.cjs';
+
+type MetaConfig = {
+    formatter: FormatterMetaConfig;
+    linter: LinterMetaConfig;
 };
-type Linter = 'eslint' | 'oxlint' | 'biome';
-type Formatter = 'prettier' | 'oxfmt' | 'biome';
-type Testing = 'vitest' | 'none';
-type ConfigStrategy = 'stealth' | 'root';
-type CodeInjectionLocation = 'vite-config-import' | 'import' | 'global-start' | 'global-end' | 'dom-start' | 'dom' | 'dom-end' | 'scene-start' | 'scene' | 'scene-end' | 'readme-start' | 'readme-end' | 'readme-libraries' | 'readme-tools' | 'readme-commands' | 'vscode-extension-suggestion' | 'vscode-setting';
-type GenerateFiberOptions = {
-    /** @default true */
-    addExample?: boolean;
-} | boolean;
-type GenerateDreiOptions = {} | boolean;
-type GenerateHandleOptions = {} | boolean;
-type GenerateKootaOptions = {
-    /** @default true */
-    addExample?: boolean;
-} | boolean;
-type GenerateLevaOptions = {} | boolean;
-type GenerateOffscreenOptions = {} | boolean;
-type GeneratePostprocessingOptions = {} | boolean;
-type GenerateRapierOptions = {} | boolean;
-type GenerateTriplexOptions = {} | boolean;
-type GenerateUikitOptions = {} | boolean;
-type GenerateViverseOptions = {} | boolean;
-type GenerateXrOptions = {
-    storeOptions?: unknown;
-} | boolean;
-type GenerateZustandOptions = {
-    /** @default true */
-    addExample?: boolean;
-} | boolean;
-type GenerateGithubPagesOptions = {} | boolean;
-type AiPlatform = 'agents' | 'claude';
-type GenerateOptions = {
-    githubUserName?: string;
-    githubRepoName?: string;
-    name: string;
-    projectType?: ProjectType;
-    libraryBundler?: LibraryBundler;
-    template?: Template;
+type ToolSelections = {
     linter?: Linter;
     formatter?: Formatter;
     testing?: Testing;
+    libraryBundler?: LibraryBundler;
+    ide?: Ide;
+    packageManager?: PackageManagerSpec;
+};
+type ProjectContext = {
+    name: string;
+    projectType?: ProjectType;
     configStrategy?: ConfigStrategy;
-    /** AI platforms to generate pointer files for */
-    aiPlatforms?: AiPlatform[];
+    engine?: EngineSpec;
     versions?: PackageVersions;
-    fiber?: GenerateFiberOptions;
-    handle?: GenerateHandleOptions;
-    drei?: GenerateDreiOptions;
-    koota?: GenerateKootaOptions;
-    leva?: GenerateLevaOptions;
-    offscreen?: GenerateOffscreenOptions;
-    postprocessing?: GeneratePostprocessingOptions;
-    rapier?: GenerateRapierOptions;
-    triplex?: GenerateTriplexOptions;
-    viverse?: GenerateViverseOptions;
-    uikit?: GenerateUikitOptions;
-    xr?: GenerateXrOptions;
-    zustand?: GenerateZustandOptions;
-    githubPages?: GenerateGithubPagesOptions;
+    workspaceRoot?: string;
+    workspaceDependencies?: string[];
+    pnpmManageVersions?: boolean;
+};
+type PartialPlan = {
+    files?: VirtualFileMap;
     dependencies?: Record<string, string>;
-    files?: Record<string, File>;
+    devDependencies?: Record<string, string>;
+    peerDependencies?: Record<string, string>;
+    scripts?: Record<string, string>;
+    vscodeSettings?: Record<string, unknown>;
+    vscodeExtensions?: string[];
     injections?: Array<{
         location: CodeInjectionLocation;
         code: string;
@@ -94,91 +39,33 @@ type GenerateOptions = {
         search: string;
         replace: string;
     }>;
-    packageManager?: PackageManagerSpec;
-    pnpmManageVersions?: boolean;
-    engine?: EngineSpec;
-    workspaceRoot?: string;
-    workspaceDependencies?: string[];
+    warnings?: string[];
 };
-type Generator = {
-    get options(): GenerateOptions;
-    get versions(): PackageVersions;
-    getVersion(name: string): string;
-    /** Returns true if using stealth config strategy (configs in .config/) */
-    isStealthConfig(): boolean;
-    addDependency(name: string, options?: DependencyVersionOptions): void;
-    addDevDependency(name: string, options?: DependencyVersionOptions): void;
-    addPeerDependency(name: string, semver: string): void;
-    addFile(path: string, file: File): void;
-    addScript(name: string, command: string): void;
-    inject(location: CodeInjectionLocation, code: string): void;
-    replace(search: string, replace: string): void;
-    configureVite(object: unknown): void;
-    addVscodeSetting(key: string, value: unknown): void;
+type ProjectPlan = {
+    files: VirtualFileMap;
+    dependencies: Record<string, string>;
+    devDependencies: Record<string, string>;
+    peerDependencies: Record<string, string>;
+    scripts: Record<string, string>;
+    vscodeSettings: Record<string, unknown>;
+    vscodeExtensions: string[];
+    injections: Array<{
+        location: CodeInjectionLocation;
+        code: string;
+    }>;
+    replacements: Array<{
+        search: string;
+        replace: string;
+    }>;
+    warnings: string[];
 };
-declare function getLanguageFromTemplate(template: Template): 'javascript' | 'typescript';
-declare function getBaseTemplate(template: Template): BaseTemplate;
 
-/**
- * Fetches the latest version of an npm package from the registry
- * @param packageName The name of the npm package
- * @param fallback Fallback version if fetch fails
- * @returns The latest version string (e.g., "1.0.0")
- */
-declare function getLatestNpmVersion(packageName: string, fallback: string): Promise<string>;
-/**
- * Fetches the latest version of pnpm from the npm registry
- * @returns The latest pnpm version string (e.g., "10.24.0")
- */
-declare function getLatestPnpmVersion(): Promise<string>;
-/**
- * Fetches the latest version of yarn from the npm registry
- * @returns The latest yarn version string (e.g., "4.6.0")
- */
-declare function getLatestYarnVersion(): Promise<string>;
-/**
- * Fetches the latest version of npm from the npm registry
- * @returns The latest npm version string (e.g., "11.0.0")
- */
-declare function getLatestNpmCliVersion(): Promise<string>;
-/**
- * Fetches the latest stable version of Node.js
- * @returns The latest Node.js version string (e.g., "25.1.0")
- */
-declare function getLatestNodeVersion(): Promise<string>;
-/**
- * Validates a package name for use in a monorepo workspace.
- * Returns an error message if invalid, undefined if valid.
- *
- * Rules:
- * - Supports scoped names (@scope/name) or unscoped names
- * - Must be lowercase
- * - Only alphanumeric characters and hyphens allowed in each segment
- * - Cannot start or end with a hyphen
- * - Cannot contain path traversal sequences
- * - Cannot be empty
- */
-declare function validatePackageName(name: string): string | undefined;
-/**
- * Parses pnpm-workspace.yaml content to extract workspace directory names.
- * Filters out hidden directories (starting with .).
- */
-declare function parseWorkspaceYamlContent(content: string): string[];
+declare function mergePartialPlans(...plans: Array<PartialPlan | undefined>): ProjectPlan;
 
-type DetectedTooling = {
-    linter: Linter | undefined;
-    formatter: Formatter | undefined;
-};
 /**
- * Detects linter and formatter from a monorepo root.
- * Priority: scripts → .config/ directories → devDependencies
- */
-declare function detectTooling(root: string): Promise<DetectedTooling>;
-/**
- * Generates a random name in the format "adjective-noun"
- * @returns A randomly generated name string
+ * Main generation function that creates all project files.
  */
-declare function generateRandomName(): string;
+declare function planProject(input: ProjectPlanInput | ProjectOptions): Promise<ProjectPlan>;
 
 /**
  * Parameters for generating a monorepo workspace.
@@ -197,24 +84,46 @@ type MonorepoParams = {
     pnpmManageVersions?: boolean;
     engine?: EngineSpec;
     versions?: PackageVersions;
+    ide?: Ide;
     /** AI platforms to generate files for */
     aiPlatforms?: AiPlatform[];
 };
-type MonorepoResult = {
-    files: Record<string, File>;
+
+declare function planWorkspace(input: MonorepoParams | WorkspacePlanInput): Promise<ProjectPlan>;
+
+declare function resolveProjectPlanInput(options: ProjectOptions): ProjectPlanInput;
+declare function projectPlanInputToOptions(input: ProjectPlanInput): ProjectOptions;
+declare function resolveWorkspacePlanInput(params: MonorepoParams): WorkspacePlanInput;
+declare function workspacePlanInputToMonorepoParams(input: WorkspacePlanInput): MonorepoParams;
+
+declare function unique<T>(...array: T[][]): T[];
+
+declare function merge(target: any, modification: any): any;
+
+declare function validatePackageName(name: string): string | undefined;
+
+declare function generateRandomName(): string;
+
+type DetectedTooling = {
+    linter: Linter | undefined;
+    formatter: Formatter | undefined;
 };
+declare function detectTooling(root: string): Promise<DetectedTooling>;
+
 /**
- * Generates a monorepo workspace root structure with shared config packages.
- *
- * Note: Monorepos are currently pnpm-only. Detection relies on pnpm-workspace.yaml.
- * TODO: Support yarn and npm workspaces in the future.
+ * Fetches the latest version of an npm package from the registry.
  */
-declare function generateMonorepo(params: MonorepoParams): MonorepoResult;
-
+declare function getLatestNpmVersion(packageName: string, fallback: string): Promise<string>;
 /**
- * Main generation function that creates all project files.
+ * Fetches the latest npm version within a specific major version.
  */
-declare function generate(options: GenerateOptions): Record<string, File>;
+declare function getLatestNpmMajorVersion(packageName: string, majorVersion: string, fallback: string): Promise<string>;
+declare function getLatestPnpmVersion(): Promise<string>;
+declare function getLatestYarnVersion(): Promise<string>;
+declare function getLatestNpmCliVersion(): Promise<string>;
+declare function getLatestNodeVersion(): Promise<string>;
+
+declare function parseWorkspaceYamlContent(content: string): string[];
 
-export { detectTooling, generate, generateMonorepo, generateRandomName, getBaseTemplate, getLanguageFromTemplate, getLatestNodeVersion, getLatestNpmCliVersion, getLatestNpmVersion, getLatestPnpmVersion, getLatestYarnVersion, parseWorkspaceYamlContent, validatePackageName };
-export type { AiPlatform, BaseTemplate, CodeInjectionLocation, ConfigStrategy, DependencyVersionOptions, DetectedTooling, EngineName, EngineSpec, File, Formatter, GenerateDreiOptions, GenerateFiberOptions, GenerateGithubPagesOptions, GenerateHandleOptions, GenerateKootaOptions, GenerateLevaOptions, GenerateOffscreenOptions, GenerateOptions, GeneratePostprocessingOptions, GenerateRapierOptions, GenerateTriplexOptions, GenerateUikitOptions, GenerateViverseOptions, GenerateXrOptions, GenerateZustandOptions, Generator, LibraryBundler, Linter, PackageManagerName, PackageManagerSpec, PackageVersions, ProjectType, Template, Testing, VersionRangePrefix };
+export { AiPlatform, CodeInjectionLocation, ConfigStrategy, EngineSpec, Formatter, FormatterMetaConfig, Ide, LibraryBundler, Linter, LinterMetaConfig, PackageManagerSpec, PackageVersions, ProjectOptions, ProjectPlanInput, ProjectType, Testing, VirtualFileMap, WorkspacePlanInput, detectTooling, generateRandomName, getLatestNodeVersion, getLatestNpmCliVersion, getLatestNpmMajorVersion, getLatestNpmVersion, getLatestPnpmVersion, getLatestYarnVersion, merge, mergePartialPlans, parseWorkspaceYamlContent, planProject, planWorkspace, projectPlanInputToOptions, resolveProjectPlanInput, resolveWorkspacePlanInput, unique, validatePackageName, workspacePlanInputToMonorepoParams };
+export type { DetectedTooling, MetaConfig, PartialPlan, ProjectContext, ProjectPlan, ToolSelections };

package/dist/index.d.mts

@@ -1,91 +1,36 @@
-type Template = 'vanilla' | 'vanilla-js' | 'react' | 'react-js' | 'r3f' | 'r3f-js';
-type BaseTemplate = 'vanilla' | 'react' | 'r3f';
-type ProjectType = 'app' | 'library' | 'monorepo';
-type LibraryBundler = 'unbuild' | 'tsdown';
-type PackageManagerName = 'pnpm' | 'npm' | 'yarn';
-type PackageManagerSpec = {
-    name: PackageManagerName;
-    version?: string;
-};
-type EngineName = string;
-type EngineSpec = {
-    name: EngineName;
-    version?: string;
-};
-type PackageVersions = Record<string, string>;
-type VersionRangePrefix = '^' | '~' | '';
-type DependencyVersionOptions = {
-    prefix?: VersionRangePrefix;
-    version?: string;
-};
-type File = {
-    type: 'text';
-    content: string;
-} | {
-    type: 'remote';
-    url: string;
+import { F as FormatterMetaConfig, L as LinterMetaConfig, V as VirtualFileMap, C as CodeInjectionLocation, P as ProjectType, a as ConfigStrategy, E as EngineSpec, b as PackageVersions, c as Linter, d as Formatter, T as Testing, e as LibraryBundler, I as Ide, f as PackageManagerSpec, g as ProjectPlanInput, h as ProjectOptions, A as AiPlatform, W as WorkspacePlanInput } from './shared/create-krispya.to8NBxeJ.mjs';
+export { i as AiAgentsMetaConfig, B as BaseTemplate, D as DependencyVersionOptions, j as EditorMetaConfig, k as EngineName, l as FeatureSelections, m as FileRenderer, n as LibraryBundlerMetaConfig, o as PackageManagerMetaConfig, p as PackageManagerName, q as PlanBuilder, r as PlanDreiOptions, s as PlanFiberOptions, t as PlanGithubPagesOptions, u as PlanHandleOptions, v as PlanKootaOptions, w as PlanLevaOptions, x as PlanOffscreenOptions, y as PlanPostprocessingOptions, z as PlanRapierOptions, G as PlanTriplexOptions, H as PlanUikitOptions, J as PlanViverseOptions, K as PlanXrOptions, M as PlanZustandOptions, N as ProjectMetaConfig, O as ProjectPlanContext, Q as Template, R as TestingMetaConfig, S as ToolConfig, U as TypeScriptMetaConfig, X as VersionRangePrefix, Y as VirtualFile, Z as WorkspacePlanContext, _ as getBaseTemplate, $ as getLanguageFromTemplate } from './shared/create-krispya.to8NBxeJ.mjs';
+
+type MetaConfig = {
+    formatter: FormatterMetaConfig;
+    linter: LinterMetaConfig;
 };
-type Linter = 'eslint' | 'oxlint' | 'biome';
-type Formatter = 'prettier' | 'oxfmt' | 'biome';
-type Testing = 'vitest' | 'none';
-type ConfigStrategy = 'stealth' | 'root';
-type CodeInjectionLocation = 'vite-config-import' | 'import' | 'global-start' | 'global-end' | 'dom-start' | 'dom' | 'dom-end' | 'scene-start' | 'scene' | 'scene-end' | 'readme-start' | 'readme-end' | 'readme-libraries' | 'readme-tools' | 'readme-commands' | 'vscode-extension-suggestion' | 'vscode-setting';
-type GenerateFiberOptions = {
-    /** @default true */
-    addExample?: boolean;
-} | boolean;
-type GenerateDreiOptions = {} | boolean;
-type GenerateHandleOptions = {} | boolean;
-type GenerateKootaOptions = {
-    /** @default true */
-    addExample?: boolean;
-} | boolean;
-type GenerateLevaOptions = {} | boolean;
-type GenerateOffscreenOptions = {} | boolean;
-type GeneratePostprocessingOptions = {} | boolean;
-type GenerateRapierOptions = {} | boolean;
-type GenerateTriplexOptions = {} | boolean;
-type GenerateUikitOptions = {} | boolean;
-type GenerateViverseOptions = {} | boolean;
-type GenerateXrOptions = {
-    storeOptions?: unknown;
-} | boolean;
-type GenerateZustandOptions = {
-    /** @default true */
-    addExample?: boolean;
-} | boolean;
-type GenerateGithubPagesOptions = {} | boolean;
-type AiPlatform = 'agents' | 'claude';
-type GenerateOptions = {
-    githubUserName?: string;
-    githubRepoName?: string;
-    name: string;
-    projectType?: ProjectType;
-    libraryBundler?: LibraryBundler;
-    template?: Template;
+type ToolSelections = {
     linter?: Linter;
     formatter?: Formatter;
     testing?: Testing;
+    libraryBundler?: LibraryBundler;
+    ide?: Ide;
+    packageManager?: PackageManagerSpec;
+};
+type ProjectContext = {
+    name: string;
+    projectType?: ProjectType;
     configStrategy?: ConfigStrategy;
-    /** AI platforms to generate pointer files for */
-    aiPlatforms?: AiPlatform[];
+    engine?: EngineSpec;
     versions?: PackageVersions;
-    fiber?: GenerateFiberOptions;
-    handle?: GenerateHandleOptions;
-    drei?: GenerateDreiOptions;
-    koota?: GenerateKootaOptions;
-    leva?: GenerateLevaOptions;
-    offscreen?: GenerateOffscreenOptions;
-    postprocessing?: GeneratePostprocessingOptions;
-    rapier?: GenerateRapierOptions;
-    triplex?: GenerateTriplexOptions;
-    viverse?: GenerateViverseOptions;
-    uikit?: GenerateUikitOptions;
-    xr?: GenerateXrOptions;
-    zustand?: GenerateZustandOptions;
-    githubPages?: GenerateGithubPagesOptions;
+    workspaceRoot?: string;
+    workspaceDependencies?: string[];
+    pnpmManageVersions?: boolean;
+};
+type PartialPlan = {
+    files?: VirtualFileMap;
     dependencies?: Record<string, string>;
-    files?: Record<string, File>;
+    devDependencies?: Record<string, string>;
+    peerDependencies?: Record<string, string>;
+    scripts?: Record<string, string>;
+    vscodeSettings?: Record<string, unknown>;
+    vscodeExtensions?: string[];
     injections?: Array<{
         location: CodeInjectionLocation;
         code: string;
@@ -94,91 +39,33 @@ type GenerateOptions = {
         search: string;
         replace: string;
     }>;
-    packageManager?: PackageManagerSpec;
-    pnpmManageVersions?: boolean;
-    engine?: EngineSpec;
-    workspaceRoot?: string;
-    workspaceDependencies?: string[];
+    warnings?: string[];
 };
-type Generator = {
-    get options(): GenerateOptions;
-    get versions(): PackageVersions;
-    getVersion(name: string): string;
-    /** Returns true if using stealth config strategy (configs in .config/) */
-    isStealthConfig(): boolean;
-    addDependency(name: string, options?: DependencyVersionOptions): void;
-    addDevDependency(name: string, options?: DependencyVersionOptions): void;
-    addPeerDependency(name: string, semver: string): void;
-    addFile(path: string, file: File): void;
-    addScript(name: string, command: string): void;
-    inject(location: CodeInjectionLocation, code: string): void;
-    replace(search: string, replace: string): void;
-    configureVite(object: unknown): void;
-    addVscodeSetting(key: string, value: unknown): void;
+type ProjectPlan = {
+    files: VirtualFileMap;
+    dependencies: Record<string, string>;
+    devDependencies: Record<string, string>;
+    peerDependencies: Record<string, string>;
+    scripts: Record<string, string>;
+    vscodeSettings: Record<string, unknown>;
+    vscodeExtensions: string[];
+    injections: Array<{
+        location: CodeInjectionLocation;
+        code: string;
+    }>;
+    replacements: Array<{
+        search: string;
+        replace: string;
+    }>;
+    warnings: string[];
 };
-declare function getLanguageFromTemplate(template: Template): 'javascript' | 'typescript';
-declare function getBaseTemplate(template: Template): BaseTemplate;
 
-/**
- * Fetches the latest version of an npm package from the registry
- * @param packageName The name of the npm package
- * @param fallback Fallback version if fetch fails
- * @returns The latest version string (e.g., "1.0.0")
- */
-declare function getLatestNpmVersion(packageName: string, fallback: string): Promise<string>;
-/**
- * Fetches the latest version of pnpm from the npm registry
- * @returns The latest pnpm version string (e.g., "10.24.0")
- */
-declare function getLatestPnpmVersion(): Promise<string>;
-/**
- * Fetches the latest version of yarn from the npm registry
- * @returns The latest yarn version string (e.g., "4.6.0")
- */
-declare function getLatestYarnVersion(): Promise<string>;
-/**
- * Fetches the latest version of npm from the npm registry
- * @returns The latest npm version string (e.g., "11.0.0")
- */
-declare function getLatestNpmCliVersion(): Promise<string>;
-/**
- * Fetches the latest stable version of Node.js
- * @returns The latest Node.js version string (e.g., "25.1.0")
- */
-declare function getLatestNodeVersion(): Promise<string>;
-/**
- * Validates a package name for use in a monorepo workspace.
- * Returns an error message if invalid, undefined if valid.
- *
- * Rules:
- * - Supports scoped names (@scope/name) or unscoped names
- * - Must be lowercase
- * - Only alphanumeric characters and hyphens allowed in each segment
- * - Cannot start or end with a hyphen
- * - Cannot contain path traversal sequences
- * - Cannot be empty
- */
-declare function validatePackageName(name: string): string | undefined;
-/**
- * Parses pnpm-workspace.yaml content to extract workspace directory names.
- * Filters out hidden directories (starting with .).
- */
-declare function parseWorkspaceYamlContent(content: string): string[];
+declare function mergePartialPlans(...plans: Array<PartialPlan | undefined>): ProjectPlan;
 
-type DetectedTooling = {
-    linter: Linter | undefined;
-    formatter: Formatter | undefined;
-};
 /**
- * Detects linter and formatter from a monorepo root.
- * Priority: scripts → .config/ directories → devDependencies
- */
-declare function detectTooling(root: string): Promise<DetectedTooling>;
-/**
- * Generates a random name in the format "adjective-noun"
- * @returns A randomly generated name string
+ * Main generation function that creates all project files.
  */
-declare function generateRandomName(): string;
+declare function planProject(input: ProjectPlanInput | ProjectOptions): Promise<ProjectPlan>;
 
 /**
  * Parameters for generating a monorepo workspace.
@@ -197,24 +84,46 @@ type MonorepoParams = {
     pnpmManageVersions?: boolean;
     engine?: EngineSpec;
     versions?: PackageVersions;
+    ide?: Ide;
     /** AI platforms to generate files for */
     aiPlatforms?: AiPlatform[];
 };
-type MonorepoResult = {
-    files: Record<string, File>;
+
+declare function planWorkspace(input: MonorepoParams | WorkspacePlanInput): Promise<ProjectPlan>;
+
+declare function resolveProjectPlanInput(options: ProjectOptions): ProjectPlanInput;
+declare function projectPlanInputToOptions(input: ProjectPlanInput): ProjectOptions;
+declare function resolveWorkspacePlanInput(params: MonorepoParams): WorkspacePlanInput;
+declare function workspacePlanInputToMonorepoParams(input: WorkspacePlanInput): MonorepoParams;
+
+declare function unique<T>(...array: T[][]): T[];
+
+declare function merge(target: any, modification: any): any;
+
+declare function validatePackageName(name: string): string | undefined;
+
+declare function generateRandomName(): string;
+
+type DetectedTooling = {
+    linter: Linter | undefined;
+    formatter: Formatter | undefined;
 };
+declare function detectTooling(root: string): Promise<DetectedTooling>;
+
 /**
- * Generates a monorepo workspace root structure with shared config packages.
- *
- * Note: Monorepos are currently pnpm-only. Detection relies on pnpm-workspace.yaml.
- * TODO: Support yarn and npm workspaces in the future.
+ * Fetches the latest version of an npm package from the registry.
  */
-declare function generateMonorepo(params: MonorepoParams): MonorepoResult;
-
+declare function getLatestNpmVersion(packageName: string, fallback: string): Promise<string>;
 /**
- * Main generation function that creates all project files.
+ * Fetches the latest npm version within a specific major version.
  */
-declare function generate(options: GenerateOptions): Record<string, File>;
+declare function getLatestNpmMajorVersion(packageName: string, majorVersion: string, fallback: string): Promise<string>;
+declare function getLatestPnpmVersion(): Promise<string>;
+declare function getLatestYarnVersion(): Promise<string>;
+declare function getLatestNpmCliVersion(): Promise<string>;
+declare function getLatestNodeVersion(): Promise<string>;
+
+declare function parseWorkspaceYamlContent(content: string): string[];
 
-export { detectTooling, generate, generateMonorepo, generateRandomName, getBaseTemplate, getLanguageFromTemplate, getLatestNodeVersion, getLatestNpmCliVersion, getLatestNpmVersion, getLatestPnpmVersion, getLatestYarnVersion, parseWorkspaceYamlContent, validatePackageName };
-export type { AiPlatform, BaseTemplate, CodeInjectionLocation, ConfigStrategy, DependencyVersionOptions, DetectedTooling, EngineName, EngineSpec, File, Formatter, GenerateDreiOptions, GenerateFiberOptions, GenerateGithubPagesOptions, GenerateHandleOptions, GenerateKootaOptions, GenerateLevaOptions, GenerateOffscreenOptions, GenerateOptions, GeneratePostprocessingOptions, GenerateRapierOptions, GenerateTriplexOptions, GenerateUikitOptions, GenerateViverseOptions, GenerateXrOptions, GenerateZustandOptions, Generator, LibraryBundler, Linter, PackageManagerName, PackageManagerSpec, PackageVersions, ProjectType, Template, Testing, VersionRangePrefix };
+export { AiPlatform, CodeInjectionLocation, ConfigStrategy, EngineSpec, Formatter, FormatterMetaConfig, Ide, LibraryBundler, Linter, LinterMetaConfig, PackageManagerSpec, PackageVersions, ProjectOptions, ProjectPlanInput, ProjectType, Testing, VirtualFileMap, WorkspacePlanInput, detectTooling, generateRandomName, getLatestNodeVersion, getLatestNpmCliVersion, getLatestNpmMajorVersion, getLatestNpmVersion, getLatestPnpmVersion, getLatestYarnVersion, merge, mergePartialPlans, parseWorkspaceYamlContent, planProject, planWorkspace, projectPlanInputToOptions, resolveProjectPlanInput, resolveWorkspacePlanInput, unique, validatePackageName, workspacePlanInputToMonorepoParams };
+export type { DetectedTooling, MetaConfig, PartialPlan, ProjectContext, ProjectPlan, ToolSelections };