wp-typia 0.20.4 → 0.20.5

package/dist-bunli/{cli-c5021kqy.js → cli-j1tyw390.js}

@@ -695,13 +695,13 @@ var require_hosts = __commonJS((exports, module) => {
   var defaults = {
     sshtemplate: ({ domain, user, project, committish }) => `git@${domain}:${user}/${project}.git${maybeJoin("#", committish)}`,
     sshurltemplate: ({ domain, user, project, committish }) => `git+ssh://git@${domain}/${user}/${project}.git${maybeJoin("#", committish)}`,
-    edittemplate: ({ domain, user, project, committish, editpath, path: path10 }) => `https://${domain}/${user}/${project}${maybeJoin("/", editpath, "/", maybeEncode(committish || "HEAD"), "/", path10)}`,
+    edittemplate: ({ domain, user, project, committish, editpath, path: path6 }) => `https://${domain}/${user}/${project}${maybeJoin("/", editpath, "/", maybeEncode(committish || "HEAD"), "/", path6)}`,
     browsetemplate: ({ domain, user, project, committish, treepath }) => `https://${domain}/${user}/${project}${maybeJoin("/", treepath, "/", maybeEncode(committish))}`,
-    browsetreetemplate: ({ domain, user, project, committish, treepath, path: path10, fragment, hashformat }) => `https://${domain}/${user}/${project}/${treepath}/${maybeEncode(committish || "HEAD")}/${path10}${maybeJoin("#", hashformat(fragment || ""))}`,
-    browseblobtemplate: ({ domain, user, project, committish, blobpath, path: path10, fragment, hashformat }) => `https://${domain}/${user}/${project}/${blobpath}/${maybeEncode(committish || "HEAD")}/${path10}${maybeJoin("#", hashformat(fragment || ""))}`,
+    browsetreetemplate: ({ domain, user, project, committish, treepath, path: path6, fragment, hashformat }) => `https://${domain}/${user}/${project}/${treepath}/${maybeEncode(committish || "HEAD")}/${path6}${maybeJoin("#", hashformat(fragment || ""))}`,
+    browseblobtemplate: ({ domain, user, project, committish, blobpath, path: path6, fragment, hashformat }) => `https://${domain}/${user}/${project}/${blobpath}/${maybeEncode(committish || "HEAD")}/${path6}${maybeJoin("#", hashformat(fragment || ""))}`,
     docstemplate: ({ domain, user, project, treepath, committish }) => `https://${domain}/${user}/${project}${maybeJoin("/", treepath, "/", maybeEncode(committish))}#readme`,
     httpstemplate: ({ auth, domain, user, project, committish }) => `git+https://${maybeJoin(auth, "@")}${domain}/${user}/${project}.git${maybeJoin("#", committish)}`,
-    filetemplate: ({ domain, user, project, committish, path: path10 }) => `https://${domain}/${user}/${project}/raw/${maybeEncode(committish || "HEAD")}/${path10}`,
+    filetemplate: ({ domain, user, project, committish, path: path6 }) => `https://${domain}/${user}/${project}/raw/${maybeEncode(committish || "HEAD")}/${path6}`,
     shortcuttemplate: ({ type, user, project, committish }) => `${type}:${user}/${project}${maybeJoin("#", committish)}`,
     pathtemplate: ({ user, project, committish }) => `${user}/${project}${maybeJoin("#", committish)}`,
     bugstemplate: ({ domain, user, project }) => `https://${domain}/${user}/${project}/issues`,
@@ -714,7 +714,7 @@ var require_hosts = __commonJS((exports, module) => {
     treepath: "tree",
     blobpath: "blob",
     editpath: "edit",
-    filetemplate: ({ auth, user, project, committish, path: path10 }) => `https://${maybeJoin(auth, "@")}raw.githubusercontent.com/${user}/${project}/${maybeEncode(committish || "HEAD")}/${path10}`,
+    filetemplate: ({ auth, user, project, committish, path: path6 }) => `https://${maybeJoin(auth, "@")}raw.githubusercontent.com/${user}/${project}/${maybeEncode(committish || "HEAD")}/${path6}`,
     gittemplate: ({ auth, domain, user, project, committish }) => `git://${maybeJoin(auth, "@")}${domain}/${user}/${project}.git${maybeJoin("#", committish)}`,
     tarballtemplate: ({ domain, user, project, committish }) => `https://codeload.${domain}/${user}/${project}/tar.gz/${maybeEncode(committish || "HEAD")}`,
     extract: (url) => {
@@ -740,7 +740,7 @@ var require_hosts = __commonJS((exports, module) => {
     treepath: "src",
     blobpath: "src",
     editpath: "?mode=edit",
-    edittemplate: ({ domain, user, project, committish, treepath, path: path10, editpath }) => `https://${domain}/${user}/${project}${maybeJoin("/", treepath, "/", maybeEncode(committish || "HEAD"), "/", path10, editpath)}`,
+    edittemplate: ({ domain, user, project, committish, treepath, path: path6, editpath }) => `https://${domain}/${user}/${project}${maybeJoin("/", treepath, "/", maybeEncode(committish || "HEAD"), "/", path6, editpath)}`,
     tarballtemplate: ({ domain, user, project, committish }) => `https://${domain}/${user}/${project}/get/${maybeEncode(committish || "HEAD")}.tar.gz`,
     extract: (url) => {
       let [, user, project, aux] = url.pathname.split("/", 4);
@@ -764,11 +764,11 @@ var require_hosts = __commonJS((exports, module) => {
     editpath: "-/edit",
     tarballtemplate: ({ domain, user, project, committish }) => `https://${domain}/${user}/${project}/repository/archive.tar.gz?ref=${maybeEncode(committish || "HEAD")}`,
     extract: (url) => {
-      const path10 = url.pathname.slice(1);
-      if (path10.includes("/-/") || path10.includes("/archive.tar.gz")) {
+      const path6 = url.pathname.slice(1);
+      if (path6.includes("/-/") || path6.includes("/archive.tar.gz")) {
         return;
       }
-      const segments = path10.split("/");
+      const segments = path6.split("/");
       let project = segments.pop();
       if (project.endsWith(".git")) {
         project = project.slice(0, -4);
@@ -788,11 +788,11 @@ var require_hosts = __commonJS((exports, module) => {
     sshurltemplate: ({ domain, project, committish }) => `git+ssh://git@${domain}/${project}.git${maybeJoin("#", committish)}`,
     edittemplate: ({ domain, user, project, committish, editpath }) => `https://${domain}/${user}/${project}${maybeJoin("/", maybeEncode(committish))}/${editpath}`,
     browsetemplate: ({ domain, project, committish }) => `https://${domain}/${project}${maybeJoin("/", maybeEncode(committish))}`,
-    browsetreetemplate: ({ domain, project, committish, path: path10, hashformat }) => `https://${domain}/${project}${maybeJoin("/", maybeEncode(committish))}${maybeJoin("#", hashformat(path10))}`,
-    browseblobtemplate: ({ domain, project, committish, path: path10, hashformat }) => `https://${domain}/${project}${maybeJoin("/", maybeEncode(committish))}${maybeJoin("#", hashformat(path10))}`,
+    browsetreetemplate: ({ domain, project, committish, path: path6, hashformat }) => `https://${domain}/${project}${maybeJoin("/", maybeEncode(committish))}${maybeJoin("#", hashformat(path6))}`,
+    browseblobtemplate: ({ domain, project, committish, path: path6, hashformat }) => `https://${domain}/${project}${maybeJoin("/", maybeEncode(committish))}${maybeJoin("#", hashformat(path6))}`,
     docstemplate: ({ domain, project, committish }) => `https://${domain}/${project}${maybeJoin("/", maybeEncode(committish))}`,
     httpstemplate: ({ domain, project, committish }) => `git+https://${domain}/${project}.git${maybeJoin("#", committish)}`,
-    filetemplate: ({ user, project, committish, path: path10 }) => `https://gist.githubusercontent.com/${user}/${project}/raw${maybeJoin("/", maybeEncode(committish))}/${path10}`,
+    filetemplate: ({ user, project, committish, path: path6 }) => `https://gist.githubusercontent.com/${user}/${project}/raw${maybeJoin("/", maybeEncode(committish))}/${path6}`,
     shortcuttemplate: ({ type, project, committish }) => `${type}:${project}${maybeJoin("#", committish)}`,
     pathtemplate: ({ project, committish }) => `${project}${maybeJoin("#", committish)}`,
     bugstemplate: ({ domain, project }) => `https://${domain}/${project}`,
@@ -824,7 +824,7 @@ var require_hosts = __commonJS((exports, module) => {
     domain: "git.sr.ht",
     treepath: "tree",
     blobpath: "tree",
-    filetemplate: ({ domain, user, project, committish, path: path10 }) => `https://${domain}/${user}/${project}/blob/${maybeEncode(committish) || "HEAD"}/${path10}`,
+    filetemplate: ({ domain, user, project, committish, path: path6 }) => `https://${domain}/${user}/${project}/blob/${maybeEncode(committish) || "HEAD"}/${path6}`,
     httpstemplate: ({ domain, user, project, committish }) => `https://${domain}/${user}/${project}.git${maybeJoin("#", committish)}`,
     tarballtemplate: ({ domain, user, project, committish }) => `https://${domain}/${user}/${project}/archive/${maybeEncode(committish) || "HEAD"}.tar.gz`,
     bugstemplate: () => null,
@@ -1005,8 +1005,8 @@ var require_lib = __commonJS((exports, module) => {
         return null;
       }
       const proto = /(?:git\+)http:$/.test(protocol) ? "http:" : "https:";
-      const path10 = pathname.replace(/\.git$/, "");
-      return `${proto}//${hostname}${path10}`;
+      const path6 = pathname.replace(/\.git$/, "");
+      return `${proto}//${hostname}${path6}`;
     } catch {
       return null;
     }
@@ -1099,20 +1099,20 @@ var require_lib = __commonJS((exports, module) => {
     sshurl(opts) {
       return this.#fill(this.sshurltemplate, opts);
     }
-    browse(path10, ...args) {
-      if (typeof path10 !== "string") {
-        return this.#fill(this.browsetemplate, path10);
+    browse(path6, ...args) {
+      if (typeof path6 !== "string") {
+        return this.#fill(this.browsetemplate, path6);
       }
       if (typeof args[0] !== "string") {
-        return this.#fill(this.browsetreetemplate, { ...args[0], path: path10 });
+        return this.#fill(this.browsetreetemplate, { ...args[0], path: path6 });
       }
-      return this.#fill(this.browsetreetemplate, { ...args[1], fragment: args[0], path: path10 });
+      return this.#fill(this.browsetreetemplate, { ...args[1], fragment: args[0], path: path6 });
     }
-    browseFile(path10, ...args) {
+    browseFile(path6, ...args) {
       if (typeof args[0] !== "string") {
-        return this.#fill(this.browseblobtemplate, { ...args[0], path: path10 });
+        return this.#fill(this.browseblobtemplate, { ...args[0], path: path6 });
       }
-      return this.#fill(this.browseblobtemplate, { ...args[1], fragment: args[0], path: path10 });
+      return this.#fill(this.browseblobtemplate, { ...args[1], fragment: args[0], path: path6 });
     }
     docs(opts) {
       return this.#fill(this.docstemplate, opts);
@@ -1135,11 +1135,11 @@ var require_lib = __commonJS((exports, module) => {
     tarball(opts) {
       return this.#fill(this.tarballtemplate, { ...opts, noCommittish: false });
     }
-    file(path10, opts) {
-      return this.#fill(this.filetemplate, { ...opts, path: path10 });
+    file(path6, opts) {
+      return this.#fill(this.filetemplate, { ...opts, path: path6 });
     }
-    edit(path10, opts) {
-      return this.#fill(this.edittemplate, { ...opts, path: path10 });
+    edit(path6, opts) {
+      return this.#fill(this.edittemplate, { ...opts, path: path6 });
     }
     getDefaultRepresentation() {
       return this.default;
@@ -3199,7 +3199,7 @@ var require_lib3 = __commonJS((exports, module) => {
 var require_npa = __commonJS((exports, module) => {
   var isWindows = process.platform === "win32";
   var { URL: URL2 } = __require("url");
-  var path10 = isWindows ? __require("path/win32") : __require("path");
+  var path6 = isWindows ? __require("path/win32") : __require("path");
   var { homedir } = __require("os");
   var HostedGit = require_lib();
   var semver = require_semver2();
@@ -3455,7 +3455,7 @@ var require_npa = __commonJS((exports, module) => {
     let resolvedUrl;
     let specUrl;
     try {
-      resolvedUrl = new URL2(rawSpec, `${pathToFileURL(path10.resolve(where))}/`);
+      resolvedUrl = new URL2(rawSpec, `${pathToFileURL(path6.resolve(where))}/`);
       specUrl = new URL2(rawSpec);
     } catch (originalError) {
       const er = new Error("Invalid file: URL, must comply with RFC 8089");
@@ -3474,13 +3474,13 @@ var require_npa = __commonJS((exports, module) => {
     }
     if (/^\/~(\/|$)/.test(specPath)) {
       res.saveSpec = `file:${specPath.substr(1)}`;
-      resolvedPath = path10.resolve(homedir(), specPath.substr(3));
-    } else if (!path10.isAbsolute(rawSpec.slice(5))) {
-      res.saveSpec = `file:${path10.relative(where, resolvedPath)}`;
+      resolvedPath = path6.resolve(homedir(), specPath.substr(3));
+    } else if (!path6.isAbsolute(rawSpec.slice(5))) {
+      res.saveSpec = `file:${path6.relative(where, resolvedPath)}`;
     } else {
-      res.saveSpec = `file:${path10.resolve(resolvedPath)}`;
+      res.saveSpec = `file:${path6.resolve(resolvedPath)}`;
     }
-    res.fetchSpec = path10.resolve(where, resolvedPath);
+    res.fetchSpec = path6.resolve(where, resolvedPath);
     res.saveSpec = res.saveSpec.split("\\").join("/");
     if (res.saveSpec.startsWith("file://")) {
       res.saveSpec = `file:/${res.saveSpec.slice(7)}`;
@@ -5916,6 +5916,72 @@ function getCompoundInnerBlocksPresetDefinition(value) {
 
 // ../wp-typia-project-tools/src/runtime/scaffold-answer-resolution.ts
 import { execSync } from "child_process";
+import path7 from "path";
+
+// ../wp-typia-project-tools/src/runtime/template-source-locators.ts
+var import_npm_package_arg = __toESM(require_npa(), 1);
+import path6 from "path";
+function isTemplatePathLocator(templateId) {
+  return path6.isAbsolute(templateId) || templateId.startsWith("./") || templateId.startsWith("../");
+}
+function parseGitHubTemplateLocator(templateId) {
+  if (!templateId.startsWith("github:")) {
+    return null;
+  }
+  const [locatorBody, refSegment] = templateId.slice("github:".length).split("#", 2);
+  const segments = locatorBody.split("/").filter(Boolean);
+  if (segments.length < 3) {
+    throw new Error(`GitHub template locators must look like github:owner/repo/path[#ref]. Received: ${templateId}`);
+  }
+  const [owner, repo, ...sourcePathSegments] = segments;
+  return {
+    owner,
+    repo,
+    ref: refSegment ?? null,
+    sourcePath: sourcePathSegments.join("/")
+  };
+}
+function parseNpmTemplateLocator(templateId) {
+  if (isBuiltInTemplateId(templateId) || isTemplatePathLocator(templateId) || templateId.startsWith("github:")) {
+    return null;
+  }
+  try {
+    const parsed = import_npm_package_arg.default(templateId);
+    if (!parsed.registry || !parsed.name) {
+      return null;
+    }
+    const parsedWithRawSpec = parsed;
+    const rawSpec = typeof parsedWithRawSpec.rawSpec === "string" ? parsedWithRawSpec.rawSpec : "";
+    return {
+      fetchSpec: typeof parsed.fetchSpec === "string" ? parsed.fetchSpec : "",
+      name: parsed.name,
+      raw: templateId,
+      rawSpec,
+      type: parsed.type
+    };
+  } catch {
+    return null;
+  }
+}
+function parseTemplateLocator(templateId) {
+  if (isRemovedBuiltInTemplateId(templateId)) {
+    throw new Error(getRemovedBuiltInTemplateMessage(templateId));
+  }
+  const githubLocator = parseGitHubTemplateLocator(templateId);
+  if (githubLocator) {
+    return { kind: "github", locator: githubLocator };
+  }
+  if (isTemplatePathLocator(templateId)) {
+    return { kind: "path", templatePath: templateId };
+  }
+  const npmLocator = parseNpmTemplateLocator(templateId);
+  if (npmLocator) {
+    return { kind: "npm", locator: npmLocator };
+  }
+  throw new Error(`Unknown template "${templateId}". Expected one of: ${BUILTIN_TEMPLATE_IDS.join(", ")}, a local path, github:owner/repo/path[#ref], or an npm package spec.`);
+}
+
+// ../wp-typia-project-tools/src/runtime/scaffold-answer-resolution.ts
 var WORKSPACE_TEMPLATE_ALIAS = "workspace";
 var TEMPLATE_SELECTION_HINT = `--template <${[
   ...TEMPLATE_IDS,
@@ -5923,6 +5989,10 @@ var TEMPLATE_SELECTION_HINT = `--template <${[
 ].join("|")}|./path|github:owner/repo/path[#ref]|npm-package>`;
 var TEMPLATE_SUGGESTION_IDS = [...TEMPLATE_IDS, WORKSPACE_TEMPLATE_ALIAS];
 var QUERY_POST_TYPE_RULE = 'Use lowercase, 1-20 chars, and only a-z, 0-9, "_" or "-".';
+var USER_FACING_TEMPLATE_IDS = [
+  ...TEMPLATE_IDS,
+  WORKSPACE_TEMPLATE_ALIAS
+];
 function detectAuthor() {
   try {
     return execSync("git config user.name", {
@@ -5973,8 +6043,14 @@ function normalizeQueryPostType(value) {
 function normalizeTemplateSelection(templateId) {
   return templateId === WORKSPACE_TEMPLATE_ALIAS ? OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE : templateId;
 }
+function looksLikeWindowsAbsoluteTemplatePath(templateId) {
+  return /^[a-z]:[\\/]/iu.test(templateId) || /^\\\\[^\\]+\\[^\\]+/u.test(templateId);
+}
+function looksLikeExplicitNonNpmExternalTemplateLocator(templateId) {
+  return path7.isAbsolute(templateId) || looksLikeWindowsAbsoluteTemplatePath(templateId) || templateId.startsWith("./") || templateId.startsWith("../") || templateId.startsWith("@") || templateId.startsWith("github:") || templateId.includes("/");
+}
 function looksLikeExplicitExternalTemplateLocator(templateId) {
-  return templateId.startsWith("./") || templateId.startsWith("../") || templateId.startsWith("/") || templateId.startsWith("@") || templateId.startsWith("github:") || templateId.includes("/");
+  return looksLikeExplicitNonNpmExternalTemplateLocator(templateId) || parseNpmTemplateLocator(templateId) !== null;
 }
 function getEditDistance(left, right) {
   const previous = Array.from({ length: right.length + 1 }, (_, index) => index);
@@ -5993,7 +6069,7 @@ function getEditDistance(left, right) {
 }
 function findMistypedBuiltInTemplateSuggestion(templateId) {
   const normalizedTemplateId = templateId.trim().toLowerCase();
-  if (normalizedTemplateId.length === 0 || looksLikeExplicitExternalTemplateLocator(normalizedTemplateId)) {
+  if (normalizedTemplateId.length === 0 || looksLikeExplicitNonNpmExternalTemplateLocator(normalizedTemplateId)) {
     return null;
   }
   let bestCandidate = null;
@@ -6016,6 +6092,13 @@ function getMistypedBuiltInTemplateMessage(templateId) {
   const suggestionDescription = suggestion === WORKSPACE_TEMPLATE_ALIAS ? "official workspace scaffold" : "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(" ");
+}
 async function resolveTemplateId({
   templateId,
   yes = false,
@@ -6037,6 +6120,9 @@ async function resolveTemplateId({
     if (mistypedBuiltInTemplateMessage) {
       throw new Error(mistypedBuiltInTemplateMessage);
     }
+    if (!looksLikeExplicitExternalTemplateLocator(normalizedTemplateId)) {
+      throw new Error(getUnknownTemplateMessage(templateId));
+    }
     return normalizedTemplateId;
   }
   if (yes) {
@@ -6077,7 +6163,7 @@ async function collectScaffoldAnswers({
   textDomain
 }) {
   const defaults = getDefaultAnswers(projectName, templateId);
-  if (yes) {
+  if (yes || !isBuiltInTemplateId(templateId) && !promptText) {
     const identifiers2 = resolveScaffoldIdentifiers({
       namespace: namespace ?? defaults.namespace,
       phpPrefix,
@@ -6120,23 +6206,23 @@ async function collectScaffoldAnswers({
 // ../wp-typia-project-tools/src/runtime/scaffold.ts
 import fs14 from "fs";
 import { promises as fsp10 } from "fs";
-import path16 from "path";
+import path17 from "path";
 
 // ../wp-typia-project-tools/src/runtime/scaffold-apply-utils.ts
 import fs6 from "fs";
 import { promises as fsp6 } from "fs";
-import path9 from "path";
+import path11 from "path";
 import { execSync as execSync3 } from "child_process";
 import { fileURLToPath } from "url";
 
 // ../wp-typia-project-tools/src/runtime/migration-ui-capability.ts
 import { promises as fsp4 } from "fs";
-import path6 from "path";
+import path8 from "path";
 var INITIAL_MIGRATION_VERSION = "v1";
 var BLOCK_METADATA_IMPORT_LINE = "import metadata from './block-metadata';";
 var LEGACY_BLOCK_JSON_IMPORT_LINE = "import metadata from './block.json';";
 async function mutatePackageJson2(projectDir, mutate) {
-  const packageJsonPath = path6.join(projectDir, "package.json");
+  const packageJsonPath = path8.join(projectDir, "package.json");
   const packageJson = JSON.parse(await fsp4.readFile(packageJsonPath, "utf8"));
   mutate(packageJson);
   await fsp4.writeFile(packageJsonPath, `${JSON.stringify(packageJson, null, "\t")}
@@ -6210,8 +6296,8 @@ function buildMigrationBlocks(templateId, variables) {
   ];
 }
 async function applySingleBlockPatches(projectDir, variables) {
-  const editPath = path6.join(projectDir, "src", "edit.tsx");
-  const indexPath = path6.join(projectDir, "src", "index.tsx");
+  const editPath = path8.join(projectDir, "src", "edit.tsx");
+  const indexPath = path8.join(projectDir, "src", "index.tsx");
   const deprecatedImport = `import { deprecated } from './migrations/generated/${variables.slugKebabCase}/deprecated';`;
   const deprecatedLine = "  deprecated,";
   const dashboardImport = `import { MigrationDashboard } from './admin/migration-dashboard';`;
@@ -6232,10 +6318,10 @@ async function applySingleBlockPatches(projectDir, variables) {
   });
 }
 async function applyCompoundPatches(projectDir, variables) {
-  const parentEditPath = path6.join(projectDir, "src", "blocks", variables.slugKebabCase, "edit.tsx");
-  const parentIndexPath = path6.join(projectDir, "src", "blocks", variables.slugKebabCase, "index.tsx");
-  const childIndexPath = path6.join(projectDir, "src", "blocks", `${variables.slugKebabCase}-item`, "index.tsx");
-  const addChildScriptPath = path6.join(projectDir, "scripts", "add-compound-child.ts");
+  const parentEditPath = path8.join(projectDir, "src", "blocks", variables.slugKebabCase, "edit.tsx");
+  const parentIndexPath = path8.join(projectDir, "src", "blocks", variables.slugKebabCase, "index.tsx");
+  const childIndexPath = path8.join(projectDir, "src", "blocks", `${variables.slugKebabCase}-item`, "index.tsx");
+  const addChildScriptPath = path8.join(projectDir, "scripts", "add-compound-child.ts");
   await patchFile(parentIndexPath, (source) => {
     let nextSource = injectAfterBlockMetadataImport(source, `import { deprecated } from '../../migrations/generated/${variables.slugKebabCase}/deprecated';`);
     nextSource = injectBefore(nextSource, "\tedit: Edit,", "\tdeprecated,");
@@ -6305,7 +6391,7 @@ async function applyMigrationUiCapability({
   templateId,
   variables
 }) {
-  const commonTemplateDir = path6.join(SHARED_MIGRATION_UI_TEMPLATE_ROOT, "common");
+  const commonTemplateDir = path8.join(SHARED_MIGRATION_UI_TEMPLATE_ROOT, "common");
   await copyInterpolatedDirectory(commonTemplateDir, projectDir, variables);
   await mutatePackageJson2(projectDir, (packageJson) => {
     const wpTypiaPackageVersion = getPackageVersions().wpTypiaPackageVersion;
@@ -6549,7 +6635,7 @@ function mergeTextLines(primaryContent, existingContent) {
 import fs4 from "fs";
 import { promises as fsp5 } from "fs";
 import { execSync as execSync2 } from "child_process";
-import path7 from "path";
+import path9 from "path";
 var LOCKFILES = {
   bun: ["bun.lock", "bun.lockb"],
   npm: ["package-lock.json"],
@@ -6557,7 +6643,7 @@ var LOCKFILES = {
   yarn: ["yarn.lock"]
 };
 async function normalizePackageManagerFiles(targetDir, packageManagerId) {
-  const yarnRcPath = path7.join(targetDir, ".yarnrc.yml");
+  const yarnRcPath = path9.join(targetDir, ".yarnrc.yml");
   if (packageManagerId === "yarn") {
     await fsp5.writeFile(yarnRcPath, `nodeLinker: node-modules
 `, "utf8");
@@ -6566,7 +6652,7 @@ async function normalizePackageManagerFiles(targetDir, packageManagerId) {
   await fsp5.rm(yarnRcPath, { force: true });
 }
 async function normalizePackageJson(targetDir, packageManagerId) {
-  const packageJsonPath = path7.join(targetDir, "package.json");
+  const packageJsonPath = path9.join(targetDir, "package.json");
   if (!fs4.existsSync(packageJsonPath)) {
     return;
   }
@@ -6594,7 +6680,7 @@ async function removeUnexpectedLockfiles(targetDir, packageManagerId) {
     if (keep.has(filename)) {
       return;
     }
-    await fsp5.rm(path7.join(targetDir, filename), { force: true });
+    await fsp5.rm(path9.join(targetDir, filename), { force: true });
   }));
 }
 async function defaultInstallDependencies({
@@ -6610,7 +6696,7 @@ async function defaultInstallDependencies({
 // ../wp-typia-project-tools/src/runtime/scaffold-repository-reference.ts
 import fs5 from "fs";
 import { createRequire } from "module";
-import path8 from "path";
+import path10 from "path";
 var require2 = createRequire(import.meta.url);
 var DEFAULT_SCAFFOLD_REPOSITORY_REFERENCE = "imjlk/wp-typia";
 function getErrorCode(error) {
@@ -6676,9 +6762,9 @@ function parseRepositoryReference(value) {
 }
 function getDefaultRepositoryManifestPaths() {
   const candidatePaths = [
-    path8.resolve(PROJECT_TOOLS_PACKAGE_ROOT, "..", "..", "package.json"),
-    path8.resolve(PROJECT_TOOLS_PACKAGE_ROOT, "..", "wp-typia", "package.json"),
-    path8.join(PROJECT_TOOLS_PACKAGE_ROOT, "package.json"),
+    path10.resolve(PROJECT_TOOLS_PACKAGE_ROOT, "..", "..", "package.json"),
+    path10.resolve(PROJECT_TOOLS_PACKAGE_ROOT, "..", "wp-typia", "package.json"),
+    path10.join(PROJECT_TOOLS_PACKAGE_ROOT, "package.json"),
     resolveInstalledPackageManifestPath("wp-typia"),
     resolveInstalledPackageManifestPath("@wp-typia/project-tools")
   ].filter((candidatePath) => Boolean(candidatePath));
@@ -6705,7 +6791,7 @@ async function reportScaffoldProgress(onProgress, event) {
   await onProgress?.(event);
 }
 var EPHEMERAL_NODE_MODULES_LINK_TYPE2 = process.platform === "win32" ? "junction" : "dir";
-var __dirname2 = path9.dirname(fileURLToPath(import.meta.url));
+var __dirname2 = path11.dirname(fileURLToPath(import.meta.url));
 var LOCKFILES2 = {
   bun: ["bun.lock", "bun.lockb"],
   npm: ["package-lock.json"],
@@ -6731,42 +6817,42 @@ async function writeStarterManifestFiles2(targetDir, templateId, variables, arti
     relativePath: `${artifact.relativeDir}/typia.manifest.json`
   })) : getStarterManifestFiles(templateId, variables);
   for (const { document, relativePath } of manifests) {
-    const destinationPath = path9.join(targetDir, relativePath);
-    await fsp6.mkdir(path9.dirname(destinationPath), { recursive: true });
+    const destinationPath = path11.join(targetDir, relativePath);
+    await fsp6.mkdir(path11.dirname(destinationPath), { recursive: true });
     await fsp6.writeFile(destinationPath, stringifyStarterManifest(document), "utf8");
   }
 }
 async function writeBuiltInStructuralArtifacts(targetDir, artifacts) {
   for (const artifact of artifacts) {
-    const destinationDir = path9.join(targetDir, artifact.relativeDir);
+    const destinationDir = path11.join(targetDir, artifact.relativeDir);
     await fsp6.mkdir(destinationDir, { recursive: true });
-    await fsp6.writeFile(path9.join(destinationDir, "types.ts"), artifact.typesSource, "utf8");
-    await fsp6.writeFile(path9.join(destinationDir, "block.json"), stringifyBuiltInBlockJsonDocument(artifact.blockJsonDocument), "utf8");
+    await fsp6.writeFile(path11.join(destinationDir, "types.ts"), artifact.typesSource, "utf8");
+    await fsp6.writeFile(path11.join(destinationDir, "block.json"), stringifyBuiltInBlockJsonDocument(artifact.blockJsonDocument), "utf8");
   }
 }
 async function writeBuiltInCodeArtifacts(targetDir, codeArtifacts) {
   for (const artifact of codeArtifacts) {
-    const destinationPath = path9.join(targetDir, artifact.relativePath);
-    await fsp6.mkdir(path9.dirname(destinationPath), { recursive: true });
+    const destinationPath = path11.join(targetDir, artifact.relativePath);
+    await fsp6.mkdir(path11.dirname(destinationPath), { recursive: true });
     await fsp6.writeFile(destinationPath, artifact.source, "utf8");
   }
 }
 function resolveScaffoldGeneratorNodeModulesPath2() {
-  const projectToolsPackageRoot = path9.resolve(__dirname2, "..", "..");
+  const projectToolsPackageRoot = path11.resolve(__dirname2, "..", "..");
   const candidates = [
-    path9.join(projectToolsPackageRoot, "node_modules"),
-    path9.resolve(projectToolsPackageRoot, "..", ".."),
-    path9.resolve(projectToolsPackageRoot, "..", "..", "node_modules")
+    path11.join(projectToolsPackageRoot, "node_modules"),
+    path11.resolve(projectToolsPackageRoot, "..", ".."),
+    path11.resolve(projectToolsPackageRoot, "..", "..", "node_modules")
   ];
   for (const candidate of candidates) {
-    if (fs6.existsSync(path9.join(candidate, "typia", "package.json"))) {
+    if (fs6.existsSync(path11.join(candidate, "typia", "package.json"))) {
       return candidate;
     }
   }
   return null;
 }
 async function withEphemeralScaffoldNodeModules2(targetDir, callback) {
-  const targetNodeModulesPath = path9.join(targetDir, "node_modules");
+  const targetNodeModulesPath = path11.join(targetDir, "node_modules");
   if (fs6.existsSync(targetNodeModulesPath)) {
     await callback();
     return;
@@ -6790,7 +6876,7 @@ async function seedBuiltInPersistenceArtifacts2(targetDir, templateId, variables
   await withEphemeralScaffoldNodeModules2(targetDir, async () => {
     if (templateId === "persistence") {
       await syncPersistenceRestArtifacts({
-        apiTypesFile: path9.join("src", "api-types.ts"),
+        apiTypesFile: path11.join("src", "api-types.ts"),
         outputDir: "src",
         projectDir: targetDir,
         variables
@@ -6798,15 +6884,15 @@ async function seedBuiltInPersistenceArtifacts2(targetDir, templateId, variables
       return;
     }
     await syncPersistenceRestArtifacts({
-      apiTypesFile: path9.join("src", "blocks", variables.slugKebabCase, "api-types.ts"),
-      outputDir: path9.join("src", "blocks", variables.slugKebabCase),
+      apiTypesFile: path11.join("src", "blocks", variables.slugKebabCase, "api-types.ts"),
+      outputDir: path11.join("src", "blocks", variables.slugKebabCase),
       projectDir: targetDir,
       variables
     });
   });
 }
 async function normalizePackageManagerFiles2(targetDir, packageManagerId) {
-  const yarnRcPath = path9.join(targetDir, ".yarnrc.yml");
+  const yarnRcPath = path11.join(targetDir, ".yarnrc.yml");
   if (packageManagerId === "yarn") {
     await fsp6.writeFile(yarnRcPath, `nodeLinker: node-modules
 `, "utf8");
@@ -6820,7 +6906,7 @@ async function removeQueryLoopPlaceholderFiles(projectDir, templateId) {
   if (templateId !== "query-loop") {
     return;
   }
-  await fsp6.rm(path9.join(projectDir, "src", "validator-toolkit.ts"), {
+  await fsp6.rm(path11.join(projectDir, "src", "validator-toolkit.ts"), {
     force: true
   });
 }
@@ -6831,7 +6917,7 @@ async function removeUnexpectedLockfiles2(targetDir, packageManagerId) {
     if (keep.has(filename)) {
       return;
     }
-    const filePath = path9.join(targetDir, filename);
+    const filePath = path11.join(targetDir, filename);
     if (fs6.existsSync(filePath)) {
       await fsp6.rm(filePath, { force: true });
     }
@@ -6861,11 +6947,11 @@ async function replaceTextRecursively(targetDir, packageManagerId, {
     if (stats.isDirectory()) {
       const entries = await fsp6.readdir(currentPath);
       for (const entry of entries) {
-        await visit(path9.join(currentPath, entry));
+        await visit(path11.join(currentPath, entry));
       }
       return;
     }
-    if (path9.basename(currentPath) === "package.json" || !textExtensions.has(path9.extname(currentPath))) {
+    if (path11.basename(currentPath) === "package.json" || !textExtensions.has(path11.extname(currentPath))) {
       return;
     }
     const content = await fsp6.readFile(currentPath, "utf8");
@@ -6943,7 +7029,7 @@ async function applyBuiltInScaffoldProjectFiles({
     phase: "finalize-project",
     title: "Finalizing scaffold output"
   });
-  const readmePath = path9.join(projectDir, "README.md");
+  const readmePath = path11.join(projectDir, "README.md");
   if (!fs6.existsSync(readmePath)) {
     await fsp6.writeFile(readmePath, readmeContent ?? buildReadme(templateId, variables, packageManager, {
       withMigrationUi,
@@ -6951,7 +7037,7 @@ async function applyBuiltInScaffoldProjectFiles({
       withWpEnv
     }), "utf8");
   }
-  const gitignorePath = path9.join(projectDir, ".gitignore");
+  const gitignorePath = path11.join(projectDir, ".gitignore");
   const existingGitignore = fs6.existsSync(gitignorePath) ? await fsp6.readFile(gitignorePath, "utf8") : "";
   await fsp6.writeFile(gitignorePath, mergeTextLines(gitignoreContent ?? buildGitignore(), existingGitignore), "utf8");
   await normalizePackageJson(projectDir, packageManager);
@@ -6983,83 +7069,20 @@ async function applyBuiltInScaffoldProjectFiles({
   }
 }
 
-// ../wp-typia-project-tools/src/runtime/template-source-locators.ts
-var import_npm_package_arg = __toESM(require_npa(), 1);
-import path10 from "path";
-function isTemplatePathLocator(templateId) {
-  return path10.isAbsolute(templateId) || templateId.startsWith("./") || templateId.startsWith("../");
-}
-function parseGitHubTemplateLocator(templateId) {
-  if (!templateId.startsWith("github:")) {
-    return null;
-  }
-  const [locatorBody, refSegment] = templateId.slice("github:".length).split("#", 2);
-  const segments = locatorBody.split("/").filter(Boolean);
-  if (segments.length < 3) {
-    throw new Error(`GitHub template locators must look like github:owner/repo/path[#ref]. Received: ${templateId}`);
-  }
-  const [owner, repo, ...sourcePathSegments] = segments;
-  return {
-    owner,
-    repo,
-    ref: refSegment ?? null,
-    sourcePath: sourcePathSegments.join("/")
-  };
-}
-function parseNpmTemplateLocator(templateId) {
-  if (isBuiltInTemplateId(templateId) || isTemplatePathLocator(templateId) || templateId.startsWith("github:")) {
-    return null;
-  }
-  try {
-    const parsed = import_npm_package_arg.default(templateId);
-    if (!parsed.registry || !parsed.name) {
-      return null;
-    }
-    const parsedWithRawSpec = parsed;
-    const rawSpec = typeof parsedWithRawSpec.rawSpec === "string" ? parsedWithRawSpec.rawSpec : "";
-    return {
-      fetchSpec: typeof parsed.fetchSpec === "string" ? parsed.fetchSpec : "",
-      name: parsed.name,
-      raw: templateId,
-      rawSpec,
-      type: parsed.type
-    };
-  } catch {
-    return null;
-  }
-}
-function parseTemplateLocator(templateId) {
-  if (isRemovedBuiltInTemplateId(templateId)) {
-    throw new Error(getRemovedBuiltInTemplateMessage(templateId));
-  }
-  const githubLocator = parseGitHubTemplateLocator(templateId);
-  if (githubLocator) {
-    return { kind: "github", locator: githubLocator };
-  }
-  if (isTemplatePathLocator(templateId)) {
-    return { kind: "path", templatePath: templateId };
-  }
-  const npmLocator = parseNpmTemplateLocator(templateId);
-  if (npmLocator) {
-    return { kind: "npm", locator: npmLocator };
-  }
-  throw new Error(`Unknown template "${templateId}". Expected one of: ${BUILTIN_TEMPLATE_IDS.join(", ")}, a local path, github:owner/repo/path[#ref], or an npm package spec.`);
-}
-
 // ../wp-typia-project-tools/src/runtime/template-source-normalization.ts
 import fs11 from "fs";
-import path14 from "path";
+import path15 from "path";
 
 // ../wp-typia-project-tools/src/runtime/template-layers.ts
 import fs7 from "fs";
-import path11 from "path";
+import path12 from "path";
 import { promises as fsp7 } from "fs";
 var TEMPLATE_LAYER_MANIFEST_FILENAME = "wp-typia.layers.json";
 var TEMPLATE_LAYER_MANIFEST_VERSION = 1;
 function resolveLayerPath(sourceRoot, relativePath) {
-  const targetPath = path11.resolve(sourceRoot, relativePath);
-  const relativeTarget = path11.relative(sourceRoot, targetPath);
-  if (relativeTarget.startsWith("..") || path11.isAbsolute(relativeTarget)) {
+  const targetPath = path12.resolve(sourceRoot, relativePath);
+  const relativeTarget = path12.relative(sourceRoot, targetPath);
+  if (relativeTarget.startsWith("..") || path12.isAbsolute(relativeTarget)) {
     throw new Error(`Template layer path "${relativePath}" must stay within ${sourceRoot}.`);
   }
   return targetPath;
@@ -7073,7 +7096,7 @@ async function assertNoSymlinks(sourceDir) {
     return;
   }
   for (const entry of await fsp7.readdir(sourceDir)) {
-    await assertNoSymlinks(path11.join(sourceDir, entry));
+    await assertNoSymlinks(path12.join(sourceDir, entry));
   }
 }
 function parseLayerDefinition(layerId, value) {
@@ -7102,7 +7125,7 @@ function parseLayerDefinition(layerId, value) {
   };
 }
 async function loadExternalTemplateLayerManifest(sourceRoot) {
-  const manifestPath = path11.join(sourceRoot, TEMPLATE_LAYER_MANIFEST_FILENAME);
+  const manifestPath = path12.join(sourceRoot, TEMPLATE_LAYER_MANIFEST_FILENAME);
   if (!fs7.existsSync(manifestPath)) {
     return null;
   }
@@ -7239,7 +7262,7 @@ async function assertExternalTemplateLayersDoNotWriteProtectedOutputs({
 
 // ../wp-typia-project-tools/src/runtime/template-source-external.ts
 import fs9 from "fs";
-import path12 from "path";
+import path13 from "path";
 import { pathToFileURL } from "url";
 
 // ../wp-typia-project-tools/src/runtime/external-template-guards.ts
@@ -7383,16 +7406,16 @@ function getTemplateWarning(key) {
   return `Ignoring external template config key "${key}": ${TEMPLATE_WARNING_MESSAGE}`;
 }
 function resolveSourceSubpath(sourceDir, relativePath) {
-  const targetPath = path12.resolve(sourceDir, relativePath);
-  const relativeTarget = path12.relative(sourceDir, targetPath);
-  if (relativeTarget.startsWith("..") || path12.isAbsolute(relativeTarget)) {
+  const targetPath = path13.resolve(sourceDir, relativePath);
+  const relativeTarget = path13.relative(sourceDir, targetPath);
+  if (relativeTarget.startsWith("..") || path13.isAbsolute(relativeTarget)) {
     throw new Error(`Template path "${relativePath}" must stay within ${sourceDir}.`);
   }
   return targetPath;
 }
 function getExternalTemplateEntry(sourceDir) {
   for (const filename of EXTERNAL_TEMPLATE_ENTRY_CANDIDATES) {
-    const candidate = path12.join(sourceDir, filename);
+    const candidate = path13.join(sourceDir, filename);
     if (fs9.existsSync(candidate)) {
       return candidate;
     }
@@ -7514,22 +7537,22 @@ async function renderCreateBlockExternalTemplate(sourceDir, context, requestedVa
   const { folderName, formatHint, templatePath } = resolveConfiguredTemplatePath(config, variantConfig);
   const { path: tempRoot, cleanup } = await createManagedTempRoot("wp-typia-create-block-external-");
   try {
-    const renderedRoot = path12.join(tempRoot, "rendered");
+    const renderedRoot = path13.join(tempRoot, "rendered");
     const blockDir = resolveSourceSubpath(renderedRoot, folderName);
     const view = await buildExternalTemplateView(context, config, selectedVariant, variantConfig);
     const blockTemplateDir = resolveSourceSubpath(sourceDir, templatePath);
     await copyRenderedDirectory(blockTemplateDir, blockDir, view, {
       filter: (sourcePath, _destinationPath, entry) => {
-        const mustacheVariantPath = path12.join(path12.dirname(sourcePath), `${entry.name}.mustache`);
+        const mustacheVariantPath = path13.join(path13.dirname(sourcePath), `${entry.name}.mustache`);
         return !(entry.isFile() && (entry.name === "package.json" || entry.name === "README.md") && fs9.existsSync(mustacheVariantPath));
       }
     });
     const assetsPath = typeof variantConfig.assetsPath === "string" ? variantConfig.assetsPath : config.assetsPath;
     if (typeof assetsPath === "string" && assetsPath.trim().length > 0) {
-      await copyRawDirectory(resolveSourceSubpath(sourceDir, assetsPath), path12.join(tempRoot, "assets"));
+      await copyRawDirectory(resolveSourceSubpath(sourceDir, assetsPath), path13.join(tempRoot, "assets"));
     }
     return {
-      assetsDir: fs9.existsSync(path12.join(tempRoot, "assets")) ? path12.join(tempRoot, "assets") : undefined,
+      assetsDir: fs9.existsSync(path13.join(tempRoot, "assets")) ? path13.join(tempRoot, "assets") : undefined,
       blockDir,
       cleanup,
       formatHint,
@@ -7546,7 +7569,7 @@ async function renderCreateBlockExternalTemplate(sourceDir, context, requestedVa
 // ../wp-typia-project-tools/src/runtime/template-source-remote.ts
 import fs10 from "fs";
 import { promises as fsp8 } from "fs";
-import path13 from "path";
+import path14 from "path";
 async function cleanupSeedRootPair(cleanup, seedCleanup) {
   let cleanupError;
   try {
@@ -7567,10 +7590,10 @@ function getDefaultCategoryFromBlockJson(blockJson) {
   return typeof blockJson.category === "string" && blockJson.category.trim().length > 0 ? blockJson.category.trim() : "widgets";
 }
 function readRemoteBlockJson(blockDir) {
-  const sourceRoot = fs10.existsSync(path13.join(blockDir, "src")) ? path13.join(blockDir, "src") : blockDir;
+  const sourceRoot = fs10.existsSync(path14.join(blockDir, "src")) ? path14.join(blockDir, "src") : blockDir;
   for (const candidate of [
-    path13.join(blockDir, "block.json"),
-    path13.join(sourceRoot, "block.json")
+    path14.join(blockDir, "block.json"),
+    path14.join(sourceRoot, "block.json")
   ]) {
     if (fs10.existsSync(candidate)) {
       return JSON.parse(fs10.readFileSync(candidate, "utf8"));
@@ -7588,8 +7611,8 @@ function getDefaultCategory(sourceDir) {
 }
 function readTemplatePackageJson(sourceDir) {
   for (const candidate of [
-    path13.join(sourceDir, "package.json.mustache"),
-    path13.join(sourceDir, "package.json")
+    path14.join(sourceDir, "package.json.mustache"),
+    path14.join(sourceDir, "package.json")
   ]) {
     if (!fs10.existsSync(candidate)) {
       continue;
@@ -7626,16 +7649,16 @@ function getTemplateProjectType(sourceDir) {
 }
 async function normalizeWpTypiaTemplateSeed(seed) {
   const { path: tempRoot, cleanup } = await createManagedTempRoot("wp-typia-template-source-");
-  const normalizedDir = path13.join(tempRoot, "template");
+  const normalizedDir = path14.join(tempRoot, "template");
   try {
     await copyRawDirectory(seed.blockDir, normalizedDir, {
       filter: (sourcePath, _targetPath, entry) => {
-        const mustacheVariantPath = path13.join(path13.dirname(sourcePath), `${entry.name}.mustache`);
+        const mustacheVariantPath = path14.join(path14.dirname(sourcePath), `${entry.name}.mustache`);
         return !(entry.isFile() && (entry.name === "package.json" || entry.name === "README.md") && fs10.existsSync(mustacheVariantPath));
       }
     });
     if (seed.assetsDir && fs10.existsSync(seed.assetsDir)) {
-      await fsp8.cp(seed.assetsDir, path13.join(normalizedDir, "assets"), {
+      await fsp8.cp(seed.assetsDir, path14.join(normalizedDir, "assets"), {
         recursive: true,
         force: true
       });
@@ -7724,21 +7747,21 @@ function buildRemoteBlockJsonTemplate(blockJson) {
 }
 async function rewriteBlockJsonImports(directory) {
   const textExtensions = new Set([".js", ".jsx", ".ts", ".tsx"]);
-  const targetBlockJsonPath = path13.join(directory, "block.json");
+  const targetBlockJsonPath = path14.join(directory, "block.json");
   async function visit(currentPath) {
     const stats = await fsp8.stat(currentPath);
     if (stats.isDirectory()) {
       const entries = await fsp8.readdir(currentPath);
       for (const entry of entries) {
-        await visit(path13.join(currentPath, entry));
+        await visit(path14.join(currentPath, entry));
       }
       return;
     }
-    if (!textExtensions.has(path13.extname(currentPath))) {
+    if (!textExtensions.has(path14.extname(currentPath))) {
       return;
     }
     const content = await fsp8.readFile(currentPath, "utf8");
-    const relativeSpecifier = path13.relative(path13.dirname(currentPath), targetBlockJsonPath).replace(/\\/g, "/");
+    const relativeSpecifier = path14.relative(path14.dirname(currentPath), targetBlockJsonPath).replace(/\\/g, "/");
     const normalizedSpecifier = relativeSpecifier.startsWith(".") ? relativeSpecifier : `./${relativeSpecifier}`;
     const next = content.replace(/(['"])\.{1,2}\/[^'"]*block\.json\1/g, `$1${normalizedSpecifier}$1`);
     if (next !== content) {
@@ -7748,7 +7771,7 @@ async function rewriteBlockJsonImports(directory) {
   await visit(directory);
 }
 async function patchRemotePackageJson(templateDir, needsInteractivity) {
-  const packageJsonPath = path13.join(templateDir, "package.json.mustache");
+  const packageJsonPath = path14.join(templateDir, "package.json.mustache");
   const packageJson = JSON.parse(await fsp8.readFile(packageJsonPath, "utf8"));
   const existingDependencies = { ...packageJson.dependencies ?? {} };
   const existingDevDependencies = { ...packageJson.devDependencies ?? {} };
@@ -7773,12 +7796,12 @@ async function patchRemotePackageJson(templateDir, needsInteractivity) {
 `, "utf8");
 }
 function getSeedSourceRoot(blockDir) {
-  return fs10.existsSync(path13.join(blockDir, "src")) ? path13.join(blockDir, "src") : blockDir;
+  return fs10.existsSync(path14.join(blockDir, "src")) ? path14.join(blockDir, "src") : blockDir;
 }
 function findSeedRenderPhp(seed) {
   for (const candidate of [
-    path13.join(seed.blockDir, "render.php"),
-    path13.join(seed.rootDir, "render.php")
+    path14.join(seed.blockDir, "render.php"),
+    path14.join(seed.rootDir, "render.php")
   ]) {
     if (fs10.existsSync(candidate)) {
       return candidate;
@@ -7819,13 +7842,13 @@ async function removeSeedEntryConflicts(templateDir) {
     "view.ts",
     "view.tsx"
   ]) {
-    await fsp8.rm(path13.join(templateDir, "src", filename), { force: true });
+    await fsp8.rm(path14.join(templateDir, "src", filename), { force: true });
   }
 }
 async function normalizeCreateBlockSubset(seed, context) {
   const { path: tempRoot, cleanup } = await createManagedTempRoot("wp-typia-remote-template-");
   try {
-    const templateDir = path13.join(tempRoot, "template");
+    const templateDir = path14.join(tempRoot, "template");
     const blockJson = readRemoteBlockJson(seed.blockDir);
     const sourceRoot = getSeedSourceRoot(seed.blockDir);
     await fsp8.mkdir(templateDir, { recursive: true });
@@ -7842,24 +7865,24 @@ async function normalizeCreateBlockSubset(seed, context) {
       });
     }
     await removeSeedEntryConflicts(templateDir);
-    await fsp8.cp(sourceRoot, path13.join(templateDir, "src"), {
+    await fsp8.cp(sourceRoot, path14.join(templateDir, "src"), {
       recursive: true,
       force: true
     });
     const remoteRenderPath = findSeedRenderPhp(seed);
     if (remoteRenderPath) {
-      await fsp8.copyFile(remoteRenderPath, path13.join(templateDir, "render.php"));
+      await fsp8.copyFile(remoteRenderPath, path14.join(templateDir, "render.php"));
     }
     if (seed.assetsDir && fs10.existsSync(seed.assetsDir)) {
-      await fsp8.cp(seed.assetsDir, path13.join(templateDir, "assets"), {
+      await fsp8.cp(seed.assetsDir, path14.join(templateDir, "assets"), {
         recursive: true,
         force: true
       });
     }
-    await fsp8.writeFile(path13.join(templateDir, "src", "types.ts"), buildRemoteTypesSource(blockJson, context), "utf8");
-    await fsp8.writeFile(path13.join(templateDir, "src", "block.json"), buildRemoteBlockJsonTemplate(blockJson), "utf8");
-    await rewriteBlockJsonImports(path13.join(templateDir, "src"));
-    const needsInteractivity = typeof blockJson.viewScriptModule === "string" || typeof blockJson.viewScript === "string" || fs10.existsSync(path13.join(templateDir, "src", "view.js")) || fs10.existsSync(path13.join(templateDir, "src", "view.ts")) || fs10.existsSync(path13.join(templateDir, "src", "view.tsx")) || fs10.existsSync(path13.join(templateDir, "src", "interactivity.js")) || fs10.existsSync(path13.join(templateDir, "src", "interactivity.ts"));
+    await fsp8.writeFile(path14.join(templateDir, "src", "types.ts"), buildRemoteTypesSource(blockJson, context), "utf8");
+    await fsp8.writeFile(path14.join(templateDir, "src", "block.json"), buildRemoteBlockJsonTemplate(blockJson), "utf8");
+    await rewriteBlockJsonImports(path14.join(templateDir, "src"));
+    const needsInteractivity = typeof blockJson.viewScriptModule === "string" || typeof blockJson.viewScript === "string" || fs10.existsSync(path14.join(templateDir, "src", "view.js")) || fs10.existsSync(path14.join(templateDir, "src", "view.ts")) || fs10.existsSync(path14.join(templateDir, "src", "view.tsx")) || fs10.existsSync(path14.join(templateDir, "src", "interactivity.js")) || fs10.existsSync(path14.join(templateDir, "src", "interactivity.ts"));
     await patchRemotePackageJson(templateDir, needsInteractivity);
     return {
       id: "remote:create-block-subset",
@@ -7909,7 +7932,7 @@ function getTemplateVariableContext(variables) {
   };
 }
 async function detectTemplateSourceFormat(sourceDir) {
-  if (fs11.existsSync(path14.join(sourceDir, "package.json.mustache"))) {
+  if (fs11.existsSync(path15.join(sourceDir, "package.json.mustache"))) {
     return "wp-typia";
   }
   if (await loadExternalTemplateLayerManifest(sourceDir)) {
@@ -7921,15 +7944,15 @@ async function detectTemplateSourceFormat(sourceDir) {
   if (getTemplateProjectType(sourceDir) !== null) {
     return "wp-typia";
   }
-  const sourceRoot = fs11.existsSync(path14.join(sourceDir, "src")) ? path14.join(sourceDir, "src") : sourceDir;
+  const sourceRoot = fs11.existsSync(path15.join(sourceDir, "src")) ? path15.join(sourceDir, "src") : sourceDir;
   const blockJsonCandidates = [
-    path14.join(sourceDir, "block.json"),
-    path14.join(sourceRoot, "block.json")
+    path15.join(sourceDir, "block.json"),
+    path15.join(sourceRoot, "block.json")
   ];
   const hasBlockJson = blockJsonCandidates.some((candidate) => fs11.existsSync(candidate));
-  const hasIndexFile = ["index.js", "index.jsx", "index.ts", "index.tsx"].some((filename) => fs11.existsSync(path14.join(sourceRoot, filename)));
-  const hasEditFile = ["edit.js", "edit.jsx", "edit.ts", "edit.tsx"].some((filename) => fs11.existsSync(path14.join(sourceRoot, filename)));
-  const hasSaveFile = ["save.js", "save.jsx", "save.ts", "save.tsx"].some((filename) => fs11.existsSync(path14.join(sourceRoot, filename)));
+  const hasIndexFile = ["index.js", "index.jsx", "index.ts", "index.tsx"].some((filename) => fs11.existsSync(path15.join(sourceRoot, filename)));
+  const hasEditFile = ["edit.js", "edit.jsx", "edit.ts", "edit.tsx"].some((filename) => fs11.existsSync(path15.join(sourceRoot, filename)));
+  const hasSaveFile = ["save.js", "save.jsx", "save.ts", "save.tsx"].some((filename) => fs11.existsSync(path15.join(sourceRoot, filename)));
   if (hasBlockJson && hasIndexFile && hasEditFile && hasSaveFile) {
     return "create-block-subset";
   }
@@ -7941,7 +7964,7 @@ var import_semver = __toESM(require_semver2(), 1);
 import fs13 from "fs";
 import { promises as fsp9 } from "fs";
 import { createRequire as createRequire2 } from "module";
-import path15 from "path";
+import path16 from "path";
 import { spawnSync } from "child_process";
 
 // ../../node_modules/.bun/tar@7.5.13/node_modules/tar/dist/esm/index.min.js
@@ -11092,6 +11115,17 @@ var So = (s3) => {
 };
 
 // ../wp-typia-project-tools/src/runtime/template-source-seeds.ts
+var USER_FACING_TEMPLATE_IDS2 = [
+  ...TEMPLATE_IDS,
+  OFFICIAL_WORKSPACE_TEMPLATE_ALIAS
+];
+function getUnknownNpmTemplateMessage(templateId) {
+  return [
+    `Unknown template "${templateId}". Expected one of: ${USER_FACING_TEMPLATE_IDS2.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"] : {};
   const versions = isPlainObject(metadata.versions) ? metadata.versions : {};
@@ -11130,6 +11164,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, {
@@ -11154,8 +11191,8 @@ async function fetchNpmTemplateSource(locator) {
     if (!tarballResponse.ok) {
       throw new Error(`Failed to download npm template tarball for ${locator.raw}: ${tarballResponse.status}`);
     }
-    const tarballPath = path15.join(tempRoot, "template.tgz");
-    const unpackDir = path15.join(tempRoot, "source");
+    const tarballPath = path16.join(tempRoot, "template.tgz");
+    const unpackDir = path16.join(tempRoot, "source");
     await fsp9.mkdir(unpackDir, { recursive: true });
     await fsp9.writeFile(tarballPath, await readBufferResponseWithLimit(tarballResponse, {
       label: `npm template tarball for ${locator.raw}@${resolvedVersion}`,
@@ -11181,7 +11218,7 @@ function resolveInstalledNpmTemplateSource(locator, cwd) {
   if (locator.rawSpec !== "" && locator.rawSpec !== "*") {
     return null;
   }
-  const workspacePackagesRoot = path15.resolve(PROJECT_TOOLS_PACKAGE_ROOT, "..");
+  const workspacePackagesRoot = path16.resolve(PROJECT_TOOLS_PACKAGE_ROOT, "..");
   if (fs13.existsSync(workspacePackagesRoot)) {
     for (const entry of fs13.readdirSync(workspacePackagesRoot, {
       withFileTypes: true
@@ -11189,8 +11226,8 @@ function resolveInstalledNpmTemplateSource(locator, cwd) {
       if (!entry.isDirectory()) {
         continue;
       }
-      const packageDir = path15.join(workspacePackagesRoot, entry.name);
-      const packageJsonPath = path15.join(packageDir, "package.json");
+      const packageDir = path16.join(workspacePackagesRoot, entry.name);
+      const packageJsonPath = path16.join(packageDir, "package.json");
       if (!fs13.existsSync(packageJsonPath)) {
         continue;
       }
@@ -11203,10 +11240,10 @@ function resolveInstalledNpmTemplateSource(locator, cwd) {
       }
     }
   }
-  const workspaceRequire = createRequire2(path15.join(path15.resolve(cwd), "__wp_typia_template_resolver__.cjs"));
+  const workspaceRequire = createRequire2(path16.join(path16.resolve(cwd), "__wp_typia_template_resolver__.cjs"));
   try {
     const packageJsonPath = fs13.realpathSync(workspaceRequire.resolve(`${locator.name}/package.json`));
-    const sourceDir = path15.dirname(packageJsonPath);
+    const sourceDir = path16.dirname(packageJsonPath);
     return {
       blockDir: sourceDir,
       rootDir: sourceDir
@@ -11215,11 +11252,11 @@ function resolveInstalledNpmTemplateSource(locator, cwd) {
     const errorCode = typeof error === "object" && error !== null && "code" in error ? String(error.code) : "";
     if (errorCode === "MODULE_NOT_FOUND" || errorCode === "ERR_PACKAGE_PATH_NOT_EXPORTED") {
       for (const basePath of workspaceRequire.resolve.paths(locator.name) ?? []) {
-        const packageJsonPath = path15.join(basePath, locator.name, "package.json");
+        const packageJsonPath = path16.join(basePath, locator.name, "package.json");
         if (!fs13.existsSync(packageJsonPath)) {
           continue;
         }
-        const sourceDir = path15.dirname(fs13.realpathSync(packageJsonPath));
+        const sourceDir = path16.dirname(fs13.realpathSync(packageJsonPath));
         return {
           blockDir: sourceDir,
           rootDir: sourceDir
@@ -11231,7 +11268,7 @@ function resolveInstalledNpmTemplateSource(locator, cwd) {
   }
 }
 function isOfficialWorkspaceTemplateSeed(seed) {
-  const packageJsonPath = path15.join(seed.rootDir, "package.json");
+  const packageJsonPath = path16.join(seed.rootDir, "package.json");
   if (!fs13.existsSync(packageJsonPath)) {
     return false;
   }
@@ -11251,12 +11288,12 @@ async function assertNoSymlinks2(sourceDir) {
     return;
   }
   for (const entry of await fsp9.readdir(sourceDir)) {
-    await assertNoSymlinks2(path15.join(sourceDir, entry));
+    await assertNoSymlinks2(path16.join(sourceDir, entry));
   }
 }
 async function resolveGitHubTemplateSource(locator) {
   const { path: remoteRoot, cleanup } = await createManagedTempRoot("wp-typia-template-source-");
-  const checkoutDir = path15.join(remoteRoot, "source");
+  const checkoutDir = path16.join(remoteRoot, "source");
   try {
     const args = ["clone", "--depth", "1"];
     if (locator.ref) {
@@ -11281,9 +11318,9 @@ async function resolveGitHubTemplateSource(locator) {
     if (cloneResult.status !== 0) {
       throw new Error(`Failed to clone GitHub template source ${locator.owner}/${locator.repo}.`);
     }
-    const sourceDir = path15.resolve(checkoutDir, locator.sourcePath);
-    const relativeSourceDir = path15.relative(checkoutDir, sourceDir);
-    if (relativeSourceDir.startsWith("..") || path15.isAbsolute(relativeSourceDir)) {
+    const sourceDir = path16.resolve(checkoutDir, locator.sourcePath);
+    const relativeSourceDir = path16.relative(checkoutDir, sourceDir);
+    if (relativeSourceDir.startsWith("..") || path16.isAbsolute(relativeSourceDir)) {
       throw new Error("GitHub template path must stay within the cloned repository.");
     }
     if (!fs13.existsSync(sourceDir)) {
@@ -11302,7 +11339,7 @@ async function resolveGitHubTemplateSource(locator) {
 }
 async function resolveTemplateSeed(locator, cwd) {
   if (locator.kind === "path") {
-    const sourceDir = path15.resolve(cwd, locator.templatePath);
+    const sourceDir = path16.resolve(cwd, locator.templatePath);
     if (!fs13.existsSync(sourceDir)) {
       throw new Error(`Template path does not exist: ${sourceDir}`);
     }
@@ -16468,7 +16505,7 @@ async function scaffoldProject({
     phase: "finalize-project",
     title: "Finalizing scaffold output"
   });
-  const readmePath = path16.join(projectDir, "README.md");
+  const readmePath = path17.join(projectDir, "README.md");
   if (!fs14.existsSync(readmePath)) {
     await fsp10.writeFile(readmePath, buildReadme(resolvedTemplateId, variables, resolvedPackageManager, {
       withMigrationUi: isBuiltInTemplate || isWorkspace ? withMigrationUi : false,
@@ -16476,7 +16513,7 @@ async function scaffoldProject({
       withWpEnv: isBuiltInTemplate ? withWpEnv : false
     }), "utf8");
   }
-  const gitignorePath = path16.join(projectDir, ".gitignore");
+  const gitignorePath = path17.join(projectDir, ".gitignore");
   const existingGitignore = fs14.existsSync(gitignorePath) ? await fsp10.readFile(gitignorePath, "utf8") : "";
   await fsp10.writeFile(gitignorePath, mergeTextLines(buildGitignore(), existingGitignore), "utf8");
   await normalizePackageJson(projectDir, resolvedPackageManager);
@@ -16559,4 +16596,4 @@ async function resolveOptionalInteractiveExternalLayerId({
 
 export { syncPersistenceRestArtifacts, copyInterpolatedDirectory, listInterpolatedDirectoryOutputs, getPrimaryDevelopmentScript, getOptionalOnboardingSteps, getOptionalOnboardingNote, getOptionalOnboardingShortNote, formatNonEmptyTargetDirectoryError, require_semver2 as require_semver, parseTemplateLocator, resolveExternalTemplateLayers, resolveTemplateSeed, normalizeOptionalCliString, resolveLocalCliPathOption, assertExternalLayerCompositionOptions, assertBuiltInTemplateVariantAllowed, parseAlternateRenderTargets, parseCompoundInnerBlocksPreset, OPTIONAL_WORDPRESS_AI_CLIENT_COMPATIBILITY, REQUIRED_WORKSPACE_ABILITY_COMPATIBILITY, resolveScaffoldCompatibilityPolicy, renderScaffoldCompatibilityConfig, updatePluginHeaderCompatibility, getDefaultAnswers, resolveTemplateId, resolvePackageManagerId, collectScaffoldAnswers, DATA_STORAGE_MODES, PERSISTENCE_POLICIES, isDataStorageMode, isPersistencePolicy, scaffoldProject, resolveOptionalInteractiveExternalLayerId };
 
-//# debugId=45408AA53A2AA42964756E2164756E21
+//# debugId=8415ABFCC6733BCA64756E2164756E21