create-shape-app 0.1.2 → 0.1.4

package/README.md

@@ -29,10 +29,14 @@ Options:
 - `--skip-install`
 - `--skip-git`
 - `--template-ref <tag>`
+- `-h, --help`
+- `-v, --version`
 
 ## Behavior
 - Scaffolds from `shape-network/builder-kit` release tags only (`latest` by default).
 - Rejects non-release refs (for example `main`) and canary tags.
+- In non-interactive terminals, `--yes` is required.
+- In interactive terminals, package manager is selectable when `--pm` is not provided.
 - Copies template files, excluding VCS/internal maintainer metadata.
 - Applies defaults:
   - Root `package.json` name is set from the project directory name.

package/dist/cli/help.js

@@ -6,6 +6,7 @@ Usage:
 
 Notes:
   If project-name is omitted in an interactive terminal, you will be prompted.
+  If --pm is omitted in an interactive terminal, you can pick a package manager.
 
 Options:
   -y, --yes                 Skip confirmation prompts

package/dist/index.js

@@ -12,8 +12,10 @@ import { fetchTemplateRelease } from './template/release.js';
 const require = createRequire(import.meta.url);
 const packageJson = require('../package.json');
 export const CLI_VERSION = packageJson.version ?? '0.0.0';
+const PACKAGE_MANAGERS = ['npm', 'pnpm', 'yarn', 'bun'];
+const PACKAGE_MANAGER_SET = new Set(PACKAGE_MANAGERS);
 const DEFAULT_PROJECT_NAME_PROMPT = 'Project name: ';
