@wp-typia/project-tools 0.22.10 → 0.23.1

package/dist/runtime/cli-doctor-workspace-blocks.js

@@ -1,371 +1,6 @@
-import fs from "node:fs";
-import path from "node:path";
-import { parseScaffoldBlockMetadata } from "@wp-typia/block-runtime/blocks";
-import { checkExistingFiles, createDoctorCheck, resolveWorkspaceBootstrapPath, WORKSPACE_FULL_BLOCK_NAME_PATTERN, WORKSPACE_GENERATED_BLOCK_ARTIFACTS, } from "./cli-doctor-workspace-shared.js";
-import { HOOKED_BLOCK_ANCHOR_PATTERN, HOOKED_BLOCK_POSITION_SET, } from "./hooked-blocks.js";
-import { hasExecutablePattern, hasUncommentedPattern, maskTypeScriptCommentsAndLiterals, } from "./ts-source-masking.js";
-const WORKSPACE_COLLECTION_IMPORT_LINE = "import '../../collection';";
-const WORKSPACE_COLLECTION_IMPORT_PATTERN = /^\s*import\s+["']\.\.\/\.\.\/collection["']\s*;?\s*$/m;
-const WORKSPACE_VARIATIONS_IMPORT_PATTERN = /^\s*import\s*\{\s*registerWorkspaceVariations\s*\}\s*from\s*["']\.\/variations["']\s*;?\s*$/mu;
-const WORKSPACE_VARIATIONS_CALL_PATTERN = /registerWorkspaceVariations\s*\(\s*\)\s*;?/u;
-const WORKSPACE_BLOCK_STYLES_IMPORT_PATTERN = /^\s*import\s*\{\s*registerWorkspaceBlockStyles\s*\}\s*from\s*["']\.\/styles["']\s*;?\s*$/mu;
-const WORKSPACE_BLOCK_STYLES_CALL_PATTERN = /registerWorkspaceBlockStyles\s*\(\s*\)\s*;?/u;
-const WORKSPACE_BLOCK_TRANSFORMS_IMPORT_PATTERN = /^\s*import\s*\{\s*applyWorkspaceBlockTransforms\s*\}\s*from\s*["']\.\/transforms["']\s*;?\s*$/mu;
-const WORKSPACE_BLOCK_TRANSFORMS_CALL_PATTERN = /applyWorkspaceBlockTransforms\s*\(\s*registration\s*\.\s*settings\s*\)\s*;?/u;
-const WORKSPACE_BLOCK_IFRAME_COMPATIBILITY_DOC_URL = "https://developer.wordpress.org/block-editor/reference-guides/block-api/block-api-versions/block-migration-for-iframe-editor-compatibility/";
-const WORKSPACE_BLOCK_IFRAME_DIAGNOSTIC_CODES = {
-    API_VERSION: "wp-typia.workspace.block.iframe.api-version",
-    BLOCK_PROPS: "wp-typia.workspace.block.iframe.block-props",
-    EDITOR_GLOBALS: "wp-typia.workspace.block.iframe.editor-globals",
-    EDITOR_STYLES: "wp-typia.workspace.block.iframe.editor-styles",
-};
-const WORKSPACE_BLOCK_EDITOR_SOURCE_FILE_PATTERN = /\.[cm]?[jt]sx?$/u;
-const WORKSPACE_BLOCK_EDITOR_SOURCE_BASENAMES = new Set([
-    "edit",
-    "editor",
-    "index",
-    "save",
-]);
-const WORKSPACE_BLOCK_EDITOR_SOURCE_DIRECTORIES = new Set([
-    "components",
-    "controls",
-    "editor",
-    "inspector",
-]);
-const WORKSPACE_BLOCK_LOCAL_STYLE_FILES = [
-    "editor.css",
-    "editor.scss",
-    "index.css",
-    "style.css",
-    "style.scss",
-];
-const WORKSPACE_BLOCK_IFRAME_GLOBAL_DOM_PATTERN = /\b(?:document|window)\b|\b(?:parent|top)\b(?!\s*:)/gu;
-const WORKSPACE_BLOCK_PROPS_PATTERN = /\buse(?:Block|InnerBlocks)Props(?:\.save)?\s*\(/u;
-function normalizePathSeparators(relativePath) {
-    return relativePath.split(path.sep).join("/");
-}
-function hasRegisteredBlockAsset(value) {
-    if (typeof value === "string") {
-        return value.trim().length > 0;
-    }
-    if (Array.isArray(value)) {
-        return value.some((entry) => hasRegisteredBlockAsset(entry));
-    }
-    return false;
-}
-function readWorkspaceBlockIframeMetadata(projectDir, blockSlug) {
-    const blockJsonRelativePath = path.join("src", "blocks", blockSlug, "block.json");
-    const blockJsonPath = path.join(projectDir, blockJsonRelativePath);
-    if (!fs.existsSync(blockJsonPath)) {
-        return {
-            blockJsonRelativePath,
-            error: `Missing ${blockJsonRelativePath}`,
-        };
-    }
-    try {
-        const document = parseScaffoldBlockMetadata(JSON.parse(fs.readFileSync(blockJsonPath, "utf8")));
-        return {
-            blockJsonRelativePath,
-            document,
-        };
-    }
-    catch (error) {
-        return {
-            blockJsonRelativePath,
-            error: error instanceof Error ? error.message : String(error),
-        };
-    }
-}
-function isWorkspaceBlockEditorSource(relativePath) {
-    if (!WORKSPACE_BLOCK_EDITOR_SOURCE_FILE_PATTERN.test(relativePath)) {
-        return false;
-    }
-    const normalizedRelativePath = normalizePathSeparators(relativePath);
-    const normalizedDirName = path.posix.dirname(normalizedRelativePath);
-    const normalizedBaseName = path.posix.basename(normalizedRelativePath, path.posix.extname(normalizedRelativePath));
-    if (WORKSPACE_BLOCK_EDITOR_SOURCE_BASENAMES.has(normalizedBaseName)) {
-        return true;
-    }
-    const pathSegments = normalizedDirName.split("/");
-    return pathSegments.some((segment) => WORKSPACE_BLOCK_EDITOR_SOURCE_DIRECTORIES.has(segment));
-}
-function isWorkspaceBlockSaveSource(relativePath) {
-    const normalizedBaseName = path.basename(relativePath, path.extname(relativePath));
-    return normalizedBaseName === "save";
-}
-function collectWorkspaceBlockEditorSources(projectDir, blockSlug) {
-    const blockDir = path.join(projectDir, "src", "blocks", blockSlug);
-    if (!fs.existsSync(blockDir)) {
-        return [];
-    }
-    const collected = [];
-    const queue = [blockDir];
-    while (queue.length > 0) {
-        const currentDir = queue.pop();
-        if (!currentDir) {
-            continue;
-        }
-        for (const entry of fs.readdirSync(currentDir, { withFileTypes: true })) {
-            const absolutePath = path.join(currentDir, entry.name);
-            if (entry.isDirectory()) {
-                queue.push(absolutePath);
-                continue;
-            }
-            if (!entry.isFile()) {
-                continue;
-            }
-            const relativePath = path.relative(projectDir, absolutePath);
-            if (!isWorkspaceBlockEditorSource(relativePath)) {
-                continue;
-            }
-            collected.push({
-                relativePath: normalizePathSeparators(relativePath),
-                source: fs.readFileSync(absolutePath, "utf8"),
-            });
-        }
-    }
-    return collected.sort((left, right) => left.relativePath.localeCompare(right.relativePath));
-}
-function getSourceLineNumber(source, index) {
-    let line = 1;
-    for (let cursor = 0; cursor < index; cursor += 1) {
-        if (source[cursor] === "\n") {
-            line += 1;
-        }
-    }
-    return line;
-}
-function isGlobalDomAccessCandidate(source, index, identifier) {
-    const lineStart = source.lastIndexOf("\n", index - 1) + 1;
-    const lineEndCandidate = source.indexOf("\n", index);
-    const lineEnd = lineEndCandidate === -1 ? source.length : lineEndCandidate;
-    const lineSource = source.slice(lineStart, lineEnd);
-    const trimmedLine = lineSource.trimStart();
-    if (trimmedLine.startsWith("import ")) {
-        return false;
-    }
-    if (trimmedLine.startsWith("const ") || trimmedLine.startsWith("let ") || trimmedLine.startsWith("var ")) {
-        return false;
-    }
-    if (trimmedLine.startsWith("function ") || trimmedLine.startsWith("class ")) {
-        return false;
-    }
-    const precedingCharacter = index > 0 ? source[index - 1] : "";
-    if (precedingCharacter === "." || precedingCharacter === "'" || precedingCharacter === '"') {
-        return false;
-    }
-    return (identifier === "document" ||
-        identifier === "window" ||
-        identifier === "parent" ||
-        identifier === "top");
-}
-function findWorkspaceBlockGlobalDomAccesses(editorSources) {
-    return editorSources.flatMap(({ relativePath, source }) => {
-        const maskedSource = maskTypeScriptCommentsAndLiterals(source);
-        const matches = maskedSource.matchAll(WORKSPACE_BLOCK_IFRAME_GLOBAL_DOM_PATTERN);
-        const findings = [];
-        for (const match of matches) {
-            const identifier = match[0];
-            const matchIndex = match.index ?? -1;
-            if (matchIndex < 0) {
-                continue;
-            }
-            if (!isGlobalDomAccessCandidate(source, matchIndex, identifier)) {
-                continue;
-            }
-            findings.push(`${relativePath}:${getSourceLineNumber(source, matchIndex)}`);
-        }
-        return findings;
-    });
-}
-function getWorkspaceBlockRequiredFiles(block) {
-    const blockDir = path.join("src", "blocks", block.slug);
-    return Array.from(new Set([
-        block.typesFile,
-        block.apiTypesFile,
-        block.openApiFile,
-        path.join(blockDir, "index.tsx"),
-        ...WORKSPACE_GENERATED_BLOCK_ARTIFACTS.map((fileName) => path.join(blockDir, fileName)),
-    ].filter((filePath) => typeof filePath === "string")));
-}
-function checkWorkspaceBlockMetadata(projectDir, workspace, block) {
-    const blockJsonRelativePath = path.join("src", "blocks", block.slug, "block.json");
-    const blockJsonPath = path.join(projectDir, blockJsonRelativePath);
-    if (!fs.existsSync(blockJsonPath)) {
-        return createDoctorCheck(`Block metadata ${block.slug}`, "fail", `Missing ${blockJsonRelativePath}`);
-    }
-    let blockJson;
-    try {
-        blockJson = parseScaffoldBlockMetadata(JSON.parse(fs.readFileSync(blockJsonPath, "utf8")));
-    }
-    catch (error) {
-        return createDoctorCheck(`Block metadata ${block.slug}`, "fail", error instanceof Error ? error.message : String(error));
-    }
-    const expectedName = `${workspace.workspace.namespace}/${block.slug}`;
-    const issues = [];
-    if (blockJson.name !== expectedName) {
-        issues.push(`block.json name must equal "${expectedName}"`);
-    }
-    if (blockJson.textdomain !== workspace.workspace.textDomain) {
-        issues.push(`block.json textdomain must equal "${workspace.workspace.textDomain}"`);
-    }
-    return createDoctorCheck(`Block metadata ${block.slug}`, issues.length === 0 ? "pass" : "fail", issues.length === 0
-        ? `block.json matches ${expectedName} and ${workspace.workspace.textDomain}`
-        : issues.join("; "));
-}
-function checkWorkspaceBlockHooks(projectDir, blockSlug) {
-    const blockJsonRelativePath = path.join("src", "blocks", blockSlug, "block.json");
-    const blockJsonPath = path.join(projectDir, blockJsonRelativePath);
-    if (!fs.existsSync(blockJsonPath)) {
-        return createDoctorCheck(`Block hooks ${blockSlug}`, "fail", `Missing ${blockJsonRelativePath}`);
-    }
-    let blockJson;
-    try {
-        blockJson = parseScaffoldBlockMetadata(JSON.parse(fs.readFileSync(blockJsonPath, "utf8")));
-    }
-    catch (error) {
-        return createDoctorCheck(`Block hooks ${blockSlug}`, "fail", error instanceof Error ? error.message : String(error));
-    }
-    const blockHooks = blockJson.blockHooks;
-    if (blockHooks === undefined) {
-        return createDoctorCheck(`Block hooks ${blockSlug}`, "pass", "No blockHooks metadata configured");
-    }
-    if (!blockHooks || typeof blockHooks !== "object" || Array.isArray(blockHooks)) {
-        return createDoctorCheck(`Block hooks ${blockSlug}`, "fail", `${blockJsonRelativePath} must define blockHooks as an object when present.`);
-    }
-    const blockName = typeof blockJson.name === "string" && blockJson.name.trim().length > 0
-        ? blockJson.name.trim()
-        : null;
-    const invalidEntries = Object.entries(blockHooks).filter(([anchor, position]) => (blockName !== null && anchor.trim() === blockName) ||
-        anchor.trim().length === 0 ||
-        anchor !== anchor.trim() ||
-        !HOOKED_BLOCK_ANCHOR_PATTERN.test(anchor) ||
-        typeof position !== "string" ||
-        !HOOKED_BLOCK_POSITION_SET.has(position));
-    return createDoctorCheck(`Block hooks ${blockSlug}`, invalidEntries.length === 0 ? "pass" : "fail", invalidEntries.length === 0
-        ? `blockHooks metadata is valid${Object.keys(blockHooks).length > 0 ? ` (${Object.keys(blockHooks).join(", ")})` : ""}`
-        : `Invalid blockHooks entries: ${invalidEntries
-            .map(([anchor, position]) => `${anchor || "<empty>"} => ${String(position)}`)
-            .join(", ")}`);
-}
-function checkWorkspaceBlockCollectionImport(projectDir, blockSlug) {
-    const entryRelativePath = path.join("src", "blocks", blockSlug, "index.tsx");
-    const entryPath = path.join(projectDir, entryRelativePath);
-    if (!fs.existsSync(entryPath)) {
-        return createDoctorCheck(`Block collection ${blockSlug}`, "fail", `Missing ${entryRelativePath}`);
-    }
-    const source = fs.readFileSync(entryPath, "utf8");
-    const hasCollectionImport = WORKSPACE_COLLECTION_IMPORT_PATTERN.test(source);
-    return createDoctorCheck(`Block collection ${blockSlug}`, hasCollectionImport ? "pass" : "fail", hasCollectionImport
-        ? "Shared block collection import is present"
-        : `Missing a shared collection import like ${WORKSPACE_COLLECTION_IMPORT_LINE}`);
-}
-function checkWorkspaceBlockIframeCompatibility(projectDir, blockSlug) {
-    const metadataResult = readWorkspaceBlockIframeMetadata(projectDir, blockSlug);
-    if (!metadataResult.document) {
-        return [
-            createDoctorCheck(`Block iframe/API v3 ${blockSlug}`, "warn", metadataResult.error ?? `Unable to inspect ${metadataResult.blockJsonRelativePath}`, WORKSPACE_BLOCK_IFRAME_DIAGNOSTIC_CODES.API_VERSION),
-        ];
-    }
-    const blockJson = metadataResult.document;
-    const apiVersion = typeof blockJson.apiVersion === "number" && Number.isFinite(blockJson.apiVersion)
-        ? blockJson.apiVersion
-        : null;
-    const blockDir = path.join(projectDir, "src", "blocks", blockSlug);
-    const localStyleFiles = WORKSPACE_BLOCK_LOCAL_STYLE_FILES.filter((fileName) => fs.existsSync(path.join(blockDir, fileName))).map((fileName) => normalizePathSeparators(path.join("src", "blocks", blockSlug, fileName)));
-    const hasRegisteredEditorStyles = hasRegisteredBlockAsset(blockJson.style) ||
-        hasRegisteredBlockAsset(blockJson.editorStyle);
-    const editorSources = collectWorkspaceBlockEditorSources(projectDir, blockSlug);
-    const editorWrapperSources = editorSources.filter((source) => !isWorkspaceBlockSaveSource(source.relativePath));
-    const globalDomAccesses = findWorkspaceBlockGlobalDomAccesses(editorSources);
-    const hasBlockPropsUsage = editorSources.some(({ source }) => hasExecutablePattern(source, WORKSPACE_BLOCK_PROPS_PATTERN));
-    const hasEditorBlockPropsUsage = editorWrapperSources.some(({ source }) => hasExecutablePattern(source, WORKSPACE_BLOCK_PROPS_PATTERN));
-    const blockWrapperStatus = editorWrapperSources.length === 0 || hasEditorBlockPropsUsage ? "pass" : "warn";
-    const blockWrapperDetail = editorSources.length === 0
-        ? "No editor-facing block source files found; general file checks will report missing entrypoints"
-        : editorWrapperSources.length === 0
-            ? "No editor wrapper source files found; general file checks will report missing entrypoints"
-            : hasEditorBlockPropsUsage
-                ? "Editor-facing sources use block wrapper props"
-                : hasBlockPropsUsage
-                    ? "Only save-facing useBlockProps.save() usage was detected. Confirm the editor wrapper also receives useBlockProps() or useInnerBlocksProps() before relying on iframe editor rendering."
-                    : "No useBlockProps(), useBlockProps.save(), or useInnerBlocksProps() usage was detected in editor-facing sources. Confirm the block wrapper receives WordPress block editor props before relying on iframe editor rendering.";
-    return [
-        createDoctorCheck(`Block iframe API version ${blockSlug}`, apiVersion !== null && apiVersion >= 3 ? "pass" : "warn", apiVersion !== null && apiVersion >= 3
-            ? "block.json declares apiVersion 3 for iframe editor readiness"
-            : `Set ${metadataResult.blockJsonRelativePath} apiVersion to 3 after testing the block in iframe-enabled Post Editor and Site Editor contexts. WordPress recommends API v3 for iframe editor compatibility. See ${WORKSPACE_BLOCK_IFRAME_COMPATIBILITY_DOC_URL}`, WORKSPACE_BLOCK_IFRAME_DIAGNOSTIC_CODES.API_VERSION),
-        createDoctorCheck(`Block iframe styles ${blockSlug}`, localStyleFiles.length === 0 || hasRegisteredEditorStyles ? "pass" : "warn", localStyleFiles.length === 0
-            ? "No local block stylesheet source files found to register"
-            : hasRegisteredEditorStyles
-                ? "block.json registers block styles for iframe editor loading"
-                : `Found stylesheet source files (${localStyleFiles.join(", ")}) but block.json does not declare style or editorStyle. Register block content styles so iframe editors do not depend on parent admin styles.`, WORKSPACE_BLOCK_IFRAME_DIAGNOSTIC_CODES.EDITOR_STYLES),
-        createDoctorCheck(`Block iframe globals ${blockSlug}`, globalDomAccesses.length === 0 ? "pass" : "warn", globalDomAccesses.length === 0
-            ? "No direct window/document/parent DOM access detected in editor-facing block sources"
-            : `Direct global DOM access detected at ${globalDomAccesses.join(", ")}. Prefer element.ownerDocument/defaultView via refs or useRefEffect for iframe editor content.`, WORKSPACE_BLOCK_IFRAME_DIAGNOSTIC_CODES.EDITOR_GLOBALS),
-        createDoctorCheck(`Block iframe wrapper ${blockSlug}`, blockWrapperStatus, blockWrapperDetail, WORKSPACE_BLOCK_IFRAME_DIAGNOSTIC_CODES.BLOCK_PROPS),
-    ];
-}
-function checkWorkspacePatternBootstrap(projectDir, packageName) {
-    const bootstrapPath = resolveWorkspaceBootstrapPath(projectDir, packageName);
-    if (!fs.existsSync(bootstrapPath)) {
-        return createDoctorCheck("Pattern bootstrap", "fail", `Missing ${path.basename(bootstrapPath)}`);
-    }
-    const source = fs.readFileSync(bootstrapPath, "utf8");
-    const hasCategoryAnchor = source.includes("register_block_pattern_category");
-    const hasPatternGlob = source.includes("/src/patterns/*.php");
-    return createDoctorCheck("Pattern bootstrap", hasCategoryAnchor && hasPatternGlob ? "pass" : "fail", hasCategoryAnchor && hasPatternGlob
-        ? "Pattern category and loader hooks are present"
-        : "Missing pattern category registration or src/patterns loader hook");
-}
-function checkVariationEntrypoint(projectDir, blockSlug) {
-    const entryPath = path.join(projectDir, "src", "blocks", blockSlug, "index.tsx");
-    if (!fs.existsSync(entryPath)) {
-        return createDoctorCheck(`Variation entrypoint ${blockSlug}`, "fail", `Missing ${path.relative(projectDir, entryPath)}`);
-    }
-    const source = fs.readFileSync(entryPath, "utf8");
-    const hasImport = hasUncommentedPattern(source, WORKSPACE_VARIATIONS_IMPORT_PATTERN);
-    const hasCall = hasExecutablePattern(source, WORKSPACE_VARIATIONS_CALL_PATTERN);
-    return createDoctorCheck(`Variation entrypoint ${blockSlug}`, hasImport && hasCall ? "pass" : "fail", hasImport && hasCall
-        ? "Variations registration hook is present"
-        : "Missing ./variations import or registerWorkspaceVariations() call");
-}
-function checkBlockStyleEntrypoint(projectDir, blockSlug) {
-    const entryPath = path.join(projectDir, "src", "blocks", blockSlug, "index.tsx");
-    if (!fs.existsSync(entryPath)) {
-        return createDoctorCheck(`Block style entrypoint ${blockSlug}`, "fail", `Missing ${path.relative(projectDir, entryPath)}`);
-    }
-    const source = fs.readFileSync(entryPath, "utf8");
-    const hasImport = hasUncommentedPattern(source, WORKSPACE_BLOCK_STYLES_IMPORT_PATTERN);
-    const hasCall = hasExecutablePattern(source, WORKSPACE_BLOCK_STYLES_CALL_PATTERN);
-    return createDoctorCheck(`Block style entrypoint ${blockSlug}`, hasImport && hasCall ? "pass" : "fail", hasImport && hasCall
-        ? "Block style registration hook is present"
-        : "Missing ./styles import or registerWorkspaceBlockStyles() call");
-}
-function checkBlockTransformEntrypoint(projectDir, blockSlug) {
-    const entryPath = path.join(projectDir, "src", "blocks", blockSlug, "index.tsx");
-    if (!fs.existsSync(entryPath)) {
-        return createDoctorCheck(`Block transform entrypoint ${blockSlug}`, "fail", `Missing ${path.relative(projectDir, entryPath)}`);
-    }
-    const source = fs.readFileSync(entryPath, "utf8");
-    const hasImport = hasUncommentedPattern(source, WORKSPACE_BLOCK_TRANSFORMS_IMPORT_PATTERN);
-    const hasCall = hasExecutablePattern(source, WORKSPACE_BLOCK_TRANSFORMS_CALL_PATTERN);
-    return createDoctorCheck(`Block transform entrypoint ${blockSlug}`, hasImport && hasCall ? "pass" : "fail", hasImport && hasCall
-        ? "Block transform registration hook is present"
-        : "Missing ./transforms import or applyWorkspaceBlockTransforms(registration.settings) call");
-}
-function checkBlockTransformConfig(workspace, transform) {
-    const expectedTo = `${workspace.workspace.namespace}/${transform.block}`;
-    const issues = [];
-    if (!WORKSPACE_FULL_BLOCK_NAME_PATTERN.test(transform.from)) {
-        issues.push("from must use full namespace/block format");
-    }
-    if (transform.to !== expectedTo) {
-        issues.push(`to must equal "${expectedTo}" for workspace block "${transform.block}"`);
-    }
-    return createDoctorCheck(`Block transform config ${transform.block}/${transform.slug}`, issues.length === 0 ? "pass" : "fail", issues.length === 0
-        ? `${transform.from} transforms into ${transform.to}`
-        : issues.join("; "));
-}
+import { getWorkspaceBlockAddonDoctorChecks, } from "./cli-doctor-workspace-block-addons.js";
+import { getWorkspaceBlockIframeCompatibilityChecks, } from "./cli-doctor-workspace-block-iframe.js";
+import { getWorkspaceBlockCoreDoctorChecks, } from "./cli-doctor-workspace-block-metadata.js";
 /**
  * Collect block-, variation-, transform-, and pattern-related workspace doctor checks.
  *
@@ -376,63 +11,10 @@ function checkBlockTransformConfig(workspace, transform) {
 export function getWorkspaceBlockDoctorChecks(workspace, inventory) {
     const checks = [];
     for (const block of inventory.blocks) {
-        checks.push(checkExistingFiles(workspace.projectDir, `Block ${block.slug}`, getWorkspaceBlockRequiredFiles(block)));
-        checks.push(checkWorkspaceBlockMetadata(workspace.projectDir, workspace, block));
-        checks.push(checkWorkspaceBlockHooks(workspace.projectDir, block.slug));
-        checks.push(checkWorkspaceBlockCollectionImport(workspace.projectDir, block.slug));
-        checks.push(...checkWorkspaceBlockIframeCompatibility(workspace.projectDir, block.slug));
+        checks.push(...getWorkspaceBlockCoreDoctorChecks(workspace, block));
+        checks.push(...getWorkspaceBlockIframeCompatibilityChecks(workspace.projectDir, block.slug));
     }
     const registeredBlockSlugs = new Set(inventory.blocks.map((block) => block.slug));
-    const variationTargetBlocks = new Set();
-    for (const variation of inventory.variations) {
-        if (!registeredBlockSlugs.has(variation.block)) {
-            checks.push(createDoctorCheck(`Variation ${variation.block}/${variation.slug}`, "fail", `Variation references unknown block "${variation.block}"`));
-            continue;
-        }
-        variationTargetBlocks.add(variation.block);
-        checks.push(checkExistingFiles(workspace.projectDir, `Variation ${variation.block}/${variation.slug}`, [variation.file]));
-    }
-    for (const blockSlug of variationTargetBlocks) {
-        checks.push(checkVariationEntrypoint(workspace.projectDir, blockSlug));
-    }
-    const blockStyleTargetBlocks = new Set();
-    for (const blockStyle of inventory.blockStyles) {
-        if (!registeredBlockSlugs.has(blockStyle.block)) {
-            checks.push(createDoctorCheck(`Block style ${blockStyle.block}/${blockStyle.slug}`, "fail", `Block style references unknown block "${blockStyle.block}"`));
-            continue;
-        }
-        blockStyleTargetBlocks.add(blockStyle.block);
-        checks.push(checkExistingFiles(workspace.projectDir, `Block style ${blockStyle.block}/${blockStyle.slug}`, [blockStyle.file]));
-    }
-    for (const blockSlug of blockStyleTargetBlocks) {
-        checks.push(checkExistingFiles(workspace.projectDir, `Block style registry ${blockSlug}`, [
-            path.join("src", "blocks", blockSlug, "styles", "index.ts"),
-        ]));
-        checks.push(checkBlockStyleEntrypoint(workspace.projectDir, blockSlug));
-    }
-    const blockTransformTargetBlocks = new Set();
-    for (const blockTransform of inventory.blockTransforms) {
-        if (!registeredBlockSlugs.has(blockTransform.block)) {
-            checks.push(createDoctorCheck(`Block transform ${blockTransform.block}/${blockTransform.slug}`, "fail", `Block transform references unknown block "${blockTransform.block}"`));
-            continue;
-        }
-        blockTransformTargetBlocks.add(blockTransform.block);
-        checks.push(checkBlockTransformConfig(workspace, blockTransform));
-        checks.push(checkExistingFiles(workspace.projectDir, `Block transform ${blockTransform.block}/${blockTransform.slug}`, [blockTransform.file]));
-    }
-    for (const blockSlug of blockTransformTargetBlocks) {
-        checks.push(checkExistingFiles(workspace.projectDir, `Block transform registry ${blockSlug}`, [
-            path.join("src", "blocks", blockSlug, "transforms", "index.ts"),
-        ]));
-        checks.push(checkBlockTransformEntrypoint(workspace.projectDir, blockSlug));
-    }
-    const shouldCheckPatternBootstrap = inventory.patterns.length > 0 ||
-        fs.existsSync(path.join(workspace.projectDir, "src", "patterns"));
-    if (shouldCheckPatternBootstrap) {
-        checks.push(checkWorkspacePatternBootstrap(workspace.projectDir, workspace.packageName));
-    }
-    for (const pattern of inventory.patterns) {
-        checks.push(checkExistingFiles(workspace.projectDir, `Pattern ${pattern.slug}`, [pattern.file]));
-    }
+    checks.push(...getWorkspaceBlockAddonDoctorChecks(workspace, inventory, registeredBlockSlugs));
     return checks;
 }

package/dist/runtime/cli-doctor-workspace-features-abilities.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 ability workspace doctor checks while preserving existing row order.
+ *
+ * @param workspace Resolved workspace metadata and filesystem paths.
+ * @param abilities Ability entries parsed from the workspace inventory.
+ * @returns Ordered ability doctor checks.
+ */
+export declare function getWorkspaceAbilityDoctorChecks(workspace: WorkspaceProject, abilities: WorkspaceInventory["abilities"]): DoctorCheck[];

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

@@ -0,0 +1,112 @@
+import fs from "node:fs";
+import path from "node:path";
+import { checkExistingFiles, createDoctorCheck, resolveWorkspaceBootstrapPath, WORKSPACE_ABILITY_EDITOR_ASSET, WORKSPACE_ABILITY_EDITOR_SCRIPT, WORKSPACE_ABILITY_GLOB, } from "./cli-doctor-workspace-shared.js";
+import { readJsonFileSync } from "./json-utils.js";
+import { escapeRegex } from "./php-utils.js";
+function getWorkspaceAbilityRequiredFiles(ability) {
+    return Array.from(new Set([
+        ability.clientFile,
+        ability.configFile,
+        ability.dataFile,
+        ability.inputSchemaFile,
+        ability.outputSchemaFile,
+        ability.phpFile,
+        ability.typesFile,
+    ]));
+}
+function checkWorkspaceAbilityConfig(projectDir, ability) {
+    const configPath = path.join(projectDir, ability.configFile);
+    if (!fs.existsSync(configPath)) {
+        return createDoctorCheck(`Ability config ${ability.slug}`, "fail", `Missing ${ability.configFile}`);
+    }
+    try {
+        const config = readJsonFileSync(configPath, {
+            context: "workspace ability config",
+        });
+        const abilityId = typeof config.abilityId === "string" ? config.abilityId.trim() : "";
+        const categorySlug = typeof config.category?.slug === "string"
+            ? config.category.slug.trim()
+            : "";
+        const hasValidAbilityId = /^[a-z0-9-]+\/[a-z0-9-]+$/u.test(abilityId);
+        const hasValidCategorySlug = /^[a-z0-9-]+$/u.test(categorySlug);
+        return createDoctorCheck(`Ability config ${ability.slug}`, hasValidAbilityId && hasValidCategorySlug ? "pass" : "fail", hasValidAbilityId && hasValidCategorySlug
+            ? `Ability id ${abilityId} in category ${categorySlug} is valid`
+            : "Ability config must define a valid abilityId (`namespace/ability-name`) and category.slug.");
+    }
+    catch (error) {
+        return createDoctorCheck(`Ability config ${ability.slug}`, "fail", error instanceof Error ? error.message : String(error));
+    }
+}
+function checkWorkspaceAbilityBootstrap(projectDir, packageName, phpPrefix) {
+    const bootstrapPath = resolveWorkspaceBootstrapPath(projectDir, packageName);
+    if (!fs.existsSync(bootstrapPath)) {
+        return createDoctorCheck("Ability bootstrap", "fail", `Missing ${path.basename(bootstrapPath)}`);
+    }
+    const source = fs.readFileSync(bootstrapPath, "utf8");
+    const loadFunctionName = `${phpPrefix}_load_workflow_abilities`;
+    const enqueueFunctionName = `${phpPrefix}_enqueue_workflow_abilities`;
+    const loadHook = `add_action( 'plugins_loaded', '${loadFunctionName}' );`;
+    const adminEnqueueHook = `add_action( 'admin_enqueue_scripts', '${enqueueFunctionName}' );`;
+    const editorEnqueueHook = `add_action( 'enqueue_block_editor_assets', '${enqueueFunctionName}' );`;
+    const hasLoaderHook = source.includes(loadHook);
+    const hasAdminEnqueueHook = source.includes(adminEnqueueHook);
+    const hasEditorEnqueueHook = source.includes(editorEnqueueHook);
+    const hasServerGlob = source.includes(WORKSPACE_ABILITY_GLOB);
+    const hasEditorScript = source.includes(WORKSPACE_ABILITY_EDITOR_SCRIPT);
+    const hasEditorAsset = source.includes(WORKSPACE_ABILITY_EDITOR_ASSET);
+    const hasScriptModuleEnqueue = source.includes("wp_enqueue_script_module");
+    return createDoctorCheck("Ability bootstrap", hasLoaderHook &&
+        hasAdminEnqueueHook &&
+        hasEditorEnqueueHook &&
+        hasServerGlob &&
+        hasEditorScript &&
+        hasEditorAsset &&
+        hasScriptModuleEnqueue
+        ? "pass"
+        : "fail", hasLoaderHook &&
+        hasAdminEnqueueHook &&
+        hasEditorEnqueueHook &&
+        hasServerGlob &&
+        hasEditorScript &&
+        hasEditorAsset &&
+        hasScriptModuleEnqueue
+        ? "Ability loader and admin/editor script-module bootstrap hooks are present"
+        : "Missing ability loader hook, script-module enqueue, or build/abilities asset references");
+}
+function checkWorkspaceAbilityIndex(projectDir, abilities) {
+    const indexRelativePath = [
+        path.join("src", "abilities", "index.ts"),
+        path.join("src", "abilities", "index.js"),
+    ].find((relativePath) => fs.existsSync(path.join(projectDir, relativePath)));
+    if (!indexRelativePath) {
+        return createDoctorCheck("Abilities index", "fail", "Missing src/abilities/index.ts or src/abilities/index.js");
+    }
+    const indexPath = path.join(projectDir, indexRelativePath);
+    const source = fs.readFileSync(indexPath, "utf8");
+    const missingExports = abilities.filter((ability) => {
+        const exportPattern = new RegExp(`^\\s*export\\s+(?:\\*\\s+from|\\{[^}]+\\}\\s+from)\\s+['"\`]\\./${escapeRegex(ability.slug)}\\/client['"\`]`, "mu");
+        return !exportPattern.test(source);
+    });
+    return createDoctorCheck("Abilities index", missingExports.length === 0 ? "pass" : "fail", missingExports.length === 0
+        ? "Ability client helpers are aggregated"
+        : `Missing ability exports for: ${missingExports.map((entry) => entry.slug).join(", ")}`);
+}
+/**
+ * Collect ability workspace doctor checks while preserving existing row order.
+ *
+ * @param workspace Resolved workspace metadata and filesystem paths.
+ * @param abilities Ability entries parsed from the workspace inventory.
+ * @returns Ordered ability doctor checks.
+ */
+export function getWorkspaceAbilityDoctorChecks(workspace, abilities) {
+    const checks = [];
+    if (abilities.length > 0) {
+        checks.push(checkWorkspaceAbilityBootstrap(workspace.projectDir, workspace.packageName, workspace.workspace.phpPrefix));
+        checks.push(checkWorkspaceAbilityIndex(workspace.projectDir, abilities));
+    }
+    for (const ability of abilities) {
+        checks.push(checkWorkspaceAbilityConfig(workspace.projectDir, ability));
+        checks.push(checkExistingFiles(workspace.projectDir, `Ability ${ability.slug}`, getWorkspaceAbilityRequiredFiles(ability)));
+    }
+    return checks;
+}

package/dist/runtime/cli-doctor-workspace-features-admin-views.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 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 declare function getWorkspaceAdminViewDoctorChecks(workspace: WorkspaceProject, inventory: WorkspaceInventory): DoctorCheck[];