wp-typia 0.23.1 → 0.24.0

package/dist-bunli/node-cli.js

@@ -30,7 +30,7 @@ var ADD_OPTION_METADATA = {
     type: "string"
   },
   block: {
-    description: "Target block slug for variation, style, and end-to-end binding-source workflows.",
+    description: "Target block slug/name for variation, core-variation, style, and end-to-end binding-source workflows.",
     type: "string"
   },
   "controller-class": {
@@ -62,6 +62,10 @@ var ADD_OPTION_METADATA = {
     description: "Source full block name (namespace/block) for transform workflows.",
     type: "string"
   },
+  "from-post-meta": {
+    description: "Alias for --post-meta when backing a binding-source scaffold from a typed post-meta contract.",
+    type: "string"
+  },
   "inner-blocks-preset": {
     description: "Compound-only InnerBlocks preset (freeform, ordered, horizontal, locked-structure).",
     type: "string"
@@ -80,6 +84,10 @@ var ADD_OPTION_METADATA = {
     description: "WordPress meta key for post-meta workflows; defaults to _<phpPrefix>_<name>.",
     type: "string"
   },
+  "meta-path": {
+    description: "Top-level post-meta field used as the default binding-source field when --post-meta or --from-post-meta is provided.",
+    type: "string"
+  },
   method: {
     description: "HTTP method for manual REST contract workflows (GET, POST, PUT, PATCH, or DELETE).",
     type: "string"
@@ -100,6 +108,10 @@ var ADD_OPTION_METADATA = {
     description: "WordPress post type key for post-meta workflows.",
     type: "string"
   },
+  "post-meta": {
+    description: "Typed post-meta contract slug used to back a binding-source scaffold.",
+    type: "string"
+  },
   "persistence-policy": {
     description: "Persistence write policy for persistence-capable templates.",
     type: "string"
@@ -129,6 +141,14 @@ var ADD_OPTION_METADATA = {
     description: "REST route pattern relative to the namespace; generated resources use it for item routes and manual/provider contracts may use it as an alias for --path.",
     type: "string"
   },
+  scope: {
+    description: "Pattern catalog scope for pattern workflows (full or section).",
+    type: "string"
+  },
+  "section-role": {
+    description: "Typed section role for section-scoped pattern catalog entries.",
+    type: "string"
+  },
   "secret-field": {
     description: "Write-only request body field for manual settings REST contracts; requires --manual and a request body, typically generated by POST, PUT, or PATCH.",
     type: "string"
@@ -165,6 +185,14 @@ var ADD_OPTION_METADATA = {
     description: "Optional built-in block family for the new block; interactive flows let you choose it when omitted and non-interactive runs default to basic.",
     type: "string"
   },
+  "thumbnail-url": {
+    description: "Optional thumbnail URL or relative path for typed pattern catalog entries.",
+    type: "string"
+  },
+  tags: {
+    description: "Comma-separated tags for typed pattern catalog entries.",
+    type: "string"
+  },
   type: {
     description: "Exported TypeScript type or interface name for standalone contract workflows.",
     type: "string"
@@ -756,10 +784,19 @@ var WP_TYPIA_CONFIG_SOURCES = [
   ".wp-typiarc",
   ".wp-typiarc.json"
 ];
+var wordpressVersionSchema = z2.string().regex(/^\d+\.\d+(?:\.\d+)?$/u, 'expected dotted numeric WordPress version such as "6.7" or "6.7.1"');
 var wpTypiaSchemaSourceSchema = z2.object({
   namespace: z2.string(),
   path: z2.string()
 }).strict();
+var wordpressCompatibilityConfigSchema = z2.object({
+  minVersion: wordpressVersionSchema.optional(),
+  testedVersions: z2.array(wordpressVersionSchema).optional()
+}).strict();
+var blockApiCompatibilityConfigSchema = z2.object({
+  allowUnknownFutureKeys: z2.boolean().optional(),
+  strict: z2.boolean().optional()
+}).strict();
 var createConfigSchema = z2.object({
   "alternate-render-targets": z2.string().optional(),
   "inner-blocks-preset": z2.string().optional(),
@@ -799,8 +836,10 @@ var mcpConfigSchema = z2.object({
 }).strict();
 var wpTypiaUserConfigSchema = z2.object({
   add: addConfigSchema.optional(),
+  compatibility: blockApiCompatibilityConfigSchema.optional(),
   create: createConfigSchema.optional(),
-  mcp: mcpConfigSchema.optional()
+  mcp: mcpConfigSchema.optional(),
+  wordpress: wordpressCompatibilityConfigSchema.optional()
 }).strict();
 function formatIssuePath(issuePath) {
   if (issuePath.length === 0) {
@@ -917,8 +956,8 @@ function extractWpTypiaConfigOverride(argv) {
 
 // src/runtime-bridge-add.ts
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES7,
-  createCliDiagnosticCodeError as createCliDiagnosticCodeError6
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES9,
+  createCliDiagnosticCodeError as createCliDiagnosticCodeError8
 } from "@wp-typia/project-tools/cli-diagnostics";
 
 // src/add-kind-ids.ts
@@ -959,11 +998,13 @@ var NAME_TYPE_VISIBLE_FIELDS = [
   "name",
   "type"
 ];
-var NAME_BLOCK_ATTRIBUTE_VISIBLE_FIELDS = [
+var NAME_BLOCK_ATTRIBUTE_POST_META_VISIBLE_FIELDS = [
   "kind",
   "name",
   "block",
-  "attribute"
+  "attribute",
+  "post-meta",
+  "meta-path"
 ];
 var NAME_BLOCK_VISIBLE_FIELDS = [
   "kind",
@@ -1216,7 +1257,7 @@ var aiFeatureAddKindEntry = defineAddKindRegistryEntry({
 });
 
 // src/add-kinds/binding-source.ts
-var BINDING_SOURCE_MISSING_NAME_MESSAGE = "`wp-typia add binding-source` requires <name>. Usage: wp-typia add binding-source <name> [--block <block-slug|namespace/block-slug> --attribute <attribute>].";
+var BINDING_SOURCE_MISSING_NAME_MESSAGE = "`wp-typia add binding-source` requires <name>. Usage: wp-typia add binding-source <name> [--block <block-slug|namespace/block-slug> --attribute <attribute>] [--from-post-meta <post-meta> --meta-path <field>].";
 var bindingSourceAddKindEntry = defineAddKindRegistryEntry({
   completion: {
     nextSteps: (values) => [
@@ -1224,11 +1265,18 @@ var bindingSourceAddKindEntry = defineAddKindRegistryEntry({
       ...values.blockSlug && values.attributeName ? [
         `Review src/blocks/${values.blockSlug}/block.json for the ${values.attributeName} bindable attribute.`
       ] : [],
+      ...values.postMetaSlug ? [
+        `Run wp-typia sync-rest --check after editing ${values.schemaFile}.`
+      ] : [],
       "Run your workspace build or dev command to verify the binding source hooks and editor registration."
     ],
     summaryLines: (values, projectDir) => [
       `Binding source: ${values.bindingSourceSlug}`,
       ...values.blockSlug && values.attributeName ? [`Target: ${values.blockSlug}.${values.attributeName}`] : [],
+      ...values.postMetaSlug ? [
+        `Post meta: ${values.postMetaSlug}`,
+        `Meta field: ${values.metaPath}`
+      ] : [],
       `Project directory: ${projectDir}`
     ],
     title: "Added binding source"
@@ -1238,17 +1286,26 @@ var bindingSourceAddKindEntry = defineAddKindRegistryEntry({
   async prepareExecution(context) {
     const name = requireAddKindName(context, BINDING_SOURCE_MISSING_NAME_MESSAGE);
     const [blockName, attributeName] = readOptionalPairedStrictStringFlags(context.flags, "block", "attribute", "`wp-typia add binding-source` requires --block and --attribute to be provided together.");
+    const postMetaName = readOptionalDashedOrCamelStringFlag(context.flags, "from-post-meta", "fromPostMeta") ?? readOptionalDashedOrCamelStringFlag(context.flags, "post-meta", "postMeta");
+    const metaPath = readOptionalDashedOrCamelStringFlag(context.flags, "meta-path", "metaPath");
     return createNamedExecutionPlan(context, {
       execute: ({ cwd, name: name2 }) => context.addRuntime.runAddBindingSourceCommand({
         attributeName,
         bindingSourceName: name2,
         blockName,
-        cwd
+        cwd,
+        metaPath,
+        postMetaName
       }),
       getValues: (result) => ({
         ...result.attributeName ? { attributeName: result.attributeName } : {},
         ...result.blockSlug ? { blockSlug: result.blockSlug } : {},
-        bindingSourceSlug: result.bindingSourceSlug
+        bindingSourceSlug: result.bindingSourceSlug,
+        ...result.metaKey ? { metaKey: result.metaKey } : {},
+        ...result.metaPath ? { metaPath: result.metaPath } : {},
+        ...result.postMetaSlug ? { postMetaSlug: result.postMetaSlug } : {},
+        ...result.postType ? { postType: result.postType } : {},
+        ...result.schemaFile ? { schemaFile: result.schemaFile } : {}
       }),
       missingNameMessage: BINDING_SOURCE_MISSING_NAME_MESSAGE,
       name,
@@ -1257,8 +1314,8 @@ var bindingSourceAddKindEntry = defineAddKindRegistryEntry({
   },
   sortOrder: 70,
   supportsDryRun: true,
-  usage: "wp-typia add binding-source <name> [--block <block-slug|namespace/block-slug> --attribute <attribute>] [--dry-run]",
-  visibleFieldNames: () => NAME_BLOCK_ATTRIBUTE_VISIBLE_FIELDS
+  usage: "wp-typia add binding-source <name> [--block <block-slug|namespace/block-slug> --attribute <attribute>] [--from-post-meta|--post-meta <post-meta> [--meta-path <field>]] [--dry-run]",
+  visibleFieldNames: () => NAME_BLOCK_ATTRIBUTE_POST_META_VISIBLE_FIELDS
 });
 
 // src/external-layer-prompt-options.ts
@@ -1400,6 +1457,78 @@ var contractAddKindEntry = defineAddKindRegistryEntry({
   visibleFieldNames: () => NAME_TYPE_VISIBLE_FIELDS
 });
 
+// src/add-kinds/core-variation.ts
+import {
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES6,
+  createCliDiagnosticCodeError as createCliDiagnosticCodeError5
+} from "@wp-typia/project-tools/cli-diagnostics";
+var CORE_VARIATION_MISSING_NAME_MESSAGE = "`wp-typia add core-variation` requires <name>. Usage: wp-typia add core-variation <block-name> <name> or wp-typia add core-variation <name> --block <namespace/block>.";
+var CORE_VARIATION_MISSING_BLOCK_MESSAGE = "`wp-typia add core-variation` requires <block-name>. Usage: wp-typia add core-variation <block-name> <name> or wp-typia add core-variation <name> --block <namespace/block>.";
+function resolveCoreVariationInputs(context) {
+  const positionalTargetBlockName = context.positionalArgs?.[1];
+  const positionalVariationName = context.positionalArgs?.[2];
+  if (positionalVariationName) {
+    if (!positionalTargetBlockName) {
+      throw createCliDiagnosticCodeError5(CLI_DIAGNOSTIC_CODES6.MISSING_ARGUMENT, CORE_VARIATION_MISSING_BLOCK_MESSAGE);
+    }
+    return {
+      targetBlockName: positionalTargetBlockName,
+      variationName: positionalVariationName
+    };
+  }
+  if (context.name?.includes("/") && !readOptionalStrictStringFlag(context.flags, "block")) {
+    throw createCliDiagnosticCodeError5(CLI_DIAGNOSTIC_CODES6.MISSING_ARGUMENT, CORE_VARIATION_MISSING_NAME_MESSAGE);
+  }
+  const variationName = requireAddKindName(context, CORE_VARIATION_MISSING_NAME_MESSAGE);
+  const targetBlockName = readOptionalStrictStringFlag(context.flags, "block");
+  if (!targetBlockName) {
+    throw createCliDiagnosticCodeError5(CLI_DIAGNOSTIC_CODES6.MISSING_ARGUMENT, CORE_VARIATION_MISSING_BLOCK_MESSAGE);
+  }
+  return {
+    targetBlockName,
+    variationName
+  };
+}
+var coreVariationAddKindEntry = defineAddKindRegistryEntry({
+  completion: {
+    nextSteps: (values) => [
+      `Review ${values.variationFile}.`,
+      "Run your workspace build or dev command to verify the editor-side variation registration."
+    ],
+    summaryLines: (values, projectDir) => [
+      `Core variation: ${values.variationSlug}`,
+      `Target block: ${values.targetBlockName}`,
+      `Project directory: ${projectDir}`
+    ],
+    title: "Added core block variation"
+  },
+  description: "Add an editor-side variation for an existing core or external block",
+  nameLabel: "Variation name",
+  async prepareExecution(context) {
+    const { targetBlockName, variationName } = resolveCoreVariationInputs(context);
+    return createNamedExecutionPlan(context, {
+      execute: ({ cwd, name }) => context.addRuntime.runAddCoreVariationCommand({
+        cwd,
+        targetBlockName,
+        variationName: name
+      }),
+      getValues: (result) => ({
+        targetBlockName: result.targetBlockName,
+        variationFile: result.variationFile,
+        variationSlug: result.variationSlug
+      }),
+      missingNameMessage: CORE_VARIATION_MISSING_NAME_MESSAGE,
+      name: variationName,
+      warnLine: context.warnLine
+    });
+  },
+  sortOrder: 25,
+  supportsDryRun: true,
+  usage: `wp-typia add core-variation <block-name> <name> [--dry-run]
+Alias: wp-typia add core-variation <name> --block <namespace/block> [--dry-run]`,
+  visibleFieldNames: () => NAME_BLOCK_VISIBLE_FIELDS
+});
+
 // src/add-kinds/editor-plugin.ts
 var EDITOR_PLUGIN_MISSING_NAME_MESSAGE = "`wp-typia add editor-plugin` requires <name>. Usage: wp-typia add editor-plugin <name> [--slot <sidebar|document-setting-panel>].";
 var editorPluginAddKindEntry = defineAddKindRegistryEntry({
@@ -1542,33 +1671,51 @@ var PATTERN_MISSING_NAME_MESSAGE = "`wp-typia add pattern` requires <name>. Usag
 var patternAddKindEntry = defineAddKindRegistryEntry({
   completion: {
     nextSteps: (values) => [
-      `Review src/patterns/${values.patternSlug}.php.`,
+      `Review ${values.contentFile}.`,
       "Run your workspace build or dev command to verify the new pattern registration."
     ],
     summaryLines: (values, projectDir) => [
       `Pattern: ${values.patternSlug}`,
+      `Content file: ${values.contentFile}`,
       `Project directory: ${projectDir}`
     ],
     title: "Added workspace pattern"
   },
   description: "Add a PHP block pattern shell",
+  hiddenStringSubmitFields: [
+    "scope",
+    "section-role",
+    "tags",
+    "thumbnail-url"
+  ],
   nameLabel: "Pattern name",
   async prepareExecution(context) {
-    return createNamedExecutionPlan(context, {
-      execute: ({ cwd, name }) => context.addRuntime.runAddPatternCommand({
+    const name = requireAddKindName(context, PATTERN_MISSING_NAME_MESSAGE);
+    const scope = typeof context.flags.scope === "string" ? context.flags.scope : undefined;
+    const sectionRole = typeof context.flags["section-role"] === "string" ? context.flags["section-role"] : undefined;
+    const tags = typeof context.flags.tags === "string" ? context.flags.tags : undefined;
+    const thumbnailUrl = typeof context.flags["thumbnail-url"] === "string" ? context.flags["thumbnail-url"] : undefined;
+    return {
+      execute: (cwd) => context.addRuntime.runAddPatternCommand({
         cwd,
-        patternName: name
+        patternScope: scope,
+        patternName: name,
+        sectionRole,
+        tags,
+        thumbnailUrl
       }),
       getValues: (result) => ({
-        patternSlug: result.patternSlug
+        contentFile: result.contentFile,
+        patternSlug: result.patternSlug,
+        patternScope: result.patternScope,
+        ...result.sectionRole ? { sectionRole: result.sectionRole } : {}
       }),
-      missingNameMessage: PATTERN_MISSING_NAME_MESSAGE,
       warnLine: context.warnLine
-    });
+    };
   },
   sortOrder: 60,
   supportsDryRun: true,
-  usage: "wp-typia add pattern <name> [--dry-run]",
+  usage: "wp-typia add pattern <name> [--scope <full|section>] [--section-role <role>] [--tags <tag,...>] [--thumbnail-url <url>] [--dry-run]",
   visibleFieldNames: () => NAME_ONLY_VISIBLE_FIELDS
 });
 
@@ -1634,6 +1781,10 @@ var postMetaAddKindEntry = defineAddKindRegistryEntry({
 });
 
 // src/add-kinds/rest-resource.ts
+import {
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES7,
+  createCliDiagnosticCodeError as createCliDiagnosticCodeError6
+} from "@wp-typia/project-tools/cli-diagnostics";
 var REST_RESOURCE_GENERATED_USAGE = "Generated: wp-typia add rest-resource <name> [--namespace <vendor/v1>] [--methods <list,read,create,update,delete>] [--route-pattern <route-pattern>] [--permission-callback <callback>] [--controller-class <ClassName>] [--controller-extends <BaseClass>] [--dry-run]";
 var REST_RESOURCE_MANUAL_USAGE = "Manual: wp-typia add rest-resource <name> --manual [--namespace <vendor/v1>] [--method <GET|POST|PUT|PATCH|DELETE>] [--auth <public|authenticated|public-write-protected>] [--path <route-pattern>|--route-pattern <route-pattern>] [--permission-callback <callback>] [--controller-class <ClassName>] [--controller-extends <BaseClass>] [--query-type <Type>] [--body-type <Type>] [--response-type <Type>] [--secret-field <field>] [--secret-state-field|--secret-has-value-field <field>] [--secret-preserve-on-empty <true|false>] [--dry-run]";
 var REST_RESOURCE_USAGE = `${REST_RESOURCE_GENERATED_USAGE}
@@ -1644,6 +1795,31 @@ var REST_RESOURCE_MISSING_NAME_MESSAGE = [
   `  ${REST_RESOURCE_MANUAL_USAGE}`
 ].join(`
 `);
+var SECRET_PRESERVE_ON_EMPTY_TRUE_VALUES = new Set(["1", "true", "yes"]);
+var SECRET_PRESERVE_ON_EMPTY_FALSE_VALUES = new Set(["0", "false", "no"]);
+function readOptionalSecretPreserveOnEmptyFlag(flags) {
+  const value = flags["secret-preserve-on-empty"] ?? flags.secretPreserveOnEmpty;
+  if (value === undefined || value === null) {
+    return;
+  }
+  if (typeof value === "boolean") {
+    return value;
+  }
+  if (typeof value !== "string") {
+    throw createCliDiagnosticCodeError6(CLI_DIAGNOSTIC_CODES7.MISSING_ARGUMENT, "`--secret-preserve-on-empty` requires a value.");
+  }
+  const normalized = value.trim().toLowerCase();
+  if (normalized.length === 0) {
+    throw createCliDiagnosticCodeError6(CLI_DIAGNOSTIC_CODES7.MISSING_ARGUMENT, "`--secret-preserve-on-empty` requires a value.");
+  }
+  if (SECRET_PRESERVE_ON_EMPTY_TRUE_VALUES.has(normalized)) {
+    return true;
+  }
+  if (SECRET_PRESERVE_ON_EMPTY_FALSE_VALUES.has(normalized)) {
+    return false;
+  }
+  throw createCliDiagnosticCodeError6(CLI_DIAGNOSTIC_CODES7.INVALID_ARGUMENT, "Manual REST contract --secret-preserve-on-empty must be true or false.");
+}
 var restResourceAddKindEntry = defineAddKindRegistryEntry({
   completion: {
     nextSteps: (values) => values.mode === "manual" ? [
@@ -1715,7 +1891,7 @@ var restResourceAddKindEntry = defineAddKindRegistryEntry({
     const secretFieldName = readOptionalDashedOrCamelStringFlag(context.flags, "secret-field", "secretField");
     const secretHasValueFieldName = readOptionalDashedOrCamelStringFlag(context.flags, "secret-has-value-field", "secretHasValueField");
     const secretMaskedResponseFieldName = readOptionalDashedOrCamelStringFlag(context.flags, "secret-masked-response-field", "secretMaskedResponseField");
-    const secretPreserveOnEmpty = readOptionalDashedOrCamelStringFlag(context.flags, "secret-preserve-on-empty", "secretPreserveOnEmpty");
+    const secretPreserveOnEmpty = readOptionalSecretPreserveOnEmptyFlag(context.flags);
     const secretStateFieldName = readOptionalDashedOrCamelStringFlag(context.flags, "secret-state-field", "secretStateField");
     return createNamedExecutionPlan(context, {
       execute: ({ cwd, name: name2 }) => context.addRuntime.runAddRestResourceCommand({
@@ -1900,6 +2076,7 @@ var ADD_KIND_REGISTRY = {
   "admin-view": adminViewAddKindEntry,
   block: blockAddKindEntry,
   "integration-env": integrationEnvAddKindEntry,
+  "core-variation": coreVariationAddKindEntry,
   variation: variationAddKindEntry,
   style: styleAddKindEntry,
   transform: transformAddKindEntry,
@@ -2295,7 +2472,7 @@ function buildStructuredInitSuccessPayload(plan) {
 // package.json
 var package_default = {
   name: "wp-typia",
-  version: "0.23.1",
+  version: "0.24.0",
   description: "Canonical CLI package for wp-typia scaffolding and project workflows",
   packageManager: "bun@1.3.11",
   type: "module",
@@ -2365,7 +2542,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.23.1",
+    "@wp-typia/project-tools": "0.24.0",
     "better-result": "^2.7.0",
     react: "^19.2.5",
     "react-dom": "^19.2.5",
@@ -2394,8 +2571,8 @@ import {
   parsePackageManagerField
 } from "@wp-typia/project-tools/package-managers";
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES6,
-  createCliDiagnosticCodeError as createCliDiagnosticCodeError5
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES8,
+  createCliDiagnosticCodeError as createCliDiagnosticCodeError7
 } from "@wp-typia/project-tools/cli-diagnostics";
 var LOOSE_CREATE_COMPLETION_PACKAGE_MANAGER_PATTERN = new RegExp(`^(?:corepack\\s+)?(${PACKAGE_MANAGER_IDS.map(escapeRegExp).join("|")})(?=$|[@:/+\\s])`, "iu");
 function parseCreateCompletionPackageManager(packageManager) {
@@ -2413,7 +2590,7 @@ function resolveCreateCompletionPackageManager(packageManager) {
   if (parsedPackageManager) {
     return parsedPackageManager;
   }
-  throw createCliDiagnosticCodeError5(CLI_DIAGNOSTIC_CODES6.INVALID_ARGUMENT, `Unsupported package manager "${packageManager}" in create completion payload. Expected one of: ${PACKAGE_MANAGER_IDS.join(", ")}.`);
+  throw createCliDiagnosticCodeError7(CLI_DIAGNOSTIC_CODES8.INVALID_ARGUMENT, `Unsupported package manager "${packageManager}" in create completion payload. Expected one of: ${PACKAGE_MANAGER_IDS.join(", ")}.`);
 }
 function formatCreateProgressLine(payload, markerOptions) {
   return formatOutputMarker("progress", `${payload.title}: ${payload.detail}`, markerOptions);
@@ -2659,6 +2836,7 @@ async function executeAddCommand({
   interactive,
   kind,
   name,
+  positionalArgs,
   printLine = console.log,
   prompt,
   warnLine = console.warn
@@ -2672,13 +2850,13 @@ async function executeAddCommand({
       if (shouldPrintMissingAddKindHelp({ emitOutput })) {
         printLine(addRuntime.formatAddHelpText());
       }
-      throw createCliDiagnosticCodeError6(CLI_DIAGNOSTIC_CODES7.MISSING_ARGUMENT, formatMissingAddKindDetailLine());
+      throw createCliDiagnosticCodeError8(CLI_DIAGNOSTIC_CODES9.MISSING_ARGUMENT, formatMissingAddKindDetailLine());
     }
     if (!isAddKindId(kind)) {
-      throw createCliDiagnosticCodeError6(CLI_DIAGNOSTIC_CODES7.INVALID_COMMAND, `Unknown add kind "${kind}". Expected one of: ${formatAddKindList()}.`);
+      throw createCliDiagnosticCodeError8(CLI_DIAGNOSTIC_CODES9.INVALID_COMMAND, `Unknown add kind "${kind}". Expected one of: ${formatAddKindList()}.`);
     }
     if (dryRun && !supportsAddKindDryRun(kind)) {
-      throw createCliDiagnosticCodeError6(CLI_DIAGNOSTIC_CODES7.INVALID_ARGUMENT, `\`wp-typia add ${kind}\` does not support \`--dry-run\` yet.`);
+      throw createCliDiagnosticCodeError8(CLI_DIAGNOSTIC_CODES9.INVALID_ARGUMENT, `\`wp-typia add ${kind}\` does not support \`--dry-run\` yet.`);
     }
     const executionContext = {
       addRuntime,
@@ -2694,6 +2872,7 @@ async function executeAddCommand({
       },
       isInteractiveSession,
       name,
+      positionalArgs,
       warnLine
     };
     return await executePlannedAddKind(kind, executionContext, {
@@ -2931,8 +3110,8 @@ async function executeMigrateCommand({
 }
 // src/runtime-bridge-templates.ts
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES8,
-  createCliDiagnosticCodeError as createCliDiagnosticCodeError7
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES10,
+  createCliDiagnosticCodeError as createCliDiagnosticCodeError9
 } from "@wp-typia/project-tools/cli-diagnostics";
 var loadCliTemplatesRuntime2 = () => import("@wp-typia/project-tools/cli-templates");
 async function executeTemplatesCommand({ flags }, printLine = console.log) {
@@ -2952,24 +3131,24 @@ async function executeTemplatesCommand({ flags }, printLine = console.log) {
   }
   if (subcommand === "inspect") {
     if (!flags.id) {
-      throw createCliDiagnosticCodeError7(CLI_DIAGNOSTIC_CODES8.MISSING_ARGUMENT, "`wp-typia templates inspect` requires <template-id>.");
+      throw createCliDiagnosticCodeError9(CLI_DIAGNOSTIC_CODES10.MISSING_ARGUMENT, "`wp-typia templates inspect` requires <template-id>.");
     }
     const template = getTemplateById(flags.id);
     if (!template) {
-      throw createCliDiagnosticCodeError7(CLI_DIAGNOSTIC_CODES8.INVALID_ARGUMENT, `Unknown template "${flags.id}".`);
+      throw createCliDiagnosticCodeError9(CLI_DIAGNOSTIC_CODES10.INVALID_ARGUMENT, `Unknown template "${flags.id}".`);
     }
     printBlock(printLine, [formatTemplateDetails(template)]);
     return;
   }
-  throw createCliDiagnosticCodeError7(CLI_DIAGNOSTIC_CODES8.INVALID_COMMAND, `Unknown templates subcommand "${subcommand}". Expected list or inspect.`);
+  throw createCliDiagnosticCodeError9(CLI_DIAGNOSTIC_CODES10.INVALID_COMMAND, `Unknown templates subcommand "${subcommand}". Expected list or inspect.`);
 }
 // src/runtime-bridge-sync.ts
 import { spawnSync } from "node:child_process";
 import fs3 from "node:fs";
 import path4 from "node:path";
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES9,
-  createCliDiagnosticCodeError as createCliDiagnosticCodeError8
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES11,
+  createCliDiagnosticCodeError as createCliDiagnosticCodeError10
 } from "@wp-typia/project-tools/cli-diagnostics";
 import {
   formatInstallCommand,
@@ -2990,10 +3169,10 @@ function resolveSyncExecutionTarget(subcommand) {
   if (subcommand === "ai") {
     return "ai";
   }
-  throw createCliDiagnosticCodeError8(CLI_DIAGNOSTIC_CODES9.INVALID_COMMAND, `Unknown sync subcommand "${subcommand}". Expected one of: "ai".`);
+  throw createCliDiagnosticCodeError10(CLI_DIAGNOSTIC_CODES11.INVALID_COMMAND, `Unknown sync subcommand "${subcommand}". Expected one of: "ai".`);
 }
 function getSyncRootError(cwd) {
-  return createCliDiagnosticCodeError8(CLI_DIAGNOSTIC_CODES9.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 createCliDiagnosticCodeError10(CLI_DIAGNOSTIC_CODES11.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 readSyncPackageJson(packageJsonPath) {
   const source = fs3.readFileSync(packageJsonPath, "utf8");
@@ -3001,7 +3180,7 @@ function readSyncPackageJson(packageJsonPath) {
     return JSON.parse(source);
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
-    throw createCliDiagnosticCodeError8(CLI_DIAGNOSTIC_CODES9.INVALID_ARGUMENT, `Unable to parse ${packageJsonPath}: ${message}`, error instanceof Error ? { cause: error } : undefined);
+    throw createCliDiagnosticCodeError10(CLI_DIAGNOSTIC_CODES11.INVALID_ARGUMENT, `Unable to parse ${packageJsonPath}: ${message}`, error instanceof Error ? { cause: error } : undefined);
   }
 }
 function resolveSyncProjectContext(cwd) {
@@ -3068,7 +3247,7 @@ function assertSyncDependenciesInstalled(project, target) {
   if (markerDir) {
     return;
   }
-  throw createCliDiagnosticCodeError8(CLI_DIAGNOSTIC_CODES9.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 createCliDiagnosticCodeError10(CLI_DIAGNOSTIC_CODES11.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) {
@@ -3106,7 +3285,7 @@ function buildSyncPlannedCommands(project, extraArgs, target) {
   if (target === "ai") {
     const syncAiCommand2 = createSyncPlannedCommand(project, "sync-ai", extraArgs);
     if (!syncAiCommand2) {
-      throw createCliDiagnosticCodeError8(CLI_DIAGNOSTIC_CODES9.CONFIGURATION_MISSING, `Expected ${project.packageJsonPath} to define a \`sync-ai\` script for \`wp-typia sync ai\`.`);
+      throw createCliDiagnosticCodeError10(CLI_DIAGNOSTIC_CODES11.CONFIGURATION_MISSING, `Expected ${project.packageJsonPath} to define a \`sync-ai\` script for \`wp-typia sync ai\`.`);
     }
     return [syncAiCommand2];
   }
@@ -3115,7 +3294,7 @@ function buildSyncPlannedCommands(project, extraArgs, target) {
   }
   const syncTypesCommand = createSyncPlannedCommand(project, "sync-types", extraArgs);
   if (!syncTypesCommand) {
-    throw createCliDiagnosticCodeError8(CLI_DIAGNOSTIC_CODES9.CONFIGURATION_MISSING, `Expected ${project.packageJsonPath} to define either a \`sync\` or \`sync-types\` script.`);
+    throw createCliDiagnosticCodeError10(CLI_DIAGNOSTIC_CODES11.CONFIGURATION_MISSING, `Expected ${project.packageJsonPath} to define either a \`sync\` or \`sync-types\` script.`);
   }
   const plannedCommands = [syncTypesCommand];
   const syncRestCommand = createSyncPlannedCommand(project, "sync-rest", extraArgs);
@@ -3139,7 +3318,7 @@ function runProjectScript(project, plannedCommand, options) {
   const stderr = options.captureOutput && typeof result.stderr === "string" ? result.stderr : undefined;
   const stdout = options.captureOutput && typeof result.stdout === "string" ? result.stdout : undefined;
   if (result.error || result.status !== 0) {
-    throw createCliDiagnosticCodeError8(CLI_DIAGNOSTIC_CODES9.COMMAND_EXECUTION, `\`${plannedCommand.displayCommand}\` failed.`, {
+    throw createCliDiagnosticCodeError10(CLI_DIAGNOSTIC_CODES11.COMMAND_EXECUTION, `\`${plannedCommand.displayCommand}\` failed.`, {
       cause: result.error ?? (stderr ? new Error(stderr.trim()) : undefined)
     });
   }
@@ -3181,8 +3360,8 @@ async function executeSyncCommand({
 // src/command-contract.ts
 import path5 from "node:path";
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES10,
-  createCliDiagnosticCodeError as createCliDiagnosticCodeError9
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES12,
+  createCliDiagnosticCodeError as createCliDiagnosticCodeError11
 } from "@wp-typia/project-tools/cli-diagnostics";
 
 // src/command-registry.ts
@@ -3453,10 +3632,10 @@ function looksLikeStructuredProjectInput(value) {
 function assertPositionalAliasProjectDir(projectDir) {
   const normalizedProjectDir = path5.normalize(projectDir).replace(/[\\/]+$/u, "") || path5.normalize(projectDir);
   if (normalizedProjectDir === "." || normalizedProjectDir === "..") {
-    throw createCliDiagnosticCodeError9(CLI_DIAGNOSTIC_CODES10.INVALID_ARGUMENT, `The positional alias does not scaffold into \`${projectDir}\`. Use \`${WP_TYPIA_CANONICAL_CREATE_USAGE}\` with an explicit child directory instead.`);
+    throw createCliDiagnosticCodeError11(CLI_DIAGNOSTIC_CODES12.INVALID_ARGUMENT, `The positional alias does not scaffold into \`${projectDir}\`. Use \`${WP_TYPIA_CANONICAL_CREATE_USAGE}\` with an explicit child directory instead.`);
   }
   if (looksLikeStructuredProjectInput(projectDir)) {
-    throw createCliDiagnosticCodeError9(CLI_DIAGNOSTIC_CODES10.INVALID_ARGUMENT, `The positional alias only accepts unambiguous local project directories. Use \`${WP_TYPIA_CANONICAL_CREATE_USAGE}\` for \`${projectDir}\`.`);
+    throw createCliDiagnosticCodeError11(CLI_DIAGNOSTIC_CODES12.INVALID_ARGUMENT, `The positional alias only accepts unambiguous local project directories. Use \`${WP_TYPIA_CANONICAL_CREATE_USAGE}\` for \`${projectDir}\`.`);
   }
 }
 function normalizeWpTypiaArgv(argv) {
@@ -3470,7 +3649,7 @@ function normalizeWpTypiaArgv(argv) {
     return argv;
   }
   if (firstPositional === "migrations") {
-    throw createCliDiagnosticCodeError9(CLI_DIAGNOSTIC_CODES10.INVALID_ARGUMENT, "`wp-typia migrations` was removed in favor of `wp-typia migrate`. Use `wp-typia migrate <subcommand>` instead.");
+    throw createCliDiagnosticCodeError11(CLI_DIAGNOSTIC_CODES12.INVALID_ARGUMENT, "`wp-typia migrations` was removed in favor of `wp-typia migrate`. Use `wp-typia migrate <subcommand>` instead.");
   }
   if (isReservedTopLevelCommandName(firstPositional)) {
     assertStringOptionValues(argv);
@@ -3478,7 +3657,7 @@ function normalizeWpTypiaArgv(argv) {
   }
   if (positionalIndexes.length > 1) {
     const extraPositionals = positionalIndexes.slice(1).map((index) => argv[index]).filter((value) => typeof value === "string" && value.length > 0);
-    throw createCliDiagnosticCodeError9(CLI_DIAGNOSTIC_CODES10.INVALID_ARGUMENT, `The positional alias only accepts a single project directory. Use \`${WP_TYPIA_CANONICAL_CREATE_USAGE}\` for scaffold invocations with additional positional arguments, or check the command spelling if you meant another top-level command. Extra positional arguments: ${extraPositionals.map((value) => `\`${value}\``).join(", ")}.`);
+    throw createCliDiagnosticCodeError11(CLI_DIAGNOSTIC_CODES12.INVALID_ARGUMENT, `The positional alias only accepts a single project directory. Use \`${WP_TYPIA_CANONICAL_CREATE_USAGE}\` for scaffold invocations with additional positional arguments, or check the command spelling if you meant another top-level command. Extra positional arguments: ${extraPositionals.map((value) => `\`${value}\``).join(", ")}.`);
   }
   assertPositionalAliasProjectDir(firstPositional);
   const normalizedArgv = [
@@ -3492,7 +3671,7 @@ function normalizeWpTypiaArgv(argv) {
 
 // src/node-fallback/doctor.ts
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES11,
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES13,
   createCliCommandError as createCliCommandError2
 } from "@wp-typia/project-tools/cli-diagnostics";
 async function renderNodeFallbackDoctorJson(cwd, exitPolicy, printLine) {
@@ -3509,7 +3688,7 @@ async function renderNodeFallbackDoctorJson(cwd, exitPolicy, printLine) {
   }, null, 2));
   if (summary.exitCode === 1) {
     throw createCliCommandError2({
-      code: CLI_DIAGNOSTIC_CODES11.DOCTOR_CHECK_FAILED,
+      code: CLI_DIAGNOSTIC_CODES13.DOCTOR_CHECK_FAILED,
       command: "doctor",
       detailLines: getDoctorExitFailureDetailLines(checks, { exitPolicy }),
       summary: "One or more doctor checks failed."
@@ -3531,9 +3710,15 @@ async function dispatchNodeFallbackDoctor({
 
 // src/node-fallback/dispatchers/add.ts
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES12,
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES14,
   createCliCommandError as createCliCommandError3
 } from "@wp-typia/project-tools/cli-diagnostics";
+function resolveNodeFallbackAddName(positionals) {
+  if (positionals[1] === "core-variation" && positionals[3]) {
+    return positionals[3];
+  }
+  return positionals[2];
+}
 async function dispatchNodeFallbackAdd({
   cwd,
   mergedFlags,
@@ -3547,11 +3732,14 @@ async function dispatchNodeFallbackAdd({
       printLine(formatAddHelpText());
     }
     throw createCliCommandError3({
-      code: CLI_DIAGNOSTIC_CODES12.MISSING_ARGUMENT,
+      code: CLI_DIAGNOSTIC_CODES14.MISSING_ARGUMENT,
       command: "add",
       detailLines: buildMissingAddKindDetailLines()
     });
   }
+  const kind = positionals[1];
+  const name = resolveNodeFallbackAddName(positionals);
+  const positionalArgs = positionals.slice(1);
   if (mergedFlags.format === "json") {
     let completion;
     try {
@@ -3560,8 +3748,9 @@ async function dispatchNodeFallbackAdd({
         emitOutput: false,
         flags: mergedFlags,
         interactive: false,
-        kind: positionals[1],
-        name: positionals[2],
+        kind,
+        name,
+        positionalArgs,
         printLine,
         warnLine
       });
@@ -3573,8 +3762,8 @@ async function dispatchNodeFallbackAdd({
     }
     printLine(JSON.stringify(buildStructuredCompletionSuccessPayload("add", completion, {
       dryRun: Boolean(mergedFlags["dry-run"]),
-      kind: positionals[1],
-      name: positionals[2],
+      kind,
+      name,
       projectDir: extractCompletionProjectDir(completion) ?? cwd
     }), null, 2));
     return;
@@ -3583,8 +3772,9 @@ async function dispatchNodeFallbackAdd({
     cwd,
     flags: mergedFlags,
     interactive: undefined,
-    kind: positionals[1],
-    name: positionals[2],
+    kind,
+    name,
+    positionalArgs,
     printLine,
     warnLine
   });
@@ -3592,7 +3782,7 @@ async function dispatchNodeFallbackAdd({
 
 // src/node-fallback/dispatchers/create.ts
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES13,
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES15,
   createCliCommandError as createCliCommandError4
 } from "@wp-typia/project-tools/cli-diagnostics";
 async function dispatchNodeFallbackCreate({
@@ -3605,7 +3795,7 @@ async function dispatchNodeFallbackCreate({
   const projectDir = positionals[1];
   if (!projectDir) {
     throw createCliCommandError4({
-      code: CLI_DIAGNOSTIC_CODES13.MISSING_ARGUMENT,
+      code: CLI_DIAGNOSTIC_CODES15.MISSING_ARGUMENT,
       command: "create",
       detailLines: buildMissingCreateProjectDirDetailLines()
     });
@@ -3638,7 +3828,7 @@ async function dispatchNodeFallbackCreate({
 
 // src/node-fallback/errors.ts
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES14,
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES16,
   createCliCommandError as createCliCommandError6,
   formatCliDiagnosticError,
   isCliDiagnosticError,
@@ -3756,18 +3946,18 @@ var NODE_FALLBACK_HELP_RENDERERS = Object.fromEntries(Object.entries(NODE_FALLBA
 // src/node-fallback/errors.ts
 function createNodeFallbackNoCommandCliError() {
   return createCliCommandError6({
-    code: CLI_DIAGNOSTIC_CODES14.INVALID_COMMAND,
+    code: CLI_DIAGNOSTIC_CODES16.INVALID_COMMAND,
     command: "wp-typia",
     detailLines: [NODE_FALLBACK_NO_COMMAND_REASON_LINE],
     summary: "No command was provided."
   });
 }
 function isNodeFallbackNoCommandCliDiagnostic(error) {
-  return isCliDiagnosticError(error) && error.code === CLI_DIAGNOSTIC_CODES14.INVALID_COMMAND && error.command === "wp-typia" && error.detailLines.includes(NODE_FALLBACK_NO_COMMAND_REASON_LINE);
+  return isCliDiagnosticError(error) && error.code === CLI_DIAGNOSTIC_CODES16.INVALID_COMMAND && error.command === "wp-typia" && error.detailLines.includes(NODE_FALLBACK_NO_COMMAND_REASON_LINE);
 }
 function throwUnsupportedNodeFallbackCommand(command) {
   throw createCliCommandError6({
-    code: CLI_DIAGNOSTIC_CODES14.UNSUPPORTED_COMMAND,
+    code: CLI_DIAGNOSTIC_CODES16.UNSUPPORTED_COMMAND,
     command,
     detailLines: [
       [
@@ -3803,7 +3993,7 @@ async function handleNodeFallbackEntrypointError(error, argv) {
 
 // src/node-fallback/templates.ts
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES15,
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES17,
   createCliCommandError as createCliCommandError7
 } from "@wp-typia/project-tools/cli-diagnostics";
 import {
@@ -3820,7 +4010,7 @@ function renderNodeFallbackTemplatesJson(printLine, flags, subcommand) {
   const templateId = flags.id;
   if (!templateId) {
     throw createCliCommandError7({
-      code: CLI_DIAGNOSTIC_CODES15.MISSING_ARGUMENT,
+      code: CLI_DIAGNOSTIC_CODES17.MISSING_ARGUMENT,
       command: "templates",
       detailLines: ["`wp-typia templates inspect` requires <template-id>."]
     });
@@ -3828,7 +4018,7 @@ function renderNodeFallbackTemplatesJson(printLine, flags, subcommand) {
   const template = getTemplateById(templateId);
   if (!template) {
     throw createCliCommandError7({
-      code: CLI_DIAGNOSTIC_CODES15.INVALID_ARGUMENT,
+      code: CLI_DIAGNOSTIC_CODES17.INVALID_ARGUMENT,
       command: "templates",
       detailLines: [`Unknown template "${templateId}".`]
     });
@@ -3847,7 +4037,7 @@ async function dispatchNodeFallbackTemplates({
   const resolvedSubcommand = subcommand ?? (templateId ? "inspect" : "list");
   if (resolvedSubcommand !== "list" && resolvedSubcommand !== "inspect") {
     throw createCliCommandError7({
-      code: CLI_DIAGNOSTIC_CODES15.INVALID_COMMAND,
+      code: CLI_DIAGNOSTIC_CODES17.INVALID_COMMAND,
       command: "templates",
       detailLines: [
         `Unknown templates subcommand "${resolvedSubcommand}". Expected list or inspect.`
@@ -4105,4 +4295,4 @@ export {
   hasFlagBeforeTerminator
 };
 
-//# debugId=7520561D7D1BD35A64756E2164756E21
+//# debugId=89977F6E4F67703D64756E2164756E21