@wp-typia/project-tools 0.22.3 → 0.22.4

package/dist/runtime/cli-add-workspace-ability-scaffold.js

@@ -6,7 +6,8 @@ import semver from "semver";
 import { appendWorkspaceInventoryEntries, readWorkspaceInventory, } from "./workspace-inventory.js";
 import { buildAbilityClientSource, buildAbilityConfigEntry, buildAbilityConfigSource, buildAbilityDataSource, buildAbilityPhpSource, buildAbilityRegistrySource, buildAbilitySyncScriptSource, buildAbilityTypesSource, } from "./cli-add-workspace-ability-templates.js";
 import { ABILITY_EDITOR_ASSET, ABILITY_EDITOR_SCRIPT, ABILITY_REGISTRY_END_MARKER, ABILITY_REGISTRY_START_MARKER, ABILITY_SERVER_GLOB, WP_ABILITIES_SCRIPT_MODULE_ID, WP_CORE_ABILITIES_SCRIPT_MODULE_ID, } from "./cli-add-workspace-ability-types.js";
-import { getWorkspaceBootstrapPath, patchFile, rollbackWorkspaceMutation, snapshotWorkspaceFiles, } from "./cli-add-shared.js";
+import { getWorkspaceBootstrapPath, patchFile, } from "./cli-add-shared.js";
+import { appendPhpSnippetBeforeClosingTag, executeWorkspaceMutationPlan, insertPhpSnippetBeforeWorkspaceAnchors, } from "./cli-add-workspace-mutation.js";
 import { updatePluginHeaderCompatibility, } from "./scaffold-compatibility.js";
 import { DEFAULT_WORDPRESS_ABILITIES_VERSION, DEFAULT_WORDPRESS_CORE_ABILITIES_VERSION, } from "./package-versions.js";
 import { escapeRegex, findPhpFunctionRange, hasPhpFunctionDefinition, replacePhpFunctionDefinition, } from "./php-utils.js";
@@ -123,46 +124,24 @@ function ${enqueueFunctionName}() {
 \t);
 }
 `;
-        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}\n${match}`);
-                if (candidate !== nextSource) {
-                    nextSource = candidate;
-                    return;
-                }
-            }
-            nextSource = `${nextSource.trimEnd()}\n${snippet}\n`;
-        };
-        const appendPhpSnippet = (snippet) => {
-            const closingTagPattern = /\?>\s*$/u;
-            if (closingTagPattern.test(nextSource)) {
-                nextSource = nextSource.replace(closingTagPattern, `${snippet}\n?>`);
-                return;
-            }
-            nextSource = `${nextSource.trimEnd()}\n${snippet}\n`;
-        };
         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;
     });
