wp-typia 0.20.4 → 0.21.0

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

@@ -1,10 +1,10 @@
 // @bun
 import {
   getPackageVersions
-} from "./cli-tesygdnr.js";
+} from "./cli-syg9qpxw.js";
 import {
   seedProjectMigrations
-} from "./cli-2rev5hqm.js";
+} from "./cli-jfj54qej.js";
 import {
   ensureMigrationDirectories,
   isPlainObject,
@@ -59,10 +59,14 @@ import {
   toTitleCase,
   validateBlockSlug,
   validateNamespace
-} from "./cli-3w3qxq9w.js";
+} from "./cli-hx88xwr4.js";
 import {
   createManagedTempRoot
 } from "./cli-t73q5aqz.js";
+import {
+  CLI_DIAGNOSTIC_CODES,
+  createCliDiagnosticCodeError
+} from "./cli-p95wr1q8.js";
 import {
   __commonJS,
   __require,
@@ -695,13 +699,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 +718,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 +744,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 +768,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 +792,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 +828,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 +1009,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 +1103,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 +1139,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 +3203,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 +3459,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 +3478,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)}`;
@@ -5803,13 +5807,13 @@ function resolveLocalCliPathOption(options) {
   }
   const resolvedPath = path5.resolve(options.cwd, normalizedValue);
   if (!fs3.existsSync(resolvedPath)) {
-    throw new Error(`\`${options.label}\` path does not exist: ${resolvedPath}. Check the path relative to ${options.cwd}.`);
+    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.INVALID_ARGUMENT, `\`${options.label}\` path does not exist: ${resolvedPath}. Check the path relative to ${options.cwd}.`);
   }
   return resolvedPath;
 }
 function assertExternalLayerCompositionOptions(options) {
   if (options.externalLayerId && !options.externalLayerSource) {
-    throw new Error("externalLayerId requires externalLayerSource when composing built-in template layers.");
+    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.INVALID_ARGUMENT, "externalLayerId requires externalLayerSource when composing built-in template layers.");
   }
 }
 function createBuiltInVariantErrorMessage(options) {
@@ -5819,7 +5823,7 @@ function assertBuiltInTemplateVariantAllowed(options) {
   if (!options.variant) {
     return;
   }
-  throw new Error(createBuiltInVariantErrorMessage({
+  throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.INVALID_ARGUMENT, createBuiltInVariantErrorMessage({
     templateId: options.templateId,
     variant: options.variant
   }));
@@ -5916,6 +5920,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 +5993,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", {
@@ -5966,15 +6040,21 @@ function normalizeQueryPostType(value) {
   }
   const validationResult = validateQueryPostType(value);
   if (validationResult !== true) {
-    throw new Error(validationResult);
+    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.INVALID_ARGUMENT, validationResult);
   }
   return value.trim().toLowerCase();
 }
 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 +6073,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 +6096,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,
@@ -6025,7 +6112,7 @@ async function resolveTemplateId({
   if (templateId) {
     const normalizedTemplateId = normalizeTemplateSelection(templateId);
     if (isRemovedBuiltInTemplateId(templateId)) {
-      throw new Error(getRemovedBuiltInTemplateMessage(templateId));
+      throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.UNKNOWN_TEMPLATE, getRemovedBuiltInTemplateMessage(templateId));
     }
     if (normalizedTemplateId === OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE) {
       return normalizedTemplateId;
@@ -6035,7 +6122,10 @@ async function resolveTemplateId({
     }
     const mistypedBuiltInTemplateMessage = getMistypedBuiltInTemplateMessage(templateId);
     if (mistypedBuiltInTemplateMessage) {
-      throw new Error(mistypedBuiltInTemplateMessage);
+      throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.UNKNOWN_TEMPLATE, mistypedBuiltInTemplateMessage);
+    }
+    if (!looksLikeExplicitExternalTemplateLocator(normalizedTemplateId)) {
+      throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.UNKNOWN_TEMPLATE, getUnknownTemplateMessage(templateId));
     }
     return normalizedTemplateId;
   }
@@ -6043,7 +6133,7 @@ async function resolveTemplateId({
     return "basic";
   }
   if (!isInteractive || !selectTemplate) {
-    throw new Error(`Template is required in non-interactive mode. Use ${TEMPLATE_SELECTION_HINT}.`);
+    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, `Template is required in non-interactive mode. Use ${TEMPLATE_SELECTION_HINT}.`);
   }
   return normalizeTemplateSelection(await selectTemplate());
 }
@@ -6060,7 +6150,7 @@ async function resolvePackageManagerId({
     return "npm";
   }
   if (!isInteractive || !selectPackageManager) {
-    throw new Error(`Package manager is required in non-interactive mode. Use --package-manager <${PACKAGE_MANAGER_IDS.join("|")}>.`);
+    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, `Package manager is required in non-interactive mode. Use --package-manager <${PACKAGE_MANAGER_IDS.join("|")}>.`);
   }
   return selectPackageManager();
 }
@@ -6077,7 +6167,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,
@@ -6118,25 +6208,25 @@ 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 fs15 from "fs";
+import { promises as fsp11 } from "fs";
+import path18 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 +6300,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 +6322,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 +6395,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 +6639,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 +6647,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 +6656,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 +6684,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({
@@ -6606,11 +6696,10 @@ async function defaultInstallDependencies({
     stdio: "inherit"
   });
 }
-
 // ../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 +6765,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 +6794,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 +6820,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 +6879,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 +6887,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 +6909,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 +6920,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 +6950,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 +7032,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 +7040,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 +7072,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 +7099,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 +7128,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 +7265,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 +7409,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 +7540,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 +7572,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 +7593,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 +7614,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 +7652,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 +7750,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 +7774,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 +7799,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 +7845,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 +7868,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 +7935,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 +7947,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";
   }
@@ -7938,10 +7964,10 @@ async function detectTemplateSourceFormat(sourceDir) {
 
 // ../wp-typia-project-tools/src/runtime/template-source-seeds.ts
 var import_semver = __toESM(require_semver2(), 1);
-import fs13 from "fs";
-import { promises as fsp9 } from "fs";
+import fs14 from "fs";
+import { promises as fsp10 } from "fs";
 import { createRequire as createRequire2 } from "module";
-import path15 from "path";
+import path17 from "path";
 import { spawnSync } from "child_process";
 
 // ../../node_modules/.bun/tar@7.5.13/node_modules/tar/dist/esm/index.min.js
@@ -11091,7 +11117,386 @@ var So = (s3) => {
   s3.mtimeCache || (s3.mtimeCache = new Map), s3.filter = t ? (e, i) => t(e, i) && !((s3.mtimeCache?.get(e) ?? i.mtime ?? 0) > (i.mtime ?? 0)) : (e, i) => !((s3.mtimeCache?.get(e) ?? i.mtime ?? 0) > (i.mtime ?? 0));
 };
 
+// ../wp-typia-project-tools/src/runtime/template-source-cache.ts
+import { createHash } from "crypto";
+import fs13 from "fs";
+import { promises as fsp9 } from "fs";
+import os2 from "os";
+import path16 from "path";
+var EXTERNAL_TEMPLATE_CACHE_ENV = "WP_TYPIA_EXTERNAL_TEMPLATE_CACHE";
+var EXTERNAL_TEMPLATE_CACHE_DIR_ENV = "WP_TYPIA_EXTERNAL_TEMPLATE_CACHE_DIR";
+var CACHE_MARKER_FILE = "wp-typia-template-cache.json";
+var PRIVATE_CACHE_DIRECTORY_MODE = 448;
+var REDACTED_CACHE_METADATA_VALUE = "[redacted]";
+var DISABLED_CACHE_VALUES = new Set(["0", "false", "no", "off"]);
+var CACHE_PUBLISH_RACE_ERROR_CODES = new Set(["EEXIST", "ENOTEMPTY"]);
+var CACHE_UNAVAILABLE_ERROR_CODES = new Set([
+  "EACCES",
+  "ENOSPC",
+  "ENOTDIR",
+  "EPERM",
+  "EROFS"
+]);
+var URL_LIKE_METADATA_KEY = /(url|uri|registry|tarball)/iu;
+var SAFE_CACHE_NAMESPACE_SEGMENT = /^[A-Za-z0-9_.-]+$/u;
+function isExternalTemplateCacheEnabled(env = process.env) {
+  const rawValue2 = env[EXTERNAL_TEMPLATE_CACHE_ENV];
+  if (rawValue2 === undefined) {
+    return true;
+  }
+  return !DISABLED_CACHE_VALUES.has(rawValue2.trim().toLowerCase());
+}
+function getExternalTemplateCacheRoot(env = process.env) {
+  const configuredCacheDir = env[EXTERNAL_TEMPLATE_CACHE_DIR_ENV]?.trim();
+  if (configuredCacheDir) {
+    return path16.resolve(configuredCacheDir);
+  }
+  return path16.join(os2.tmpdir(), `wp-typia-template-source-cache-${getCurrentUserCacheSegment()}`);
+}
+function createExternalTemplateCacheKey(keyParts) {
+  return createHash("sha256").update(JSON.stringify(keyParts)).digest("hex");
+}
+async function pathExists(filePath) {
+  try {
+    await fsp9.access(filePath, fs13.constants.F_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function isDirectoryPath(directory) {
+  try {
+    const stats = await fsp9.lstat(directory);
+    return stats.isDirectory() && !stats.isSymbolicLink();
+  } catch {
+    return false;
+  }
+}
+function getNodeErrorCode(error) {
+  return typeof error === "object" && error !== null && "code" in error ? String(error.code) : "";
+}
+async function removeTemporaryCacheEntry(entryDir) {
+  try {
+    await fsp9.rm(entryDir, { force: true, recursive: true });
+  } catch {}
+}
+function getCurrentUserCacheSegment() {
+  if (typeof process.getuid === "function") {
+    return String(process.getuid());
+  }
+  try {
+    const safeUsername = os2.userInfo().username.trim().replace(/[^A-Za-z0-9._-]+/gu, "-");
+    return safeUsername.length > 0 ? safeUsername : "user";
+  } catch {
+    return "user";
+  }
+}
+function getCurrentUid() {
+  return typeof process.getuid === "function" ? process.getuid() : null;
+}
+async function isPrivateCacheDirectory(directory) {
+  try {
+    const stats = await fsp9.lstat(directory);
+    if (!stats.isDirectory() || stats.isSymbolicLink()) {
+      return false;
+    }
+    const currentUid = getCurrentUid();
+    if (currentUid !== null && stats.uid !== currentUid) {
+      return false;
+    }
+    if (process.platform !== "win32" && (stats.mode & 63) !== 0) {
+      return false;
+    }
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function ensurePrivateCacheDirectory(directory) {
+  try {
+    await fsp9.mkdir(directory, {
+      mode: PRIVATE_CACHE_DIRECTORY_MODE,
+      recursive: true
+    });
+    const stats = await fsp9.lstat(directory);
+    if (!stats.isDirectory() || stats.isSymbolicLink()) {
+      return false;
+    }
+    const currentUid = getCurrentUid();
+    if (currentUid !== null && stats.uid !== currentUid) {
+      return false;
+    }
+    if (process.platform !== "win32") {
+      if ((stats.mode & 63) !== 0) {
+        await fsp9.chmod(directory, PRIVATE_CACHE_DIRECTORY_MODE);
+      }
+    }
+    return isPrivateCacheDirectory(directory);
+  } catch {
+    return false;
+  }
+}
+function sanitizeCacheMetadataValue(key, value) {
+  if (!URL_LIKE_METADATA_KEY.test(key)) {
+    return value;
+  }
+  try {
+    const url = new URL(value);
+    url.username = "";
+    url.password = "";
+    url.search = "";
+    url.hash = "";
+    return url.toString();
+  } catch {
+    return REDACTED_CACHE_METADATA_VALUE;
+  }
+}
+function sanitizeCacheMetadata(metadata) {
+  return Object.fromEntries(Object.entries(metadata).map(([key, value]) => [
+    key,
+    value === null ? null : sanitizeCacheMetadataValue(key, value)
+  ]));
+}
+function resolveCacheNamespaceDir(cacheRoot, namespace) {
+  if (namespace === "." || namespace === ".." || !SAFE_CACHE_NAMESPACE_SEGMENT.test(namespace)) {
+    return null;
+  }
+  const namespaceDir = path16.join(cacheRoot, namespace);
+  const relativeNamespaceDir = path16.relative(cacheRoot, namespaceDir);
+  if (relativeNamespaceDir.length === 0 || relativeNamespaceDir.startsWith("..") || path16.isAbsolute(relativeNamespaceDir)) {
+    return null;
+  }
+  return namespaceDir;
+}
+function getCacheEntryPaths(descriptor) {
+  const cacheKey = createExternalTemplateCacheKey(descriptor.keyParts);
+  const cacheRoot = getExternalTemplateCacheRoot();
+  const namespaceDir = resolveCacheNamespaceDir(cacheRoot, descriptor.namespace);
+  if (!namespaceDir) {
+    return null;
+  }
+  const entryDir = path16.join(namespaceDir, cacheKey);
+  return {
+    cacheKey,
+    cacheRoot,
+    entryDir,
+    markerPath: path16.join(entryDir, CACHE_MARKER_FILE),
+    namespaceDir,
+    sourceDir: path16.join(entryDir, "source")
+  };
+}
+async function isReusableCacheEntry(entryDir, markerPath, sourceDir) {
+  return await isPrivateCacheDirectory(entryDir) && await pathExists(markerPath) && await isDirectoryPath(sourceDir);
+}
+function parseCacheMarkerMetadata(markerText) {
+  let marker;
+  try {
+    marker = JSON.parse(markerText);
+  } catch {
+    return null;
+  }
+  if (typeof marker !== "object" || marker === null || Array.isArray(marker)) {
+    return null;
+  }
+  const rawMetadata = marker.metadata;
+  if (typeof rawMetadata !== "object" || rawMetadata === null || Array.isArray(rawMetadata)) {
+    return null;
+  }
+  const metadata = {};
+  for (const [key, value] of Object.entries(rawMetadata)) {
+    if (typeof value !== "string" && value !== null) {
+      return null;
+    }
+    metadata[key] = value;
+  }
+  const rawCreatedAt = marker.createdAt;
+  const createdAtMs = typeof rawCreatedAt === "string" ? Date.parse(rawCreatedAt) : 0;
+  return {
+    createdAtMs: Number.isFinite(createdAtMs) ? createdAtMs : 0,
+    metadata
+  };
+}
+function cacheMetadataMatches(actual, expected) {
+  return Object.entries(expected).every(([key, value]) => actual[key] === value);
+}
+async function findReusableExternalTemplateSourceCache(descriptor) {
+  if (!isExternalTemplateCacheEnabled()) {
+    return null;
+  }
+  const cacheRoot = getExternalTemplateCacheRoot();
+  const namespaceDir = resolveCacheNamespaceDir(cacheRoot, descriptor.namespace);
+  if (!namespaceDir) {
+    return null;
+  }
+  if (!await isPrivateCacheDirectory(cacheRoot) || !await isPrivateCacheDirectory(namespaceDir)) {
+    return null;
+  }
+  let entries;
+  try {
+    entries = await fsp9.readdir(namespaceDir, { withFileTypes: true });
+  } catch {
+    return null;
+  }
+  let bestEntry = null;
+  for (const entry of entries) {
+    if (!entry.isDirectory()) {
+      continue;
+    }
+    const entryDir = path16.join(namespaceDir, entry.name);
+    const markerPath = path16.join(entryDir, CACHE_MARKER_FILE);
+    const sourceDir = path16.join(entryDir, "source");
+    if (!await isReusableCacheEntry(entryDir, markerPath, sourceDir)) {
+      continue;
+    }
+    let markerText;
+    try {
+      markerText = await fsp9.readFile(markerPath, "utf8");
+    } catch {
+      continue;
+    }
+    const marker = parseCacheMarkerMetadata(markerText);
+    if (!marker || !cacheMetadataMatches(marker.metadata, descriptor.metadata)) {
+      continue;
+    }
+    if (!bestEntry || marker.createdAtMs > bestEntry.createdAtMs) {
+      bestEntry = {
+        createdAtMs: marker.createdAtMs,
+        sourceDir
+      };
+    }
+  }
+  return bestEntry ? {
+    cacheHit: true,
+    sourceDir: bestEntry.sourceDir
+  } : null;
+}
+async function resolveExternalTemplateSourceCache(descriptor, populateSourceDir) {
+  if (!isExternalTemplateCacheEnabled()) {
+    return null;
+  }
+  const cacheEntryPaths = getCacheEntryPaths(descriptor);
+  if (!cacheEntryPaths) {
+    return null;
+  }
+  const { cacheKey, cacheRoot, entryDir, markerPath, namespaceDir, sourceDir } = cacheEntryPaths;
+  if (!await ensurePrivateCacheDirectory(cacheRoot) || !await ensurePrivateCacheDirectory(namespaceDir)) {
+    return null;
+  }
+  if (await isReusableCacheEntry(entryDir, markerPath, sourceDir)) {
+    return {
+      cacheHit: true,
+      sourceDir
+    };
+  }
+  const temporaryEntryDir = path16.join(namespaceDir, `.tmp-${cacheKey}-${process.pid}-${Date.now()}-${Math.random().toString(16).slice(2)}`);
+  const temporarySourceDir = path16.join(temporaryEntryDir, "source");
+  let populateFailed = false;
+  try {
+    await fsp9.mkdir(temporarySourceDir, {
+      mode: PRIVATE_CACHE_DIRECTORY_MODE,
+      recursive: true
+    });
+    if (process.platform !== "win32") {
+      await fsp9.chmod(temporaryEntryDir, PRIVATE_CACHE_DIRECTORY_MODE);
+    }
+    try {
+      await populateSourceDir(temporarySourceDir);
+    } catch (error) {
+      populateFailed = true;
+      throw error;
+    }
+    await fsp9.writeFile(path16.join(temporaryEntryDir, CACHE_MARKER_FILE), `${JSON.stringify({
+      createdAt: new Date().toISOString(),
+      key: cacheKey,
+      metadata: sanitizeCacheMetadata(descriptor.metadata),
+      namespace: descriptor.namespace
+    }, null, 2)}
+`, "utf8");
+    await fsp9.rename(temporaryEntryDir, entryDir);
+    return {
+      cacheHit: false,
+      sourceDir
+    };
+  } catch (error) {
+    await removeTemporaryCacheEntry(temporaryEntryDir);
+    if (populateFailed) {
+      if (CACHE_UNAVAILABLE_ERROR_CODES.has(getNodeErrorCode(error))) {
+        return null;
+      }
+      throw error;
+    }
+    const errorCode = getNodeErrorCode(error);
+    if (CACHE_PUBLISH_RACE_ERROR_CODES.has(errorCode) && await isReusableCacheEntry(entryDir, markerPath, sourceDir)) {
+      return {
+        cacheHit: true,
+        sourceDir
+      };
+    }
+    if (CACHE_PUBLISH_RACE_ERROR_CODES.has(errorCode) || CACHE_UNAVAILABLE_ERROR_CODES.has(errorCode)) {
+      return null;
+    }
+    throw error;
+  }
+}
+
 // ../wp-typia-project-tools/src/runtime/template-source-seeds.ts
+var USER_FACING_TEMPLATE_IDS2 = [
+  ...TEMPLATE_IDS,
+  OFFICIAL_WORKSPACE_TEMPLATE_ALIAS
+];
+var GITHUB_TEMPLATE_CACHE_REVISION_RACE_CODE = "github-template-cache-revision-race";
+function createGitHubTemplateCacheRevisionRaceError(message) {
+  const error = new Error(message);
+  error.code = GITHUB_TEMPLATE_CACHE_REVISION_RACE_CODE;
+  return error;
+}
+function isGitHubTemplateCacheRevisionRaceError(error) {
+  return typeof error === "object" && error !== null && "code" in error && error.code === GITHUB_TEMPLATE_CACHE_REVISION_RACE_CODE;
+}
+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 readOptionalDistString(dist, key) {
+  const value = dist[key];
+  return typeof value === "string" && value.length > 0 ? value : null;
+}
+function normalizeNpmRegistryCacheKey(registryBase) {
+  try {
+    const url = new URL(registryBase);
+    url.username = "";
+    url.password = "";
+    url.search = "";
+    url.hash = "";
+    return url.toString().replace(/\/$/u, "");
+  } catch {
+    return registryBase;
+  }
+}
+async function downloadNpmTemplateTarball(locator, resolvedVersion, tarballUrl, unpackDir) {
+  const tarballResponse = await fetchWithExternalTemplateTimeout(tarballUrl, {
+    label: `downloading npm template tarball for ${locator.raw}@${resolvedVersion}`
+  });
+  if (!tarballResponse.ok) {
+    throw new Error(`Failed to download npm template tarball for ${locator.raw}: ${tarballResponse.status}`);
+  }
+  const tarballPath = path17.join(path17.dirname(unpackDir), "template.tgz");
+  await fsp10.mkdir(unpackDir, { recursive: true });
+  await fsp10.writeFile(tarballPath, await readBufferResponseWithLimit(tarballResponse, {
+    label: `npm template tarball for ${locator.raw}@${resolvedVersion}`,
+    maxBytes: getExternalTemplateTarballMaxBytes()
+  }));
+  await co({
+    cwd: unpackDir,
+    file: tarballPath,
+    strip: 1
+  });
+  await fsp10.rm(tarballPath, { force: true });
+  await assertNoSymlinks2(unpackDir);
+}
 function selectRegistryVersion(metadata, locator) {
   const distTags = isPlainObject(metadata["dist-tags"]) ? metadata["dist-tags"] : {};
   const versions = isPlainObject(metadata.versions) ? metadata.versions : {};
@@ -11130,6 +11535,9 @@ async function fetchNpmTemplateSource(locator) {
     label: metadataLabel
   });
   if (!metadataResponse.ok) {
+    if (metadataResponse.status === 404) {
+      throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.UNKNOWN_TEMPLATE, getUnknownNpmTemplateMessage(locator.raw));
+    }
     throw new Error(`Failed to fetch npm template metadata for ${locator.raw}: ${metadataResponse.status}`);
   }
   const metadata = await readJsonResponseWithLimit(metadataResponse, {
@@ -11146,27 +11554,43 @@ async function fetchNpmTemplateSource(locator) {
   if (typeof tarballUrl !== "string" || tarballUrl.length === 0) {
     throw new Error(`npm template metadata is missing tarball URL for ${locator.raw}@${resolvedVersion}.`);
   }
+  const tarballIntegrity = readOptionalDistString(versionMetadata.dist, "integrity");
+  const tarballShasum = readOptionalDistString(versionMetadata.dist, "shasum");
+  if (tarballIntegrity || tarballShasum) {
+    const registryCacheKey = normalizeNpmRegistryCacheKey(registryBase);
+    const cachedSource = await resolveExternalTemplateSourceCache({
+      keyParts: [
+        "npm",
+        registryCacheKey,
+        locator.name,
+        locator.raw,
+        resolvedVersion,
+        tarballIntegrity ?? "",
+        tarballShasum ?? ""
+      ],
+      metadata: {
+        integrity: tarballIntegrity,
+        package: locator.name,
+        raw: locator.raw,
+        registry: registryBase,
+        shasum: tarballShasum,
+        tarball: tarballUrl,
+        version: resolvedVersion
+      },
+      namespace: "npm"
+    }, (unpackDir) => downloadNpmTemplateTarball(locator, resolvedVersion, tarballUrl, unpackDir));
+    if (cachedSource) {
+      await assertNoSymlinks2(cachedSource.sourceDir);
+      return {
+        blockDir: cachedSource.sourceDir,
+        rootDir: cachedSource.sourceDir
+      };
+    }
+  }
   const { path: tempRoot, cleanup } = await createManagedTempRoot("wp-typia-template-source-");
   try {
-    const tarballResponse = await fetchWithExternalTemplateTimeout(tarballUrl, {
-      label: `downloading npm template tarball for ${locator.raw}@${resolvedVersion}`
-    });
-    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");
-    await fsp9.mkdir(unpackDir, { recursive: true });
-    await fsp9.writeFile(tarballPath, await readBufferResponseWithLimit(tarballResponse, {
-      label: `npm template tarball for ${locator.raw}@${resolvedVersion}`,
-      maxBytes: getExternalTemplateTarballMaxBytes()
-    }));
-    await co({
-      cwd: unpackDir,
-      file: tarballPath,
-      strip: 1
-    });
-    await assertNoSymlinks2(unpackDir);
+    const unpackDir = path17.join(tempRoot, "source");
+    await downloadNpmTemplateTarball(locator, resolvedVersion, tarballUrl, unpackDir);
     return {
       blockDir: unpackDir,
       cleanup,
@@ -11181,20 +11605,20 @@ function resolveInstalledNpmTemplateSource(locator, cwd) {
   if (locator.rawSpec !== "" && locator.rawSpec !== "*") {
     return null;
   }
-  const workspacePackagesRoot = path15.resolve(PROJECT_TOOLS_PACKAGE_ROOT, "..");
-  if (fs13.existsSync(workspacePackagesRoot)) {
-    for (const entry of fs13.readdirSync(workspacePackagesRoot, {
+  const workspacePackagesRoot = path17.resolve(PROJECT_TOOLS_PACKAGE_ROOT, "..");
+  if (fs14.existsSync(workspacePackagesRoot)) {
+    for (const entry of fs14.readdirSync(workspacePackagesRoot, {
       withFileTypes: true
     })) {
       if (!entry.isDirectory()) {
         continue;
       }
-      const packageDir = path15.join(workspacePackagesRoot, entry.name);
-      const packageJsonPath = path15.join(packageDir, "package.json");
-      if (!fs13.existsSync(packageJsonPath)) {
+      const packageDir = path17.join(workspacePackagesRoot, entry.name);
+      const packageJsonPath = path17.join(packageDir, "package.json");
+      if (!fs14.existsSync(packageJsonPath)) {
         continue;
       }
-      const manifest = JSON.parse(fs13.readFileSync(packageJsonPath, "utf8"));
+      const manifest = JSON.parse(fs14.readFileSync(packageJsonPath, "utf8"));
       if (manifest.name === locator.name) {
         return {
           blockDir: packageDir,
@@ -11203,10 +11627,10 @@ function resolveInstalledNpmTemplateSource(locator, cwd) {
       }
     }
   }
-  const workspaceRequire = createRequire2(path15.join(path15.resolve(cwd), "__wp_typia_template_resolver__.cjs"));
+  const workspaceRequire = createRequire2(path17.join(path17.resolve(cwd), "__wp_typia_template_resolver__.cjs"));
   try {
-    const packageJsonPath = fs13.realpathSync(workspaceRequire.resolve(`${locator.name}/package.json`));
-    const sourceDir = path15.dirname(packageJsonPath);
+    const packageJsonPath = fs14.realpathSync(workspaceRequire.resolve(`${locator.name}/package.json`));
+    const sourceDir = path17.dirname(packageJsonPath);
     return {
       blockDir: sourceDir,
       rootDir: sourceDir
@@ -11215,11 +11639,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");
-        if (!fs13.existsSync(packageJsonPath)) {
+        const packageJsonPath = path17.join(basePath, locator.name, "package.json");
+        if (!fs14.existsSync(packageJsonPath)) {
           continue;
         }
-        const sourceDir = path15.dirname(fs13.realpathSync(packageJsonPath));
+        const sourceDir = path17.dirname(fs14.realpathSync(packageJsonPath));
         return {
           blockDir: sourceDir,
           rootDir: sourceDir
@@ -11231,64 +11655,250 @@ function resolveInstalledNpmTemplateSource(locator, cwd) {
   }
 }
 function isOfficialWorkspaceTemplateSeed(seed) {
-  const packageJsonPath = path15.join(seed.rootDir, "package.json");
-  if (!fs13.existsSync(packageJsonPath)) {
+  const packageJsonPath = path17.join(seed.rootDir, "package.json");
+  if (!fs14.existsSync(packageJsonPath)) {
     return false;
   }
   try {
-    const packageJson = JSON.parse(fs13.readFileSync(packageJsonPath, "utf8"));
+    const packageJson = JSON.parse(fs14.readFileSync(packageJsonPath, "utf8"));
     return packageJson.name === OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE;
   } catch {
     return false;
   }
 }
 async function assertNoSymlinks2(sourceDir) {
-  const stats = await fsp9.lstat(sourceDir);
+  const stats = await fsp10.lstat(sourceDir);
   if (stats.isSymbolicLink()) {
     throw new Error(`Template sources may not include symbolic links: ${sourceDir}`);
   }
   if (!stats.isDirectory()) {
     return;
   }
-  for (const entry of await fsp9.readdir(sourceDir)) {
-    await assertNoSymlinks2(path15.join(sourceDir, entry));
+  for (const entry of await fsp10.readdir(sourceDir)) {
+    await assertNoSymlinks2(path17.join(sourceDir, entry));
   }
 }
-async function resolveGitHubTemplateSource(locator) {
-  const { path: remoteRoot, cleanup } = await createManagedTempRoot("wp-typia-template-source-");
-  const checkoutDir = path15.join(remoteRoot, "source");
-  try {
-    const args = ["clone", "--depth", "1"];
-    if (locator.ref) {
-      args.push("--branch", locator.ref);
-    }
-    args.push(`https://github.com/${locator.owner}/${locator.repo}.git`, checkoutDir);
-    const cloneTimeoutMs = getExternalTemplateTimeoutMs();
-    const cloneResult = spawnSync("git", args, {
-      stdio: "ignore",
-      timeout: cloneTimeoutMs
-    });
-    if (cloneResult.error) {
-      const errorCode = typeof cloneResult.error === "object" && cloneResult.error !== null && "code" in cloneResult.error ? String(cloneResult.error.code) : "";
-      if (errorCode === "ETIMEDOUT") {
-        throw createExternalTemplateTimeoutError(`cloning GitHub template ${locator.owner}/${locator.repo}`, cloneTimeoutMs);
-      }
-      throw cloneResult.error;
+function runGitTemplateCommand(args, label, options = {}) {
+  const timeoutMs = getExternalTemplateTimeoutMs();
+  const result = options.captureOutput ? spawnSync("git", args, {
+    encoding: "utf8",
+    stdio: ["ignore", "pipe", "pipe"],
+    timeout: timeoutMs
+  }) : spawnSync("git", args, {
+    stdio: "ignore",
+    timeout: timeoutMs
+  });
+  if (result.error) {
+    const errorCode = typeof result.error === "object" && result.error !== null && "code" in result.error ? String(result.error.code) : "";
+    if (errorCode === "ETIMEDOUT") {
+      throw createExternalTemplateTimeoutError(label, timeoutMs);
     }
-    if (cloneResult.signal === "SIGTERM" || cloneResult.signal === "SIGKILL") {
-      throw createExternalTemplateTimeoutError(`cloning GitHub template ${locator.owner}/${locator.repo}`, cloneTimeoutMs);
+    throw result.error;
+  }
+  if (result.signal === "SIGTERM" || result.signal === "SIGKILL") {
+    throw createExternalTemplateTimeoutError(label, timeoutMs);
+  }
+  return result;
+}
+function getGitHubTemplateRepositoryUrl(locator) {
+  return `https://github.com/${locator.owner}/${locator.repo}.git`;
+}
+function resolveGitHubTemplateDirectory(checkoutDir, locator) {
+  const sourceDir = path17.resolve(checkoutDir, locator.sourcePath);
+  const relativeSourceDir = path17.relative(checkoutDir, sourceDir);
+  if (relativeSourceDir.startsWith("..") || path17.isAbsolute(relativeSourceDir)) {
+    throw new Error("GitHub template path must stay within the cloned repository.");
+  }
+  if (!fs14.existsSync(sourceDir)) {
+    throw new Error(`GitHub template path does not exist: ${locator.sourcePath}`);
+  }
+  return sourceDir;
+}
+function cloneGitHubTemplateSource(locator, checkoutDir) {
+  const args = ["clone", "--depth", "1"];
+  if (locator.ref) {
+    args.push("--branch", locator.ref);
+  }
+  args.push(getGitHubTemplateRepositoryUrl(locator), checkoutDir);
+  const cloneResult = runGitTemplateCommand(args, `cloning GitHub template ${locator.owner}/${locator.repo}`);
+  if (cloneResult.status !== 0) {
+    throw new Error(`Failed to clone GitHub template source ${locator.owner}/${locator.repo}.`);
+  }
+}
+function readGitHubTemplateHeadRevision(checkoutDir) {
+  const result = runGitTemplateCommand(["-C", checkoutDir, "rev-parse", "HEAD"], "reading GitHub template checkout revision", { captureOutput: true });
+  if (result.status !== 0 || typeof result.stdout !== "string") {
+    return null;
+  }
+  const revision = result.stdout.trim().split(/\s+/u)[0];
+  return /^[0-9a-f]{40}$/iu.test(revision) ? revision.toLowerCase() : null;
+}
+function pinGitHubTemplateCacheRevision(locator, checkoutDir, cacheRevision) {
+  const normalizedCacheRevision = cacheRevision.toLowerCase();
+  if (readGitHubTemplateHeadRevision(checkoutDir) === normalizedCacheRevision) {
+    return;
+  }
+  const fetchResult = runGitTemplateCommand(["-C", checkoutDir, "fetch", "--depth", "1", "origin", cacheRevision], `fetching GitHub template revision ${locator.owner}/${locator.repo}`);
+  if (fetchResult.status !== 0) {
+    throw createGitHubTemplateCacheRevisionRaceError(`Failed to fetch GitHub template revision ${cacheRevision} for ${locator.owner}/${locator.repo}.`);
+  }
+  const checkoutResult = runGitTemplateCommand(["-C", checkoutDir, "checkout", "--detach", cacheRevision], `checking out GitHub template revision ${locator.owner}/${locator.repo}`);
+  if (checkoutResult.status !== 0) {
+    throw createGitHubTemplateCacheRevisionRaceError(`Failed to check out GitHub template revision ${cacheRevision} for ${locator.owner}/${locator.repo}.`);
+  }
+  if (readGitHubTemplateHeadRevision(checkoutDir) !== normalizedCacheRevision) {
+    throw createGitHubTemplateCacheRevisionRaceError(`GitHub template checkout did not match resolved revision ${cacheRevision} for ${locator.owner}/${locator.repo}.`);
+  }
+}
+function getGitHubTemplateRevisionPatterns(locator) {
+  const ref = locator.ref ?? "HEAD";
+  if (!locator.ref) {
+    return [ref];
+  }
+  if (ref.startsWith("refs/")) {
+    return [ref, `${ref}^{}`];
+  }
+  return [ref, `refs/heads/${ref}`, `refs/tags/${ref}`, `refs/tags/${ref}^{}`];
+}
+function pickGitHubTemplateCacheRevision(locator, revisions) {
+  const ref = locator.ref ?? "HEAD";
+  if (!locator.ref) {
+    return revisions[0]?.revision ?? null;
+  }
+  if (!ref.startsWith("refs/")) {
+    const branchRevision = revisions.find((entry) => entry.resolvedRef === `refs/heads/${ref}`);
+    if (branchRevision) {
+      return branchRevision.revision;
     }
-    if (cloneResult.status !== 0) {
-      throw new Error(`Failed to clone GitHub template source ${locator.owner}/${locator.repo}.`);
+    const peeledTagRevision = revisions.find((entry) => entry.resolvedRef === `refs/tags/${ref}^{}`);
+    if (peeledTagRevision) {
+      return peeledTagRevision.revision;
     }
-    const sourceDir = path15.resolve(checkoutDir, locator.sourcePath);
-    const relativeSourceDir = path15.relative(checkoutDir, sourceDir);
-    if (relativeSourceDir.startsWith("..") || path15.isAbsolute(relativeSourceDir)) {
-      throw new Error("GitHub template path must stay within the cloned repository.");
+    const tagRevision = revisions.find((entry) => entry.resolvedRef === `refs/tags/${ref}`);
+    if (tagRevision) {
+      return tagRevision.revision;
     }
-    if (!fs13.existsSync(sourceDir)) {
-      throw new Error(`GitHub template path does not exist: ${locator.sourcePath}`);
+  }
+  if (ref.startsWith("refs/tags/")) {
+    const peeledRevision = revisions.find((entry) => entry.resolvedRef === `${ref}^{}`);
+    if (peeledRevision) {
+      return peeledRevision.revision;
+    }
+  }
+  const exactRevision = revisions.find((entry) => entry.resolvedRef === ref);
+  return (exactRevision ?? revisions[0])?.revision ?? null;
+}
+function resolveGitHubTemplateCacheRevision(locator) {
+  const result = runGitTemplateCommand([
+    "ls-remote",
+    getGitHubTemplateRepositoryUrl(locator),
+    ...getGitHubTemplateRevisionPatterns(locator)
+  ], `checking GitHub template revision ${locator.owner}/${locator.repo}`, { captureOutput: true });
+  if (result.status !== 0 || typeof result.stdout !== "string") {
+    return {
+      lookupUnavailable: true,
+      revision: null
+    };
+  }
+  const revisions = result.stdout.split(`
+`).map((line) => {
+    const [revision, resolvedRef] = line.trim().split(/\s+/u);
+    if (!/^[0-9a-f]{40}$/iu.test(revision) || !resolvedRef) {
+      return null;
     }
+    return {
+      resolvedRef,
+      revision: revision.toLowerCase()
+    };
+  }).filter((entry) => entry !== null);
+  return {
+    lookupUnavailable: false,
+    revision: pickGitHubTemplateCacheRevision(locator, revisions)
+  };
+}
+function getGitHubTemplateCacheMetadata(locator, revision) {
+  return {
+    ...revision ? { revision } : {},
+    owner: locator.owner,
+    ref: locator.ref,
+    repo: locator.repo,
+    sourcePath: locator.sourcePath
+  };
+}
+async function reuseGitHubTemplateCacheByMetadata(locator) {
+  const cachedSource = await findReusableExternalTemplateSourceCache({
+    metadata: getGitHubTemplateCacheMetadata(locator),
+    namespace: "github"
+  });
+  if (!cachedSource) {
+    return null;
+  }
+  const sourceDir = resolveGitHubTemplateDirectory(cachedSource.sourceDir, locator);
+  await assertNoSymlinks2(sourceDir);
+  return {
+    blockDir: sourceDir,
+    rootDir: sourceDir
+  };
+}
+async function resolveGitHubTemplateSource(locator) {
+  const cacheEnabled = isExternalTemplateCacheEnabled();
+  let cacheRevisionLookupUnavailable = false;
+  let cacheRevision = null;
+  if (cacheEnabled) {
+    try {
+      const resolvedRevision = resolveGitHubTemplateCacheRevision(locator);
+      cacheRevision = resolvedRevision.revision;
+      cacheRevisionLookupUnavailable = resolvedRevision.lookupUnavailable;
+    } catch {
+      cacheRevision = null;
+      cacheRevisionLookupUnavailable = true;
+    }
+  }
+  if (cacheEnabled && !cacheRevision && cacheRevisionLookupUnavailable) {
+    const cachedSource = await reuseGitHubTemplateCacheByMetadata(locator);
+    if (cachedSource) {
+      return cachedSource;
+    }
+  }
+  if (cacheRevision) {
+    const resolvedCacheRevision = cacheRevision;
+    try {
+      const cachedSource = await resolveExternalTemplateSourceCache({
+        keyParts: [
+          "github",
+          locator.owner,
+          locator.repo,
+          locator.sourcePath,
+          locator.ref ?? "",
+          resolvedCacheRevision
+        ],
+        metadata: getGitHubTemplateCacheMetadata(locator, resolvedCacheRevision),
+        namespace: "github"
+      }, async (checkoutDir2) => {
+        cloneGitHubTemplateSource(locator, checkoutDir2);
+        const sourceDir = resolveGitHubTemplateDirectory(checkoutDir2, locator);
+        await assertNoSymlinks2(sourceDir);
+        pinGitHubTemplateCacheRevision(locator, checkoutDir2, resolvedCacheRevision);
+      });
+      if (cachedSource) {
+        const sourceDir = resolveGitHubTemplateDirectory(cachedSource.sourceDir, locator);
+        await assertNoSymlinks2(sourceDir);
+        return {
+          blockDir: sourceDir,
+          rootDir: sourceDir
+        };
+      }
+    } catch (error) {
+      if (!isGitHubTemplateCacheRevisionRaceError(error)) {
+        throw error;
+      }
+    }
+  }
+  const { path: remoteRoot, cleanup } = await createManagedTempRoot("wp-typia-template-source-");
+  const checkoutDir = path17.join(remoteRoot, "source");
+  try {
+    cloneGitHubTemplateSource(locator, checkoutDir);
+    const sourceDir = resolveGitHubTemplateDirectory(checkoutDir, locator);
     await assertNoSymlinks2(sourceDir);
     return {
       blockDir: sourceDir,
@@ -11302,8 +11912,8 @@ async function resolveGitHubTemplateSource(locator) {
 }
 async function resolveTemplateSeed(locator, cwd) {
   if (locator.kind === "path") {
-    const sourceDir = path15.resolve(cwd, locator.templatePath);
-    if (!fs13.existsSync(sourceDir)) {
+    const sourceDir = path17.resolve(cwd, locator.templatePath);
+    if (!fs14.existsSync(sourceDir)) {
       throw new Error(`Template path does not exist: ${sourceDir}`);
     }
     await assertNoSymlinks2(sourceDir);
@@ -16468,17 +17078,17 @@ async function scaffoldProject({
     phase: "finalize-project",
     title: "Finalizing scaffold output"
   });
-  const readmePath = path16.join(projectDir, "README.md");
-  if (!fs14.existsSync(readmePath)) {
-    await fsp10.writeFile(readmePath, buildReadme(resolvedTemplateId, variables, resolvedPackageManager, {
+  const readmePath = path18.join(projectDir, "README.md");
+  if (!fs15.existsSync(readmePath)) {
+    await fsp11.writeFile(readmePath, buildReadme(resolvedTemplateId, variables, resolvedPackageManager, {
       withMigrationUi: isBuiltInTemplate || isWorkspace ? withMigrationUi : false,
       withTestPreset: isBuiltInTemplate ? withTestPreset : false,
       withWpEnv: isBuiltInTemplate ? withWpEnv : false
     }), "utf8");
   }
-  const gitignorePath = path16.join(projectDir, ".gitignore");
-  const existingGitignore = fs14.existsSync(gitignorePath) ? await fsp10.readFile(gitignorePath, "utf8") : "";
-  await fsp10.writeFile(gitignorePath, mergeTextLines(buildGitignore(), existingGitignore), "utf8");
+  const gitignorePath = path18.join(projectDir, ".gitignore");
+  const existingGitignore = fs15.existsSync(gitignorePath) ? await fsp11.readFile(gitignorePath, "utf8") : "";
+  await fsp11.writeFile(gitignorePath, mergeTextLines(buildGitignore(), existingGitignore), "utf8");
   await normalizePackageJson(projectDir, resolvedPackageManager);
   if (isBuiltInTemplate) {
     const variableGroups = getScaffoldTemplateVariableGroups(variables);
@@ -16559,4 +17169,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=EFE0A10933AD252664756E2164756E21