create-krispya 0.7.0 → 0.9.0

package/dist/index.d.cts

@@ -1,28 +1,35 @@
-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 PackageVersions = {
-    vite?: string;
-    vitest?: string;
-    eslint?: string;
-    oxlint?: string;
-    oxfmt?: string;
-    prettier?: string;
-    biome?: string;
+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";
+    type: 'text';
     content: string;
 } | {
-    type: "remote";
+    type: 'remote';
     url: string;
 };
-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 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;
@@ -48,7 +55,7 @@ type GenerateZustandOptions = {
     addExample?: boolean;
 } | boolean;
 type GenerateGithubPagesOptions = {} | boolean;
-type AiPlatform = "agents" | "claude";
+type AiPlatform = 'agents' | 'claude';
 type GenerateOptions = {
     githubUserName?: string;
     githubRepoName?: string;
@@ -87,22 +94,21 @@ type GenerateOptions = {
         search: string;
         replace: string;
     }>;
-    packageManager?: string;
-    pnpmVersion?: string;
+    packageManager?: PackageManagerSpec;
     pnpmManageVersions?: boolean;
-    yarnVersion?: string;
-    npmVersion?: string;
-    nodeVersion?: string;
+    engine?: EngineSpec;
     workspaceRoot?: string;
     workspaceDependencies?: 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, semver: string): void;
-    addDevDependency(name: string, semver: string): void;
+    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;
@@ -110,7 +116,7 @@ type Generator = {
     configureVite(object: unknown): void;
     addVscodeSetting(key: string, value: unknown): void;
 };
-declare function getLanguageFromTemplate(template: Template): "javascript" | "typescript";
+declare function getLanguageFromTemplate(template: Template): 'javascript' | 'typescript';
 declare function getBaseTemplate(template: Template): BaseTemplate;
 
 /**
@@ -120,6 +126,14 @@ declare function getBaseTemplate(template: Template): BaseTemplate;
  * @returns The latest version string (e.g., "1.0.0")
  */
 declare function getLatestNpmVersion(packageName: string, fallback: string): Promise<string>;