@@ -336,8 +315,8 @@ export async function scaffoldAbilityWorkspace({ abilitySlug, compatibilityPolic
     const dataFilePath = path.join(abilityDir, "data.ts");
     const clientFilePath = path.join(abilityDir, "client.ts");
     const phpFilePath = path.join(workspace.projectDir, "inc", "abilities", `${abilitySlug}.php`);
-    const mutationSnapshot = {
-        fileSources: await snapshotWorkspaceFiles([
+    await executeWorkspaceMutationPlan({
+        filePaths: [
             blockConfigPath,
             bootstrapPath,
             buildScriptPath,
@@ -346,47 +325,42 @@ export async function scaffoldAbilityWorkspace({ abilitySlug, compatibilityPolic
             syncProjectScriptPath,
             webpackConfigPath,
             abilitiesIndexPath,
-        ]),
-        snapshotDirs: [],
+        ],
         targetPaths: [abilityDir, phpFilePath, syncAbilitiesScriptPath],
-    };
-    try {
-        await fsp.mkdir(abilityDir, { recursive: true });
-        await fsp.mkdir(path.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 fsp.writeFile(syncAbilitiesScriptPath, buildAbilitySyncScriptSource(), "utf8");
-        await fsp.writeFile(configFilePath, buildAbilityConfigSource(abilitySlug, workspace.workspace.namespace), "utf8");
-        await fsp.writeFile(typesFilePath, buildAbilityTypesSource(abilitySlug), "utf8");
-        await fsp.writeFile(dataFilePath, buildAbilityDataSource(abilitySlug), "utf8");
-        await fsp.writeFile(clientFilePath, buildAbilityClientSource(abilitySlug), "utf8");
-        await fsp.writeFile(phpFilePath, buildAbilityPhpSource(abilitySlug, workspace), "utf8");
-        const pascalCase = toPascalCase(abilitySlug);
-        await syncTypeSchemas({
-            jsonSchemaFile: `src/abilities/${abilitySlug}/input.schema.json`,
-            projectRoot: workspace.projectDir,
-            sourceTypeName: `${pascalCase}AbilityInput`,
-            typesFile: `src/abilities/${abilitySlug}/types.ts`,
-        });
-        await syncTypeSchemas({
-            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;
-    }
+        run: async () => {
+            await fsp.mkdir(abilityDir, { recursive: true });
+            await fsp.mkdir(path.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 fsp.writeFile(syncAbilitiesScriptPath, buildAbilitySyncScriptSource(), "utf8");
+            await fsp.writeFile(configFilePath, buildAbilityConfigSource(abilitySlug, workspace.workspace.namespace), "utf8");
+            await fsp.writeFile(typesFilePath, buildAbilityTypesSource(abilitySlug), "utf8");
+            await fsp.writeFile(dataFilePath, buildAbilityDataSource(abilitySlug), "utf8");
+            await fsp.writeFile(clientFilePath, buildAbilityClientSource(abilitySlug), "utf8");
+            await fsp.writeFile(phpFilePath, buildAbilityPhpSource(abilitySlug, workspace), "utf8");
+            const pascalCase = toPascalCase(abilitySlug);
+            await syncTypeSchemas({
+                jsonSchemaFile: `src/abilities/${abilitySlug}/input.schema.json`,
+                projectRoot: workspace.projectDir,
+                sourceTypeName: `${pascalCase}AbilityInput`,
+                typesFile: `src/abilities/${abilitySlug}/types.ts`,
+            });
+            await syncTypeSchemas({
+                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),
+                ],
+            });
+        },
+    });
 }

package/dist/runtime/cli-add-workspace-admin-view-scaffold.js

@@ -4,7 +4,8 @@ import path from 'node:path';
 import { appendWorkspaceInventoryEntries, readWorkspaceInventory, } from './workspace-inventory.js';
 import { buildAdminViewConfigEntry, buildAdminViewConfigSource, buildAdminViewEntrySource, buildAdminViewPhpSource, buildAdminViewRegistrySource, buildAdminViewScreenSource, buildAdminViewStyleSource, buildAdminViewTypesSource, buildCoreDataAdminViewDataSource, buildCoreDataAdminViewScreenSource, buildDefaultAdminViewDataSource, buildRestAdminViewDataSource, } from './cli-add-workspace-admin-view-templates.js';
 import { ADMIN_VIEWS_PHP_GLOB, isAdminViewCoreDataSource, } from './cli-add-workspace-admin-view-types.js';
-import { getWorkspaceBootstrapPath, patchFile, rollbackWorkspaceMutation, snapshotWorkspaceFiles, } from './cli-add-shared.js';
+import { getWorkspaceBootstrapPath, patchFile, } from './cli-add-shared.js';
+import { appendPhpSnippetBeforeClosingTag, executeWorkspaceMutationPlan, insertPhpSnippetBeforeWorkspaceAnchors, } from './cli-add-workspace-mutation.js';
 import { DEFAULT_WORDPRESS_CORE_DATA_VERSION, DEFAULT_WORDPRESS_DATA_VERSION, DEFAULT_WORDPRESS_DATAVIEWS_VERSION, DEFAULT_WP_TYPIA_DATAVIEWS_VERSION, resolveManagedPackageVersionRange, } from './package-versions.js';
 import { findPhpFunctionRange, hasPhpFunctionDefinition, replacePhpFunctionDefinition, } from './php-utils.js';
 function detectJsonIndent(source) {
@@ -77,30 +78,8 @@ function ${loadFunctionName}() {
 \t}
 }
 `;
-        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}\n${match}`);
-                if (candidate !== nextSource) {
-                    nextSource = candidate;
-                    return;
-                }
-            }
-            nextSource = `${nextSource.trimEnd()}\n${snippet}\n`;
-        };
-        const appendPhpSnippet = (snippet) => {
-            const closingTagPattern = /\?>\s*$/u;
-            if (closingTagPattern.test(nextSource)) {
-                nextSource = nextSource.replace(closingTagPattern, `${snippet}\n?>`);
-                return;
-            }
-            nextSource = `${nextSource.trimEnd()}\n${snippet}\n`;
-        };
         if (!hasPhpFunctionDefinition(nextSource, loadFunctionName)) {
-            insertPhpSnippet(loadFunction);
+            nextSource = insertPhpSnippetBeforeWorkspaceAnchors(nextSource, loadFunction);
         }
         else {
             const functionRange = findPhpFunctionRange(nextSource, loadFunctionName);
@@ -116,7 +95,7 @@ function ${loadFunctionName}() {
             }
         }
         if (!loadHookPattern.test(nextSource)) {
-            appendPhpSnippet(loadHook);
+            nextSource = appendPhpSnippetBeforeClosingTag(nextSource, loadHook);
         }
         return nextSource;
     });
