create-gen-app 0.8.0 → 0.9.0

package/esm/scaffolder/template-scaffolder.js

@@ -81,10 +81,11 @@ export class TemplateScaffolder {
         }
         const branch = options.branch ?? this.config.defaultBranch;
         const resolvedTemplate = this.resolveTemplatePath(template);
+        const useBoilerplatesConfig = options.useBoilerplatesConfig ?? true;
         if (this.isLocalPath(resolvedTemplate) && fs.existsSync(resolvedTemplate)) {
-            return this.inspectLocal(resolvedTemplate, options.fromPath);
+            return this.inspectLocal(resolvedTemplate, options.fromPath, useBoilerplatesConfig);
         }
-        return this.inspectRemote(resolvedTemplate, branch, options.fromPath);
+        return this.inspectRemote(resolvedTemplate, branch, options.fromPath, useBoilerplatesConfig);
     }
     /**
      * Read the .boilerplates.json configuration from a template repository root.
@@ -136,8 +137,8 @@ export class TemplateScaffolder {
     getTemplatizer() {
         return this.templatizer;
     }
-    inspectLocal(templateDir, fromPath) {
-        const { fromPath: resolvedFromPath, resolvedTemplatePath } = this.resolveFromPath(templateDir, fromPath);
+    inspectLocal(templateDir, fromPath, useBoilerplatesConfig = true) {
+        const { fromPath: resolvedFromPath, resolvedTemplatePath } = this.resolveFromPath(templateDir, fromPath, useBoilerplatesConfig);
         const config = this.readBoilerplateConfig(resolvedTemplatePath);
         return {
             templateDir,
@@ -148,7 +149,7 @@ export class TemplateScaffolder {
             config,
         };
     }
-    inspectRemote(templateUrl, branch, fromPath) {
+    inspectRemote(templateUrl, branch, fromPath, useBoilerplatesConfig = true) {
         const normalizedUrl = this.gitCloner.normalizeUrl(templateUrl);
         const cacheKey = this.cacheManager.createKey(normalizedUrl, branch);
         const expiredMetadata = this.cacheManager.checkExpiration(cacheKey);
@@ -172,7 +173,7 @@ export class TemplateScaffolder {
             this.cacheManager.set(cacheKey, tempDest);
             templateDir = tempDest;
         }
-        const { fromPath: resolvedFromPath, resolvedTemplatePath } = this.resolveFromPath(templateDir, fromPath);
+        const { fromPath: resolvedFromPath, resolvedTemplatePath } = this.resolveFromPath(templateDir, fromPath, useBoilerplatesConfig);
         const config = this.readBoilerplateConfig(resolvedTemplatePath);
         return {
             templateDir,
@@ -184,7 +185,7 @@ export class TemplateScaffolder {
         };
     }
     async scaffoldFromLocal(templateDir, options) {
-        const { fromPath, resolvedTemplatePath } = this.resolveFromPath(templateDir, options.fromPath);
+        const { fromPath, resolvedTemplatePath } = this.resolveFromPath(templateDir, options.fromPath, options.useBoilerplatesConfig ?? true);
         const boilerplateConfig = this.readBoilerplateConfig(resolvedTemplatePath);
         const result = await this.templatizer.process(templateDir, options.outputDir, {
             argv: options.answers,
@@ -226,7 +227,7 @@ export class TemplateScaffolder {
             this.cacheManager.set(cacheKey, tempDest);
             templateDir = tempDest;
         }
-        const { fromPath, resolvedTemplatePath } = this.resolveFromPath(templateDir, options.fromPath);
+        const { fromPath, resolvedTemplatePath } = this.resolveFromPath(templateDir, options.fromPath, options.useBoilerplatesConfig ?? true);
         const boilerplateConfig = this.readBoilerplateConfig(resolvedTemplatePath);
         const result = await this.templatizer.process(templateDir, options.outputDir, {
             argv: options.answers,
@@ -249,10 +250,14 @@ export class TemplateScaffolder {
      *
      * Resolution order:
      * 1. If explicit fromPath is provided and exists, use it directly
-     * 2. If .boilerplates.json exists with a dir field, prepend it to fromPath
+     * 2. If useBoilerplatesConfig is true and .boilerplates.json exists with a dir field, prepend it to fromPath
      * 3. Return the fromPath as-is
+     *
+     * @param templateDir - The template repository root directory
+     * @param fromPath - The subdirectory path to resolve
+     * @param useBoilerplatesConfig - Whether to use .boilerplates.json for fallback resolution (default: true)
      */
