@wp-typia/project-tools 0.16.13 → 0.16.14

package/README.md

@@ -12,7 +12,6 @@ Package roles:
   templates no longer ship structural, TS/TSX, style, or block-local `render.php`
   Mustache files.
 - `@wp-typia/block-runtime/*` owns generated-project runtime helpers.
-- `@wp-typia/create` is the deprecated legacy package shell.
 
 Supported public imports:
 

package/dist/runtime/cli-prompt.js

@@ -18,18 +18,17 @@ export function createReadlinePrompt() {
  * retry behavior without stubbing global stdin/stdout.
  */
 export function createReadlinePromptWithInterface(rl) {
+    const askQuestion = (query) => new Promise((resolve) => {
+        rl.question(query, resolve);
+    });
     return {
         async text(message, defaultValue, validate) {
-            const suffix = defaultValue ? ` (${defaultValue})` : "";
             while (true) {
-                const answer = await new Promise((resolve) => {
-                    rl.question(`${message}${suffix}: `, resolve);
-                });
-                const value = String(answer).trim() || defaultValue;
+                const value = normalizePromptAnswer(await askQuestion(formatTextPrompt(message, defaultValue))) || defaultValue;
                 if (validate) {
                     const result = validate(value);
                     if (result !== true) {
-                        console.error(`❌ ${typeof result === "string" ? result : "Invalid input"}`);
+                        console.error(formatValidationError(message, result, defaultValue));
                         continue;
                     }
                 }
@@ -40,22 +39,22 @@ export function createReadlinePromptWithInterface(rl) {
             if (options.length === 0) {
                 throw new Error(`select() requires at least one option for prompt: ${message}`);
             }
-            console.log(message);
-            options.forEach((option, index) => {
-                const hint = option.hint ? ` - ${option.hint}` : "";
-                console.log(`  ${index + 1}. ${option.label}${hint}`);
-            });
+            const resolvedDefaultIndex = getResolvedDefaultIndex(options, defaultValue);
+            renderSelectPrompt(message, options, resolvedDefaultIndex);
             while (true) {
-                const answer = await this.text("Choice", String(defaultValue));
-                const numericChoice = Number(answer);
-                if (!Number.isNaN(numericChoice) && options[numericChoice - 1]) {
-                    return options[numericChoice - 1].value;
+                const answer = normalizePromptAnswer(await askQuestion(formatChoicePrompt(resolvedDefaultIndex)));
+                if (answer.length === 0) {
+                    return options[resolvedDefaultIndex].value;
+                }
+                const selection = resolvePromptSelection(options, answer);
+                if (selection) {
+                    return selection.value;
                 }
-                const directChoice = options.find((option) => option.value === answer);
-                if (directChoice) {
-                    return directChoice.value;
+                if (isPromptHelpToken(answer)) {
+                    renderSelectPrompt(message, options, resolvedDefaultIndex);
+                    continue;
                 }
-                console.error(`❌ Invalid selection: ${answer}`);
+                console.error(formatInvalidSelectionError(answer, options, resolvedDefaultIndex));
             }
         },
         close() {
@@ -63,3 +62,63 @@ export function createReadlinePromptWithInterface(rl) {
         },
     };
 }
+function normalizePromptAnswer(value) {
+    return String(value).trim();
+}
+function normalizePromptToken(value) {
+    return value.trim().toLowerCase();
+}
+function getResolvedDefaultIndex(options, defaultValue) {
+    const candidateIndex = Number.isInteger(defaultValue) ? defaultValue - 1 : -1;
+    return options[candidateIndex] ? candidateIndex : 0;
+}
+function formatTextPrompt(message, defaultValue) {
+    const suffix = defaultValue.length > 0 ? ` [default: ${defaultValue}]` : "";
+    return `${message}${suffix}: `;
+}
+function formatValidationError(message, result, defaultValue) {
+    const detail = typeof result === "string" ? result : "Invalid input";
+    const retryHint = defaultValue.length > 0 ? ` Press Enter to keep "${defaultValue}".` : "";
+    return `❌ ${message}: ${detail}.${retryHint}`;
+}
+function formatChoicePrompt(defaultIndex) {
+    return `Choice [default: ${defaultIndex + 1}, ? for options]: `;
+}
+function renderSelectPrompt(message, options, defaultIndex) {
+    console.log(message);
+    console.log("  Enter a number, option label, or option value. Press Enter to keep the default, or type ? to list choices again.");
+    options.forEach((option, index) => {
+        const defaultMarker = index === defaultIndex ? " (default)" : "";
+        const valueHint = normalizePromptToken(option.label) === normalizePromptToken(option.value)
+            ? ""
+            : ` [${option.value}]`;
+        console.log(`  ${index + 1}. ${option.label}${valueHint}${defaultMarker}`);
+        if (option.hint) {
+            console.log(`     ${option.hint}`);
+        }
+    });
+}
+function isPromptHelpToken(answer) {
+    const normalized = normalizePromptToken(answer);
+    return normalized === "?" || normalized === "help" || normalized === "list";
+}
+function resolvePromptSelection(options, answer) {
+    const numericChoice = Number(answer);
+    if (!Number.isNaN(numericChoice) && options[numericChoice - 1]) {
+        return options[numericChoice - 1];
+    }
+    const normalizedAnswer = normalizePromptToken(answer);
+    return options.find((option) => {
+        const normalizedLabel = normalizePromptToken(option.label);
+        const normalizedValue = normalizePromptToken(option.value);
+        return normalizedAnswer === normalizedLabel || normalizedAnswer === normalizedValue;
+    });
+}
+function formatInvalidSelectionError(answer, options, defaultIndex) {
+    const optionValues = options.map((option) => option.value).join(", ");
+    return [
+        `❌ Invalid selection: ${answer}.`,
+        `Enter 1-${options.length}, one of: ${optionValues},`,
+        `or press Enter for "${options[defaultIndex].label}".`,
+    ].join(" ");
+}

package/dist/runtime/scaffold-answer-resolution.d.ts

@@ -0,0 +1,37 @@
+import type { PackageManagerId } from './package-managers.js';
+import type { CollectScaffoldAnswersOptions, ResolvePackageManagerOptions, ResolveTemplateOptions, ScaffoldAnswers } from './scaffold.js';
+/**
+ * Detect the current author name from local Git config.
+ *
+ * @returns The configured Git author name, or `"Your Name"` when unavailable.
+ */
+export declare function detectAuthor(): string;
+/**
+ * Compute the default scaffold answers for one project and template pair.
+ *
+ * @param projectName User-supplied project directory or block name seed.
+ * @param templateId Selected scaffold template identifier.
+ * @returns Normalized default answers for scaffold prompts and non-interactive flows.
+ */
+export declare function getDefaultAnswers(projectName: string, templateId: string): ScaffoldAnswers;
+/**
+ * Resolve the scaffold template id from flags, defaults, and interactive selection.
+ *
+ * @param options Template resolution options for interactive and non-interactive flows.
+ * @returns The normalized template identifier to scaffold.
+ */
+export declare function resolveTemplateId({ templateId, yes, isInteractive, selectTemplate, }: ResolveTemplateOptions): Promise<string>;
+/**
+ * Resolve the package manager id from flags, defaults, and interactive selection.
+ *
+ * @param options Package manager resolution options for interactive and non-interactive flows.
+ * @returns The normalized package manager id.
+ */
+export declare function resolvePackageManagerId({ packageManager, yes, isInteractive, selectPackageManager, }: ResolvePackageManagerOptions): Promise<PackageManagerId>;
+/**
+ * Collect scaffold answers from defaults, CLI overrides, and optional prompts.
+ *
+ * @param options Answer collection inputs including prompt callbacks and explicit overrides.
+ * @returns The normalized scaffold answers used for rendering and file generation.
+ */
+export declare function collectScaffoldAnswers({ projectName, templateId, yes, dataStorageMode, namespace, persistencePolicy, phpPrefix, promptText, textDomain, }: CollectScaffoldAnswersOptions): Promise<ScaffoldAnswers>;

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

@@ -0,0 +1,138 @@
+import { PACKAGE_MANAGER_IDS, getPackageManager, } from './package-managers.js';
+import { normalizeBlockSlug, resolveScaffoldIdentifiers, validateBlockSlug, validateNamespace, } from './scaffold-identifiers.js';
+import { OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE, TEMPLATE_IDS, getTemplateById, isBuiltInTemplateId, } from './template-registry.js';
+import { getRemovedBuiltInTemplateMessage, isRemovedBuiltInTemplateId, } from './template-defaults.js';
+import { toSnakeCase, toTitleCase, } from './string-case.js';
+const WORKSPACE_TEMPLATE_ALIAS = 'workspace';
+/**
+ * Detect the current author name from local Git config.
+ *
+ * @returns The configured Git author name, or `"Your Name"` when unavailable.
+ */
+export function detectAuthor() {
+    try {
+        return (execSync('git config user.name', {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim() || 'Your Name');
+    }
+    catch {
+        return 'Your Name';
+    }
+}
+/**
+ * Compute the default scaffold answers for one project and template pair.
+ *
+ * @param projectName User-supplied project directory or block name seed.
+ * @param templateId Selected scaffold template identifier.
+ * @returns Normalized default answers for scaffold prompts and non-interactive flows.
+ */
+export function getDefaultAnswers(projectName, templateId) {
+    const template = isBuiltInTemplateId(templateId) ? getTemplateById(templateId) : null;
+    const slugDefault = normalizeBlockSlug(projectName) || 'my-wp-typia-block';
+    return {
+        author: detectAuthor(),
+        dataStorageMode: templateId === 'persistence' ? 'custom-table' : undefined,
+        description: template?.description ?? 'A WordPress block scaffolded from a remote template',
+        namespace: slugDefault,
+        persistencePolicy: templateId === 'persistence' ? 'authenticated' : undefined,
+        phpPrefix: toSnakeCase(slugDefault),
+        slug: slugDefault,
+        textDomain: slugDefault,
+        title: toTitleCase(slugDefault),
+    };
+}
+function normalizeTemplateSelection(templateId) {
+    return templateId === WORKSPACE_TEMPLATE_ALIAS
+        ? OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE
+        : templateId;
+}
+/**
+ * Resolve the scaffold template id from flags, defaults, and interactive selection.
+ *
+ * @param options Template resolution options for interactive and non-interactive flows.
+ * @returns The normalized template identifier to scaffold.
+ */
+export async function resolveTemplateId({ templateId, yes = false, isInteractive = false, selectTemplate, }) {
+    if (templateId) {
+        const normalizedTemplateId = normalizeTemplateSelection(templateId);
+        if (isRemovedBuiltInTemplateId(templateId)) {
+            throw new Error(getRemovedBuiltInTemplateMessage(templateId));
+        }
+        if (isBuiltInTemplateId(normalizedTemplateId)) {
+            return getTemplateById(normalizedTemplateId).id;
+        }
+        return normalizedTemplateId;
+    }
+    if (yes) {
+        return 'basic';
+    }
+    if (!isInteractive || !selectTemplate) {
+        throw new Error(`Template is required in non-interactive mode. Use --template <${TEMPLATE_IDS.join('|')}|./path|github:owner/repo/path[#ref]|npm-package>.`);
+    }
+    return normalizeTemplateSelection(await selectTemplate());
+}
+/**
+ * Resolve the package manager id from flags, defaults, and interactive selection.
+ *
+ * @param options Package manager resolution options for interactive and non-interactive flows.
+ * @returns The normalized package manager id.
+ */
+export async function resolvePackageManagerId({ packageManager, yes = false, isInteractive = false, selectPackageManager, }) {
+    if (packageManager) {
+        return getPackageManager(packageManager).id;
+    }
+    if (yes) {
+        return 'npm';
+    }
+    if (!isInteractive || !selectPackageManager) {
+        throw new Error(`Package manager is required in non-interactive mode. Use --package-manager <${PACKAGE_MANAGER_IDS.join('|')}>.`);
+    }
+    return selectPackageManager();
+}
+/**
+ * Collect scaffold answers from defaults, CLI overrides, and optional prompts.
+ *
+ * @param options Answer collection inputs including prompt callbacks and explicit overrides.
+ * @returns The normalized scaffold answers used for rendering and file generation.
+ */
+export async function collectScaffoldAnswers({ projectName, templateId, yes = false, dataStorageMode, namespace, persistencePolicy, phpPrefix, promptText, textDomain, }) {
+    const defaults = getDefaultAnswers(projectName, templateId);
+    if (yes) {
+        const identifiers = resolveScaffoldIdentifiers({
+            namespace: namespace ?? defaults.namespace,
+            phpPrefix,
+            slug: defaults.slug,
+            textDomain,
+        });
+        return {
+            ...defaults,
+            dataStorageMode: dataStorageMode ?? defaults.dataStorageMode,
+            namespace: identifiers.namespace,
+            persistencePolicy: persistencePolicy ?? defaults.persistencePolicy,
+            phpPrefix: identifiers.phpPrefix,
+            textDomain: identifiers.textDomain,
+        };
+    }
+    if (!promptText) {
+        throw new Error('Interactive answers require a promptText callback.');
+    }
+    const identifiers = resolveScaffoldIdentifiers({
+        namespace: namespace ?? (await promptText('Namespace', defaults.namespace, validateNamespace)),
+        phpPrefix,
+        slug: await promptText('Block slug', defaults.slug, validateBlockSlug),
+        textDomain,
+    });
+    return {
+        author: await promptText('Author', defaults.author),
+        dataStorageMode: dataStorageMode ?? defaults.dataStorageMode,
+        description: await promptText('Description', defaults.description),
+        namespace: identifiers.namespace,
+        persistencePolicy: persistencePolicy ?? defaults.persistencePolicy,
+        phpPrefix: identifiers.phpPrefix,
+        slug: identifiers.slug,
+        textDomain: identifiers.textDomain,
+        title: await promptText('Block title', toTitleCase(identifiers.slug)),
+    };
+}
+import { execSync } from 'node:child_process';

package/dist/runtime/scaffold-apply-utils.d.ts

@@ -3,27 +3,12 @@ import type { BuiltInCodeArtifact } from "./built-in-block-code-artifacts.js";
 import { type BuiltInTemplateId } from "./template-registry.js";
 import type { PackageManagerId } from "./package-managers.js";
 import type { ScaffoldTemplateVariables } from "./scaffold.js";
+export { buildGitignore, buildReadme, mergeTextLines, } from "./scaffold-documents.js";
 export interface InstallDependenciesOptions {
     packageManager: PackageManagerId;
     projectDir: string;
 }
 export declare function ensureDirectory(targetDir: string, allowExisting?: boolean): Promise<void>;
-/**
- * Builds the generated README markdown for one scaffolded project.
- *
- * @param templateId Scaffold template family or template identifier.
- * @param variables Interpolated scaffold variables used in generated content.
- * @param packageManager Package manager used to format install and script commands.
- * @param options Optional README sections enabled by scaffold presets.
- * @returns Markdown README content for the generated project root.
- */
-export declare function buildReadme(templateId: string, variables: ScaffoldTemplateVariables, packageManager: PackageManagerId, { withMigrationUi, withTestPreset, withWpEnv, }?: {
-    withMigrationUi?: boolean;
-    withTestPreset?: boolean;
-    withWpEnv?: boolean;
-}): string;
-export declare function buildGitignore(): string;
-export declare function mergeTextLines(primaryContent: string, existingContent: string): string;
 export declare function writeStarterManifestFiles(targetDir: string, templateId: string, variables: ScaffoldTemplateVariables, artifacts?: readonly BuiltInBlockArtifact[]): Promise<void>;
 /**
  * Seed REST-derived persistence artifacts into a newly scaffolded built-in

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

@@ -3,18 +3,19 @@ import { promises as fsp } from "node:fs";
 import path from "node:path";
 import { execSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
-import { applyGeneratedProjectDxPackageJson, applyLocalDevPresetFiles, getPrimaryDevelopmentScript, } from "./local-dev-presets.js";
+import { applyGeneratedProjectDxPackageJson, applyLocalDevPresetFiles, } from "./local-dev-presets.js";
 import { applyMigrationUiCapability } from "./migration-ui-capability.js";
 import { getPackageVersions } from "./package-versions.js";
 import { ensureMigrationDirectories, writeInitialMigrationScaffold, writeMigrationConfig, } from "./migration-project.js";
 import { syncPersistenceRestArtifacts, } from "./persistence-rest-artifacts.js";
-import { getCompoundExtensionWorkflowSection, getInitialCommitCommands, getInitialCommitNote, getOptionalOnboardingNote, getOptionalOnboardingSteps, getQuickStartWorkflowNote, getPhpRestExtensionPointsSection, getTemplateSourceOfTruthNote, } from "./scaffold-onboarding.js";
+import { buildGitignore, buildReadme, mergeTextLines, } from "./scaffold-documents.js";
 import { getStarterManifestFiles, stringifyStarterManifest, } from "./starter-manifests.js";
 import { stringifyBuiltInBlockJsonDocument, } from "./built-in-block-artifacts.js";
 import { OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE, } from "./template-registry.js";
 import { copyInterpolatedDirectory } from "./template-render.js";
-import { formatInstallCommand, formatPackageExecCommand, formatRunScript, getPackageManager, transformPackageManagerText, } from "./package-managers.js";
+import { formatInstallCommand, formatPackageExecCommand, getPackageManager, transformPackageManagerText, } from "./package-managers.js";
 import { replaceRepositoryReferencePlaceholders, resolveScaffoldRepositoryReference, } from "./scaffold-repository-reference.js";
+export { buildGitignore, buildReadme, mergeTextLines, } from "./scaffold-documents.js";
 const EPHEMERAL_NODE_MODULES_LINK_TYPE = process.platform === "win32" ? "junction" : "dir";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const LOCKFILES = {
@@ -36,131 +37,6 @@ export async function ensureDirectory(targetDir, allowExisting = false) {
         throw new Error(`Target directory is not empty: ${targetDir}`);
     }
 }
-/**
- * Builds the generated README markdown for one scaffolded project.
- *
- * @param templateId Scaffold template family or template identifier.
- * @param variables Interpolated scaffold variables used in generated content.
- * @param packageManager Package manager used to format install and script commands.
- * @param options Optional README sections enabled by scaffold presets.
- * @returns Markdown README content for the generated project root.
- */
-export function buildReadme(templateId, variables, packageManager, { withMigrationUi = false, withTestPreset = false, withWpEnv = false, } = {}) {
-    const optionalOnboardingSteps = getOptionalOnboardingSteps(packageManager, templateId, {
-        compoundPersistenceEnabled: variables.compoundPersistenceEnabled === "true",
-    });
-    const initialCommitCommands = getInitialCommitCommands();
-    const sourceOfTruthNote = getTemplateSourceOfTruthNote(templateId, {
-        compoundPersistenceEnabled: variables.compoundPersistenceEnabled === "true",
-    });
-    const compoundPersistenceEnabled = variables.compoundPersistenceEnabled === "true";
-    const publicPersistencePolicyNote = variables.isPublicPersistencePolicy === "true"
-        ? "Public persistence writes use signed short-lived tokens, per-request ids, and coarse rate limiting by default. Add application-specific abuse controls before using the same pattern for high-value metrics or experiments."
-        : null;
-    const compoundExtensionWorkflowSection = getCompoundExtensionWorkflowSection(packageManager, templateId);
-    const phpRestExtensionPointsSection = getPhpRestExtensionPointsSection(templateId, {
-        compoundPersistenceEnabled,
-        slug: variables.slug,
-    });
-    const developmentScript = getPrimaryDevelopmentScript(templateId);
-    const wpEnvSection = withWpEnv
-        ? `## Local WordPress\n\n\`\`\`bash\n${formatRunScript(packageManager, "wp-env:start")}\n${formatRunScript(packageManager, "wp-env:stop")}\n${formatRunScript(packageManager, "wp-env:reset")}\n\`\`\``
-        : "";
-    const testPresetSection = withTestPreset
-        ? `## Local Test Preset\n\n\`\`\`bash\n${formatRunScript(packageManager, "wp-env:start:test")}\n${formatRunScript(packageManager, "wp-env:wait:test")}\n${formatRunScript(packageManager, "test:e2e")}\n\`\`\`\n\nThe generated smoke test uses \`.wp-env.test.json\` and verifies that the scaffolded block registers in the WordPress editor.`
-        : "";
-    const migrationSection = withMigrationUi
-        ? `## Migration UI\n\nThis scaffold already includes an initialized migration workspace at \`v1\`, generated deprecated/runtime artifacts, and an editor-embedded migration dashboard. Migration versions are schema lineage labels and are separate from your package or plugin release version. Use the existing CLI commands to snapshot, diff, scaffold, verify, and fuzz future schema changes.\n\n\`\`\`bash\n${formatRunScript(packageManager, "migration:doctor")}\n${formatRunScript(packageManager, "migration:verify")}\n${formatRunScript(packageManager, "migration:fuzz")}\n\`\`\`\n\nRun \`migration:init\` only when retrofitting migration support into an older project that was not scaffolded with \`--with-migration-ui\`.`
-        : "";
-    return `# ${variables.title}
-
-${variables.description}
-
-## Template
-
-${templateId}
-
-## Quick Start
-
-\`\`\`bash
-${formatInstallCommand(packageManager)}
-${formatRunScript(packageManager, developmentScript)}
-\`\`\`
-
-${getQuickStartWorkflowNote(packageManager, templateId, {
-        compoundPersistenceEnabled,
-    })}
-
-## Build and Verify
-
-\`\`\`bash
-${formatRunScript(packageManager, "build")}
-${formatRunScript(packageManager, "typecheck")}
-\`\`\`
-
-## Advanced Sync
-
-\`\`\`bash
-${optionalOnboardingSteps.join("\n")}
-\`\`\`
-
-${getOptionalOnboardingNote(packageManager, templateId, {
-        compoundPersistenceEnabled,
-    })}
-
-## Before First Commit
-
-\`\`\`bash
-${initialCommitCommands.join("\n")}
-\`\`\`
-
-${getInitialCommitNote()}
-
-${sourceOfTruthNote}${publicPersistencePolicyNote ? `\n\n${publicPersistencePolicyNote}` : ""}${migrationSection ? `\n\n${migrationSection}` : ""}${compoundExtensionWorkflowSection ? `\n\n${compoundExtensionWorkflowSection}` : ""}${wpEnvSection ? `\n\n${wpEnvSection}` : ""}${testPresetSection ? `\n\n${testPresetSection}` : ""}${phpRestExtensionPointsSection ? `\n\n${phpRestExtensionPointsSection}` : ""}
-`;
-}
-export function buildGitignore() {
-    return `# Dependencies
-node_modules/
-.yarn/
-.pnp.*
-
-# Build
-build/
-dist/
-
-# Editor
-.vscode/
-.idea/
-
-# OS
-.DS_Store
-Thumbs.db
-
-# WordPress
-*.log
-.wp-env/
-`;
-}
-export function mergeTextLines(primaryContent, existingContent) {
-    const normalizedPrimary = primaryContent.replace(/\r\n/g, "\n").trimEnd();
-    const normalizedExisting = existingContent.replace(/\r\n/g, "\n").trimEnd();
-    const mergedLines = [];
-    const seen = new Set();
-    for (const line of [...normalizedPrimary.split("\n"), ...normalizedExisting.split("\n")]) {
-        if (line.length === 0 && mergedLines[mergedLines.length - 1] === "") {
-            continue;
-        }
-        if (line.length > 0 && seen.has(line)) {
-            continue;
-        }
-        if (line.length > 0) {
-            seen.add(line);
-        }
-        mergedLines.push(line);
-    }
-    return `${mergedLines.join("\n").replace(/\n{3,}/g, "\n\n")}\n`;
-}
 export async function writeStarterManifestFiles(targetDir, templateId, variables, artifacts) {
     const manifests = artifacts
         ? artifacts.map((artifact) => ({

package/dist/runtime/scaffold-documents.d.ts

@@ -0,0 +1,34 @@
+import type { PackageManagerId } from './package-managers.js';
+import type { ScaffoldTemplateVariables } from './scaffold.js';
+/**
+ * Builds the generated README markdown for one scaffolded project.
+ *
+ * @param templateId Scaffold template family or template identifier.
+ * @param variables Interpolated scaffold variables used in generated content.
+ * @param packageManager Package manager used to format install and script commands.
+ * @param options Optional README sections enabled by scaffold presets.
+ * @returns Markdown README content for the generated project root.
+ */
+export declare function buildReadme(templateId: string, variables: ScaffoldTemplateVariables, packageManager: PackageManagerId, { withMigrationUi, withTestPreset, withWpEnv, }?: {
+    withMigrationUi?: boolean;
+    withTestPreset?: boolean;
+    withWpEnv?: boolean;
+}): string;
+/**
+ * Build the default `.gitignore` contents for a scaffolded project.
+ *
+ * @returns A newline-terminated `.gitignore` string covering dependency, build, editor, OS, and WordPress artifacts.
+ */
+export declare function buildGitignore(): string;
+/**
+ * Merge generated and existing text files while keeping line order stable.
+ *
+ * Existing unique lines are appended after the primary content, duplicate
+ * non-empty lines are removed, and runs of more than two blank lines collapse
+ * to a single empty separator.
+ *
+ * @param primaryContent Newly generated text that should appear first.
+ * @param existingContent Existing file contents preserved after unique generated lines.
+ * @returns The merged text block with a trailing newline.
+ */
+export declare function mergeTextLines(primaryContent: string, existingContent: string): string;

package/dist/runtime/scaffold-documents.js

@@ -0,0 +1,144 @@
+import { getPrimaryDevelopmentScript } from './local-dev-presets.js';
+import { getCompoundExtensionWorkflowSection, getInitialCommitCommands, getInitialCommitNote, getOptionalOnboardingNote, getOptionalOnboardingSteps, getQuickStartWorkflowNote, getPhpRestExtensionPointsSection, getTemplateSourceOfTruthNote, } from './scaffold-onboarding.js';
+import { formatInstallCommand, formatRunScript, } from './package-managers.js';
+/**
+ * Builds the generated README markdown for one scaffolded project.
+ *
+ * @param templateId Scaffold template family or template identifier.
+ * @param variables Interpolated scaffold variables used in generated content.
+ * @param packageManager Package manager used to format install and script commands.
+ * @param options Optional README sections enabled by scaffold presets.
+ * @returns Markdown README content for the generated project root.
+ */
+export function buildReadme(templateId, variables, packageManager, { withMigrationUi = false, withTestPreset = false, withWpEnv = false, } = {}) {
+    const optionalOnboardingSteps = getOptionalOnboardingSteps(packageManager, templateId, {
+        compoundPersistenceEnabled: variables.compoundPersistenceEnabled === 'true',
+    });
+    const initialCommitCommands = getInitialCommitCommands();
+    const sourceOfTruthNote = getTemplateSourceOfTruthNote(templateId, {
+        compoundPersistenceEnabled: variables.compoundPersistenceEnabled === 'true',
+    });
+    const compoundPersistenceEnabled = variables.compoundPersistenceEnabled === 'true';
+    const publicPersistencePolicyNote = variables.isPublicPersistencePolicy === 'true'
+        ? 'Public persistence writes use signed short-lived tokens, per-request ids, and coarse rate limiting by default. Add application-specific abuse controls before using the same pattern for high-value metrics or experiments.'
+        : null;
+    const compoundExtensionWorkflowSection = getCompoundExtensionWorkflowSection(packageManager, templateId);
+    const phpRestExtensionPointsSection = getPhpRestExtensionPointsSection(templateId, {
+        compoundPersistenceEnabled,
+        slug: variables.slug,
+    });
+    const developmentScript = getPrimaryDevelopmentScript(templateId);
+    const wpEnvSection = withWpEnv
+        ? `## Local WordPress\n\n\`\`\`bash\n${formatRunScript(packageManager, 'wp-env:start')}\n${formatRunScript(packageManager, 'wp-env:stop')}\n${formatRunScript(packageManager, 'wp-env:reset')}\n\`\`\``
+        : '';
+    const testPresetSection = withTestPreset
+        ? `## Local Test Preset\n\n\`\`\`bash\n${formatRunScript(packageManager, 'wp-env:start:test')}\n${formatRunScript(packageManager, 'wp-env:wait:test')}\n${formatRunScript(packageManager, 'test:e2e')}\n\`\`\`\n\nThe generated smoke test uses \`.wp-env.test.json\` and verifies that the scaffolded block registers in the WordPress editor.`
+        : '';
+    const migrationSection = withMigrationUi
+        ? `## Migration UI\n\nThis scaffold already includes an initialized migration workspace at \`v1\`, generated deprecated/runtime artifacts, and an editor-embedded migration dashboard. Migration versions are schema lineage labels and are separate from your package or plugin release version. Use the existing CLI commands to snapshot, diff, scaffold, verify, and fuzz future schema changes.\n\n\`\`\`bash\n${formatRunScript(packageManager, 'migration:doctor')}\n${formatRunScript(packageManager, 'migration:verify')}\n${formatRunScript(packageManager, 'migration:fuzz')}\n\`\`\`\n\nRun \`migration:init\` only when retrofitting migration support into an older project that was not scaffolded with \`--with-migration-ui\`.`
+        : '';
+    return `# ${variables.title}
+
+${variables.description}
+
+## Template
+
+${templateId}
+
+## Quick Start
+
+\`\`\`bash
+${formatInstallCommand(packageManager)}
+${formatRunScript(packageManager, developmentScript)}
+\`\`\`
+
+${getQuickStartWorkflowNote(packageManager, templateId, {
+        compoundPersistenceEnabled,
+    })}
+
+## Build and Verify
+
+\`\`\`bash
+${formatRunScript(packageManager, 'build')}
+${formatRunScript(packageManager, 'typecheck')}
+\`\`\`
+
+## Advanced Sync
+
+\`\`\`bash
+${optionalOnboardingSteps.join('\n')}
+\`\`\`
+
+${getOptionalOnboardingNote(packageManager, templateId, {
+        compoundPersistenceEnabled,
+    })}
+
+## Before First Commit
+
+\`\`\`bash
+${initialCommitCommands.join('\n')}
+\`\`\`
+
+${getInitialCommitNote()}
+
+${sourceOfTruthNote}${publicPersistencePolicyNote ? `\n\n${publicPersistencePolicyNote}` : ''}${migrationSection ? `\n\n${migrationSection}` : ''}${compoundExtensionWorkflowSection ? `\n\n${compoundExtensionWorkflowSection}` : ''}${wpEnvSection ? `\n\n${wpEnvSection}` : ''}${testPresetSection ? `\n\n${testPresetSection}` : ''}${phpRestExtensionPointsSection ? `\n\n${phpRestExtensionPointsSection}` : ''}
+`;
+}
+/**
+ * Build the default `.gitignore` contents for a scaffolded project.
+ *
+ * @returns A newline-terminated `.gitignore` string covering dependency, build, editor, OS, and WordPress artifacts.
+ */
+export function buildGitignore() {
+    return `# Dependencies
+node_modules/
+.yarn/
+.pnp.*
+
+# Build
+build/
+dist/
+
+# Editor
+.vscode/
+.idea/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# WordPress
+*.log
+.wp-env/
+`;
+}
+/**
+ * Merge generated and existing text files while keeping line order stable.
+ *
+ * Existing unique lines are appended after the primary content, duplicate
+ * non-empty lines are removed, and runs of more than two blank lines collapse
+ * to a single empty separator.
+ *
+ * @param primaryContent Newly generated text that should appear first.
+ * @param existingContent Existing file contents preserved after unique generated lines.
+ * @returns The merged text block with a trailing newline.
+ */
+export function mergeTextLines(primaryContent, existingContent) {
+    const normalizedPrimary = primaryContent.replace(/\r\n/g, '\n').trimEnd();
+    const normalizedExisting = existingContent.replace(/\r\n/g, '\n').trimEnd();
+    const mergedLines = [];
+    const seen = new Set();
+    for (const line of [...normalizedPrimary.split('\n'), ...normalizedExisting.split('\n')]) {
+        if (line.length === 0 && mergedLines[mergedLines.length - 1] === '') {
+            continue;
+        }
+        if (line.length > 0 && seen.has(line)) {
+            continue;
+        }
+        if (line.length > 0) {
+            seen.add(line);
+        }
+        mergedLines.push(line);
+    }
+    return `${mergedLines.join('\n').replace(/\n{3,}/g, '\n\n')}\n`;
+}

package/dist/runtime/scaffold-template-variables.d.ts

@@ -0,0 +1,9 @@
+import type { ScaffoldAnswers, ScaffoldTemplateVariables } from './scaffold.js';
+/**
+ * Build the normalized template variables used by scaffold rendering.
+ *
+ * @param templateId Selected scaffold template identifier.
+ * @param answers Normalized scaffold answers collected from defaults, flags, and prompts.
+ * @returns Template variables ready for file interpolation and generated artifacts.
+ */
+export declare function getTemplateVariables(templateId: string, answers: ScaffoldAnswers): ScaffoldTemplateVariables;

package/dist/runtime/scaffold-template-variables.js

@@ -0,0 +1,111 @@
+import { buildTemplateVariablesFromBlockSpec, createBuiltInBlockSpec, } from './block-generator-service.js';
+import { getPackageVersions } from './package-versions.js';
+import { buildBlockCssClassName, buildFrontendCssClassName, resolveScaffoldIdentifiers, } from './scaffold-identifiers.js';
+import { BUILTIN_BLOCK_METADATA_VERSION, COMPOUND_CHILD_BLOCK_METADATA_DEFAULTS, getBuiltInTemplateMetadataDefaults, } from './template-defaults.js';
+import { getTemplateById, isBuiltInTemplateId, } from './template-registry.js';
+import { toPascalCase, toSnakeCase, } from './string-case.js';
+/**
+ * Build the normalized template variables used by scaffold rendering.
+ *
+ * @param templateId Selected scaffold template identifier.
+ * @param answers Normalized scaffold answers collected from defaults, flags, and prompts.
+ * @returns Template variables ready for file interpolation and generated artifacts.
+ */
+export function getTemplateVariables(templateId, answers) {
+    if (isBuiltInTemplateId(templateId)) {
+        return buildTemplateVariablesFromBlockSpec(createBuiltInBlockSpec({
+            answers,
+            dataStorageMode: answers.dataStorageMode,
+            persistencePolicy: answers.persistencePolicy,
+            templateId,
+        }));
+    }
+    const { apiClientPackageVersion, blockRuntimePackageVersion, blockTypesPackageVersion, projectToolsPackageVersion, restPackageVersion, } = getPackageVersions();
+    const template = isBuiltInTemplateId(templateId) ? getTemplateById(templateId) : null;
+    const metadataDefaults = isBuiltInTemplateId(templateId)
+        ? getBuiltInTemplateMetadataDefaults(templateId)
+        : null;
+    const identifiers = resolveScaffoldIdentifiers({
+        namespace: answers.namespace,
+        phpPrefix: answers.phpPrefix,
+        slug: answers.slug,
+        textDomain: answers.textDomain,
+    });
+    const slug = identifiers.slug;
+    const slugSnakeCase = toSnakeCase(slug);
+    const pascalCase = toPascalCase(slug);
+    const title = answers.title.trim();
+    const namespace = identifiers.namespace;
+    const description = answers.description.trim();
+    const textDomain = identifiers.textDomain;
+    const phpPrefix = identifiers.phpPrefix;
+    const phpPrefixUpper = phpPrefix.toUpperCase();
+    const compoundChildTitle = `${title} Item`;
+    const cssClassName = buildBlockCssClassName(namespace, slug);
+    const compoundChildCssClassName = buildBlockCssClassName(namespace, `${slug}-item`);
+    const compoundPersistenceEnabled = templateId === 'persistence'
+        ? true
+        : templateId === 'compound'
+            ? Boolean(answers.dataStorageMode || answers.persistencePolicy)
+            : false;
+    const dataStorageMode = templateId === 'persistence' || compoundPersistenceEnabled
+        ? answers.dataStorageMode ?? 'custom-table'
+        : 'custom-table';
+    const persistencePolicy = templateId === 'persistence' || compoundPersistenceEnabled
+        ? answers.persistencePolicy ?? 'authenticated'
+        : 'authenticated';
+    return {
+        apiClientPackageVersion,
+        author: answers.author.trim(),
+        blockRuntimePackageVersion,
+        blockMetadataVersion: BUILTIN_BLOCK_METADATA_VERSION,
+        blockTypesPackageVersion,
+        category: metadataDefaults?.category ?? template?.defaultCategory ?? 'widgets',
+        icon: metadataDefaults?.icon ?? 'smiley',
+        compoundChildTitle,
+        compoundChildCategory: COMPOUND_CHILD_BLOCK_METADATA_DEFAULTS.category,
+        compoundChildCssClassName,
+        compoundChildIcon: COMPOUND_CHILD_BLOCK_METADATA_DEFAULTS.icon,
+        compoundChildTitleJson: JSON.stringify(compoundChildTitle),
+        compoundPersistenceEnabled: compoundPersistenceEnabled ? 'true' : 'false',
+        projectToolsPackageVersion,
+        cssClassName,
+        dataStorageMode,
+        dashCase: slug,
+        description,
+        frontendCssClassName: buildFrontendCssClassName(cssClassName),
+        isAuthenticatedPersistencePolicy: persistencePolicy === 'authenticated' ? 'true' : 'false',
+        isPublicPersistencePolicy: persistencePolicy === 'public' ? 'true' : 'false',
+        bootstrapCredentialDeclarations: persistencePolicy === 'public'
+            ? "publicWriteExpiresAt?: number & tags.Type< 'uint32' >;\n\tpublicWriteToken?: string & tags.MinLength< 1 > & tags.MaxLength< 512 >;"
+            : "restNonce?: string & tags.MinLength< 1 > & tags.MaxLength< 128 >;",
+        persistencePolicyDescriptionJson: JSON.stringify(persistencePolicy === 'authenticated'
+            ? 'Writes require a logged-in user and a valid REST nonce.'
+            : 'Anonymous writes use signed short-lived public tokens, per-request ids, and coarse rate limiting.'),
+        keyword: slug.replace(/-/g, ' '),
+        namespace,
+        needsMigration: '{{needsMigration}}',
+        pascalCase,
+        phpPrefix,
+        phpPrefixUpper,
+        restPackageVersion,
+        publicWriteRequestIdDeclaration: persistencePolicy === 'public'
+            ? "publicWriteRequestId: string & tags.MinLength< 1 > & tags.MaxLength< 128 >;"
+            : "publicWriteRequestId?: string & tags.MinLength< 1 > & tags.MaxLength< 128 >;",
+        restWriteAuthIntent: persistencePolicy === 'public'
+            ? 'public-write-protected'
+            : 'authenticated',
+        restWriteAuthMechanism: persistencePolicy === 'public' ? 'public-signed-token' : 'rest-nonce',
+        restWriteAuthMode: persistencePolicy === 'public' ? 'public-signed-token' : 'authenticated-rest-nonce',
+        slug,
+        slugCamelCase: pascalCase.charAt(0).toLowerCase() + pascalCase.slice(1),
+        slugKebabCase: slug,
+        slugSnakeCase,
+        textDomain,
+        textdomain: textDomain,
+        title,
+        titleJson: JSON.stringify(title),
+        titleCase: pascalCase,
+        persistencePolicy,
+    };
+}

package/dist/runtime/scaffold.d.ts

@@ -81,19 +81,25 @@ export interface ScaffoldTemplateVariables extends Record<string, string> {
  * can surface custom ids. Downstream code uses `isBuiltInTemplateId()` to
  * distinguish built-in templates from custom sources.
  */
-interface ResolveTemplateOptions {
+export interface ResolveTemplateOptions {
     isInteractive?: boolean;
     selectTemplate?: () => Promise<string>;
     templateId?: string;
     yes?: boolean;
 }
-interface ResolvePackageManagerOptions {
+/**
+ * Options for resolving the package manager in CLI and interactive scaffold flows.
+ */
+export interface ResolvePackageManagerOptions {
     isInteractive?: boolean;
     packageManager?: string;
     selectPackageManager?: () => Promise<PackageManagerId>;
     yes?: boolean;
 }
-interface CollectScaffoldAnswersOptions {
+/**
+ * Options for collecting scaffold answers from defaults, overrides, and prompts.
+ */
+export interface CollectScaffoldAnswersOptions {
     dataStorageMode?: DataStorageMode;
     namespace?: string;
     phpPrefix?: string;
@@ -139,12 +145,8 @@ export interface ScaffoldProjectResult {
     warnings: string[];
 }
 export { buildBlockCssClassName } from "./scaffold-identifiers.js";
+export { collectScaffoldAnswers, detectAuthor, getDefaultAnswers, resolvePackageManagerId, resolveTemplateId, } from "./scaffold-answer-resolution.js";
+export { getTemplateVariables } from "./scaffold-template-variables.js";
 export declare function isDataStorageMode(value: string): value is DataStorageMode;
 export declare function isPersistencePolicy(value: string): value is PersistencePolicy;
-export declare function detectAuthor(): string;
-export declare function getDefaultAnswers(projectName: string, templateId: string): ScaffoldAnswers;
-export declare function resolveTemplateId({ templateId, yes, isInteractive, selectTemplate, }: ResolveTemplateOptions): Promise<string>;
-export declare function resolvePackageManagerId({ packageManager, yes, isInteractive, selectPackageManager, }: ResolvePackageManagerOptions): Promise<PackageManagerId>;
-export declare function collectScaffoldAnswers({ projectName, templateId, yes, dataStorageMode, namespace, persistencePolicy, phpPrefix, promptText, textDomain, }: CollectScaffoldAnswersOptions): Promise<ScaffoldAnswers>;
-export declare function getTemplateVariables(templateId: string, answers: ScaffoldAnswers): ScaffoldTemplateVariables;
 export declare function scaffoldProject({ projectDir, templateId, answers, dataStorageMode, persistencePolicy, packageManager, externalLayerId, externalLayerSource, externalLayerSourceLabel, repositoryReference, cwd, allowExistingDir, noInstall, installDependencies, variant, withMigrationUi, withTestPreset, withWpEnv, }: ScaffoldProjectOptions): Promise<ScaffoldProjectResult>;

package/dist/runtime/scaffold.js

@@ -1,230 +1,34 @@
 import fs from "node:fs";
 import { promises as fsp } from "node:fs";
 import path from "node:path";
-import { execSync } from "node:child_process";
-import { PACKAGE_MANAGER_IDS, getPackageManager, } from "./package-managers.js";
+import { getPackageManager } from "./package-managers.js";
 import { buildGitignore, buildReadme, mergeTextLines, replaceTextRecursively, } from "./scaffold-apply-utils.js";
-import { buildBlockCssClassName, buildFrontendCssClassName, normalizeBlockSlug, resolveScaffoldIdentifiers, validateBlockSlug, validateNamespace, } from "./scaffold-identifiers.js";
 import { applyGeneratedProjectDxPackageJson, applyLocalDevPresetFiles, } from "./local-dev-presets.js";
 import { applyMigrationUiCapability } from "./migration-ui-capability.js";
-import { getPackageVersions } from "./package-versions.js";
 import { applyWorkspaceMigrationCapability, ensureScaffoldDirectory, isOfficialWorkspaceProject, seedBuiltInPersistenceArtifacts, writeStarterManifestFiles, } from "./scaffold-bootstrap.js";
 import { defaultInstallDependencies, normalizePackageJson, normalizePackageManagerFiles, removeUnexpectedLockfiles, } from "./scaffold-package-manager-files.js";
-import { toPascalCase, toSnakeCase, toTitleCase, } from "./string-case.js";
-import { BUILTIN_BLOCK_METADATA_VERSION, COMPOUND_CHILD_BLOCK_METADATA_DEFAULTS, getBuiltInTemplateMetadataDefaults, getRemovedBuiltInTemplateMessage, isRemovedBuiltInTemplateId, } from "./template-defaults.js";
 import { copyInterpolatedDirectory } from "./template-render.js";
-import { OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE, TEMPLATE_IDS, getTemplateById, isBuiltInTemplateId, } from "./template-registry.js";
+import { OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE, isBuiltInTemplateId, } from "./template-registry.js";
 import { resolveTemplateSource } from "./template-source.js";
-import { BlockGeneratorService, buildTemplateVariablesFromBlockSpec, createBuiltInBlockSpec, } from "./block-generator-service.js";
+import { BlockGeneratorService, } from "./block-generator-service.js";
+import { getTemplateVariables } from "./scaffold-template-variables.js";
 const WORKSPACE_TEMPLATE_ALIAS = "workspace";
 export const DATA_STORAGE_MODES = ["post-meta", "custom-table"];
 export const PERSISTENCE_POLICIES = ["authenticated", "public"];
 export { buildBlockCssClassName } from "./scaffold-identifiers.js";
+export { collectScaffoldAnswers, detectAuthor, getDefaultAnswers, resolvePackageManagerId, resolveTemplateId, } from "./scaffold-answer-resolution.js";
+export { getTemplateVariables } from "./scaffold-template-variables.js";
 export function isDataStorageMode(value) {
     return DATA_STORAGE_MODES.includes(value);
 }
 export function isPersistencePolicy(value) {
     return PERSISTENCE_POLICIES.includes(value);
 }
-export function detectAuthor() {
-    try {
-        return (execSync("git config user.name", {
-            encoding: "utf8",
-            stdio: ["ignore", "pipe", "ignore"],
-        }).trim() || "Your Name");
-    }
-    catch {
-        return "Your Name";
-    }
-}
-export function getDefaultAnswers(projectName, templateId) {
-    const template = isBuiltInTemplateId(templateId) ? getTemplateById(templateId) : null;
-    const slugDefault = normalizeBlockSlug(projectName) || "my-wp-typia-block";
-    return {
-        author: detectAuthor(),
-        dataStorageMode: templateId === "persistence" ? "custom-table" : undefined,
-        description: template?.description ?? "A WordPress block scaffolded from a remote template",
-        namespace: slugDefault,
-        persistencePolicy: templateId === "persistence" ? "authenticated" : undefined,
-        phpPrefix: toSnakeCase(slugDefault),
-        slug: slugDefault,
-        textDomain: slugDefault,
-        title: toTitleCase(slugDefault),
-    };
-}
 function normalizeTemplateSelection(templateId) {
     return templateId === WORKSPACE_TEMPLATE_ALIAS
         ? OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE
         : templateId;
 }
-export async function resolveTemplateId({ templateId, yes = false, isInteractive = false, selectTemplate, }) {
-    if (templateId) {
-        const normalizedTemplateId = normalizeTemplateSelection(templateId);
-        if (isRemovedBuiltInTemplateId(templateId)) {
-            throw new Error(getRemovedBuiltInTemplateMessage(templateId));
-        }
-        if (isBuiltInTemplateId(normalizedTemplateId)) {
-            return getTemplateById(normalizedTemplateId).id;
-        }
-        return normalizedTemplateId;
-    }
-    if (yes) {
-        return "basic";
-    }
-    if (!isInteractive || !selectTemplate) {
-        throw new Error(`Template is required in non-interactive mode. Use --template <${TEMPLATE_IDS.join("|")}|./path|github:owner/repo/path[#ref]|npm-package>.`);
-    }
-    return normalizeTemplateSelection(await selectTemplate());
-}
-export async function resolvePackageManagerId({ packageManager, yes = false, isInteractive = false, selectPackageManager, }) {
-    if (packageManager) {
-        return getPackageManager(packageManager).id;
-    }
-    if (yes) {
-        return "npm";
-    }
-    if (!isInteractive || !selectPackageManager) {
-        throw new Error(`Package manager is required in non-interactive mode. Use --package-manager <${PACKAGE_MANAGER_IDS.join("|")}>.`);
-    }
-    return selectPackageManager();
-}
-export async function collectScaffoldAnswers({ projectName, templateId, yes = false, dataStorageMode, namespace, persistencePolicy, phpPrefix, promptText, textDomain, }) {
-    const defaults = getDefaultAnswers(projectName, templateId);
-    if (yes) {
-        const identifiers = resolveScaffoldIdentifiers({
-            namespace: namespace ?? defaults.namespace,
-            phpPrefix,
-            slug: defaults.slug,
-            textDomain,
-        });
-        return {
-            ...defaults,
-            dataStorageMode: dataStorageMode ?? defaults.dataStorageMode,
-            namespace: identifiers.namespace,
-            persistencePolicy: persistencePolicy ?? defaults.persistencePolicy,
-            phpPrefix: identifiers.phpPrefix,
-            textDomain: identifiers.textDomain,
-        };
-    }
-    if (!promptText) {
-        throw new Error("Interactive answers require a promptText callback.");
-    }
-    const identifiers = resolveScaffoldIdentifiers({
-        namespace: namespace ?? (await promptText("Namespace", defaults.namespace, validateNamespace)),
-        phpPrefix,
-        slug: await promptText("Block slug", defaults.slug, validateBlockSlug),
-        textDomain,
-    });
-    return {
-        author: await promptText("Author", defaults.author),
-        dataStorageMode: dataStorageMode ?? defaults.dataStorageMode,
-        description: await promptText("Description", defaults.description),
-        namespace: identifiers.namespace,
-        persistencePolicy: persistencePolicy ?? defaults.persistencePolicy,
-        phpPrefix: identifiers.phpPrefix,
-        slug: identifiers.slug,
-        textDomain: identifiers.textDomain,
-        title: await promptText("Block title", toTitleCase(identifiers.slug)),
-    };
-}
-export function getTemplateVariables(templateId, answers) {
-    if (isBuiltInTemplateId(templateId)) {
-        return buildTemplateVariablesFromBlockSpec(createBuiltInBlockSpec({
-            answers,
-            dataStorageMode: answers.dataStorageMode,
-            persistencePolicy: answers.persistencePolicy,
-            templateId,
-        }));
-    }
-    const { apiClientPackageVersion, blockRuntimePackageVersion, blockTypesPackageVersion, projectToolsPackageVersion, restPackageVersion, } = getPackageVersions();
-    const template = isBuiltInTemplateId(templateId) ? getTemplateById(templateId) : null;
-    const metadataDefaults = isBuiltInTemplateId(templateId)
-        ? getBuiltInTemplateMetadataDefaults(templateId)
-        : null;
-    const identifiers = resolveScaffoldIdentifiers({
-        namespace: answers.namespace,
-        phpPrefix: answers.phpPrefix,
-        slug: answers.slug,
-        textDomain: answers.textDomain,
-    });
-    const slug = identifiers.slug;
-    const slugSnakeCase = toSnakeCase(slug);
-    const pascalCase = toPascalCase(slug);
-    const title = answers.title.trim();
-    const namespace = identifiers.namespace;
-    const description = answers.description.trim();
-    const textDomain = identifiers.textDomain;
-    const phpPrefix = identifiers.phpPrefix;
-    const phpPrefixUpper = phpPrefix.toUpperCase();
-    const compoundChildTitle = `${title} Item`;
-    const cssClassName = buildBlockCssClassName(namespace, slug);
-    const compoundChildCssClassName = buildBlockCssClassName(namespace, `${slug}-item`);
-    const compoundPersistenceEnabled = templateId === "persistence"
-        ? true
-        : templateId === "compound"
-            ? Boolean(answers.dataStorageMode || answers.persistencePolicy)
-            : false;
-    const dataStorageMode = templateId === "persistence" || compoundPersistenceEnabled
-        ? answers.dataStorageMode ?? "custom-table"
-        : "custom-table";
-    const persistencePolicy = templateId === "persistence" || compoundPersistenceEnabled
-        ? answers.persistencePolicy ?? "authenticated"
-        : "authenticated";
-    return {
-        apiClientPackageVersion,
-        author: answers.author.trim(),
-        blockRuntimePackageVersion,
-        blockMetadataVersion: BUILTIN_BLOCK_METADATA_VERSION,
-        blockTypesPackageVersion,
-        category: metadataDefaults?.category ?? template?.defaultCategory ?? "widgets",
-        icon: metadataDefaults?.icon ?? "smiley",
-        compoundChildTitle,
-        compoundChildCategory: COMPOUND_CHILD_BLOCK_METADATA_DEFAULTS.category,
-        compoundChildCssClassName,
-        compoundChildIcon: COMPOUND_CHILD_BLOCK_METADATA_DEFAULTS.icon,
-        compoundChildTitleJson: JSON.stringify(compoundChildTitle),
-        compoundPersistenceEnabled: compoundPersistenceEnabled ? "true" : "false",
-        projectToolsPackageVersion,
-        cssClassName,
-        dataStorageMode,
-        dashCase: slug,
-        description,
-        frontendCssClassName: buildFrontendCssClassName(cssClassName),
-        isAuthenticatedPersistencePolicy: persistencePolicy === "authenticated" ? "true" : "false",
-        isPublicPersistencePolicy: persistencePolicy === "public" ? "true" : "false",
-        bootstrapCredentialDeclarations: persistencePolicy === "public"
-            ? "publicWriteExpiresAt?: number & tags.Type< 'uint32' >;\n\tpublicWriteToken?: string & tags.MinLength< 1 > & tags.MaxLength< 512 >;"
-            : "restNonce?: string & tags.MinLength< 1 > & tags.MaxLength< 128 >;",
-        persistencePolicyDescriptionJson: JSON.stringify(persistencePolicy === "authenticated"
-            ? "Writes require a logged-in user and a valid REST nonce."
-            : "Anonymous writes use signed short-lived public tokens, per-request ids, and coarse rate limiting."),
-        keyword: slug.replace(/-/g, " "),
-        namespace,
-        needsMigration: "{{needsMigration}}",
-        pascalCase,
-        phpPrefix,
-        phpPrefixUpper,
-        restPackageVersion,
-        publicWriteRequestIdDeclaration: persistencePolicy === "public"
-            ? "publicWriteRequestId: string & tags.MinLength< 1 > & tags.MaxLength< 128 >;"
-            : "publicWriteRequestId?: string & tags.MinLength< 1 > & tags.MaxLength< 128 >;",
-        restWriteAuthIntent: persistencePolicy === "public"
-            ? "public-write-protected"
-            : "authenticated",
-        restWriteAuthMechanism: persistencePolicy === "public" ? "public-signed-token" : "rest-nonce",
-        restWriteAuthMode: persistencePolicy === "public" ? "public-signed-token" : "authenticated-rest-nonce",
-        slug,
-        slugCamelCase: pascalCase.charAt(0).toLowerCase() + pascalCase.slice(1),
-        slugKebabCase: slug,
-        slugSnakeCase,
-        textDomain,
-        textdomain: textDomain,
-        title,
-        titleJson: JSON.stringify(title),
-        titleCase: pascalCase,
-        persistencePolicy,
-    };
-}
 export async function scaffoldProject({ projectDir, templateId, answers, dataStorageMode, persistencePolicy, packageManager, externalLayerId, externalLayerSource, externalLayerSourceLabel, repositoryReference, cwd = process.cwd(), allowExistingDir = false, noInstall = false, installDependencies = undefined, variant, withMigrationUi = false, withTestPreset = false, withWpEnv = false, }) {
     const resolvedTemplateId = normalizeTemplateSelection(templateId);
     const resolvedPackageManager = getPackageManager(packageManager).id;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wp-typia/project-tools",
-  "version": "0.16.13",
+  "version": "0.16.14",
   "description": "Project orchestration and programmatic tooling for wp-typia",
   "packageManager": "bun@1.3.11",
   "type": "module",
@@ -120,8 +120,8 @@
   },
   "dependencies": {
     "@wp-typia/api-client": "^0.4.5",
-    "@wp-typia/block-runtime": "^0.4.9",
-    "@wp-typia/rest": "^0.3.9",
+    "@wp-typia/block-runtime": "^0.4.10",
+    "@wp-typia/rest": "^0.3.10",
     "@wp-typia/block-types": "^0.2.4",
     "mustache": "^4.2.0",
     "npm-package-arg": "^13.0.0",