create-kimesh 0.2.4 → 0.2.5

package/dist/index.d.ts

@@ -1,5 +1,153 @@
-import { main$1 as main } from "./main-WWKDQIfS.js";
+import { main$1 as main } from "./main-DnvYiSHH.js";
 
+//#region src/utils/monorepo.d.ts
+/**
+ * Monorepo detection result
+ */
+interface MonorepoInfo {
+  /** Root directory of the monorepo */
+  root: string;
+  /** Package manager used */
+  packageManager: "pnpm" | "npm" | "yarn" | "bun";
+  /** Workspace patterns */
+  workspaces: string[];
+}
+/**
+ * Host app candidate
+ */
+interface HostAppCandidate {
+  /** Name from package.json */
+  name: string;
+  /** Absolute path to the host app */
+  path: string;
+  /** Whether it has a kimesh.config.ts */
+  hasKimeshConfig: boolean;
+}
+/**
+ * Detect if we're in a monorepo and return its root
+ *
+ * @param cwd - Current working directory to start search from
+ * @returns MonorepoInfo if found, null otherwise
+ */
+declare function detectMonorepoRoot(cwd: string): Promise<MonorepoInfo | null>;
+/**
+ * Find potential host apps in a monorepo
+ *
+ * @param monorepoRoot - Root directory of the monorepo
+ * @returns Array of host app candidates
+ */
+declare function findHostApps(monorepoRoot: string): Promise<HostAppCandidate[]>;
+/**
+ * Get the recommended layer directory based on monorepo structure
+ *
+ * @param monorepoRoot - Root of the monorepo
+ * @param workspaces - Workspace patterns
+ * @returns Recommended directory path for layers
+ */
+declare function getRecommendedLayerDir(monorepoRoot: string, workspaces: string[]): string;
+/**
+ * Check if a path is within a monorepo workspace
+ *
+ * @param path - Path to check
+ * @param monorepo - Monorepo info
+ * @returns true if path is within a workspace pattern
+ */
+declare function isInWorkspace(path: string, monorepo: MonorepoInfo): boolean;
+//#endregion
+//#region src/utils/layer.d.ts
+/**
+ * Default version for @kimesh/* dependencies.
+ * This should match the version of create-kimesh package.
+ */
+declare const DEFAULT_KIMESH_VERSION = "0.2.4";
+/**
+ * Options for transforming a template to a layer
+ */
+interface TransformToLayerOptions {
+  /** Absolute path to the layer directory */
+  layerPath: string;
+  /** Package name for the layer (e.g., "@myorg/my-layer") */
+  packageName: string;
+  /** Layer name for display/config (e.g., "my-layer") */
+  layerName: string;
+}
+/**
+ * Result of layer transformation
+ */
+interface TransformToLayerResult {
+  success: boolean;
+  error?: string;
+  modifiedFiles: string[];
+}
+/**
+ * Transform a downloaded template into a layer
+ *
+ * This function modifies:
+ * - package.json: Updates name, main, exports, files
+ * - kimesh.config.ts: Updates to layer configuration with name and prefix
+ * - routes: Renames routes to layer-specific paths (e.g., src/routes/index.vue -> src/routes/[layerName]/index.vue)
+ *
+ * @param options - Transform options
+ * @returns Result of the transformation
+ */
+declare function transformTemplateToLayer(options: TransformToLayerOptions): Promise<TransformToLayerResult>;
+/**
+ * Convert kebab-case or snake_case to PascalCase
+ */
+declare function toPascalCase(str: string): string;
+/**
+ * Validate layer name
+ *
+ * @param name - Layer name to validate
+ * @returns Error message if invalid, undefined if valid
+ */
+declare function validateLayerName(name: string): string | undefined;
+/**
+ * Generate a package name from layer name and optional scope
+ *
+ * @param layerName - The layer name
+ * @param scope - Optional npm scope (e.g., "@myorg")
+ * @returns Full package name
+ */
+declare function generatePackageName(layerName: string, scope?: string): string;
+//#endregion
+//#region src/utils/host-update.d.ts
+/**
+ * Result of a host update operation
+ */
+interface HostUpdateResult {
+  success: boolean;
+  error?: string;
+  updatedFiles: string[];
+}
+/**
+ * Options for updating a host app
+ */
+interface HostUpdateOptions {
+  /** Absolute path to the host app */
+  hostPath: string;
+  /** Package name of the layer (e.g., "@myorg/my-layer") */
+  layerName: string;
+  /** Relative path from host to layer for workspace reference (e.g., "../layers/my-layer") */
+  layerRelativePath?: string;
+  /** Whether this is a workspace package (use workspace:* version) */
+  isWorkspace?: boolean;
+}
+/**
+ * Add a layer to a host app's configuration
+ *
+ * @param options - Update options
+ * @returns Result of the update operation
+ */
+declare function addLayerToHost(options: HostUpdateOptions): Promise<HostUpdateResult>;
+/**
+ * Check if a host app can be updated (has required files)
+ */
+declare function canUpdateHost(hostPath: string): {
+  canUpdate: boolean;
+  missingFiles: string[];
+};
+//#endregion
 //#region src/types.d.ts
 /**
  * File to generate for a module
@@ -84,6 +232,10 @@ interface CreateOptions {
  * Directory conflict resolution action
  */
 type ConflictAction = "override" | "different" | "abort";
