wp-typia 0.22.4 → 0.22.6

package/dist-bunli/{cli-add-6s6kzf7x.js → cli-add-5vmxpgmn.js}

@@ -11,6 +11,7 @@ import {
   parseAlternateRenderTargets,
   parseCompoundInnerBlocksPreset,
   parseTemplateLocator,
+  pathExists,
   renderScaffoldCompatibilityConfig,
   require_semver,
   resolveExternalTemplateLayers,
@@ -21,7 +22,7 @@ import {
   scaffoldProject,
   syncPersistenceRestArtifacts,
   updatePluginHeaderCompatibility
-} from "./cli-6ymn63t4.js";
+} from "./cli-6a65qfb1.js";
 import {
   DEFAULT_WORDPRESS_ABILITIES_VERSION,
   DEFAULT_WORDPRESS_CORE_ABILITIES_VERSION,
@@ -34,13 +35,13 @@ import {
 } from "./cli-1sm60g1z.js";
 import {
   snapshotProjectVersion
-} from "./cli-2mt6bvcj.js";
+} from "./cli-0q0tz4dq.js";
 import {
   ensureMigrationDirectories,
   parseMigrationConfig,
   writeInitialMigrationScaffold,
   writeMigrationConfig
-} from "./cli-hb9vpsev.js";
+} from "./cli-2rqf6t0b.js";
 import"./cli-bq2v559b.js";
 import {
   findExecutablePatternMatch,
@@ -54,7 +55,6 @@ import {
 } from "./cli-tke8twkn.js";
 import {
   ADD_BLOCK_TEMPLATE_IDS,
-  ADD_KIND_IDS,
   EDITOR_PLUGIN_SLOT_IDS,
   appendWorkspaceInventoryEntries,
   assertAbilityDoesNotExist,
@@ -79,6 +79,7 @@ import {
   getMutableBlockHooks,
   getWorkspaceBlockSelectOptions,
   getWorkspaceBootstrapPath,
+  hasPhpFunctionCall,
   hasPhpFunctionDefinition,
   isAddBlockTemplateId,
   normalizeBlockSlug,
@@ -100,26 +101,25 @@ import {
   toPascalCase,
   toSnakeCase,
   toTitleCase
-} from "./cli-qr2ek735.js";
+} from "./cli-5kn2p7ee.js";
 import {
   createManagedTempRoot
 } from "./cli-t73q5aqz.js";
 import {
-  CLI_DIAGNOSTIC_CODES,
-  createCliDiagnosticCodeError
-} from "./cli-p95wr1q8.js";
+  ADD_KIND_IDS
+} from "./cli-fys8vm2t.js";
+import"./cli-p95wr1q8.js";
 import {
   resolveWorkspaceProject
-} from "./cli-btbpt84c.js";
+} from "./cli-hhp1d348.js";
 import {
   formatInstallCommand
-} from "./cli-6bhfzq5e.js";
+} from "./cli-52ke0ptp.js";
 import {
   __reExport,
   __toESM
 } from "./cli-xnn9xjcy.js";
 // ../wp-typia-project-tools/src/runtime/cli-add-block.ts
