wp-typia 0.22.3 → 0.22.5

package/dist-bunli/{cli-add-p3re8act.js → cli-add-1gqgshf0.js}

@@ -21,7 +21,7 @@ import {
   scaffoldProject,
   syncPersistenceRestArtifacts,
   updatePluginHeaderCompatibility
-} from "./cli-tbd9x8b6.js";
+} from "./cli-ctddkm3n.js";
 import {
   DEFAULT_WORDPRESS_ABILITIES_VERSION,
   DEFAULT_WORDPRESS_CORE_ABILITIES_VERSION,
@@ -34,17 +34,20 @@ import {
 } from "./cli-1sm60g1z.js";
 import {
   snapshotProjectVersion
-} from "./cli-prc42zqd.js";
+} from "./cli-xbzfx7qz.js";
 import {
   ensureMigrationDirectories,
   parseMigrationConfig,
   writeInitialMigrationScaffold,
   writeMigrationConfig
-} from "./cli-gcbre1zs.js";
+} from "./cli-hb9vpsev.js";
 import"./cli-bq2v559b.js";
 import {
-  formatInstallCommand
-} from "./cli-sj5mtyzj.js";
+  findExecutablePatternMatch,
+  hasExecutablePattern,
+  hasUncommentedPattern,
+  maskTypeScriptCommentsAndLiterals
+} from "./cli-rwjkqjhs.js";
 import"./cli-10pe4mf8.js";
 import {
   SHARED_WORKSPACE_TEMPLATE_ROOT
@@ -97,7 +100,7 @@ import {
   toPascalCase,
   toSnakeCase,
   toTitleCase
-} from "./cli-x0h03qqe.js";
+} from "./cli-j30rk466.js";
 import {
   createManagedTempRoot
 } from "./cli-t73q5aqz.js";
@@ -107,7 +110,10 @@ import {
 } from "./cli-p95wr1q8.js";
 import {
   resolveWorkspaceProject
-} from "./cli-pd5pqgre.js";
+} from "./cli-btbpt84c.js";
+import {
+  formatInstallCommand
+} from "./cli-6bhfzq5e.js";
 import {
   __reExport,
   __toESM
@@ -1865,6 +1871,67 @@ add_action( 'admin_enqueue_scripts', '${enqueueFunctionName}' );
 `;
 }
 
+// ../wp-typia-project-tools/src/runtime/cli-add-workspace-mutation.ts
+var DEFAULT_PHP_SNIPPET_INSERTION_ANCHORS = [
+  /add_action\(\s*["']init["']\s*,\s*["'][^"']+_load_textdomain["']\s*\);\s*\n/u,
+  /\?>\s*$/u
+];
+
+class WorkspaceMutationRollbackError extends Error {
+  mutationError;
+  rollbackError;
+  constructor(mutationError, rollbackError) {
+    super("Workspace mutation failed and rollback also failed.");
+    this.name = "WorkspaceMutationRollbackError";
+    this.mutationError = mutationError;
+    this.rollbackError = rollbackError;
+  }
+}
+async function executeWorkspaceMutationPlan({
+  filePaths,
+  run,
+  snapshotDirs = [],
+  targetPaths = []
+}) {
+  const mutationSnapshot = {
+    fileSources: await snapshotWorkspaceFiles(filePaths),
+    snapshotDirs: [...snapshotDirs],
+    targetPaths: [...targetPaths]
+  };
+  try {
+    return await run();
+  } catch (error) {
+    try {
+      await rollbackWorkspaceMutation(mutationSnapshot);
+    } catch (rollbackError) {
+      throw new WorkspaceMutationRollbackError(error, rollbackError);
+    }
+    throw error;
+  }
+}
+function insertPhpSnippetBeforeWorkspaceAnchors(source, snippet) {
+  for (const anchor of DEFAULT_PHP_SNIPPET_INSERTION_ANCHORS) {
+    const candidate = source.replace(anchor, (match) => `${snippet}
+${match}`);
+    if (candidate !== source) {
+      return candidate;
+    }
+  }
+  return `${source.trimEnd()}
+${snippet}
+`;
+}
+function appendPhpSnippetBeforeClosingTag(source, snippet) {
+  const closingTagPattern = /\?>\s*$/u;
+  if (closingTagPattern.test(source)) {
+    return source.replace(closingTagPattern, `${snippet}
+?>`);
+  }
+  return `${source.trimEnd()}
+${snippet}
+`;
+}
+
 // ../wp-typia-project-tools/src/runtime/cli-add-workspace-admin-view-scaffold.ts
 function detectJsonIndent(source) {
   const indentMatch = /\n([ \t]+)"/u.exec(source);
@@ -1928,36 +1995,8 @@ function ${loadFunctionName}() {
 	}
 }
 `;
-    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, loadFunctionName)) {
-      insertPhpSnippet(loadFunction);
+      nextSource = insertPhpSnippetBeforeWorkspaceAnchors(nextSource, loadFunction);
     } else {
       const functionRange = findPhpFunctionRange(nextSource, loadFunctionName);
       const functionSource = functionRange ? nextSource.slice(functionRange.start, functionRange.end) : "";
@@ -1970,7 +2009,7 @@ ${snippet}
       }
     }
     if (!loadHookPattern.test(nextSource)) {
-      appendPhpSnippet(loadHook);
+      nextSource = appendPhpSnippetBeforeClosingTag(nextSource, loadHook);
     }
     return nextSource;
   });
