@wp-typia/project-tools 0.22.10 → 0.23.1

package/dist/runtime/cli-doctor-workspace-features-admin-views.js

@@ -0,0 +1,128 @@
+import fs from "node:fs";
+import path from "node:path";
+import { hasAdminViewManualSettingsRouteParameters, isAdminViewManualSettingsRestResource, } from "./cli-add-workspace-admin-view-types.js";
+import { checkExistingFiles, createDoctorCheck, resolveWorkspaceBootstrapPath, WORKSPACE_ADMIN_VIEW_ASSET, WORKSPACE_ADMIN_VIEW_GLOB, WORKSPACE_ADMIN_VIEW_SCRIPT, WORKSPACE_ADMIN_VIEW_STYLE, } from "./cli-doctor-workspace-shared.js";
+import { escapeRegex } from "./php-utils.js";
+function getWorkspaceAdminViewRequiredFiles(adminView) {
+    const adminViewDir = path.join("src", "admin-views", adminView.slug);
+    return Array.from(new Set([
+        adminView.file,
+        adminView.phpFile,
+        path.join(adminViewDir, "Screen.tsx"),
+        path.join(adminViewDir, "config.ts"),
+        path.join(adminViewDir, "data.ts"),
+        path.join(adminViewDir, "style.scss"),
+        path.join(adminViewDir, "types.ts"),
+    ]));
+}
+function checkWorkspaceAdminViewConfig(adminView, inventory) {
+    if (adminView.source === undefined) {
+        return createDoctorCheck(`Admin view config ${adminView.slug}`, "pass", "Admin view uses a replaceable local fetcher");
+    }
+    const source = adminView.source.trim();
+    const restSourceMatch = /^rest-resource:([a-z][a-z0-9-]*)$/u.exec(source);
+    const coreDataSourceMatch = /^core-data:(postType|taxonomy)\/([a-z0-9][a-z0-9_-]*)$/u.exec(source);
+    const restResourceSlug = restSourceMatch?.[1];
+    const restResource = restResourceSlug
+        ? inventory.restResources.find((entry) => entry.slug === restResourceSlug)
+        : undefined;
+    const isListCapableRestResource = Boolean(restResource?.methods.includes("list"));
+    const isManualSettingsRestResource = isAdminViewManualSettingsRestResource(restResource);
+    const hasManualSettingsRouteParameters = isManualSettingsRestResource &&
+        hasAdminViewManualSettingsRouteParameters(restResource);
+    const isValid = isListCapableRestResource ||
+        (isManualSettingsRestResource && !hasManualSettingsRouteParameters) ||
+        Boolean(coreDataSourceMatch);
+    const failDetail = hasManualSettingsRouteParameters
+        ? `Admin view source ${source} uses route parameters or regex groups and cannot scaffold a singleton settings form`
+        : "Admin view source must use rest-resource:<slug> with a list-capable REST resource, a manual settings contract with a body type, or core-data:<postType|taxonomy>/<name>";
+    return createDoctorCheck(`Admin view config ${adminView.slug}`, isValid ? "pass" : "fail", isValid
+        ? `Admin view source ${source} is ${isManualSettingsRestResource
+            ? "settings-form capable"
+            : coreDataSourceMatch
+                ? "core-data capable"
+                : "list-capable"}`
+        : failDetail);
+}
+function checkWorkspaceAdminViewBootstrap(projectDir, packageName, phpPrefix) {
+    const bootstrapPath = resolveWorkspaceBootstrapPath(projectDir, packageName);
+    if (!fs.existsSync(bootstrapPath)) {
+        return createDoctorCheck("Admin view bootstrap", "fail", `Missing ${path.basename(bootstrapPath)}`);
+    }
+    const source = fs.readFileSync(bootstrapPath, "utf8");
+    const loadFunctionName = `${phpPrefix}_load_admin_views`;
+    const loadHook = `add_action( 'plugins_loaded', '${loadFunctionName}' );`;
+    const hasLoaderHook = source.includes(loadHook);
+    const hasServerGlob = source.includes(WORKSPACE_ADMIN_VIEW_GLOB);
+    return createDoctorCheck("Admin view bootstrap", hasLoaderHook && hasServerGlob ? "pass" : "fail", hasLoaderHook && hasServerGlob
+        ? "Admin view PHP loader hook is present"
+        : "Missing admin view PHP require glob or plugins_loaded hook");
+}
+function checkWorkspaceAdminViewIndex(projectDir, adminViews) {
+    const indexRelativePath = [
+        path.join("src", "admin-views", "index.ts"),
+        path.join("src", "admin-views", "index.js"),
+    ].find((relativePath) => fs.existsSync(path.join(projectDir, relativePath)));
+    if (!indexRelativePath) {
+        return createDoctorCheck("Admin views index", "fail", "Missing src/admin-views/index.ts or src/admin-views/index.js");
+    }
+    const indexPath = path.join(projectDir, indexRelativePath);
+    const source = fs.readFileSync(indexPath, "utf8");
+    const missingImports = adminViews.filter((adminView) => {
+        const importPattern = new RegExp(`['"\`]\\./${escapeRegex(adminView.slug)}(?:/[^'"\`]*)?['"\`]`, "u");
+        return !importPattern.test(source);
+    });
+    return createDoctorCheck("Admin views index", missingImports.length === 0 ? "pass" : "fail", missingImports.length === 0
+        ? "Admin view registrations are aggregated"
+        : `Missing admin view imports for: ${missingImports
+            .map((entry) => entry.slug)
+            .join(", ")}`);
+}
+function checkWorkspaceAdminViewPhp(projectDir, adminView) {
+    const phpPath = path.join(projectDir, adminView.phpFile);
+    if (!fs.existsSync(phpPath)) {
+        return createDoctorCheck(`Admin view PHP ${adminView.slug}`, "fail", `Missing ${adminView.phpFile}`);
+    }
+    const source = fs.readFileSync(phpPath, "utf8");
+    const hasAdminMenu = source.includes("add_submenu_page");
+    const hasAdminEnqueue = source.includes("admin_enqueue_scripts");
+    const hasScript = source.includes(WORKSPACE_ADMIN_VIEW_SCRIPT);
+    const hasAsset = source.includes(WORKSPACE_ADMIN_VIEW_ASSET);
+    const hasStyle = source.includes(WORKSPACE_ADMIN_VIEW_STYLE);
+    const hasComponentsStyleDependency = /['"]wp-components['"]/u.test(source);
+    return createDoctorCheck(`Admin view PHP ${adminView.slug}`, hasAdminMenu &&
+        hasAdminEnqueue &&
+        hasScript &&
+        hasAsset &&
+        hasStyle &&
+        hasComponentsStyleDependency
+        ? "pass"
+        : "fail", hasAdminMenu &&
+        hasAdminEnqueue &&
+        hasScript &&
+        hasAsset &&
+        hasStyle &&
+        hasComponentsStyleDependency
+        ? "Admin menu, script, style, and wp-components style dependency are wired"
+        : "Missing admin menu, enqueue hook, build/admin-views asset reference, or wp-components style dependency");
+}
+/**
+ * Collect admin view workspace doctor checks while preserving existing row order.
+ *
+ * @param workspace Resolved workspace metadata and filesystem paths.
+ * @param inventory Parsed workspace inventory from `scripts/block-config.ts`.
+ * @returns Ordered admin view doctor checks.
+ */
+export function getWorkspaceAdminViewDoctorChecks(workspace, inventory) {
+    const checks = [];
+    if (inventory.adminViews.length > 0) {
+        checks.push(checkWorkspaceAdminViewBootstrap(workspace.projectDir, workspace.packageName, workspace.workspace.phpPrefix));
+        checks.push(checkWorkspaceAdminViewIndex(workspace.projectDir, inventory.adminViews));
+    }
+    for (const adminView of inventory.adminViews) {
+        checks.push(checkWorkspaceAdminViewConfig(adminView, inventory));
+        checks.push(checkExistingFiles(workspace.projectDir, `Admin view ${adminView.slug}`, getWorkspaceAdminViewRequiredFiles(adminView)));
+        checks.push(checkWorkspaceAdminViewPhp(workspace.projectDir, adminView));
+    }
+    return checks;
+}

package/dist/runtime/cli-doctor-workspace-features-ai.d.ts

@@ -0,0 +1,11 @@
+import type { DoctorCheck } from "./cli-doctor.js";
+import type { WorkspaceInventory } from "./workspace-inventory.js";
+import type { WorkspaceProject } from "./workspace-project.js";
+/**
+ * Collect AI feature workspace doctor checks while preserving existing row order.
+ *
+ * @param workspace Resolved workspace metadata and filesystem paths.
+ * @param aiFeatures AI feature entries parsed from the workspace inventory.
+ * @returns Ordered AI feature doctor checks.
+ */
+export declare function getWorkspaceAiFeatureDoctorChecks(workspace: WorkspaceProject, aiFeatures: WorkspaceInventory["aiFeatures"]): DoctorCheck[];

package/dist/runtime/cli-doctor-workspace-features-ai.js

@@ -0,0 +1,57 @@
+import fs from "node:fs";
+import path from "node:path";
+import { REST_RESOURCE_NAMESPACE_PATTERN } from "./cli-add-shared.js";
+import { checkExistingFiles, createDoctorCheck, resolveWorkspaceBootstrapPath, WORKSPACE_AI_FEATURE_GLOB, } from "./cli-doctor-workspace-shared.js";
+function getWorkspaceAiFeatureRequiredFiles(aiFeature) {
+    return Array.from(new Set([
+        aiFeature.aiSchemaFile,
+        aiFeature.apiFile,
+        path.join(path.dirname(aiFeature.typesFile), "api-schemas", "feature-request.schema.json"),
+        path.join(path.dirname(aiFeature.typesFile), "api-schemas", "feature-response.schema.json"),
+        path.join(path.dirname(aiFeature.typesFile), "api-schemas", "feature-result.schema.json"),
+        aiFeature.clientFile,
+        aiFeature.dataFile,
+        aiFeature.openApiFile,
+        aiFeature.phpFile,
+        aiFeature.typesFile,
+        aiFeature.validatorsFile,
+    ]));
+}
+function checkWorkspaceAiFeatureConfig(aiFeature) {
+    const hasNamespace = REST_RESOURCE_NAMESPACE_PATTERN.test(aiFeature.namespace);
+    return createDoctorCheck(`AI feature config ${aiFeature.slug}`, hasNamespace ? "pass" : "fail", hasNamespace
+        ? `AI feature namespace ${aiFeature.namespace} is valid`
+        : "AI feature namespace is invalid");
+}
+function checkWorkspaceAiFeatureBootstrap(projectDir, packageName, phpPrefix) {
+    const bootstrapPath = resolveWorkspaceBootstrapPath(projectDir, packageName);
+    if (!fs.existsSync(bootstrapPath)) {
+        return createDoctorCheck("AI feature bootstrap", "fail", `Missing ${path.basename(bootstrapPath)}`);
+    }
+    const source = fs.readFileSync(bootstrapPath, "utf8");
+    const registerFunctionName = `${phpPrefix}_register_ai_features`;
+    const registerHook = `add_action( 'init', '${registerFunctionName}', 20 );`;
+    const hasServerGlob = source.includes(WORKSPACE_AI_FEATURE_GLOB);
+    const hasRegisterHook = source.includes(registerHook);
+    return createDoctorCheck("AI feature bootstrap", hasServerGlob && hasRegisterHook ? "pass" : "fail", hasServerGlob && hasRegisterHook
+        ? "AI feature PHP loader hook is present"
+        : "Missing AI feature PHP require glob or init hook");
+}
+/**
+ * Collect AI feature workspace doctor checks while preserving existing row order.
+ *
+ * @param workspace Resolved workspace metadata and filesystem paths.
+ * @param aiFeatures AI feature entries parsed from the workspace inventory.
+ * @returns Ordered AI feature doctor checks.
+ */
+export function getWorkspaceAiFeatureDoctorChecks(workspace, aiFeatures) {
+    const checks = [];
+    if (aiFeatures.length > 0) {
+        checks.push(checkWorkspaceAiFeatureBootstrap(workspace.projectDir, workspace.packageName, workspace.workspace.phpPrefix));
+    }
+    for (const aiFeature of aiFeatures) {
+        checks.push(checkWorkspaceAiFeatureConfig(aiFeature));
+        checks.push(checkExistingFiles(workspace.projectDir, `AI feature ${aiFeature.slug}`, getWorkspaceAiFeatureRequiredFiles(aiFeature)));
+    }
+    return checks;
+}

package/dist/runtime/cli-doctor-workspace-features-editor-plugins.d.ts

@@ -0,0 +1,11 @@
+import type { DoctorCheck } from "./cli-doctor.js";
+import type { WorkspaceInventory } from "./workspace-inventory.js";
+import type { WorkspaceProject } from "./workspace-project.js";
+/**
+ * Collect editor plugin workspace doctor checks while preserving existing row order.
+ *
+ * @param workspace Resolved workspace metadata and filesystem paths.
+ * @param editorPlugins Editor plugin entries parsed from the workspace inventory.
+ * @returns Ordered editor plugin doctor checks.
+ */
+export declare function getWorkspaceEditorPluginDoctorChecks(workspace: WorkspaceProject, editorPlugins: WorkspaceInventory["editorPlugins"]): DoctorCheck[];

package/dist/runtime/cli-doctor-workspace-features-editor-plugins.js

@@ -0,0 +1,80 @@
+import fs from "node:fs";
+import path from "node:path";
+import { EDITOR_PLUGIN_SLOT_IDS, resolveEditorPluginSlotAlias, } from "./cli-add-shared.js";
+import { checkExistingFiles, createDoctorCheck, resolveWorkspaceBootstrapPath, WORKSPACE_EDITOR_PLUGIN_EDITOR_ASSET, WORKSPACE_EDITOR_PLUGIN_EDITOR_SCRIPT, WORKSPACE_EDITOR_PLUGIN_EDITOR_STYLE, } from "./cli-doctor-workspace-shared.js";
+import { escapeRegex } from "./php-utils.js";
+function getWorkspaceEditorPluginRequiredFiles(editorPlugin) {
+    const editorPluginDir = path.join("src", "editor-plugins", editorPlugin.slug);
+    const surfaceFile = editorPlugin.slot === "PluginSidebar"
+        ? path.join(editorPluginDir, "Sidebar.tsx")
+        : path.join(editorPluginDir, "Surface.tsx");
+    return Array.from(new Set([
+        editorPlugin.file,
+        surfaceFile,
+        path.join(editorPluginDir, "data.ts"),
+        path.join(editorPluginDir, "types.ts"),
+        path.join(editorPluginDir, "style.scss"),
+    ]));
+}
+function checkWorkspaceEditorPluginConfig(editorPlugin) {
+    const normalizedSlot = resolveEditorPluginSlotAlias(editorPlugin.slot);
+    const isValidSlot = Boolean(normalizedSlot);
+    return createDoctorCheck(`Editor plugin config ${editorPlugin.slug}`, isValidSlot ? "pass" : "fail", isValidSlot
+        ? `Editor plugin slot ${editorPlugin.slot} is supported as ${normalizedSlot}`
+        : `Unsupported editor plugin slot "${editorPlugin.slot}". Expected one of: ${EDITOR_PLUGIN_SLOT_IDS.join(", ")} or legacy aliases PluginSidebar, PluginDocumentSettingPanel.`);
+}
+function checkWorkspaceEditorPluginBootstrap(projectDir, packageName, phpPrefix) {
+    const bootstrapPath = resolveWorkspaceBootstrapPath(projectDir, packageName);
+    if (!fs.existsSync(bootstrapPath)) {
+        return createDoctorCheck("Editor plugin bootstrap", "fail", `Missing ${path.basename(bootstrapPath)}`);
+    }
+    const source = fs.readFileSync(bootstrapPath, "utf8");
+    const enqueueFunctionName = `${phpPrefix}_enqueue_editor_plugins_editor`;
+    const enqueueHook = `add_action( 'enqueue_block_editor_assets', '${enqueueFunctionName}' );`;
+    const hasEditorEnqueueHook = source.includes(enqueueHook);
+    const hasEditorScript = source.includes(WORKSPACE_EDITOR_PLUGIN_EDITOR_SCRIPT);
+    const hasEditorAsset = source.includes(WORKSPACE_EDITOR_PLUGIN_EDITOR_ASSET);
+    const hasEditorStyle = source.includes(WORKSPACE_EDITOR_PLUGIN_EDITOR_STYLE);
+    return createDoctorCheck("Editor plugin bootstrap", hasEditorEnqueueHook && hasEditorScript && hasEditorAsset && hasEditorStyle ? "pass" : "fail", hasEditorEnqueueHook && hasEditorScript && hasEditorAsset && hasEditorStyle
+        ? "Editor plugin enqueue hook is present"
+        : "Missing editor plugin enqueue hook or build/editor-plugins script/style asset references");
+}
+function checkWorkspaceEditorPluginIndex(projectDir, editorPlugins) {
+    const indexRelativePath = [
+        path.join("src", "editor-plugins", "index.ts"),
+        path.join("src", "editor-plugins", "index.js"),
+    ].find((relativePath) => fs.existsSync(path.join(projectDir, relativePath)));
+    if (!indexRelativePath) {
+        return createDoctorCheck("Editor plugins index", "fail", "Missing src/editor-plugins/index.ts or src/editor-plugins/index.js");
+    }
+    const indexPath = path.join(projectDir, indexRelativePath);
+    const source = fs.readFileSync(indexPath, "utf8");
+    const missingImports = editorPlugins.filter((editorPlugin) => {
+        const importPattern = new RegExp(`['"\`]\\./${escapeRegex(editorPlugin.slug)}(?:/[^'"\`]*)?['"\`]`, "u");
+        return !importPattern.test(source);
+    });
+    return createDoctorCheck("Editor plugins index", missingImports.length === 0 ? "pass" : "fail", missingImports.length === 0
+        ? "Editor plugin registrations are aggregated"
+        : `Missing editor plugin imports for: ${missingImports
+            .map((entry) => entry.slug)
+            .join(", ")}`);
+}
+/**
+ * Collect editor plugin workspace doctor checks while preserving existing row order.
+ *
+ * @param workspace Resolved workspace metadata and filesystem paths.
+ * @param editorPlugins Editor plugin entries parsed from the workspace inventory.
+ * @returns Ordered editor plugin doctor checks.
+ */
+export function getWorkspaceEditorPluginDoctorChecks(workspace, editorPlugins) {
+    const checks = [];
+    if (editorPlugins.length > 0) {
+        checks.push(checkWorkspaceEditorPluginBootstrap(workspace.projectDir, workspace.packageName, workspace.workspace.phpPrefix));
+        checks.push(checkWorkspaceEditorPluginIndex(workspace.projectDir, editorPlugins));
+    }
+    for (const editorPlugin of editorPlugins) {
+        checks.push(checkExistingFiles(workspace.projectDir, `Editor plugin ${editorPlugin.slug}`, getWorkspaceEditorPluginRequiredFiles(editorPlugin)));
+        checks.push(checkWorkspaceEditorPluginConfig(editorPlugin));
+    }
+    return checks;
+}

package/dist/runtime/cli-doctor-workspace-features-post-meta.d.ts

@@ -0,0 +1,11 @@
+import type { DoctorCheck } from "./cli-doctor.js";
+import type { WorkspaceInventory } from "./workspace-inventory.js";
+import type { WorkspaceProject } from "./workspace-project.js";
+/**
+ * Collect post meta workspace doctor checks while preserving existing row order.
+ *
+ * @param workspace Resolved workspace metadata and filesystem paths.
+ * @param postMetaEntries Post meta entries parsed from the workspace inventory.
+ * @returns Ordered post meta doctor checks.
+ */
+export declare function getWorkspacePostMetaDoctorChecks(workspace: WorkspaceProject, postMetaEntries: WorkspaceInventory["postMeta"]): DoctorCheck[];

package/dist/runtime/cli-doctor-workspace-features-post-meta.js

@@ -0,0 +1,77 @@
+import fs from "node:fs";
+import path from "node:path";
+import { assertValidPostMetaPostType } from "./cli-add-shared.js";
+import { checkExistingFiles, createDoctorCheck, resolveWorkspaceBootstrapPath, WORKSPACE_POST_META_GLOB, } from "./cli-doctor-workspace-shared.js";
+function getWorkspacePostMetaRequiredFiles(postMeta) {
+    return Array.from(new Set([
+        postMeta.phpFile,
+        postMeta.schemaFile,
+        postMeta.typesFile,
+    ]));
+}
+function checkWorkspacePostMetaConfig(postMeta) {
+    let hasPostType = false;
+    try {
+        hasPostType = assertValidPostMetaPostType(postMeta.postType) === postMeta.postType;
+    }
+    catch {
+        hasPostType = false;
+    }
+    const hasMetaKey = typeof postMeta.metaKey === "string" &&
+        postMeta.metaKey.trim().length > 0 &&
+        !/\s/u.test(postMeta.metaKey);
+    const hasRestExposure = typeof postMeta.showInRest === "boolean";
+    return createDoctorCheck(`Post meta config ${postMeta.slug}`, hasPostType && hasMetaKey && hasRestExposure ? "pass" : "fail", hasPostType && hasMetaKey && hasRestExposure
+        ? `Post meta ${postMeta.metaKey} targets ${postMeta.postType}`
+        : "Post meta postType, metaKey, or showInRest configuration is invalid");
+}
+function checkWorkspacePostMetaBootstrap(projectDir, packageName, phpPrefix) {
+    const bootstrapPath = resolveWorkspaceBootstrapPath(projectDir, packageName);
+    if (!fs.existsSync(bootstrapPath)) {
+        return createDoctorCheck("Post meta bootstrap", "fail", `Missing ${path.basename(bootstrapPath)}`);
+    }
+    const source = fs.readFileSync(bootstrapPath, "utf8");
+    const registerFunctionName = `${phpPrefix}_register_post_meta_contracts`;
+    const registerHook = `add_action( 'init', '${registerFunctionName}', 20 );`;
+    const hasServerGlob = source.includes(WORKSPACE_POST_META_GLOB);
+    const hasRegisterHook = source.includes(registerHook);
+    return createDoctorCheck("Post meta bootstrap", hasServerGlob && hasRegisterHook ? "pass" : "fail", hasServerGlob && hasRegisterHook
+        ? "Post meta PHP loader hook is present"
+        : "Missing post meta PHP require glob or init hook");
+}
+function checkWorkspacePostMetaPhp(projectDir, postMeta) {
+    const phpPath = path.join(projectDir, postMeta.phpFile);
+    if (!fs.existsSync(phpPath)) {
+        return createDoctorCheck(`Post meta PHP ${postMeta.slug}`, "fail", `Missing ${postMeta.phpFile}`);
+    }
+    const source = fs.readFileSync(phpPath, "utf8");
+    const hasRegisterPostMeta = source.includes("register_post_meta");
+    const hasPostType = source.includes(postMeta.postType);
+    const hasMetaKey = source.includes(postMeta.metaKey);
+    const hasSchemaFile = source.includes(postMeta.schemaFile);
+    const hasRestExposure = source.includes("'show_in_rest'");
+    return createDoctorCheck(`Post meta PHP ${postMeta.slug}`, hasRegisterPostMeta && hasPostType && hasMetaKey && hasSchemaFile && hasRestExposure
+        ? "pass"
+        : "fail", hasRegisterPostMeta && hasPostType && hasMetaKey && hasSchemaFile && hasRestExposure
+        ? "Post meta registration, schema path, and REST exposure flag are wired"
+        : "Missing register_post_meta, post type, meta key, schema path, or show_in_rest wiring");
+}
+/**
+ * Collect post meta workspace doctor checks while preserving existing row order.
+ *
+ * @param workspace Resolved workspace metadata and filesystem paths.
+ * @param postMetaEntries Post meta entries parsed from the workspace inventory.
+ * @returns Ordered post meta doctor checks.
+ */
+export function getWorkspacePostMetaDoctorChecks(workspace, postMetaEntries) {
+    const checks = [];
+    if (postMetaEntries.length > 0) {
+        checks.push(checkWorkspacePostMetaBootstrap(workspace.projectDir, workspace.packageName, workspace.workspace.phpPrefix));
+    }
+    for (const postMeta of postMetaEntries) {
+        checks.push(checkWorkspacePostMetaConfig(postMeta));
+        checks.push(checkExistingFiles(workspace.projectDir, `Post meta ${postMeta.slug}`, getWorkspacePostMetaRequiredFiles(postMeta)));
+        checks.push(checkWorkspacePostMetaPhp(workspace.projectDir, postMeta));
+    }
+    return checks;
+}

package/dist/runtime/cli-doctor-workspace-features-rest.d.ts

@@ -0,0 +1,11 @@
+import type { DoctorCheck } from "./cli-doctor.js";
+import type { WorkspaceInventory } from "./workspace-inventory.js";
+import type { WorkspaceProject } from "./workspace-project.js";
+/**
+ * Collect REST resource workspace doctor checks while preserving existing row order.
+ *
+ * @param workspace Resolved workspace metadata and filesystem paths.
+ * @param restResources REST resources parsed from the workspace inventory.
+ * @returns Ordered REST resource doctor checks.
+ */
+export declare function getWorkspaceRestResourceDoctorChecks(workspace: WorkspaceProject, restResources: WorkspaceInventory["restResources"]): DoctorCheck[];

package/dist/runtime/cli-doctor-workspace-features-rest.js

@@ -0,0 +1,120 @@
+import fs from "node:fs";
+import path from "node:path";
+import { MANUAL_REST_CONTRACT_AUTH_IDS, MANUAL_REST_CONTRACT_HTTP_METHOD_IDS, REST_RESOURCE_METHOD_IDS, REST_RESOURCE_NAMESPACE_PATTERN, isGeneratedRestResourceRoutePatternCompatible, } from "./cli-add-shared.js";
+import { checkExistingFiles, createDoctorCheck, resolveWorkspaceBootstrapPath, WORKSPACE_REST_RESOURCE_GLOB, } from "./cli-doctor-workspace-shared.js";
+function isManualRestResource(restResource) {
+    return restResource.mode === "manual";
+}
+function getWorkspaceRestResourceRequiredFiles(restResource) {
+    const schemaNames = new Set();
+    if (isManualRestResource(restResource)) {
+        schemaNames.add("query");
+        if (restResource.bodyTypeName) {
+            schemaNames.add("request");
+        }
+        schemaNames.add("response");
+        return Array.from(new Set([
+            restResource.apiFile,
+            ...Array.from(schemaNames, (schemaName) => path.join(path.dirname(restResource.typesFile), "api-schemas", `${schemaName}.schema.json`)),
+            restResource.clientFile,
+            restResource.openApiFile,
+            restResource.typesFile,
+            restResource.validatorsFile,
+        ]));
+    }
+    if (restResource.methods.includes("list")) {
+        schemaNames.add("list-query");
+        schemaNames.add("list-response");
+    }
+    if (restResource.methods.includes("read")) {
+        schemaNames.add("read-query");
+        schemaNames.add("read-response");
+    }
+    if (restResource.methods.includes("create")) {
+        schemaNames.add("create-request");
+        schemaNames.add("create-response");
+    }
+    if (restResource.methods.includes("update")) {
+        schemaNames.add("update-query");
+        schemaNames.add("update-request");
+        schemaNames.add("update-response");
+    }
+    if (restResource.methods.includes("delete")) {
+        schemaNames.add("delete-query");
+        schemaNames.add("delete-response");
+    }
+    return Array.from(new Set([
+        restResource.apiFile,
+        ...Array.from(schemaNames, (schemaName) => path.join(path.dirname(restResource.typesFile), "api-schemas", `${schemaName}.schema.json`)),
+        restResource.clientFile,
+        ...(restResource.dataFile ? [restResource.dataFile] : []),
+        restResource.openApiFile,
+        ...(restResource.phpFile ? [restResource.phpFile] : []),
+        restResource.typesFile,
+        restResource.validatorsFile,
+    ]));
+}
+function checkWorkspaceRestResourceConfig(restResource) {
+    const hasNamespace = REST_RESOURCE_NAMESPACE_PATTERN.test(restResource.namespace);
+    if (isManualRestResource(restResource)) {
+        const hasAuth = restResource.auth == null ||
+            MANUAL_REST_CONTRACT_AUTH_IDS.includes(restResource.auth);
+        const hasMethod = typeof restResource.method === "string" &&
+            MANUAL_REST_CONTRACT_HTTP_METHOD_IDS.includes(restResource.method);
+        const hasPathPattern = typeof restResource.pathPattern === "string" &&
+            restResource.pathPattern.startsWith("/") &&
+            restResource.pathPattern.length > 1;
+        return createDoctorCheck(`REST resource config ${restResource.slug}`, hasNamespace && hasAuth && hasMethod && hasPathPattern ? "pass" : "fail", hasNamespace && hasAuth && hasMethod && hasPathPattern
+            ? `Manual REST contract ${restResource.method} /${restResource.namespace}${restResource.pathPattern}`
+            : "Manual REST contract namespace, auth, method, or path pattern is invalid");
+    }
+    const hasMethods = restResource.methods.length > 0 &&
+        restResource.methods.every((method) => REST_RESOURCE_METHOD_IDS.includes(method));
+    const hasGeneratedFiles = typeof restResource.dataFile === "string" &&
+        restResource.dataFile.length > 0 &&
+        typeof restResource.phpFile === "string" &&
+        restResource.phpFile.length > 0;
+    const hasRoutePattern = restResource.routePattern == null ||
+        (typeof restResource.routePattern === "string" &&
+            restResource.routePattern.startsWith("/") &&
+            restResource.routePattern.length > 1 &&
+            !/\s/u.test(restResource.routePattern) &&
+            isGeneratedRestResourceRoutePatternCompatible(restResource.routePattern));
+    return createDoctorCheck(`REST resource config ${restResource.slug}`, hasNamespace && hasMethods && hasGeneratedFiles && hasRoutePattern
+        ? "pass"
+        : "fail", hasNamespace && hasMethods && hasGeneratedFiles && hasRoutePattern
+        ? `REST resource namespace ${restResource.namespace} with methods ${restResource.methods.join(", ")}`
+        : "REST resource namespace, methods, dataFile, phpFile, or routePattern are invalid");
+}
+function checkWorkspaceRestResourceBootstrap(projectDir, packageName, phpPrefix) {
+    const bootstrapPath = resolveWorkspaceBootstrapPath(projectDir, packageName);
+    if (!fs.existsSync(bootstrapPath)) {
+        return createDoctorCheck("REST resource bootstrap", "fail", `Missing ${path.basename(bootstrapPath)}`);
+    }
+    const source = fs.readFileSync(bootstrapPath, "utf8");
+    const registerFunctionName = `${phpPrefix}_register_rest_resources`;
+    const registerHook = `add_action( 'init', '${registerFunctionName}', 20 );`;
+    const hasServerGlob = source.includes(WORKSPACE_REST_RESOURCE_GLOB);
+    const hasRegisterHook = source.includes(registerHook);
+    return createDoctorCheck("REST resource bootstrap", hasServerGlob && hasRegisterHook ? "pass" : "fail", hasServerGlob && hasRegisterHook
+        ? "REST resource PHP loader hook is present"
+        : "Missing REST resource PHP require glob or init hook");
+}
+/**
+ * Collect REST resource workspace doctor checks while preserving existing row order.
+ *
+ * @param workspace Resolved workspace metadata and filesystem paths.
+ * @param restResources REST resources parsed from the workspace inventory.
+ * @returns Ordered REST resource doctor checks.
+ */
+export function getWorkspaceRestResourceDoctorChecks(workspace, restResources) {
+    const checks = [];
+    if (restResources.some((restResource) => !isManualRestResource(restResource))) {
+        checks.push(checkWorkspaceRestResourceBootstrap(workspace.projectDir, workspace.packageName, workspace.workspace.phpPrefix));
+    }
+    for (const restResource of restResources) {
+        checks.push(checkWorkspaceRestResourceConfig(restResource));
+        checks.push(checkExistingFiles(workspace.projectDir, `REST resource ${restResource.slug}`, getWorkspaceRestResourceRequiredFiles(restResource)));
+    }
+    return checks;
+}