wp-typia 0.24.2 → 0.24.4

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;
@@ -989,7 +993,9 @@ var PATTERN_CATALOG_VISIBLE_FIELDS = [
   "name",
   "scope",
   "section-role",
-  "catalog-title"
+  "catalog-title",
+  "tags",
+  "thumbnail-url"
 ];
 var NAME_SOURCE_VISIBLE_FIELDS = [
   "kind",
@@ -1468,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>.`,
@@ -1485,6 +1495,7 @@ function resolveCoreVariationInputs(context) {
     }
     return {
       targetBlockName: positionalTargetBlockName,
+      targetBlockNameDiagnostics: CORE_VARIATION_POSITIONAL_TARGET_DIAGNOSTICS,
       variationName: positionalVariationName
     };
   }
@@ -1499,6 +1510,7 @@ function resolveCoreVariationInputs(context) {
   }
   return {
     targetBlockName: targetBlockFlag,
+    targetBlockNameDiagnostics: "--block",
     variationName
   };
 }
@@ -1518,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) => ({
@@ -1701,15 +1714,19 @@ var patternAddKindEntry = defineAddKindRegistryEntry({
     title: "Added workspace pattern"
   },
   description: "Add a PHP block pattern shell",
-  hiddenStringSubmitFields: ["tag", "tags", "thumbnail-url"],
+  hiddenStringSubmitFields: ["tag"],
   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,
@@ -1720,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,
@@ -1783,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>].";
@@ -2537,7 +2630,7 @@ function buildStructuredInitSuccessPayload(plan) {
 // package.json
 var package_default = {
   name: "wp-typia",
-  version: "0.24.2",
+  version: "0.24.4",
   description: "Canonical CLI package for wp-typia scaffolding and project workflows",
   packageManager: "bun@1.3.11",
   type: "module",
@@ -2607,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.2",
+    "@wp-typia/project-tools": "0.24.4",
     "better-result": "^2.7.0",
     react: "^19.2.5",
     "react-dom": "^19.2.5",
@@ -2728,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
   };
@@ -2867,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,
@@ -2882,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,
@@ -4360,4 +4459,4 @@ export {
   hasFlagBeforeTerminator
 };
 
-//# debugId=925E6E8A01768B3B64756E2164756E21
+//# debugId=89953F05ED6BD87364756E2164756E21

package/package.json

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