@wp-typia/project-tools 0.16.14 → 0.18.0

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

@@ -4,17 +4,67 @@ import path from "node:path";
 import { resolveWorkspaceProject, } from "./workspace-project.js";
 import { readWorkspaceInventory, appendWorkspaceInventoryEntries } from "./workspace-inventory.js";
 import { toTitleCase } from "./string-case.js";
-import { assertBindingSourceDoesNotExist, assertPatternDoesNotExist, assertValidGeneratedSlug, getWorkspaceBootstrapPath, normalizeBlockSlug, patchFile, quoteTsString, rollbackWorkspaceMutation, snapshotWorkspaceFiles, } from "./cli-add-shared.js";
+import { assertBindingSourceDoesNotExist, assertEditorPluginDoesNotExist, assertPatternDoesNotExist, assertValidEditorPluginSlot, assertValidGeneratedSlug, getWorkspaceBootstrapPath, normalizeBlockSlug, patchFile, quoteTsString, rollbackWorkspaceMutation, snapshotWorkspaceFiles, } from "./cli-add-shared.js";
 const PATTERN_BOOTSTRAP_CATEGORY = "register_block_pattern_category";
 const BINDING_SOURCE_SERVER_GLOB = "/src/bindings/*/server.php";
 const BINDING_SOURCE_EDITOR_SCRIPT = "build/bindings/index.js";
 const BINDING_SOURCE_EDITOR_ASSET = "build/bindings/index.asset.php";
+const EDITOR_PLUGIN_EDITOR_SCRIPT = "build/editor-plugins/index.js";
+const EDITOR_PLUGIN_EDITOR_ASSET = "build/editor-plugins/index.asset.php";
+const EDITOR_PLUGIN_EDITOR_STYLE = "build/editor-plugins/style-index.css";
+const EDITOR_PLUGIN_EDITOR_STYLE_RTL = "build/editor-plugins/style-index-rtl.css";
 function escapeRegex(value) {
     return value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
 }
 function quotePhpString(value) {
     return `'${value.replace(/\\/gu, "\\\\").replace(/'/gu, "\\'")}'`;
 }
+function findPhpFunctionRange(source, functionName) {
+    const signaturePattern = new RegExp(`function\\s+${escapeRegex(functionName)}\\s*\\(`, "u");
+    const signatureMatch = signaturePattern.exec(source);
+    if (!signatureMatch || signatureMatch.index === undefined) {
+        return null;
+    }
+    const functionStart = signatureMatch.index;
+    const openBraceIndex = source.indexOf("{", functionStart);
+    if (openBraceIndex === -1) {
+        return null;
+    }
+    let depth = 0;
+    for (let index = openBraceIndex; index < source.length; index += 1) {
+        const character = source[index];
+        if (character === "{") {
+            depth += 1;
+            continue;
+        }
+        if (character !== "}") {
+            continue;
+        }
+        depth -= 1;
+        if (depth === 0) {
+            let functionEnd = index + 1;
+            while (functionEnd < source.length && /[\r\n]/u.test(source[functionEnd] ?? "")) {
+                functionEnd += 1;
+            }
+            return {
+                end: functionEnd,
+                start: functionStart,
+            };
+        }
+    }
+    return null;
+}
+function replacePhpFunctionDefinition(source, functionName, replacement) {
+    const functionRange = findPhpFunctionRange(source, functionName);
+    if (!functionRange) {
+        return null;
+    }
+    return [
+        source.slice(0, functionRange.start),
+        replacement,
+        source.slice(functionRange.end),
+    ].join("");
+}
 function buildPatternConfigEntry(patternSlug) {
     return [
         "\t{",
@@ -32,6 +82,22 @@ function buildBindingSourceConfigEntry(bindingSourceSlug) {
         "\t},",
     ].join("\n");
 }
+function buildEditorPluginConfigEntry(editorPluginSlug, slot) {
+    return [
+        "\t{",
+        `\t\tfile: ${quoteTsString(`src/editor-plugins/${editorPluginSlug}/index.tsx`)},`,
+        `\t\tslug: ${quoteTsString(editorPluginSlug)},`,
+        `\t\tslot: ${quoteTsString(slot)},`,
+        "\t},",
+    ].join("\n");
+}
+function toPascalCaseFromSlug(slug) {
+    return normalizeBlockSlug(slug)
+        .split("-")
+        .filter(Boolean)
+        .map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1))
+        .join("");
+}
 function buildPatternSource(patternSlug, namespace, textDomain) {
     const patternTitle = toTitleCase(patternSlug);
     return `<?php
@@ -144,12 +210,137 @@ registerBlockBindingsSource( {
 } );
 `;
 }
