wp-typia 0.24.3 → 0.24.4

package/dist-bunli/.bunli/commands.gen.js

@@ -239228,13 +239228,23 @@ var init_cli_add_workspace_binding_source_source_emitters = __esm(() => {
 });
 
 // ../wp-typia-project-tools/src/runtime/block-targets.ts
-function assertFullBlockName(blockName, flagName) {
+function resolveFullBlockNameDiagnostics(diagnostics) {
+  if (typeof diagnostics !== "string") {
+    return diagnostics;
+  }
+  return {
+    empty: () => `\`${diagnostics}\` requires a block name.`,
+    invalidFormat: () => `\`${diagnostics}\` must use <namespace/block-slug> format.`
+  };
+}
+function assertFullBlockName(blockName, diagnostics) {
+  const messages = resolveFullBlockNameDiagnostics(diagnostics);
   const trimmed = blockName.trim();
   if (!trimmed) {
-    throw new Error(`\`${flagName}\` requires a block name.`);
+    throw new Error(messages.empty());
   }
   if (!FULL_BLOCK_NAME_PATTERN.test(trimmed)) {
-    throw new Error(`\`${flagName}\` must use <namespace/block-slug> format.`);
+    throw new Error(messages.invalidFormat());
   }
   return trimmed;
 }
@@ -241523,10 +241533,11 @@ async function writeCoreVariationRegistry(projectDir, targetBlockName, textDomai
 async function runAddCoreVariationCommand({
   cwd = process.cwd(),
   targetBlockName,
+  targetBlockNameDiagnostics = "core-variation target",
   variationName
 }) {
   const workspace = resolveWorkspaceProject(cwd);
-  const resolvedTargetBlockName = assertFullBlockName(targetBlockName, "core-variation target");
+  const resolvedTargetBlockName = assertFullBlockName(targetBlockName, targetBlockNameDiagnostics);
   const variationSlug = assertValidGeneratedSlug("Core variation name", normalizeBlockSlug(variationName), CORE_VARIATION_USAGE);
   const unknownCoreTargetWarning = getUnknownCoreVariationTargetWarning(resolvedTargetBlockName);
   assertCoreVariationSlugIsNotRegistryIndex(variationSlug);
@@ -300143,7 +300154,11 @@ function resolveCommandOptionValues(metadata2, options) {
       continue;
     }
     if (descriptor.repeatable && Array.isArray(value2)) {
-      resolved[name2] = value2.every((item) => typeof item === "string") ? value2.join(",") : undefined;
+      if (!value2.every((item) => typeof item === "string")) {
+        resolved[name2] = undefined;
+        continue;
+      }
+      resolved[name2] = options.preserveArrays ? [...value2] : value2.join(",");
       continue;
     }
     resolved[name2] = typeof value2 === "string" ? value2 : undefined;
@@ -300812,6 +300827,10 @@ init_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>.";
 var CORE_VARIATION_BLOCK_NAME_PATTERN = /^[^/\s]+\/[^/\s]+$/u;
+var CORE_VARIATION_POSITIONAL_TARGET_DIAGNOSTICS = {
+  empty: () => "The first positional argument (target block name) requires a block name.",
+  invalidFormat: () => "The first positional argument (target block name) must use <namespace/block-slug> format."
+};
 function formatCoreVariationMissingPositionalNameMessage(blockName) {
   return [
     `\`wp-typia add core-variation ${blockName}\` is missing <name>.`,
@@ -300829,6 +300848,7 @@ function resolveCoreVariationInputs(context) {
     }
     return {
       targetBlockName: positionalTargetBlockName,
+      targetBlockNameDiagnostics: CORE_VARIATION_POSITIONAL_TARGET_DIAGNOSTICS,
       variationName: positionalVariationName
     };
   }
@@ -300843,6 +300863,7 @@ function resolveCoreVariationInputs(context) {
   }
   return {
     targetBlockName: targetBlockFlag,
+    targetBlockNameDiagnostics: "--block",
     variationName
   };
 }
@@ -300862,11 +300883,12 @@ var coreVariationAddKindEntry = defineAddKindRegistryEntry({
   description: "Add an editor-side variation for an existing core or external block",
   nameLabel: "Variation name",
   async prepareExecution(context) {
-    const { targetBlockName, variationName } = resolveCoreVariationInputs(context);
+    const { targetBlockName, targetBlockNameDiagnostics, variationName } = resolveCoreVariationInputs(context);
     return createNamedExecutionPlan(context, {
       execute: ({ cwd, name: name2 }) => context.addRuntime.runAddCoreVariationCommand({
         cwd,
         targetBlockName,
+        targetBlockNameDiagnostics,
         variationName: name2
       }),
       getValues: (result) => ({
@@ -301046,11 +301068,15 @@ var patternAddKindEntry = defineAddKindRegistryEntry({
   nameLabel: "Pattern name",
   async prepareExecution(context) {
     const name2 = requireAddKindName(context, PATTERN_MISSING_NAME_MESSAGE);
+    const rawScope = typeof context.flags.scope === "string" ? context.flags.scope : undefined;
+    const rawSectionRole = typeof context.flags["section-role"] === "string" ? context.flags["section-role"] : undefined;
+    const rawCatalogTitle = typeof context.flags["catalog-title"] === "string" ? context.flags["catalog-title"] : undefined;
+    const rawThumbnailUrl = typeof context.flags["thumbnail-url"] === "string" ? context.flags["thumbnail-url"] : undefined;
     const scope = resolvePatternScopeFlag(context);
     const sectionRole = resolvePatternSectionRoleFlag(context, scope);
-    const catalogTitle = typeof context.flags["catalog-title"] === "string" ? context.flags["catalog-title"] : undefined;
+    const catalogTitle = rawCatalogTitle;
     const tags = normalizePatternTagFlags(context.flags.tags, context.flags.tag);
-    const thumbnailUrl = typeof context.flags["thumbnail-url"] === "string" ? context.flags["thumbnail-url"] : undefined;
+    const thumbnailUrl = rawThumbnailUrl;
     return {
       execute: (cwd) => context.addRuntime.runAddPatternCommand({
         catalogTitle,
@@ -301061,6 +301087,13 @@ var patternAddKindEntry = defineAddKindRegistryEntry({
         tags,
         thumbnailUrl
       }),
+      getDryRunSummaryLines: (result) => buildPatternCatalogDryRunSummaryLines(result, {
+        rawCatalogTitle,
+        rawScope,
+        rawSectionRole,
+        rawTags: tags,
+        rawThumbnailUrl
+      }),
       getValues: (result) => ({
         contentFile: result.contentFile,
         patternSlug: result.patternSlug,
@@ -301124,6 +301157,75 @@ function normalizePatternTagFlags(tagsFlag, tagFlag) {
   ];
   return tags.length > 0 ? tags : undefined;
 }
+function quoteValue(value2) {
+  return `"${value2}"`;
+}
+function formatTags(tags) {
+  return tags.length > 0 ? tags.join(", ") : "no tags";
+}
+function collectPatternTagTokens(tags) {
+  return (tags ?? []).flatMap((tag) => tag.split(",")).map((tag) => tag.trim()).filter((tag) => tag.length > 0);
+}
+function valuesMatch(left, right) {
+  return left.length === right.length && left.every((value2, index) => value2 === right[index]);
+}
+function createNormalizationNote(options) {
+  const rawValue = options.rawValue;
+  if (rawValue === undefined || rawValue.trim().length === 0 || !options.resolvedValue || rawValue === options.resolvedValue) {
+    return;
+  }
+  return `${options.fieldLabel} normalized from ${quoteValue(rawValue)} to ${quoteValue(options.resolvedValue)}.`;
+}
+function collectPatternCatalogNormalizationNotes(result, options) {
+  const notes = [
+    createNormalizationNote({
+      fieldLabel: "Scope",
+      rawValue: options.rawScope,
+      resolvedValue: result.patternScope
+    }),
+    createNormalizationNote({
+      fieldLabel: "Section role",
+      rawValue: options.rawSectionRole,
+      resolvedValue: result.sectionRole
+    }),
+    createNormalizationNote({
+      fieldLabel: "Title",
+      rawValue: options.rawCatalogTitle,
+      resolvedValue: result.title
+    }),
+    createNormalizationNote({
+      fieldLabel: "Thumbnail URL",
+      rawValue: options.rawThumbnailUrl,
+      resolvedValue: result.thumbnailUrl
+    })
+  ].filter((note) => typeof note === "string");
+  const rawTags = collectPatternTagTokens(options.rawTags);
+  if (rawTags.length > 0 && !valuesMatch(rawTags, result.tags)) {
+    notes.push(`Tags normalized from ${quoteValue(formatTags(rawTags))} to ${quoteValue(formatTags(result.tags))}.`);
+  }
+  return notes;
+}
+function buildPatternCatalogDryRunSummaryLines(result, options) {
+  const catalogLines = [
+    "",
+    "Catalog metadata:",
+    `  Scope: ${result.patternScope}`,
+    ...result.sectionRole ? [`  Section role: ${result.sectionRole}`] : [],
+    `  Title: ${result.title}`,
+    ...result.tags.length > 0 ? [`  Tags: ${formatTags(result.tags)}`] : [],
+    ...result.thumbnailUrl ? [`  Thumbnail URL: ${result.thumbnailUrl}`] : []
+  ];
+  const normalizationNotes = collectPatternCatalogNormalizationNotes(result, options);
+  if (normalizationNotes.length === 0) {
+    return catalogLines;
+  }
+  return [
+    ...catalogLines,
+    "",
+    "Normalization notes:",
+    ...normalizationNotes.map((note) => `  ${note}`)
+  ];
+}
 
 // src/add-kinds/post-meta.ts
 var POST_META_MISSING_NAME_MESSAGE = "`wp-typia add post-meta` requires <name>. Usage: wp-typia add post-meta <name> --post-type <post-type> [--type <ExportedTypeName>] [--meta-key <meta-key>].";
@@ -301872,7 +301974,7 @@ function buildStructuredInitSuccessPayload(plan) {
 // package.json
 var package_default2 = {
   name: "wp-typia",
-  version: "0.24.3",
+  version: "0.24.4",
   description: "Canonical CLI package for wp-typia scaffolding and project workflows",
   packageManager: "bun@1.3.11",
   type: "module",
@@ -301942,7 +302044,7 @@ var package_default2 = {
     "@bunli/tui": "0.6.0",
     "@bunli/utils": "0.6.0",
     "@wp-typia/api-client": "^0.4.5",
-    "@wp-typia/project-tools": "0.24.3",
+    "@wp-typia/project-tools": "0.24.4",
     "better-result": "^2.7.0",
     react: "^19.2.5",
     "react-dom": "^19.2.5",
@@ -302053,12 +302155,16 @@ function buildAddCompletionPayload(options, markerOptions) {
 }
 function buildAddDryRunPayload(options, markerOptions) {
   const normalizedTitle = stripLeadingOutputMarker(options.completion.title, "success").replace(/^Added\s*/u, "");
+  const summaryLines = [
+    ...options.completion.summaryLines ?? [],
+    ...options.summaryLines ?? []
+  ];
   return {
     optionalLines: options.fileOperations,
     optionalNote: "No workspace files were changed because --dry-run was enabled. Re-run without --dry-run to apply this add command.",
     optionalTitle: `Planned workspace updates (${options.fileOperations.length}):`,
     preambleLines: options.completion.preambleLines,
-    summaryLines: options.completion.summaryLines,
+    summaryLines: summaryLines.length > 0 ? summaryLines : undefined,
     title: formatOutputMarker("dryRun", `Dry run for ${normalizedTitle || "workspace add command"}`, markerOptions),
     warningLines: options.completion.warningLines
   };
@@ -302196,7 +302302,8 @@ async function executeWorkspaceAddWithOptionalDryRun(options) {
   }
   return emitCompletion(buildAddDryRunPayload({
     completion,
-    fileOperations: simulated.fileOperations
+    fileOperations: simulated.fileOperations,
+    summaryLines: options.buildDryRunSummaryLines?.(result)
   }), {
     emitOutput: options.emitOutput ?? true,
     printLine: options.printLine,
@@ -302211,6 +302318,7 @@ function executePreparedAddKind(kind, context, plan) {
       values: plan.getValues(result),
       warnings: plan.getWarnings?.(result)
     }),
+    buildDryRunSummaryLines: (result) => plan.getDryRunSummaryLines?.(result),
     cwd: context.cwd,
     dryRun: context.dryRun,
     emitOutput: context.emitOutput,
@@ -304330,4 +304438,4 @@ export {
   cli
 };
 
-//# debugId=2AB06C2166C7F45664756E2164756E21
+//# debugId=C8CAA6A09EF0F81764756E2164756E21

package/dist-bunli/{cli-4pzxbk4s.js → cli-368d4cgy.js}

@@ -14,7 +14,7 @@ import {
 // package.json
 var package_default = {
   name: "wp-typia",
-  version: "0.24.3",
+  version: "0.24.4",
   description: "Canonical CLI package for wp-typia scaffolding and project workflows",
   packageManager: "bun@1.3.11",
   type: "module",
@@ -84,7 +84,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.24.3",
+    "@wp-typia/project-tools": "0.24.4",
     "better-result": "^2.7.0",
     react: "^19.2.5",
     "react-dom": "^19.2.5",
@@ -755,7 +755,11 @@ function resolveCommandOptionValues(metadata, options) {
       continue;
     }
     if (descriptor.repeatable && Array.isArray(value)) {
-      resolved[name] = value.every((item) => typeof item === "string") ? value.join(",") : undefined;
+      if (!value.every((item) => typeof item === "string")) {
+        resolved[name] = undefined;
+        continue;
+      }
+      resolved[name] = options.preserveArrays ? [...value] : value.join(",");
       continue;
     }
     resolved[name] = typeof value === "string" ? value : undefined;
@@ -1228,4 +1232,4 @@ function createPlugin(input) {
 }
 export { createPlugin, package_default, collectPositionalIndexes, findFirstPositionalIndex, ADD_OPTION_METADATA, CREATE_OPTION_METADATA, DOCTOR_OPTION_METADATA, GLOBAL_OPTION_METADATA, INIT_OPTION_METADATA, MCP_OPTION_METADATA, MIGRATE_OPTION_METADATA, SYNC_OPTION_METADATA, TEMPLATES_OPTION_METADATA, COMMAND_OPTION_METADATA_BY_GROUP, ALL_COMMAND_OPTION_METADATA, buildCommandOptions, collectOptionNamesByType, buildCommandOptionParser, COMMAND_ROUTING_METADATA, createMissingOptionValueError, extractKnownOptionValuesFromArgv, resolveCommandOptionValues, normalizeCliOutputFormatArgv, validateCliOutputFormatArgv, prefersStructuredCliOutput, emitCliDiagnosticFailure, writeStructuredCliDiagnosticError, formatAddKindList, formatAddKindUsagePlaceholder, WP_TYPIA_CANONICAL_CREATE_USAGE, WP_TYPIA_RESERVED_TOP_LEVEL_COMMAND_NAMES, WP_TYPIA_TOP_LEVEL_COMMAND_NAMES, WP_TYPIA_COMMAND_OPTION_GROUP_NAMES_BY_TOP_LEVEL_COMMAND, WP_TYPIA_CONFIG_SOURCES, mergeWpTypiaUserConfig, loadWpTypiaUserConfigFromSource, loadWpTypiaUserConfig, getCreateDefaults, getAddBlockDefaults, getMcpSchemaSources };
 
-//# debugId=C92E20FC0E312E8D64756E2164756E21
+//# debugId=213462D0D4B1919364756E2164756E21

package/dist-bunli/{cli-add-mxxk5rep.js → cli-add-qjd3ba8j.js}

@@ -6124,13 +6124,23 @@ registerBlockBindingsSource( {
 
 // ../wp-typia-project-tools/src/runtime/block-targets.ts
 var FULL_BLOCK_NAME_PATTERN = /^[a-z0-9-]+\/[a-z0-9-]+$/u;
-function assertFullBlockName(blockName, flagName) {
+function resolveFullBlockNameDiagnostics(diagnostics) {
+  if (typeof diagnostics !== "string") {
+    return diagnostics;
+  }
+  return {
+    empty: () => `\`${diagnostics}\` requires a block name.`,
+    invalidFormat: () => `\`${diagnostics}\` must use <namespace/block-slug> format.`
+  };
+}
+function assertFullBlockName(blockName, diagnostics) {
+  const messages = resolveFullBlockNameDiagnostics(diagnostics);
   const trimmed = blockName.trim();
   if (!trimmed) {
-    throw new Error(`\`${flagName}\` requires a block name.`);
+    throw new Error(messages.empty());
   }
   if (!FULL_BLOCK_NAME_PATTERN.test(trimmed)) {
-    throw new Error(`\`${flagName}\` must use <namespace/block-slug> format.`);
+    throw new Error(messages.invalidFormat());
   }
   return trimmed;
 }
@@ -8230,10 +8240,11 @@ async function writeCoreVariationRegistry(projectDir, targetBlockName, textDomai
 async function runAddCoreVariationCommand({
   cwd = process.cwd(),
   targetBlockName,
+  targetBlockNameDiagnostics = "core-variation target",
   variationName
 }) {
   const workspace = resolveWorkspaceProject(cwd);
-  const resolvedTargetBlockName = assertFullBlockName(targetBlockName, "core-variation target");
+  const resolvedTargetBlockName = assertFullBlockName(targetBlockName, targetBlockNameDiagnostics);
   const variationSlug = assertValidGeneratedSlug("Core variation name", normalizeBlockSlug(variationName), CORE_VARIATION_USAGE);
   const unknownCoreTargetWarning = getUnknownCoreVariationTargetWarning(resolvedTargetBlockName);
   assertCoreVariationSlugIsNotRegistryIndex(variationSlug);
@@ -10657,4 +10668,4 @@ export {
   ADD_BLOCK_TEMPLATE_IDS
 };
 
-//# debugId=3EDD3B6180967F3A64756E2164756E21
+//# debugId=8D1F1CF635D9D28D64756E2164756E21

package/dist-bunli/cli.js

@@ -22,7 +22,7 @@ import {
   package_default,
   validateCliOutputFormatArgv,
   writeStructuredCliDiagnosticError
-} from "./cli-4pzxbk4s.js";
+} from "./cli-368d4cgy.js";
 import"./cli-03j0axbt.js";
 import {
   GLOBAL_FLAGS,
@@ -2460,7 +2460,7 @@ async function formatCliError(error) {
 }
 async function createWpTypiaCli(options = {}) {
   applyStandaloneSupportLayoutEnv();
-  const { wpTypiaCommands } = await import("./command-list-bgwaa2f4.js");
+  const { wpTypiaCommands } = await import("./command-list-y3g7e9rb.js");
   const cli = await createCLI({
     ...bunliConfig,
     description: package_default.description,

package/dist-bunli/{command-list-bgwaa2f4.js → command-list-y3g7e9rb.js}

@@ -19,7 +19,7 @@ import {
   package_default,
   prefersStructuredCliOutput,
   resolveCommandOptionValues
-} from "./cli-4pzxbk4s.js";
+} from "./cli-368d4cgy.js";
 import {
   Result,
   TaggedError,
@@ -593,6 +593,10 @@ var contractAddKindEntry = defineAddKindRegistryEntry({
 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>.";
 var CORE_VARIATION_BLOCK_NAME_PATTERN = /^[^/\s]+\/[^/\s]+$/u;
+var CORE_VARIATION_POSITIONAL_TARGET_DIAGNOSTICS = {
+  empty: () => "The first positional argument (target block name) requires a block name.",
+  invalidFormat: () => "The first positional argument (target block name) must use <namespace/block-slug> format."
+};
 function formatCoreVariationMissingPositionalNameMessage(blockName) {
   return [
     `\`wp-typia add core-variation ${blockName}\` is missing <name>.`,
@@ -610,6 +614,7 @@ function resolveCoreVariationInputs(context) {
     }
     return {
       targetBlockName: positionalTargetBlockName,
+      targetBlockNameDiagnostics: CORE_VARIATION_POSITIONAL_TARGET_DIAGNOSTICS,
       variationName: positionalVariationName
     };
   }
@@ -624,6 +629,7 @@ function resolveCoreVariationInputs(context) {
   }
   return {
     targetBlockName: targetBlockFlag,
+    targetBlockNameDiagnostics: "--block",
     variationName
   };
 }
@@ -643,11 +649,12 @@ var coreVariationAddKindEntry = defineAddKindRegistryEntry({
   description: "Add an editor-side variation for an existing core or external block",
   nameLabel: "Variation name",
   async prepareExecution(context) {
-    const { targetBlockName, variationName } = resolveCoreVariationInputs(context);
+    const { targetBlockName, targetBlockNameDiagnostics, variationName } = resolveCoreVariationInputs(context);
     return createNamedExecutionPlan(context, {
       execute: ({ cwd, name }) => context.addRuntime.runAddCoreVariationCommand({
         cwd,
         targetBlockName,
+        targetBlockNameDiagnostics,
         variationName: name
       }),
       getValues: (result) => ({
@@ -826,11 +833,15 @@ var patternAddKindEntry = defineAddKindRegistryEntry({
   nameLabel: "Pattern name",
   async prepareExecution(context) {
     const name = requireAddKindName(context, PATTERN_MISSING_NAME_MESSAGE);
+    const rawScope = typeof context.flags.scope === "string" ? context.flags.scope : undefined;
+    const rawSectionRole = typeof context.flags["section-role"] === "string" ? context.flags["section-role"] : undefined;
+    const rawCatalogTitle = typeof context.flags["catalog-title"] === "string" ? context.flags["catalog-title"] : undefined;
+    const rawThumbnailUrl = typeof context.flags["thumbnail-url"] === "string" ? context.flags["thumbnail-url"] : undefined;
     const scope = resolvePatternScopeFlag(context);
     const sectionRole = resolvePatternSectionRoleFlag(context, scope);
-    const catalogTitle = typeof context.flags["catalog-title"] === "string" ? context.flags["catalog-title"] : undefined;
+    const catalogTitle = rawCatalogTitle;
     const tags = normalizePatternTagFlags(context.flags.tags, context.flags.tag);
-    const thumbnailUrl = typeof context.flags["thumbnail-url"] === "string" ? context.flags["thumbnail-url"] : undefined;
+    const thumbnailUrl = rawThumbnailUrl;
     return {
       execute: (cwd) => context.addRuntime.runAddPatternCommand({
         catalogTitle,
@@ -841,6 +852,13 @@ var patternAddKindEntry = defineAddKindRegistryEntry({
         tags,
         thumbnailUrl
       }),
+      getDryRunSummaryLines: (result) => buildPatternCatalogDryRunSummaryLines(result, {
+        rawCatalogTitle,
+        rawScope,
+        rawSectionRole,
+        rawTags: tags,
+        rawThumbnailUrl
+      }),
       getValues: (result) => ({
         contentFile: result.contentFile,
         patternSlug: result.patternSlug,
@@ -904,6 +922,75 @@ function normalizePatternTagFlags(tagsFlag, tagFlag) {
   ];
   return tags.length > 0 ? tags : undefined;
 }
+function quoteValue(value) {
+  return `"${value}"`;
+}
+function formatTags(tags) {
+  return tags.length > 0 ? tags.join(", ") : "no tags";
+}
+function collectPatternTagTokens(tags) {
+  return (tags ?? []).flatMap((tag) => tag.split(",")).map((tag) => tag.trim()).filter((tag) => tag.length > 0);
+}
+function valuesMatch(left, right) {
+  return left.length === right.length && left.every((value, index) => value === right[index]);
+}
+function createNormalizationNote(options) {
+  const rawValue = options.rawValue;
+  if (rawValue === undefined || rawValue.trim().length === 0 || !options.resolvedValue || rawValue === options.resolvedValue) {
+    return;
+  }
+  return `${options.fieldLabel} normalized from ${quoteValue(rawValue)} to ${quoteValue(options.resolvedValue)}.`;
+}
+function collectPatternCatalogNormalizationNotes(result, options) {
+  const notes = [
+    createNormalizationNote({
+      fieldLabel: "Scope",
+      rawValue: options.rawScope,
+      resolvedValue: result.patternScope
+    }),
+    createNormalizationNote({
+      fieldLabel: "Section role",
+      rawValue: options.rawSectionRole,
+      resolvedValue: result.sectionRole
+    }),
+    createNormalizationNote({
+      fieldLabel: "Title",
+      rawValue: options.rawCatalogTitle,
+      resolvedValue: result.title
+    }),
+    createNormalizationNote({
+      fieldLabel: "Thumbnail URL",
+      rawValue: options.rawThumbnailUrl,
+      resolvedValue: result.thumbnailUrl
+    })
+  ].filter((note) => typeof note === "string");
+  const rawTags = collectPatternTagTokens(options.rawTags);
+  if (rawTags.length > 0 && !valuesMatch(rawTags, result.tags)) {
+    notes.push(`Tags normalized from ${quoteValue(formatTags(rawTags))} to ${quoteValue(formatTags(result.tags))}.`);
+  }
+  return notes;
+}
+function buildPatternCatalogDryRunSummaryLines(result, options) {
+  const catalogLines = [
+    "",
+    "Catalog metadata:",
+    `  Scope: ${result.patternScope}`,
+    ...result.sectionRole ? [`  Section role: ${result.sectionRole}`] : [],
+    `  Title: ${result.title}`,
+    ...result.tags.length > 0 ? [`  Tags: ${formatTags(result.tags)}`] : [],
+    ...result.thumbnailUrl ? [`  Thumbnail URL: ${result.thumbnailUrl}`] : []
+  ];
+  const normalizationNotes = collectPatternCatalogNormalizationNotes(result, options);
+  if (normalizationNotes.length === 0) {
+    return catalogLines;
+  }
+  return [
+    ...catalogLines,
+    "",
+    "Normalization notes:",
+    ...normalizationNotes.map((note) => `  ${note}`)
+  ];
+}
 
 // src/add-kinds/post-meta.ts
 var POST_META_MISSING_NAME_MESSAGE = "`wp-typia add post-meta` requires <name>. Usage: wp-typia add post-meta <name> --post-type <post-type> [--type <ExportedTypeName>] [--meta-key <meta-key>].";
@@ -1733,12 +1820,16 @@ function buildAddCompletionPayload(options, markerOptions) {
 }
 function buildAddDryRunPayload(options, markerOptions) {
   const normalizedTitle = stripLeadingOutputMarker(options.completion.title, "success").replace(/^Added\s*/u, "");
+  const summaryLines = [
+    ...options.completion.summaryLines ?? [],
+    ...options.summaryLines ?? []
+  ];
   return {
     optionalLines: options.fileOperations,
     optionalNote: "No workspace files were changed because --dry-run was enabled. Re-run without --dry-run to apply this add command.",
     optionalTitle: `Planned workspace updates (${options.fileOperations.length}):`,
     preambleLines: options.completion.preambleLines,
-    summaryLines: options.completion.summaryLines,
+    summaryLines: summaryLines.length > 0 ? summaryLines : undefined,
     title: formatOutputMarker("dryRun", `Dry run for ${normalizedTitle || "workspace add command"}`, markerOptions),
     warningLines: options.completion.warningLines
   };
@@ -1858,7 +1949,7 @@ function pushFlag(argv, name, value) {
 }
 
 // src/runtime-bridge-add.ts
-var loadCliAddRuntime = () => import("./cli-add-mxxk5rep.js");
+var loadCliAddRuntime = () => import("./cli-add-qjd3ba8j.js");
 var loadCliPromptRuntime = () => import("./cli-prompt-ncyg68rn.js");
 async function executeWorkspaceAddWithOptionalDryRun(options) {
   const simulated = options.dryRun ? await simulateWorkspaceAddDryRun({
@@ -1876,7 +1967,8 @@ async function executeWorkspaceAddWithOptionalDryRun(options) {
   }
   return emitCompletion(buildAddDryRunPayload({
     completion,
-    fileOperations: simulated.fileOperations
+    fileOperations: simulated.fileOperations,
+    summaryLines: options.buildDryRunSummaryLines?.(result)
   }), {
     emitOutput: options.emitOutput ?? true,
     printLine: options.printLine,
@@ -1891,6 +1983,7 @@ function executePreparedAddKind(kind, context, plan) {
       values: plan.getValues(result),
       warnings: plan.getWarnings?.(result)
     }),
+    buildDryRunSummaryLines: (result) => plan.getDryRunSummaryLines?.(result),
     cwd: context.cwd,
     dryRun: context.dryRun,
     emitOutput: context.emitOutput,
@@ -3917,4 +4010,4 @@ export {
   wpTypiaCommands
 };
 
-//# debugId=F41601669F8057C564756E2164756E21
+//# debugId=3C2BF11DC520694164756E2164756E21

package/dist-bunli/node-cli.js

@@ -620,7 +620,11 @@ function resolveCommandOptionValues(metadata, options) {
       continue;
     }
     if (descriptor.repeatable && Array.isArray(value)) {
-      resolved[name] = value.every((item) => typeof item === "string") ? value.join(",") : undefined;
+      if (!value.every((item) => typeof item === "string")) {
+        resolved[name] = undefined;
+        continue;
+      }
+      resolved[name] = options.preserveArrays ? [...value] : value.join(",");
       continue;
     }
     resolved[name] = typeof value === "string" ? value : undefined;
@@ -1470,6 +1474,10 @@ import {
 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>.";
 var CORE_VARIATION_BLOCK_NAME_PATTERN = /^[^/\s]+\/[^/\s]+$/u;
+var CORE_VARIATION_POSITIONAL_TARGET_DIAGNOSTICS = {
+  empty: () => "The first positional argument (target block name) requires a block name.",
+  invalidFormat: () => "The first positional argument (target block name) must use <namespace/block-slug> format."
+};
 function formatCoreVariationMissingPositionalNameMessage(blockName) {
   return [
     `\`wp-typia add core-variation ${blockName}\` is missing <name>.`,
@@ -1487,6 +1495,7 @@ function resolveCoreVariationInputs(context) {
     }
     return {
       targetBlockName: positionalTargetBlockName,
+      targetBlockNameDiagnostics: CORE_VARIATION_POSITIONAL_TARGET_DIAGNOSTICS,
       variationName: positionalVariationName
     };
   }
@@ -1501,6 +1510,7 @@ function resolveCoreVariationInputs(context) {
   }
   return {
     targetBlockName: targetBlockFlag,
+    targetBlockNameDiagnostics: "--block",
     variationName
   };
 }
@@ -1520,11 +1530,12 @@ var coreVariationAddKindEntry = defineAddKindRegistryEntry({
   description: "Add an editor-side variation for an existing core or external block",
   nameLabel: "Variation name",
   async prepareExecution(context) {
-    const { targetBlockName, variationName } = resolveCoreVariationInputs(context);
+    const { targetBlockName, targetBlockNameDiagnostics, variationName } = resolveCoreVariationInputs(context);
     return createNamedExecutionPlan(context, {
       execute: ({ cwd, name }) => context.addRuntime.runAddCoreVariationCommand({
         cwd,
         targetBlockName,
+        targetBlockNameDiagnostics,
         variationName: name
       }),
       getValues: (result) => ({
@@ -1707,11 +1718,15 @@ var patternAddKindEntry = defineAddKindRegistryEntry({
   nameLabel: "Pattern name",
   async prepareExecution(context) {
     const name = requireAddKindName(context, PATTERN_MISSING_NAME_MESSAGE);
+    const rawScope = typeof context.flags.scope === "string" ? context.flags.scope : undefined;
+    const rawSectionRole = typeof context.flags["section-role"] === "string" ? context.flags["section-role"] : undefined;
+    const rawCatalogTitle = typeof context.flags["catalog-title"] === "string" ? context.flags["catalog-title"] : undefined;
+    const rawThumbnailUrl = typeof context.flags["thumbnail-url"] === "string" ? context.flags["thumbnail-url"] : undefined;
     const scope = resolvePatternScopeFlag(context);
     const sectionRole = resolvePatternSectionRoleFlag(context, scope);
-    const catalogTitle = typeof context.flags["catalog-title"] === "string" ? context.flags["catalog-title"] : undefined;
+    const catalogTitle = rawCatalogTitle;
     const tags = normalizePatternTagFlags(context.flags.tags, context.flags.tag);
-    const thumbnailUrl = typeof context.flags["thumbnail-url"] === "string" ? context.flags["thumbnail-url"] : undefined;
+    const thumbnailUrl = rawThumbnailUrl;
     return {
       execute: (cwd) => context.addRuntime.runAddPatternCommand({
         catalogTitle,
@@ -1722,6 +1737,13 @@ var patternAddKindEntry = defineAddKindRegistryEntry({
         tags,
         thumbnailUrl
       }),
+      getDryRunSummaryLines: (result) => buildPatternCatalogDryRunSummaryLines(result, {
+        rawCatalogTitle,
+        rawScope,
+        rawSectionRole,
+        rawTags: tags,
+        rawThumbnailUrl
+      }),
       getValues: (result) => ({
         contentFile: result.contentFile,
         patternSlug: result.patternSlug,
@@ -1785,6 +1807,75 @@ function normalizePatternTagFlags(tagsFlag, tagFlag) {
   ];
   return tags.length > 0 ? tags : undefined;
 }
+function quoteValue(value) {
+  return `"${value}"`;
+}
+function formatTags(tags) {
+  return tags.length > 0 ? tags.join(", ") : "no tags";
+}
+function collectPatternTagTokens(tags) {
+  return (tags ?? []).flatMap((tag) => tag.split(",")).map((tag) => tag.trim()).filter((tag) => tag.length > 0);
+}
+function valuesMatch(left, right) {
+  return left.length === right.length && left.every((value, index) => value === right[index]);
+}
+function createNormalizationNote(options) {
+  const rawValue = options.rawValue;
+  if (rawValue === undefined || rawValue.trim().length === 0 || !options.resolvedValue || rawValue === options.resolvedValue) {
+    return;
+  }
+  return `${options.fieldLabel} normalized from ${quoteValue(rawValue)} to ${quoteValue(options.resolvedValue)}.`;
+}
+function collectPatternCatalogNormalizationNotes(result, options) {
+  const notes = [
+    createNormalizationNote({
+      fieldLabel: "Scope",
+      rawValue: options.rawScope,
+      resolvedValue: result.patternScope
+    }),
+    createNormalizationNote({
+      fieldLabel: "Section role",
+      rawValue: options.rawSectionRole,
+      resolvedValue: result.sectionRole
+    }),
+    createNormalizationNote({
+      fieldLabel: "Title",
+      rawValue: options.rawCatalogTitle,
+      resolvedValue: result.title
+    }),
+    createNormalizationNote({
+      fieldLabel: "Thumbnail URL",
+      rawValue: options.rawThumbnailUrl,
+      resolvedValue: result.thumbnailUrl
+    })
+  ].filter((note) => typeof note === "string");
+  const rawTags = collectPatternTagTokens(options.rawTags);
+  if (rawTags.length > 0 && !valuesMatch(rawTags, result.tags)) {
+    notes.push(`Tags normalized from ${quoteValue(formatTags(rawTags))} to ${quoteValue(formatTags(result.tags))}.`);
+  }
+  return notes;
+}
+function buildPatternCatalogDryRunSummaryLines(result, options) {
+  const catalogLines = [
+    "",
+    "Catalog metadata:",
+    `  Scope: ${result.patternScope}`,
+    ...result.sectionRole ? [`  Section role: ${result.sectionRole}`] : [],
+    `  Title: ${result.title}`,
+    ...result.tags.length > 0 ? [`  Tags: ${formatTags(result.tags)}`] : [],
+    ...result.thumbnailUrl ? [`  Thumbnail URL: ${result.thumbnailUrl}`] : []
+  ];
+  const normalizationNotes = collectPatternCatalogNormalizationNotes(result, options);
+  if (normalizationNotes.length === 0) {
+    return catalogLines;
+  }
+  return [
+    ...catalogLines,
+    "",
+    "Normalization notes:",
+    ...normalizationNotes.map((note) => `  ${note}`)
+  ];
+}
 
 // src/add-kinds/post-meta.ts
 var POST_META_MISSING_NAME_MESSAGE = "`wp-typia add post-meta` requires <name>. Usage: wp-typia add post-meta <name> --post-type <post-type> [--type <ExportedTypeName>] [--meta-key <meta-key>].";
@@ -2539,7 +2630,7 @@ function buildStructuredInitSuccessPayload(plan) {
 // package.json
 var package_default = {
   name: "wp-typia",
-  version: "0.24.3",
+  version: "0.24.4",
   description: "Canonical CLI package for wp-typia scaffolding and project workflows",
   packageManager: "bun@1.3.11",
   type: "module",
@@ -2609,7 +2700,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.24.3",
+    "@wp-typia/project-tools": "0.24.4",
     "better-result": "^2.7.0",
     react: "^19.2.5",
     "react-dom": "^19.2.5",
@@ -2730,12 +2821,16 @@ function buildAddCompletionPayload(options, markerOptions) {
 }
 function buildAddDryRunPayload(options, markerOptions) {
   const normalizedTitle = stripLeadingOutputMarker(options.completion.title, "success").replace(/^Added\s*/u, "");
+  const summaryLines = [
+    ...options.completion.summaryLines ?? [],
+    ...options.summaryLines ?? []
+  ];
   return {
     optionalLines: options.fileOperations,
     optionalNote: "No workspace files were changed because --dry-run was enabled. Re-run without --dry-run to apply this add command.",
     optionalTitle: `Planned workspace updates (${options.fileOperations.length}):`,
     preambleLines: options.completion.preambleLines,
-    summaryLines: options.completion.summaryLines,
+    summaryLines: summaryLines.length > 0 ? summaryLines : undefined,
     title: formatOutputMarker("dryRun", `Dry run for ${normalizedTitle || "workspace add command"}`, markerOptions),
     warningLines: options.completion.warningLines
   };
@@ -2869,7 +2964,8 @@ async function executeWorkspaceAddWithOptionalDryRun(options) {
   }
   return emitCompletion(buildAddDryRunPayload({
     completion,
-    fileOperations: simulated.fileOperations
+    fileOperations: simulated.fileOperations,
+    summaryLines: options.buildDryRunSummaryLines?.(result)
   }), {
     emitOutput: options.emitOutput ?? true,
     printLine: options.printLine,
@@ -2884,6 +2980,7 @@ function executePreparedAddKind(kind, context, plan) {
       values: plan.getValues(result),
       warnings: plan.getWarnings?.(result)
     }),
+    buildDryRunSummaryLines: (result) => plan.getDryRunSummaryLines?.(result),
     cwd: context.cwd,
     dryRun: context.dryRun,
     emitOutput: context.emitOutput,
@@ -4362,4 +4459,4 @@ export {
   hasFlagBeforeTerminator
 };
 
-//# debugId=5AEE5FBC0C6CEA8264756E2164756E21
+//# debugId=89953F05ED6BD87364756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wp-typia",
-  "version": "0.24.3",
+  "version": "0.24.4",
   "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.24.3",
+    "@wp-typia/project-tools": "0.24.4",
     "better-result": "^2.7.0",
     "react": "^19.2.5",
     "react-dom": "^19.2.5",