+/**
+ * Project type - either an app or a layer
+ */
+type ProjectType = "app" | "layer";
 //#endregion
 //#region src/modules/registry.d.ts
 /**
@@ -162,6 +314,58 @@ declare function promptDirectoryConflict(dirname: string): Promise<ConflictActio
  */
 declare function promptNewDirectoryName(currentName: string): Promise<string>;
 //#endregion
+//#region src/prompts/layer.d.ts
+/**
+ * Project type options
+ */
+type ProjectType$1 = "app" | "layer";
+/**
+ * Prompt user to select project type (app or layer)
+ *
+ * @returns Selected project type
+ */
+declare function promptProjectType(): Promise<ProjectType$1>;
+/**
+ * Prompt user for layer name
+ *
+ * @param defaultName - Default layer name
+ * @returns Layer name
+ */
+declare function promptLayerName(defaultName?: string): Promise<string>;
+/**
+ * Prompt user for npm scope
+ *
+ * @param defaultScope - Default scope (without @)
+ * @returns Scope string (without @) or empty string for no scope
+ */
+declare function promptNpmScope(defaultScope?: string): Promise<string>;
+/**
+ * Prompt user to select a host app to extend
+ *
+ * @param candidates - List of potential host apps
+ * @returns Selected host app path or null if user chooses not to extend
+ */
+declare function promptHostAppSelection(candidates: HostAppCandidate[]): Promise<HostAppCandidate | null>;
+/**
+ * Prompt user for layer directory in monorepo
+ *
+ * @param recommendedDir - Recommended directory path
+ * @param monorepoRoot - Monorepo root path
+ * @returns Selected directory path
+ */
+declare function promptLayerDirectory(recommendedDir: string, monorepoRoot: string): Promise<string>;
+/**
+ * Prompt user whether to include example files
+ */
+
+/**
+ * Prompt user whether to update host app
+ *
+ * @param hostName - Name of the host app
+ * @returns Whether to update host
+ */
+declare function promptUpdateHost(hostName: string): Promise<boolean>;
+//#endregion
 //#region src/utils/registry.d.ts
 /**
  * Template definition from registry
@@ -317,6 +521,18 @@ interface DownloadOptions {
   force?: boolean;
   /** New project name (for package.json update) */
   projectName?: string;
+  /**
+   * Whether we are in a workspace context.
+   * When true, keeps "workspace:*" dependencies.
+   * When false, replaces "workspace:*" with fixed versions.
+   * @default false
+   */
+  useWorkspaceVersions?: boolean;
+  /**
+   * Version to use for @kimesh/* dependencies when not using workspace versions.
+   * @default DEFAULT_KIMESH_VERSION from layer.ts
+   */
+  kimeshVersion?: string;
 }
 /**
  * Result of template download operation
@@ -355,4 +571,4 @@ declare function installDependencies(dir: string, packageManager?: "npm" | "yarn
  */
 declare function detectPreferredPackageManager(): Promise<"npm" | "yarn" | "pnpm" | "bun">;
 //#endregion
