wp-typia 0.22.2 → 0.22.3

package/dist-bunli/node-cli.js

@@ -3,7 +3,7 @@ var __require = /* @__PURE__ */ createRequire(import.meta.url);
 // package.json
 var package_default = {
   name: "wp-typia",
-  version: "0.22.2",
+  version: "0.22.3",
   description: "Canonical CLI package for wp-typia scaffolding and project workflows",
   packageManager: "bun@1.3.11",
   type: "module",
@@ -73,7 +73,7 @@ var package_default = {
     "@bunli/tui": "0.6.0",
     "@bunli/utils": "0.6.0",
     "@wp-typia/api-client": "^0.4.5",
-    "@wp-typia/project-tools": "0.22.2",
+    "@wp-typia/project-tools": "0.22.3",
     "better-result": "^2.7.0",
     react: "^19.2.5",
     "react-dom": "^19.2.5",
@@ -97,9 +97,9 @@ var package_default = {
 
 // src/node-cli.ts
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES5,
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES6,
   createCliCommandError as createCliCommandError2,
-  createCliDiagnosticCodeError as createCliDiagnosticCodeError5,
+  createCliDiagnosticCodeError as createCliDiagnosticCodeError6,
   formatCliDiagnosticError,
   serializeCliDiagnosticError as serializeCliDiagnosticError2
 } from "@wp-typia/project-tools/cli-diagnostics";
@@ -653,8 +653,8 @@ import {
 
 // src/add-kind-registry.ts
 import {
-  CLI_DIAGNOSTIC_CODES,
-  createCliDiagnosticCodeError
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES2,
+  createCliDiagnosticCodeError as createCliDiagnosticCodeError2
 } from "@wp-typia/project-tools/cli-diagnostics";
 
 // src/add-kind-ids.ts
@@ -673,6 +673,66 @@ var ADD_KIND_IDS = [
   "editor-plugin"
 ];
 
+// src/cli-string-flags.ts
+import {
+  CLI_DIAGNOSTIC_CODES,
+  createCliDiagnosticCodeError
+} from "@wp-typia/project-tools/cli-diagnostics";
+function readOptionalCliStringFlagValue(flags, name, mode) {
+  const value = flags[name];
+  if (value === undefined || value === null) {
+    return;
+  }
+  if (typeof value !== "string") {
+    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, `\`--${name}\` requires a value.`);
+  }
+  const trimmed = value.trim();
+  if (trimmed.length === 0) {
+    if (mode === "strict") {
+      throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, `\`--${name}\` requires a value.`);
+    }
+    return;
+  }
+  return mode === "strict" ? value : trimmed;
+}
+function readOptionalLooseStringFlag(flags, name) {
+  return readOptionalCliStringFlagValue(flags, name, "loose");
+}
+function readOptionalStrictStringFlag(flags, name) {
+  return readOptionalCliStringFlagValue(flags, name, "strict");
+}
+function requireStrictStringFlag(flags, name, message) {
+  const value = readOptionalStrictStringFlag(flags, name);
+  if (!value) {
+    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, message);
+  }
+  return value;
+}
+function readOptionalPairedStrictStringFlags(flags, leftName, rightName, message) {
+  const leftValue = readOptionalStrictStringFlag(flags, leftName);
+  const rightValue = readOptionalStrictStringFlag(flags, rightName);
+  if (Boolean(leftValue) !== Boolean(rightValue)) {
+    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, message);
+  }
+  return [leftValue, rightValue];
+}
+
+// src/external-layer-prompt-options.ts
+function formatExternalLayerSelectHint(option) {
+  const details = [
+    option.description,
+    option.extends.length > 0 ? `extends ${option.extends.join(", ")}` : undefined
+  ].filter((value) => typeof value === "string" && value.length > 0);
+  return details.length > 0 ? details.join(" · ") : undefined;
+}
+function toExternalLayerPromptOptions(options) {
+  return options.map((option) => ({
+    hint: formatExternalLayerSelectHint(option),
+    label: option.id,
+    value: option.id
+  }));
+}
+
 // src/add-kind-registry.ts
 var BLOCK_VISIBLE_FIELD_ORDER = [
   "kind",
@@ -731,51 +791,12 @@ var NAME_NAMESPACE_VISIBLE_FIELDS = [
   "name",
   "namespace"
 ];
-function readOptionalStringFlag(flags, name) {
-  const value = flags[name];
-  if (value === undefined || value === null) {
-    return;
-  }
-  if (typeof value !== "string" || value.trim().length === 0) {
-    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, `\`--${name}\` requires a value.`);
-  }
-  return value;
-}
-function requireStringFlag(flags, name, message) {
-  const value = readOptionalStringFlag(flags, name);
-  if (!value) {
-    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, message);
-  }
-  return value;
-}
-function readOptionalPairedStringFlags(flags, leftName, rightName, message) {
-  const leftValue = readOptionalStringFlag(flags, leftName);
-  const rightValue = readOptionalStringFlag(flags, rightName);
-  if (Boolean(leftValue) !== Boolean(rightValue)) {
-    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, message);
-  }
-  return [leftValue, rightValue];
-}
 function requireAddKindName(context, message) {
   if (!context.name) {
-    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, message);
+    throw createCliDiagnosticCodeError2(CLI_DIAGNOSTIC_CODES2.MISSING_ARGUMENT, message);
   }
   return context.name;
 }