-import fs2 from "fs";
 import { promises as fsp2 } from "fs";
 import path3 from "path";
 import {
@@ -485,11 +485,16 @@ async function renderWorkspacePersistenceServerModule(projectDir, variables) {
   const templateDir = buildServerTemplateRoot(variables.persistencePolicy);
   await copyInterpolatedDirectory(templateDir, targetDir, variables);
 }
-function hasInstalledWorkspaceDependencies(projectDir) {
-  return WORKSPACE_INSTALL_MARKERS.some((marker) => fs2.existsSync(path3.join(projectDir, marker)));
+async function hasInstalledWorkspaceDependencies(projectDir) {
+  for (const marker of WORKSPACE_INSTALL_MARKERS) {
+    if (await pathExists(path3.join(projectDir, marker))) {
+      return true;
+    }
+  }
+  return false;
 }
-function assertWorkspaceDependenciesInstalled(workspace) {
-  if (hasInstalledWorkspaceDependencies(workspace.projectDir)) {
+async function assertWorkspaceDependenciesInstalled(workspace) {
+  if (await hasInstalledWorkspaceDependencies(workspace.projectDir)) {
     return;
   }
   throw new Error(`Workspace dependencies have not been installed yet. Run \`${formatInstallCommand(workspace.packageManager)}\` from the workspace root before using \`wp-typia add block ...\`.`);
@@ -561,19 +566,19 @@ function collectWorkspaceBlockPaths(projectDir, templateId, variables) {
   }
   return [path3.join(projectDir, "src", "blocks", variables.slugKebabCase)];
 }
-function assertBlockTargetsDoNotExist(projectDir, templateId, variables) {
+async function assertBlockTargetsDoNotExist(projectDir, templateId, variables) {
   for (const targetPath of collectWorkspaceBlockPaths(projectDir, templateId, variables)) {
-    if (fs2.existsSync(targetPath)) {
+    if (await pathExists(targetPath)) {
       throw new Error(`A block already exists at ${path3.relative(projectDir, targetPath)}. Choose a different name.`);
     }
   }
 }
 async function updateWorkspaceMigrationConfigIfPresent(projectDir, newBlocks) {
   const configPath = path3.join(projectDir, "src", "migrations", "config.ts");
-  if (!fs2.existsSync(configPath)) {
+  const configSource = await readOptionalFile(configPath);
+  if (configSource === null) {
     return;
   }
-  const configSource = await fsp2.readFile(configPath, "utf8");
   const config = parseMigrationConfig(configSource);
   const existingBlocks = Array.isArray(config.blocks) ? config.blocks : [];
   const nextBlocks = [
@@ -682,7 +687,7 @@ async function runAddBlockCommand({
   assertCompoundInnerBlocksPresetAllowed(resolvedTemplateId, innerBlocksPreset);
   const resolvedInnerBlocksPreset = parseCompoundInnerBlocksPreset(innerBlocksPreset);
   const workspace = resolveWorkspaceProject(cwd);
-  assertWorkspaceDependenciesInstalled(workspace);
+  await assertWorkspaceDependenciesInstalled(workspace);
   const normalizedExternalLayerId = normalizeOptionalCliString(externalLayerId);
   const normalizedExternalLayerSource = resolveLocalCliPathOption({
     cwd,
@@ -753,7 +758,7 @@ async function runAddBlockCommand({
       });
       return scaffoldResult;
     })();
-    assertBlockTargetsDoNotExist(workspace.projectDir, resolvedTemplateId, result.variables);
+    await assertBlockTargetsDoNotExist(workspace.projectDir, resolvedTemplateId, result.variables);
     const mutationSnapshot = {
       fileSources: await snapshotWorkspaceFiles([
         blockConfigPath,
@@ -789,7 +794,7 @@ async function runAddBlockCommand({
   }
 }
 // ../wp-typia-project-tools/src/runtime/cli-add-workspace.ts
-import fs6 from "fs";
+import fs5 from "fs";
 import { promises as fsp9 } from "fs";
 import path14 from "path";
 
@@ -808,8 +813,6 @@ var ADMIN_VIEWS_ASSET = "build/admin-views/index.asset.php";
 var ADMIN_VIEWS_STYLE = "build/admin-views/style-index.css";
 var ADMIN_VIEWS_STYLE_RTL = "build/admin-views/style-index-rtl.css";
 var ADMIN_VIEWS_PHP_GLOB = "/inc/admin-views/*.php";
-var ADMIN_VIEW_ALLOW_UNPUBLISHED_DATAVIEWS_ENV = "WP_TYPIA_ALLOW_UNPUBLISHED_DATAVIEWS";
-var ADMIN_VIEW_PUBLIC_INSTALLS_ENABLED = false;
 function isAdminViewCoreDataSource(source) {
   return source?.kind === ADMIN_VIEW_CORE_DATA_SOURCE_KIND;
 }
@@ -824,14 +827,8 @@ function formatAdminViewSourceLocator(source) {
 }
 
 // ../wp-typia-project-tools/src/runtime/cli-add-workspace-admin-view-source.ts
-function isAdminViewUnpublishedDataViewsOverrideEnabled() {
-  return process.env[ADMIN_VIEW_ALLOW_UNPUBLISHED_DATAVIEWS_ENV]?.trim() === "1";
-}
 function assertAdminViewPackageAvailability() {
-  if (isAdminViewUnpublishedDataViewsOverrideEnabled() || ADMIN_VIEW_PUBLIC_INSTALLS_ENABLED) {
-    return;
-  }
-  throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.INVALID_ARGUMENT, "`wp-typia add admin-view` is temporarily unavailable because `@wp-typia/dataviews` is not published to npm for public installs yet.");
+  return;
 }
 function assertValidCoreDataEntitySegment(label, value) {
   const trimmed = value.trim();
@@ -908,7 +905,7 @@ function resolveAdminViewCoreDataSource(source) {
 }
 
 // ../wp-typia-project-tools/src/runtime/cli-add-workspace-admin-view-scaffold.ts
-import fs3 from "fs";
+import fs2 from "fs";
 import { promises as fsp3 } from "fs";
 import path5 from "path";
 
@@ -2094,13 +2091,13 @@ function resolveAdminViewRegistryPath(projectDir) {
   return [
     path5.join(adminViewsDir, "index.ts"),
     path5.join(adminViewsDir, "index.js")
-  ].find((candidatePath) => fs3.existsSync(candidatePath)) ?? path5.join(adminViewsDir, "index.ts");
+  ].find((candidatePath) => fs2.existsSync(candidatePath)) ?? path5.join(adminViewsDir, "index.ts");
 }
 function readAdminViewRegistrySlugs(registryPath) {
-  if (!fs3.existsSync(registryPath)) {
+  if (!fs2.existsSync(registryPath)) {
     return [];
   }
-  const source = fs3.readFileSync(registryPath, "utf8");
+  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) {
@@ -2196,7 +2193,7 @@ async function runAddAdminViewCommand({
 }
 // ../wp-typia-project-tools/src/runtime/cli-add-workspace-assets.ts
 var import_typescript = __toESM(require_typescript(), 1);
-import fs4 from "fs";
+import fs3 from "fs";
 import { promises as fsp4 } from "fs";
 import path6 from "path";
 import {
@@ -2794,45 +2791,17 @@ function ${bindingEditorEnqueueFunctionName}() {
 	);
 }
 `;
-    const insertionAnchors = [
-      /add_action\(\s*["']init["']\s*,\s*["'][^"']+_load_textdomain["']\s*\);\s*\n/u,
-      /\?>\s*$/u
-    ];
-    const insertPhpSnippet = (snippet) => {
-      for (const anchor of insertionAnchors) {
-        const candidate = nextSource.replace(anchor, (match) => `${snippet}
-${match}`);
-        if (candidate !== nextSource) {
-          nextSource = candidate;
-          return;
-        }
-      }
-      nextSource = `${nextSource.trimEnd()}
-${snippet}
-`;
-    };
-    const appendPhpSnippet = (snippet) => {
-      const closingTagPattern = /\?>\s*$/u;
-      if (closingTagPattern.test(nextSource)) {
-        nextSource = nextSource.replace(closingTagPattern, `${snippet}
-?>`);
-        return;
-      }
-      nextSource = `${nextSource.trimEnd()}
-${snippet}
-`;
-    };
     if (!hasPhpFunctionDefinition(nextSource, bindingRegistrationFunctionName)) {
-      insertPhpSnippet(bindingRegistrationFunction);
+      nextSource = insertPhpSnippetBeforeWorkspaceAnchors(nextSource, bindingRegistrationFunction);
     }
     if (!hasPhpFunctionDefinition(nextSource, bindingEditorEnqueueFunctionName)) {
-      insertPhpSnippet(bindingEditorEnqueueFunction);
+      nextSource = insertPhpSnippetBeforeWorkspaceAnchors(nextSource, bindingEditorEnqueueFunction);
     }
     if (!nextSource.includes(bindingRegistrationHook)) {
-      appendPhpSnippet(bindingRegistrationHook);
+      nextSource = appendPhpSnippetBeforeClosingTag(nextSource, bindingRegistrationHook);
     }
     if (!nextSource.includes(bindingEditorEnqueueHook)) {
-      appendPhpSnippet(bindingEditorEnqueueHook);
+      nextSource = appendPhpSnippetBeforeClosingTag(nextSource, bindingEditorEnqueueHook);
     }
     return nextSource;
   });
@@ -2882,36 +2851,8 @@ function ${enqueueFunctionName}() {
 	}
 }
 `;
-    const insertionAnchors = [
-      /add_action\(\s*["']init["']\s*,\s*["'][^"']+_load_textdomain["']\s*\);\s*\n/u,
-      /\?>\s*$/u
-    ];
-    const insertPhpSnippet = (snippet) => {
-      for (const anchor of insertionAnchors) {
-        const candidate = nextSource.replace(anchor, (match) => `${snippet}
-${match}`);
-        if (candidate !== nextSource) {
-          nextSource = candidate;
-          return;
-        }
-      }
-      nextSource = `${nextSource.trimEnd()}
-${snippet}
-`;
-    };
-    const appendPhpSnippet = (snippet) => {
-      const closingTagPattern = /\?>\s*$/u;
-      if (closingTagPattern.test(nextSource)) {
-        nextSource = nextSource.replace(closingTagPattern, `${snippet}
-?>`);
-        return;
-      }
-      nextSource = `${nextSource.trimEnd()}
-${snippet}
-`;
-    };
     if (!hasPhpFunctionDefinition(nextSource, enqueueFunctionName)) {
-      insertPhpSnippet(enqueueFunction);
+      nextSource = insertPhpSnippetBeforeWorkspaceAnchors(nextSource, enqueueFunction);
     } else {
       const requiredReferences = [
         EDITOR_PLUGIN_EDITOR_SCRIPT,
@@ -2932,7 +2873,7 @@ ${snippet}
       }
     }
     if (!nextSource.includes(enqueueHook)) {
-      appendPhpSnippet(enqueueHook);
+      nextSource = appendPhpSnippetBeforeClosingTag(nextSource, enqueueHook);
     }
     return nextSource;
   });
@@ -2992,13 +2933,13 @@ async function ensureEditorPluginWebpackAnchors(workspace) {
 }
 function resolveBindingSourceRegistryPath(projectDir) {
   const bindingsDir = path6.join(projectDir, "src", "bindings");
-  return [path6.join(bindingsDir, "index.ts"), path6.join(bindingsDir, "index.js")].find((candidatePath) => fs4.existsSync(candidatePath)) ?? path6.join(bindingsDir, "index.ts");
+  return [path6.join(bindingsDir, "index.ts"), path6.join(bindingsDir, "index.js")].find((candidatePath) => fs3.existsSync(candidatePath)) ?? path6.join(bindingsDir, "index.ts");
 }
 async function writeBindingSourceRegistry(projectDir, bindingSourceSlug) {
   const bindingsDir = path6.join(projectDir, "src", "bindings");
   const bindingsIndexPath = resolveBindingSourceRegistryPath(projectDir);
   await fsp4.mkdir(bindingsDir, { recursive: true });
-  const existingBindingSourceSlugs = fs4.readdirSync(bindingsDir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+  const existingBindingSourceSlugs = fs3.readdirSync(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");
 }
@@ -3007,13 +2948,13 @@ function resolveEditorPluginRegistryPath(projectDir) {
   return [
     path6.join(editorPluginsDir, "index.ts"),
     path6.join(editorPluginsDir, "index.js")
-  ].find((candidatePath) => fs4.existsSync(candidatePath)) ?? path6.join(editorPluginsDir, "index.ts");
+  ].find((candidatePath) => fs3.existsSync(candidatePath)) ?? path6.join(editorPluginsDir, "index.ts");
 }
 function readEditorPluginRegistrySlugs(registryPath) {
-  if (!fs4.existsSync(registryPath)) {
+  if (!fs3.existsSync(registryPath)) {
     return [];
   }
-  const source = fs4.readFileSync(registryPath, "utf8");
+  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) {
@@ -3198,36 +3139,8 @@ function ${registerFunctionName}() {
 	}
 }
 `;
-    const insertionAnchors = [
-      /add_action\(\s*["']init["']\s*,\s*["'][^"']+_load_textdomain["']\s*\);\s*\n/u,
-      /\?>\s*$/u
-    ];
-    const insertPhpSnippet = (snippet) => {
-      for (const anchor of insertionAnchors) {
-        const candidate = nextSource.replace(anchor, (match) => `${snippet}
-${match}`);
-        if (candidate !== nextSource) {
-          nextSource = candidate;
-          return;
-        }
-      }
-      nextSource = `${nextSource.trimEnd()}
-${snippet}
-`;
-    };
-    const appendPhpSnippet = (snippet) => {
-      const closingTagPattern = /\?>\s*$/u;
-      if (closingTagPattern.test(nextSource)) {
-        nextSource = nextSource.replace(closingTagPattern, `${snippet}
-?>`);
-        return;
-      }
-      nextSource = `${nextSource.trimEnd()}
-${snippet}
-`;
-    };
     if (!hasPhpFunctionDefinition(nextSource, registerFunctionName)) {
-      insertPhpSnippet(registerFunction);
+      nextSource = insertPhpSnippetBeforeWorkspaceAnchors(nextSource, registerFunction);
     } else if (!nextSource.includes(REST_RESOURCE_SERVER_GLOB)) {
       throw new Error([
         `Unable to patch ${path7.basename(bootstrapPath)} in ensureRestResourceBootstrapAnchors.`,
@@ -3236,7 +3149,7 @@ ${snippet}
       ].join(" "));
     }
     if (!nextSource.includes(registerHook)) {
-      appendPhpSnippet(registerHook);
+      nextSource = appendPhpSnippetBeforeClosingTag(nextSource, registerHook);
     }
     return nextSource;
   });
@@ -4408,7 +4321,7 @@ async function runAddRestResourceCommand({
 }
 // ../wp-typia-project-tools/src/runtime/cli-add-workspace-ability-scaffold.ts
 var import_semver = __toESM(require_semver(), 1);
-import fs5 from "fs";
+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";
@@ -4902,13 +4815,13 @@ function resolveManagedDependencyVersion(existingVersion, requiredVersion) {
 }
 function resolveAbilityRegistryPath(projectDir) {
   const abilitiesDir = path10.join(projectDir, "src", "abilities");
-  return [path10.join(abilitiesDir, "index.ts"), path10.join(abilitiesDir, "index.js")].find((candidatePath) => fs5.existsSync(candidatePath)) ?? path10.join(abilitiesDir, "index.ts");
+  return [path10.join(abilitiesDir, "index.ts"), path10.join(abilitiesDir, "index.js")].find((candidatePath) => fs4.existsSync(candidatePath)) ?? path10.join(abilitiesDir, "index.ts");
 }
 function readAbilityRegistrySlugs(registryPath) {
-  if (!fs5.existsSync(registryPath)) {
+  if (!fs4.existsSync(registryPath)) {
     return [];
   }
-  const source = fs5.readFileSync(registryPath, "utf8");
+  const source = fs4.readFileSync(registryPath, "utf8");
   return Array.from(source.matchAll(/^\s*export\s+\*\s+from\s+['"]\.\/([^/'"]+)\/client['"];?\s*$/gmu)).map((match) => match[1]);
 }
 async function writeAbilityRegistry(projectDir, abilitySlug) {
@@ -4919,7 +4832,7 @@ async function writeAbilityRegistry(projectDir, abilitySlug) {
   const existingRegistrySlugs = readAbilityRegistrySlugs(registryPath);
   const nextAbilitySlugs = Array.from(new Set([...existingAbilitySlugs, ...existingRegistrySlugs, abilitySlug])).sort();
   const generatedSection = buildAbilityRegistrySource(nextAbilitySlugs);
-  const existingSource = fs5.existsSync(registryPath) ? fs5.readFileSync(registryPath, "utf8") : "";
+  const existingSource = fs4.existsSync(registryPath) ? fs4.readFileSync(registryPath, "utf8") : "";
   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()}
 
@@ -5000,8 +4913,16 @@ function ${enqueueFunctionName}() {
     }
     if (!hasPhpFunctionDefinition(nextSource, enqueueFunctionName)) {
       nextSource = insertPhpSnippetBeforeWorkspaceAnchors(nextSource, enqueueFunction);
-    } else if (!findPhpFunctionRange(nextSource, enqueueFunctionName)?.source.includes("wp_enqueue_script_module")) {
-      nextSource = replacePhpFunctionDefinition(nextSource, enqueueFunctionName, enqueueFunction, { trimReplacementStart: true }) ?? nextSource;
+    } else {
+      const functionRange = findPhpFunctionRange(nextSource, enqueueFunctionName);
+      const functionSource = functionRange ? nextSource.slice(functionRange.start, functionRange.end) : "";
+      if (!hasPhpFunctionCall(functionSource, "wp_enqueue_script_module")) {
+        const replacedSource = replacePhpFunctionDefinition(nextSource, enqueueFunctionName, enqueueFunction, { trimReplacementStart: true });
+        if (!replacedSource) {
+          throw new Error(`Unable to repair ${path10.basename(bootstrapPath)} for ${enqueueFunctionName}.`);
+        }
+        nextSource = replacedSource;
+      }
     }
     if (!nextSource.includes(loadHook)) {
       nextSource = appendPhpSnippetBeforeClosingTag(nextSource, loadHook);
@@ -5172,6 +5093,7 @@ async function scaffoldAbilityWorkspace({
   compatibilityPolicy,
   workspace
 }) {
+  const compatibilityWarnings = [];
   const blockConfigPath = path10.join(workspace.projectDir, "scripts", "block-config.ts");
   const bootstrapPath = getWorkspaceBootstrapPath(workspace);
   const buildScriptPath = path10.join(workspace.projectDir, "scripts", "build-workspace.mjs");
@@ -5202,7 +5124,11 @@ async function scaffoldAbilityWorkspace({
       await fsp6.mkdir(abilityDir, { recursive: true });
       await fsp6.mkdir(path10.dirname(phpFilePath), { recursive: true });
       await ensureAbilityBootstrapAnchors(workspace);
-      await patchFile(bootstrapPath, (source) => updatePluginHeaderCompatibility(source, compatibilityPolicy));
+      await patchFile(bootstrapPath, (source) => updatePluginHeaderCompatibility(source, compatibilityPolicy, {
+        onWarning: (warning) => {
+          compatibilityWarnings.push(warning);
+        }
+      }));
       await ensureAbilityPackageScripts(workspace);
       await ensureAbilitySyncProjectAnchors(workspace);
       await ensureAbilityBuildScriptAnchors(workspace);
@@ -5234,6 +5160,9 @@ async function scaffoldAbilityWorkspace({
       });
     }
   });
+  return {
+    warnings: compatibilityWarnings
+  };
 }
 
 // ../wp-typia-project-tools/src/runtime/cli-add-workspace-ability.ts
@@ -5246,14 +5175,15 @@ async function runAddAbilityCommand({
   const inventory = readWorkspaceInventory(workspace.projectDir);
   assertAbilityDoesNotExist(workspace.projectDir, abilitySlug, inventory);
   const compatibilityPolicy = resolveScaffoldCompatibilityPolicy(REQUIRED_WORKSPACE_ABILITY_COMPATIBILITY);
-  await scaffoldAbilityWorkspace({
+  const scaffoldResult = await scaffoldAbilityWorkspace({
     abilitySlug,
     compatibilityPolicy,
     workspace
   });
   return {
     abilitySlug,
-    projectDir: workspace.projectDir
+    projectDir: workspace.projectDir,
+    warnings: scaffoldResult.warnings
   };
 }
 // ../wp-typia-project-tools/src/runtime/cli-add-workspace-ai-scaffold.ts
@@ -5857,36 +5787,8 @@ function ${registerFunctionName}() {
 	}
 }
 `;
-    const insertionAnchors = [
-      /add_action\(\s*["']init["']\s*,\s*["'][^"']+_load_textdomain["']\s*\);\s*\n/u,
-      /\?>\s*$/u
-    ];
-    const insertPhpSnippet = (snippet) => {
-      for (const anchor of insertionAnchors) {
-        const candidate = nextSource.replace(anchor, (match) => `${snippet}
-${match}`);
-        if (candidate !== nextSource) {
-          nextSource = candidate;
-          return;
-        }
-      }
-      nextSource = `${nextSource.trimEnd()}
-${snippet}
-`;
-    };
-    const appendPhpSnippet = (snippet) => {
-      const closingTagPattern = /\?>\s*$/u;
-      if (closingTagPattern.test(nextSource)) {
-        nextSource = nextSource.replace(closingTagPattern, `${snippet}
-?>`);
-        return;
-      }
-      nextSource = `${nextSource.trimEnd()}
-${snippet}
-`;
-    };
     if (!hasPhpFunctionDefinition(nextSource, registerFunctionName)) {
-      insertPhpSnippet(registerFunction);
+      nextSource = insertPhpSnippetBeforeWorkspaceAnchors(nextSource, registerFunction);
     } else if (!nextSource.includes(AI_FEATURE_SERVER_GLOB)) {
       throw new Error([
         `Unable to patch ${path12.basename(bootstrapPath)} in ensureAiFeatureBootstrapAnchors.`,
@@ -5895,7 +5797,7 @@ ${snippet}
       ].join(" "));
     }
     if (!nextSource.includes(registerHook)) {
-      appendPhpSnippet(registerHook);
+      nextSource = appendPhpSnippetBeforeClosingTag(nextSource, registerHook);
     }
     return nextSource;
   });
@@ -6724,6 +6626,7 @@ async function scaffoldAiFeatureWorkspace({
   namespace,
   workspace
 }) {
+  const compatibilityWarnings = [];
   const blockConfigPath = path13.join(workspace.projectDir, "scripts", "block-config.ts");
   const bootstrapPath = getWorkspaceBootstrapPath(workspace);
   const packageJsonPath = path13.join(workspace.projectDir, "package.json");
@@ -6750,7 +6653,11 @@ async function scaffoldAiFeatureWorkspace({
       await fsp8.mkdir(aiFeatureDir, { recursive: true });
       await fsp8.mkdir(path13.dirname(phpFilePath), { recursive: true });
       await ensureAiFeatureBootstrapAnchors(workspace);
-      await patchFile(bootstrapPath, (source) => updatePluginHeaderCompatibility(source, compatibilityPolicy));
+      await patchFile(bootstrapPath, (source) => updatePluginHeaderCompatibility(source, compatibilityPolicy, {
+        onWarning: (warning) => {
+          compatibilityWarnings.push(warning);
+        }
+      }));
       const packageScriptChanges = await ensureAiFeaturePackageScripts(workspace);
       await ensureAiFeatureSyncProjectAnchors(workspace);
       await ensureAiFeatureSyncRestAnchors(workspace);
@@ -6786,9 +6693,12 @@ async function scaffoldAiFeatureWorkspace({
         transformSource: ensureBlockConfigCanAddRestManifests
       });
       return {
-        warnings: packageScriptChanges.addedProjectToolsDependency ? [
-          "Added `@wp-typia/project-tools` to devDependencies for `sync-ai`. If this workspace was already installed, rerun your package manager install command before the first `wp-typia sync ai`."
-        ] : []
+        warnings: [
+          ...compatibilityWarnings,
+          ...packageScriptChanges.addedProjectToolsDependency ? [
+            "Added `@wp-typia/project-tools` to devDependencies for `sync-ai`. If this workspace was already installed, rerun your package manager install command before the first `wp-typia sync ai`."
+          ] : []
+        ]
       };
     }
   });
@@ -7207,7 +7117,7 @@ async function writeVariationRegistry(projectDir, blockSlug, variationSlug) {
   const variationsDir = path14.join(projectDir, "src", "blocks", blockSlug, "variations");
   const variationsIndexPath = path14.join(variationsDir, "index.ts");
   await fsp9.mkdir(variationsDir, { recursive: true });
-  const existingVariationSlugs = fs6.readdirSync(variationsDir).filter((entry) => entry.endsWith(".ts") && entry !== "index.ts").map((entry) => entry.replace(/\.ts$/u, ""));
+  const existingVariationSlugs = fs5.readdirSync(variationsDir).filter((entry) => entry.endsWith(".ts") && entry !== "index.ts").map((entry) => entry.replace(/\.ts$/u, ""));
   const nextVariationSlugs = Array.from(new Set([...existingVariationSlugs, variationSlug])).sort();
   await fsp9.writeFile(variationsIndexPath, buildVariationIndexSource(nextVariationSlugs), "utf8");
 }
@@ -7215,7 +7125,7 @@ async function writeBlockStyleRegistry(projectDir, blockSlug, styleSlug) {
   const stylesDir = path14.join(projectDir, "src", "blocks", blockSlug, "styles");
   const stylesIndexPath = path14.join(stylesDir, "index.ts");
   await fsp9.mkdir(stylesDir, { recursive: true });
-  const existingStyleSlugs = fs6.readdirSync(stylesDir).filter((entry) => entry.endsWith(".ts") && entry !== "index.ts").map((entry) => entry.replace(/\.ts$/u, ""));
+  const existingStyleSlugs = fs5.readdirSync(stylesDir).filter((entry) => entry.endsWith(".ts") && entry !== "index.ts").map((entry) => entry.replace(/\.ts$/u, ""));
   const nextStyleSlugs = Array.from(new Set([...existingStyleSlugs, styleSlug])).sort();
   await fsp9.writeFile(stylesIndexPath, buildBlockStyleIndexSource(nextStyleSlugs), "utf8");
 }
@@ -7223,7 +7133,7 @@ async function writeBlockTransformRegistry(projectDir, blockSlug, transformSlug)
   const transformsDir = path14.join(projectDir, "src", "blocks", blockSlug, "transforms");
   const transformsIndexPath = path14.join(transformsDir, "index.ts");
   await fsp9.mkdir(transformsDir, { recursive: true });
-  const existingTransformSlugs = fs6.readdirSync(transformsDir).filter((entry) => entry.endsWith(".ts") && entry !== "index.ts").map((entry) => entry.replace(/\.ts$/u, ""));
+  const existingTransformSlugs = fs5.readdirSync(transformsDir).filter((entry) => entry.endsWith(".ts") && entry !== "index.ts").map((entry) => entry.replace(/\.ts$/u, ""));
   const nextTransformSlugs = Array.from(new Set([...existingTransformSlugs, transformSlug])).sort();
   await fsp9.writeFile(transformsIndexPath, buildBlockTransformIndexSource(nextTransformSlugs), "utf8");
 }
@@ -7272,7 +7182,7 @@ async function runAddVariationCommand({
   const variationsDir = path14.join(workspace.projectDir, "src", "blocks", blockSlug, "variations");
   const variationFilePath = path14.join(variationsDir, `${variationSlug}.ts`);
   const variationsIndexPath = path14.join(variationsDir, "index.ts");
-  const shouldRemoveVariationsDirOnRollback = !fs6.existsSync(variationsDir);
+  const shouldRemoveVariationsDirOnRollback = !fs5.existsSync(variationsDir);
   const mutationSnapshot = {
     fileSources: await snapshotWorkspaceFiles([
       blockConfigPath,
@@ -7319,7 +7229,7 @@ async function runAddBlockStyleCommand({
   const stylesDir = path14.join(workspace.projectDir, "src", "blocks", blockSlug, "styles");
   const styleFilePath = path14.join(stylesDir, `${styleSlug}.ts`);
   const stylesIndexPath = path14.join(stylesDir, "index.ts");
-  const shouldRemoveStylesDirOnRollback = !fs6.existsSync(stylesDir);
+  const shouldRemoveStylesDirOnRollback = !fs5.existsSync(stylesDir);
   const mutationSnapshot = {
     fileSources: await snapshotWorkspaceFiles([
       blockConfigPath,
@@ -7368,7 +7278,7 @@ async function runAddBlockTransformCommand({
   const transformsDir = path14.join(workspace.projectDir, "src", "blocks", target.blockSlug, "transforms");
   const transformFilePath = path14.join(transformsDir, `${transformSlug}.ts`);
   const transformsIndexPath = path14.join(transformsDir, "index.ts");
-  const shouldRemoveTransformsDirOnRollback = !fs6.existsSync(transformsDir);
+  const shouldRemoveTransformsDirOnRollback = !fs5.existsSync(transformsDir);
   const mutationSnapshot = {
     fileSources: await snapshotWorkspaceFiles([
       blockConfigPath,
@@ -7475,4 +7385,4 @@ export {
   ADD_BLOCK_TEMPLATE_IDS
 };
 
-//# debugId=851894DA0B69BA4964756E2164756E21
+//# debugId=24FCFA027181E91A64756E2164756E21