_meta.global.tsx

import { SidebarSeparator } from "@/components/ui/sidebar-separator";

export const docsIntroItems = {
  "search-bar-docs": {
    type: "separator",
    title: "__INKEEP_SEARCH_DOCS__",
  },
  index: {
    display: "hidden",
    theme: {
      layout: "full",
      toc: false,
      pagination: false,
    },
  },
};

const meta = {
  // hide static pages from sidebar
  "*": {
    display: "hidden",
  },
  docs: {
    title: "Documentation",
    type: "page",
    display: "children",
    items: {
      ...docsIntroItems,
      /*
        SDKs
      */
      "sdks-section": {
        type: "separator",
        title: <SidebarSeparator>{"SDKs"}</SidebarSeparator>,
      },
      sdks: {
        title: "SDKs",
        display: "children",
        items: {
          introduction: {
            title: "Introduction",
          },
          "core-concepts": {
            title: "Core Concepts",
          },
          "create-client-sdks": {
            title: "Generate SDKs",
          },
          "prep-openapi": {
            title: "Prepare OpenAPI Spec",
            items: {
              "best-practices": {
                title: "Best Practices",
              },
              linting: {
                title: "Linting",
              },
              merge: {
                title: "Merge Documents",
              },
              overlays: {
                title: "Overlays",
              },
              transformations: {
                title: "Transformations",
              },
              maintenance: {
                title: "Maintenance",
              },
            },
          },
          customize: {
            title: "Customize",
            items: {
              basics: {
                title: "Customization Basics",
              },
              structure: {
                title: "Structure",
              },
              "data-model": {
                title: "Data Model",
                items: {
                  types: {
                    title: "Types",
                  },
                  enums: {
                    title: "Enums",
                  },
                  "oneof-schemas": {
                    title: "OneOf",
                  },
                  "allof-schemas": {
                    title: "AllOf",
                  },
                  "complex-numbers": {
                    title: "Complex Numbers",
                  },
                  additionalproperties: {
                    title: "Additional Properties",
                  },
                },
              },
              methods: {
                title: "Customize methods",
              },
              responses: {
                title: "Responses & Error Handling",
                items: {
                  responses: {
                    title: "Customize Responses",
                  },
                  errors: {
                    title: "Error Handling",
                  },
                },
              },
              globals: {
                title: "Global Parameters",
              },
              servers: {
                title: "Configure servers",
              },
              deprecations: {
                title: "Deprecations",
              },
              authentication: {
                title: "Security & Authentication",
                items: {
                  overview: {
                    title: "Overview",
                  },
                  configuration: {
                    title: "Configuration Options",
                  },
                  "simple-schemes": {
                    title: "Standard security schemes",
                  },
                  oauth: {
                    title: "OAuth 2.0 Authentication",
                  },
                  "custom-security-schemes": {
                    title: "Custom Security Schemes",
                  },
                  "security-callbacks": {
                    title: "Security Callbacks",
                  },
                },
              },
              runtime: {
                title: "SDK Behavior",
                items: {
                  retries: {
                    title: "Enable Retries",
                  },
                  timeouts: {
                    title: "Enable Timeouts",
                  },
                  pagination: {
                    title: "Enable Pagination",
                  },
                  polling: {
                    title: "Enable Polling",
                  },
                  streaming: {
                    title: "Enable Streaming",
                  },
                  "server-sent-events": {
                    title: "Enable Server-Sent Events",
                  },
                  "jsonl-events": {
                    title: "Enable JSON Lines Responses",
                  },
                  "custom-http-client": {
                    title: "Customize HTTP Client",
                  },
                  "override-accept-headers": {
                    title: "Override accept headers",
                  },
                },
              },
              "data-transforms": {
                title: "Data transforms",
              },
              webhooks: {
                title: "Add webhooks to your SDKs",
              },
              code: {
                title: "Modify SDK code",
                items: {
                  "sdk-hooks": {
                    title: "Hooks",
                  },
                  "custom-code": {
                    title: "Custom code",
                    items: {
                      "custom-code": {
                        title: "Overview",
                      },
                      "custom-code-best-practices": {
                        title: "Best practices",
                      },
                      "custom-code-reference": {
                        title: "Technical reference",
                      },
                      genignore: {
                        title: "Ignoring files",
                      },
                    },
                  },
                  "patch-files": {
                    title: "Patch files",
                    items: {
                      "patch-files": {
                        title: "Overview",
                      },
                      "patch-files-reference": {
                        title: "Technical reference",
                      },
                    },
                  },
                  "code-regions": {
                    title: "Code regions",
                    items: {
                      overview: {
                        title: "Custom code regions",
                      },
                      python: {
                        title: "Python",
                      },
                      typescript: {
                        title: "TypeScript",
                      },
                      java: {
                        title: "Java",
                      },
                    },
                  },
                },
              },
              typescript: {
                title: "TypeScript",
                items: {
                  "additional-index-exports": {
                    title: "Additional index exports",
                  },
                  "configuring-module-format": {
                    title: "Configuring Module Format",
                  },
                  "disabling-barrel-files": {
                    title: "Disabling Barrel Files",
                  },
                  "model-validation-and-serialization": {
                    title: "Model validation and serialization",
                  },
                  "property-naming": {
                    title: "Control property casing: snake, camel",
                  },
                  "react-hooks": {
                    title: "Generating React Hooks from OpenAPI",
                  },
                },
              },
            },
          },
          manage: {
            title: "Manage",
            items: {
              versioning: {
                title: "Version Control",
              },
              "sdk-changelogs": {
                title: "SDK Changelogs",
              },
              "github-setup": {
                title: "Github Setup",
              },
              "sdk-sandbox": {
                title: "Enable Sandbox",
              },
              migrate: {
                title: "Migrate",
              },
              "forward-compatibility": {
                title: "Forward Compatibility",
              },
              "breaking-changes": {
                title: "Handle Breaking Changes",
              },
            },
          },
          "publish-sdk": {
            title: "Publish SDK",
          },
          "sdk-contract-testing": {
            title: "SDK Contract Testing",
            items: {
              "bootstrapping-test-generation": {
                title: "Bootstrapping SDK Tests",
              },
              "customizing-sdk-tests": {
                title: "Customizing SDK Tests",
              },
              "github-actions": {
                title: "Testing in Github Actions",
              },
              "openapi-in-tests": {
                title: "OpenAPI data in Tests",
              },
              "running-tests": {
                title: "Running SDK Tests",
              },
              "custom-contract-tests": {
                title: "Custom Contract Tests",
              },
            },
          },
          "sdk-docs": {
            title: "SDK Documentation",
            items: {
              "edit-readme": {
                title: "Edit README",
              },
              integrations: {
                title: "Integrate with docs provider",
                items: {
                  readme: {
                    title: "README.com",
                  },
                  mintlify: {
                    title: "Mintlify",
                  },
                  scalar: {
                    title: "Scalar",
                  },
                  bump: {
                    title: "Bump.sh",
                  },
                },
              },
              "code-samples": {
                title: "Code Samples",
                items: {
                  "generate-code-samples": {
                    title: "Generate Code Samples",
                  },
                  "code-samples-api": {
                    title: "Code Samples API",
                  },
                  "automated-code-sample-urls": {
                    title: "Automated Code Sample URLs",
                  },
                },
              },
            },
          },
          languages: {
            title: "Language Design",
            items: {
              philosophy: {
                title: "Design philosophy",
              },
              maturity: {
                title: "Maturity",
              },
              typescript: {
                title: "TypeScript",
                items: {
                  "methodology-ts": {
                    title: "TypeScript design",
                  },
                  "oss-comparison-ts": {
                    title: "Speakeasy vs. OSS generators",
                  },
                  "migrating-from-oss": {
                    title: "Migrating from OpenAPI Generator to Speakeasy",
                  },
                  "feature-support": {
                    title: "Feature reference",
                  },
                  "standalone-functions": {
                    title: "Standalone functions",
                  },
                  "dependency-management": {
                    title: "Dependency management",
                  },
                },
              },
              python: {
                title: "Python",
                items: {
                  "methodology-python": {
                    title: "Python design",
                  },
                  "oss-comparison-python": {
                    title: "Speakeasy vs. OSS generators",
                  },
                  "feature-support": {
                    title: "Feature reference",
                  },
                },
              },
              golang: {
                title: "Go",
                items: {
                  "methodology-go": {
                    title: "Go design",
                  },
                  "oss-comparison-go": {
                    title: "Speakeasy vs. OSS generators",
                  },
                  "feature-support": {
                    title: "Feature reference",
                  },
                },
              },
              java: {
                title: "Java",
                items: {
                  "methodology-java": {
                    title: "Java design",
                  },
                  "oss-comparison-java": {
                    title: "Speakeasy vs. OSS generators",
                  },
                  "feature-support": {
                    title: "Feature reference",
                  },
                },
              },
              csharp: {
                title: "C#",
                items: {
                  "methodology-csharp": {
                    title: "C# design",
                  },
                  "oss-comparison-csharp": {
                    title: "Speakeasy vs. OSS generators",
                  },
                },
              },
              php: {
                title: "PHP",
                items: {
                  "methodology-php": {
                    title: "PHP design",
                  },
                  "oss-comparison-php": {
                    title: "Speakeasy vs. OSS generators",
                  },
                },
              },
              ruby: {
                title: "Ruby",
                items: {
                  "methodology-ruby": {
                    title: "Ruby design",
                  },
                },
              },
              rust: {
                title: "Rust [coming]",
                items: {
                  "methodology-rust": {
                    title: "Rust design [coming soon]",
                  },
                },
              },
              cpp: {
                title: "C++ [coming]",
                items: {
                  "methodology-cpp": {
                    title: "C++ design [coming soon]",
                  },
                },
              },
            },
          },
          guides: {
            title: "Guides",
            items: {
              overlays: {
                title: "Overlays",
              },
              hooks: {
                title: "Hooks",
              },
              "code-samples-without-github-actions": {
                title: "Populate Code Samples Without GitHub Actions",
              },
              "sdk-preview-breaking-changes": {
                title: "SDK preview and breaking change detection",
              },
            },
          },
        },
      },
      "docs-md": {
        // Hide DocsMD docs while we're still in private beta. We'll make them visible
        // once we hit public beta in July.
        display: "hidden",
      },

      /*
                Terraform
              */
      "terraform-section": {
        type: "separator",
        title: <SidebarSeparator>{"Terraform"}</SidebarSeparator>,
      },
      terraform: {
        title: "Terraform",
        display: "children",
        items: {
          "create-terraform": {
            title: "Generate Terraform Provider",
          },
          "publish-terraform": {
            title: "Publish Terraform Provider",
          },
          "customize-terraform": {
            title: "Customize Terraform",
            items: {
              index: {
                title: "Overview",
              },
              "entity-mapping": {
                title: "Map API Entities",
              },
              "provider-configuration": {
                title: "Provider Configuration",
              },
              "resource-configuration": {
                title: "Resource Configuration",
              },
              "property-customization": {
                title: "Property Customization",
              },
              "validation-dependencies": {
                title: "Validation and Dependencies",
              },
              "plan-modification": {
                title: "Plan Modification",
              },
              "advanced-features": {
                title: "Advanced Features",
              },
              "schema-keywords": {
                title: "Schema Keywords",
              },
              testing: {
                display: "hidden",
              },
              extensions: {
                display: "hidden",
              },
            },
          },
          "terraform-guides": {
            title: "Guides",
          },
        },
      },
      /*
                CLI Generation
              */
      "cli-generation-section": {
        type: "separator",
        title: <SidebarSeparator>{"CLI Generation"}</SidebarSeparator>,
      },
      "cli-generation": {
        title: "CLI Generation",
        display: "children",
        items: {
          "create-cli": {
            title: "Generate CLI",
          },
          index: {
            title: "Overview",
          },
          "customize-cli": {
            title: "Customize CLI",
          },
          "distribute-cli": {
            title: "Distribute CLI",
          },
        },
      },
      /*
                CLI & Reference
              */
      "cli-section": {
        type: "separator",
        title: <SidebarSeparator>{"CLI"}</SidebarSeparator>,
      },
      "speakeasy-reference": {
        title: "Speakeasy",
        items: {
          cli: {
            title: "CLI",
            items: {
              "getting-started": {
                title: "Getting Started",
              },
              docker: {
                title: "Using with Docker",
              },
              "mise-toolkit": {
                title: "Using with mise toolkit",
              },
            },
          },
          generation: {
            title: "Generation Config",
            items: {
              "gen-yaml": {
                title: "Config File",
              },
              "ci-cd-pipeline": {
                title: "CI/CD Pipeline",
              },
              "ts-config": {
                title: "TypeScript Configuration",
              },
              "python-config": {
                title: "Python Configuration",
              },
              "go-config": {
                title: "Go Configuration",
              },
              "java-config": {
                title: "Java Configuration",
              },
              "csharp-config": {
                title: "C# Configuration",
              },
              "php-config": {
                title: "PHP Configuration",
              },
              "ruby-config": {
                title: "Ruby Configuration",
              },
              "terraform-config": {
                title: "Terraform Configuration",
              },
              "mcp-server-config": {
                title: "MCP Server Configuration",
              },
              "cli-config": {
                title: "CLI Configuration",
              },
            },
          },
          supported: {
            title: "Supported",
          },
          extensions: {
            title: "Extensions",
          },
          "workflow-file": {
            title: "Workflow File",
          },
        },
      },
      /*
                Standalone MCP
              */
      "standalone-mcp-section": {
        type: "separator",
        title: <SidebarSeparator>{"Standalone MCP"}</SidebarSeparator>,
      },
      "standalone-mcp": {
        title: "Standalone MCP",
        display: "children",
        items: {
          overview: {
            title: "Introduction",
          },
          "build-server": {
            title: "Generate MCP Servers from OpenAPI Documents",
          },
          "cloudflare-deployment": {
            title: "Deploy to Cloudflare Workers",
          },
          "custom-prompts": {
            title: "Custom Prompts",
          },
          "custom-resources": {
            title: "Custom Resources",
          },
          "customize-tools": {
            title: "Customize Tools",
          },
          "remote-mcp-servers": {
            title: "Adapting Speakeasy MCP Servers for Remote Deployment",
          },
          "eval-command": {
            title: "Test with the Eval Command",
          },
          "setting-up-oauth": {
            title: "Add OAuth to an MCP Server",
          },
        },
      },
      mcp: {
        display: "children",
        items: {
          index: {
            title: "Docs home",
            theme: {
              toc: false,
              layout: "full",
            },
          },
          "why-gram": {
            title: "Why the AI Control Plane?",
          },
          "getting-started": {
            title: "Getting started",
            items: {
              typescript: {
                title: "Use TypeScript (Speakeasy Functions)",
              },
              openapi: {
                title: "Use an OpenAPI spec",
              },
            },
          },
          /*
            Build
          */
          "__group-build": {
            type: "separator",
            title: <SidebarSeparator>{"Build"}</SidebarSeparator>,
          },
          build: {
            title: "Build",
            display: "children",
            items: {
              "gram-functions": {
                title: "Creating TypeScript tools",
                items: {
                  "functions-framework": {
                    title: "Using the Functions Framework",
                  },
                  "tool-annotations": {
                    title: "Tool annotations",
                  },
                  "tool-tags": {
                    title: "Tool tags",
                  },
                  "mcp-sdk": {
                    title: "Using the MCP SDK",
                  },
                  "configuring-environments": {
                    title: "Configuring environments",
                  },
                  "build-deploy": {
                    title: "Build and deploy",
                  },
                },
              },
              toolsets: {
                title: "Creating toolsets",
                items: {
                  "custom-toolsets": {
                    title: "Curate a custom toolset",
                  },
                  "create-default-toolset": {
                    title: "Create a default toolset",
                  },
                  "advanced-tool-curation": {
                    title: "Advanced tool curation",
                  },
                  "configuring-environments": {
                    title: "Configure environments",
                  },
                  "attach-environments-to-sources": {
                    title: "Attach environments to tool sources",
                  },
                  "test-toolsets": {
                    title: "Test toolsets",
                  },
                  "dynamic-toolsets": {
                    title: "Dynamic toolsets (experimental)",
                  },
                  "response-filtering": {
                    title: "Response filtering (experimental)",
                  },
                },
              },
              hosting: {
                title: "Hosting MCP servers",
                items: {
                  "deploy-mcp-server": {
                    title: "Deploy an MCP server",
                  },
                  "tool-filtering": {
                    title: "Tag-based tool filtering",
                  },
                  "tool-call-healing": {
                    title: "Tool call healing",
                  },
                  "publish-gram-server-mcp-registry": {
                    title: "Publish to MCP Registry",
                  },
                },
              },
              integrate: {
                title: "Integrate MCP servers",
                items: {
                  agents: {
                    title: "Agent Frameworks",
                    items: {
                      "using-langchain-with-gram-mcp-servers": {
                        title: "LangChain",
                      },
                      "using-openai-agents-sdk-with-gram-mcp-servers": {
                        title: "OpenAI Agents SDK",
                      },
                      "using-openai-apps-sdk-with-gram-mcp-servers": {
                        title: "OpenAI Apps SDK",
                      },
                      "using-mastra-with-gram-mcp-servers": {
                        title: "Mastra",
                      },
                      "using-pydantic-ai-with-gram-mcp-servers": {
                        title: "Pydantic AI",
                      },
                      "using-vellum-workflows-sdk-with-gram-mcp-servers": {
                        title: "Vellum",
                      },
                    },
                  },
                  clients: {
                    title: "Coding assistants & IDEs",
                    items: {
                      "using-chatgpt-developer-mode-with-gram": {
                        title: "ChatGPT Developer mode",
                      },
                      "using-claude-code-with-gram-mcp-servers": {
                        title: "Claude Code",
                      },
                      "using-claude-desktop-with-gram-mcp-server": {
                        title: "Claude Desktop",
                      },
                      "using-cline-with-gram-mcp-server": {
                        title: "Cline",
                      },
                      "using-cursor-with-gram-mcp-server": {
                        title: "Cursor",
                      },
                      "using-gemini-cli-with-gram-mcp-servers": {
                        title: "Gemini CLI",
                      },
                      "using-mistral-with-gram-mcp-servers": {
                        title: "Mistral",
                      },
                      "using-n8n-with-gram-mcp-servers": {
                        title: "n8n",
                      },
                      "using-roo-code-with-gram-mcp-server": {
                        title: "Roo Code",
                      },
                      "using-vellum-agents-with-gram-mcp-servers": {
                        title: "Vellum Agents",
                      },
                      "using-your-ide-with-gram-mcp-server": {
                        title: "IDE",
                      },
                      "using-zapier-with-mcp": {
                        title: "Zapier",
                      },
                      troubleshooting: {
                        title: "Troubleshooting",
                      },
                    },
                  },
                  "api-clients": {
                    title: "Other tools",
                    items: {
                      "using-anthropic-api-with-gram-mcp-servers": {
                        title: "Anthropic API",
                      },
                      "using-openai-api-with-gram-mcp-servers": {
                        title: "OpenAI Responses API",
                      },
                      "using-vercel-ai-sdk-with-gram-mcp-servers": {
                        title: "Vercel AI SDK",
                      },
                    },
                  },
                  "export-server-configuration": {
                    title: "Export server configuration",
                  },
                },
              },
              examples: {
                title: "Examples",
                items: {
                  "adding-ai-chat-to-your-app": {
                    title: "Add AI chat to an existing app",
                  },
                  "oauth-external-server": {
                    title: "Build MCP with external OAuth",
                  },
                  "deploy-from-github-actions": {
                    title: "Deploy from GitHub Actions",
                  },
                  "creating-taskmaster-mcp-server": {
                    title: "Create a Taskmaster MCP server",
                  },
                  "consuming-external-apis": {
                    title: "Connect to external APIs",
                  },
                  "open-ai-apps-sdk": {
                    title: "Build a ChatGPT App",
                  },
                  "using-environments-with-vercel-ai-sdk": {
                    title: "Using environments with the Vercel AI SDK",
                  },
                },
              },
            },
          },
          /*
            Catalog
          */
          "__group-catalog": {
            type: "separator",
            title: <SidebarSeparator>{"Catalog"}</SidebarSeparator>,
          },
          catalog: {
            title: "Catalog",
            display: "children",
            items: {
              overview: {
                title: "Catalog overview",
              },
              "sub-catalogs": {
                title: "Sub catalogs",
              },
            },
          },
          /*
            Secure
          */
          "__group-secure": {
            type: "separator",
            title: <SidebarSeparator>{"Secure"}</SidebarSeparator>,
          },
          secure: {
            title: "Secure",
            display: "children",
            items: {
              security: {
                title: "Security overview",
              },
              "adding-oauth-servers": {
                title: "Add OAuth to MCP servers",
              },
              "add-oauth-functions": {
                title: "Add OAuth to Speakeasy Functions",
              },
              "oauth-proxy-for-internal-servers": {
                title: "OAuth proxy for internal servers",
              },
              "public-private-servers": {
                title: "Control server visibility",
              },
              "api-keys": {
                title: "API keys",
              },
              environments: {
                title: "Environments",
              },
            },
          },
          /*
            Observe
          */
          "__group-observe": {
            type: "separator",
            title: <SidebarSeparator>{"Observe"}</SidebarSeparator>,
          },
          observe: {
            title: "Observe",
            display: "children",
            items: {
              insights: {
                title: "Insights (Beta)",
                items: {
                  logs: {
                    title: "Logs",
                  },
                  metrics: {
                    title: "Metrics",
                  },
                  "api-reference": {
                    title: "API reference",
                  },
                },
              },
              "agents-api": {
                title: "Agents API (Beta)",
                items: {
                  overview: {
                    title: "Agents API overview",
                  },
                  "billing-and-usage": {
                    title: "Billing and usage",
                  },
                  "example-usage": {
                    title: "Usage examples",
                  },
                },
              },
            },
          },
          /*
            Technical Reference
          */
          "__group-reference": {
            type: "separator",
            title: <SidebarSeparator>{"Technical Reference"}</SidebarSeparator>,
          },
          reference: {
            title: "Technical Reference",
            display: "children",
            items: {
              concepts: {
                title: "Concepts",
                items: {
                  "tool-definitions": {
                    title: "Tool definitions",
                  },
                  toolsets: {
                    title: "Toolsets",
                  },
                  "tool-variations": {
                    title: "Tool variations",
                  },
                  "tool-sources": {
                    title: "Tool sources",
                  },
                  deployments: {
                    title: "Deployments",
                  },
                },
              },
              "command-line": {
                title: "CLI reference",
                items: {
                  install: {},
                  auth: {},
                  whoami: {},
                  stage: {},
                  "stage-function": {},
                  "stage-openapi": {},
                  push: {},
                  status: {},
                  update: {},
                },
              },
            },
          },
        },
      },

      /*
            Support
          */
      // "support-section": {
      //   type: "separator",
      //   title: <SidebarSeparator>{"Support"}</SidebarSeparator>,
      // },
      // "enterprise-support": {
      //   title: "Enterprise Support",
      // },
      // // Privacy & Security
      // "privacy-security-section": {
      //   type: "separator",
      //   title: <SidebarSeparator>{"Privacy & Security"}</SidebarSeparator>,
      // },
      // "product-security": {
      //   title: "Product Security",
      // },
      // "privacy-policy": {
      //   title: "Privacy Policy",
      // },
      // "terms-of-service": {
      //   title: "Terms of Service",
      // },
    },
  },
  openapi: {
    title: "OpenAPI Hub",
    type: "page",
    display: "children",
    items: {
      "search-bar-openapi": {
        type: "separator",
        title: "__INKEEP_SEARCH__",
      },
      index: {
        title: "Introduction",
        theme: {
          layout: "full",
          toc: false,
        },
      },
      // Start standard OpenAPI order
      info: {
        title: "Info",
      },
      servers: {
        title: "Servers",
        items: {
          "server-variables": {
            title: "Server Variables",
          },
        },
      },
      security: {
        title: "Security",
        items: {
          "security-schemes": {
            title: "Security Schemes",
            items: {
              "security-api-key": {
                title: "API Key",
              },
              "security-http": {
                title: "HTTP Authentication",
              },
              "security-mutualtls": {
                title: "Mutual TLS",
              },
              "security-oauth2": {
                title: "OAuth 2.0",
              },
              "security-openid": {
                title: "OpenID Connect",
              },
            },
          },
          "custom-auth": {
            title: "Custom Authentication",
          },
        },
      },
      paths: {
        title: "Paths",
      },
      operations: {
        title: "Operations",
      },
      content: {
        title: "Content & Media",
        items: {
          "file-uploads": {
            title: "File Uploads",
          },
          "server-sent-events": {
            title: "Server-Sent Events",
          },
          jsonl: {
            title: "JSONL",
          },
        },
      },
      schemas: {
        title: "Data Types",
        items: {
          strings: {
            title: "Strings",
          },
          numbers: {
            title: "Numbers",
          },
          booleans: {
            title: "Booleans",
          },
          null: {
            title: "Null",
          },
          arrays: {
            title: "Arrays",
          },
          objects: {
            title: "Objects",
            items: {
              polymorphism: {
                title: "Polymorphism",
              },
              xml: {
                title: "XML",
              },
            },
          },
          enums: {
            title: "Enums",
          },
          composition: {
            title: "Composition",
          },
        },
      },
      requests: {
        title: "Requests",
        items: {
          parameters: {
            title: "Parameters",
            items: {
              "path-parameters": {
                title: "Path Parameters",
              },
              "query-parameters": {
                title: "Query Parameters",
              },
              "header-parameters": {
                title: "Header Parameters",
              },
              "cookie-parameters": {
                title: "Cookie Parameters",
              },
            },
          },
        },
      },
      responses: {
        title: "Responses",
        items: {
          errors: {
            title: "Errors",
          },
          "rate-limiting": {
            title: "Rate Limiting",
          },
          headers: {
            title: "Headers",
          },
          links: {
            title: "Links",
          },
        },
      },
      components: {
        title: "Components",
      },
      tags: {
        title: "Tags",
      },
      "external-documentation": {
        title: "External Documentation",
      },
      references: {
        title: "References ($ref)",
      },
      examples: {
        title: "Examples",
      },
      // Extensions and other concepts
      extensions: {
        title: "Extensions",
      },
      overlays: {
        title: "Overlays",
      },
      // Advanced features
      webhooks: {
        title: "Webhooks",
      },
      // Additional tools and frameworks
      arazzo: {
        title: "Arazzo",
      },
      frameworks: {
        title: "Frameworks",
        items: {
          // JavaScript/TypeScript Frameworks
          "js-ts-frameworks": {
            type: "separator",
            title: (
              <SidebarSeparator>{"JavaScript/TypeScript"}</SidebarSeparator>
            ),
          },
          nestjs: {
            title: "NestJS",
          },
          fastify: {
            title: "Fastify",
          },
          hono: {
            title: "Hono",
          },
          trpc: {
            title: "tRPC",
          },
          tsoa: {
            title: "tsoa",
          },
          typespec: {
            title: "TypeSpec",
          },
          elysia: {
            title: "Elysia",
          },
          zod: {
            title: "Zod",
            items: {
              "zod-v3": {
                title: "Zod v3",
              },
            },
          },

          // Python Frameworks
          "python-frameworks": {
            type: "separator",
            title: <SidebarSeparator>{"Python"}</SidebarSeparator>,
          },
          fastapi: {
            title: "FastAPI",
          },
          django: {
            title: "Django",
          },
          flask: {
            title: "Flask",
          },
          pydantic: {
            title: "Pydantic",
          },

          // Go Frameworks
          "go-frameworks": {
            type: "separator",
            title: <SidebarSeparator>{"Go"}</SidebarSeparator>,
          },
          goa: {
            title: "Goa",
          },
          "grpc-gateway": {
            title: "gRPC-Gateway",
          },
          gnostic: {
            title: "Gnostic",
          },

          // Java Frameworks
          "java-frameworks": {
            type: "separator",
            title: <SidebarSeparator>{"Java"}</SidebarSeparator>,
          },
          springboot: {
            title: "Spring Boot",
          },

          // PHP Frameworks
          "php-frameworks": {
            type: "separator",
            title: <SidebarSeparator>{"PHP"}</SidebarSeparator>,
          },
          laravel: {
            title: "Laravel",
          },
          // Ruby Frameworks
          "ruby-frameworks": {
            type: "separator",
            title: <SidebarSeparator>{"Ruby"}</SidebarSeparator>,
          },
          rails: {
            title: "Ruby on Rails",
          },
        },
      },
      pagination: {
        title: "Pagination",
      },
      guides: {
        title: "Guides",
      },
      "release-notes-section": {
        type: "separator",
        title: <SidebarSeparator>{"Release Notes"}</SidebarSeparator>,
      },
      "release-notes": {
        title: "OpenAPI Release Notes",
      },
    },
  },
  "api-design": {
    title: "API Design",
    type: "page",
    display: "children",
    items: {
      "search-bar-api-design": {
        type: "separator",
        title: "__INKEEP_SEARCH__",
      },
      index: {
        title: "Introduction",
        theme: {
          layout: "full",
          toc: false,
        },
      },
      "basics-section": {
        type: "separator",
        title: <SidebarSeparator>{"API Design Basics"}</SidebarSeparator>,
      },
      "picking-architectures": {
        title: "Picking an architecture",
      },
      urls: {
        title: "Structuring URLs",
      },
      "http-methods": {
        title: "HTTP Methods",
      },
      parameters: {
        title: "Request parameters",
      },
      "data-formats": {
        title: "Data Formats",
      },
      "request-body": {
        title: "Request Body",
      },
      "status-codes": {
        title: "Status Codes",
      },
      responses: {
        title: "Response Body",
      },
      "advanced-section": {
        type: "separator",
        title: <SidebarSeparator>{"Advanced Considerations"}</SidebarSeparator>,
      },
      "file-uploads": {
        title: "File uploads",
      },
      pagination: {
        title: "Pagination",
      },
      "filtering-responses": {
        title: "Filtering responses",
      },
      caching: {
        title: "Caching",
      },
      errors: {
        title: "Returning Errors",
      },
      "rate-limiting": {
        title: "Rate limiting",
      },
      versioning: {
        title: "Versioning",
      },
      "product-section": {
        type: "separator",
        title: <SidebarSeparator>{"Productizing APIs"}</SidebarSeparator>,
      },
      "expose-api-publicly": {
        title: "Expose APIs publicly",
      },
      monetization: {
        title: "Monetizing APIs",
      },
      "developer-experience": {
        title: "Developer experience",
      },
      documentation: {
        title: "Documentation",
      },
      consistency: {
        title: "Enforcing consistency",
      },
      security: {
        title: "Security",
      },
      "api-compliance": {
        title: "API Compliance",
      },
      testing: {
        title: "Testing",
      },
      collections: {
        title: "Collections",
      },
    },
  },
  mcp: {
    title: "MCP Hub",
    type: "page",
    display: "children",
    items: {
      "search-bar-mcp": {
        type: "separator",
        title: "__INKEEP_SEARCH__",
      },
      index: {
        title: "MCP Hub",
        theme: {
          layout: "full",
          toc: false,
        },
      },

      "getting-started-section": {
        type: "separator",
        title: <SidebarSeparator>{"Intro to MCP"}</SidebarSeparator>,
      },
      overview: {
        title: "An overview of MCP",
      },
      "core-concepts": {
        title: "Core Concepts",
        items: {
          tools: {
            title: "Tools",
          },
          resources: {
            title: "Resources",
          },
          transports: {
            title: "Transports",
          },
          prompts: {
            title: "Prompts",
          },
          completables: {
            title: "Completables",
          },
          roots: {
            title: "Roots",
          },
          sampling: {
            title: "Sampling",
          },
        },
      },
      "mcp-for-skeptics": {
        title: "MCP for Skeptics",
        items: {
          "common-criticisms": {
            title: "Common Criticisms Addressed",
          },
          "when-to-use-mcp": {
            title: "When to Use MCP",
          },
        },
      },
      "openai-ecosystem": {
        title: "The OpenAI ecosystem",
      },
      "building-servers-section": {
        type: "separator",
        title: <SidebarSeparator>{"Building MCP servers"}</SidebarSeparator>,
      },
      "tool-design": {
        title: "Design MCP tools",
        items: {
          "less-is-more": {
            title: "Why less is more for MCP",
          },
          "dynamic-tool-discovery": {
            title: "Dynamic Tool Discovery",
          },
          "response-filtering-jq": {
            title: "Response Filtering with JQ",
          },
          "generate-mcp-tools-from-openapi": {
            title: "Build tools from OpenAPI",
          },
        },
      },
      "deploying-mcp-servers": {
        title: "Deploying your MCP server",
      },
      "securing-mcp-servers": {
        title: "Secure your MCP server",
        items: {
          "authenticating-mcp-servers": {
            title: "State of OAuth in MCP",
          },
          "authorizing-mcp-servers": {
            title: "Authorizing MCP servers",
          },
        },
      },
      "distributing-mcp-servers": {
        title: "Distribute your MCP server",
      },
      "monitoring-mcp-servers": {
        title: "Monitor your MCP server",
      },
      "framework-guides": {
        title: "Framework Guides",
        items: {
          "building-fastapi-server": {
            title: "Building an MCP server for FastAPI",
          },
        },
      },

      "using-mcp-section": {
        type: "separator",
        title: <SidebarSeparator>{"Using MCP servers"}</SidebarSeparator>,
      },
      "using-mcp": {
        title: "Using MCP",
        display: "children",
        items: {
          "installing-mcp-servers": {
            title: "Intro to using MCP servers",
          },
          "using-tools": {
            title: "Best practices for using MCP Tools",
          },
          "use-cases": {
            title: "MCP use cases",
            items: {
              "account-management": {
                title: "Account management",
              },
            },
          },
          "mcp-server-providers": {
            title: "Connect popular MCP servers",
            items: {
              slack: {
                title: "Slack",
              },
              hubspot: {
                title: "Hubspot",
              },
              resend: {
                title: "Resend",
              },
              pandadoc: {
                title: "Pandadoc",
              },
              postiz: {
                title: "Postiz",
              },
            },
          },
          "ai-agents": {
            title: "Building AI Agents",
            items: {
              introduction: {
                title: "Introduction to AI Agents",
              },
              "agent-use-cases": {
                title: "Use cases for AI Agents",
              },
              "architecture-patterns": {
                title: "Agent Architecture Patterns",
              },
            },
          },
        },
      },

      "release-notes-section": {
        type: "separator",
        title: <SidebarSeparator>{"Release Notes"}</SidebarSeparator>,
      },
      "release-notes": {
        title: "MCP Release Notes",
        href: "/mcp/release-notes",
      },
    },
  },
  blog: {
    title: "Blog",
    type: "page",
    display: "children",
    items: {
      "*": {
        theme: {
          sidebar: true,
          pagination: false,
        },
      },
    },
  },
  customers: {
    title: "Customers",
    type: "page",
    display: "children",
    items: {
      "*": {
        theme: {
          sidebar: false,
          pagination: false,
        },
      },
    },
  },
  legal: {
    title: "Legal",
    type: "page",
    display: "children",
    items: {
      "*": {
        theme: {
          sidebar: false,
          pagination: false,
        },
      },
    },
  },
  support: {
    title: "Support",
    type: "page",
    display: "children",
    items: {
      "*": {
        theme: {
          sidebar: false,
          pagination: false,
        },
      },
    },
  },
};

export default meta;