-    resolveFromPath(templateDir, fromPath) {
+    resolveFromPath(templateDir, fromPath, useBoilerplatesConfig = true) {
         if (!fromPath) {
             return {
                 fromPath: undefined,
@@ -268,14 +273,17 @@ export class TemplateScaffolder {
                 resolvedTemplatePath: directPath,
             };
         }
-        const rootConfig = this.readBoilerplatesConfig(templateDir);
-        if (rootConfig?.dir) {
-            const configBasedPath = path.join(templateDir, rootConfig.dir, fromPath);
-            if (fs.existsSync(configBasedPath) && fs.statSync(configBasedPath).isDirectory()) {
-                return {
-                    fromPath: path.join(rootConfig.dir, fromPath),
-                    resolvedTemplatePath: configBasedPath,
-                };
+        // Only check .boilerplates.json if useBoilerplatesConfig is true
+        if (useBoilerplatesConfig) {
+            const rootConfig = this.readBoilerplatesConfig(templateDir);
+            if (rootConfig?.dir) {
+                const configBasedPath = path.join(templateDir, rootConfig.dir, fromPath);
+                if (fs.existsSync(configBasedPath) && fs.statSync(configBasedPath).isDirectory()) {
+                    return {
+                        fromPath: path.join(rootConfig.dir, fromPath),
+                        resolvedTemplatePath: configBasedPath,
+                    };
+                }
             }
         }
         return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-gen-app",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "author": "Constructive <developers@constructive.io>",
   "description": "Clone and customize template repositories with variable replacement",
   "main": "index.js",
@@ -29,12 +29,12 @@
   },
   "dependencies": {
     "appstash": "0.2.6",
-    "inquirerer": "2.3.2"
+    "inquirerer": "2.4.0"
   },
   "devDependencies": {
     "copyfiles": "^2.4.1",
     "makage": "0.1.8"
   },
   "keywords": [],
-  "gitHead": "9ab0a7a8b90ccedd5f9bbde7dcdaef424c7f5acd"
+  "gitHead": "3d31881a64d8eb1c88d9540871f72bc255da446c"
 }

package/scaffolder/template-scaffolder.d.ts

@@ -78,8 +78,12 @@ export declare class TemplateScaffolder {
      *
      * Resolution order:
      * 1. If explicit fromPath is provided and exists, use it directly
-     * 2. If .boilerplates.json exists with a dir field, prepend it to fromPath
+     * 2. If useBoilerplatesConfig is true and .boilerplates.json exists with a dir field, prepend it to fromPath
      * 3. Return the fromPath as-is
+     *
+     * @param templateDir - The template repository root directory
+     * @param fromPath - The subdirectory path to resolve
+     * @param useBoilerplatesConfig - Whether to use .boilerplates.json for fallback resolution (default: true)
      */
     private resolveFromPath;
     private isLocalPath;

package/scaffolder/template-scaffolder.js

@@ -117,10 +117,11 @@ class TemplateScaffolder {
         }
         const branch = options.branch ?? this.config.defaultBranch;
         const resolvedTemplate = this.resolveTemplatePath(template);
+        const useBoilerplatesConfig = options.useBoilerplatesConfig ?? true;
         if (this.isLocalPath(resolvedTemplate) && fs.existsSync(resolvedTemplate)) {
-            return this.inspectLocal(resolvedTemplate, options.fromPath);
+            return this.inspectLocal(resolvedTemplate, options.fromPath, useBoilerplatesConfig);
         }
-        return this.inspectRemote(resolvedTemplate, branch, options.fromPath);
+        return this.inspectRemote(resolvedTemplate, branch, options.fromPath, useBoilerplatesConfig);
     }
     /**
      * Read the .boilerplates.json configuration from a template repository root.
@@ -172,8 +173,8 @@ class TemplateScaffolder {
     getTemplatizer() {
         return this.templatizer;
     }
-    inspectLocal(templateDir, fromPath) {
-        const { fromPath: resolvedFromPath, resolvedTemplatePath } = this.resolveFromPath(templateDir, fromPath);
+    inspectLocal(templateDir, fromPath, useBoilerplatesConfig = true) {
+        const { fromPath: resolvedFromPath, resolvedTemplatePath } = this.resolveFromPath(templateDir, fromPath, useBoilerplatesConfig);
         const config = this.readBoilerplateConfig(resolvedTemplatePath);
         return {
             templateDir,
@@ -184,7 +185,7 @@ class TemplateScaffolder {
             config,
         };
     }
-    inspectRemote(templateUrl, branch, fromPath) {
+    inspectRemote(templateUrl, branch, fromPath, useBoilerplatesConfig = true) {
         const normalizedUrl = this.gitCloner.normalizeUrl(templateUrl);
         const cacheKey = this.cacheManager.createKey(normalizedUrl, branch);
         const expiredMetadata = this.cacheManager.checkExpiration(cacheKey);
@@ -208,7 +209,7 @@ class TemplateScaffolder {
             this.cacheManager.set(cacheKey, tempDest);
             templateDir = tempDest;
         }
-        const { fromPath: resolvedFromPath, resolvedTemplatePath } = this.resolveFromPath(templateDir, fromPath);
+        const { fromPath: resolvedFromPath, resolvedTemplatePath } = this.resolveFromPath(templateDir, fromPath, useBoilerplatesConfig);
         const config = this.readBoilerplateConfig(resolvedTemplatePath);
         return {
             templateDir,
@@ -220,7 +221,7 @@ class TemplateScaffolder {
         };
     }
     async scaffoldFromLocal(templateDir, options) {
-        const { fromPath, resolvedTemplatePath } = this.resolveFromPath(templateDir, options.fromPath);
+        const { fromPath, resolvedTemplatePath } = this.resolveFromPath(templateDir, options.fromPath, options.useBoilerplatesConfig ?? true);
         const boilerplateConfig = this.readBoilerplateConfig(resolvedTemplatePath);
         const result = await this.templatizer.process(templateDir, options.outputDir, {
             argv: options.answers,
@@ -262,7 +263,7 @@ class TemplateScaffolder {
             this.cacheManager.set(cacheKey, tempDest);
             templateDir = tempDest;
         }
-        const { fromPath, resolvedTemplatePath } = this.resolveFromPath(templateDir, options.fromPath);
+        const { fromPath, resolvedTemplatePath } = this.resolveFromPath(templateDir, options.fromPath, options.useBoilerplatesConfig ?? true);
         const boilerplateConfig = this.readBoilerplateConfig(resolvedTemplatePath);
         const result = await this.templatizer.process(templateDir, options.outputDir, {
             argv: options.answers,
@@ -285,10 +286,14 @@ class TemplateScaffolder {
      *
      * Resolution order:
      * 1. If explicit fromPath is provided and exists, use it directly
-     * 2. If .boilerplates.json exists with a dir field, prepend it to fromPath
+     * 2. If useBoilerplatesConfig is true and .boilerplates.json exists with a dir field, prepend it to fromPath
      * 3. Return the fromPath as-is
+     *
+     * @param templateDir - The template repository root directory
+     * @param fromPath - The subdirectory path to resolve
+     * @param useBoilerplatesConfig - Whether to use .boilerplates.json for fallback resolution (default: true)
      */
-    resolveFromPath(templateDir, fromPath) {
+    resolveFromPath(templateDir, fromPath, useBoilerplatesConfig = true) {
         if (!fromPath) {
             return {
                 fromPath: undefined,
@@ -304,14 +309,17 @@ class TemplateScaffolder {
                 resolvedTemplatePath: directPath,
             };
         }
-        const rootConfig = this.readBoilerplatesConfig(templateDir);
-        if (rootConfig?.dir) {
-            const configBasedPath = path.join(templateDir, rootConfig.dir, fromPath);
-            if (fs.existsSync(configBasedPath) && fs.statSync(configBasedPath).isDirectory()) {
-                return {
-                    fromPath: path.join(rootConfig.dir, fromPath),
-                    resolvedTemplatePath: configBasedPath,
-                };
+        // Only check .boilerplates.json if useBoilerplatesConfig is true
+        if (useBoilerplatesConfig) {
+            const rootConfig = this.readBoilerplatesConfig(templateDir);
+            if (rootConfig?.dir) {
+                const configBasedPath = path.join(templateDir, rootConfig.dir, fromPath);
+                if (fs.existsSync(configBasedPath) && fs.statSync(configBasedPath).isDirectory()) {
+                    return {
+                        fromPath: path.join(rootConfig.dir, fromPath),
+                        resolvedTemplatePath: configBasedPath,
+                    };
+                }
             }
         }
         return {

package/scaffolder/types.d.ts

@@ -47,6 +47,14 @@ export interface ScaffoldOptions {
      * Can be a direct path or a variant name that gets resolved via .boilerplates.json
      */
     fromPath?: string;
+    /**
+     * Whether to use .boilerplates.json for path resolution fallback.
+     * When true (default), if fromPath doesn't exist directly, the resolver
+     * will check .boilerplates.json for a base directory to prepend.
+     * When false, .boilerplates.json is ignored and fromPath is used as-is.
+     * @default true
+     */
+    useBoilerplatesConfig?: boolean;
     /**
      * Output directory for the generated project
      */
@@ -142,6 +150,14 @@ export interface InspectOptions {
      * Can be a direct path or a variant name that gets resolved via .boilerplates.json
      */
     fromPath?: string;
+    /**
+     * Whether to use .boilerplates.json for path resolution fallback.
+     * When true (default), if fromPath doesn't exist directly, the resolver
+     * will check .boilerplates.json for a base directory to prepend.
+     * When false, .boilerplates.json is ignored and fromPath is used as-is.
+     * @default true
+     */
+    useBoilerplatesConfig?: boolean;
 }
 /**
  * Result of inspecting a template.