@@ -2093,42 +2132,38 @@ async function scaffoldAdminViewWorkspace(options) {
   const adminViewsIndexPath = resolveAdminViewRegistryPath(workspace.projectDir);
   const adminViewDir = path5.join(workspace.projectDir, "src", "admin-views", adminViewSlug);
   const adminViewPhpPath = path5.join(workspace.projectDir, "inc", "admin-views", `${adminViewSlug}.php`);
-  const mutationSnapshot = {
-    fileSources: await snapshotWorkspaceFiles([
+  await executeWorkspaceMutationPlan({
+    filePaths: [
       adminViewsIndexPath,
       blockConfigPath,
       bootstrapPath,
       buildScriptPath,
       packageJsonPath,
       webpackConfigPath
-    ]),
-    snapshotDirs: [],
-    targetPaths: [adminViewDir, adminViewPhpPath]
-  };
-  try {
-    await fsp3.mkdir(adminViewDir, { recursive: true });
-    await fsp3.mkdir(path5.dirname(adminViewPhpPath), { recursive: true });
-    await ensureAdminViewPackageDependencies(workspace, parsedSource);
-    await ensureAdminViewBootstrapAnchors(workspace);
-    await ensureAdminViewBuildScriptAnchors(workspace);
-    await ensureAdminViewWebpackAnchors(workspace);
-    await fsp3.writeFile(path5.join(adminViewDir, "types.ts"), buildAdminViewTypesSource(adminViewSlug, restResource, coreDataSource), "utf8");
-    await fsp3.writeFile(path5.join(adminViewDir, "config.ts"), buildAdminViewConfigSource(adminViewSlug, workspace.workspace.textDomain, parsedSource, restResource), "utf8");
-    await fsp3.writeFile(path5.join(adminViewDir, "data.ts"), coreDataSource ? buildCoreDataAdminViewDataSource(adminViewSlug, coreDataSource) : restResource ? buildRestAdminViewDataSource(adminViewSlug, restResource) : buildDefaultAdminViewDataSource(adminViewSlug), "utf8");
-    await fsp3.writeFile(path5.join(adminViewDir, "Screen.tsx"), coreDataSource ? buildCoreDataAdminViewScreenSource(adminViewSlug, workspace.workspace.textDomain) : buildAdminViewScreenSource(adminViewSlug, workspace.workspace.textDomain), "utf8");
-    await fsp3.writeFile(path5.join(adminViewDir, "index.tsx"), buildAdminViewEntrySource(adminViewSlug), "utf8");
-    await fsp3.writeFile(path5.join(adminViewDir, "style.scss"), buildAdminViewStyleSource(), "utf8");
-    await fsp3.writeFile(adminViewPhpPath, buildAdminViewPhpSource(adminViewSlug, workspace), "utf8");
-    await writeAdminViewRegistry(workspace.projectDir, adminViewSlug);
-    await appendWorkspaceInventoryEntries(workspace.projectDir, {
-      adminViewEntries: [
-        buildAdminViewConfigEntry(adminViewSlug, parsedSource)
-      ]
-    });
-  } catch (error) {
-    await rollbackWorkspaceMutation(mutationSnapshot);
-    throw error;
-  }
+    ],
+    targetPaths: [adminViewDir, adminViewPhpPath],
+    run: async () => {
+      await fsp3.mkdir(adminViewDir, { recursive: true });
+      await fsp3.mkdir(path5.dirname(adminViewPhpPath), { recursive: true });
+      await ensureAdminViewPackageDependencies(workspace, parsedSource);
+      await ensureAdminViewBootstrapAnchors(workspace);
+      await ensureAdminViewBuildScriptAnchors(workspace);
+      await ensureAdminViewWebpackAnchors(workspace);
+      await fsp3.writeFile(path5.join(adminViewDir, "types.ts"), buildAdminViewTypesSource(adminViewSlug, restResource, coreDataSource), "utf8");
+      await fsp3.writeFile(path5.join(adminViewDir, "config.ts"), buildAdminViewConfigSource(adminViewSlug, workspace.workspace.textDomain, parsedSource, restResource), "utf8");
+      await fsp3.writeFile(path5.join(adminViewDir, "data.ts"), coreDataSource ? buildCoreDataAdminViewDataSource(adminViewSlug, coreDataSource) : restResource ? buildRestAdminViewDataSource(adminViewSlug, restResource) : buildDefaultAdminViewDataSource(adminViewSlug), "utf8");
+      await fsp3.writeFile(path5.join(adminViewDir, "Screen.tsx"), coreDataSource ? buildCoreDataAdminViewScreenSource(adminViewSlug, workspace.workspace.textDomain) : buildAdminViewScreenSource(adminViewSlug, workspace.workspace.textDomain), "utf8");
+      await fsp3.writeFile(path5.join(adminViewDir, "index.tsx"), buildAdminViewEntrySource(adminViewSlug), "utf8");
+      await fsp3.writeFile(path5.join(adminViewDir, "style.scss"), buildAdminViewStyleSource(), "utf8");
+      await fsp3.writeFile(adminViewPhpPath, buildAdminViewPhpSource(adminViewSlug, workspace), "utf8");
+      await writeAdminViewRegistry(workspace.projectDir, adminViewSlug);
+      await appendWorkspaceInventoryEntries(workspace.projectDir, {
+        adminViewEntries: [
+          buildAdminViewConfigEntry(adminViewSlug, parsedSource)
+        ]
+      });
+    }
+  });
 }
 
 // ../wp-typia-project-tools/src/runtime/cli-add-workspace-admin-view.ts
