@wp-typia/project-tools 0.20.2 → 0.21.0

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

@@ -1,10 +1,11 @@
 import fs from "node:fs";
 import path from "node:path";
 import { parseScaffoldBlockMetadata } from "@wp-typia/block-runtime/blocks";
-import { EDITOR_PLUGIN_SLOT_IDS, REST_RESOURCE_METHOD_IDS, REST_RESOURCE_NAMESPACE_PATTERN, } from "./cli-add-shared.js";
+import { EDITOR_PLUGIN_SLOT_IDS, REST_RESOURCE_METHOD_IDS, REST_RESOURCE_NAMESPACE_PATTERN, resolveEditorPluginSlotAlias, } from "./cli-add-shared.js";
 import { HOOKED_BLOCK_ANCHOR_PATTERN, HOOKED_BLOCK_POSITION_SET, } from "./hooked-blocks.js";
 import { readWorkspaceInventory } from "./workspace-inventory.js";
 import { getInvalidWorkspaceProjectReason, parseWorkspacePackageJson, WORKSPACE_TEMPLATE_PACKAGE, tryResolveWorkspaceProject, } from "./workspace-project.js";
+import { escapeRegex } from "./php-utils.js";
 const WORKSPACE_COLLECTION_IMPORT_LINE = "import '../../collection';";
 const WORKSPACE_COLLECTION_IMPORT_PATTERN = /^\s*import\s+["']\.\.\/\.\.\/collection["']\s*;?\s*$/m;
 const WORKSPACE_BINDING_SERVER_GLOB = "/src/bindings/*/server.php";
@@ -15,6 +16,10 @@ const WORKSPACE_ABILITY_GLOB = "/inc/abilities/*.php";
 const WORKSPACE_ABILITY_EDITOR_SCRIPT = "build/abilities/index.js";
 const WORKSPACE_ABILITY_EDITOR_ASSET = "build/abilities/index.asset.php";
 const WORKSPACE_AI_FEATURE_GLOB = "/inc/ai-features/*.php";
+const WORKSPACE_ADMIN_VIEW_GLOB = "/inc/admin-views/*.php";
+const WORKSPACE_ADMIN_VIEW_SCRIPT = "build/admin-views/index.js";
+const WORKSPACE_ADMIN_VIEW_ASSET = "build/admin-views/index.asset.php";
+const WORKSPACE_ADMIN_VIEW_STYLE = "build/admin-views/style-index.css";
 const WORKSPACE_EDITOR_PLUGIN_EDITOR_SCRIPT = "build/editor-plugins/index.js";
 const WORKSPACE_EDITOR_PLUGIN_EDITOR_ASSET = "build/editor-plugins/index.asset.php";
 const WORKSPACE_EDITOR_PLUGIN_EDITOR_STYLE = "build/editor-plugins/style-index.css";
@@ -25,14 +30,252 @@ const WORKSPACE_GENERATED_BLOCK_ARTIFACTS = [
     "typia-validator.php",
     "typia.openapi.json",
 ];
-function createDoctorCheck(label, status, detail) {
-    return { detail, label, status };
+const WORKSPACE_FULL_BLOCK_NAME_PATTERN = /^[a-z0-9-]+\/[a-z0-9-]+$/u;
+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 createDoctorCheck(label, status, detail, code) {
+    return code ? { code, detail, label, status } : { detail, label, status };
 }
 function createDoctorScopeCheck(status, detail) {
     return createDoctorCheck("Doctor scope", status, detail);
 }
-function escapeRegex(value) {
-    return value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+function maskSourceSegment(segment) {
+    return segment.replace(/[^\n\r]/gu, " ");
+}
+function maskTypeScriptComments(source) {
+    return source
+        .replace(/\/\*[\s\S]*?\*\//gu, maskSourceSegment)
+        .replace(/\/\/[^\n\r]*/gu, maskSourceSegment);
+}
+// Preserve offsets while hiding non-executable text from hook checks.
+function maskTypeScriptCommentsAndLiterals(source) {
+    let maskedSource = "";
+    let index = 0;
+    while (index < source.length) {
+        const current = source[index];
+        const next = source[index + 1];
+        if (current === "/" && next === "/") {
+            const start = index;
+            index += 2;
+            while (index < source.length &&
+                source[index] !== "\n" &&
+                source[index] !== "\r") {
+                index += 1;
+            }
+            maskedSource += maskSourceSegment(source.slice(start, index));
+            continue;
+        }
+        if (current === "/" && next === "*") {
+            const start = index;
+            index += 2;
+            while (index < source.length &&
+                !(source[index] === "*" && source[index + 1] === "/")) {
+                index += 1;
+            }
+            index = Math.min(index + 2, source.length);
+            maskedSource += maskSourceSegment(source.slice(start, index));
+            continue;
+        }
+        if (current === "'" || current === '"' || current === "`") {
+            const start = index;
+            const quote = current;
+            index += 1;
+            while (index < source.length) {
+                const char = source[index];
+                if (char === "\\") {
+                    index += 2;
+                    continue;
+                }
+                index += 1;
+                if (char === quote) {
+                    break;
+                }
+            }
+            maskedSource += maskSourceSegment(source.slice(start, index));
+            continue;
+        }
+        maskedSource += current;
+        index += 1;
+    }
+    return maskedSource;
+}
+function hasUncommentedPattern(source, pattern) {
+    return pattern.test(maskTypeScriptComments(source));
+}
+function hasExecutablePattern(source, pattern) {
+    return pattern.test(maskTypeScriptCommentsAndLiterals(source));
+}
+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 parsed = JSON.parse(fs.readFileSync(blockJsonPath, "utf8"));
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+            return {
+                blockJsonRelativePath,
+                error: `${blockJsonRelativePath} must contain a JSON object`,
+            };
+        }
+        return {
+            blockJsonRelativePath,
+            document: parsed,
+        };
+    }
+    catch (error) {
+        return {
+            blockJsonRelativePath,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+function isWorkspaceBlockEditorSource(relativePath) {
+    const normalizedPath = normalizePathSeparators(relativePath);
+    const normalizedLowerPath = normalizedPath.toLowerCase();
+    if (!WORKSPACE_BLOCK_EDITOR_SOURCE_FILE_PATTERN.test(normalizedLowerPath) ||
+        /\.d\.[cm]?[jt]s$/u.test(normalizedLowerPath)) {
+        return false;
+    }
+    const segments = normalizedLowerPath.split("/");
+    const fileName = segments[segments.length - 1] ?? "";
+    const baseName = fileName.replace(/\.[^.]+$/u, "");
+    if (WORKSPACE_BLOCK_EDITOR_SOURCE_BASENAMES.has(baseName)) {
+        return true;
+    }
+    return segments
+        .slice(0, -1)
+        .some((segment) => WORKSPACE_BLOCK_EDITOR_SOURCE_DIRECTORIES.has(segment));
+}
+function isWorkspaceBlockSaveSource(relativePath) {
+    const fileName = normalizePathSeparators(relativePath).split("/").pop() ?? "";
+    return fileName.replace(/\.[^.]+$/u, "").toLowerCase() === "save";
+}
+function collectWorkspaceBlockEditorSources(projectDir, blockSlug) {
+    const blockDir = path.join(projectDir, "src", "blocks", blockSlug);
+    if (!fs.existsSync(blockDir)) {
+        return [];
+    }
+    const sources = [];
+    const visitDirectory = (directory) => {
+        for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+            const entryPath = path.join(directory, entry.name);
+            if (entry.isDirectory()) {
+                visitDirectory(entryPath);
+                continue;
+            }
+            if (!entry.isFile()) {
+                continue;
+            }
+            const relativePath = normalizePathSeparators(path.relative(projectDir, entryPath));
+            const blockRelativePath = path.relative(blockDir, entryPath);
+            if (!isWorkspaceBlockEditorSource(blockRelativePath)) {
+                continue;
+            }
+            sources.push({
+                relativePath,
+                source: fs.readFileSync(entryPath, "utf8"),
+            });
+        }
+    };
+    visitDirectory(blockDir);
+    return sources;
+}
+function getSourceLineNumber(source, index) {
+    let lineNumber = 1;
+    for (let cursor = 0; cursor < index; cursor += 1) {
+        if (source[cursor] === "\n") {
+            lineNumber += 1;
+        }
+    }
+    return lineNumber;
+}
+function isGlobalDomAccessCandidate(maskedSource, index, token) {
+    if (token === "document" || token === "window") {
+        return true;
+    }
+    const before = maskedSource.slice(0, index);
+    const after = maskedSource.slice(index + token.length);
+    const previousNonWhitespace = before.match(/\S(?=\s*$)/u)?.[0] ?? "";
+    const nextNonWhitespace = after.match(/^\s*(\S)/u)?.[1] ?? "";
+    if (previousNonWhitespace === "." || previousNonWhitespace === "{" || previousNonWhitespace === ",") {
+        return false;
+    }
+    if (nextNonWhitespace === ":") {
+        return false;
+    }
+    if (/\b(?:const|function|let|var)\s+$/u.test(before)) {
+        return false;
+    }
+    return true;
+}
+function findWorkspaceBlockGlobalDomAccesses(sources) {
+    const findings = [];
+    for (const { relativePath, source } of sources) {
+        const maskedSource = maskTypeScriptCommentsAndLiterals(source);
+        const matches = maskedSource.matchAll(WORKSPACE_BLOCK_IFRAME_GLOBAL_DOM_PATTERN);
+        for (const match of matches) {
+            const index = match.index ?? 0;
+            const matchedToken = match[0].replace(/\W+/gu, "");
+            if (!isGlobalDomAccessCandidate(maskedSource, index, matchedToken)) {
+                continue;
+            }
+            findings.push(`${relativePath}:${getSourceLineNumber(source, index)} (${matchedToken})`);
+            if (findings.length >= 5) {
+                return findings;
+            }
+        }
+    }
+    return findings;
 }
 function getWorkspaceBootstrapRelativePath(packageName) {
     const packageBaseName = packageName.split("/").pop() ?? packageName;
@@ -156,6 +399,51 @@ function checkWorkspaceBlockCollectionImport(projectDir, blockSlug) {
         ? "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 packageBaseName = packageName.split("/").pop() ?? packageName;
     const bootstrapPath = path.join(projectDir, `${packageBaseName}.php`);
@@ -196,6 +484,82 @@ function checkWorkspaceBindingSourcesIndex(projectDir, bindingSources) {
         ? "Binding source editor registrations are aggregated"
         : `Missing editor imports for: ${missingImports.map((entry) => entry.slug).join(", ")}`);
 }
+function checkWorkspaceBindingTarget(projectDir, workspace, registeredBlockSlugs, bindingSource) {
+    const hasBlock = bindingSource.block !== undefined;
+    const hasAttribute = bindingSource.attribute !== undefined;
+    if (!hasBlock && !hasAttribute) {
+        return undefined;
+    }
+    if (!bindingSource.block || !bindingSource.attribute) {
+        return createDoctorCheck(`Binding target ${bindingSource.slug}`, "fail", "Binding target entries must include both block and attribute.");
+    }
+    if (!registeredBlockSlugs.has(bindingSource.block)) {
+        return createDoctorCheck(`Binding target ${bindingSource.slug}`, "fail", `Binding target references unknown block "${bindingSource.block}".`);
+    }
+    const blockJsonRelativePath = path.join("src", "blocks", bindingSource.block, "block.json");
+    const blockJsonPath = path.join(projectDir, blockJsonRelativePath);
+    const issues = [];
+    try {
+        const blockJson = parseScaffoldBlockMetadata(JSON.parse(fs.readFileSync(blockJsonPath, "utf8")));
+        const attributes = blockJson.attributes;
+        if (!attributes || typeof attributes !== "object" || Array.isArray(attributes)) {
+            issues.push(`${blockJsonRelativePath} must define an attributes object`);
+        }
+        else {
+            const attributeConfig = attributes[bindingSource.attribute];
+            if (!attributeConfig ||
+                typeof attributeConfig !== "object" ||
+                Array.isArray(attributeConfig)) {
+                issues.push(`${blockJsonRelativePath} must declare attribute "${bindingSource.attribute}"`);
+            }
+        }
+    }
+    catch (error) {
+        issues.push(error instanceof Error
+            ? `Unable to read ${blockJsonRelativePath}: ${error.message}`
+            : `Unable to read ${blockJsonRelativePath}.`);
+    }
+    const serverPath = path.join(projectDir, bindingSource.serverFile);
+    if (fs.existsSync(serverPath)) {
+        const serverSource = fs.readFileSync(serverPath, "utf8");
+        const supportedAttributesFilter = `block_bindings_supported_attributes_${workspace.workspace.namespace}/${bindingSource.block}`;
+        if (!serverSource.includes(supportedAttributesFilter)) {
+            issues.push(`${bindingSource.serverFile} must register ${supportedAttributesFilter}`);
+        }
+        if (!new RegExp(`'${escapeRegex(bindingSource.attribute)}'`, "u").test(serverSource)) {
+            issues.push(`${bindingSource.serverFile} must expose attribute "${bindingSource.attribute}"`);
+        }
+    }
+    else {
+        issues.push(`Missing ${bindingSource.serverFile}`);
+    }
+    const editorPath = path.join(projectDir, bindingSource.editorFile);
+    if (fs.existsSync(editorPath)) {
+        const editorSource = fs.readFileSync(editorPath, "utf8");
+        const blockName = `${workspace.workspace.namespace}/${bindingSource.block}`;
+        const bindingSourceTargetMatch = editorSource.match(/export\s+const\s+BINDING_SOURCE_TARGET\s*=\s*\{([\s\S]*?)\}\s+as\s+const\s*;/u);
+        if (!bindingSourceTargetMatch) {
+            issues.push(`${bindingSource.editorFile} must export BINDING_SOURCE_TARGET`);
+        }
+        else {
+            const targetSource = bindingSourceTargetMatch[1] ?? "";
+            const attributePattern = new RegExp(`\\battribute\\s*:\\s*["']${escapeRegex(bindingSource.attribute)}["']`, "u");
+            const blockPattern = new RegExp(`\\bblock\\s*:\\s*["']${escapeRegex(blockName)}["']`, "u");
+            if (!attributePattern.test(targetSource)) {
+                issues.push(`${bindingSource.editorFile} must document target attribute "${bindingSource.attribute}"`);
+            }
+            if (!blockPattern.test(targetSource)) {
+                issues.push(`${bindingSource.editorFile} must document target block "${blockName}"`);
+            }
+        }
+    }
+    else {
+        issues.push(`Missing ${bindingSource.editorFile}`);
+    }
+    return createDoctorCheck(`Binding target ${bindingSource.slug}`, issues.length === 0 ? "pass" : "fail", issues.length === 0
+        ? `${bindingSource.block}.${bindingSource.attribute} is declared and supported`
+        : issues.join("; "));
+}
 function getWorkspaceRestResourceRequiredFiles(restResource) {
     const schemaNames = new Set();
     if (restResource.methods.includes("list")) {
@@ -378,20 +742,23 @@ function checkWorkspaceAiFeatureBootstrap(projectDir, packageName, phpPrefix) {
 }
 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,
-        path.join(editorPluginDir, "Sidebar.tsx"),
+        surfaceFile,
         path.join(editorPluginDir, "data.ts"),
         path.join(editorPluginDir, "types.ts"),
         path.join(editorPluginDir, "style.scss"),
     ]));
 }
 function checkWorkspaceEditorPluginConfig(editorPlugin) {
-    const validSlots = new Set(EDITOR_PLUGIN_SLOT_IDS);
-    const isValidSlot = validSlots.has(editorPlugin.slot);
+    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`
-        : `Unsupported editor plugin slot "${editorPlugin.slot}". Expected one of: ${EDITOR_PLUGIN_SLOT_IDS.join(", ")}`);
+        ? `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 packageBaseName = packageName.split("/").pop() ?? packageName;
@@ -430,18 +797,145 @@ function checkWorkspaceEditorPluginIndex(projectDir, editorPlugins) {
             .map((entry) => entry.slug)
             .join(", ")}`);
 }
+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 sourceMatch = /^rest-resource:([a-z][a-z0-9-]*)$/u.exec(source);
+    const restResourceSlug = sourceMatch?.[1];
+    const restResource = restResourceSlug
+        ? inventory.restResources.find((entry) => entry.slug === restResourceSlug)
+        : undefined;
+    const isValid = Boolean(restResource?.methods.includes("list"));
+    return createDoctorCheck(`Admin view config ${adminView.slug}`, isValid ? "pass" : "fail", isValid
+        ? `Admin view source ${source} is list-capable`
+        : "Admin view source must use rest-resource:<slug> and reference a list-capable REST resource");
+}
+function checkWorkspaceAdminViewBootstrap(projectDir, packageName, phpPrefix) {
+    const packageBaseName = packageName.split("/").pop() ?? packageName;
+    const bootstrapPath = path.join(projectDir, `${packageBaseName}.php`);
+    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 = source.includes("'wp-components'");
+    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");
+}
 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 = source.includes("./variations");
-    const hasCall = source.includes("registerWorkspaceVariations()");
+    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("; "));
+}
 function checkMigrationWorkspaceHint(workspace, packageJson) {
     const hasMigrationScript = typeof packageJson.scripts?.["migration:doctor"] === "string";
     const migrationConfigRelativePath = path.join("src", "migrations", "config.ts");
@@ -504,12 +998,13 @@ export function getWorkspaceDoctorChecks(cwd) {
     checks.push(checkWorkspacePackageMetadata(workspace, workspacePackageJson));
     try {
         const inventory = readWorkspaceInventory(workspace.projectDir);
-        checks.push(createDoctorCheck("Workspace inventory", "pass", `${inventory.blocks.length} block(s), ${inventory.variations.length} variation(s), ${inventory.patterns.length} pattern(s), ${inventory.bindingSources.length} binding source(s), ${inventory.restResources.length} REST resource(s), ${inventory.abilities.length} ability scaffold(s), ${inventory.aiFeatures.length} AI feature(s), ${inventory.editorPlugins.length} editor plugin(s)`));
+        checks.push(createDoctorCheck("Workspace inventory", "pass", `${inventory.blocks.length} block(s), ${inventory.variations.length} variation(s), ${inventory.blockStyles.length} block style(s), ${inventory.blockTransforms.length} block transform(s), ${inventory.patterns.length} pattern(s), ${inventory.bindingSources.length} binding source(s), ${inventory.restResources.length} REST resource(s), ${inventory.abilities.length} ability scaffold(s), ${inventory.aiFeatures.length} AI feature(s), ${inventory.editorPlugins.length} editor plugin(s), ${inventory.adminViews.length} admin view(s)`));
         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));
         }
         const registeredBlockSlugs = new Set(inventory.blocks.map((block) => block.slug));
         const variationTargetBlocks = new Set();
@@ -524,6 +1019,37 @@ export function getWorkspaceDoctorChecks(cwd) {
         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) {
@@ -541,6 +1067,10 @@ export function getWorkspaceDoctorChecks(cwd) {
                 bindingSource.serverFile,
                 bindingSource.editorFile,
             ]));
+            const bindingTargetCheck = checkWorkspaceBindingTarget(workspace.projectDir, workspace, registeredBlockSlugs, bindingSource);
+            if (bindingTargetCheck) {
+                checks.push(bindingTargetCheck);
+            }
         }
         if (inventory.restResources.length > 0) {
             checks.push(checkWorkspaceRestResourceBootstrap(workspace.projectDir, workspace.packageName, workspace.workspace.phpPrefix));
@@ -572,6 +1102,15 @@ export function getWorkspaceDoctorChecks(cwd) {
             checks.push(checkExistingFiles(workspace.projectDir, `Editor plugin ${editorPlugin.slug}`, getWorkspaceEditorPluginRequiredFiles(editorPlugin)));
             checks.push(checkWorkspaceEditorPluginConfig(editorPlugin));
         }
+        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));
+        }
         const migrationWorkspaceCheck = checkMigrationWorkspaceHint(workspace, workspacePackageJson);
         if (migrationWorkspaceCheck) {
             checks.push(migrationWorkspaceCheck);