@@ -211,47 +190,42 @@ export async function scaffoldAdminViewWorkspace(options) {
     const adminViewsIndexPath = resolveAdminViewRegistryPath(workspace.projectDir);
     const adminViewDir = path.join(workspace.projectDir, 'src', 'admin-views', adminViewSlug);
     const adminViewPhpPath = path.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 fsp.mkdir(adminViewDir, { recursive: true });
-        await fsp.mkdir(path.dirname(adminViewPhpPath), { recursive: true });
-        await ensureAdminViewPackageDependencies(workspace, parsedSource);
-        await ensureAdminViewBootstrapAnchors(workspace);
-        await ensureAdminViewBuildScriptAnchors(workspace);
-        await ensureAdminViewWebpackAnchors(workspace);
-        await fsp.writeFile(path.join(adminViewDir, 'types.ts'), buildAdminViewTypesSource(adminViewSlug, restResource, coreDataSource), 'utf8');
-        await fsp.writeFile(path.join(adminViewDir, 'config.ts'), buildAdminViewConfigSource(adminViewSlug, workspace.workspace.textDomain, parsedSource, restResource), 'utf8');
-        await fsp.writeFile(path.join(adminViewDir, 'data.ts'), coreDataSource
-            ? buildCoreDataAdminViewDataSource(adminViewSlug, coreDataSource)
-            : restResource
-                ? buildRestAdminViewDataSource(adminViewSlug, restResource)
-                : buildDefaultAdminViewDataSource(adminViewSlug), 'utf8');
-        await fsp.writeFile(path.join(adminViewDir, 'Screen.tsx'), coreDataSource
-            ? buildCoreDataAdminViewScreenSource(adminViewSlug, workspace.workspace.textDomain)
-            : buildAdminViewScreenSource(adminViewSlug, workspace.workspace.textDomain), 'utf8');
-        await fsp.writeFile(path.join(adminViewDir, 'index.tsx'), buildAdminViewEntrySource(adminViewSlug), 'utf8');
-        await fsp.writeFile(path.join(adminViewDir, 'style.scss'), buildAdminViewStyleSource(), 'utf8');
-        await fsp.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;
-    }
+        run: async () => {
+            await fsp.mkdir(adminViewDir, { recursive: true });
+            await fsp.mkdir(path.dirname(adminViewPhpPath), { recursive: true });
+            await ensureAdminViewPackageDependencies(workspace, parsedSource);
+            await ensureAdminViewBootstrapAnchors(workspace);
+            await ensureAdminViewBuildScriptAnchors(workspace);
+            await ensureAdminViewWebpackAnchors(workspace);
+            await fsp.writeFile(path.join(adminViewDir, 'types.ts'), buildAdminViewTypesSource(adminViewSlug, restResource, coreDataSource), 'utf8');
+            await fsp.writeFile(path.join(adminViewDir, 'config.ts'), buildAdminViewConfigSource(adminViewSlug, workspace.workspace.textDomain, parsedSource, restResource), 'utf8');
+            await fsp.writeFile(path.join(adminViewDir, 'data.ts'), coreDataSource
+                ? buildCoreDataAdminViewDataSource(adminViewSlug, coreDataSource)
+                : restResource
+                    ? buildRestAdminViewDataSource(adminViewSlug, restResource)
+                    : buildDefaultAdminViewDataSource(adminViewSlug), 'utf8');
+            await fsp.writeFile(path.join(adminViewDir, 'Screen.tsx'), coreDataSource
+                ? buildCoreDataAdminViewScreenSource(adminViewSlug, workspace.workspace.textDomain)
+                : buildAdminViewScreenSource(adminViewSlug, workspace.workspace.textDomain), 'utf8');
+            await fsp.writeFile(path.join(adminViewDir, 'index.tsx'), buildAdminViewEntrySource(adminViewSlug), 'utf8');
+            await fsp.writeFile(path.join(adminViewDir, 'style.scss'), buildAdminViewStyleSource(), 'utf8');
+            await fsp.writeFile(adminViewPhpPath, buildAdminViewPhpSource(adminViewSlug, workspace), 'utf8');
+            await writeAdminViewRegistry(workspace.projectDir, adminViewSlug);
+            await appendWorkspaceInventoryEntries(workspace.projectDir, {
+                adminViewEntries: [
+                    buildAdminViewConfigEntry(adminViewSlug, parsedSource),
+                ],
+            });
+        },
+    });
 }