-function formatExternalLayerSelectHint(option) {
-  const details = [
-    option.description,
-    option.extends.length > 0 ? `extends ${option.extends.join(", ")}` : undefined
-  ].filter((value) => typeof value === "string" && value.length > 0);
-  return details.length > 0 ? details.join(" · ") : undefined;
-}
-function toExternalLayerPromptOptions(options) {
-  return options.map((option) => ({
-    hint: formatExternalLayerSelectHint(option),
-    label: option.id,
-    value: option.id
-  }));
-}
 function defineAddKindRegistryEntry(entry) {
   return entry;
 }
@@ -809,7 +830,7 @@ var ADD_KIND_REGISTRY = {
     nameLabel: "Admin view name",
     async prepareExecution(context) {
       const name = requireAddKindName(context, "`wp-typia add admin-view` requires <name>. Usage: wp-typia add admin-view <name> [--source <rest-resource:slug|core-data:kind/name>].");
-      const source = readOptionalStringFlag(context.flags, "source");
+      const source = readOptionalStrictStringFlag(context.flags, "source");
       return createNamedExecutionPlan(context, {
         execute: ({ cwd, name: name2 }) => context.addRuntime.runAddAdminViewCommand({
           adminViewName: name2,
@@ -849,7 +870,7 @@ var ADD_KIND_REGISTRY = {
     nameLabel: "Binding source name",
     async prepareExecution(context) {
       const name = requireAddKindName(context, "`wp-typia add binding-source` requires <name>. Usage: wp-typia add binding-source <name> [--block <block-slug|namespace/block-slug> --attribute <attribute>].");
-      const [blockName, attributeName] = readOptionalPairedStringFlags(context.flags, "block", "attribute", "`wp-typia add binding-source` requires --block and --attribute to be provided together.");
+      const [blockName, attributeName] = readOptionalPairedStrictStringFlags(context.flags, "block", "attribute", "`wp-typia add binding-source` requires --block and --attribute to be provided together.");
       return createNamedExecutionPlan(context, {
         execute: ({ cwd, name: name2 }) => context.addRuntime.runAddBindingSourceCommand({
           attributeName,
@@ -889,15 +910,15 @@ var ADD_KIND_REGISTRY = {
     nameLabel: "Block name",
     async prepareExecution(context) {
       const name = requireAddKindName(context, "`wp-typia add block` requires <name>. Usage: wp-typia add block <name> [--template <basic|interactivity|persistence|compound>]");
-      const externalLayerId = readOptionalStringFlag(context.flags, "external-layer-id");
-      const externalLayerSource = readOptionalStringFlag(context.flags, "external-layer-source");
+      const externalLayerId = readOptionalStrictStringFlag(context.flags, "external-layer-id");
+      const externalLayerSource = readOptionalStrictStringFlag(context.flags, "external-layer-source");
       const shouldPromptForLayerSelection = Boolean(externalLayerSource) && !Boolean(externalLayerId) && context.isInteractiveSession;
       const selectPrompt = shouldPromptForLayerSelection ? await context.getOrCreatePrompt() : undefined;
-      const alternateRenderTargets = readOptionalStringFlag(context.flags, "alternate-render-targets");
-      const dataStorageMode = readOptionalStringFlag(context.flags, "data-storage");
-      const innerBlocksPreset = readOptionalStringFlag(context.flags, "inner-blocks-preset");
-      const persistencePolicy = readOptionalStringFlag(context.flags, "persistence-policy");
-      let resolvedTemplateId = readOptionalStringFlag(context.flags, "template");
+      const alternateRenderTargets = readOptionalStrictStringFlag(context.flags, "alternate-render-targets");
+      const dataStorageMode = readOptionalStrictStringFlag(context.flags, "data-storage");
+      const innerBlocksPreset = readOptionalStrictStringFlag(context.flags, "inner-blocks-preset");
+      const persistencePolicy = readOptionalStrictStringFlag(context.flags, "persistence-policy");
+      let resolvedTemplateId = readOptionalStrictStringFlag(context.flags, "template");
       if (!resolvedTemplateId && context.isInteractiveSession) {
         const templatePrompt = await context.getOrCreatePrompt();
         resolvedTemplateId = await templatePrompt.select("Select a block template", context.addRuntime.ADD_BLOCK_TEMPLATE_IDS.map((templateId) => ({
@@ -994,7 +1015,7 @@ var ADD_KIND_REGISTRY = {
     nameLabel: "Editor plugin name",
     async prepareExecution(context) {
       const name = requireAddKindName(context, "`wp-typia add editor-plugin` requires <name>. Usage: wp-typia add editor-plugin <name> [--slot <sidebar|document-setting-panel>].");
-      const slot = readOptionalStringFlag(context.flags, "slot");
+      const slot = readOptionalStrictStringFlag(context.flags, "slot");
       return createNamedExecutionPlan(context, {
         execute: ({ cwd, name: name2 }) => context.addRuntime.runAddEditorPluginCommand({
           cwd,
@@ -1032,8 +1053,8 @@ var ADD_KIND_REGISTRY = {
     nameLabel: "Target block",
     async prepareExecution(context) {
       const name = requireAddKindName(context, "`wp-typia add hooked-block` requires <block-slug>. Usage: wp-typia add hooked-block <block-slug> --anchor <anchor-block-name> --position <before|after|firstChild|lastChild>.");
-      const anchorBlockName = requireStringFlag(context.flags, "anchor", "`wp-typia add hooked-block` requires --anchor <anchor-block-name>.");
-      const position = requireStringFlag(context.flags, "position", "`wp-typia add hooked-block` requires --position <before|after|firstChild|lastChild>.");
+      const anchorBlockName = requireStrictStringFlag(context.flags, "anchor", "`wp-typia add hooked-block` requires --anchor <anchor-block-name>.");
+      const position = requireStrictStringFlag(context.flags, "position", "`wp-typia add hooked-block` requires --position <before|after|firstChild|lastChild>.");
       return createNamedExecutionPlan(context, {
         execute: ({ cwd, name: name2 }) => context.addRuntime.runAddHookedBlockCommand({
           anchorBlockName,
@@ -1103,7 +1124,7 @@ var ADD_KIND_REGISTRY = {
     nameLabel: "Style name",
     async prepareExecution(context) {
       const name = requireAddKindName(context, "`wp-typia add style` requires <name>. Usage: wp-typia add style <name> --block <block-slug>.");
-      const blockSlug = requireStringFlag(context.flags, "block", "`wp-typia add style` requires --block <block-slug>.");
+      const blockSlug = requireStrictStringFlag(context.flags, "block", "`wp-typia add style` requires --block <block-slug>.");
       return createNamedExecutionPlan(context, {
         execute: ({ cwd, name: name2 }) => context.addRuntime.runAddBlockStyleCommand({
           blockName: blockSlug,
@@ -1141,8 +1162,8 @@ var ADD_KIND_REGISTRY = {
     nameLabel: "Transform name",
     async prepareExecution(context) {
       const name = requireAddKindName(context, "`wp-typia add transform` requires <name>. Usage: wp-typia add transform <name> --from <namespace/block> --to <block-slug|namespace/block-slug>.");
-      const fromBlockName = requireStringFlag(context.flags, "from", "`wp-typia add transform` requires --from <namespace/block>.");
-      const toBlockName = requireStringFlag(context.flags, "to", "`wp-typia add transform` requires --to <block-slug|namespace/block-slug>.");
+      const fromBlockName = requireStrictStringFlag(context.flags, "from", "`wp-typia add transform` requires --from <namespace/block>.");
+      const toBlockName = requireStrictStringFlag(context.flags, "to", "`wp-typia add transform` requires --to <block-slug|namespace/block-slug>.");
       return createNamedExecutionPlan(context, {
         execute: ({ cwd, name: name2 }) => context.addRuntime.runAddBlockTransformCommand({
           cwd,
@@ -1183,8 +1204,8 @@ var ADD_KIND_REGISTRY = {
     nameLabel: "REST resource name",
     async prepareExecution(context) {
       const name = requireAddKindName(context, "`wp-typia add rest-resource` requires <name>. Usage: wp-typia add rest-resource <name> [--namespace <vendor/v1>] [--methods <list,read,create>].");
-      const methods = readOptionalStringFlag(context.flags, "methods");
-      const namespace = readOptionalStringFlag(context.flags, "namespace");
+      const methods = readOptionalStrictStringFlag(context.flags, "methods");
+      const namespace = readOptionalStrictStringFlag(context.flags, "namespace");
       return createNamedExecutionPlan(context, {
         execute: ({ cwd, name: name2 }) => context.addRuntime.runAddRestResourceCommand({
           cwd,
@@ -1223,7 +1244,7 @@ var ADD_KIND_REGISTRY = {
     nameLabel: "AI feature name",
     async prepareExecution(context) {
       const name = requireAddKindName(context, "`wp-typia add ai-feature` requires <name>. Usage: wp-typia add ai-feature <name> [--namespace <vendor/v1>].");
-      const namespace = readOptionalStringFlag(context.flags, "namespace");
+      const namespace = readOptionalStrictStringFlag(context.flags, "namespace");
       return createNamedExecutionPlan(context, {
         execute: ({ cwd, name: name2 }) => context.addRuntime.runAddAiFeatureCommand({
           aiFeatureName: name2,
@@ -1262,7 +1283,7 @@ var ADD_KIND_REGISTRY = {
     nameLabel: "Variation name",
     async prepareExecution(context) {
       const name = requireAddKindName(context, "`wp-typia add variation` requires <name>. Usage: wp-typia add variation <name> --block <block-slug>");
-      const blockSlug = requireStringFlag(context.flags, "block", "`wp-typia add variation` requires --block <block-slug>.");
+      const blockSlug = requireStrictStringFlag(context.flags, "block", "`wp-typia add variation` requires --block <block-slug>.");
       return createNamedExecutionPlan(context, {
         execute: ({ cwd, name: name2 }) => context.addRuntime.runAddVariationCommand({
           blockName: blockSlug,
@@ -1313,8 +1334,8 @@ import os from "node:os";
 import path from "node:path";
 import { isPlainObject as isRecord } from "@wp-typia/api-client/runtime-primitives";
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES2,
-  createCliDiagnosticCodeError as createCliDiagnosticCodeError2
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES3,
+  createCliDiagnosticCodeError as createCliDiagnosticCodeError3
 } from "@wp-typia/project-tools/cli-diagnostics";
 var WP_TYPIA_CONFIG_SOURCES = [
   "~/.config/wp-typia/config.json",
@@ -1351,7 +1372,7 @@ async function readJsonFile(filePath) {
     return isRecord(parsed) ? parsed : null;
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
-    throw createCliDiagnosticCodeError2(CLI_DIAGNOSTIC_CODES2.INVALID_ARGUMENT, `Unable to parse ${filePath}: ${message}`, error instanceof Error ? { cause: error } : undefined);
+    throw createCliDiagnosticCodeError3(CLI_DIAGNOSTIC_CODES3.INVALID_ARGUMENT, `Unable to parse ${filePath}: ${message}`, error instanceof Error ? { cause: error } : undefined);
   }
 }
 function resolveConfigPath(cwd, source) {
@@ -1404,8 +1425,8 @@ function extractWpTypiaConfigOverride(argv) {
 
 // src/runtime-bridge.ts
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES4,
-  createCliDiagnosticCodeError as createCliDiagnosticCodeError4
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES5,
+  createCliDiagnosticCodeError as createCliDiagnosticCodeError5
 } from "@wp-typia/project-tools/cli-diagnostics";
 
 // src/runtime-bridge-add-dry-run.ts
@@ -1870,20 +1891,6 @@ function printBlock(lines, printLine) {
     printLine(line);
   }
 }
-function formatExternalLayerSelectHint2(option) {
-  const details = [
-    option.description,
-    option.extends.length > 0 ? `extends ${option.extends.join(", ")}` : undefined
-  ].filter((value) => typeof value === "string" && value.length > 0);
-  return details.length > 0 ? details.join(" · ") : undefined;
-}
-function toExternalLayerPromptOptions2(options) {
-  return options.map((option) => ({
-    hint: formatExternalLayerSelectHint2(option),
-    label: option.id,
-    value: option.id
-  }));
-}
 
 // src/runtime-capabilities.ts
 function isInteractiveTerminal({
@@ -1898,8 +1905,8 @@ import { spawnSync } from "node:child_process";
 import fs4 from "node:fs";
 import path4 from "node:path";
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES3,
-  createCliDiagnosticCodeError as createCliDiagnosticCodeError3
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES4,
+  createCliDiagnosticCodeError as createCliDiagnosticCodeError4
 } from "@wp-typia/project-tools/cli-diagnostics";
 var SYNC_INSTALL_MARKERS = [
   "node_modules",
@@ -1915,7 +1922,7 @@ function resolveSyncExecutionTarget(subcommand) {
   if (subcommand === "ai") {
     return "ai";
   }
-  throw createCliDiagnosticCodeError3(CLI_DIAGNOSTIC_CODES3.INVALID_COMMAND, `Unknown sync subcommand "${subcommand}". Expected one of: "ai".`);
+  throw createCliDiagnosticCodeError4(CLI_DIAGNOSTIC_CODES4.INVALID_COMMAND, `Unknown sync subcommand "${subcommand}". Expected one of: "ai".`);
 }
 function formatRunScript(packageManagerId, scriptName, extraArgs = "") {
   const args = extraArgs.trim();
@@ -1943,7 +1950,7 @@ function formatInstallCommand(packageManagerId) {
   }
 }
 function getSyncRootError(cwd) {
-  return createCliDiagnosticCodeError3(CLI_DIAGNOSTIC_CODES3.OUTSIDE_PROJECT_ROOT, `No generated wp-typia project root was found at ${cwd}. Run \`wp-typia sync\` from a scaffolded project or official workspace root that already contains generated sync scripts. If you expected this directory to work, cd into the scaffold root first or rerun the scaffold before syncing.`);
+  return createCliDiagnosticCodeError4(CLI_DIAGNOSTIC_CODES4.OUTSIDE_PROJECT_ROOT, `No generated wp-typia project root was found at ${cwd}. Run \`wp-typia sync\` from a scaffolded project or official workspace root that already contains generated sync scripts. If you expected this directory to work, cd into the scaffold root first or rerun the scaffold before syncing.`);
 }
 function inferSyncPackageManager(cwd, packageManagerField) {
   const field = String(packageManagerField ?? "");
@@ -2033,7 +2040,7 @@ function assertSyncDependenciesInstalled(project, target) {
   if (markerDir) {
     return;
   }
-  throw createCliDiagnosticCodeError3(CLI_DIAGNOSTIC_CODES3.DEPENDENCIES_NOT_INSTALLED, `Project dependencies have not been installed yet. Run \`${formatInstallCommand(project.packageManager)}\` from the project root before \`wp-typia sync\`. The generated sync scripts rely on local tools such as \`tsx\`.`);
+  throw createCliDiagnosticCodeError4(CLI_DIAGNOSTIC_CODES4.DEPENDENCIES_NOT_INSTALLED, `Project dependencies have not been installed yet. Run \`${formatInstallCommand(project.packageManager)}\` from the project root before \`wp-typia sync\`. The generated sync scripts rely on local tools such as \`tsx\`.`);
 }
 function getPackageManagerRunInvocation(packageManager, scriptName, extraArgs) {
   switch (packageManager) {
@@ -2071,7 +2078,7 @@ function buildSyncPlannedCommands(project, extraArgs, target) {
   if (target === "ai") {
     const syncAiCommand2 = createSyncPlannedCommand(project, "sync-ai", extraArgs);
     if (!syncAiCommand2) {
-      throw createCliDiagnosticCodeError3(CLI_DIAGNOSTIC_CODES3.CONFIGURATION_MISSING, `Expected ${project.packageJsonPath} to define a \`sync-ai\` script for \`wp-typia sync ai\`.`);
+      throw createCliDiagnosticCodeError4(CLI_DIAGNOSTIC_CODES4.CONFIGURATION_MISSING, `Expected ${project.packageJsonPath} to define a \`sync-ai\` script for \`wp-typia sync ai\`.`);
     }
     return [syncAiCommand2];
   }
@@ -2080,7 +2087,7 @@ function buildSyncPlannedCommands(project, extraArgs, target) {
   }
   const syncTypesCommand = createSyncPlannedCommand(project, "sync-types", extraArgs);
   if (!syncTypesCommand) {
-    throw createCliDiagnosticCodeError3(CLI_DIAGNOSTIC_CODES3.CONFIGURATION_MISSING, `Expected ${project.packageJsonPath} to define either a \`sync\` or \`sync-types\` script.`);
+    throw createCliDiagnosticCodeError4(CLI_DIAGNOSTIC_CODES4.CONFIGURATION_MISSING, `Expected ${project.packageJsonPath} to define either a \`sync\` or \`sync-types\` script.`);
   }
   const plannedCommands = [syncTypesCommand];
   const syncRestCommand = createSyncPlannedCommand(project, "sync-rest", extraArgs);
@@ -2166,17 +2173,6 @@ function shouldWrapCliCommandError(options) {
   }
   return true;
 }
-function readOptionalLooseStringFlag(flags, name) {
-  const value = flags[name];
-  if (value === undefined || value === null) {
-    return;
-  }
-  if (typeof value !== "string") {
-    throw createCliDiagnosticCodeError4(CLI_DIAGNOSTIC_CODES4.MISSING_ARGUMENT, `\`--${name}\` requires a value.`);
-  }
-  const trimmed = value.trim();
-  return trimmed.length > 0 ? trimmed : undefined;
-}
 function pushFlag(argv, name, value) {
   if (value === undefined || value === null || value === false) {
     return;
@@ -2318,7 +2314,7 @@ async function executeCreateCommand({
       promptText: activePrompt ? (message, defaultValue, validate) => activePrompt.text(message, defaultValue, validate) : undefined,
       queryPostType: readOptionalLooseStringFlag(flags, "query-post-type"),
       selectDataStorage: activePrompt ? () => activePrompt.select("Select a data storage mode", [...DATA_STORAGE_PROMPT_OPTIONS], 1) : undefined,
-      selectExternalLayerId: shouldPromptForExternalLayerSelection && activePrompt ? (options) => activePrompt.select("Select an external layer", toExternalLayerPromptOptions2(options), 1) : undefined,
+      selectExternalLayerId: shouldPromptForExternalLayerSelection && activePrompt ? (options) => activePrompt.select("Select an external layer", toExternalLayerPromptOptions(options), 1) : undefined,
       selectPackageManager: activePrompt ? () => activePrompt.select("Select a package manager", [...PACKAGE_MANAGER_PROMPT_OPTIONS], 1) : undefined,
       selectPersistencePolicy: activePrompt ? () => activePrompt.select("Select a persistence policy", [...PERSISTENCE_POLICY_PROMPT_OPTIONS], 1) : undefined,
       selectTemplate: activePrompt ? () => activePrompt.select("Select a template", getTemplateSelectOptions(), 1) : undefined,
@@ -2371,13 +2367,13 @@ async function executeAddCommand({
       if (emitOutput) {
         printLine(addRuntime.formatAddHelpText());
       }
-      throw createCliDiagnosticCodeError4(CLI_DIAGNOSTIC_CODES4.MISSING_ARGUMENT, `\`wp-typia add\` requires <kind>. Usage: wp-typia add ${formatAddKindUsagePlaceholder()} ...`);
+      throw createCliDiagnosticCodeError5(CLI_DIAGNOSTIC_CODES5.MISSING_ARGUMENT, `\`wp-typia add\` requires <kind>. Usage: wp-typia add ${formatAddKindUsagePlaceholder()} ...`);
     }
     if (!isAddKindId(kind)) {
-      throw createCliDiagnosticCodeError4(CLI_DIAGNOSTIC_CODES4.INVALID_COMMAND, `Unknown add kind "${kind}". Expected one of: ${formatAddKindList()}.`);
+      throw createCliDiagnosticCodeError5(CLI_DIAGNOSTIC_CODES5.INVALID_COMMAND, `Unknown add kind "${kind}". Expected one of: ${formatAddKindList()}.`);
     }
     if (dryRun && !supportsAddKindDryRun(kind)) {
-      throw createCliDiagnosticCodeError4(CLI_DIAGNOSTIC_CODES4.INVALID_ARGUMENT, `\`wp-typia add ${kind}\` does not support \`--dry-run\` yet.`);
+      throw createCliDiagnosticCodeError5(CLI_DIAGNOSTIC_CODES5.INVALID_ARGUMENT, `\`wp-typia add ${kind}\` does not support \`--dry-run\` yet.`);
     }
     const executionContext = {
       addRuntime,
@@ -2429,16 +2425,16 @@ async function executeTemplatesCommand({ flags }, printLine = console.log) {
   }
   if (subcommand === "inspect") {
     if (!flags.id) {
-      throw createCliDiagnosticCodeError4(CLI_DIAGNOSTIC_CODES4.MISSING_ARGUMENT, "`wp-typia templates inspect` requires <template-id>.");
+      throw createCliDiagnosticCodeError5(CLI_DIAGNOSTIC_CODES5.MISSING_ARGUMENT, "`wp-typia templates inspect` requires <template-id>.");
     }
     const template = getTemplateById(flags.id);
     if (!template) {
-      throw createCliDiagnosticCodeError4(CLI_DIAGNOSTIC_CODES4.INVALID_ARGUMENT, `Unknown template "${flags.id}".`);
+      throw createCliDiagnosticCodeError5(CLI_DIAGNOSTIC_CODES5.INVALID_ARGUMENT, `Unknown template "${flags.id}".`);
     }
     printBlock([formatTemplateDetails(template)], printLine);
     return;
   }
-  throw createCliDiagnosticCodeError4(CLI_DIAGNOSTIC_CODES4.INVALID_COMMAND, `Unknown templates subcommand "${subcommand}". Expected list or inspect.`);
+  throw createCliDiagnosticCodeError5(CLI_DIAGNOSTIC_CODES5.INVALID_COMMAND, `Unknown templates subcommand "${subcommand}". Expected list or inspect.`);
 }
 async function executeInitCommand({ apply, cwd, packageManager, projectDir }, options = {}) {
   try {
@@ -2823,7 +2819,7 @@ function parseGlobalFlags(argv) {
     };
   } catch (error) {
     if (error instanceof Error && /\`--format\` requires a value\.|\`--id\` requires a value\./.test(error.message)) {
-      throw createCliDiagnosticCodeError5(CLI_DIAGNOSTIC_CODES5.MISSING_ARGUMENT, error.message);
+      throw createCliDiagnosticCodeError6(CLI_DIAGNOSTIC_CODES6.MISSING_ARGUMENT, error.message);
     }
     throw error;
   }
@@ -2987,7 +2983,7 @@ function renderTemplatesJson(flags, subcommand) {
   const templateId = flags.id;
   if (!templateId) {
     throw createCliCommandError2({
-      code: CLI_DIAGNOSTIC_CODES5.MISSING_ARGUMENT,
+      code: CLI_DIAGNOSTIC_CODES6.MISSING_ARGUMENT,
       command: "templates",
       detailLines: ["`wp-typia templates inspect` requires <template-id>."]
     });
@@ -2995,7 +2991,7 @@ function renderTemplatesJson(flags, subcommand) {
   const template = getTemplateById(templateId);
   if (!template) {
     throw createCliCommandError2({
-      code: CLI_DIAGNOSTIC_CODES5.INVALID_ARGUMENT,
+      code: CLI_DIAGNOSTIC_CODES6.INVALID_ARGUMENT,
       command: "templates",
       detailLines: [`Unknown template "${templateId}".`]
     });
@@ -3006,7 +3002,7 @@ function renderTemplatesJson(flags, subcommand) {
 }
 function renderUnsupportedCommand(command) {
   throw createCliCommandError2({
-    code: CLI_DIAGNOSTIC_CODES5.UNSUPPORTED_COMMAND,
+    code: CLI_DIAGNOSTIC_CODES6.UNSUPPORTED_COMMAND,
     command,
     detailLines: [
       [
@@ -3032,7 +3028,7 @@ async function renderDoctorJson() {
   }, null, 2));
   if (checks.some((check) => check.status === "fail")) {
     throw createCliCommandError3({
-      code: CLI_DIAGNOSTIC_CODES5.DOCTOR_CHECK_FAILED,
+      code: CLI_DIAGNOSTIC_CODES6.DOCTOR_CHECK_FAILED,
       command: "doctor",
       detailLines: getDoctorFailureDetailLines(checks),
       summary: "One or more doctor checks failed."
@@ -3049,7 +3045,7 @@ var NODE_FALLBACK_COMMAND_DISPATCHERS = {
       const { formatAddHelpText } = await import("@wp-typia/project-tools/cli-add");
       printLine(formatAddHelpText());
       throw createCliCommandError2({
-        code: CLI_DIAGNOSTIC_CODES5.MISSING_ARGUMENT,
+        code: CLI_DIAGNOSTIC_CODES6.MISSING_ARGUMENT,
         command: "add",
         detailLines: [
           `\`wp-typia add\` requires <kind>. Usage: wp-typia add ${formatAddKindUsagePlaceholder()} ...`
@@ -3097,7 +3093,7 @@ var NODE_FALLBACK_COMMAND_DISPATCHERS = {
     const projectDir = positionals[1];
     if (!projectDir) {
       throw createCliCommandError2({
-        code: CLI_DIAGNOSTIC_CODES5.MISSING_ARGUMENT,
+        code: CLI_DIAGNOSTIC_CODES6.MISSING_ARGUMENT,
         command: "create",
         detailLines: [
           "`wp-typia create` requires <project-dir>.",
@@ -3208,7 +3204,7 @@ var NODE_FALLBACK_COMMAND_DISPATCHERS = {
     const resolvedSubcommand = templateId ? "inspect" : subcommand ?? "list";
     if (resolvedSubcommand !== "list" && resolvedSubcommand !== "inspect") {
       throw createCliCommandError2({
-        code: CLI_DIAGNOSTIC_CODES5.INVALID_COMMAND,
+        code: CLI_DIAGNOSTIC_CODES6.INVALID_COMMAND,
         command: "templates",
         detailLines: [
           `Unknown templates subcommand "${resolvedSubcommand}". Expected list or inspect.`
@@ -3240,9 +3236,14 @@ async function runNodeCli(argv = process.argv.slice(2)) {
     ...flags
   };
   const [command, subcommand] = positionals;
-  const helpRequested = cliArgv.length === 0 || hasFlagBeforeTerminator(cliArgv, "--help") || command === "help";
+  const helpRequested = hasFlagBeforeTerminator(cliArgv, "--help") || command === "help";
   const helpTarget = command === "help" ? subcommand : command;
   const versionRequested = hasFlagBeforeTerminator(cliArgv, "--version") || command === "version";
+  if (cliArgv.length === 0) {
+    renderGeneralHelp();
+    process.exitCode = 1;
+    return;
+  }
   if (helpRequested) {
     if (helpTarget) {
       const helpRenderer = NODE_FALLBACK_HELP_RENDERERS[helpTarget];
@@ -3304,4 +3305,4 @@ export {
   hasFlagBeforeTerminator
 };
 
-//# debugId=F8B7C97D684FB07764756E2164756E21
+//# debugId=2746E868E408BAB564756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wp-typia",
-  "version": "0.22.2",
+  "version": "0.22.3",
   "description": "Canonical CLI package for wp-typia scaffolding and project workflows",
   "packageManager": "bun@1.3.11",
   "type": "module",
@@ -70,7 +70,7 @@
     "@bunli/tui": "0.6.0",
     "@bunli/utils": "0.6.0",
     "@wp-typia/api-client": "^0.4.5",
-    "@wp-typia/project-tools": "0.22.2",
+    "@wp-typia/project-tools": "0.22.3",
     "better-result": "^2.7.0",
     "react": "^19.2.5",
     "react-dom": "^19.2.5",