@wp-typia/project-tools 0.22.2 → 0.22.4

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.d.ts

@@ -0,0 +1,21 @@
+import type { ScaffoldCompatibilityPolicy } from "./scaffold-compatibility.js";
+import type { WorkspaceProject } from "./workspace-project.js";
+/**
+ * Inputs required to scaffold a generated AI feature into a workspace.
+ */
+export interface ScaffoldAiFeatureWorkspaceOptions {
+    /** Kebab-case feature slug used for file paths and route ids. */
+    aiFeatureSlug: string;
+    /** Compatibility metadata applied to the generated workspace bootstrap. */
+    compatibilityPolicy: ScaffoldCompatibilityPolicy;
+    /** WordPress REST namespace used for generated feature routes. */
+    namespace: string;
+    /** Resolved workspace metadata and filesystem paths for the target project. */
+    workspace: WorkspaceProject;
+}
+/**
+ * Write generated AI feature sources and patch shared workspace anchors.
+ */
+export declare function scaffoldAiFeatureWorkspace({ aiFeatureSlug, compatibilityPolicy, namespace, workspace, }: ScaffoldAiFeatureWorkspaceOptions): Promise<{
+    warnings: string[];
+}>;

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

@@ -0,0 +1,87 @@
+import { promises as fsp } from "node:fs";
+import path from "node:path";
+import { ensureBlockConfigCanAddRestManifests } from "./cli-add-block-legacy-validator.js";
+import { buildAiFeatureConfigEntry, buildAiFeatureDataSource, buildAiFeatureSyncScriptSource, buildAiFeatureTypesSource, buildAiFeatureValidatorsSource, buildAiFeatureApiSource, } from "./cli-add-workspace-ai-source-emitters.js";
+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, } 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";
+/**
+ * Write generated AI feature sources and patch shared workspace anchors.
+ */
+export async function scaffoldAiFeatureWorkspace({ aiFeatureSlug, compatibilityPolicy, namespace, workspace, }) {
+    const blockConfigPath = path.join(workspace.projectDir, "scripts", "block-config.ts");
+    const bootstrapPath = getWorkspaceBootstrapPath(workspace);
+    const packageJsonPath = path.join(workspace.projectDir, "package.json");
+    const syncAiScriptPath = path.join(workspace.projectDir, "scripts", "sync-ai-features.ts");
+    const syncProjectScriptPath = path.join(workspace.projectDir, "scripts", "sync-project.ts");
+    const syncRestScriptPath = path.join(workspace.projectDir, "scripts", "sync-rest-contracts.ts");
+    const aiFeatureDir = path.join(workspace.projectDir, "src", "ai-features", aiFeatureSlug);
+    const typesFilePath = path.join(aiFeatureDir, "api-types.ts");
+    const validatorsFilePath = path.join(aiFeatureDir, "api-validators.ts");
+    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`);
+    return executeWorkspaceMutationPlan({
+        filePaths: [
+            blockConfigPath,
+            bootstrapPath,
+            packageJsonPath,
+            syncAiScriptPath,
+            syncProjectScriptPath,
+            syncRestScriptPath,
+        ],
+        targetPaths: [aiFeatureDir, phpFilePath, syncAiScriptPath],
+        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.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Build the generated PHP controller and hook surface for a workspace AI feature.
+ */
+export declare function buildAiFeaturePhpSource(aiFeatureSlug: string, namespace: string, phpPrefix: string, textDomain: string): string;