+/**
+ * Fetches the latest npm version within a specific major version.
+ * @param packageName The name of the npm package
+ * @param majorVersion The required major version
+ * @param fallback Fallback version if fetch fails or no match exists
+ * @returns The latest matching version string (e.g., "25.3.5")
+ */
+declare function getLatestNpmMajorVersion(packageName: string, majorVersion: 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")
@@ -187,10 +201,10 @@ type MonorepoParams = {
     linter: Linter;
     formatter: Formatter;
     /** Currently always "pnpm" - monorepos are pnpm-only */
-    packageManager: string;
-    pnpmVersion?: string;
+    packageManager: PackageManagerSpec;
     pnpmManageVersions?: boolean;
-    nodeVersion?: string;
+    engine?: EngineSpec;
+    versions?: PackageVersions;
     /** AI platforms to generate files for */
     aiPlatforms?: AiPlatform[];
 };
@@ -210,5 +224,5 @@ declare function generateMonorepo(params: MonorepoParams): MonorepoResult;
  */
 declare function generate(options: GenerateOptions): Record<string, File>;
 
-export { detectTooling, generate, generateMonorepo, generateRandomName, getBaseTemplate, getLanguageFromTemplate, getLatestNodeVersion, getLatestNpmCliVersion, getLatestNpmVersion, getLatestPnpmVersion, getLatestYarnVersion, parseWorkspaceYamlContent, validatePackageName };
-export type { AiPlatform, BaseTemplate, CodeInjectionLocation, ConfigStrategy, DetectedTooling, File, Formatter, GenerateDreiOptions, GenerateFiberOptions, GenerateGithubPagesOptions, GenerateHandleOptions, GenerateKootaOptions, GenerateLevaOptions, GenerateOffscreenOptions, GenerateOptions, GeneratePostprocessingOptions, GenerateRapierOptions, GenerateTriplexOptions, GenerateUikitOptions, GenerateViverseOptions, GenerateXrOptions, GenerateZustandOptions, Generator, LibraryBundler, Linter, PackageVersions, ProjectType, Template, Testing };
+export { detectTooling, generate, generateMonorepo, generateRandomName, getBaseTemplate, getLanguageFromTemplate, getLatestNodeVersion, getLatestNpmCliVersion, getLatestNpmMajorVersion, 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 };

package/dist/index.d.mts

@@ -1,28 +1,35 @@
-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 PackageVersions = {
-    vite?: string;
-    vitest?: string;
-    eslint?: string;
-    oxlint?: string;
-    oxfmt?: string;
-    prettier?: string;
-    biome?: string;
+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";
+    type: 'text';
     content: string;
 } | {
-    type: "remote";
+    type: 'remote';
     url: string;
 };
-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 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;
@@ -48,7 +55,7 @@ type GenerateZustandOptions = {
     addExample?: boolean;
 } | boolean;
 type GenerateGithubPagesOptions = {} | boolean;
-type AiPlatform = "agents" | "claude";
+type AiPlatform = 'agents' | 'claude';
 type GenerateOptions = {
     githubUserName?: string;
     githubRepoName?: string;
@@ -87,22 +94,21 @@ type GenerateOptions = {
         search: string;
         replace: string;
     }>;
-    packageManager?: string;
-    pnpmVersion?: string;
+    packageManager?: PackageManagerSpec;
     pnpmManageVersions?: boolean;
-    yarnVersion?: string;
-    npmVersion?: string;
-    nodeVersion?: string;
+    engine?: EngineSpec;
     workspaceRoot?: string;
     workspaceDependencies?: 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, semver: string): void;
-    addDevDependency(name: string, semver: string): void;
+    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;
@@ -110,7 +116,7 @@ type Generator = {
     configureVite(object: unknown): void;
     addVscodeSetting(key: string, value: unknown): void;
 };
-declare function getLanguageFromTemplate(template: Template): "javascript" | "typescript";
+declare function getLanguageFromTemplate(template: Template): 'javascript' | 'typescript';
 declare function getBaseTemplate(template: Template): BaseTemplate;
 
 /**
@@ -120,6 +126,14 @@ declare function getBaseTemplate(template: Template): BaseTemplate;
  * @returns The latest version string (e.g., "1.0.0")
  */
 declare function getLatestNpmVersion(packageName: string, fallback: string): Promise<string>;
+/**
+ * Fetches the latest npm version within a specific major version.
+ * @param packageName The name of the npm package
+ * @param majorVersion The required major version
+ * @param fallback Fallback version if fetch fails or no match exists
+ * @returns The latest matching version string (e.g., "25.3.5")
+ */
+declare function getLatestNpmMajorVersion(packageName: string, majorVersion: 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")
@@ -187,10 +201,10 @@ type MonorepoParams = {
     linter: Linter;
     formatter: Formatter;
     /** Currently always "pnpm" - monorepos are pnpm-only */
-    packageManager: string;
-    pnpmVersion?: string;
+    packageManager: PackageManagerSpec;
     pnpmManageVersions?: boolean;
-    nodeVersion?: string;
+    engine?: EngineSpec;
+    versions?: PackageVersions;
     /** AI platforms to generate files for */
     aiPlatforms?: AiPlatform[];
 };
@@ -210,5 +224,5 @@ declare function generateMonorepo(params: MonorepoParams): MonorepoResult;
  */
 declare function generate(options: GenerateOptions): Record<string, File>;
 
-export { detectTooling, generate, generateMonorepo, generateRandomName, getBaseTemplate, getLanguageFromTemplate, getLatestNodeVersion, getLatestNpmCliVersion, getLatestNpmVersion, getLatestPnpmVersion, getLatestYarnVersion, parseWorkspaceYamlContent, validatePackageName };
-export type { AiPlatform, BaseTemplate, CodeInjectionLocation, ConfigStrategy, DetectedTooling, File, Formatter, GenerateDreiOptions, GenerateFiberOptions, GenerateGithubPagesOptions, GenerateHandleOptions, GenerateKootaOptions, GenerateLevaOptions, GenerateOffscreenOptions, GenerateOptions, GeneratePostprocessingOptions, GenerateRapierOptions, GenerateTriplexOptions, GenerateUikitOptions, GenerateViverseOptions, GenerateXrOptions, GenerateZustandOptions, Generator, LibraryBundler, Linter, PackageVersions, ProjectType, Template, Testing };
+export { detectTooling, generate, generateMonorepo, generateRandomName, getBaseTemplate, getLanguageFromTemplate, getLatestNodeVersion, getLatestNpmCliVersion, getLatestNpmMajorVersion, 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 };

package/dist/index.d.ts

@@ -1,28 +1,35 @@
-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 PackageVersions = {
-    vite?: string;
-    vitest?: string;
-    eslint?: string;
-    oxlint?: string;
-    oxfmt?: string;
-    prettier?: string;
-    biome?: string;
+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";
+    type: 'text';
     content: string;
 } | {
-    type: "remote";
+    type: 'remote';
     url: string;
 };
-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 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;
@@ -48,7 +55,7 @@ type GenerateZustandOptions = {
     addExample?: boolean;
 } | boolean;
 type GenerateGithubPagesOptions = {} | boolean;
-type AiPlatform = "agents" | "claude";
+type AiPlatform = 'agents' | 'claude';
 type GenerateOptions = {
     githubUserName?: string;
     githubRepoName?: string;
@@ -87,22 +94,21 @@ type GenerateOptions = {
         search: string;
         replace: string;
     }>;
-    packageManager?: string;
-    pnpmVersion?: string;
+    packageManager?: PackageManagerSpec;
     pnpmManageVersions?: boolean;
-    yarnVersion?: string;
-    npmVersion?: string;
-    nodeVersion?: string;
+    engine?: EngineSpec;
     workspaceRoot?: string;
     workspaceDependencies?: 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, semver: string): void;
-    addDevDependency(name: string, semver: string): void;
+    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;
@@ -110,7 +116,7 @@ type Generator = {
     configureVite(object: unknown): void;
     addVscodeSetting(key: string, value: unknown): void;
 };
-declare function getLanguageFromTemplate(template: Template): "javascript" | "typescript";
+declare function getLanguageFromTemplate(template: Template): 'javascript' | 'typescript';
 declare function getBaseTemplate(template: Template): BaseTemplate;
 
 /**
@@ -120,6 +126,14 @@ declare function getBaseTemplate(template: Template): BaseTemplate;
  * @returns The latest version string (e.g., "1.0.0")
  */
 declare function getLatestNpmVersion(packageName: string, fallback: string): Promise<string>;
+/**
+ * Fetches the latest npm version within a specific major version.
+ * @param packageName The name of the npm package
+ * @param majorVersion The required major version
+ * @param fallback Fallback version if fetch fails or no match exists
+ * @returns The latest matching version string (e.g., "25.3.5")
+ */
+declare function getLatestNpmMajorVersion(packageName: string, majorVersion: 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")
@@ -187,10 +201,10 @@ type MonorepoParams = {
     linter: Linter;
     formatter: Formatter;
     /** Currently always "pnpm" - monorepos are pnpm-only */
-    packageManager: string;
-    pnpmVersion?: string;
+    packageManager: PackageManagerSpec;
     pnpmManageVersions?: boolean;
-    nodeVersion?: string;
+    engine?: EngineSpec;
+    versions?: PackageVersions;
     /** AI platforms to generate files for */
     aiPlatforms?: AiPlatform[];
 };
@@ -210,5 +224,5 @@ declare function generateMonorepo(params: MonorepoParams): MonorepoResult;
  */
 declare function generate(options: GenerateOptions): Record<string, File>;
 
-export { detectTooling, generate, generateMonorepo, generateRandomName, getBaseTemplate, getLanguageFromTemplate, getLatestNodeVersion, getLatestNpmCliVersion, getLatestNpmVersion, getLatestPnpmVersion, getLatestYarnVersion, parseWorkspaceYamlContent, validatePackageName };
-export type { AiPlatform, BaseTemplate, CodeInjectionLocation, ConfigStrategy, DetectedTooling, File, Formatter, GenerateDreiOptions, GenerateFiberOptions, GenerateGithubPagesOptions, GenerateHandleOptions, GenerateKootaOptions, GenerateLevaOptions, GenerateOffscreenOptions, GenerateOptions, GeneratePostprocessingOptions, GenerateRapierOptions, GenerateTriplexOptions, GenerateUikitOptions, GenerateViverseOptions, GenerateXrOptions, GenerateZustandOptions, Generator, LibraryBundler, Linter, PackageVersions, ProjectType, Template, Testing };
+export { detectTooling, generate, generateMonorepo, generateRandomName, getBaseTemplate, getLanguageFromTemplate, getLatestNodeVersion, getLatestNpmCliVersion, getLatestNpmMajorVersion, 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 };