package/dist/runtime/cli-add-workspace-ai-scaffold.js

@@ -5,7 +5,8 @@ import { buildAiFeatureConfigEntry, buildAiFeatureDataSource, buildAiFeatureSync
 import { ensureAiFeatureBootstrapAnchors, ensureAiFeaturePackageScripts, ensureAiFeatureSyncProjectAnchors, ensureAiFeatureSyncRestAnchors, } from "./cli-add-workspace-ai-anchors.js";
 import { buildAiFeaturePhpSource } from "./cli-add-workspace-ai-templates.js";
 import { appendWorkspaceInventoryEntries } from "./workspace-inventory.js";
-import { getWorkspaceBootstrapPath, patchFile, rollbackWorkspaceMutation, snapshotWorkspaceFiles, } from "./cli-add-shared.js";
+import { getWorkspaceBootstrapPath, patchFile, } from "./cli-add-shared.js";
+import { executeWorkspaceMutationPlan } from "./cli-add-workspace-mutation.js";
 import { updatePluginHeaderCompatibility } from "./scaffold-compatibility.js";
 import { toPascalCase, toTitleCase } from "./string-case.js";
 import { syncAiFeatureRestArtifacts, syncAiFeatureSchemaArtifact, } from "./ai-feature-artifacts.js";
@@ -25,67 +26,62 @@ export async function scaffoldAiFeatureWorkspace({ aiFeatureSlug, compatibilityP
     const apiFilePath = path.join(aiFeatureDir, "api.ts");
     const dataFilePath = path.join(aiFeatureDir, "data.ts");
     const phpFilePath = path.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 fsp.mkdir(aiFeatureDir, { recursive: true });
-        await fsp.mkdir(path.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 fsp.writeFile(syncAiScriptPath, buildAiFeatureSyncScriptSource(), "utf8");
-        await fsp.writeFile(typesFilePath, buildAiFeatureTypesSource(aiFeatureSlug), "utf8");
-        await fsp.writeFile(validatorsFilePath, buildAiFeatureValidatorsSource(aiFeatureSlug), "utf8");
-        await fsp.writeFile(apiFilePath, buildAiFeatureApiSource(aiFeatureSlug), "utf8");
-        await fsp.writeFile(dataFilePath, buildAiFeatureDataSource(aiFeatureSlug), "utf8");
-        await fsp.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: path.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: path.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;
-    }
+        run: async () => {
+            await fsp.mkdir(aiFeatureDir, { recursive: true });
+            await fsp.mkdir(path.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 fsp.writeFile(syncAiScriptPath, buildAiFeatureSyncScriptSource(), "utf8");
+            await fsp.writeFile(typesFilePath, buildAiFeatureTypesSource(aiFeatureSlug), "utf8");
+            await fsp.writeFile(validatorsFilePath, buildAiFeatureValidatorsSource(aiFeatureSlug), "utf8");
+            await fsp.writeFile(apiFilePath, buildAiFeatureApiSource(aiFeatureSlug), "utf8");
+            await fsp.writeFile(dataFilePath, buildAiFeatureDataSource(aiFeatureSlug), "utf8");
+            await fsp.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: path.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: path.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`.",
+                    ]
+                    : [],
+            };
+        },
+    });
 }

package/dist/runtime/cli-add-workspace-ai-templates.js

@@ -43,6 +43,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}' ) ) {

package/dist/runtime/cli-add-workspace-mutation.d.ts

@@ -0,0 +1,30 @@
+export interface WorkspaceMutationPlan<TResult> {
+    /** Files to capture before the mutation starts. Missing files are restored as absent. */
+    filePaths: string[];
+    /** Snapshot directories created by the mutation, usually migration fixtures. */
+    snapshotDirs?: string[];
+    /** Created files or directories to remove if the mutation fails. */
+    targetPaths?: string[];
+    /** Mutating work to execute after the snapshot is captured. */
+    run: () => Promise<TResult>;
+}
+/**
+ * Error thrown when the mutation and its rollback both fail.
+ */
+export declare class WorkspaceMutationRollbackError extends Error {
+    readonly mutationError: unknown;
+    readonly rollbackError: unknown;
+    constructor(mutationError: unknown, rollbackError: unknown);
+}
+/**
+ * Execute a workspace add mutation with rollback on any failure.
+ */
+export declare function executeWorkspaceMutationPlan<TResult>({ filePaths, run, snapshotDirs, targetPaths, }: WorkspaceMutationPlan<TResult>): Promise<TResult>;
+/**
+ * Insert a PHP snippet before the workspace textdomain hook or closing tag.
+ */
+export declare function insertPhpSnippetBeforeWorkspaceAnchors(source: string, snippet: string): string;
+/**
+ * Append a PHP snippet before the closing tag when one is present.
+ */
+export declare function appendPhpSnippetBeforeClosingTag(source: string, snippet: string): string;

package/dist/runtime/cli-add-workspace-mutation.js

@@ -0,0 +1,60 @@
+import { rollbackWorkspaceMutation, snapshotWorkspaceFiles, } from "./cli-add-shared.js";
+const DEFAULT_PHP_SNIPPET_INSERTION_ANCHORS = [
+    /add_action\(\s*["']init["']\s*,\s*["'][^"']+_load_textdomain["']\s*\);\s*\n/u,
+    /\?>\s*$/u,
+];
+/**
+ * Error thrown when the mutation and its rollback both fail.
+ */
+export class WorkspaceMutationRollbackError extends Error {
+    constructor(mutationError, rollbackError) {
+        super("Workspace mutation failed and rollback also failed.");
+        this.name = "WorkspaceMutationRollbackError";
+        this.mutationError = mutationError;
+        this.rollbackError = rollbackError;
+    }
+}
+/**
+ * Execute a workspace add mutation with rollback on any failure.
+ */
+export 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;
+    }
+}
+/**
+ * Insert a PHP snippet before the workspace textdomain hook or closing tag.
+ */
+export function insertPhpSnippetBeforeWorkspaceAnchors(source, snippet) {
+    for (const anchor of DEFAULT_PHP_SNIPPET_INSERTION_ANCHORS) {
+        const candidate = source.replace(anchor, (match) => `${snippet}\n${match}`);
+        if (candidate !== source) {
+            return candidate;
+        }
+    }
+    return `${source.trimEnd()}\n${snippet}\n`;
+}
+/**
+ * Append a PHP snippet before the closing tag when one is present.
+ */
+export function appendPhpSnippetBeforeClosingTag(source, snippet) {
+    const closingTagPattern = /\?>\s*$/u;
+    if (closingTagPattern.test(source)) {
+        return source.replace(closingTagPattern, `${snippet}\n?>`);
+    }
+    return `${source.trimEnd()}\n${snippet}\n`;
+}

package/dist/runtime/cli-add-workspace.js

@@ -5,6 +5,7 @@ import { resolveWorkspaceProject } from "./workspace-project.js";
 import { appendWorkspaceInventoryEntries, readWorkspaceInventory } from "./workspace-inventory.js";
 import { toKebabCase, toSnakeCase, toTitleCase } from "./string-case.js";
 import { assertBlockStyleDoesNotExist, assertBlockTransformDoesNotExist, assertValidGeneratedSlug, assertValidHookAnchor, assertValidHookedBlockPosition, assertVariationDoesNotExist, getMutableBlockHooks, normalizeBlockSlug, patchFile, quoteTsString, readWorkspaceBlockJson, resolveWorkspaceBlock, rollbackWorkspaceMutation, snapshotWorkspaceFiles, } from "./cli-add-shared.js";
+import { findExecutablePatternMatch, hasExecutablePattern, hasUncommentedPattern, maskTypeScriptCommentsAndLiterals, } from "./ts-source-masking.js";
 const VARIATIONS_IMPORT_LINE = "import { registerWorkspaceVariations } from './variations';";
 const VARIATIONS_IMPORT_PATTERN = /^\s*import\s*\{\s*registerWorkspaceVariations\s*\}\s*from\s*["']\.\/variations["']\s*;?\s*$/mu;
 const VARIATIONS_CALL_LINE = "registerWorkspaceVariations();";
@@ -19,85 +20,6 @@ const BLOCK_TRANSFORMS_CALL_LINE = "applyWorkspaceBlockTransforms(registration.s
 const BLOCK_TRANSFORMS_CALL_PATTERN = /applyWorkspaceBlockTransforms\s*\(\s*registration\s*\.\s*settings\s*\)\s*;?/u;
 const SCAFFOLD_REGISTRATION_SETTINGS_CALL_PATTERN = /registerScaffoldBlockType\s*\(\s*registration\s*\.\s*name\s*,\s*registration\s*\.\s*settings\s*\)\s*;?/u;
 const 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);
-}
-// Preserve source offsets so executable-code match indexes still map to the original file.
-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] !== "\n" &&
-                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 undefined;
-}
 function isIdentifierBoundary(source, index) {
     if (index < 0 || index >= source.length) {
         return true;

package/dist/runtime/cli-add.d.ts

@@ -3,11 +3,11 @@
  *
  * The canonical CLI surface stays stable here while the implementation lives
  * in focused internal modules:
- * - `cli-add-shared` for shared validation/help/rollback helpers
+ * - `cli-add-shared` as a compatibility barrel around focused add helpers
  * - `cli-add-block` for built-in block scaffolding
  * - `cli-add-workspace` for workspace mutation commands
  */
-export { ADD_BLOCK_TEMPLATE_IDS, ADD_KIND_IDS, EDITOR_PLUGIN_SLOT_IDS, formatAddHelpText, } from "./cli-add-shared.js";
+export { ADD_BLOCK_TEMPLATE_IDS, ADD_KIND_IDS, EDITOR_PLUGIN_SLOT_IDS, formatAddHelpText, isAddBlockTemplateId, } from "./cli-add-shared.js";
 export type { AddBlockTemplateId, AddKindId, EditorPluginSlotId, } from "./cli-add-shared.js";
 export { runAddBlockCommand, seedWorkspaceMigrationProject, } from "./cli-add-block.js";
 export { runAddAdminViewCommand, runAddAbilityCommand, runAddAiFeatureCommand, runAddBindingSourceCommand, runAddBlockStyleCommand, runAddBlockTransformCommand, runAddEditorPluginCommand, runAddHookedBlockCommand, runAddPatternCommand, runAddRestResourceCommand, runAddVariationCommand, } from "./cli-add-workspace.js";