@wp-typia/project-tools 0.20.1 → 0.20.2

package/dist/runtime/cli-add-block.js

@@ -281,7 +281,7 @@ export async function runAddBlockCommand({ alternateRenderTargets, blockName, cw
         throw new Error("`wp-typia add block --template query-loop` is not supported. Query Loop is a create-time `core/query` variation scaffold, so use `wp-typia create <project-dir> --template query-loop` instead.");
     }
     if (!isAddBlockTemplateId(templateId)) {
-        throw new Error(`Unknown add-block template "${templateId}". Expected one of: ${ADD_BLOCK_TEMPLATE_IDS.join(", ")}`);
+        throw new Error(`Unknown add-block template "${templateId}". Expected one of: ${ADD_BLOCK_TEMPLATE_IDS.join(", ")}. Run \`wp-typia templates list\` to inspect available templates.`);
     }
     const resolvedTemplateId = templateId;
     assertPersistenceFlagsAllowed(resolvedTemplateId, {

package/dist/runtime/cli-diagnostics.d.ts

@@ -19,6 +19,7 @@ export declare const CLI_DIAGNOSTIC_CODES: {
     readonly OUTSIDE_PROJECT_ROOT: "outside-project-root";
     readonly TEMPLATE_SOURCE_TIMEOUT: "template-source-timeout";
     readonly TEMPLATE_SOURCE_TOO_LARGE: "template-source-too-large";
+    readonly UNKNOWN_TEMPLATE: "unknown-template";
     readonly UNSUPPORTED_COMMAND: "unsupported-command";
 };
 export type CliDiagnosticCode = (typeof CLI_DIAGNOSTIC_CODES)[keyof typeof CLI_DIAGNOSTIC_CODES];

package/dist/runtime/cli-diagnostics.js

@@ -10,6 +10,7 @@ export const CLI_DIAGNOSTIC_CODES = {
     OUTSIDE_PROJECT_ROOT: "outside-project-root",
     TEMPLATE_SOURCE_TIMEOUT: "template-source-timeout",
     TEMPLATE_SOURCE_TOO_LARGE: "template-source-too-large",
+    UNKNOWN_TEMPLATE: "unknown-template",
     UNSUPPORTED_COMMAND: "unsupported-command",
 };
 const DEFAULT_CLI_FAILURE_SUMMARIES = {
@@ -183,7 +184,10 @@ function inferCliDiagnosticCode(options) {
     if (/requires <|requires --|requires a value/u.test(haystack)) {
         return CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT;
     }
-    if (/Unknown .*subcommand|Unknown add kind|Unknown template|removed in favor|does not support|The Bun-free fallback runtime does not support|The positional alias only accepts/u.test(haystack)) {
+    if (/Unknown (?:add-block )?template\s+(?:"|\\")/u.test(haystack)) {
+        return CLI_DIAGNOSTIC_CODES.UNKNOWN_TEMPLATE;
+    }
+    if (/Unknown .*subcommand|Unknown add kind|removed in favor|does not support|The Bun-free fallback runtime does not support|The positional alias only accepts/u.test(haystack)) {
         return haystack.includes("does not support") ||
             haystack.includes("The Bun-free fallback runtime does not support")
             ? CLI_DIAGNOSTIC_CODES.UNSUPPORTED_COMMAND

package/dist/runtime/scaffold-answer-resolution.js

@@ -1,8 +1,10 @@
 import { execSync } from 'node:child_process';
+import path from 'node:path';
 import { PACKAGE_MANAGER_IDS, getPackageManager, } from './package-managers.js';
 import { normalizeBlockSlug, resolveScaffoldIdentifiers, validateBlockSlug, validateNamespace, } from './scaffold-identifiers.js';
 import { OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE, TEMPLATE_IDS, getTemplateById, isBuiltInTemplateId, } from './template-registry.js';
 import { getRemovedBuiltInTemplateMessage, isRemovedBuiltInTemplateId, } from './template-defaults.js';
+import { parseNpmTemplateLocator } from './template-source-locators.js';
 import { toSnakeCase, toTitleCase, } from './string-case.js';
 const WORKSPACE_TEMPLATE_ALIAS = 'workspace';
 const TEMPLATE_SELECTION_HINT = `--template <${[
@@ -11,6 +13,10 @@ const TEMPLATE_SELECTION_HINT = `--template <${[
 ].join('|')}|./path|github:owner/repo/path[#ref]|npm-package>`;
 const TEMPLATE_SUGGESTION_IDS = [...TEMPLATE_IDS, WORKSPACE_TEMPLATE_ALIAS];
 const QUERY_POST_TYPE_RULE = 'Use lowercase, 1-20 chars, and only a-z, 0-9, "_" or "-".';
+const USER_FACING_TEMPLATE_IDS = [
+    ...TEMPLATE_IDS,
+    WORKSPACE_TEMPLATE_ALIAS,
+];
 /**
  * Detect the current author name from local Git config.
  *
@@ -78,14 +84,22 @@ function normalizeTemplateSelection(templateId) {
         ? OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE
         : templateId;
 }
-function looksLikeExplicitExternalTemplateLocator(templateId) {
-    return (templateId.startsWith('./') ||
+function looksLikeWindowsAbsoluteTemplatePath(templateId) {
+    return /^[a-z]:[\\/]/iu.test(templateId) || /^\\\\[^\\]+\\[^\\]+/u.test(templateId);
+}
+function looksLikeExplicitNonNpmExternalTemplateLocator(templateId) {
+    return (path.isAbsolute(templateId) ||
+        looksLikeWindowsAbsoluteTemplatePath(templateId) ||
+        templateId.startsWith('./') ||
         templateId.startsWith('../') ||
-        templateId.startsWith('/') ||
         templateId.startsWith('@') ||
         templateId.startsWith('github:') ||
         templateId.includes('/'));
 }
+function looksLikeExplicitExternalTemplateLocator(templateId) {
+    return (looksLikeExplicitNonNpmExternalTemplateLocator(templateId) ||
+        parseNpmTemplateLocator(templateId) !== null);
+}
 function getEditDistance(left, right) {
     const previous = Array.from({ length: right.length + 1 }, (_, index) => index);
     const current = new Array(right.length + 1);
@@ -104,7 +118,7 @@ function getEditDistance(left, right) {
 function findMistypedBuiltInTemplateSuggestion(templateId) {
     const normalizedTemplateId = templateId.trim().toLowerCase();
     if (normalizedTemplateId.length === 0 ||
-        looksLikeExplicitExternalTemplateLocator(normalizedTemplateId)) {
+        looksLikeExplicitNonNpmExternalTemplateLocator(normalizedTemplateId)) {
         return null;
     }
     let bestCandidate = null;
@@ -132,6 +146,13 @@ function getMistypedBuiltInTemplateMessage(templateId) {
         : 'built-in scaffold';
     return `Unknown template "${templateId}". Did you mean "${suggestion}"? Use \`--template ${suggestion}\` for the ${suggestionDescription}, or pass a local path, \`github:owner/repo/path[#ref]\`, or an npm package spec for an external template.`;
 }
+function getUnknownTemplateMessage(templateId) {
+    return [
+        `Unknown template "${templateId}". Expected one of: ${USER_FACING_TEMPLATE_IDS.join(', ')}.`,
+        'Run `wp-typia templates list` to inspect available templates.',
+        'Pass an explicit external template locator such as `./path`, `github:owner/repo/path[#ref]`, or `@scope/template` for custom templates.',
+    ].join(' ');
+}
 /**
  * Resolve the scaffold template id from flags, defaults, and interactive selection.
  *
@@ -154,6 +175,9 @@ export async function resolveTemplateId({ templateId, yes = false, isInteractive
         if (mistypedBuiltInTemplateMessage) {
             throw new Error(mistypedBuiltInTemplateMessage);
         }
+        if (!looksLikeExplicitExternalTemplateLocator(normalizedTemplateId)) {
+            throw new Error(getUnknownTemplateMessage(templateId));
+        }
         return normalizedTemplateId;
     }
     if (yes) {
@@ -190,7 +214,7 @@ export async function resolvePackageManagerId({ packageManager, yes = false, isI
  */
 export async function collectScaffoldAnswers({ projectName, templateId, yes = false, dataStorageMode, namespace, persistencePolicy, phpPrefix, promptText, queryPostType, textDomain, }) {
     const defaults = getDefaultAnswers(projectName, templateId);
-    if (yes) {
+    if (yes || (!isBuiltInTemplateId(templateId) && !promptText)) {
         const identifiers = resolveScaffoldIdentifiers({
             namespace: namespace ?? defaults.namespace,
             phpPrefix,

package/dist/runtime/template-source-seeds.js

@@ -6,9 +6,20 @@ import { spawnSync } from 'node:child_process';
 import semver from 'semver';
 import { x as extractTarball } from 'tar';
 import { createExternalTemplateTimeoutError, fetchWithExternalTemplateTimeout, getExternalTemplateMetadataMaxBytes, getExternalTemplateTarballMaxBytes, getExternalTemplateTimeoutMs, readBufferResponseWithLimit, readJsonResponseWithLimit, } from './external-template-guards.js';
-import { OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE, PROJECT_TOOLS_PACKAGE_ROOT, } from './template-registry.js';
+import { OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE, OFFICIAL_WORKSPACE_TEMPLATE_ALIAS, PROJECT_TOOLS_PACKAGE_ROOT, TEMPLATE_IDS, } from './template-registry.js';
 import { isPlainObject } from './object-utils.js';
 import { createManagedTempRoot } from './temp-roots.js';
+const USER_FACING_TEMPLATE_IDS = [
+    ...TEMPLATE_IDS,
+    OFFICIAL_WORKSPACE_TEMPLATE_ALIAS,
+];
+function getUnknownNpmTemplateMessage(templateId) {
+    return [
+        `Unknown template "${templateId}". Expected one of: ${USER_FACING_TEMPLATE_IDS.join(', ')}.`,
+        'Run `wp-typia templates list` to inspect available templates.',
+        'If you meant an npm template package, verify the package name and configured npm registry.',
+    ].join(' ');
+}
 function selectRegistryVersion(metadata, locator) {
     const distTags = isPlainObject(metadata['dist-tags'])
         ? metadata['dist-tags']
@@ -49,6 +60,9 @@ async function fetchNpmTemplateSource(locator) {
         label: metadataLabel,
     });
     if (!metadataResponse.ok) {
+        if (metadataResponse.status === 404) {
+            throw new Error(getUnknownNpmTemplateMessage(locator.raw));
+        }
         throw new Error(`Failed to fetch npm template metadata for ${locator.raw}: ${metadataResponse.status}`);
     }
     const metadata = await readJsonResponseWithLimit(metadataResponse, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wp-typia/project-tools",
-  "version": "0.20.1",
+  "version": "0.20.2",
   "description": "Project orchestration and programmatic tooling for wp-typia",
   "packageManager": "bun@1.3.11",
   "type": "module",