-export { AVAILABLE_MODULES, ConflictAction, CreateOptions, DownloadOptions, DownloadResult, ModuleConfigUpdate, ModuleDefinition, ModuleFile, ModuleInstallOptions, ModuleInstallResult, PackageManager, ResolvedModules, TemplateDefinition, TemplateName, collectPackages, detectPreferredPackageManager, downloadProjectTemplate, fetchAllTemplates, fetchTemplate, generateModuleFiles, getDefaultTemplateName, getInstallSummary, getModule, getModuleDisplayHint, getModuleIds, getTemplateNames, getTemplateSource, hasUnmetDependencies, initGitRepo, installDependencies, installModules, installNpmPackages, isValidModuleId, isValidTemplateName, main, parseModulesArg, promptDirectoryConflict, promptGitInit, promptInstallDeps, promptModuleSelection, promptNewDirectoryName, promptPackageManager, promptProjectName, promptTemplateSelection, resolveModules, updateKimeshConfig, validateProjectName };
+export { AVAILABLE_MODULES, ConflictAction, CreateOptions, DEFAULT_KIMESH_VERSION, DownloadOptions, DownloadResult, type HostAppCandidate, type HostUpdateOptions, type HostUpdateResult, ModuleConfigUpdate, ModuleDefinition, ModuleFile, ModuleInstallOptions, ModuleInstallResult, type MonorepoInfo, PackageManager, ProjectType, ResolvedModules, TemplateDefinition, TemplateName, type TransformToLayerOptions, type TransformToLayerResult, addLayerToHost, canUpdateHost, collectPackages, detectMonorepoRoot, detectPreferredPackageManager, downloadProjectTemplate, fetchAllTemplates, fetchTemplate, findHostApps, generateModuleFiles, generatePackageName, getDefaultTemplateName, getInstallSummary, getModule, getModuleDisplayHint, getModuleIds, getRecommendedLayerDir, getTemplateNames, getTemplateSource, hasUnmetDependencies, initGitRepo, installDependencies, installModules, installNpmPackages, isInWorkspace, isValidModuleId, isValidTemplateName, main, parseModulesArg, promptDirectoryConflict, promptGitInit, promptHostAppSelection, promptInstallDeps, promptLayerDirectory, promptLayerName, promptModuleSelection, promptNewDirectoryName, promptNpmScope, promptPackageManager, promptProjectName, promptProjectType, promptTemplateSelection, promptUpdateHost, resolveModules, toPascalCase, transformTemplateToLayer, updateKimeshConfig, validateLayerName, validateProjectName };

package/dist/index.js

@@ -1,3 +1,4 @@
-import { AVAILABLE_MODULES, collectPackages, detectPreferredPackageManager, downloadProjectTemplate, fetchAllTemplates, fetchTemplate, generateModuleFiles, getDefaultTemplateName, getInstallSummary, getModule, getModuleDisplayHint, getModuleIds, getTemplateNames, getTemplateSource, hasUnmetDependencies, initGitRepo, installDependencies, installModules, installNpmPackages, isValidModuleId, isValidTemplateName, main, parseModulesArg, promptDirectoryConflict, promptGitInit, promptInstallDeps, promptModuleSelection, promptNewDirectoryName, promptPackageManager, promptProjectName, promptTemplateSelection, resolveModules, updateKimeshConfig, validateProjectName } from "./main-BH0zeBMP.js";
+import { AVAILABLE_MODULES, addLayerToHost, canUpdateHost, collectPackages, detectMonorepoRoot, detectPreferredPackageManager, downloadProjectTemplate, fetchAllTemplates, fetchTemplate, findHostApps, generateModuleFiles, getDefaultTemplateName, getInstallSummary, getModule, getModuleDisplayHint, getModuleIds, getRecommendedLayerDir, getTemplateNames, getTemplateSource, hasUnmetDependencies, initGitRepo, installDependencies, installModules, installNpmPackages, isInWorkspace, isValidModuleId, isValidTemplateName, main, parseModulesArg, promptDirectoryConflict, promptGitInit, promptHostAppSelection, promptInstallDeps, promptLayerDirectory, promptLayerName, promptModuleSelection, promptNewDirectoryName, promptNpmScope, promptPackageManager, promptProjectName, promptProjectType, promptTemplateSelection, promptUpdateHost, resolveModules, updateKimeshConfig, validateProjectName } from "./main-BFNE3EFY.js";
+import { DEFAULT_KIMESH_VERSION, generatePackageName, toPascalCase, transformTemplateToLayer, validateLayerName } from "./layer-C-e43mro.js";
 
