wp-typia 0.22.7 → 0.22.9

package/dist-bunli/{cli-add-8jpdnz1r.js → cli-add-6dn9h94t.js}

@@ -6,13 +6,12 @@ import {
   copyInterpolatedDirectory,
   createScaffoldCompatibilityConfig,
   getDefaultAnswers,
+  isCompoundPersistenceEnabled,
   listInterpolatedDirectoryOutputs,
   normalizeOptionalCliString,
   parseAlternateRenderTargets,
   parseCompoundInnerBlocksPreset,
-  parseTemplateLocator,
   renderScaffoldCompatibilityConfig,
-  require_semver,
   resolveExternalTemplateLayers,
   resolveLocalCliPathOption,
   resolveOptionalInteractiveExternalLayerId,
@@ -21,7 +20,7 @@ import {
   scaffoldProject,
   syncPersistenceRestArtifacts,
   updatePluginHeaderCompatibility
-} from "./cli-8snabymq.js";
+} from "./cli-2pnk64h0.js";
 import {
   DEFAULT_WORDPRESS_ABILITIES_VERSION,
   DEFAULT_WORDPRESS_CORE_ABILITIES_VERSION,
@@ -31,10 +30,14 @@ import {
   DEFAULT_WP_TYPIA_DATAVIEWS_VERSION,
   getPackageVersions,
   resolveManagedPackageVersionRange
-} from "./cli-2hsp17nd.js";
+} from "./cli-arz4rcye.js";
+import {
+  parseTemplateLocator,
+  require_semver
+} from "./cli-8reep89s.js";
 import {
   snapshotProjectVersion
-} from "./cli-27v2qpjg.js";
+} from "./cli-ag722tzm.js";
 import {
   ensureMigrationDirectories,
   parseMigrationConfig,
@@ -48,10 +51,10 @@ import {
   hasUncommentedPattern,
   maskTypeScriptCommentsAndLiterals
 } from "./cli-rwjkqjhs.js";
-import"./cli-10pe4mf8.js";
+import"./cli-xw1wbxf3.js";
 import {
   SHARED_WORKSPACE_TEMPLATE_ROOT
-} from "./cli-tke8twkn.js";
+} from "./cli-qse6myha.js";
 import {
   ADD_BLOCK_TEMPLATE_IDS,
   EDITOR_PLUGIN_SLOT_IDS,
@@ -76,7 +79,9 @@ import {
   findPhpFunctionRange,
   formatAddHelpText,
   getMutableBlockHooks,
+  getPropertyNameText,
   getWorkspaceBlockSelectOptions,
+  getWorkspaceBlockSelectOptionsAsync,
   getWorkspaceBootstrapPath,
   hasPhpFunctionCall,
   hasPhpFunctionDefinition,
@@ -87,8 +92,9 @@ import {
   quotePhpString,
   quoteTsString,
   readOptionalFile,
+  readOptionalUtf8File,
   readWorkspaceBlockJson,
-  readWorkspaceInventory,
+  readWorkspaceInventoryAsync,
   replacePhpFunctionDefinition,
   require_typescript,
   resolveNonEmptyNormalizedBlockSlug,
@@ -96,12 +102,14 @@ import {
   resolveWorkspaceBlock,
   rollbackWorkspaceMutation,
   snapshotWorkspaceFiles,
+  suggestAddBlockTemplateId,
   toCamelCase,
   toKebabCase,
   toPascalCase,
   toSnakeCase,
   toTitleCase
-} from "./cli-ta3y0hp2.js";
+} from "./cli-regw5384.js";
+import"./cli-cvxvcw7c.js";
 import {
   createManagedTempRoot
 } from "./cli-t73q5aqz.js";
@@ -228,7 +236,7 @@ function buildConfigEntries(templateId, variables) {
   if (templateId === "persistence") {
     return [buildPersistenceBlockConfigEntry(variables)];
   }
-  if (variables.compoundPersistenceEnabled === "true") {
+  if (isCompoundPersistenceEnabled(variables)) {
     return [
       buildPersistenceBlockConfigEntry(variables),
       buildCompoundChildConfigEntry(variables)
@@ -499,12 +507,19 @@ async function assertWorkspaceDependenciesInstalled(workspace) {
   }
   throw new Error(`Workspace dependencies have not been installed yet. Run \`${formatInstallCommand(workspace.packageManager)}\` from the workspace root before using \`wp-typia add block ...\`.`);
 }
+function getMistypedAddBlockTemplateMessage(templateId) {
+  const suggestion = suggestAddBlockTemplateId(templateId);
+  if (!suggestion) {
+    return null;
+  }
+  return `Unknown add-block template "${templateId}". Did you mean "${suggestion}"? Use \`--template ${suggestion}\`, or run \`wp-typia templates list\` to inspect available templates.`;
+}
 async function copyScaffoldedBlockSlice(projectDir, templateId, tempProjectDir, variables, legacyValidatorPaths = []) {
   if (templateId === "compound") {
     await ensureCompoundWorkspaceSupportFiles(projectDir, tempProjectDir, legacyValidatorPaths);
     await copyTempDirectory(path3.join(tempProjectDir, "src", "blocks", variables.slugKebabCase), path3.join(projectDir, "src", "blocks", variables.slugKebabCase));
     await copyTempDirectory(path3.join(tempProjectDir, "src", "blocks", `${variables.slugKebabCase}-item`), path3.join(projectDir, "src", "blocks", `${variables.slugKebabCase}-item`));
-    if (variables.compoundPersistenceEnabled === "true") {
+    if (isCompoundPersistenceEnabled(variables)) {
       await renderWorkspacePersistenceServerModule(projectDir, variables);
     }
     return;
@@ -617,7 +632,7 @@ async function syncWorkspaceAddedBlockArtifacts(projectDir, templateId, variable
   if (templateId === "compound") {
     await syncWorkspaceBlockMetadata(projectDir, `${variables.slugKebabCase}-item`, `${variables.pascalCase}ItemAttributes`, path3.join("src", "blocks", `${variables.slugKebabCase}-item`, "types.ts"));
   }
-  if (templateId === "persistence" || templateId === "compound" && variables.compoundPersistenceEnabled === "true") {
+  if (templateId === "persistence" || templateId === "compound" && isCompoundPersistenceEnabled(variables)) {
     await syncWorkspacePersistenceArtifacts(projectDir, variables);
   }
 }
@@ -676,6 +691,10 @@ async function runAddBlockCommand({
     throw new Error("`wp-typia add block --template query-loop` is not supported. Query Loop is a create-time `core/query` variation scaffold, so use `wp-typia create <project-dir> --template query-loop` instead.");
   }
   if (!isAddBlockTemplateId(templateId)) {
+    const mistypedAddBlockTemplateMessage = getMistypedAddBlockTemplateMessage(templateId);
+    if (mistypedAddBlockTemplateMessage) {
+      throw new Error(mistypedAddBlockTemplateMessage);
+    }
     throw new Error(`Unknown add-block template "${templateId}". Expected one of: ${ADD_BLOCK_TEMPLATE_IDS.join(", ")}. Run \`wp-typia templates list\` to inspect available templates.`);
   }
   const resolvedTemplateId = templateId;
@@ -772,7 +791,7 @@ async function runAddBlockCommand({
     try {
       await copyScaffoldedBlockSlice(workspace.projectDir, resolvedTemplateId, tempProjectDir, result.variables, legacyCompoundValidatorPaths);
       await addCollectionImportsForTemplate(workspace.projectDir, resolvedTemplateId, result.variables);
-      await appendBlockConfigEntries(workspace.projectDir, buildConfigEntries(resolvedTemplateId, result.variables), resolvedTemplateId === "persistence" || resolvedTemplateId === "compound" && result.variables.compoundPersistenceEnabled === "true");
+      await appendBlockConfigEntries(workspace.projectDir, buildConfigEntries(resolvedTemplateId, result.variables), resolvedTemplateId === "persistence" || resolvedTemplateId === "compound" && isCompoundPersistenceEnabled(result.variables));
       await syncWorkspaceAddedBlockArtifacts(workspace.projectDir, resolvedTemplateId, result.variables);
       await updateWorkspaceMigrationConfigIfPresent(workspace.projectDir, buildMigrationBlocks(resolvedTemplateId, result.variables));
       return {
@@ -797,6 +816,49 @@ async function runAddBlockCommand({
 import { promises as fsp9 } from "fs";
 import path14 from "path";
 
+// ../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) {
+  const trimmed = blockName.trim();
+  if (!trimmed) {
+    throw new Error(`\`${flagName}\` requires a block name.`);
+  }
+  if (!FULL_BLOCK_NAME_PATTERN.test(trimmed)) {
+    throw new Error(`\`${flagName}\` must use <namespace/block-slug> format.`);
+  }
+  return trimmed;
+}
+function resolveWorkspaceBlockTargetName(blockName, namespace, diagnostics) {
+  const trimmed = blockName.trim();
+  if (!trimmed) {
+    throw new Error(diagnostics.empty());
+  }
+  const blockNameSegments = trimmed.split("/");
+  if (blockNameSegments.length > 2) {
+    throw new Error(diagnostics.invalidFormat(trimmed));
+  }
+  if (blockNameSegments.some((segment) => segment.trim() === "")) {
+    throw new Error(diagnostics.emptySegment(trimmed));
+  }
+  const [maybeNamespace, maybeSlug] = blockNameSegments.length === 2 ? blockNameSegments : [undefined, blockNameSegments[0]];
+  if (maybeNamespace && maybeNamespace !== namespace) {
+    throw new Error(diagnostics.namespaceMismatch(trimmed, maybeNamespace, namespace));
+  }
+  const blockSlug = normalizeBlockSlug(maybeSlug ?? "");
+  return {
+    blockName: `${namespace}/${blockSlug}`,
+    blockSlug
+  };
+}
+function resolveWorkspaceTargetBlockName(blockName, namespace, flagName) {
+  return resolveWorkspaceBlockTargetName(blockName, namespace, {
+    empty: () => `\`${flagName}\` requires <block-slug|namespace/block-slug>.`,
+    emptySegment: () => `\`${flagName}\` must use <block-slug|namespace/block-slug> format.`,
+    invalidFormat: () => `\`${flagName}\` must use <block-slug|namespace/block-slug> format.`,
+    namespaceMismatch: (_input, actualNamespace, expectedNamespace) => `\`${flagName}\` references namespace "${actualNamespace}". Expected "${expectedNamespace}".`
+  });
+}
+
 // ../wp-typia-project-tools/src/runtime/cli-add-workspace-admin-view-types.ts
 var ADMIN_VIEW_REST_SOURCE_KIND = "rest-resource";
 var ADMIN_VIEW_CORE_DATA_SOURCE_KIND = "core-data";
@@ -904,7 +966,6 @@ function resolveAdminViewCoreDataSource(source) {
 }
 
 // ../wp-typia-project-tools/src/runtime/cli-add-workspace-admin-view-scaffold.ts
-import fs2 from "fs";
 import { promises as fsp3 } from "fs";
 import path5 from "path";
 
@@ -2085,26 +2146,31 @@ async function ensureAdminViewWebpackAnchors(workspace) {
     return nextSource;
   });
 }
-function resolveAdminViewRegistryPath(projectDir) {
+async function resolveAdminViewRegistryPath(projectDir) {
   const adminViewsDir = path5.join(projectDir, "src", "admin-views");
-  return [
+  for (const candidatePath of [
     path5.join(adminViewsDir, "index.ts"),
     path5.join(adminViewsDir, "index.js")
-  ].find((candidatePath) => fs2.existsSync(candidatePath)) ?? path5.join(adminViewsDir, "index.ts");
+  ]) {
+    if (await pathExists(candidatePath)) {
+      return candidatePath;
+    }
+  }
+  return path5.join(adminViewsDir, "index.ts");
 }
-function readAdminViewRegistrySlugs(registryPath) {
-  if (!fs2.existsSync(registryPath)) {
+async function readAdminViewRegistrySlugs(registryPath) {
+  const source = await readOptionalUtf8File(registryPath);
+  if (source === null) {
     return [];
   }
-  const source = fs2.readFileSync(registryPath, "utf8");
   return Array.from(source.matchAll(/^\s*import\s+['"]\.\/([^/'"]+)(?:\/index(?:\.[cm]?[jt]sx?)?)?['"];?\s*$/gmu)).map((match) => match[1]);
 }
 async function writeAdminViewRegistry(projectDir, adminViewSlug) {
   const adminViewsDir = path5.join(projectDir, "src", "admin-views");
-  const registryPath = resolveAdminViewRegistryPath(projectDir);
+  const registryPath = await resolveAdminViewRegistryPath(projectDir);
   await fsp3.mkdir(adminViewsDir, { recursive: true });
-  const existingAdminViewSlugs = readWorkspaceInventory(projectDir).adminViews.map((entry) => entry.slug);
-  const existingRegistrySlugs = readAdminViewRegistrySlugs(registryPath);
+  const existingAdminViewSlugs = (await readWorkspaceInventoryAsync(projectDir)).adminViews.map((entry) => entry.slug);
+  const existingRegistrySlugs = await readAdminViewRegistrySlugs(registryPath);
   const nextAdminViewSlugs = Array.from(new Set([
     ...existingAdminViewSlugs,
     ...existingRegistrySlugs,
@@ -2125,7 +2191,7 @@ async function scaffoldAdminViewWorkspace(options) {
   const buildScriptPath = path5.join(workspace.projectDir, "scripts", "build-workspace.mjs");
   const packageJsonPath = path5.join(workspace.projectDir, "package.json");
   const webpackConfigPath = path5.join(workspace.projectDir, "webpack.config.js");
-  const adminViewsIndexPath = resolveAdminViewRegistryPath(workspace.projectDir);
+  const adminViewsIndexPath = await resolveAdminViewRegistryPath(workspace.projectDir);
   const adminViewDir = path5.join(workspace.projectDir, "src", "admin-views", adminViewSlug);
   const adminViewPhpPath = path5.join(workspace.projectDir, "inc", "admin-views", `${adminViewSlug}.php`);
   await executeWorkspaceMutationPlan({
@@ -2173,7 +2239,7 @@ async function runAddAdminViewCommand({
   assertAdminViewPackageAvailability();
   const adminViewSlug = assertValidGeneratedSlug("Admin view name", normalizeBlockSlug(adminViewName), ADD_ADMIN_VIEW_USAGE);
   const parsedSource = parseAdminViewSource(source);
-  const inventory = readWorkspaceInventory(workspace.projectDir);
+  const inventory = await readWorkspaceInventoryAsync(workspace.projectDir);
   const restResource = resolveRestResourceSource(inventory.restResources, parsedSource);
   const coreDataSource = resolveAdminViewCoreDataSource(parsedSource);
   assertAdminViewDoesNotExist(workspace.projectDir, adminViewSlug, inventory);
@@ -2192,7 +2258,6 @@ async function runAddAdminViewCommand({
 }
 // ../wp-typia-project-tools/src/runtime/cli-add-workspace-assets.ts
 var import_typescript = __toESM(require_typescript(), 1);
-import fs3 from "fs";
 import { promises as fsp4 } from "fs";
 import path6 from "path";
 import {
@@ -2238,24 +2303,6 @@ function assertValidBindingAttributeName(attributeName) {
   }
   return trimmed;
 }
-function resolveBindingTargetBlockSlug(blockName, namespace) {
-  const trimmed = blockName.trim();
-  if (!trimmed) {
-    throw new Error("`wp-typia add binding-source` requires --block <block-slug|namespace/block-slug> to include a value when --attribute is provided.");
-  }
-  const blockNameSegments = trimmed.split("/");
-  if (blockNameSegments.length > 2) {
-    throw new Error(`Binding target block "${trimmed}" must use <block-slug> or <namespace/block-slug> format.`);
-  }
-  if (blockNameSegments.some((segment) => segment.trim() === "")) {
-    throw new Error(`Binding target block "${trimmed}" must use <block-slug> or <namespace/block-slug> format without empty path segments.`);
-  }
-  const [maybeNamespace, maybeSlug] = blockNameSegments.length === 2 ? blockNameSegments : [undefined, blockNameSegments[0]];
-  if (maybeNamespace && maybeNamespace !== namespace) {
-    throw new Error(`Binding target block "${trimmed}" uses namespace "${maybeNamespace}". Expected "${namespace}".`);
-  }
-  return normalizeBlockSlug(maybeSlug ?? "");
-}
 function buildEditorPluginConfigEntry(editorPluginSlug, slot) {
   return [
     "\t{",
@@ -2420,9 +2467,15 @@ function resolveBindingTarget(options, namespace) {
   if (!hasBlock || !hasAttribute) {
     throw new Error("`wp-typia add binding-source` requires --block and --attribute to be provided together.");
   }
+  const targetBlock = resolveWorkspaceBlockTargetName(blockName ?? "", namespace, {
+    empty: () => "`wp-typia add binding-source` requires --block <block-slug|namespace/block-slug> to include a value when --attribute is provided.",
+    emptySegment: (input) => `Binding target block "${input}" must use <block-slug> or <namespace/block-slug> format without empty path segments.`,
+    invalidFormat: (input) => `Binding target block "${input}" must use <block-slug> or <namespace/block-slug> format.`,
+    namespaceMismatch: (input, actualNamespace, expectedNamespace) => `Binding target block "${input}" uses namespace "${actualNamespace}". Expected "${expectedNamespace}".`
+  });
   return {
     attributeName: assertValidBindingAttributeName(attributeName ?? ""),
-    blockSlug: resolveBindingTargetBlockSlug(blockName ?? "", namespace)
+    blockSlug: targetBlock.blockSlug
   };
 }
 function formatBindingAttributeTypeMember(attributeName) {
@@ -2448,12 +2501,6 @@ function getInterfaceDeclaration(source, interfaceName) {
   visit(sourceFile);
   return declaration ? { declaration, sourceFile } : undefined;
 }
-function getPropertyNameText(name) {
-  if (import_typescript.default.isIdentifier(name) || import_typescript.default.isStringLiteral(name) || import_typescript.default.isNumericLiteral(name)) {
-    return name.text;
-  }
-  return;
-}
 function interfaceHasAttributeMember(declaration, attributeName) {
   return declaration.members.some((member) => import_typescript.default.isPropertySignature(member) && member.name !== undefined && getPropertyNameText(member.name) === attributeName);
 }
@@ -2930,38 +2977,51 @@ async function ensureEditorPluginWebpackAnchors(workspace) {
     return nextSource;
   });
 }
-function resolveBindingSourceRegistryPath(projectDir) {
+async function resolveBindingSourceRegistryPath(projectDir) {
   const bindingsDir = path6.join(projectDir, "src", "bindings");
-  return [path6.join(bindingsDir, "index.ts"), path6.join(bindingsDir, "index.js")].find((candidatePath) => fs3.existsSync(candidatePath)) ?? path6.join(bindingsDir, "index.ts");
+  for (const candidatePath of [
+    path6.join(bindingsDir, "index.ts"),
+    path6.join(bindingsDir, "index.js")
+  ]) {
+    if (await pathExists(candidatePath)) {
+      return candidatePath;
+    }
+  }
+  return path6.join(bindingsDir, "index.ts");
 }
 async function writeBindingSourceRegistry(projectDir, bindingSourceSlug) {
   const bindingsDir = path6.join(projectDir, "src", "bindings");
-  const bindingsIndexPath = resolveBindingSourceRegistryPath(projectDir);
+  const bindingsIndexPath = await resolveBindingSourceRegistryPath(projectDir);
   await fsp4.mkdir(bindingsDir, { recursive: true });
-  const existingBindingSourceSlugs = fs3.readdirSync(bindingsDir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+  const existingBindingSourceSlugs = (await fsp4.readdir(bindingsDir, { withFileTypes: true })).filter((entry) => entry.isDirectory()).map((entry) => entry.name);
   const nextBindingSourceSlugs = Array.from(new Set([...existingBindingSourceSlugs, bindingSourceSlug])).sort();
   await fsp4.writeFile(bindingsIndexPath, buildBindingSourceIndexSource(nextBindingSourceSlugs), "utf8");
 }
-function resolveEditorPluginRegistryPath(projectDir) {
+async function resolveEditorPluginRegistryPath(projectDir) {
   const editorPluginsDir = path6.join(projectDir, "src", "editor-plugins");
-  return [
+  for (const candidatePath of [
     path6.join(editorPluginsDir, "index.ts"),
     path6.join(editorPluginsDir, "index.js")
-  ].find((candidatePath) => fs3.existsSync(candidatePath)) ?? path6.join(editorPluginsDir, "index.ts");
+  ]) {
+    if (await pathExists(candidatePath)) {
+      return candidatePath;
+    }
+  }
+  return path6.join(editorPluginsDir, "index.ts");
 }
-function readEditorPluginRegistrySlugs(registryPath) {
-  if (!fs3.existsSync(registryPath)) {
+async function readEditorPluginRegistrySlugs(registryPath) {
+  const source = await readOptionalUtf8File(registryPath);
+  if (source === null) {
     return [];
   }
-  const source = fs3.readFileSync(registryPath, "utf8");
   return Array.from(source.matchAll(/^\s*import\s+['"]\.\/([^/'"]+)(?:\/index(?:\.[cm]?[jt]sx?)?)?['"];?\s*$/gmu)).map((match) => match[1]);
 }
 async function writeEditorPluginRegistry(projectDir, editorPluginSlug) {
   const editorPluginsDir = path6.join(projectDir, "src", "editor-plugins");
-  const registryPath = resolveEditorPluginRegistryPath(projectDir);
+  const registryPath = await resolveEditorPluginRegistryPath(projectDir);
   await fsp4.mkdir(editorPluginsDir, { recursive: true });
-  const existingEditorPluginSlugs = readWorkspaceInventory(projectDir).editorPlugins.map((entry) => entry.slug);
-  const existingRegistrySlugs = readEditorPluginRegistrySlugs(registryPath);
+  const existingEditorPluginSlugs = (await readWorkspaceInventoryAsync(projectDir)).editorPlugins.map((entry) => entry.slug);
+  const existingRegistrySlugs = await readEditorPluginRegistrySlugs(registryPath);
   const nextEditorPluginSlugs = Array.from(new Set([...existingEditorPluginSlugs, ...existingRegistrySlugs, editorPluginSlug])).sort();
   await fsp4.writeFile(registryPath, buildEditorPluginRegistrySource(nextEditorPluginSlugs), "utf8");
 }
@@ -2973,12 +3033,12 @@ async function runAddEditorPluginCommand({
   const workspace = resolveWorkspaceProject(cwd);
   const editorPluginSlug = assertValidGeneratedSlug("Editor plugin name", normalizeBlockSlug(editorPluginName), "wp-typia add editor-plugin <name> [--slot <sidebar|document-setting-panel>]");
   const resolvedSlot = assertValidEditorPluginSlot(slot);
-  const inventory = readWorkspaceInventory(workspace.projectDir);
+  const inventory = await readWorkspaceInventoryAsync(workspace.projectDir);
   assertEditorPluginDoesNotExist(workspace.projectDir, editorPluginSlug, inventory);
   const blockConfigPath = path6.join(workspace.projectDir, "scripts", "block-config.ts");
   const bootstrapPath = getWorkspaceBootstrapPath(workspace);
   const buildScriptPath = path6.join(workspace.projectDir, "scripts", "build-workspace.mjs");
-  const editorPluginsIndexPath = resolveEditorPluginRegistryPath(workspace.projectDir);
+  const editorPluginsIndexPath = await resolveEditorPluginRegistryPath(workspace.projectDir);
   const webpackConfigPath = path6.join(workspace.projectDir, "webpack.config.js");
   const editorPluginDir = path6.join(workspace.projectDir, "src", "editor-plugins", editorPluginSlug);
   const entryFilePath = path6.join(editorPluginDir, "index.tsx");
@@ -3029,7 +3089,7 @@ async function runAddPatternCommand({
 }) {
   const workspace = resolveWorkspaceProject(cwd);
   const patternSlug = assertValidGeneratedSlug("Pattern name", normalizeBlockSlug(patternName), "wp-typia add pattern <name>");
-  const inventory = readWorkspaceInventory(workspace.projectDir);
+  const inventory = await readWorkspaceInventoryAsync(workspace.projectDir);
   assertPatternDoesNotExist(workspace.projectDir, patternSlug, inventory);
   const blockConfigPath = path6.join(workspace.projectDir, "scripts", "block-config.ts");
   const bootstrapPath = getWorkspaceBootstrapPath(workspace);
@@ -3063,7 +3123,7 @@ async function runAddBindingSourceCommand({
 }) {
   const workspace = resolveWorkspaceProject(cwd);
   const bindingSourceSlug = assertValidGeneratedSlug("Binding source name", normalizeBlockSlug(bindingSourceName), "wp-typia add binding-source <name> [--block <block-slug|namespace/block-slug> --attribute <attribute>]");
-  const inventory = readWorkspaceInventory(workspace.projectDir);
+  const inventory = await readWorkspaceInventoryAsync(workspace.projectDir);
   assertBindingSourceDoesNotExist(workspace.projectDir, bindingSourceSlug, inventory);
   const target = resolveBindingTarget({
     attributeName,
@@ -3072,7 +3132,7 @@ async function runAddBindingSourceCommand({
   const targetBlock = target ? resolveWorkspaceBlock(inventory, target.blockSlug) : undefined;
   const blockConfigPath = path6.join(workspace.projectDir, "scripts", "block-config.ts");
   const bootstrapPath = getWorkspaceBootstrapPath(workspace);
-  const bindingsIndexPath = resolveBindingSourceRegistryPath(workspace.projectDir);
+  const bindingsIndexPath = await resolveBindingSourceRegistryPath(workspace.projectDir);
   const bindingSourceDir = path6.join(workspace.projectDir, "src", "bindings", bindingSourceSlug);
   const serverFilePath = path6.join(bindingSourceDir, "server.php");
   const editorFilePath = path6.join(bindingSourceDir, "editor.ts");
@@ -4257,7 +4317,7 @@ async function runAddRestResourceCommand({
   const restResourceSlug = assertValidGeneratedSlug("REST resource name", normalizeBlockSlug(restResourceName), "wp-typia add rest-resource <name> [--namespace <vendor/v1>] [--methods <list,read,create>]");
   const resolvedMethods = assertValidRestResourceMethods(methods);
   const resolvedNamespace = resolveRestResourceNamespace(workspace.workspace.namespace, namespace);
-  const inventory = readWorkspaceInventory(workspace.projectDir);
+  const inventory = await readWorkspaceInventoryAsync(workspace.projectDir);
   assertRestResourceDoesNotExist(workspace.projectDir, restResourceSlug, inventory);
   const blockConfigPath = path9.join(workspace.projectDir, "scripts", "block-config.ts");
   const bootstrapPath = getWorkspaceBootstrapPath(workspace);
@@ -4320,7 +4380,6 @@ async function runAddRestResourceCommand({
 }
 // ../wp-typia-project-tools/src/runtime/cli-add-workspace-ability-scaffold.ts
 var import_semver = __toESM(require_semver(), 1);
-import fs4 from "fs";
 import { promises as fsp6 } from "fs";
 import path10 from "path";
 import { syncTypeSchemas as syncTypeSchemas2 } from "@wp-typia/block-runtime/metadata-core";
@@ -4812,26 +4871,34 @@ function resolveManagedDependencyVersion(existingVersion, requiredVersion) {
   }
   return import_semver.default.gte(existingMinimum, requiredMinimum) ? existingVersion : requiredVersion;
 }
-function resolveAbilityRegistryPath(projectDir) {
+async function resolveAbilityRegistryPath(projectDir) {
   const abilitiesDir = path10.join(projectDir, "src", "abilities");
-  return [path10.join(abilitiesDir, "index.ts"), path10.join(abilitiesDir, "index.js")].find((candidatePath) => fs4.existsSync(candidatePath)) ?? path10.join(abilitiesDir, "index.ts");
+  for (const candidatePath of [
+    path10.join(abilitiesDir, "index.ts"),
+    path10.join(abilitiesDir, "index.js")
+  ]) {
+    if (await pathExists(candidatePath)) {
+      return candidatePath;
+    }
+  }
+  return path10.join(abilitiesDir, "index.ts");
 }
-function readAbilityRegistrySlugs(registryPath) {
-  if (!fs4.existsSync(registryPath)) {
+async function readAbilityRegistrySlugs(registryPath) {
+  const source = await readOptionalUtf8File(registryPath);
+  if (source === null) {
     return [];
   }
-  const source = fs4.readFileSync(registryPath, "utf8");
-  return Array.from(source.matchAll(/^\s*export\s+\*\s+from\s+['"]\.\/([^/'"]+)\/client['"];?\s*$/gmu)).map((match) => match[1]);
+  return Array.from(source.matchAll(/^\s*export\s+\*\s+from\s+['"]\.\/([^/'"]+)\/client(?:\.[cm]?[jt]sx?)?['"];?\s*$/gmu)).map((match) => match[1]);
 }
 async function writeAbilityRegistry(projectDir, abilitySlug) {
   const abilitiesDir = path10.join(projectDir, "src", "abilities");
-  const registryPath = resolveAbilityRegistryPath(projectDir);
+  const registryPath = await resolveAbilityRegistryPath(projectDir);
   await fsp6.mkdir(abilitiesDir, { recursive: true });
-  const existingAbilitySlugs = readWorkspaceInventory(projectDir).abilities.map((entry) => entry.slug);
-  const existingRegistrySlugs = readAbilityRegistrySlugs(registryPath);
+  const existingAbilitySlugs = (await readWorkspaceInventoryAsync(projectDir)).abilities.map((entry) => entry.slug);
+  const existingRegistrySlugs = await readAbilityRegistrySlugs(registryPath);
   const nextAbilitySlugs = Array.from(new Set([...existingAbilitySlugs, ...existingRegistrySlugs, abilitySlug])).sort();
   const generatedSection = buildAbilityRegistrySource(nextAbilitySlugs);
-  const existingSource = fs4.existsSync(registryPath) ? fs4.readFileSync(registryPath, "utf8") : "";
+  const existingSource = await readOptionalUtf8File(registryPath) ?? "";
   const generatedSectionPattern = new RegExp(`${escapeRegex(ABILITY_REGISTRY_START_MARKER)}[\\s\\S]*?${escapeRegex(ABILITY_REGISTRY_END_MARKER)}\\n?`, "u");
   const nextSource = existingSource ? generatedSectionPattern.test(existingSource) ? existingSource.replace(generatedSectionPattern, generatedSection) : `${existingSource.trimEnd()}
 
@@ -5100,7 +5167,7 @@ async function scaffoldAbilityWorkspace({
   const syncAbilitiesScriptPath = path10.join(workspace.projectDir, "scripts", "sync-abilities.ts");
   const syncProjectScriptPath = path10.join(workspace.projectDir, "scripts", "sync-project.ts");
   const webpackConfigPath = path10.join(workspace.projectDir, "webpack.config.js");
-  const abilitiesIndexPath = resolveAbilityRegistryPath(workspace.projectDir);
+  const abilitiesIndexPath = await resolveAbilityRegistryPath(workspace.projectDir);
   const abilityDir = path10.join(workspace.projectDir, "src", "abilities", abilitySlug);
   const configFilePath = path10.join(abilityDir, "ability.config.json");
   const typesFilePath = path10.join(abilityDir, "types.ts");
@@ -5171,7 +5238,7 @@ async function runAddAbilityCommand({
 }) {
   const workspace = resolveWorkspaceProject(cwd);
   const abilitySlug = assertValidGeneratedSlug("Ability name", normalizeBlockSlug(abilityName), "wp-typia add ability <name>");
-  const inventory = readWorkspaceInventory(workspace.projectDir);
+  const inventory = await readWorkspaceInventoryAsync(workspace.projectDir);
   assertAbilityDoesNotExist(workspace.projectDir, abilitySlug, inventory);
   const compatibilityPolicy = resolveScaffoldCompatibilityPolicy(REQUIRED_WORKSPACE_ABILITY_COMPATIBILITY);
   const scaffoldResult = await scaffoldAbilityWorkspace({
@@ -6713,7 +6780,7 @@ async function runAddAiFeatureCommand({
   const aiFeatureSlug = assertValidGeneratedSlug("AI feature name", normalizeBlockSlug(aiFeatureName), "wp-typia add ai-feature <name> [--namespace <vendor/v1>]");
   const resolvedNamespace = resolveRestResourceNamespace(workspace.workspace.namespace, namespace);
   const compatibilityPolicy = resolveScaffoldCompatibilityPolicy(OPTIONAL_WORDPRESS_AI_CLIENT_COMPATIBILITY);
-  const inventory = readWorkspaceInventory(workspace.projectDir);
+  const inventory = await readWorkspaceInventoryAsync(workspace.projectDir);
   assertAiFeatureDoesNotExist(workspace.projectDir, aiFeatureSlug, inventory);
   const scaffoldResult = await scaffoldAiFeatureWorkspace({
     aiFeatureSlug,
@@ -6743,7 +6810,6 @@ var BLOCK_TRANSFORMS_IMPORT_PATTERN = /^\s*import\s*\{\s*applyWorkspaceBlockTran
 var BLOCK_TRANSFORMS_CALL_LINE = "applyWorkspaceBlockTransforms(registration.settings);";
 var BLOCK_TRANSFORMS_CALL_PATTERN = /applyWorkspaceBlockTransforms\s*\(\s*registration\s*\.\s*settings\s*\)\s*;?/u;
 var SCAFFOLD_REGISTRATION_SETTINGS_CALL_PATTERN = /registerScaffoldBlockType\s*\(\s*registration\s*\.\s*name\s*,\s*registration\s*\.\s*settings\s*\)\s*;?/u;
-var FULL_BLOCK_NAME_PATTERN = /^[a-z0-9-]+\/[a-z0-9-]+$/u;
 function isIdentifierBoundary(source, index) {
   if (index < 0 || index >= source.length) {
     return true;
@@ -7136,35 +7202,6 @@ async function writeBlockTransformRegistry(projectDir, blockSlug, transformSlug)
   const nextTransformSlugs = Array.from(new Set([...existingTransformSlugs, transformSlug])).sort();
   await fsp9.writeFile(transformsIndexPath, buildBlockTransformIndexSource(nextTransformSlugs), "utf8");
 }
-function assertFullBlockName(blockName, flagName) {
-  const trimmed = blockName.trim();
-  if (!trimmed) {
-    throw new Error(`\`${flagName}\` requires a block name.`);
-  }
-  if (!FULL_BLOCK_NAME_PATTERN.test(trimmed)) {
-    throw new Error(`\`${flagName}\` must use <namespace/block-slug> format.`);
-  }
-  return trimmed;
-}
-function resolveWorkspaceTargetBlockName(blockName, namespace, flagName) {
-  const trimmed = blockName.trim();
-  if (!trimmed) {
-    throw new Error(`\`${flagName}\` requires <block-slug|namespace/block-slug>.`);
-  }
-  const blockNameSegments = trimmed.split("/");
-  if (blockNameSegments.length > 2 || blockNameSegments.some((segment) => segment.trim() === "")) {
-    throw new Error(`\`${flagName}\` must use <block-slug|namespace/block-slug> format.`);
-  }
-  const [maybeNamespace, maybeSlug] = blockNameSegments.length === 2 ? blockNameSegments : [undefined, blockNameSegments[0]];
-  if (maybeNamespace && maybeNamespace !== namespace) {
-    throw new Error(`\`${flagName}\` references namespace "${maybeNamespace}". Expected "${namespace}".`);
-  }
-  const blockSlug = normalizeBlockSlug(maybeSlug ?? "");
-  return {
-    blockName: `${namespace}/${blockSlug}`,
-    blockSlug
-  };
-}
 async function runAddVariationCommand({
   blockName,
   cwd = process.cwd(),
@@ -7173,7 +7210,7 @@ async function runAddVariationCommand({
   const workspace = resolveWorkspaceProject(cwd);
   const blockSlug = normalizeBlockSlug(blockName);
   const variationSlug = assertValidGeneratedSlug("Variation name", normalizeBlockSlug(variationName), "wp-typia add variation <name> --block <block-slug>");
-  const inventory = readWorkspaceInventory(workspace.projectDir);
+  const inventory = await readWorkspaceInventoryAsync(workspace.projectDir);
   resolveWorkspaceBlock(inventory, blockSlug);
   assertVariationDoesNotExist(workspace.projectDir, blockSlug, variationSlug, inventory);
   const blockConfigPath = path14.join(workspace.projectDir, "scripts", "block-config.ts");
@@ -7220,7 +7257,7 @@ async function runAddBlockStyleCommand({
   const workspace = resolveWorkspaceProject(cwd);
   const blockSlug = normalizeBlockSlug(blockName);
   const styleSlug = assertValidGeneratedSlug("Style name", normalizeBlockSlug(styleName), "wp-typia add style <name> --block <block-slug>");
-  const inventory = readWorkspaceInventory(workspace.projectDir);
+  const inventory = await readWorkspaceInventoryAsync(workspace.projectDir);
   resolveWorkspaceBlock(inventory, blockSlug);
   assertBlockStyleDoesNotExist(workspace.projectDir, blockSlug, styleSlug, inventory);
   const blockConfigPath = path14.join(workspace.projectDir, "scripts", "block-config.ts");
@@ -7269,7 +7306,7 @@ async function runAddBlockTransformCommand({
   const transformSlug = assertValidGeneratedSlug("Transform name", normalizeBlockSlug(transformName), "wp-typia add transform <name> --from <namespace/block> --to <block-slug|namespace/block-slug>");
   const resolvedFromBlockName = assertFullBlockName(fromBlockName, "--from");
   const target = resolveWorkspaceTargetBlockName(toBlockName, workspace.workspace.namespace, "--to");
-  const inventory = readWorkspaceInventory(workspace.projectDir);
+  const inventory = await readWorkspaceInventoryAsync(workspace.projectDir);
   resolveWorkspaceBlock(inventory, target.blockSlug);
   assertBlockTransformDoesNotExist(workspace.projectDir, target.blockSlug, transformSlug, inventory);
   const blockConfigPath = path14.join(workspace.projectDir, "scripts", "block-config.ts");
@@ -7329,7 +7366,7 @@ async function runAddHookedBlockCommand({
 }) {
   const workspace = resolveWorkspaceProject(cwd);
   const blockSlug = normalizeBlockSlug(blockName);
-  const inventory = readWorkspaceInventory(workspace.projectDir);
+  const inventory = await readWorkspaceInventoryAsync(workspace.projectDir);
   resolveWorkspaceBlock(inventory, blockSlug);
   const resolvedAnchorBlockName = assertValidHookAnchor(anchorBlockName);
   const resolvedPosition = assertValidHookedBlockPosition(position);
@@ -7363,6 +7400,7 @@ async function runAddHookedBlockCommand({
   }
 }
 export {
+  suggestAddBlockTemplateId,
   seedWorkspaceMigrationProject,
   runAddVariationCommand,
   runAddRestResourceCommand,
@@ -7377,6 +7415,7 @@ export {
   runAddAdminViewCommand,
   runAddAbilityCommand,
   isAddBlockTemplateId,
+  getWorkspaceBlockSelectOptionsAsync,
   getWorkspaceBlockSelectOptions,
   formatAddHelpText,
   EDITOR_PLUGIN_SLOT_IDS,
@@ -7384,4 +7423,4 @@ export {
   ADD_BLOCK_TEMPLATE_IDS
 };
 
-//# debugId=DA912BE06859998764756E2164756E21
+//# debugId=31F5DCD7996BF38964756E2164756E21

package/dist-bunli/{cli-27v2qpjg.js → cli-ag722tzm.js}

@@ -51,7 +51,7 @@ import {
 } from "./cli-bq2v559b.js";
 import {
   readWorkspaceInventory
-} from "./cli-ta3y0hp2.js";
+} from "./cli-regw5384.js";
 import {
   getInvalidWorkspaceProjectReason,
   tryResolveWorkspaceProject