@wp-typia/project-tools 0.22.6 → 0.22.8

package/dist/runtime/create-template-validation.js

@@ -0,0 +1,121 @@
+import path from "node:path";
+import { CLI_DIAGNOSTIC_CODES, createCliDiagnosticCodeError, } from "./cli-diagnostics.js";
+import { OFFICIAL_WORKSPACE_TEMPLATE_ALIAS, OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE, TEMPLATE_IDS, getTemplateById, isBuiltInTemplateId, } from "./template-registry.js";
+import { getRemovedBuiltInTemplateMessage, isRemovedBuiltInTemplateId, } from "./template-defaults.js";
+import { parseNpmTemplateLocator } from "./template-source-locators.js";
+export const CREATE_TEMPLATE_SELECTION_HINT = `--template <${[
+    ...TEMPLATE_IDS,
+    OFFICIAL_WORKSPACE_TEMPLATE_ALIAS,
+].join("|")}|./path|github:owner/repo/path[#ref]|npm-package>`;
+const TEMPLATE_SUGGESTION_IDS = [
+    ...TEMPLATE_IDS,
+    OFFICIAL_WORKSPACE_TEMPLATE_ALIAS,
+];
+const USER_FACING_TEMPLATE_IDS = [
+    ...TEMPLATE_IDS,
+    OFFICIAL_WORKSPACE_TEMPLATE_ALIAS,
+];
+function normalizeCreateTemplateSelection(templateId) {
+    return templateId === OFFICIAL_WORKSPACE_TEMPLATE_ALIAS
+        ? OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE
+        : templateId;
+}
+function looksLikeWindowsAbsoluteTemplatePath(templateId) {
+    return /^[a-z]:[\\/]/iu.test(templateId) || /^\\\\[^\\]+\\[^\\]+/u.test(templateId);
+}
+function looksLikeExplicitNonNpmExternalTemplateLocator(templateId) {
+    return (path.isAbsolute(templateId) ||
+        looksLikeWindowsAbsoluteTemplatePath(templateId) ||
+        templateId.startsWith("./") ||
+        templateId.startsWith(".\\") ||
+        templateId.startsWith("../") ||
+        templateId.startsWith("..\\") ||
+        templateId.startsWith("@") ||
+        templateId.startsWith("github:") ||
+        templateId.includes("/") ||
+        templateId.includes("\\"));
+}
+function looksLikeExplicitCreateExternalTemplateLocator(templateId) {
+    return (looksLikeExplicitNonNpmExternalTemplateLocator(templateId) ||
+        parseNpmTemplateLocator(templateId) !== null);
+}
+function getEditDistance(left, right) {
+    const previous = Array.from({ length: right.length + 1 }, (_, index) => index);
+    const current = new Array(right.length + 1);
+    for (let leftIndex = 0; leftIndex < left.length; leftIndex += 1) {
+        current[0] = leftIndex + 1;
+        for (let rightIndex = 0; rightIndex < right.length; rightIndex += 1) {
+            const substitutionCost = left[leftIndex] === right[rightIndex] ? 0 : 1;
+            current[rightIndex + 1] = Math.min(current[rightIndex] + 1, previous[rightIndex + 1] + 1, previous[rightIndex] + substitutionCost);
+        }
+        for (let index = 0; index < current.length; index += 1) {
+            previous[index] = current[index];
+        }
+    }
+    return previous[right.length];
+}
+function findMistypedBuiltInTemplateSuggestion(templateId) {
+    const normalizedTemplateId = templateId.trim().toLowerCase();
+    if (normalizedTemplateId.length === 0 ||
+        looksLikeExplicitNonNpmExternalTemplateLocator(normalizedTemplateId)) {
+        return null;
+    }
+    let bestCandidate = null;
+    for (const candidateId of TEMPLATE_SUGGESTION_IDS) {
+        const distance = getEditDistance(normalizedTemplateId, candidateId);
+        if (bestCandidate === null || distance < bestCandidate.distance) {
+            bestCandidate = {
+                distance,
+                id: candidateId,
+            };
+        }
+    }
+    return bestCandidate && bestCandidate.distance <= 2
+        ? bestCandidate.id
+        : null;
+}
+function getMistypedBuiltInTemplateMessage(templateId) {
+    const suggestion = findMistypedBuiltInTemplateSuggestion(templateId);
+    if (!suggestion) {
+        return null;
+    }
+    const suggestionDescription = suggestion === OFFICIAL_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(" ");
+}
+/**
+ * Validate an explicitly supplied create template id before entering the full
+ * scaffold flow.
+ *
+ * Built-in template ids and the workspace alias resolve immediately, common
+ * built-in typos keep suggestion diagnostics, and explicit external template
+ * locators remain deferred to the external template resolver.
+ */
+export function validateExplicitCreateTemplateId(templateId) {
+    const normalizedTemplateId = normalizeCreateTemplateSelection(templateId);
+    if (isRemovedBuiltInTemplateId(templateId)) {
+        throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.UNKNOWN_TEMPLATE, getRemovedBuiltInTemplateMessage(templateId));
+    }
+    if (normalizedTemplateId === OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE) {
+        return normalizedTemplateId;
+    }
+    if (isBuiltInTemplateId(normalizedTemplateId)) {
+        return getTemplateById(normalizedTemplateId).id;
+    }
+    const mistypedBuiltInTemplateMessage = getMistypedBuiltInTemplateMessage(templateId);
+    if (mistypedBuiltInTemplateMessage) {
+        throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.UNKNOWN_TEMPLATE, mistypedBuiltInTemplateMessage);
+    }
+    if (!looksLikeExplicitCreateExternalTemplateLocator(normalizedTemplateId)) {
+        throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.UNKNOWN_TEMPLATE, getUnknownTemplateMessage(templateId));
+    }
+    return normalizedTemplateId;
+}