-export { AVAILABLE_MODULES, collectPackages, detectPreferredPackageManager, downloadProjectTemplate, fetchAllTemplates, fetchTemplate, generateModuleFiles, getDefaultTemplateName, getInstallSummary, getModule, getModuleDisplayHint, getModuleIds, getTemplateNames, getTemplateSource, hasUnmetDependencies, initGitRepo, installDependencies, installModules, installNpmPackages, isValidModuleId, isValidTemplateName, main, parseModulesArg, promptDirectoryConflict, promptGitInit, promptInstallDeps, promptModuleSelection, promptNewDirectoryName, promptPackageManager, promptProjectName, promptTemplateSelection, resolveModules, updateKimeshConfig, validateProjectName };
+export { AVAILABLE_MODULES, DEFAULT_KIMESH_VERSION, addLayerToHost, canUpdateHost, collectPackages, detectMonorepoRoot, detectPreferredPackageManager, downloadProjectTemplate, fetchAllTemplates, fetchTemplate, findHostApps, generateModuleFiles, generatePackageName, getDefaultTemplateName, getInstallSummary, getModule, getModuleDisplayHint, getModuleIds, getRecommendedLayerDir, getTemplateNames, getTemplateSource, hasUnmetDependencies, initGitRepo, installDependencies, installModules, installNpmPackages, isInWorkspace, isValidModuleId, isValidTemplateName, main, parseModulesArg, promptDirectoryConflict, promptGitInit, promptHostAppSelection, promptInstallDeps, promptLayerDirectory, promptLayerName, promptModuleSelection, promptNewDirectoryName, promptNpmScope, promptPackageManager, promptProjectName, promptProjectType, promptTemplateSelection, promptUpdateHost, resolveModules, toPascalCase, transformTemplateToLayer, updateKimeshConfig, validateLayerName, validateProjectName };

package/dist/layer-C-e43mro.js