+function buildEditorPluginTypesSource(editorPluginSlug) {
+    const typeName = `${toPascalCaseFromSlug(editorPluginSlug)}SidebarModel`;
+    return `export interface ${typeName} {
+\tprimaryActionLabel: string;
+\tsummary: string;
+}
+`;
+}
+function buildEditorPluginDataSource(editorPluginSlug, slot) {
+    const typeName = `${toPascalCaseFromSlug(editorPluginSlug)}SidebarModel`;
+    const pluginTitle = toTitleCase(editorPluginSlug);
+    const modelFactoryName = `get${toPascalCaseFromSlug(editorPluginSlug)}SidebarModel`;
+    const enabledFactoryName = `is${toPascalCaseFromSlug(editorPluginSlug)}Enabled`;
+    return `import type { ${typeName} } from './types';
+
+export const EDITOR_PLUGIN_SLOT = ${quoteTsString(slot)} as const;
+export const REQUIRED_CAPABILITY = 'edit_posts' as const;
+
+const DEFAULT_SIDEBAR_MODEL: ${typeName} = {
+\tprimaryActionLabel: ${quoteTsString(`Review ${pluginTitle}`)},
+\tsummary: ${quoteTsString(`Replace this summary with your ${pluginTitle} workflow state.`)},
+};
+
+export function ${modelFactoryName}(): ${typeName} {
+\treturn DEFAULT_SIDEBAR_MODEL;
+}
+
+export function ${enabledFactoryName}(): boolean {
+\treturn true;
+}
+`;
+}
+function buildEditorPluginSidebarSource(editorPluginSlug, textDomain) {
+    const pascalName = toPascalCaseFromSlug(editorPluginSlug);
+    const modelFactoryName = `get${pascalName}SidebarModel`;
+    const enabledFactoryName = `is${pascalName}Enabled`;
+    const componentName = `${pascalName}Sidebar`;
+    return `import { Button, PanelBody } from '@wordpress/components';
+import { PluginSidebar, PluginSidebarMoreMenuItem } from '@wordpress/editor';
+import { __ } from '@wordpress/i18n';
+
+import { ${modelFactoryName}, ${enabledFactoryName} } from './data';
+import './style.scss';
+
+export interface ${componentName}Props {
+\tpluginName: string;
+\ttitle: string;
+}
+
+export function ${componentName}( {
+\tpluginName,
+\ttitle,
+}: ${componentName}Props ) {
+\tif ( ! ${enabledFactoryName}() ) {
+\t\treturn null;
+\t}
+
+\tconst sidebarModel = ${modelFactoryName}();
+
+\treturn (
+\t\t<>
+\t\t\t<PluginSidebarMoreMenuItem target={ pluginName }>
+\t\t\t\t{ title }
+\t\t\t</PluginSidebarMoreMenuItem>
+\t\t\t<PluginSidebar name={ pluginName } title={ title }>
+\t\t\t\t<div className="wp-typia-editor-plugin-shell">
+\t\t\t\t\t<PanelBody
+\t\t\t\t\t\tinitialOpen
+\t\t\t\t\t\ttitle={ __( 'Document workflow', ${quoteTsString(textDomain)} ) }
+\t\t\t\t\t>
+\t\t\t\t\t\t<p>{ sidebarModel.summary }</p>
+\t\t\t\t\t\t<Button variant="secondary">
+\t\t\t\t\t\t\t{ sidebarModel.primaryActionLabel }
+\t\t\t\t\t\t</Button>
+\t\t\t\t\t</PanelBody>
+\t\t\t\t</div>
+\t\t\t</PluginSidebar>
+\t\t</>
+\t);
+}
+`;
+}
+function buildEditorPluginEntrySource(editorPluginSlug, namespace, textDomain) {
+    const pascalName = toPascalCaseFromSlug(editorPluginSlug);
+    const componentName = `${pascalName}Sidebar`;
+    const pluginName = `${namespace}-${editorPluginSlug}`;
+    const pluginTitle = toTitleCase(editorPluginSlug);
+    return `import { registerPlugin } from '@wordpress/plugins';
+import { __ } from '@wordpress/i18n';
+
+import { REQUIRED_CAPABILITY } from './data';
+import { ${componentName} } from './Sidebar';
+
+const EDITOR_PLUGIN_NAME = ${quoteTsString(pluginName)};
+const EDITOR_PLUGIN_TITLE = __( ${quoteTsString(pluginTitle)}, ${quoteTsString(textDomain)} );
+
+registerPlugin( EDITOR_PLUGIN_NAME, {
+\ticon: 'admin-generic',
+\trender: () => (
+\t\t<${componentName}
+\t\t\tpluginName={ EDITOR_PLUGIN_NAME }
+\t\t\ttitle={ EDITOR_PLUGIN_TITLE }
+\t\t/>
+\t),
+} );
+
+export { REQUIRED_CAPABILITY };
+`;
+}
+function buildEditorPluginStyleSource() {
+    return `.wp-typia-editor-plugin-shell {
+\tpadding: 16px;
+}
+
+.wp-typia-editor-plugin-shell p {
+\tmargin: 0 0 12px;
+}
+`;
+}
 function buildBindingSourceIndexSource(bindingSourceSlugs) {
     const importLines = bindingSourceSlugs
         .map((bindingSourceSlug) => `import './${bindingSourceSlug}/editor';`)
         .join("\n");
     return `${importLines}${importLines ? "\n\n" : ""}// wp-typia add binding-source entries\n`;
 }