package/dist/runtime/package-versions.d.ts

@@ -23,7 +23,7 @@ export declare const DEFAULT_WORDPRESS_CORE_ABILITIES_VERSION = "^0.9.0";
 export declare const DEFAULT_WORDPRESS_CORE_DATA_VERSION = "^7.44.0";
 export declare const DEFAULT_WORDPRESS_DATA_VERSION = "^9.28.0";
 export declare const DEFAULT_WORDPRESS_DATAVIEWS_VERSION = "^14.1.0";
-export declare const DEFAULT_WP_TYPIA_DATAVIEWS_VERSION = "^0.1.0";
+export declare const DEFAULT_WP_TYPIA_DATAVIEWS_VERSION = "^0.1.1";
 /**
  * Resolve a managed package version range from linked workspace packages first,
  * then installed package manifests, while preserving the shared normalization

package/dist/runtime/package-versions.js

@@ -19,7 +19,7 @@ export const DEFAULT_WORDPRESS_CORE_ABILITIES_VERSION = '^0.9.0';
 export const DEFAULT_WORDPRESS_CORE_DATA_VERSION = '^7.44.0';
 export const DEFAULT_WORDPRESS_DATA_VERSION = '^9.28.0';
 export const DEFAULT_WORDPRESS_DATAVIEWS_VERSION = '^14.1.0';
-export const DEFAULT_WP_TYPIA_DATAVIEWS_VERSION = '^0.1.0';
+export const DEFAULT_WP_TYPIA_DATAVIEWS_VERSION = '^0.1.1';
 let cachedPackageVersions = null;
 function getErrorCode(error) {
     return typeof error === 'object' && error !== null && 'code' in error
@@ -58,10 +58,23 @@ function createContentFingerprint(source) {
     }
     return (hash >>> 0).toString(16);
 }
+function readPackageManifestFile(packageJsonPath) {
+    const fileDescriptor = fs.openSync(packageJsonPath, 'r');
+    try {
+        // Keep cache metadata and manifest contents tied to one opened file, so a
+        // concurrent path replacement cannot mix stats from one manifest with
+        // contents from another. The content fingerprint remains the final guard.
+        const stats = fs.fstatSync(fileDescriptor);
+        const source = fs.readFileSync(fileDescriptor, 'utf8');
+        return { source, stats };
+    }
+    finally {
+        fs.closeSync(fileDescriptor);
+    }
+}
 function resolvePackageManifestLocation(packageJsonPath) {
     try {
-        const stats = fs.statSync(packageJsonPath);
-        const source = fs.readFileSync(packageJsonPath, 'utf8');
+        const { source, stats } = readPackageManifestFile(packageJsonPath);
         return {
             cacheKey: `file:${packageJsonPath}:${stats.ino}:${stats.mtimeMs}:${stats.ctimeMs}:${stats.size}:${createContentFingerprint(source)}`,
             packageJsonPath,

package/dist/runtime/php-utils.js

@@ -139,95 +139,168 @@ function matchesPhpFunctionCallAt(source, index, functionName) {
     const callStart = skipPhpCallTrivia(source, cursor);
     return callStart !== null && source[callStart] === "(";
 }
-/**
- * Detect a PHP function call outside strings, comments, heredoc, and nowdoc blocks.
- *
- * @param source PHP source to scan.
- * @param functionName Literal PHP function identifier to find.
- * @returns Whether `source` contains a code-mode call to `functionName`.
- */
-export function hasPhpFunctionCall(source, functionName) {
-    let mode = "code";
-    let heredocDelimiter = "";
-    let index = 0;
-    while (index < source.length) {
-        const character = source[index];
-        if (mode === "heredoc") {
-            const closingEnd = findPhpHeredocClosingEnd(source, index, heredocDelimiter);
-            if (closingEnd !== null) {
-                mode = "code";
-                heredocDelimiter = "";
-                index = closingEnd;
-                continue;
-            }
-            const nextLineStart = findPhpLineBoundary(source, index).nextStart;
-            if (nextLineStart <= index) {
-                return false;
-            }
-            index = nextLineStart;
-            continue;
+function createPhpScannerState() {
+    return {
+        heredocDelimiter: "",
+        interpolationComment: "",
+        interpolationDepth: 0,
+        interpolationQuote: "",
+        mode: "code",
+    };
+}
+function advancePhpScanner(source, index, state) {
+    const character = source[index];
+    if (state.mode === "heredoc") {
+        const closingEnd = findPhpHeredocClosingEnd(source, index, state.heredocDelimiter);
+        if (closingEnd !== null) {
+            state.mode = "code";
+            state.heredocDelimiter = "";
+            return { ambiguous: false, inCode: false, index: closingEnd };
+        }
+        const nextLineStart = findPhpLineBoundary(source, index).nextStart;
+        if (nextLineStart <= index) {
+            return { ambiguous: true, inCode: false, index };
+        }
+        return { ambiguous: false, inCode: false, index: nextLineStart };
+    }
+    if (state.mode === "single-quoted" || state.mode === "double-quoted") {
+        const quote = state.mode === "single-quoted" ? "'" : '"';
+        if (character === "\\") {
+            return { ambiguous: false, inCode: false, index: index + 2 };
+        }
+        if (state.mode === "double-quoted" &&
+            character === "{" &&
+            source[index + 1] === "$") {
+            state.mode = "double-quoted-interpolation";
+            state.interpolationComment = "";
+            state.interpolationDepth = 1;
+            state.interpolationQuote = "";
+            return { ambiguous: false, inCode: false, index: index + 2 };
         }
-        if (mode === "single-quoted" || mode === "double-quoted") {
-            const quote = mode === "single-quoted" ? "'" : '"';
+        if (character === quote) {
+            state.mode = "code";
+        }
+        return { ambiguous: false, inCode: false, index: index + 1 };
+    }
+    if (state.mode === "double-quoted-interpolation") {
+        if (state.interpolationQuote) {
             if (character === "\\") {
-                index += 2;
-                continue;
+                return { ambiguous: false, inCode: false, index: index + 2 };
             }
-            if (character === quote) {
-                mode = "code";
+            if (character === state.interpolationQuote) {
+                state.interpolationQuote = "";
             }
-            index += 1;
-            continue;
+            return { ambiguous: false, inCode: false, index: index + 1 };
         }
-        if (mode === "line-comment") {
+        if (state.interpolationComment === "line") {
             if (character === "\r" || character === "\n") {
-                mode = "code";
+                state.interpolationComment = "";
             }
-            index += 1;
-            continue;
+            return { ambiguous: false, inCode: false, index: index + 1 };
         }
-        if (mode === "block-comment") {
+        if (state.interpolationComment === "block") {
             if (character === "*" && source[index + 1] === "/") {
-                mode = "code";
-                index += 2;
-                continue;
+                state.interpolationComment = "";
+                return { ambiguous: false, inCode: false, index: index + 2 };
             }
-            index += 1;
-            continue;
-        }
-        if (character === "'") {
-            mode = "single-quoted";
-            index += 1;
-            continue;
-        }
-        if (character === '"') {
-            mode = "double-quoted";
-            index += 1;
-            continue;
+            return { ambiguous: false, inCode: false, index: index + 1 };
         }
         if (character === "/" && source[index + 1] === "/") {
-            mode = "line-comment";
-            index += 2;
-            continue;
+            state.interpolationComment = "line";
+            return { ambiguous: false, inCode: false, index: index + 2 };
         }
         if (character === "#" && source[index + 1] !== "[") {
-            mode = "line-comment";
-            index += 1;
-            continue;
+            state.interpolationComment = "line";
+            return { ambiguous: false, inCode: false, index: index + 1 };
         }
         if (character === "/" && source[index + 1] === "*") {
-            mode = "block-comment";
-            index += 2;
-            continue;
+            state.interpolationComment = "block";
+            return { ambiguous: false, inCode: false, index: index + 2 };
+        }
+        if (character === "'" || character === '"') {
+            state.interpolationQuote = character;
+            return { ambiguous: false, inCode: false, index: index + 1 };
+        }
+        if (character === "{") {
+            state.interpolationDepth += 1;
+            return { ambiguous: false, inCode: false, index: index + 1 };
         }
-        if (character === "<") {
-            const heredocStart = parsePhpHeredocStart(source, index);
-            if (heredocStart) {
-                mode = "heredoc";
-                heredocDelimiter = heredocStart.delimiter;
-                index = heredocStart.contentStart;
-                continue;
+        if (character === "}") {
+            state.interpolationDepth -= 1;
+            if (state.interpolationDepth <= 0) {
+                state.interpolationComment = "";
+                state.interpolationDepth = 0;
+                state.mode = "double-quoted";
             }
+            return { ambiguous: false, inCode: false, index: index + 1 };
+        }
+        return { ambiguous: false, inCode: false, index: index + 1 };
+    }
+    if (state.mode === "line-comment") {
+        if (character === "\r" || character === "\n") {
+            state.mode = "code";
+        }
+        return { ambiguous: false, inCode: false, index: index + 1 };
+    }
+    if (state.mode === "block-comment") {
+        if (character === "*" && source[index + 1] === "/") {
+            state.mode = "code";
+            return { ambiguous: false, inCode: false, index: index + 2 };
+        }
+        return { ambiguous: false, inCode: false, index: index + 1 };
+    }
+    if (character === "'") {
+        state.mode = "single-quoted";
+        return { ambiguous: false, inCode: false, index: index + 1 };
+    }
+    if (character === '"') {
+        state.mode = "double-quoted";
+        return { ambiguous: false, inCode: false, index: index + 1 };
+    }
+    if (character === "/" && source[index + 1] === "/") {
+        state.mode = "line-comment";
+        return { ambiguous: false, inCode: false, index: index + 2 };
+    }
+    if (character === "#" && source[index + 1] !== "[") {
+        state.mode = "line-comment";
+        return { ambiguous: false, inCode: false, index: index + 1 };
+    }
+    if (character === "/" && source[index + 1] === "*") {
+        state.mode = "block-comment";
+        return { ambiguous: false, inCode: false, index: index + 2 };
+    }
+    if (character === "<") {
+        const heredocStart = parsePhpHeredocStart(source, index);
+        if (heredocStart) {
+            state.mode = "heredoc";
+            state.heredocDelimiter = heredocStart.delimiter;
+            return {
+                ambiguous: false,
+                inCode: false,
+                index: heredocStart.contentStart,
+            };
+        }
+    }
+    return { ambiguous: false, inCode: true, index };
+}
+/**
+ * Detect a PHP function call outside strings, comments, heredoc, and nowdoc blocks.
+ *
+ * @param source PHP source to scan.
+ * @param functionName Literal PHP function identifier to find.
+ * @returns Whether `source` contains a code-mode call to `functionName`.
+ */
+export function hasPhpFunctionCall(source, functionName) {
+    const scanner = createPhpScannerState();
+    let index = 0;
+    while (index < source.length) {
+        const scan = advancePhpScanner(source, index, scanner);
+        if (scan.ambiguous) {
+            return false;
+        }
+        if (!scan.inCode) {
+            index = scan.index;
+            continue;
         }
         if (matchesPhpFunctionCallAt(source, index, functionName)) {
             return true;
@@ -257,88 +330,18 @@ export function findPhpFunctionRange(source, functionName, options = {}) {
     }
     const openBraceIndex = functionStart + openBraceOffset;
     let depth = 0;
-    let mode = "code";
-    let heredocDelimiter = "";
+    const scanner = createPhpScannerState();
     let index = openBraceIndex;
     while (index < source.length) {
-        const character = source[index];
-        if (mode === "heredoc") {
-            const closingEnd = findPhpHeredocClosingEnd(source, index, heredocDelimiter);
-            if (closingEnd !== null) {
-                mode = "code";
-                heredocDelimiter = "";
-                index = closingEnd;
-                continue;
-            }
-            const nextLineStart = findPhpLineBoundary(source, index).nextStart;
-            if (nextLineStart <= index) {
-                return null;
-            }
-            index = nextLineStart;
-            continue;
-        }
-        if (mode === "single-quoted" || mode === "double-quoted") {
-            const quote = mode === "single-quoted" ? "'" : '"';
-            if (character === "\\") {
-                index += 2;
-                continue;
-            }
-            if (character === quote) {
-                mode = "code";
-            }
-            index += 1;
-            continue;
-        }
-        if (mode === "line-comment") {
-            if (character === "\r" || character === "\n") {
-                mode = "code";
-            }
-            index += 1;
-            continue;
-        }
-        if (mode === "block-comment") {
-            if (character === "*" && source[index + 1] === "/") {
-                mode = "code";
-                index += 2;
-                continue;
-            }
-            index += 1;
-            continue;
-        }
-        if (character === "'") {
-            mode = "single-quoted";
-            index += 1;
-            continue;
-        }
-        if (character === '"') {
-            mode = "double-quoted";
-            index += 1;
-            continue;
-        }
-        if (character === "/" && source[index + 1] === "/") {
-            mode = "line-comment";
-            index += 2;
-            continue;
-        }
-        if (character === "#" && source[index + 1] !== "[") {
-            mode = "line-comment";
-            index += 1;
-            continue;
+        const scan = advancePhpScanner(source, index, scanner);
+        if (scan.ambiguous) {
+            return null;
         }
-        if (character === "/" && source[index + 1] === "*") {
-            mode = "block-comment";
-            index += 2;
+        if (!scan.inCode) {
+            index = scan.index;
             continue;
         }
-        if (character === "<") {
-            const heredocStart = parsePhpHeredocStart(source, index);
-            if (heredocStart) {
-                mode = "heredoc";
-                heredocDelimiter = heredocStart.delimiter;
-                index = heredocStart.contentStart;
-                continue;
-            }
-        }
+        const character = source[index];
         if (character === "{") {
             depth += 1;
             index += 1;

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

@@ -1,23 +1,11 @@
 import { execSync } from 'node:child_process';
-import path from 'node:path';
 import { PACKAGE_MANAGER_IDS, getPackageManager, } from './package-managers.js';
 import { normalizeBlockSlug, resolveScaffoldIdentifiers, validateBlockSlug, validateNamespace, } from './scaffold-identifiers.js';
 import { CLI_DIAGNOSTIC_CODES, createCliDiagnosticCodeError, } from './cli-diagnostics.js';
-import { OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE, TEMPLATE_IDS, getTemplateById, isBuiltInTemplateId, } from './template-registry.js';
-import { getRemovedBuiltInTemplateMessage, isRemovedBuiltInTemplateId, } from './template-defaults.js';
-import { parseNpmTemplateLocator } from './template-source-locators.js';
+import { getTemplateById, isBuiltInTemplateId, } from './template-registry.js';
+import { CREATE_TEMPLATE_SELECTION_HINT, validateExplicitCreateTemplateId, } from './create-template-validation.js';
 import { toSnakeCase, toTitleCase, } from './string-case.js';
-const WORKSPACE_TEMPLATE_ALIAS = 'workspace';
-const TEMPLATE_SELECTION_HINT = `--template <${[
-    ...TEMPLATE_IDS,
-    WORKSPACE_TEMPLATE_ALIAS,
-].join('|')}|./path|github:owner/repo/path[#ref]|npm-package>`;
-const TEMPLATE_SUGGESTION_IDS = [...TEMPLATE_IDS, WORKSPACE_TEMPLATE_ALIAS];
 const QUERY_POST_TYPE_RULE = 'Use lowercase, 1-20 chars, and only a-z, 0-9, "_" or "-".';
-const USER_FACING_TEMPLATE_IDS = [
-    ...TEMPLATE_IDS,
-    WORKSPACE_TEMPLATE_ALIAS,
-];
 /**
  * Detect the current author name from local Git config.
  *
@@ -80,80 +68,6 @@ function normalizeQueryPostType(value) {
     }
     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 (path.isAbsolute(templateId) ||
-        looksLikeWindowsAbsoluteTemplatePath(templateId) ||
-        templateId.startsWith('./') ||
-        templateId.startsWith('../') ||
-        templateId.startsWith('@') ||
-        templateId.startsWith('github:') ||
-        templateId.includes('/'));
-}
-function looksLikeExplicitExternalTemplateLocator(templateId) {
-    return (looksLikeExplicitNonNpmExternalTemplateLocator(templateId) ||
-        parseNpmTemplateLocator(templateId) !== null);
-}
-function getEditDistance(left, right) {
-    const previous = Array.from({ length: right.length + 1 }, (_, index) => index);
-    const current = new Array(right.length + 1);
-    for (let leftIndex = 0; leftIndex < left.length; leftIndex += 1) {
-        current[0] = leftIndex + 1;
-        for (let rightIndex = 0; rightIndex < right.length; rightIndex += 1) {
-            const substitutionCost = left[leftIndex] === right[rightIndex] ? 0 : 1;
-            current[rightIndex + 1] = Math.min(current[rightIndex] + 1, previous[rightIndex + 1] + 1, previous[rightIndex] + substitutionCost);
-        }
-        for (let index = 0; index < current.length; index += 1) {
-            previous[index] = current[index];
-        }
-    }
-    return previous[right.length];
-}
-function findMistypedBuiltInTemplateSuggestion(templateId) {
-    const normalizedTemplateId = templateId.trim().toLowerCase();
-    if (normalizedTemplateId.length === 0 ||
-        looksLikeExplicitNonNpmExternalTemplateLocator(normalizedTemplateId)) {
-        return null;
-    }
-    let bestCandidate = null;
-    for (const candidateId of TEMPLATE_SUGGESTION_IDS) {
-        const distance = getEditDistance(normalizedTemplateId, candidateId);
-        if (bestCandidate === null ||
-            distance < bestCandidate.distance) {
-            bestCandidate = {
-                distance,
-                id: candidateId,
-            };
-        }
-    }
-    return bestCandidate && bestCandidate.distance <= 2
-        ? bestCandidate.id
-        : null;
-}
-function getMistypedBuiltInTemplateMessage(templateId) {
-    const suggestion = findMistypedBuiltInTemplateSuggestion(templateId);
-    if (!suggestion) {
-        return null;
-    }
-    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(' ');
-}
 /**
  * Resolve the scaffold template id from flags, defaults, and interactive selection.
  *
@@ -162,32 +76,15 @@ function getUnknownTemplateMessage(templateId) {
  */
 export async function resolveTemplateId({ templateId, yes = false, isInteractive = false, selectTemplate, }) {
     if (templateId) {
-        const normalizedTemplateId = normalizeTemplateSelection(templateId);
-        if (isRemovedBuiltInTemplateId(templateId)) {
-            throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.UNKNOWN_TEMPLATE, getRemovedBuiltInTemplateMessage(templateId));
-        }
-        if (normalizedTemplateId === OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE) {
-            return normalizedTemplateId;
-        }
-        if (isBuiltInTemplateId(normalizedTemplateId)) {
-            return getTemplateById(normalizedTemplateId).id;
-        }
-        const mistypedBuiltInTemplateMessage = getMistypedBuiltInTemplateMessage(templateId);
-        if (mistypedBuiltInTemplateMessage) {
-            throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.UNKNOWN_TEMPLATE, mistypedBuiltInTemplateMessage);
-        }
-        if (!looksLikeExplicitExternalTemplateLocator(normalizedTemplateId)) {
-            throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.UNKNOWN_TEMPLATE, getUnknownTemplateMessage(templateId));
-        }
-        return normalizedTemplateId;
+        return validateExplicitCreateTemplateId(templateId);
     }
     if (yes) {
         return 'basic';
     }
     if (!isInteractive || !selectTemplate) {
-        throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, `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 ${CREATE_TEMPLATE_SELECTION_HINT}.`);
     }
-    return normalizeTemplateSelection(await selectTemplate());
+    return validateExplicitCreateTemplateId(await selectTemplate());
 }
 /**
  * Resolve the package manager id from flags, defaults, and interactive selection.

package/dist/runtime/scaffold-apply-utils.js

@@ -15,6 +15,7 @@ import { pathExists, readOptionalUtf8File, } from "./fs-async.js";
 import { normalizePackageJson } from "./scaffold-package-manager-files.js";
 export { applyWorkspaceMigrationCapability, isOfficialWorkspaceProject, } from "./scaffold-bootstrap.js";
 import { replaceRepositoryReferencePlaceholders, resolveScaffoldRepositoryReference, } from "./scaffold-repository-reference.js";
+import { isCompoundPersistenceEnabled } from "./scaffold-template-variable-groups.js";
 export { buildGitignore, buildReadme, mergeTextLines } from "./scaffold-documents.js";
 async function reportScaffoldProgress(onProgress, event) {
     await onProgress?.(event);
@@ -103,7 +104,7 @@ async function withEphemeralScaffoldNodeModules(targetDir, callback) {
  */
 export async function seedBuiltInPersistenceArtifacts(targetDir, templateId, variables) {
     const needsPersistenceArtifacts = templateId === "persistence" ||
-        (templateId === "compound" && variables.compoundPersistenceEnabled === "true");
+        (templateId === "compound" && isCompoundPersistenceEnabled(variables));
     if (!needsPersistenceArtifacts) {
         return;
     }
@@ -256,7 +257,7 @@ export async function applyBuiltInScaffoldProjectFiles({ projectDir, templateDir
     await fsp.writeFile(gitignorePath, mergeTextLines(gitignoreContent ?? buildGitignore(), existingGitignore), "utf8");
     await normalizePackageJson(projectDir, packageManager);
     await applyGeneratedProjectDxPackageJson({
-        compoundPersistenceEnabled: variables.compoundPersistenceEnabled === "true",
+        compoundPersistenceEnabled: isCompoundPersistenceEnabled(variables),
         packageManager,
         projectDir,
         templateId,