@@ -0,0 +1,214 @@
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+
+//#region src/utils/layer.ts
+/**
+* Default version for @kimesh/* dependencies.
+* This should match the version of create-kimesh package.
+*/
+const DEFAULT_KIMESH_VERSION = "0.2.4";
+/**
+* Transform a downloaded template into a layer
+*
+* This function modifies:
+* - package.json: Updates name, main, exports, files
+* - kimesh.config.ts: Updates to layer configuration with name and prefix
+* - routes: Renames routes to layer-specific paths (e.g., src/routes/index.vue -> src/routes/[layerName]/index.vue)
+*
+* @param options - Transform options
+* @returns Result of the transformation
+*/
+async function transformTemplateToLayer(options) {
+	const { layerPath, packageName, layerName } = options;
+	const modifiedFiles = [];
+	try {
+		await updatePackageJsonForLayer(layerPath, packageName);
+		modifiedFiles.push("package.json");
+		await updateKimeshConfigForLayer(layerPath, layerName);
+		modifiedFiles.push("kimesh.config.ts");
+		await restructureRoutesForLayer(layerPath, layerName);
+		modifiedFiles.push(`src/routes/${layerName}.vue`);
+		modifiedFiles.push(`src/routes/${layerName}/index.vue`);
+		await cleanupForLayer(layerPath);
+		modifiedFiles.push("removed: src/app.vue", "removed: src/routes/__root.vue");
+		return {
+			success: true,
+			modifiedFiles
+		};
+	} catch (error) {
+		return {
+			success: false,
+			error: error instanceof Error ? error.message : String(error),
+			modifiedFiles
+		};
+	}
+}
+/**
+* Update package.json for layer usage
+*/
+async function updatePackageJsonForLayer(layerPath, packageName) {
+	const pkgPath = join(layerPath, "package.json");
+	if (!existsSync(pkgPath)) throw new Error("package.json not found");
+	const content = await readFile(pkgPath, "utf-8");
+	const pkg = JSON.parse(content);
+	pkg.name = packageName;
+	pkg.main = "./kimesh.config.ts";
+	pkg.exports = { ".": "./kimesh.config.ts" };
+	pkg.files = ["src", "kimesh.config.ts"];
+	if (pkg.scripts) {
+		delete pkg.scripts.dev;
+		delete pkg.scripts.build;
+		delete pkg.scripts.preview;
+		if (Object.keys(pkg.scripts).length === 0) delete pkg.scripts;
+	}
+	await writeFile(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+}
+/**
+* Update kimesh.config.ts for layer usage
+*/
+async function updateKimeshConfigForLayer(layerPath, layerName) {
+	const configPath = join(layerPath, "kimesh.config.ts");
+	const pascalName = toPascalCase(layerName);
+	const newConfig = `import { defineKmConfig } from "@kimesh/kit";
+
+export default defineKmConfig({
+  name: "${layerName}",
+  components: {
+    prefix: "${pascalName}",
+  },
+});
+`;
+	await writeFile(configPath, newConfig);
+}
+/**
+* Restructure routes from app pattern to layer pattern
+*
+* App pattern:
+*   src/routes/__root.vue
+*   src/routes/index.vue
+*   src/routes/about.vue
+*   src/routes/blog.vue
+*
+* Layer pattern:
+*   src/routes/[layerName].vue         <- layout wrapper
+*   src/routes/[layerName]/index.vue   <- index page
+*/
+async function restructureRoutesForLayer(layerPath, layerName) {
+	const routesDir = join(layerPath, "src", "routes");
+	const layerRoutesDir = join(routesDir, layerName);
+	if (!existsSync(layerRoutesDir)) await mkdir(layerRoutesDir, { recursive: true });
+	const newIndexPath = join(layerRoutesDir, "index.vue");
+	const indexContent = generateLayerIndexRoute(layerName);
+	await writeFile(newIndexPath, indexContent);
+	const layoutPath = join(routesDir, `${layerName}.vue`);
+	const layoutContent = generateLayerLayoutRoute(layerName);
+	await writeFile(layoutPath, layoutContent);
+}
+/**
+* Clean up files that aren't needed for layers
+*/
+async function cleanupForLayer(layerPath) {
+	const routesDir = join(layerPath, "src", "routes");
+	const filesToRemove = [
+		join(routesDir, "__root.vue"),
+		join(routesDir, "index.vue"),
+		join(routesDir, "about.vue"),
+		join(routesDir, "blog.vue"),
+		join(layerPath, "src", "app.vue")
+	];
+	for (const file of filesToRemove) if (existsSync(file)) await rm(file);
+}
+/**
+* Generate a layout route for the layer
+*/
+function generateLayerLayoutRoute(layerName) {
+	const pascalName = toPascalCase(layerName);
+	return `<script setup lang="ts">
+/**
+ * ${pascalName} Layer Layout
+ *
+ * This layout wraps all routes under /${layerName}/*
+ */
+</script>
+
+<template>
+  <div class="${layerName}-layout">
+    <slot />
+  </div>
+</template>
+
+<style scoped>
+.${layerName}-layout {
+  min-height: 100vh;
+}
+</style>
+`;
+}
+/**
+* Generate an index route for the layer
+*/
+function generateLayerIndexRoute(layerName) {
+	const pascalName = toPascalCase(layerName);
+	return `<script setup lang="ts">
+/**
+ * ${pascalName} Layer Index Page
+ *
+ * Route: /${layerName}
+ */
+</script>
+
+<template>
+  <div class="${layerName}-page">
+    <h1>Welcome to ${pascalName}</h1>
+    <p>This is the ${layerName} layer index page.</p>
+  </div>
+</template>
+
+<style scoped>
+.${layerName}-page {
+  padding: 2rem;
+}
+
+h1 {
+  margin-bottom: 1rem;
+}
+</style>
+`;
+}
+/**
+* Convert kebab-case or snake_case to PascalCase
+*/
+function toPascalCase(str) {
+	return str.split(/[-_]/).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join("");
+}
+/**
+* Validate layer name
+*
+* @param name - Layer name to validate
+* @returns Error message if invalid, undefined if valid
+*/
+function validateLayerName(name) {
+	if (!name) return "Layer name is required";
+	if (!/^[a-z][a-z0-9-]*$/.test(name)) return "Layer name must start with a letter and contain only lowercase letters, numbers, and hyphens";
+	if (name.length < 2) return "Layer name must be at least 2 characters";
+	if (name.length > 50) return "Layer name must be at most 50 characters";
+	return void 0;
+}
+/**
+* Generate a package name from layer name and optional scope
+*
+* @param layerName - The layer name
+* @param scope - Optional npm scope (e.g., "@myorg")
+* @returns Full package name
+*/
+function generatePackageName(layerName, scope) {
+	if (scope) {
+		const normalizedScope = scope.startsWith("@") ? scope : `@${scope}`;
+		return `${normalizedScope}/${layerName}`;
+	}
+	return layerName;
+}
+
+//#endregion
+export { DEFAULT_KIMESH_VERSION, generatePackageName, toPascalCase, transformTemplateToLayer, validateLayerName };

package/dist/layer-Dv5nq31o.js

@@ -0,0 +1,3 @@
+import { DEFAULT_KIMESH_VERSION, generatePackageName, toPascalCase, transformTemplateToLayer, validateLayerName } from "./layer-C-e43mro.js";
+
+export { validateLayerName };