@crustjs/create 0.0.1 → 0.0.3

package/dist/index.d.ts

@@ -22,24 +22,24 @@ declare function interpolate(content: string, context: Record<string, string>):
 * @example
 * ```ts
 * const options: ScaffoldOptions = {
-*   template: "../templates/base",
+*   template: new URL("../templates/base", import.meta.url),
 *   dest: "./my-project",
-*   importMeta: import.meta.url,
 *   context: { name: "my-app", description: "A cool CLI" },
 *   conflict: "abort",
 * };
 * ```
 */
 interface ScaffoldOptions {
-	/** Relative path to the template directory (resolved against `importMeta`). */
-	readonly template: string;
-	/** Absolute or relative path to the destination directory. */
-	readonly dest: string;
 	/**
-	* The `import.meta.url` of the calling module.
-	* Used to resolve the template path relative to the caller.
+	* Template directory source.
+	*
+	* - `string` absolute path: used as-is
+	* - `string` relative path: resolved from the nearest package root of `process.argv[1]`
+	* - `URL`: must be a `file:` URL (for module-relative templates)
 	*/
-	readonly importMeta: string;
+	readonly template: string | URL;
+	/** Absolute or relative path to the destination directory. */
+	readonly dest: string;
 	/**
 	* Variables to interpolate into template file contents.
 	* Keys map to `{{key}}` placeholders in template files.
@@ -92,9 +92,10 @@ type PostScaffoldStep = {
 * Copy a template directory to a destination, applying variable interpolation
 * and dotfile renaming.
 *
-* Templates are resolved relative to the calling module's `import.meta.url`,
-* so templates bundled inside published npm packages resolve correctly
-* regardless of install location.
+* Template resolution:
+* - `string` absolute paths are used as-is
+* - `string` relative paths resolve from the nearest package root of `process.argv[1]`
+* - `URL` templates must be `file:` URLs (for module-relative templates)
 *
 * Call `scaffold()` multiple times to layer/compose templates — for example,
 * a base template followed by a TypeScript-specific overlay.
@@ -108,9 +109,8 @@ type PostScaffoldStep = {
 * import { scaffold } from "@crustjs/create";
 *
 * const result = await scaffold({
-*   template: "../templates/base",
+*   template: new URL("../templates/base", import.meta.url),
 *   dest: "./my-project",
-*   importMeta: import.meta.url,
 *   context: { name: "my-app", description: "A cool CLI" },
 * });
 *
@@ -141,6 +141,7 @@ declare function scaffold(options: ScaffoldOptions): Promise<ScaffoldResult>;
 * ```
 */
 declare function runSteps(steps: PostScaffoldStep[], cwd: string): Promise<void>;
+type PackageManager = "npm" | "pnpm" | "bun" | "yarn";
 /**
 * Detect the package manager for a project directory.
 *
@@ -158,7 +159,7 @@ declare function runSteps(steps: PostScaffoldStep[], cwd: string): Promise<void>
 * // => "bun" (if bun.lock exists)
 * ```
 */
-declare function detectPackageManager(cwd?: string): string;
+declare function detectPackageManager(cwd?: string): PackageManager;
 /**
 * Check whether `git` is installed and available on the system PATH.
 *
@@ -192,4 +193,4 @@ declare function getGitUser(): {
 	name: string | null;
 	email: string | null;
 };
-export { scaffold, runSteps, isGitInstalled, interpolate, getGitUser, detectPackageManager, ScaffoldResult, ScaffoldOptions, PostScaffoldStep };
+export { scaffold, runSteps, isGitInstalled, interpolate, getGitUser, detectPackageManager, ScaffoldResult, ScaffoldOptions, PostScaffoldStep, PackageManager };

package/dist/index.js

@@ -17,7 +17,7 @@ import {
   statSync,
   writeFileSync
 } from "fs";
-import { dirname, join, relative, resolve } from "path";
+import { dirname, isAbsolute, join, relative, resolve } from "path";
 import { fileURLToPath } from "url";
 
 // src/isBinary.ts
@@ -66,10 +66,55 @@ function isNonEmptyDir(dirPath) {
   const entries = readdirSync(dirPath);
   return entries.length > 0;
 }
+function findNearestPackageRoot(startPath) {
+  let current = resolve(startPath);
+  if (existsSync(current) && !statSync(current).isDirectory()) {
+    current = dirname(current);
+  }
+  while (true) {
+    if (existsSync(join(current, "package.json"))) {
+      return current;
+    }
+    const parent = dirname(current);
+    if (parent === current) {
+      return null;
+    }
+    current = parent;
+  }
+}
+function resolveTemplateDir(template) {
+  if (template instanceof URL) {
+    if (template.protocol !== "file:") {
+      throw new Error(`Template URL must use file: protocol, got "${template.protocol}".`);
+    }
+    return fileURLToPath(template);
+  }
+  if (isAbsolute(template)) {
+    return resolve(template);
+  }
+  const entrypoint = process.argv[1];
+  if (!entrypoint) {
+    throw new Error(`Could not resolve relative template path "${template}" because process.argv[1] is not set. Pass an absolute path or a file: URL template.`);
+  }
+  const packageRoot = findNearestPackageRoot(resolve(entrypoint));
+  if (!packageRoot) {
+    throw new Error(`Could not resolve relative template path "${template}" from entrypoint "${entrypoint}" because no package.json was found in its parent directories. Pass an absolute path or a file: URL template.`);
+  }
+  return resolve(packageRoot, template);
+}
+function formatTemplateInput(template) {
+  return typeof template === "string" ? template : template.href;
+}
 async function scaffold(options) {
-  const { template, dest, importMeta, context, conflict = "abort" } = options;
-  const templateDir = fileURLToPath(new URL(template, importMeta));
+  const { template, dest, context, conflict = "abort" } = options;
+  const templateDir = resolveTemplateDir(template);
   const destDir = resolve(dest);
+  if (!existsSync(templateDir)) {
+    throw new Error(`Template directory "${templateDir}" does not exist (from template: "${formatTemplateInput(template)}").`);
+  }
+  if (!statSync(templateDir).isDirectory()) {
+    throw new Error(`Template path "${templateDir}" is not a directory (from template: "${formatTemplateInput(template)}").`);
+  }
   if (conflict === "abort" && isNonEmptyDir(destDir)) {
     throw new Error(`Destination directory "${destDir}" already exists and is non-empty. Use conflict: "overwrite" to proceed.`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@crustjs/create",
-	"version": "0.0.1",
+	"version": "0.0.3",
 	"description": "Headless scaffolding engine for building create-xxx tools",
 	"type": "module",
 	"license": "MIT",