@@ -2759,45 +2794,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;
   });
@@ -2847,36 +2854,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,
@@ -2897,7 +2876,7 @@ ${snippet}
       }
     }
     if (!nextSource.includes(enqueueHook)) {
-      appendPhpSnippet(enqueueHook);
+      nextSource = appendPhpSnippetBeforeClosingTag(nextSource, enqueueHook);
     }
     return nextSource;
   });
@@ -3163,36 +3142,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.`,
@@ -3201,7 +3152,7 @@ ${snippet}
       ].join(" "));
     }
     if (!nextSource.includes(registerHook)) {
-      appendPhpSnippet(registerHook);
+      nextSource = appendPhpSnippetBeforeClosingTag(nextSource, registerHook);
     }
     return nextSource;
   });
@@ -4960,50 +4911,22 @@ 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, loadFunctionName)) {
-      insertPhpSnippet(loadFunction);
+      nextSource = insertPhpSnippetBeforeWorkspaceAnchors(nextSource, loadFunction);
     }
     if (!hasPhpFunctionDefinition(nextSource, enqueueFunctionName)) {
-      insertPhpSnippet(enqueueFunction);
+      nextSource = insertPhpSnippetBeforeWorkspaceAnchors(nextSource, enqueueFunction);
     } else if (!findPhpFunctionRange(nextSource, enqueueFunctionName)?.source.includes("wp_enqueue_script_module")) {
       nextSource = replacePhpFunctionDefinition(nextSource, enqueueFunctionName, enqueueFunction, { trimReplacementStart: true }) ?? nextSource;
     }
     if (!nextSource.includes(loadHook)) {
-      appendPhpSnippet(loadHook);
+      nextSource = appendPhpSnippetBeforeClosingTag(nextSource, loadHook);
     }
     if (!nextSource.includes(adminEnqueueHook)) {
-      appendPhpSnippet(adminEnqueueHook);
+      nextSource = appendPhpSnippetBeforeClosingTag(nextSource, adminEnqueueHook);
     }
     if (!nextSource.includes(editorEnqueueHook)) {
-      appendPhpSnippet(editorEnqueueHook);
+      nextSource = appendPhpSnippetBeforeClosingTag(nextSource, editorEnqueueHook);
     }
     return nextSource;
   });
@@ -5179,8 +5102,8 @@ async function scaffoldAbilityWorkspace({
   const dataFilePath = path10.join(abilityDir, "data.ts");
   const clientFilePath = path10.join(abilityDir, "client.ts");
   const phpFilePath = path10.join(workspace.projectDir, "inc", "abilities", `${abilitySlug}.php`);
-  const mutationSnapshot = {
-    fileSources: await snapshotWorkspaceFiles([
+  await executeWorkspaceMutationPlan({
+    filePaths: [
       blockConfigPath,
       bootstrapPath,
       buildScriptPath,
@@ -5189,48 +5112,44 @@ async function scaffoldAbilityWorkspace({
       syncProjectScriptPath,
       webpackConfigPath,
       abilitiesIndexPath
-    ]),
-    snapshotDirs: [],
-    targetPaths: [abilityDir, phpFilePath, syncAbilitiesScriptPath]
-  };
-  try {
-    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 ensureAbilityPackageScripts(workspace);
-    await ensureAbilitySyncProjectAnchors(workspace);
-    await ensureAbilityBuildScriptAnchors(workspace);
-    await ensureAbilityWebpackAnchors(workspace);
-    await fsp6.writeFile(syncAbilitiesScriptPath, buildAbilitySyncScriptSource(), "utf8");
-    await fsp6.writeFile(configFilePath, buildAbilityConfigSource(abilitySlug, workspace.workspace.namespace), "utf8");
-    await fsp6.writeFile(typesFilePath, buildAbilityTypesSource(abilitySlug), "utf8");
-    await fsp6.writeFile(dataFilePath, buildAbilityDataSource(abilitySlug), "utf8");
-    await fsp6.writeFile(clientFilePath, buildAbilityClientSource(abilitySlug), "utf8");
-    await fsp6.writeFile(phpFilePath, buildAbilityPhpSource(abilitySlug, workspace), "utf8");
-    const pascalCase = toPascalCase(abilitySlug);
-    await syncTypeSchemas2({
-      jsonSchemaFile: `src/abilities/${abilitySlug}/input.schema.json`,
-      projectRoot: workspace.projectDir,
-      sourceTypeName: `${pascalCase}AbilityInput`,
-      typesFile: `src/abilities/${abilitySlug}/types.ts`
-    });
-    await syncTypeSchemas2({
-      jsonSchemaFile: `src/abilities/${abilitySlug}/output.schema.json`,
-      projectRoot: workspace.projectDir,
-      sourceTypeName: `${pascalCase}AbilityOutput`,
-      typesFile: `src/abilities/${abilitySlug}/types.ts`
-    });
-    await writeAbilityRegistry(workspace.projectDir, abilitySlug);
-    await appendWorkspaceInventoryEntries(workspace.projectDir, {
-      abilityEntries: [
-        buildAbilityConfigEntry(abilitySlug, compatibilityPolicy)
-      ]
-    });
-  } catch (error) {
-    await rollbackWorkspaceMutation(mutationSnapshot);
-    throw error;
-  }
+    ],
+    targetPaths: [abilityDir, phpFilePath, syncAbilitiesScriptPath],
+    run: async () => {
+      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 ensureAbilityPackageScripts(workspace);
+      await ensureAbilitySyncProjectAnchors(workspace);
+      await ensureAbilityBuildScriptAnchors(workspace);
+      await ensureAbilityWebpackAnchors(workspace);
+      await fsp6.writeFile(syncAbilitiesScriptPath, buildAbilitySyncScriptSource(), "utf8");
+      await fsp6.writeFile(configFilePath, buildAbilityConfigSource(abilitySlug, workspace.workspace.namespace), "utf8");
+      await fsp6.writeFile(typesFilePath, buildAbilityTypesSource(abilitySlug), "utf8");
+      await fsp6.writeFile(dataFilePath, buildAbilityDataSource(abilitySlug), "utf8");
+      await fsp6.writeFile(clientFilePath, buildAbilityClientSource(abilitySlug), "utf8");
+      await fsp6.writeFile(phpFilePath, buildAbilityPhpSource(abilitySlug, workspace), "utf8");
+      const pascalCase = toPascalCase(abilitySlug);
+      await syncTypeSchemas2({
+        jsonSchemaFile: `src/abilities/${abilitySlug}/input.schema.json`,
+        projectRoot: workspace.projectDir,
+        sourceTypeName: `${pascalCase}AbilityInput`,
+        typesFile: `src/abilities/${abilitySlug}/types.ts`
+      });
+      await syncTypeSchemas2({
+        jsonSchemaFile: `src/abilities/${abilitySlug}/output.schema.json`,
+        projectRoot: workspace.projectDir,
+        sourceTypeName: `${pascalCase}AbilityOutput`,
+        typesFile: `src/abilities/${abilitySlug}/types.ts`
+      });
+      await writeAbilityRegistry(workspace.projectDir, abilitySlug);
+      await appendWorkspaceInventoryEntries(workspace.projectDir, {
+        abilityEntries: [
+          buildAbilityConfigEntry(abilitySlug, compatibilityPolicy)
+        ]
+      });
+    }
+  });
 }
 
 // ../wp-typia-project-tools/src/runtime/cli-add-workspace-ability.ts
@@ -5854,36 +5773,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.`,
@@ -5892,7 +5783,7 @@ ${snippet}
       ].join(" "));
     }
     if (!nextSource.includes(registerHook)) {
-      appendPhpSnippet(registerHook);
+      nextSource = appendPhpSnippetBeforeClosingTag(nextSource, registerHook);
     }
     return nextSource;
   });
