@sxl-studio/bridge 1.7.2 → 1.7.3

package/dist/figma-mcp-skills-parity.js

@@ -0,0 +1,434 @@
+import { ALL_AGENT_RECIPES } from "./agent-recipes.js";
+import { BRIDGE_SCHEMA_INDEX } from "./tools/schema-contracts.js";
+import { ensureBridgeToolCatalogue } from "./tools/catalogue-bootstrap.js";
+import { getBridgeToolCatalogue } from "./tools/registry.js";
+const SOURCE = {
+    skills: "https://help.figma.com/hc/en-us/articles/39166810751895-Figma-skills-for-MCP",
+    toolsAndPrompts: "https://developers.figma.com/docs/figma-mcp-server/tools-and-prompts/",
+    createSkills: "https://developers.figma.com/docs/figma-mcp-server/create-skills/",
+};
+const VERIFIED_AT = "2026-06-10";
+const COMMON_PREFLIGHT = [
+    "get_bridge_runtime_summary",
+    "route_intent",
+    "plan_workflow",
+    "preview_workflow",
+];
+const REQUIRED_COMPANION_SKILLS = [
+    "figma-use-figjam",
+    "figma-use-slides",
+    "figma-create-new-file",
+    "figma-generate-diagram",
+];
+export const FIGMA_MCP_SKILL_COMPATIBILITY_ALIASES = [
+    {
+        alias: "figma-code-connect-components",
+        mapsToOfficialSkill: "figma-code-connect",
+        sxlRecipe: "sxl-code-connect",
+        note: "Older/client-specific Code Connect skill naming. Treat it as figma-code-connect and use Bridge Code Connect context, suggestions, template, and binding tools.",
+    },
+    {
+        alias: "figma-implement-design",
+        sxlRecipe: "sxl-implement-design",
+        note: "Design-to-code alias used by some agent stacks. It is not in the current official Figma skills list, but Bridge routes it to read-only design context, screenshots, variables, and Code Connect hints before agent-side code edits.",
+    },
+    {
+        alias: "figma-create-design-system-rules",
+        sxlRecipe: "sxl-generate-library",
+        note: "Rule-generation alias used by some agent stacks. It is not in the current official Figma skills list, but Bridge routes it to SXL design-system, token, composition, docs, and Code Connect discovery before the agent writes client-specific rules.",
+    },
+];
+export const FIGMA_MCP_SKILL_PARITY_ENTRIES = [
+    {
+        officialSkill: "figma-use",
+        kind: "official-skill",
+        status: "covered-by-bridge-and-sxl",
+        bridgeTools: [
+            "get_plugin_status",
+            "get_capability_matrix",
+            "get_metadata",
+            "get_variable_defs",
+            "inspect_design_system",
+            "validate_screen_spec",
+            "build_screen",
+            "update_screen",
+            "import_variable_spec",
+            "import_style_spec",
+            "apply_coverage_suggestions",
+            "upload_assets",
+        ],
+        bridgeResources: [
+            "sxl://agent/recipes/sxl-use",
+            "sxl://agent/schemas/design-dsl-v1",
+            "sxl://agent/figma-mcp-parity",
+        ],
+        sxlRecipes: ["sxl-use", "sxl-generate-design", "sxl-generate-library", "sxl-audit"],
+        preferredFlow: [
+            ...COMMON_PREFLIGHT,
+            "Use the thick Bridge tool for the requested Figma Design operation.",
+            "Run dryRun/preview first when the tool supports it.",
+            "Commit only after approval and get_plugin_status confirms writesAllowed=true.",
+        ],
+        limitations: [
+            "Bridge covers active Figma Design files through SXL Studio Remote Connect.",
+            "FigJam and Slides writes remain official Figma MCP companion scope.",
+            "Bridge intentionally prefers typed commands over arbitrary use_figma JavaScript.",
+        ],
+        note: "This is the SXL-safe equivalent of figma-use for Figma Design: canvas reads/writes, variables, styles, components, documentation, and SXL workflows through explicit Bridge contracts.",
+    },
+    {
+        officialSkill: "figma-use-figjam",
+        kind: "official-skill",
+        status: "companion-figma-mcp-required",
+        bridgeTools: ["get_figma_mcp_parity", "get_figma_mcp_skills_parity", "get_bridge_runtime_summary", "plan_workflow"],
+        bridgeResources: [
+            "sxl://agent/recipes/figma-mcp-companion",
+            "sxl://agent/figma-mcp-parity",
+            "sxl://agent/figma-mcp-skills-parity",
+        ],
+        sxlRecipes: ["figma-mcp-companion"],
+        preferredFlow: [
+            "Use official Figma MCP use_figma with the figma-use-figjam skill.",
+            "Keep Bridge as read-only context for SXL/Figma Design follow-up work only after the user returns to a Figma Design file.",
+            "Do not translate FigJam boards into Figma Design frames through SXL Bridge.",
+        ],
+        limitations: [
+            "SXL Studio Remote Connect targets Figma Design plugin workflows, not FigJam boards.",
+            "Bridge can route and explain the handoff but should not fake FigJam stickies, sections, connectors, tables, or board semantics.",
+        ],
+        note: "The current official Figma MCP skill for FigJam is a companion path. Bridge remains the SXL/Figma Design automation layer once the workflow returns to a Design file.",
+    },
+    {
+        officialSkill: "figma-use-slides",
+        kind: "official-skill",
+        status: "companion-figma-mcp-required",
+        bridgeTools: ["get_figma_mcp_parity", "get_figma_mcp_skills_parity", "get_bridge_runtime_summary", "plan_workflow"],
+        bridgeResources: [
+            "sxl://agent/recipes/figma-mcp-companion",
+            "sxl://agent/figma-mcp-parity",
+            "sxl://agent/figma-mcp-skills-parity",
+        ],
+        sxlRecipes: ["figma-mcp-companion"],
+        preferredFlow: [
+            "Use official Figma MCP use_figma with the figma-use-slides skill.",
+            "Use Bridge only for SXL/Figma Design context when the task later targets a Design file.",
+            "Do not route slide deck creation, slide sections, speaker notes, or deck theme edits through the local plugin.",
+        ],
+        limitations: [
+            "Figma Slides is outside the SXL Studio plugin's active Figma Design canvas scope.",
+            "Bridge can route and explain the handoff but does not create Slides decks or slide-native content.",
+        ],
+        note: "Slides workflows require the official Figma MCP companion. This keeps Bridge honest about the local plugin's file-type boundary.",
+    },
+    {
+        officialSkill: "figma-swiftui",
+        kind: "official-skill",
+        status: "bridge-primary-with-agent-work",
+        bridgeTools: [
+            "get_design_context",
+            "get_metadata",
+            "get_screenshot",
+            "get_variable_defs",
+            "get_context_for_code_connect",
+            "get_code_connect_suggestions",
+            "generate_code_connect_template",
+        ],
+        bridgeResources: [
+            "sxl://agent/recipes/sxl-implement-design",
+            "sxl://agent/recipes/sxl-code-connect",
+            "sxl://agent/figma-mcp-parity",
+            "sxl://agent/figma-mcp-skills-parity",
+        ],
+        sxlRecipes: ["sxl-implement-design", "sxl-code-connect"],
+        preferredFlow: [
+            ...COMMON_PREFLIGHT,
+            "Ask whether the direction is Figma Design → SwiftUI code or SwiftUI code → Figma Design when ambiguous.",
+            "For Figma Design → SwiftUI, gather get_design_context, get_screenshot, get_variable_defs, and Code Connect context, then let the agent edit Swift code in the repository.",
+            "For SwiftUI code → Figma Design, use official Figma MCP companion or an explicit SXL Design DSL spec; Bridge should not invent a SwiftUI parser.",
+            "Verify repository changes with the project's iOS/Swift checks when available.",
+        ],
+        limitations: [
+            "Bridge provides active-file SXL/Figma context, screenshots, variables, and Code Connect hints; it does not implement a dedicated SwiftUI semantic parser.",
+            "Exact SwiftUI-to-Figma canvas generation remains official Figma MCP companion or future dedicated tooling.",
+        ],
+        note: "This entry covers the current official figma-swiftui skill without overclaiming: Bridge is useful for Figma Design context and Code Connect, while SwiftUI source edits are agent-side work.",
+    },
+    {
+        officialSkill: "figma-code-connect",
+        kind: "official-skill",
+        status: "covered-by-bridge-and-sxl",
+        bridgeTools: [
+            "get_context_for_code_connect",
+            "get_code_connect_suggestions",
+            "generate_code_connect_template",
+            "codeconnect_save_binding",
+            "codeconnect_get_registry",
+            "codeconnect_get_global_settings",
+            "codeconnect_get_selection_status",
+            "codeconnect_get_node_ui_status",
+        ],
+        bridgeResources: [
+            "sxl://agent/recipes/sxl-code-connect",
+            "sxl://agent/schemas/code-connect-context-v1",
+            "sxl://agent/schemas/code-connect-template-v1",
+        ],
+        sxlRecipes: ["sxl-code-connect"],
+        preferredFlow: [
+            ...COMMON_PREFLIGHT,
+            "get_context_for_code_connect",
+            "get_code_connect_suggestions",
+            "generate_code_connect_template with writeFile=false",
+            "Review generated template/binding metadata.",
+            "codeconnect_save_binding or write the reviewed .figma.ts template.",
+        ],
+        limitations: [
+            "Hosted repository/library context from the official remote MCP server may still be needed for published-library Code Connect at organization scale.",
+            "Bridge stores SXL binding metadata and local template guidance; it does not publish Figma libraries.",
+        ],
+        note: "Bridge covers the local-codebase and active-file SXL Code Connect workflow, including Storybook/docs/files/component API metadata and dry-run-first template generation.",
+    },
+    {
+        officialSkill: "figma-create-new-file",
+        kind: "official-skill",
+        status: "companion-figma-mcp-required",
+        bridgeTools: ["get_figma_mcp_parity", "get_figma_mcp_skills_parity", "get_bridge_runtime_summary"],
+        bridgeResources: [
+            "sxl://agent/recipes/figma-mcp-companion",
+            "sxl://agent/figma-mcp-parity",
+            "sxl://agent/figma-mcp-skills-parity",
+        ],
+        sxlRecipes: ["figma-mcp-companion"],
+        preferredFlow: [
+            "Use official Figma MCP create_new_file.",
+            "Open the created file in Figma and start SXL Studio Remote Connect.",
+            "Continue with Bridge/SXL tools for active-file work.",
+        ],
+        limitations: [
+            "Figma Plugin API cannot create a new Figma Design/FigJam/Slides file or select a drafts organization.",
+        ],
+        note: "Bridge should not fake new-file creation. It routes this official skill to the companion MCP and resumes once the file is open in SXL Studio.",
+    },
+    {
+        officialSkill: "figma-generate-diagram",
+        kind: "official-skill",
+        status: "companion-figma-mcp-required",
+        bridgeTools: ["get_figma_mcp_parity", "get_figma_mcp_skills_parity", "plan_workflow"],
+        bridgeResources: [
+            "sxl://agent/recipes/figma-mcp-companion",
+            "sxl://agent/figma-mcp-parity",
+            "sxl://agent/figma-mcp-skills-parity",
+        ],
+        sxlRecipes: ["figma-mcp-companion"],
+        preferredFlow: [
+            "Use official Figma MCP generate_diagram for Mermaid/natural-language diagrams.",
+            "Create or update a FigJam diagram through the companion MCP.",
+            "Return to Bridge only if the user later needs SXL/Figma Design documentation or component work.",
+        ],
+        limitations: [
+            "SXL Studio Bridge does not generate FigJam-native diagrams through the local plugin.",
+        ],
+        note: "Diagram generation is now an explicit official MCP companion skill, not an untracked future Bridge promise.",
+    },
+    {
+        officialSkill: "figma-generate-library",
+        kind: "example-skill",
+        status: "covered-by-bridge-and-sxl",
+        bridgeTools: [
+            "inspect_design_system",
+            "preview_export_variables",
+            "export_variables",
+            "import_variable_spec",
+            "import_style_spec",
+            "list_compositions",
+            "bulk_generate_compositions",
+            "audit_composition_drift",
+            "build_token_documentation",
+            "build_component_doc",
+            "build_doc_flow",
+            "codeconnect_save_binding",
+        ],
+        bridgeResources: [
+            "sxl://agent/recipes/sxl-generate-library",
+            "sxl://agent/recipes/sxl-doc-builder",
+            "sxl://agent/schemas/doc-spec-v2",
+            "sxl://agent/figma-mcp-skills-parity",
+        ],
+        sxlRecipes: ["sxl-generate-library", "sxl-doc-builder", "bulk-compositions", "composition-drift"],
+        preferredFlow: [
+            ...COMMON_PREFLIGHT,
+            "inspect_design_system",
+            "preview_export_variables before export_variables",
+            "import_variable_spec/import_style_spec with dryRun first for bulk foundations.",
+            "bulk_generate_compositions with dryRun first for component pages.",
+            "Render docs through build_token_documentation/build_component_doc/build_doc_flow.",
+        ],
+        limitations: [
+            "Bridge targets SXL Studio token/composition/library workflows inside an existing Figma Design file.",
+            "Create a new file first with official Figma MCP when no target file exists.",
+        ],
+        note: "SXL Bridge is intentionally stronger than the example skill for SXL Studio: it includes safe export defaults, composition drift, bulk regeneration, docs, and Code Connect metadata.",
+    },
+    {
+        officialSkill: "figma-generate-design",
+        kind: "example-skill",
+        status: "covered-by-bridge-and-sxl",
+        bridgeTools: [
+            "inspect_design_system",
+            "validate_screen_spec",
+            "build_screen",
+            "update_screen",
+            "find_components",
+            "build_mockup",
+            "apply_mockup_dataset",
+            "get_screenshot",
+            "get_variable_defs",
+        ],
+        bridgeResources: [
+            "sxl://agent/recipes/sxl-generate-design",
+            "sxl://agent/recipes/mockup-builder",
+            "sxl://agent/schemas/design-dsl-v1",
+            "sxl://agent/figma-mcp-skills-parity",
+        ],
+        sxlRecipes: ["sxl-generate-design", "mockup-builder", "sxl-use"],
+        preferredFlow: [
+            ...COMMON_PREFLIGHT,
+            "inspect_design_system",
+            "validate_screen_spec",
+            "build_screen with dryRun=true",
+            "Review resolved plan and component bindings.",
+            "build_screen or update_screen after approval.",
+        ],
+        limitations: [
+            "Bridge builds editable Figma Design screens from SXL Design DSL and actual components.",
+            "It does not perform the official generate_figma_design browser capture path; use official Figma MCP companion when that exact capture flow is required.",
+        ],
+        note: "This is the preferred SXL path for 'нарисуй экран в Figma': thick commands, design-system inspection, typed payload schemas, and dry-run-first application.",
+    },
+];
+function countByStatus(entries, status) {
+    return entries.filter((entry) => entry.status === status).length;
+}
+function buildValidResourceSet() {
+    return new Set([
+        "sxl://agent/recipes/index",
+        "sxl://agent/figma-mcp-parity",
+        "sxl://agent/figma-mcp-skills-parity",
+        "sxl://agent/performance-profile",
+        "sxl://agent/runtime-summary",
+        "sxl://agent/ultimate-readiness",
+        "sxl://agent/schemas/index",
+        ...ALL_AGENT_RECIPES.map((recipe) => `sxl://agent/recipes/${recipe.id}`),
+        ...BRIDGE_SCHEMA_INDEX.schemas.map((schema) => schema.uri),
+    ]);
+}
+export function buildFigmaMcpSkillsParityMatrix() {
+    ensureBridgeToolCatalogue();
+    const bridgeToolNames = new Set(getBridgeToolCatalogue().map((entry) => entry.name));
+    const bridgeResources = buildValidResourceSet();
+    const recipeIds = new Set(ALL_AGENT_RECIPES.map((recipe) => recipe.id));
+    const staleBridgeToolReferences = Array.from(new Set(FIGMA_MCP_SKILL_PARITY_ENTRIES.flatMap((entry) => entry.bridgeTools).filter((toolName) => !bridgeToolNames.has(toolName)))).sort();
+    const staleBridgeResourceReferences = Array.from(new Set(FIGMA_MCP_SKILL_PARITY_ENTRIES
+        .flatMap((entry) => entry.bridgeResources)
+        .filter((resourceUri) => !bridgeResources.has(resourceUri)))).sort();
+    const staleRecipeReferences = Array.from(new Set([
+        ...FIGMA_MCP_SKILL_PARITY_ENTRIES.flatMap((entry) => entry.sxlRecipes),
+        ...FIGMA_MCP_SKILL_COMPATIBILITY_ALIASES.map((alias) => alias.sxlRecipe),
+    ].filter((recipeId) => !recipeIds.has(recipeId)))).sort();
+    return {
+        version: 1,
+        verifiedAt: VERIFIED_AT,
+        source: SOURCE,
+        summary: {
+            officialSkillCount: FIGMA_MCP_SKILL_PARITY_ENTRIES.length,
+            officialSkills: FIGMA_MCP_SKILL_PARITY_ENTRIES.filter((entry) => entry.kind === "official-skill").length,
+            exampleSkills: FIGMA_MCP_SKILL_PARITY_ENTRIES.filter((entry) => entry.kind === "example-skill").length,
+            coveredByBridgeAndSxl: countByStatus(FIGMA_MCP_SKILL_PARITY_ENTRIES, "covered-by-bridge-and-sxl"),
+            bridgePrimaryWithAgentWork: countByStatus(FIGMA_MCP_SKILL_PARITY_ENTRIES, "bridge-primary-with-agent-work"),
+            companionRequired: countByStatus(FIGMA_MCP_SKILL_PARITY_ENTRIES, "companion-figma-mcp-required"),
+            compatibilityAliases: FIGMA_MCP_SKILL_COMPATIBILITY_ALIASES.length,
+            staleBridgeToolReferences,
+            staleBridgeResourceReferences,
+            staleRecipeReferences,
+        },
+        operatingModel: {
+            bridgePrimary: FIGMA_MCP_SKILL_PARITY_ENTRIES
+                .filter((entry) => entry.status === "covered-by-bridge-and-sxl")
+                .map((entry) => entry.officialSkill),
+            companionFigmaMcp: FIGMA_MCP_SKILL_PARITY_ENTRIES
+                .filter((entry) => entry.status === "companion-figma-mcp-required")
+                .map((entry) => entry.officialSkill),
+            agentImplementationRequired: FIGMA_MCP_SKILL_PARITY_ENTRIES
+                .filter((entry) => entry.status === "bridge-primary-with-agent-work")
+                .map((entry) => entry.officialSkill),
+        },
+        compatibilityAliases: [...FIGMA_MCP_SKILL_COMPATIBILITY_ALIASES],
+        entries: [...FIGMA_MCP_SKILL_PARITY_ENTRIES],
+    };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function stringArray(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+export function validateFigmaMcpSkillsParityPayload(value) {
+    const expectedSkills = FIGMA_MCP_SKILL_PARITY_ENTRIES.map((entry) => entry.officialSkill);
+    const expectedAliases = FIGMA_MCP_SKILL_COMPATIBILITY_ALIASES.map((alias) => alias.alias);
+    const errors = [];
+    if (!isRecord(value)) {
+        return {
+            ok: false,
+            officialSkillCount: 0,
+            compatibilityAliases: 0,
+            missingOfficialSkills: expectedSkills,
+            missingCompanionSkills: [...REQUIRED_COMPANION_SKILLS],
+            missingCompatibilityAliases: expectedAliases,
+            errors: ["Payload is not an object."],
+        };
+    }
+    const summary = isRecord(value["summary"]) ? value["summary"] : {};
+    const entries = Array.isArray(value["entries"]) ? value["entries"].filter(isRecord) : [];
+    const aliases = Array.isArray(value["compatibilityAliases"])
+        ? value["compatibilityAliases"].filter(isRecord)
+        : [];
+    const operatingModel = isRecord(value["operatingModel"]) ? value["operatingModel"] : {};
+    const officialSkillCount = typeof summary["officialSkillCount"] === "number" ? summary["officialSkillCount"] : 0;
+    const compatibilityAliases = typeof summary["compatibilityAliases"] === "number" ? summary["compatibilityAliases"] : 0;
+    const entryNames = new Set(entries.map((entry) => entry["officialSkill"]).filter((item) => typeof item === "string"));
+    const aliasNames = new Set(aliases.map((alias) => alias["alias"]).filter((item) => typeof item === "string"));
+    const companionSkills = new Set(stringArray(operatingModel["companionFigmaMcp"]));
+    const missingOfficialSkills = expectedSkills.filter((skill) => !entryNames.has(skill));
+    const missingCompanionSkills = REQUIRED_COMPANION_SKILLS.filter((skill) => !companionSkills.has(skill));
+    const missingCompatibilityAliases = expectedAliases.filter((alias) => !aliasNames.has(alias));
+    if (value["verifiedAt"] !== VERIFIED_AT) {
+        errors.push(`verifiedAt must be ${VERIFIED_AT}.`);
+    }
+    if (officialSkillCount !== expectedSkills.length) {
+        errors.push(`officialSkillCount must be ${expectedSkills.length}.`);
+    }
+    if (entries.length !== expectedSkills.length) {
+        errors.push(`entries length must be ${expectedSkills.length}.`);
+    }
+    if (compatibilityAliases !== expectedAliases.length) {
+        errors.push(`compatibilityAliases must be ${expectedAliases.length}.`);
+    }
+    if (missingOfficialSkills.length > 0) {
+        errors.push(`Missing official skills: ${missingOfficialSkills.join(", ")}.`);
+    }
+    if (missingCompanionSkills.length > 0) {
+        errors.push(`Missing companion skills: ${missingCompanionSkills.join(", ")}.`);
+    }
+    if (missingCompatibilityAliases.length > 0) {
+        errors.push(`Missing compatibility aliases: ${missingCompatibilityAliases.join(", ")}.`);
+    }
+    return {
+        ok: errors.length === 0,
+        officialSkillCount,
+        compatibilityAliases,
+        missingOfficialSkills,
+        missingCompanionSkills,
+        missingCompatibilityAliases,
+        errors,
+    };
+}
+//# sourceMappingURL=figma-mcp-skills-parity.js.map

package/dist/figma-mcp-skills-parity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"figma-mcp-skills-parity.js","sourceRoot":"","sources":["../src/figma-mcp-skills-parity.ts"],"names":[],"mappings":"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"}

package/dist/figma-rest-diagnostics.d.ts

@@ -0,0 +1,50 @@
+import { type FigmaRestAuthMode, type FigmaRestClientOptions } from "./figma-rest.js";
+export type FigmaRestDiagnosticCheckId = "whoami" | "fileMetadata" | "fileNodes" | "fileImages" | "fileImageFills" | "fileComponents" | "fileComponentSets" | "fileStyles" | "teamComponents" | "teamComponentSets" | "teamStyles" | "variablesLocal" | "variablesPublished";
+export declare const FIGMA_REST_DIAGNOSTIC_CHECK_IDS: readonly ["whoami", "fileMetadata", "fileNodes", "fileImages", "fileImageFills", "fileComponents", "fileComponentSets", "fileStyles", "teamComponents", "teamComponentSets", "teamStyles", "variablesLocal", "variablesPublished"];
+export type FigmaRestDiagnosticStatus = "pass" | "warn" | "fail" | "skip";
+export type FigmaRestDiagnosticCheck = {
+    id: FigmaRestDiagnosticCheckId;
+    endpoint: string | null;
+    status: FigmaRestDiagnosticStatus;
+    durationMs: number;
+    httpStatus?: number;
+    message: string;
+    requiredScopes: string[];
+    requirements: string[];
+    retryable: boolean;
+};
+export type FigmaRestDiagnosticReport = {
+    ok: boolean;
+    status: "pass" | "warn" | "fail";
+    version: 1;
+    generatedAt: string;
+    auth: {
+        tokenConfigured: boolean;
+        tokenEnv: string | null;
+        authMode: FigmaRestAuthMode;
+        apiBaseUrl: string;
+    };
+    inputs: {
+        fileKey: string | null;
+        teamId: string | null;
+        nodeIds: string[];
+    };
+    summary: {
+        requested: number;
+        pass: number;
+        warn: number;
+        fail: number;
+        skip: number;
+    };
+    checks: FigmaRestDiagnosticCheck[];
+    recommendations: string[];
+    sources: string[];
+};
+export type FigmaRestDiagnosticOptions = FigmaRestClientOptions & {
+    checks?: FigmaRestDiagnosticCheckId[];
+    fileKey?: string;
+    url?: string;
+    teamId?: string;
+    nodeIds?: string[];
+};
+export declare function diagnoseFigmaRest(options?: FigmaRestDiagnosticOptions): Promise<FigmaRestDiagnosticReport>;