+function buildEditorPluginRegistrySource(editorPluginSlugs) {
+    const importLines = editorPluginSlugs
+        .map((editorPluginSlug) => `import './${editorPluginSlug}';`)
+        .join("\n");
+    return `${importLines}${importLines ? "\n\n" : ""}// wp-typia add editor-plugin entries\n`;
+}
 async function ensurePatternBootstrapAnchors(workspace) {
     const workspaceBaseName = workspace.packageName.split("/").pop() ?? workspace.packageName;
     const bootstrapPath = getWorkspaceBootstrapPath(workspace);
@@ -288,6 +479,138 @@ function ${bindingEditorEnqueueFunctionName}() {
         return nextSource;
     });
 }
+async function ensureEditorPluginBootstrapAnchors(workspace) {
+    const bootstrapPath = getWorkspaceBootstrapPath(workspace);
+    await patchFile(bootstrapPath, (source) => {
+        let nextSource = source;
+        const workspaceBaseName = workspace.packageName.split("/").pop() ?? workspace.packageName;
+        const enqueueFunctionName = `${workspace.workspace.phpPrefix}_enqueue_editor_plugins_editor`;
+        const enqueueHook = `add_action( 'enqueue_block_editor_assets', '${enqueueFunctionName}' );`;
+        const enqueueFunction = `
+
+function ${enqueueFunctionName}() {
+\t$script_path = __DIR__ . '/${EDITOR_PLUGIN_EDITOR_SCRIPT}';
+\t$asset_path  = __DIR__ . '/${EDITOR_PLUGIN_EDITOR_ASSET}';
+\t$style_path  = __DIR__ . '/${EDITOR_PLUGIN_EDITOR_STYLE}';
+\t$style_rtl_path = __DIR__ . '/${EDITOR_PLUGIN_EDITOR_STYLE_RTL}';
+
+\tif ( ! file_exists( $script_path ) || ! file_exists( $asset_path ) ) {
+\t\treturn;
+\t}
+
+\t$asset = require $asset_path;
+\tif ( ! is_array( $asset ) ) {
+\t\t$asset = array();
+\t}
+
+\twp_enqueue_script(
+\t\t'${workspaceBaseName}-editor-plugins',
+\t\tplugins_url( '${EDITOR_PLUGIN_EDITOR_SCRIPT}', __FILE__ ),
+\t\tisset( $asset['dependencies'] ) && is_array( $asset['dependencies'] ) ? $asset['dependencies'] : array(),
+\t\tisset( $asset['version'] ) ? $asset['version'] : filemtime( $script_path ),
+\t\ttrue
+\t);
+
+\tif ( file_exists( $style_path ) ) {
+\t\twp_enqueue_style(
+\t\t\t'${workspaceBaseName}-editor-plugins',
+\t\t\tplugins_url( '${EDITOR_PLUGIN_EDITOR_STYLE}', __FILE__ ),
+\t\t\tarray(),
+\t\t\tisset( $asset['version'] ) ? $asset['version'] : filemtime( $style_path )
+\t\t);
+\t\tif ( file_exists( $style_rtl_path ) ) {
+\t\t\twp_style_add_data( '${workspaceBaseName}-editor-plugins', 'rtl', 'replace' );
+\t\t}
+\t}
+}
+`;
+        const insertionAnchors = [
+            /add_action\(\s*["']init["']\s*,\s*["'][^"']+_load_textdomain["']\s*\);\s*\n/u,
+            /\?>\s*$/u,
+        ];
+        const hasPhpFunctionDefinition = (functionName) => new RegExp(`function\\s+${escapeRegex(functionName)}\\s*\\(`, "u").test(nextSource);
+        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(enqueueFunctionName)) {
+            insertPhpSnippet(enqueueFunction);
+        }
+        else {
+            const requiredReferences = [
+                EDITOR_PLUGIN_EDITOR_SCRIPT,
+                EDITOR_PLUGIN_EDITOR_ASSET,
+                EDITOR_PLUGIN_EDITOR_STYLE,
+                EDITOR_PLUGIN_EDITOR_STYLE_RTL,
+                "wp_style_add_data",
+            ];
+            const functionRange = findPhpFunctionRange(nextSource, enqueueFunctionName);
+            const functionSource = functionRange
+                ? nextSource.slice(functionRange.start, functionRange.end)
+                : "";
+            const missingReferences = requiredReferences.filter((reference) => !functionSource.includes(reference));
+            if (missingReferences.length > 0) {
+                const replacedSource = replacePhpFunctionDefinition(nextSource, enqueueFunctionName, enqueueFunction);
+                if (!replacedSource) {
+                    throw new Error(`Unable to repair ${path.basename(bootstrapPath)} for ${enqueueFunctionName}.`);
+                }
+                nextSource = replacedSource;
+            }
+        }
+        if (!nextSource.includes(enqueueHook)) {
+            appendPhpSnippet(enqueueHook);
+        }
+        return nextSource;
+    });
+}
+async function ensureEditorPluginBuildScriptAnchors(workspace) {
+    const buildScriptPath = path.join(workspace.projectDir, "scripts", "build-workspace.mjs");
+    await patchFile(buildScriptPath, (source) => {
+        if (/['"]src\/editor-plugins\/index\.(?:ts|js)['"]/u.test(source)) {
+            return source;
+        }
+        const legacySharedEntriesPattern = /\[\s*['"]src\/bindings\/index\.ts['"]\s*,\s*['"]src\/bindings\/index\.js['"]\s*(?:,\s*)?\]/u;
+        const nextSource = source.replace(legacySharedEntriesPattern, `[
+\t\t'src/bindings/index.ts',
+\t\t'src/bindings/index.js',
+\t\t'src/editor-plugins/index.ts',
+\t\t'src/editor-plugins/index.js',
+\t]`);
+        if (nextSource === source) {
+            throw new Error(`Unable to update ${path.relative(workspace.projectDir, buildScriptPath)} for editor plugin shared entries.`);
+        }
+        return nextSource;
+    });
+}
+async function ensureEditorPluginWebpackAnchors(workspace) {
+    const webpackConfigPath = path.join(workspace.projectDir, "webpack.config.js");
+    await patchFile(webpackConfigPath, (source) => {
+        if (/['"]editor-plugins\/index['"]/u.test(source)) {
+            return source;
+        }
+        const legacySharedEntriesBlockPattern = /for\s*\(\s*const\s+relativePath\s+of\s+\[\s*['"]src\/bindings\/index\.ts['"]\s*,\s*['"]src\/bindings\/index\.js['"]\s*(?:,\s*)?\]\s*\)\s*\{[\s\S]*?entries\.push\(\s*\[\s*['"]bindings\/index['"]\s*,\s*entryPath\s*\]\s*\);\s*break;\s*\}/u;
+        const nextSharedEntriesBlock = `\tfor ( const [ entryName, candidates ] of [\n\t\t[\n\t\t\t'bindings/index',\n\t\t\t[ 'src/bindings/index.ts', 'src/bindings/index.js' ],\n\t\t],\n\t\t[\n\t\t\t'editor-plugins/index',\n\t\t\t[ 'src/editor-plugins/index.ts', 'src/editor-plugins/index.js' ],\n\t\t],\n\t] ) {\n\t\tfor ( const relativePath of candidates ) {\n\t\t\tconst entryPath = path.resolve( process.cwd(), relativePath );\n\t\t\tif ( ! fs.existsSync( entryPath ) ) {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tentries.push( [ entryName, entryPath ] );\n\t\t\tbreak;\n\t\t}\n\t}`;
+        const nextSource = source.replace(legacySharedEntriesBlockPattern, nextSharedEntriesBlock);
+        if (nextSource === source) {
+            throw new Error(`Unable to update ${path.relative(workspace.projectDir, webpackConfigPath)} for editor plugin shared entries.`);
+        }
+        return nextSource;
+    });
+}
 function resolveBindingSourceRegistryPath(projectDir) {
     const bindingsDir = path.join(projectDir, "src", "bindings");
     return [path.join(bindingsDir, "index.ts"), path.join(bindingsDir, "index.js")].find((candidatePath) => fs.existsSync(candidatePath)) ?? path.join(bindingsDir, "index.ts");
@@ -303,6 +626,99 @@ async function writeBindingSourceRegistry(projectDir, bindingSourceSlug) {
     const nextBindingSourceSlugs = Array.from(new Set([...existingBindingSourceSlugs, bindingSourceSlug])).sort();
     await fsp.writeFile(bindingsIndexPath, buildBindingSourceIndexSource(nextBindingSourceSlugs), "utf8");
 }
+function resolveEditorPluginRegistryPath(projectDir) {
+    const editorPluginsDir = path.join(projectDir, "src", "editor-plugins");
+    return [
+        path.join(editorPluginsDir, "index.ts"),
+        path.join(editorPluginsDir, "index.js"),
+    ].find((candidatePath) => fs.existsSync(candidatePath)) ?? path.join(editorPluginsDir, "index.ts");
+}
+function readEditorPluginRegistrySlugs(registryPath) {
+    if (!fs.existsSync(registryPath)) {
+        return [];
+    }
+    const source = fs.readFileSync(registryPath, "utf8");
+    return Array.from(source.matchAll(/^\s*import\s+['"]\.\/([^/'"]+)(?:\/index(?:\.[cm]?[jt]sx?)?)?['"];?\s*$/gmu)).map((match) => match[1]);
+}
+async function writeEditorPluginRegistry(projectDir, editorPluginSlug) {
+    const editorPluginsDir = path.join(projectDir, "src", "editor-plugins");
+    const registryPath = resolveEditorPluginRegistryPath(projectDir);
+    await fsp.mkdir(editorPluginsDir, { recursive: true });
+    const existingEditorPluginSlugs = readWorkspaceInventory(projectDir).editorPlugins.map((entry) => entry.slug);
+    const existingRegistrySlugs = readEditorPluginRegistrySlugs(registryPath);
+    const nextEditorPluginSlugs = Array.from(new Set([...existingEditorPluginSlugs, ...existingRegistrySlugs, editorPluginSlug])).sort();
+    await fsp.writeFile(registryPath, buildEditorPluginRegistrySource(nextEditorPluginSlugs), "utf8");
+}
+/**
+ * Add one document-level editor plugin scaffold to an official workspace project.
+ *
+ * @param options Command options for the editor-plugin scaffold workflow.
+ * @param options.cwd Working directory used to resolve the nearest official workspace.
+ * Defaults to `process.cwd()`.
+ * @param options.editorPluginName Human-entered editor-plugin name that will be
+ * normalized and validated before files are written.
+ * @param options.slot Optional editor plugin shell slot. Defaults to `PluginSidebar`.
+ * @returns A promise that resolves with the normalized `editorPluginSlug`, chosen
+ * `slot`, and owning `projectDir` after the scaffold files and inventory entry
+ * are written successfully.
+ * @throws {Error} When the command is run outside an official workspace, when the
+ * slug or slot is invalid, or when a conflicting file or inventory entry exists.
+ */
+export async function runAddEditorPluginCommand({ cwd = process.cwd(), editorPluginName, slot, }) {
+    const workspace = resolveWorkspaceProject(cwd);
+    const editorPluginSlug = assertValidGeneratedSlug("Editor plugin name", normalizeBlockSlug(editorPluginName), "wp-typia add editor-plugin <name> [--slot <PluginSidebar>]");
+    const resolvedSlot = assertValidEditorPluginSlot(slot);
+    const inventory = readWorkspaceInventory(workspace.projectDir);
+    assertEditorPluginDoesNotExist(workspace.projectDir, editorPluginSlug, inventory);
+    const blockConfigPath = path.join(workspace.projectDir, "scripts", "block-config.ts");
+    const bootstrapPath = getWorkspaceBootstrapPath(workspace);
+    const buildScriptPath = path.join(workspace.projectDir, "scripts", "build-workspace.mjs");
+    const editorPluginsIndexPath = resolveEditorPluginRegistryPath(workspace.projectDir);
+    const webpackConfigPath = path.join(workspace.projectDir, "webpack.config.js");
+    const editorPluginDir = path.join(workspace.projectDir, "src", "editor-plugins", editorPluginSlug);
+    const entryFilePath = path.join(editorPluginDir, "index.tsx");
+    const sidebarFilePath = path.join(editorPluginDir, "Sidebar.tsx");
+    const dataFilePath = path.join(editorPluginDir, "data.ts");
+    const typesFilePath = path.join(editorPluginDir, "types.ts");
+    const styleFilePath = path.join(editorPluginDir, "style.scss");
+    const mutationSnapshot = {
+        fileSources: await snapshotWorkspaceFiles([
+            blockConfigPath,
+            bootstrapPath,
+            buildScriptPath,
+            editorPluginsIndexPath,
+            webpackConfigPath,
+        ]),
+        snapshotDirs: [],
+        targetPaths: [editorPluginDir],
+    };
+    try {
+        await fsp.mkdir(editorPluginDir, { recursive: true });
+        await ensureEditorPluginBootstrapAnchors(workspace);
+        await ensureEditorPluginBuildScriptAnchors(workspace);
+        await ensureEditorPluginWebpackAnchors(workspace);
+        await fsp.writeFile(entryFilePath, buildEditorPluginEntrySource(editorPluginSlug, workspace.workspace.namespace, workspace.workspace.textDomain), "utf8");
+        await fsp.writeFile(sidebarFilePath, buildEditorPluginSidebarSource(editorPluginSlug, workspace.workspace.textDomain), "utf8");
+        await fsp.writeFile(dataFilePath, buildEditorPluginDataSource(editorPluginSlug, resolvedSlot), "utf8");
+        await fsp.writeFile(typesFilePath, buildEditorPluginTypesSource(editorPluginSlug), "utf8");
+        await fsp.writeFile(styleFilePath, buildEditorPluginStyleSource(), "utf8");
+        await writeEditorPluginRegistry(workspace.projectDir, editorPluginSlug);
+        await appendWorkspaceInventoryEntries(workspace.projectDir, {
+            editorPluginEntries: [
+                buildEditorPluginConfigEntry(editorPluginSlug, resolvedSlot),
+            ],
+        });
+        return {
+            editorPluginSlug,
+            projectDir: workspace.projectDir,
+            slot: resolvedSlot,
+        };
+    }
+    catch (error) {
+        await rollbackWorkspaceMutation(mutationSnapshot);
+        throw error;
+    }
+}
 /**
  * Add one PHP block pattern shell to an official workspace project.
  *

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

@@ -0,0 +1,14 @@
+import { type RestResourceMethodId, type RunAddRestResourceCommandOptions } from "./cli-add-shared.js";
+/**
+ * Scaffold a workspace-level REST resource and synchronize its generated
+ * TypeScript and PHP artifacts.
+ *
+ * @param options Command options for the REST resource scaffold workflow.
+ * @returns Resolved scaffold metadata for the created REST resource.
+ */
+export declare function runAddRestResourceCommand({ cwd, methods, namespace, restResourceName, }: RunAddRestResourceCommandOptions): Promise<{
+    methods: RestResourceMethodId[];
+    namespace: string;
+    projectDir: string;
+    restResourceSlug: string;
+}>;