@@ -6151,6 +6042,8 @@ if ( ! defined( 'ABSPATH' ) ) {
  * - ${quotePhpString(adminNoticeMessageFilterHook)} filters the wp-admin notice shown when AI support is unavailable.
  * - ${quotePhpString(unavailableMessageFilterHook)} filters REST-facing unavailable messages by reason code.
  * - ${quotePhpString(telemetryFilterHook)} filters the response telemetry array before schema validation. Return a schema-compatible array.
+ *
+ * Compatibility note: this server-only endpoint avoids WordPress script-module enqueue APIs so older sites can load the generated feature file safely.
  */
 
 if ( ! function_exists( '${loadSchemaFunctionName}' ) ) {
@@ -6731,66 +6624,62 @@ async function scaffoldAiFeatureWorkspace({
   const apiFilePath = path13.join(aiFeatureDir, "api.ts");
   const dataFilePath = path13.join(aiFeatureDir, "data.ts");
   const phpFilePath = path13.join(workspace.projectDir, "inc", "ai-features", `${aiFeatureSlug}.php`);
-  const mutationSnapshot = {
-    fileSources: await snapshotWorkspaceFiles([
+  return executeWorkspaceMutationPlan({
+    filePaths: [
       blockConfigPath,
       bootstrapPath,
       packageJsonPath,
       syncAiScriptPath,
       syncProjectScriptPath,
       syncRestScriptPath
-    ]),
-    snapshotDirs: [],
-    targetPaths: [aiFeatureDir, phpFilePath, syncAiScriptPath]
-  };
-  try {
-    await fsp8.mkdir(aiFeatureDir, { recursive: true });
-    await fsp8.mkdir(path13.dirname(phpFilePath), { recursive: true });
-    await ensureAiFeatureBootstrapAnchors(workspace);
-    await patchFile(bootstrapPath, (source) => updatePluginHeaderCompatibility(source, compatibilityPolicy));
-    const packageScriptChanges = await ensureAiFeaturePackageScripts(workspace);
-    await ensureAiFeatureSyncProjectAnchors(workspace);
-    await ensureAiFeatureSyncRestAnchors(workspace);
-    await fsp8.writeFile(syncAiScriptPath, buildAiFeatureSyncScriptSource(), "utf8");
-    await fsp8.writeFile(typesFilePath, buildAiFeatureTypesSource(aiFeatureSlug), "utf8");
-    await fsp8.writeFile(validatorsFilePath, buildAiFeatureValidatorsSource(aiFeatureSlug), "utf8");
-    await fsp8.writeFile(apiFilePath, buildAiFeatureApiSource(aiFeatureSlug), "utf8");
-    await fsp8.writeFile(dataFilePath, buildAiFeatureDataSource(aiFeatureSlug), "utf8");
-    await fsp8.writeFile(phpFilePath, buildAiFeaturePhpSource(aiFeatureSlug, namespace, workspace.workspace.phpPrefix, workspace.workspace.textDomain), "utf8");
-    const pascalCase = toPascalCase(aiFeatureSlug);
-    await syncAiFeatureRestArtifacts({
-      clientFile: `src/ai-features/${aiFeatureSlug}/api-client.ts`,
-      outputDir: path13.join("src", "ai-features", aiFeatureSlug),
-      projectDir: workspace.projectDir,
-      typesFile: `src/ai-features/${aiFeatureSlug}/api-types.ts`,
-      validatorsFile: `src/ai-features/${aiFeatureSlug}/api-validators.ts`,
-      variables: {
-        namespace,
-        pascalCase,
-        slugKebabCase: aiFeatureSlug,
-        title: toTitleCase(aiFeatureSlug)
-      }
-    });
-    await syncAiFeatureSchemaArtifact({
-      aiSchemaFile: `src/ai-features/${aiFeatureSlug}/ai-schemas/feature-result.ai.schema.json`,
-      outputDir: path13.join("src", "ai-features", aiFeatureSlug),
-      projectDir: workspace.projectDir
-    });
-    await appendWorkspaceInventoryEntries(workspace.projectDir, {
-      aiFeatureEntries: [
-        buildAiFeatureConfigEntry(aiFeatureSlug, namespace)
-      ],
-      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`."
-      ] : []
-    };
-  } catch (error) {
-    await rollbackWorkspaceMutation(mutationSnapshot);
-    throw error;
-  }
+    ],
+    targetPaths: [aiFeatureDir, phpFilePath, syncAiScriptPath],
+    run: async () => {
+      await fsp8.mkdir(aiFeatureDir, { recursive: true });
+      await fsp8.mkdir(path13.dirname(phpFilePath), { recursive: true });
+      await ensureAiFeatureBootstrapAnchors(workspace);
+      await patchFile(bootstrapPath, (source) => updatePluginHeaderCompatibility(source, compatibilityPolicy));
+      const packageScriptChanges = await ensureAiFeaturePackageScripts(workspace);
+      await ensureAiFeatureSyncProjectAnchors(workspace);
+      await ensureAiFeatureSyncRestAnchors(workspace);
+      await fsp8.writeFile(syncAiScriptPath, buildAiFeatureSyncScriptSource(), "utf8");
+      await fsp8.writeFile(typesFilePath, buildAiFeatureTypesSource(aiFeatureSlug), "utf8");
+      await fsp8.writeFile(validatorsFilePath, buildAiFeatureValidatorsSource(aiFeatureSlug), "utf8");
+      await fsp8.writeFile(apiFilePath, buildAiFeatureApiSource(aiFeatureSlug), "utf8");
+      await fsp8.writeFile(dataFilePath, buildAiFeatureDataSource(aiFeatureSlug), "utf8");
+      await fsp8.writeFile(phpFilePath, buildAiFeaturePhpSource(aiFeatureSlug, namespace, workspace.workspace.phpPrefix, workspace.workspace.textDomain), "utf8");
+      const pascalCase = toPascalCase(aiFeatureSlug);
+      await syncAiFeatureRestArtifacts({
+        clientFile: `src/ai-features/${aiFeatureSlug}/api-client.ts`,
+        outputDir: path13.join("src", "ai-features", aiFeatureSlug),
+        projectDir: workspace.projectDir,
+        typesFile: `src/ai-features/${aiFeatureSlug}/api-types.ts`,
+        validatorsFile: `src/ai-features/${aiFeatureSlug}/api-validators.ts`,
+        variables: {
+          namespace,
+          pascalCase,
+          slugKebabCase: aiFeatureSlug,
+          title: toTitleCase(aiFeatureSlug)
+        }
+      });
+      await syncAiFeatureSchemaArtifact({
+        aiSchemaFile: `src/ai-features/${aiFeatureSlug}/ai-schemas/feature-result.ai.schema.json`,
+        outputDir: path13.join("src", "ai-features", aiFeatureSlug),
+        projectDir: workspace.projectDir
+      });
+      await appendWorkspaceInventoryEntries(workspace.projectDir, {
+        aiFeatureEntries: [
+          buildAiFeatureConfigEntry(aiFeatureSlug, namespace)
+        ],
+        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`."
+        ] : []
+      };
+    }
+  });
 }
 
 // ../wp-typia-project-tools/src/runtime/cli-add-workspace-ai.ts
@@ -6834,80 +6723,6 @@ var BLOCK_TRANSFORMS_CALL_LINE = "applyWorkspaceBlockTransforms(registration.set
 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 maskSourceSegment(segment) {
-  return segment.replace(/[^\n\r]/gu, " ");
-}
-function maskTypeScriptComments(source) {
-  return source.replace(/\/\*[\s\S]*?\*\//gu, maskSourceSegment).replace(/\/\/[^\n\r]*/gu, maskSourceSegment);
-}
-function maskTypeScriptCommentsAndLiterals(source) {
-  let maskedSource = "";
-  let index = 0;
-  while (index < source.length) {
-    const current = source[index];
-    const next = source[index + 1];
-    if (current === "/" && next === "/") {
-      const start = index;
-      index += 2;
-      while (index < source.length && source[index] !== `
-` && source[index] !== "\r") {
-        index += 1;
-      }
-      maskedSource += maskSourceSegment(source.slice(start, index));
-      continue;
-    }
-    if (current === "/" && next === "*") {
-      const start = index;
-      index += 2;
-      while (index < source.length && !(source[index] === "*" && source[index + 1] === "/")) {
-        index += 1;
-      }
-      index = Math.min(index + 2, source.length);
-      maskedSource += maskSourceSegment(source.slice(start, index));
-      continue;
-    }
-    if (current === "'" || current === '"' || current === "`") {
-      const start = index;
-      const quote = current;
-      index += 1;
-      while (index < source.length) {
-        const char = source[index];
-        if (char === "\\") {
-          index += 2;
-          continue;
-        }
-        index += 1;
-        if (char === quote) {
-          break;
-        }
-      }
-      maskedSource += maskSourceSegment(source.slice(start, index));
-      continue;
-    }
-    maskedSource += current;
-    index += 1;
-  }
-  return maskedSource;
-}
-function hasExecutablePattern(source, pattern) {
-  return pattern.test(maskTypeScriptCommentsAndLiterals(source));
-}
-function hasUncommentedPattern(source, pattern) {
-  return pattern.test(maskTypeScriptComments(source));
-}
-function findExecutablePatternMatch(source, patterns) {
-  const maskedSource = maskTypeScriptCommentsAndLiterals(source);
-  for (const pattern of patterns) {
-    const match = pattern.exec(maskedSource);
-    if (match && match.index !== undefined) {
-      return {
-        end: match.index + match[0].length,
-        start: match.index
-      };
-    }
-  }
-  return;
-}
 function isIdentifierBoundary(source, index) {
   if (index < 0 || index >= source.length) {
     return true;
@@ -7540,6 +7355,7 @@ export {
   runAddAiFeatureCommand,
   runAddAdminViewCommand,
   runAddAbilityCommand,
+  isAddBlockTemplateId,
   getWorkspaceBlockSelectOptions,
   formatAddHelpText,
   EDITOR_PLUGIN_SLOT_IDS,
@@ -7547,4 +7363,4 @@ export {
   ADD_BLOCK_TEMPLATE_IDS
 };
 
-//# debugId=272EBA8B7C96349F64756E2164756E21
+//# debugId=BE460360B35E3C8864756E2164756E21