wp-typia 0.20.4 → 0.21.0

package/dist-bunli/{cli-68145vb5.js → cli-9x01fjna.js}

@@ -3,13 +3,15 @@ import {
   exports_external
 } from "./cli-hv2yedw2.js";
 import {
+  CLI_DIAGNOSTIC_CODES,
   createCliCommandError,
+  createCliDiagnosticCodeError,
   serializeCliDiagnosticError
-} from "./cli-jcd4wgam.js";
+} from "./cli-p95wr1q8.js";
 // package.json
 var package_default = {
   name: "wp-typia",
-  version: "0.20.4",
+  version: "0.21.0",
   description: "Canonical CLI package for wp-typia scaffolding and project workflows",
   packageManager: "bun@1.3.11",
   type: "module",
@@ -23,7 +25,9 @@ var package_default = {
     "package.json"
   ],
   scripts: {
-    generate: "bun scripts/generate-bunli-metadata.ts",
+    "generate:routing": "node scripts/generate-routing-metadata.mjs",
+    "validate:routing": "node scripts/generate-routing-metadata.mjs --check",
+    generate: "node scripts/generate-routing-metadata.mjs && bun scripts/generate-bunli-metadata.ts",
     build: "bun run generate && bun scripts/build-bunli-runtime.ts",
     "build:standalone": "bun scripts/build-standalone-runtime.ts --targets native --outdir ./dist-standalone",
     "build:standalone:release": "bun scripts/build-standalone-runtime.ts --targets darwin-arm64,darwin-x64,linux-arm64,linux-x64,windows-x64 --outdir ./.cache/standalone/raw",
@@ -77,7 +81,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.20.1",
+    "@wp-typia/project-tools": "0.21.0",
     "better-result": "^2.7.0",
     react: "^19.2.5",
     "react-dom": "^19.2.5",
@@ -196,8 +200,12 @@ var ADD_OPTION_METADATA = {
     description: "Anchor block name for hooked-block workflows.",
     type: "string"
   },
+  attribute: {
+    description: "Target block attribute for end-to-end binding-source workflows.",
+    type: "string"
+  },
   block: {
-    description: "Target block slug for variation workflows.",
+    description: "Target block slug for variation, style, and end-to-end binding-source workflows.",
     type: "string"
   },
   "data-storage": {
@@ -217,6 +225,10 @@ var ADD_OPTION_METADATA = {
     description: "Local path, GitHub locator, or npm package that exposes wp-typia.layers.json for built-in block templates.",
     type: "string"
   },
+  from: {
+    description: "Source full block name (namespace/block) for transform workflows.",
+    type: "string"
+  },
   "inner-blocks-preset": {
     description: "Compound-only InnerBlocks preset (freeform, ordered, horizontal, locked-structure).",
     type: "string"
@@ -238,11 +250,31 @@ var ADD_OPTION_METADATA = {
     type: "string"
   },
   slot: {
-    description: "Document editor shell slot for editor-plugin workflows.",
+    description: "Document editor shell slot for editor-plugin workflows (sidebar or document-setting-panel).",
+    type: "string"
+  },
+  source: {
+    description: "Optional data source locator for admin-view workflows, such as rest-resource:products.",
     type: "string"
   },
   template: {
-    description: "Built-in block family for the new block.",
+    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"
+  },
+  to: {
+    description: "Target workspace block slug or full block name for transform workflows.",
+    type: "string"
+  }
+};
+var INIT_OPTION_METADATA = {
+  apply: {
+    argumentKind: "flag",
+    description: "Write the planned package.json updates and retrofit helper files instead of previewing only.",
+    type: "boolean"
+  },
+  "package-manager": {
+    description: "Package manager to use for emitted scripts and next steps.",
+    short: "p",
     type: "string"
   }
 };
@@ -294,6 +326,12 @@ var SYNC_OPTION_METADATA = {
     type: "boolean"
   }
 };
+var DOCTOR_OPTION_METADATA = {
+  format: {
+    description: "Use `json` for machine-readable doctor check output.",
+    type: "string"
+  }
+};
 var TEMPLATES_OPTION_METADATA = {
   id: {
     description: "Template id for `templates inspect`.",
@@ -319,6 +357,30 @@ var GLOBAL_OPTION_METADATA = {
     type: "string"
   }
 };
+var COMMAND_OPTION_METADATA_BY_GROUP = {
+  add: ADD_OPTION_METADATA,
+  create: CREATE_OPTION_METADATA,
+  doctor: DOCTOR_OPTION_METADATA,
+  global: GLOBAL_OPTION_METADATA,
+  init: INIT_OPTION_METADATA,
+  migrate: MIGRATE_OPTION_METADATA,
+  sync: SYNC_OPTION_METADATA,
+  templates: TEMPLATES_OPTION_METADATA
+};
+var COMMAND_OPTION_GROUP_NAMES = Object.keys(COMMAND_OPTION_METADATA_BY_GROUP);
+function collectCommandOptionMetadata(...groupNames) {
+  const metadata = {};
+  for (const groupName of groupNames) {
+    for (const [optionName, option] of Object.entries(COMMAND_OPTION_METADATA_BY_GROUP[groupName])) {
+      metadata[optionName] = {
+        ...metadata[optionName] ?? {},
+        ...option
+      };
+    }
+  }
+  return metadata;
+}
+var ALL_COMMAND_OPTION_METADATA = collectCommandOptionMetadata(...COMMAND_OPTION_GROUP_NAMES);
 function buildCommandOptions(metadata) {
   return Object.fromEntries(Object.entries(metadata).map(([name, option]) => [
     name,
@@ -334,13 +396,99 @@ function collectOptionNamesByType(metadata, type) {
   return Object.entries(metadata).filter(([, option]) => option.type === type).map(([name]) => name);
 }
 function buildCommandOptionParser(...metadataMaps) {
-  const metadata = Object.assign({}, ...metadataMaps);
+  const metadata = {};
+  for (const metadataMap of metadataMaps) {
+    for (const [optionName, option] of Object.entries(metadataMap)) {
+      metadata[optionName] = {
+        ...metadata[optionName] ?? {},
+        ...option
+      };
+    }
+  }
   return {
     booleanOptionNames: new Set(collectOptionNamesByType(metadata, "boolean")),
     shortFlagMap: new Map(Object.entries(metadata).flatMap(([name, option]) => option.short ? [[option.short, { name, type: option.type }]] : [])),
     stringOptionNames: new Set(collectOptionNamesByType(metadata, "string"))
   };
 }
+function buildArgvWalkerRoutingMetadata(...metadataMaps) {
+  const parser = buildCommandOptionParser(...metadataMaps);
+  return {
+    longValueOptions: Array.from(parser.stringOptionNames).map((optionName) => `--${optionName}`).sort((left, right) => left.localeCompare(right)),
+    shortValueOptions: Array.from(parser.shortFlagMap.entries()).filter(([, option]) => option.type === "string").map(([short]) => `-${short}`).sort((left, right) => left.localeCompare(right))
+  };
+}
+var COMMAND_ROUTING_METADATA = buildArgvWalkerRoutingMetadata(ALL_COMMAND_OPTION_METADATA);
+function extractKnownOptionValuesFromArgv(argv, options) {
+  const flags = {};
+  const nextArgv = [];
+  const optionNames = new Set(options.optionNames);
+  for (let index = 0;index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (!arg) {
+      continue;
+    }
+    if (arg === "--") {
+      nextArgv.push(...argv.slice(index));
+      break;
+    }
+    if (arg.length === 2 && arg.startsWith("-")) {
+      const shortFlag = options.parser.shortFlagMap.get(arg.slice(1));
+      if (!shortFlag || !optionNames.has(shortFlag.name)) {
+        nextArgv.push(arg);
+        continue;
+      }
+      if (shortFlag.type === "boolean") {
+        flags[shortFlag.name] = true;
+        continue;
+      }
+      const next = argv[index + 1];
+      if (!next || next.startsWith("-")) {
+        throw new Error(`\`${arg}\` requires a value.`);
+      }
+      flags[shortFlag.name] = next;
+      index += 1;
+      continue;
+    }
+    if (arg.startsWith("--")) {
+      const option = arg.slice(2);
+      const separatorIndex = option.indexOf("=");
+      const rawName = separatorIndex === -1 ? option : option.slice(0, separatorIndex);
+      const inlineValue = separatorIndex === -1 ? undefined : option.slice(separatorIndex + 1);
+      if (!optionNames.has(rawName)) {
+        nextArgv.push(arg);
+        continue;
+      }
+      if (options.parser.booleanOptionNames.has(rawName)) {
+        flags[rawName] = true;
+        continue;
+      }
+      if (!options.parser.stringOptionNames.has(rawName)) {
+        nextArgv.push(arg);
+        continue;
+      }
+      if (inlineValue !== undefined) {
+        if (!inlineValue) {
+          throw new Error(`\`--${rawName}\` requires a value.`);
+        }
+        flags[rawName] = inlineValue;
+        continue;
+      }
+      const next = argv[index + 1];
+      if (!next || next.startsWith("-")) {
+        throw new Error(`\`--${rawName}\` requires a value.`);
+      }
+      flags[rawName] = next;
+      index += 1;
+      continue;
+    }
+    nextArgv.push(arg);
+  }
+  return {
+    argv: nextArgv,
+    flags
+  };
+}
 function resolveCommandOptionValues(metadata, options) {
   const resolved = {};
   const optionNames = options.optionNames ?? Object.keys(metadata);
@@ -360,47 +508,54 @@ function resolveCommandOptionValues(metadata, options) {
   return resolved;
 }
 
-// src/cli-diagnostic-output.ts
-var ALL_OPTION_METADATA = {
-  ...GLOBAL_OPTION_METADATA,
-  ...CREATE_OPTION_METADATA,
-  ...ADD_OPTION_METADATA,
-  ...MIGRATE_OPTION_METADATA,
-  ...SYNC_OPTION_METADATA,
-  ...TEMPLATES_OPTION_METADATA
-};
-var CLI_STRING_OPTION_NAMES = new Set(Object.entries(ALL_OPTION_METADATA).flatMap(([name, option]) => option.type === "string" ? [
-  `--${name}`,
-  ..."short" in option && option.short ? [`-${option.short}`] : []
-] : []));
-function resolveEntrypointCliCommand(argv) {
+// bin/argv-walker.js
+function normalizeOptionSet(values) {
+  return values instanceof Set ? values : new Set(values);
+}
+function collectPositionalIndexes(argv, metadata) {
+  const longValueOptionSet = normalizeOptionSet(metadata.longValueOptions);
+  const shortValueOptionSet = normalizeOptionSet(metadata.shortValueOptions);
+  const positionalIndexes = [];
   for (let index = 0;index < argv.length; index += 1) {
     const arg = argv[index];
-    if (!arg) {
-      continue;
-    }
     if (arg === "--") {
+      for (let restIndex = index + 1;restIndex < argv.length; restIndex += 1) {
+        positionalIndexes.push(restIndex);
+      }
       break;
     }
-    if (CLI_STRING_OPTION_NAMES.has(arg)) {
-      const next = argv[index + 1];
-      if (next && !next.startsWith("-")) {
-        index += 1;
-      }
+    if (!arg.startsWith("-") || arg === "-") {
+      positionalIndexes.push(index);
       continue;
     }
     if (arg.startsWith("--")) {
-      const [inlineName] = arg.split("=", 1);
-      if (inlineName && CLI_STRING_OPTION_NAMES.has(inlineName)) {
+      if (arg.includes("=")) {
         continue;
       }
-    }
-    if (arg.startsWith("-")) {
+      const next = argv[index + 1];
+      if (longValueOptionSet.has(arg) && next && !next.startsWith("-")) {
+        index += 1;
+      }
       continue;
     }
-    return arg;
+    if (arg.length === 2 && shortValueOptionSet.has(arg) && argv[index + 1] && !argv[index + 1].startsWith("-")) {
+      index += 1;
+    }
   }
-  return "wp-typia";
+  return positionalIndexes;
+}
+function findFirstPositionalIndex(argv, metadata) {
+  const positionalIndexes = collectPositionalIndexes(argv, metadata);
+  return positionalIndexes[0] ?? -1;
+}
+function findFirstPositional(argv, metadata) {
+  const firstPositionalIndex = findFirstPositionalIndex(argv, metadata);
+  return firstPositionalIndex === -1 ? undefined : argv[firstPositionalIndex];
+}
+
+// src/cli-diagnostic-output.ts
+function resolveEntrypointCliCommand(argv) {
+  return findFirstPositional(argv, COMMAND_ROUTING_METADATA) ?? "wp-typia";
 }
 function prefersStructuredCliArgv(argv) {
   for (let index = 0;index < argv.length; index += 1) {
@@ -451,6 +606,150 @@ function writeStructuredCliDiagnosticError(argv, error) {
   return true;
 }
 
+// src/command-registry.ts
+var WP_TYPIA_CANONICAL_CREATE_USAGE = "wp-typia create <project-dir>";
+var WP_TYPIA_COMMAND_REGISTRY = [
+  {
+    commandTree: true,
+    description: "Scaffold a new wp-typia project.",
+    name: "create",
+    nodeFallback: true,
+    optionGroups: ["create"],
+    requiresBunRuntime: false
+  },
+  {
+    commandTree: true,
+    description: "Preview or apply the minimum retrofit plan for an existing project.",
+    name: "init",
+    nodeFallback: true,
+    optionGroups: ["init"],
+    requiresBunRuntime: false
+  },
+  {
+    commandTree: true,
+    description: "Run the common generated-project sync workflow.",
+    name: "sync",
+    nodeFallback: true,
+    optionGroups: ["sync"],
+    requiresBunRuntime: false,
+    subcommands: ["ai"]
+  },
+  {
+    commandTree: true,
+    description: "Extend an official wp-typia workspace.",
+    name: "add",
+    nodeFallback: true,
+    optionGroups: ["add"],
+    requiresBunRuntime: false,
+    subcommands: [
+      "block",
+      "variation",
+      "style",
+      "transform",
+      "pattern",
+      "binding-source",
+      "rest-resource",
+      "editor-plugin",
+      "hooked-block"
+    ]
+  },
+  {
+    commandTree: true,
+    description: "Run migration workflows.",
+    name: "migrate",
+    nodeFallback: true,
+    optionGroups: ["migrate"],
+    requiresBunRuntime: false,
+    subcommands: [
+      "init",
+      "snapshot",
+      "diff",
+      "scaffold",
+      "plan",
+      "wizard",
+      "verify",
+      "doctor",
+      "fixtures",
+      "fuzz"
+    ]
+  },
+  {
+    commandTree: true,
+    description: "Inspect scaffold templates.",
+    name: "templates",
+    nodeFallback: true,
+    optionGroups: ["templates"],
+    requiresBunRuntime: false,
+    subcommands: ["list", "inspect"]
+  },
+  {
+    commandTree: true,
+    description: "Run repository and project diagnostics.",
+    name: "doctor",
+    nodeFallback: true,
+    optionGroups: ["doctor"],
+    requiresBunRuntime: false
+  },
+  {
+    commandTree: true,
+    description: "Inspect or sync schema-driven MCP metadata.",
+    name: "mcp",
+    nodeFallback: false,
+    optionGroups: [],
+    requiresBunRuntime: true,
+    subcommands: ["list", "sync"]
+  },
+  {
+    commandTree: false,
+    name: "help",
+    nodeFallback: true,
+    optionGroups: [],
+    requiresBunRuntime: false
+  },
+  {
+    commandTree: false,
+    name: "version",
+    nodeFallback: true,
+    optionGroups: [],
+    requiresBunRuntime: false
+  },
+  {
+    commandTree: false,
+    name: "skills",
+    nodeFallback: false,
+    optionGroups: [],
+    requiresBunRuntime: true
+  },
+  {
+    commandTree: false,
+    name: "completions",
+    nodeFallback: false,
+    optionGroups: [],
+    requiresBunRuntime: true
+  },
+  {
+    commandTree: false,
+    name: "complete",
+    nodeFallback: false,
+    optionGroups: [],
+    requiresBunRuntime: true
+  }
+];
+var WP_TYPIA_RESERVED_TOP_LEVEL_COMMAND_NAMES = WP_TYPIA_COMMAND_REGISTRY.map((command) => command.name);
+var WP_TYPIA_NODE_FALLBACK_TOP_LEVEL_COMMAND_NAMES = WP_TYPIA_COMMAND_REGISTRY.filter((command) => command.nodeFallback).map((command) => command.name);
+var WP_TYPIA_TOP_LEVEL_COMMAND_NAMES = WP_TYPIA_COMMAND_REGISTRY.filter((command) => command.commandTree).map((command) => command.name);
+var WP_TYPIA_BUN_REQUIRED_TOP_LEVEL_COMMAND_NAMES = WP_TYPIA_COMMAND_REGISTRY.filter((command) => command.requiresBunRuntime).map((command) => command.name);
+var WP_TYPIA_FUTURE_COMMAND_TREE = WP_TYPIA_COMMAND_REGISTRY.filter((command) => command.commandTree).map((command) => ({
+  description: command.description,
+  name: command.name,
+  subcommands: "subcommands" in command ? command.subcommands : undefined
+}));
+var commandOptionGroupNamesByTopLevelCommand = {};
+for (const command of WP_TYPIA_COMMAND_REGISTRY) {
+  commandOptionGroupNamesByTopLevelCommand[command.name] = command.optionGroups;
+}
+var WP_TYPIA_COMMAND_OPTION_GROUP_NAMES_BY_TOP_LEVEL_COMMAND = commandOptionGroupNamesByTopLevelCommand;
+
 // src/config.ts
 import fs from "fs/promises";
 import os from "os";
@@ -477,16 +776,22 @@ function deepMerge(base, incoming) {
   return merged;
 }
 async function readJsonFile(filePath) {
+  let source;
   try {
-    const source = await fs.readFile(filePath, "utf8");
-    const parsed = JSON.parse(source);
-    return isRecord(parsed) ? parsed : null;
+    source = await fs.readFile(filePath, "utf8");
   } catch (error) {
     if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") {
       return null;
     }
     throw error;
   }
+  try {
+    const parsed = JSON.parse(source);
+    return isRecord(parsed) ? parsed : null;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.INVALID_ARGUMENT, `Unable to parse ${filePath}: ${message}`, error instanceof Error ? { cause: error } : undefined);
+  }
 }
 function resolveConfigPath(cwd, source) {
   if (source.startsWith("~/")) {
@@ -530,6 +835,6 @@ function getMcpSchemaSources(config) {
 function createPlugin(input) {
   return input;
 }
-export { createPlugin, package_default, CREATE_OPTION_METADATA, ADD_OPTION_METADATA, MIGRATE_OPTION_METADATA, SYNC_OPTION_METADATA, TEMPLATES_OPTION_METADATA, GLOBAL_OPTION_METADATA, buildCommandOptions, collectOptionNamesByType, buildCommandOptionParser, resolveCommandOptionValues, prefersStructuredCliOutput, emitCliDiagnosticFailure, writeStructuredCliDiagnosticError, WP_TYPIA_CONFIG_SOURCES, mergeWpTypiaUserConfig, loadWpTypiaUserConfigFromSource, loadWpTypiaUserConfig, getCreateDefaults, getAddBlockDefaults, getMcpSchemaSources };
+export { createPlugin, package_default, CREATE_OPTION_METADATA, ADD_OPTION_METADATA, INIT_OPTION_METADATA, MIGRATE_OPTION_METADATA, SYNC_OPTION_METADATA, DOCTOR_OPTION_METADATA, TEMPLATES_OPTION_METADATA, GLOBAL_OPTION_METADATA, COMMAND_OPTION_METADATA_BY_GROUP, ALL_COMMAND_OPTION_METADATA, buildCommandOptions, collectOptionNamesByType, buildCommandOptionParser, COMMAND_ROUTING_METADATA, extractKnownOptionValuesFromArgv, resolveCommandOptionValues, collectPositionalIndexes, findFirstPositionalIndex, prefersStructuredCliOutput, emitCliDiagnosticFailure, writeStructuredCliDiagnosticError, 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=33737B5BBB1DCAAF64756E2164756E21
+//# debugId=C2E45FEA52BDC1AC64756E2164756E21