-const DEFAULT_CONFIRM_PROMPT = 'Continue? (y/N): ';
+const DEFAULT_CONFIRM_PROMPT = 'Continue? (Y/n): ';
 export async function runCLI(argv, runtimeOverrides = {}) {
     const runtime = createRuntime(runtimeOverrides);
     try {
@@ -34,7 +36,7 @@ export async function runCLI(argv, runtimeOverrides = {}) {
             return 1;
         }
         assertValidProjectName(projectName);
-        const packageManager = options.packageManager ?? detectPackageManager(runtime.env.npm_config_user_agent);
+        const packageManager = await resolvePackageManager(options.packageManager, options.yes, runtime);
         const targetDirectory = path.resolve(runtime.cwd, projectName);
         if (!options.yes) {
             if (!isInteractive(runtime)) {
@@ -131,6 +133,38 @@ async function resolveProjectName(projectName, runtime) {
     const nextProjectName = answer.trim();
     return nextProjectName || undefined;
 }
+async function resolvePackageManager(packageManager, skipPrompts, runtime) {
+    if (packageManager) {
+        return packageManager;
+    }
+    const detectedPackageManager = detectPackageManager(runtime.env.npm_config_user_agent);
+    if (!isInteractive(runtime) || skipPrompts) {
+        return detectedPackageManager;
+    }
+    runtime.print('Package manager:');
+    for (const [index, candidate] of PACKAGE_MANAGERS.entries()) {
+        const defaultLabel = candidate === detectedPackageManager ? ' (default)' : '';
+        runtime.print(`  ${index + 1}) ${candidate}${defaultLabel}`);
+    }
+    while (true) {
+        const answer = (await runtime.prompt(`Select package manager (1-${PACKAGE_MANAGERS.length}) [${detectedPackageManager}]: `))
+            .trim()
+            .toLowerCase();
+        if (!answer) {
+            return detectedPackageManager;
+        }
+        const selectedByIndex = Number(answer);
+        if (Number.isInteger(selectedByIndex) &&
+            selectedByIndex >= 1 &&
+            selectedByIndex <= PACKAGE_MANAGERS.length) {
+            return PACKAGE_MANAGERS[selectedByIndex - 1];
+        }
+        if (PACKAGE_MANAGER_SET.has(answer)) {
+            return answer;
+        }
+        runtime.printError(`Invalid package manager: ${answer}. Enter 1-${PACKAGE_MANAGERS.length} or one of ${PACKAGE_MANAGERS.join(', ')}.`);
+    }
+}
 function isInteractive(runtime) {
     return runtime.stdinIsTTY && runtime.stdoutIsTTY;
 }
@@ -148,7 +182,8 @@ async function defaultPrompt(message) {
 }
 async function defaultConfirm(message) {
     const answer = await defaultPrompt(message);
-    return /^(y|yes)$/i.test(answer.trim());
+    const normalized = answer.trim().toLowerCase();
+    return normalized === '' || normalized === 'y' || normalized === 'yes';
 }
 function assertValidProjectName(projectName) {
     if (projectName === '.' || projectName === '..') {

package/dist/template/release.js

@@ -23,10 +23,11 @@ export async function fetchTemplateRelease(options = {}) {
     const endpoint = templateRef
         ? `https://api.github.com/repos/${owner}/${repo}/releases/tags/${encodeURIComponent(templateRef)}`
         : `https://api.github.com/repos/${owner}/${repo}/releases/latest`;
+    const headers = buildHeaders(githubToken);
     let response;
     for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
         response = await fetchImpl(endpoint, {
-            headers: buildHeaders(githubToken),
+            headers,
         });
         if (response.ok) {
             break;
@@ -40,6 +41,37 @@ export async function fetchTemplateRelease(options = {}) {
         throw new Error('Failed to resolve template release: no response received.');
     }
     if (!response.ok) {
+        if (response.status === 404) {
+            if (templateRef) {
+                const resolvedTag = await resolveTemplateRefTag({
+                    owner,
+                    repo,
+                    templateRef,
+                    githubToken,
+                    fetchImpl,
+                });
+                if (resolvedTag) {
+                    return {
+                        tag: resolvedTag,
+                        tarballUrl: buildTagTarballUrl(owner, repo, resolvedTag),
+                    };
+                }
+            }
+            else {
+                const latestTag = await resolveLatestSupportedTag({
+                    owner,
+                    repo,
+                    githubToken,
+                    fetchImpl,
+                });
+                if (latestTag) {
+                    return {
+                        tag: latestTag,
+                        tarballUrl: buildTagTarballUrl(owner, repo, latestTag),
+                    };
+                }
+            }
+        }
         throw new Error(await buildReleaseLookupError(response, templateRef));
     }
     const payload = (await response.json());
@@ -54,6 +86,9 @@ export async function fetchTemplateRelease(options = {}) {
         tarballUrl,
     };
 }
+function buildTagTarballUrl(owner, repo, tag) {
+    return `https://api.github.com/repos/${owner}/${repo}/tarball/${encodeURIComponent(tag)}`;
+}
 function buildHeaders(githubToken) {
     const headers = {
         Accept: 'application/vnd.github+json',
@@ -84,6 +119,50 @@ async function buildReleaseLookupError(response, templateRef) {
     }
     return `Failed to resolve ${refLabel}: HTTP ${response.status}.`;
 }
+async function resolveLatestSupportedTag(options) {
+    const tags = await fetchTagNames(options);
+    return tags.find((tag) => isSupportedTag(tag));
+}
+async function resolveTemplateRefTag(options) {
+    const tags = await fetchTagNames(options);
+    const exactMatch = tags.find((tag) => tag === options.templateRef && isSupportedTag(tag));
+    if (exactMatch) {
+        return exactMatch;
+    }
+    const normalizedTemplateRef = normalizeTag(options.templateRef);
+    return tags.find((tag) => normalizeTag(tag) === normalizedTemplateRef && isSupportedTag(tag));
+}
+async function fetchTagNames(options) {
+    const response = await options.fetchImpl(`https://api.github.com/repos/${options.owner}/${options.repo}/tags?per_page=100`, {
+        headers: buildHeaders(options.githubToken),
+    });
+    if (!response.ok) {
+        return [];
+    }
+    const payload = (await response.json());
+    if (!Array.isArray(payload)) {
+        return [];
+    }
+    return payload.flatMap((item) => {
+        if (!item || typeof item !== 'object') {
+            return [];
+        }
+        const name = item.name;
+        return typeof name === 'string' && name.trim() ? [name] : [];
+    });
+}
+function isSupportedTag(tag) {
+    try {
+        assertTagIsSupported(tag);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function normalizeTag(tag) {
+    return tag.startsWith('v') ? tag.slice(1) : tag;
+}
 async function readApiMessage(response) {
     try {
         const payload = (await response.clone().json());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-shape-app",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Scaffold Shape Builder Kit projects from pinned release tags.",
   "license": "MIT",
   "repository": {