@redocly/theme 0.59.0-rc.3 → 0.60.0-custom.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (427) hide show
  1. package/LICENSE +7 -1
  2. package/lib/components/AsyncApiDocs/hooks/AfterAsyncApiChannelDescription.js +1 -0
  3. package/lib/components/Buttons/AIAssistantButton.js +6 -2
  4. package/lib/components/Buttons/ConnectMCPButton.d.ts +8 -0
  5. package/lib/components/Buttons/ConnectMCPButton.js +145 -0
  6. package/lib/components/Buttons/variables.d.ts +1 -0
  7. package/lib/components/Buttons/variables.js +44 -2
  8. package/lib/components/Catalog/CatalogCardView/CatalogCard.js +4 -3
  9. package/lib/components/Catalog/CatalogEntity/CatalogEntity.js +5 -1
  10. package/lib/components/Catalog/CatalogEntity/CatalogEntityGraph/CatalogEntityRelationsGraph.js +2 -2
  11. package/lib/components/Catalog/CatalogEntity/CatalogEntityInfoBar.js +1 -0
  12. package/lib/components/Catalog/CatalogEntity/CatalogEntityLinks.js +4 -1
  13. package/lib/components/Catalog/CatalogEntity/CatalogEntityMetadata.js +1 -0
  14. package/lib/components/Catalog/CatalogEntity/CatalogEntityMethodAndPath.js +4 -1
  15. package/lib/components/Catalog/CatalogEntity/CatalogEntityProperties/ContactProperty.js +4 -1
  16. package/lib/components/Catalog/CatalogEntity/CatalogEntityProperties/DomainsProperty.js +4 -1
  17. package/lib/components/Catalog/CatalogEntity/CatalogEntityProperties/EntityTypeProperty.js +4 -1
  18. package/lib/components/Catalog/CatalogEntity/CatalogEntityProperties/FormatProperty.js +4 -1
  19. package/lib/components/Catalog/CatalogEntity/CatalogEntityProperties/GitProperty.js +4 -1
  20. package/lib/components/Catalog/CatalogEntity/CatalogEntityProperties/OwnersProperty.js +4 -1
  21. package/lib/components/Catalog/CatalogEntity/CatalogEntityProperties/TagsProperty.js +4 -1
  22. package/lib/components/Catalog/CatalogEntity/CatalogEntityProperties/UserEmailProperty.js +4 -1
  23. package/lib/components/Catalog/CatalogEntity/CatalogEntityRelations/CatalogEntityApiDescriptionRelations.js +1 -1
  24. package/lib/components/Catalog/CatalogEntity/CatalogEntityRelations/CatalogEntityTeamRelations.js +1 -1
  25. package/lib/components/Catalog/CatalogEntity/CatalogEntitySchema.js +2 -2
  26. package/lib/components/Catalog/CatalogEntityIcon.js +2 -1
  27. package/lib/components/Catalog/CatalogFilter/CatalogFilter.js +4 -0
  28. package/lib/components/Catalog/CatalogFilter/CatalogFilterDateRange.js +2 -2
  29. package/lib/components/Catalog/CatalogSelector.js +1 -1
  30. package/lib/components/Catalog/CatalogSortButton.js +4 -1
  31. package/lib/components/Catalog/CatalogTableView/CatalogTableHeaderCell.js +2 -2
  32. package/lib/components/Catalog/CatalogTableView/CatalogTableViewRow.js +2 -2
  33. package/lib/components/Catalog/CatalogTagsWithTooltip.js +5 -1
  34. package/lib/components/Catalog/variables.dark.js +1 -1
  35. package/lib/components/Catalog/variables.js +6 -4
  36. package/lib/components/CatalogClassic/variables.js +1 -1
  37. package/lib/components/CodeBlock/CodeBlock.js +3 -1
  38. package/lib/components/CodeBlock/CodeBlockTabs.js +3 -3
  39. package/lib/components/DatePicker/variables.js +2 -0
  40. package/lib/components/Dropdown/Dropdown.d.ts +16 -2
  41. package/lib/components/Dropdown/Dropdown.js +5 -5
  42. package/lib/components/Feedback/Mood.js +2 -2
  43. package/lib/components/Feedback/Rating.js +2 -2
  44. package/lib/components/Filter/FilterDateRange.js +2 -2
  45. package/lib/components/Filter/FilterSelect.js +5 -1
  46. package/lib/components/Link/Link.d.ts +1 -0
  47. package/lib/components/Loaders/Loading.js +4 -1
  48. package/lib/components/Markdown/Markdown.js +9 -9
  49. package/lib/components/Markdown/styles/{baseTable.js → base-table.js} +1 -1
  50. package/lib/components/Markdown/styles/{headingAnchor.js → heading-anchor.js} +1 -1
  51. package/lib/components/Menu/MenuItem.js +6 -2
  52. package/lib/components/Navbar/NavbarItem.js +3 -3
  53. package/lib/components/OpenApiDocs/hooks/AdditionalOverviewInfo.js +1 -0
  54. package/lib/components/OpenApiDocs/hooks/AfterOpenApiDescription.js +1 -0
  55. package/lib/components/OpenApiDocs/hooks/AfterOpenApiOperation.js +1 -0
  56. package/lib/components/OpenApiDocs/hooks/AfterOpenApiTitle.js +1 -0
  57. package/lib/components/OpenApiDocs/hooks/BeforeOpenApiOperation.js +1 -0
  58. package/lib/components/OpenApiDocs/hooks/OpenApiFooter.js +3 -2
  59. package/lib/components/OpenApiDocs/hooks/OpenApiHeader.js +3 -2
  60. package/lib/components/PageActions/PageActions.js +4 -1
  61. package/lib/components/PageActions/variables.js +2 -0
  62. package/lib/components/Search/FilterFields/SearchFilterFieldSelect.js +2 -1
  63. package/lib/components/Search/FilterFields/SearchFilterFieldTags.js +8 -3
  64. package/lib/components/Search/SearchAiActionButtons.d.ts +10 -0
  65. package/lib/components/Search/SearchAiActionButtons.js +43 -0
  66. package/lib/components/Search/SearchAiConversationInput.d.ts +3 -1
  67. package/lib/components/Search/SearchAiConversationInput.js +39 -7
  68. package/lib/components/Search/SearchAiDialog.d.ts +3 -6
  69. package/lib/components/Search/SearchAiDialog.js +20 -9
  70. package/lib/components/Search/SearchAiMessage.d.ts +9 -5
  71. package/lib/components/Search/SearchAiMessage.js +147 -21
  72. package/lib/components/Search/SearchAiNegativeFeedbackForm.d.ts +10 -0
  73. package/lib/components/Search/SearchAiNegativeFeedbackForm.js +170 -0
  74. package/lib/components/Search/SearchDialog.js +36 -5
  75. package/lib/components/Search/SearchGroups.js +5 -2
  76. package/lib/components/Search/SearchHighlight.js +1 -0
  77. package/lib/components/Search/SearchItem.js +9 -2
  78. package/lib/components/Search/variables.js +38 -64
  79. package/lib/components/Segmented/Segmented.d.ts +1 -8
  80. package/lib/components/Segmented/Segmented.js +5 -3
  81. package/lib/components/Select/Select.d.ts +1 -1
  82. package/lib/components/Select/Select.js +4 -2
  83. package/lib/components/Select/SelectInput.d.ts +1 -1
  84. package/lib/components/Select/SelectInput.js +3 -1
  85. package/lib/components/SidebarActions/styled.d.ts +5 -4
  86. package/lib/components/SidebarActions/styled.js +9 -5
  87. package/lib/components/Tag/Tag.d.ts +3 -2
  88. package/lib/components/Tag/Tag.js +65 -16
  89. package/lib/components/Tag/variables.dark.js +143 -36
  90. package/lib/components/Tag/variables.js +85 -60
  91. package/lib/components/Tooltip/Tooltip.js +2 -0
  92. package/lib/components/VersionPicker/VersionPicker.d.ts +1 -1
  93. package/lib/config.d.ts +2 -2
  94. package/lib/core/constants/index.d.ts +2 -0
  95. package/lib/core/constants/index.js +2 -0
  96. package/lib/core/constants/mcp.d.ts +1 -0
  97. package/lib/core/constants/mcp.js +5 -0
  98. package/lib/core/constants/request-methods.d.ts +1 -0
  99. package/lib/core/constants/request-methods.js +14 -0
  100. package/lib/core/constants/search.d.ts +5 -4
  101. package/lib/core/constants/search.js +4 -5
  102. package/lib/core/hoc/index.d.ts +1 -1
  103. package/lib/core/hoc/index.js +1 -1
  104. package/lib/core/hoc/{typedMemo.js → typed-memo.js} +1 -1
  105. package/lib/core/hooks/__tests__/mocks/mock-intersection-observer.d.ts +1 -1
  106. package/lib/core/hooks/__tests__/mocks/mock-intersection-observer.js +1 -3
  107. package/lib/core/hooks/catalog/{useCatalogEntities.js → use-catalog-entities.js} +1 -1
  108. package/lib/core/hooks/catalog/{useCatalogEntitySchema.d.ts → use-catalog-entity-schema.d.ts} +1 -1
  109. package/lib/core/hooks/catalog/{useCatalogEntitySchema.js → use-catalog-entity-schema.js} +1 -1
  110. package/lib/core/hooks/catalog/{useCatalogTableHeaderCellActions.js → use-catalog-table-header-cell-actions.js} +1 -1
  111. package/lib/core/hooks/catalog/{useCatalogTableViewRow.js → use-catalog-table-view-row.js} +1 -1
  112. package/lib/core/hooks/catalog/{useGraph.js → use-graph.js} +2 -2
  113. package/lib/core/hooks/code-walkthrough/use-code-walkthrough-controls.js +1 -0
  114. package/lib/core/hooks/code-walkthrough/use-code-walkthrough-steps.d.ts +1 -0
  115. package/lib/core/hooks/code-walkthrough/use-renderable-files.js +2 -2
  116. package/lib/core/hooks/index.d.ts +8 -2
  117. package/lib/core/hooks/index.js +8 -2
  118. package/lib/core/hooks/menu/use-collapse.js +1 -0
  119. package/lib/core/hooks/menu/use-mobile-menu-items.js +1 -0
  120. package/lib/core/hooks/menu/use-nested-menu.js +1 -1
  121. package/lib/core/hooks/search/use-feedback-tooltip.d.ts +6 -0
  122. package/lib/core/hooks/search/use-feedback-tooltip.js +26 -0
  123. package/lib/core/hooks/use-connect-mcp-button.d.ts +13 -0
  124. package/lib/core/hooks/use-connect-mcp-button.js +50 -0
  125. package/lib/core/hooks/use-mcp-config.d.ts +9 -0
  126. package/lib/core/hooks/use-mcp-config.js +30 -0
  127. package/lib/core/hooks/use-page-actions.d.ts +1 -1
  128. package/lib/core/hooks/use-page-actions.js +120 -120
  129. package/lib/core/hooks/use-product-picker.js +2 -1
  130. package/lib/core/hooks/use-tabs.d.ts +3 -2
  131. package/lib/core/hooks/use-tabs.js +115 -57
  132. package/lib/core/hooks/use-telemetry-fallback.d.ts +10 -8
  133. package/lib/core/hooks/use-telemetry-fallback.js +11 -8
  134. package/lib/core/hooks/use-theme-config.js +1 -0
  135. package/lib/core/hooks/use-theme-hooks.js +1 -0
  136. package/lib/core/openapi/index.d.ts +3 -1
  137. package/lib/core/openapi/index.js +5 -3
  138. package/lib/core/styles/dark.js +4 -0
  139. package/lib/core/styles/global.js +5 -0
  140. package/lib/core/templates/Markdown.js +1 -0
  141. package/lib/core/types/hooks.d.ts +8 -2
  142. package/lib/core/types/index.d.ts +20 -18
  143. package/lib/core/types/index.js +0 -18
  144. package/lib/core/types/l10n.d.ts +1 -1
  145. package/lib/core/types/mcp.d.ts +6 -0
  146. package/lib/core/types/mcp.js +3 -0
  147. package/lib/core/types/search.d.ts +12 -4
  148. package/lib/core/types/search.js +6 -0
  149. package/lib/core/types/segmented.d.ts +12 -0
  150. package/lib/core/types/segmented.js +3 -0
  151. package/lib/core/types/sidebar.d.ts +1 -0
  152. package/lib/core/utils/{dynamic.js → Dynamic.js} +1 -1
  153. package/lib/core/utils/{get-file-icon.js → GetFileIcon.js} +1 -1
  154. package/lib/core/utils/args-typecheck.d.ts +2 -2
  155. package/lib/core/utils/clipboard-service.js +2 -0
  156. package/lib/core/utils/frontmatter-translate.d.ts +6 -0
  157. package/lib/core/utils/frontmatter-translate.js +14 -0
  158. package/lib/core/utils/get-operation-color.d.ts +7 -0
  159. package/lib/core/utils/get-operation-color.js +13 -0
  160. package/lib/core/utils/get-user-agent.js +1 -0
  161. package/lib/core/utils/index.d.ts +5 -2
  162. package/lib/core/utils/index.js +5 -2
  163. package/lib/core/utils/js-utils.d.ts +1 -1
  164. package/lib/core/utils/load-and-navigate.js +1 -0
  165. package/lib/core/utils/markdoc.js +1 -0
  166. package/lib/core/utils/mcp.d.ts +2 -0
  167. package/lib/core/utils/mcp.js +31 -0
  168. package/lib/core/utils/parse-style-string.js +1 -0
  169. package/lib/ext/configure.d.ts +2 -2
  170. package/lib/ext/configure.js +12 -6
  171. package/lib/ext/{useConfigureReplay.js → use-configure-replay.js} +5 -4
  172. package/lib/icons/AiStarsGradientIcon/AiStarsGradientIcon.js +44 -4
  173. package/lib/icons/AiStarsIcon/AiStarsIcon.js +11 -2
  174. package/lib/icons/ConnectIcon/ConnectIcon.d.ts +9 -0
  175. package/lib/icons/ConnectIcon/ConnectIcon.js +17 -0
  176. package/lib/icons/CubeIcon/CubeIcon.d.ts +9 -0
  177. package/lib/icons/CubeIcon/CubeIcon.js +17 -0
  178. package/lib/icons/HashtagIcon/HashtagIcon.d.ts +9 -0
  179. package/lib/icons/HashtagIcon/HashtagIcon.js +22 -0
  180. package/lib/icons/RedoclyIcon/RedoclyIcon.js +4 -7
  181. package/lib/icons/ThumbDownFilledIcon/ThumbDownFilledIcon.d.ts +9 -0
  182. package/lib/icons/ThumbDownFilledIcon/ThumbDownFilledIcon.js +34 -0
  183. package/lib/icons/ThumbUpFilledIcon/ThumbUpFilledIcon.d.ts +9 -0
  184. package/lib/icons/ThumbUpFilledIcon/ThumbUpFilledIcon.js +34 -0
  185. package/lib/icons/VSCodeIcon/VSCodeIcon.d.ts +9 -0
  186. package/lib/icons/VSCodeIcon/VSCodeIcon.js +17 -0
  187. package/lib/index.d.ts +4 -3
  188. package/lib/index.js +3 -3
  189. package/lib/layouts/ThreePanelLayout.js +4 -4
  190. package/lib/markdoc/components/Cards/Card.js +1 -28
  191. package/lib/markdoc/components/Cards/variables.dark.js +2 -0
  192. package/lib/markdoc/components/Cards/variables.js +2 -0
  193. package/lib/markdoc/components/CodeWalkthrough/CodePanelHeader.js +1 -0
  194. package/lib/markdoc/components/ConnectMCP/ConnectMCP.d.ts +8 -0
  195. package/lib/markdoc/components/ConnectMCP/ConnectMCP.js +19 -0
  196. package/lib/markdoc/components/Tabs/TabList.d.ts +3 -1
  197. package/lib/markdoc/components/Tabs/TabList.js +197 -47
  198. package/lib/markdoc/components/Tabs/Tabs.d.ts +2 -1
  199. package/lib/markdoc/components/Tabs/Tabs.js +57 -12
  200. package/lib/markdoc/components/default.d.ts +1 -0
  201. package/lib/markdoc/components/default.js +1 -0
  202. package/lib/markdoc/default.d.ts +6 -0
  203. package/lib/markdoc/default.js +2 -0
  204. package/lib/markdoc/tags/card.js +0 -1
  205. package/lib/markdoc/tags/code-walkthrough.js +1 -0
  206. package/lib/markdoc/tags/connect-mcp.d.ts +2 -0
  207. package/lib/markdoc/tags/connect-mcp.js +27 -0
  208. package/lib/markdoc/tags/html.js +1 -0
  209. package/package.json +6 -6
  210. package/src/components/AsyncApiDocs/hooks/AfterAsyncApiChannelDescription.tsx +1 -0
  211. package/src/components/Button/Button.tsx +1 -0
  212. package/src/components/Buttons/AIAssistantButton.tsx +6 -2
  213. package/src/components/Buttons/ConnectMCPButton.tsx +180 -0
  214. package/src/components/Buttons/variables.ts +44 -1
  215. package/src/components/Catalog/CatalogCardView/CatalogCard.tsx +4 -3
  216. package/src/components/Catalog/CatalogEntity/CatalogEntity.tsx +4 -0
  217. package/src/components/Catalog/CatalogEntity/CatalogEntityGraph/CatalogEntityRelationsGraph.tsx +1 -1
  218. package/src/components/Catalog/CatalogEntity/CatalogEntityInfoBar.tsx +1 -0
  219. package/src/components/Catalog/CatalogEntity/CatalogEntityLinks.tsx +5 -1
  220. package/src/components/Catalog/CatalogEntity/CatalogEntityMetadata.tsx +1 -0
  221. package/src/components/Catalog/CatalogEntity/CatalogEntityMethodAndPath.tsx +5 -1
  222. package/src/components/Catalog/CatalogEntity/CatalogEntityProperties/ContactProperty.tsx +5 -1
  223. package/src/components/Catalog/CatalogEntity/CatalogEntityProperties/DomainsProperty.tsx +5 -1
  224. package/src/components/Catalog/CatalogEntity/CatalogEntityProperties/EntityTypeProperty.tsx +5 -1
  225. package/src/components/Catalog/CatalogEntity/CatalogEntityProperties/FormatProperty.tsx +5 -1
  226. package/src/components/Catalog/CatalogEntity/CatalogEntityProperties/GitProperty.tsx +5 -1
  227. package/src/components/Catalog/CatalogEntity/CatalogEntityProperties/OwnersProperty.tsx +5 -1
  228. package/src/components/Catalog/CatalogEntity/CatalogEntityProperties/TagsProperty.tsx +5 -1
  229. package/src/components/Catalog/CatalogEntity/CatalogEntityProperties/UserEmailProperty.tsx +5 -1
  230. package/src/components/Catalog/CatalogEntity/CatalogEntityRelations/CatalogEntityApiDescriptionRelations.tsx +1 -1
  231. package/src/components/Catalog/CatalogEntity/CatalogEntityRelations/CatalogEntityTeamRelations.tsx +1 -1
  232. package/src/components/Catalog/CatalogEntity/CatalogEntitySchema.tsx +3 -1
  233. package/src/components/Catalog/CatalogEntityIcon.tsx +2 -1
  234. package/src/components/Catalog/CatalogFilter/CatalogFilter.tsx +5 -0
  235. package/src/components/Catalog/CatalogFilter/CatalogFilterDateRange.tsx +2 -2
  236. package/src/components/Catalog/CatalogSelector.tsx +2 -2
  237. package/src/components/Catalog/CatalogSortButton.tsx +5 -1
  238. package/src/components/Catalog/CatalogTableView/CatalogTableHeaderCell.tsx +1 -1
  239. package/src/components/Catalog/CatalogTableView/CatalogTableViewRow.tsx +1 -1
  240. package/src/components/Catalog/CatalogTagsWithTooltip.tsx +8 -1
  241. package/src/components/Catalog/variables.dark.ts +1 -1
  242. package/src/components/Catalog/variables.ts +6 -4
  243. package/src/components/CatalogClassic/CatalogClassicInfoBlock.tsx +1 -0
  244. package/src/components/CatalogClassic/variables.ts +1 -1
  245. package/src/components/CodeBlock/CodeBlock.tsx +4 -0
  246. package/src/components/CodeBlock/CodeBlockControls.tsx +1 -0
  247. package/src/components/CodeBlock/CodeBlockTabs.tsx +1 -1
  248. package/src/components/DatePicker/variables.ts +3 -1
  249. package/src/components/Dropdown/Dropdown.tsx +84 -79
  250. package/src/components/Feedback/Mood.tsx +2 -2
  251. package/src/components/Feedback/Rating.tsx +2 -2
  252. package/src/components/Filter/FilterDateRange.tsx +2 -2
  253. package/src/components/Filter/FilterSelect.tsx +1 -0
  254. package/src/components/JsonViewer/JsonViewer.tsx +1 -0
  255. package/src/components/JsonViewer/helpers.tsx +3 -0
  256. package/src/components/LastUpdated/LastUpdated.tsx +1 -0
  257. package/src/components/Link/Link.tsx +1 -0
  258. package/src/components/Loaders/Loading.tsx +5 -1
  259. package/src/components/Markdown/Markdown.tsx +2 -2
  260. package/src/components/Menu/MenuItem.tsx +7 -2
  261. package/src/components/Navbar/NavbarItem.tsx +6 -5
  262. package/src/components/OpenApiDocs/hooks/AdditionalOverviewInfo.tsx +1 -0
  263. package/src/components/OpenApiDocs/hooks/AfterOpenApiDescription.tsx +1 -0
  264. package/src/components/OpenApiDocs/hooks/AfterOpenApiOperation.tsx +1 -1
  265. package/src/components/OpenApiDocs/hooks/AfterOpenApiTitle.tsx +1 -1
  266. package/src/components/OpenApiDocs/hooks/BeforeOpenApiOperation.tsx +1 -1
  267. package/src/components/OpenApiDocs/hooks/OpenApiFooter.tsx +1 -1
  268. package/src/components/OpenApiDocs/hooks/OpenApiHeader.tsx +1 -1
  269. package/src/components/PageActions/PageActions.tsx +5 -1
  270. package/src/components/PageActions/variables.ts +2 -0
  271. package/src/components/Search/FilterFields/SearchFilterFieldSelect.tsx +4 -1
  272. package/src/components/Search/FilterFields/SearchFilterFieldTags.tsx +10 -4
  273. package/src/components/Search/SearchAiActionButtons.tsx +76 -0
  274. package/src/components/Search/SearchAiConversationInput.tsx +61 -18
  275. package/src/components/Search/SearchAiDialog.tsx +52 -23
  276. package/src/components/Search/SearchAiMessage.tsx +173 -39
  277. package/src/components/Search/SearchAiNegativeFeedbackForm.tsx +212 -0
  278. package/src/components/Search/SearchDialog.tsx +49 -13
  279. package/src/components/Search/SearchGroups.tsx +6 -1
  280. package/src/components/Search/SearchHighlight.tsx +1 -0
  281. package/src/components/Search/SearchItem.tsx +15 -3
  282. package/src/components/Search/variables.ts +38 -64
  283. package/src/components/Segmented/Segmented.tsx +16 -21
  284. package/src/components/Select/Select.tsx +8 -4
  285. package/src/components/Select/SelectInput.tsx +11 -1
  286. package/src/components/SidebarActions/{styled.tsx → styled.ts} +11 -4
  287. package/src/components/Tag/Tag.tsx +36 -18
  288. package/src/components/Tag/variables.dark.ts +143 -36
  289. package/src/components/Tag/variables.ts +85 -60
  290. package/src/components/Tooltip/Tooltip.tsx +2 -1
  291. package/src/components/VersionPicker/VersionPicker.tsx +2 -1
  292. package/src/config.ts +2 -0
  293. package/src/core/constants/index.ts +2 -0
  294. package/src/core/constants/mcp.ts +1 -0
  295. package/src/core/constants/request-methods.ts +10 -0
  296. package/src/core/constants/search.ts +8 -4
  297. package/src/core/hoc/index.ts +1 -1
  298. package/src/core/hooks/__mocks__/use-theme-hooks.ts +2 -2
  299. package/src/core/hooks/__tests__/mocks/mock-intersection-observer.ts +9 -8
  300. package/src/core/hooks/catalog/{useCatalogEntitySchema.ts → use-catalog-entity-schema.ts} +3 -3
  301. package/src/core/hooks/catalog/{useGraph.ts → use-graph.ts} +1 -1
  302. package/src/core/hooks/code-walkthrough/__mocks__/MockIntersectionObserver.ts +1 -1
  303. package/src/core/hooks/code-walkthrough/__mocks__/mock-intersection-observer.ts +24 -0
  304. package/src/core/hooks/code-walkthrough/use-code-walkthrough-controls.ts +1 -0
  305. package/src/core/hooks/code-walkthrough/use-code-walkthrough-steps.ts +2 -2
  306. package/src/core/hooks/code-walkthrough/use-renderable-files.ts +1 -1
  307. package/src/core/hooks/index.ts +8 -2
  308. package/src/core/hooks/menu/use-collapse.ts +3 -3
  309. package/src/core/hooks/menu/use-mobile-menu-items.ts +1 -0
  310. package/src/core/hooks/menu/use-nested-menu.ts +2 -2
  311. package/src/core/hooks/search/use-feedback-tooltip.ts +32 -0
  312. package/src/core/hooks/use-connect-mcp-button.ts +79 -0
  313. package/src/core/hooks/use-mcp-config.ts +49 -0
  314. package/src/core/hooks/use-page-actions.ts +164 -146
  315. package/src/core/hooks/use-product-picker.ts +2 -1
  316. package/src/core/hooks/use-tabs.ts +168 -86
  317. package/src/core/hooks/use-telemetry-fallback.ts +11 -8
  318. package/src/core/hooks/use-theme-config.ts +1 -0
  319. package/src/core/hooks/use-theme-hooks.ts +2 -1
  320. package/src/core/openapi/index.ts +3 -1
  321. package/src/core/styles/dark.ts +4 -0
  322. package/src/core/styles/global.ts +6 -1
  323. package/src/core/templates/Markdown.tsx +1 -0
  324. package/src/core/types/catalog.ts +3 -1
  325. package/src/core/types/filter.ts +1 -0
  326. package/src/core/types/hooks.ts +11 -1
  327. package/src/core/types/index.ts +20 -18
  328. package/src/core/types/l10n.ts +37 -1
  329. package/src/core/types/mcp.ts +8 -0
  330. package/src/core/types/search.ts +15 -5
  331. package/src/core/types/segmented.ts +15 -0
  332. package/src/core/types/select.ts +1 -0
  333. package/src/core/types/sidebar.ts +1 -0
  334. package/src/core/utils/args-typecheck.ts +2 -2
  335. package/src/core/utils/clipboard-service.ts +2 -0
  336. package/src/core/utils/frontmatter-translate.ts +9 -0
  337. package/src/core/utils/get-operation-color.ts +18 -0
  338. package/src/core/utils/get-user-agent.ts +1 -0
  339. package/src/core/utils/index.ts +5 -2
  340. package/src/core/utils/js-utils.ts +1 -1
  341. package/src/core/utils/load-and-navigate.ts +1 -0
  342. package/src/core/utils/markdoc.ts +1 -0
  343. package/src/core/utils/mcp.ts +34 -0
  344. package/src/core/utils/parse-style-string.ts +1 -0
  345. package/src/ext/configure.ts +15 -8
  346. package/src/ext/process-scorecard.ts +1 -0
  347. package/src/ext/{useConfigureReplay.ts → use-configure-replay.ts} +5 -3
  348. package/src/icons/AiStarsGradientIcon/AiStarsGradientIcon.tsx +13 -4
  349. package/src/icons/AiStarsIcon/AiStarsIcon.tsx +11 -2
  350. package/src/icons/ConnectIcon/ConnectIcon.tsx +27 -0
  351. package/src/icons/CubeIcon/CubeIcon.tsx +27 -0
  352. package/src/icons/HashtagIcon/HashtagIcon.tsx +23 -0
  353. package/src/icons/RedoclyIcon/RedoclyIcon.tsx +4 -22
  354. package/src/icons/ThumbDownFilledIcon/ThumbDownFilledIcon.tsx +38 -0
  355. package/src/icons/ThumbUpFilledIcon/ThumbUpFilledIcon.tsx +35 -0
  356. package/src/icons/VSCodeIcon/VSCodeIcon.tsx +29 -0
  357. package/src/index.ts +4 -3
  358. package/src/layouts/ThreePanelLayout.tsx +1 -1
  359. package/src/markdoc/components/Cards/Card.tsx +1 -28
  360. package/src/markdoc/components/Cards/variables.dark.ts +2 -0
  361. package/src/markdoc/components/Cards/variables.ts +3 -1
  362. package/src/markdoc/components/CodeWalkthrough/CodePanelHeader.tsx +1 -1
  363. package/src/markdoc/components/ConnectMCP/ConnectMCP.tsx +28 -0
  364. package/src/markdoc/components/Tabs/TabList.tsx +312 -105
  365. package/src/markdoc/components/Tabs/Tabs.tsx +136 -11
  366. package/src/markdoc/components/default.ts +1 -0
  367. package/src/markdoc/default.ts +2 -0
  368. package/src/markdoc/tags/card.ts +0 -1
  369. package/src/markdoc/tags/code-walkthrough.ts +2 -0
  370. package/src/markdoc/tags/connect-mcp.ts +25 -0
  371. package/src/markdoc/tags/html.ts +1 -0
  372. package/lib/core/hooks/__mocks__/index.d.ts +0 -28
  373. package/lib/core/hooks/__mocks__/index.js +0 -45
  374. package/lib/core/hooks/__mocks__/search/use-recent-searches.d.ts +0 -5
  375. package/lib/core/hooks/__mocks__/search/use-recent-searches.js +0 -13
  376. package/lib/core/hooks/__mocks__/search/use-search-filter.d.ts +0 -8
  377. package/lib/core/hooks/__mocks__/search/use-search-filter.js +0 -15
  378. package/lib/core/hooks/__mocks__/search/use-suggested-pages.d.ts +0 -4
  379. package/lib/core/hooks/__mocks__/search/use-suggested-pages.js +0 -13
  380. package/lib/core/hooks/__mocks__/use-controlled-state.d.ts +0 -1
  381. package/lib/core/hooks/__mocks__/use-controlled-state.js +0 -7
  382. package/lib/core/hooks/__mocks__/use-element-size.d.ts +0 -4
  383. package/lib/core/hooks/__mocks__/use-element-size.js +0 -9
  384. package/lib/core/hooks/__mocks__/use-input-key-commands.d.ts +0 -3
  385. package/lib/core/hooks/__mocks__/use-input-key-commands.js +0 -8
  386. package/lib/core/hooks/__mocks__/use-mobile-menu.d.ts +0 -1
  387. package/lib/core/hooks/__mocks__/use-mobile-menu.js +0 -7
  388. package/lib/core/hooks/__mocks__/use-theme-config.d.ts +0 -8
  389. package/lib/core/hooks/__mocks__/use-theme-config.js +0 -13
  390. package/lib/core/hooks/__mocks__/use-theme-hooks.d.ts +0 -69
  391. package/lib/core/hooks/__mocks__/use-theme-hooks.js +0 -94
  392. package/lib/core/hooks/__mocks__/use-time-ago.d.ts +0 -3
  393. package/lib/core/hooks/__mocks__/use-time-ago.js +0 -8
  394. package/lib/core/hooks/code-walkthrough/__mocks__/MockIntersectionObserver.d.ts +0 -10
  395. package/lib/core/hooks/code-walkthrough/__mocks__/MockIntersectionObserver.js +0 -56
  396. package/lib/core/hooks/menu/__mocks__/use-mobile-menu-items.d.ts +0 -1
  397. package/lib/core/hooks/menu/__mocks__/use-mobile-menu-items.js +0 -35
  398. /package/lib/components/Markdown/styles/{baseTable.d.ts → base-table.d.ts} +0 -0
  399. /package/lib/components/Markdown/styles/{headingAnchor.d.ts → heading-anchor.d.ts} +0 -0
  400. /package/lib/core/hoc/{typedMemo.d.ts → typed-memo.d.ts} +0 -0
  401. /package/lib/core/hooks/catalog/{useCatalogEntities.d.ts → use-catalog-entities.d.ts} +0 -0
  402. /package/lib/core/hooks/catalog/{useCatalogTableHeaderCellActions.d.ts → use-catalog-table-header-cell-actions.d.ts} +0 -0
  403. /package/lib/core/hooks/catalog/{useCatalogTableViewRow.d.ts → use-catalog-table-view-row.d.ts} +0 -0
  404. /package/lib/core/hooks/catalog/{useGraph.d.ts → use-graph.d.ts} +0 -0
  405. /package/lib/core/utils/{dynamic.d.ts → Dynamic.d.ts} +0 -0
  406. /package/lib/core/utils/{get-file-icon.d.ts → GetFileIcon.d.ts} +0 -0
  407. /package/lib/ext/{useConfigureReplay.d.ts → use-configure-replay.d.ts} +0 -0
  408. /package/src/components/Markdown/styles/{baseTable.ts → base-table.ts} +0 -0
  409. /package/src/components/Markdown/styles/{headingAnchor.ts → heading-anchor.ts} +0 -0
  410. /package/src/components/Panel/{PanelBody.ts → PanelBody.tsx} +0 -0
  411. /package/src/components/Panel/{PanelHeader.ts → PanelHeader.tsx} +0 -0
  412. /package/src/components/Panel/{PanelHeaderTitle.ts → PanelHeaderTitle.tsx} +0 -0
  413. /package/src/components/StatusCode/{StatusCode.ts → StatusCode.tsx} +0 -0
  414. /package/src/components/Typography/{CompactTypography.ts → CompactTypography.tsx} +0 -0
  415. /package/src/components/Typography/{Emphasis.ts → Emphasis.tsx} +0 -0
  416. /package/src/components/Typography/{H1.ts → H1.tsx} +0 -0
  417. /package/src/components/Typography/{H2.ts → H2.tsx} +0 -0
  418. /package/src/components/Typography/{H3.ts → H3.tsx} +0 -0
  419. /package/src/components/Typography/{H4.ts → H4.tsx} +0 -0
  420. /package/src/components/Typography/{SectionHeader.ts → SectionHeader.tsx} +0 -0
  421. /package/src/components/Typography/{Typography.ts → Typography.tsx} +0 -0
  422. /package/src/core/hoc/{typedMemo.ts → typed-memo.ts} +0 -0
  423. /package/src/core/hooks/catalog/{useCatalogEntities.ts → use-catalog-entities.ts} +0 -0
  424. /package/src/core/hooks/catalog/{useCatalogTableHeaderCellActions.ts → use-catalog-table-header-cell-actions.ts} +0 -0
  425. /package/src/core/hooks/catalog/{useCatalogTableViewRow.ts → use-catalog-table-view-row.ts} +0 -0
  426. /package/src/core/utils/{dynamic.tsx → Dynamic.tsx} +0 -0
  427. /package/src/core/utils/{get-file-icon.tsx → GetFileIcon.tsx} +0 -0
@@ -32,14 +32,12 @@ var __importStar = (this && this.__importStar) || (function () {
32
32
  return result;
33
33
  };
34
34
  })();
35
- var __importDefault = (this && this.__importDefault) || function (mod) {
36
- return (mod && mod.__esModule) ? mod : { "default": mod };
37
- };
38
35
  Object.defineProperty(exports, "__esModule", { value: true });
39
36
  exports.TabContent = exports.TabsSize = void 0;
40
37
  exports.Tabs = Tabs;
41
38
  const react_1 = __importStar(require("react"));
42
- const styled_components_1 = __importDefault(require("styled-components"));
39
+ const react_router_dom_1 = require("react-router-dom");
40
+ const styled_components_1 = __importStar(require("styled-components"));
43
41
  const hooks_1 = require("../../../core/hooks");
44
42
  const TabList_1 = require("../../../markdoc/components/Tabs/TabList");
45
43
  const utils_1 = require("../../../core/utils");
@@ -48,22 +46,62 @@ var TabsSize;
48
46
  TabsSize["SMALL"] = "small";
49
47
  TabsSize["MEDIUM"] = "medium";
50
48
  })(TabsSize || (exports.TabsSize = TabsSize = {}));
51
- function Tabs({ id, children, className, size, initialTab: propInitialTab, }) {
49
+ function Tabs({ id, children, className, size, initialTab: propInitialTab, forceReady = false, }) {
52
50
  var _a, _b;
53
- const [childrenArray, setChildrenArray] = (0, react_1.useState)(react_1.default.Children.toArray(children));
51
+ const childrenArray = react_1.default.Children.toArray(children);
52
+ const [isReady, setIsReady] = (0, react_1.useState)(false);
53
+ const containerRef = (0, react_1.useRef)(null);
54
54
  const initialTab = (_b = propInitialTab !== null && propInitialTab !== void 0 ? propInitialTab : (_a = childrenArray[0]) === null || _a === void 0 ? void 0 : _a.props.label) !== null && _b !== void 0 ? _b : '';
55
- const { activeTab, setActiveTab } = (0, hooks_1.useActiveTab)({ tabsId: id, initialTab });
56
- (0, react_1.useEffect)(() => {
57
- setChildrenArray(react_1.default.Children.toArray(children));
58
- }, [children]);
59
- return (react_1.default.createElement(TabsContainer, { "data-component-name": "Markdoc/Tabs/Tabs", className: className, key: id },
60
- react_1.default.createElement(TabList_1.TabList, { size: size, childrenArray: childrenArray, activeTab: activeTab, onTabChange: setActiveTab }),
55
+ const labelsHash = childrenArray.map((c) => c.props.label).join('|');
56
+ const handleReadyChange = (0, react_1.useCallback)((ready) => {
57
+ setIsReady(ready);
58
+ }, []);
59
+ // Reset isReady when children change (new page/tabs)
60
+ // Use useLayoutEffect to run synchronously before paint
61
+ (0, react_1.useLayoutEffect)(() => {
62
+ setIsReady(false);
63
+ }, [labelsHash]);
64
+ const inRouter = (0, react_router_dom_1.useInRouterContext)();
65
+ return (react_1.default.createElement(TabsView, { id: id, className: className, size: size, childrenArray: childrenArray, initialTab: initialTab, useActiveTab: inRouter ? useActiveTabWithRouter : useActiveTabWithoutRouter, isReady: isReady || forceReady, labelsHash: labelsHash, containerRef: containerRef, onReadyChange: handleReadyChange }));
66
+ }
67
+ function TabsView({ id, className, size, childrenArray, useActiveTab, initialTab, isReady, labelsHash, containerRef, onReadyChange, }) {
68
+ const { activeTab, setActiveTab } = useActiveTab(initialTab, id, childrenArray);
69
+ return (react_1.default.createElement(TabsContainer, { "data-component-name": "Markdoc/Tabs/Tabs", className: className, key: id, "$isReady": isReady },
70
+ react_1.default.createElement(TabList_1.TabList, { key: labelsHash, size: size, childrenArray: childrenArray, activeTab: activeTab, onTabChange: setActiveTab, containerRef: containerRef, onReadyChange: onReadyChange }),
61
71
  childrenArray.map((child, index) => {
62
72
  const { label } = child.props;
63
73
  const tabId = (0, utils_1.getTabId)(label, index);
64
74
  return label === activeTab ? (react_1.default.createElement(exports.TabContent, { key: `content-${tabId}`, id: `panel-${tabId}`, "aria-labelledby": `tab-${tabId}`, tabIndex: 0, role: "tabpanel" }, child.props.children)) : null;
65
75
  })));
66
76
  }
77
+ /**
78
+ * Validates that the active tab exists in children and resets to initial tab if not found.
79
+ * Ensures tab state remains consistent when tab structure changes.
80
+ */
81
+ function useValidateActiveTab(activeTab, setActiveTab, childrenArray, initialTab) {
82
+ (0, react_1.useEffect)(() => {
83
+ const availableLabels = childrenArray.map((child) => child.props.label);
84
+ if (activeTab && !availableLabels.includes(activeTab) && availableLabels.length > 0) {
85
+ setActiveTab(initialTab);
86
+ }
87
+ }, [childrenArray, activeTab, initialTab, setActiveTab]);
88
+ }
89
+ const useActiveTabWithRouter = (initialTab, tabsId, childrenArray) => {
90
+ const { activeTab, setActiveTab } = (0, hooks_1.useActiveTab)({ initialTab, tabsId });
91
+ useValidateActiveTab(activeTab, setActiveTab, childrenArray, initialTab);
92
+ return {
93
+ activeTab,
94
+ setActiveTab,
95
+ };
96
+ };
97
+ const useActiveTabWithoutRouter = (initialTab, _tabsId, childrenArray) => {
98
+ const [activeTab, setActiveTab] = (0, react_1.useState)(initialTab);
99
+ useValidateActiveTab(activeTab, setActiveTab, childrenArray, initialTab);
100
+ return {
101
+ activeTab,
102
+ setActiveTab,
103
+ };
104
+ };
67
105
  const TabsContainer = styled_components_1.default.div `
68
106
  position: relative;
69
107
  color: var(--md-tabs-container-text-color);
@@ -80,6 +118,13 @@ const TabsContainer = styled_components_1.default.div `
80
118
  margin: 0;
81
119
  padding: 0;
82
120
  }
121
+
122
+ ${({ $isReady }) => !$isReady &&
123
+ (0, styled_components_1.css) `
124
+ opacity: 0;
125
+ pointer-events: none;
126
+ overflow: hidden;
127
+ `}
83
128
  `;
84
129
  exports.TabContent = styled_components_1.default.div `
85
130
  color: var(--md-tabs-content-text-color);
@@ -20,3 +20,4 @@ export * from '../../markdoc/components/CodeWalkthrough/CodeToggle';
20
20
  export * from '../../markdoc/components/CodeWalkthrough/CodeContainer';
21
21
  export * from '../../markdoc/components/CodeGroup/CodeGroup';
22
22
  export * from '../../markdoc/components/Icon/Icon';
23
+ export * from '../../markdoc/components/ConnectMCP/ConnectMCP';
@@ -36,4 +36,5 @@ __exportStar(require("../../markdoc/components/CodeWalkthrough/CodeToggle"), exp
36
36
  __exportStar(require("../../markdoc/components/CodeWalkthrough/CodeContainer"), exports);
37
37
  __exportStar(require("../../markdoc/components/CodeGroup/CodeGroup"), exports);
38
38
  __exportStar(require("../../markdoc/components/Icon/Icon"), exports);
39
+ __exportStar(require("../../markdoc/components/ConnectMCP/ConnectMCP"), exports);
39
40
  //# sourceMappingURL=default.js.map
@@ -22,6 +22,7 @@ import { input } from '../markdoc/tags/input';
22
22
  import { toggle } from '../markdoc/tags/code-toggle';
23
23
  import { codeGroup } from '../markdoc/tags/code-group';
24
24
  import { icon } from '../markdoc/tags/icon';
25
+ import { connectMcp } from '../markdoc/tags/connect-mcp';
25
26
  export declare const tags: {
26
27
  [admonition.tagName]: import("@markdoc/markdoc").Schema & {
27
28
  attributes?: Record<string, import("@markdoc/markdoc").SchemaAttribute & {
@@ -113,4 +114,9 @@ export declare const tags: {
113
114
  resolver?: string;
114
115
  }>;
115
116
  };
117
+ [connectMcp.tagName]: import("@markdoc/markdoc").Schema & {
118
+ attributes?: Record<string, import("@markdoc/markdoc").SchemaAttribute & {
119
+ resolver?: string;
120
+ }>;
121
+ };
116
122
  };
@@ -64,6 +64,7 @@ const input_1 = require("../markdoc/tags/input");
64
64
  const code_toggle_1 = require("../markdoc/tags/code-toggle");
65
65
  const code_group_1 = require("../markdoc/tags/code-group");
66
66
  const icon_1 = require("../markdoc/tags/icon");
67
+ const connect_mcp_1 = require("../markdoc/tags/connect-mcp");
67
68
  exports.tags = {
68
69
  [admonition_1.admonition.tagName]: admonition_1.admonition.schema,
69
70
  [debug_1.debug.tagName]: debug_1.debug.schema,
@@ -83,5 +84,6 @@ exports.tags = {
83
84
  [input_1.input.tagName]: input_1.input.schema,
84
85
  [code_group_1.codeGroup.tagName]: code_group_1.codeGroup.schema,
85
86
  [icon_1.icon.tagName]: icon_1.icon.schema,
87
+ [connect_mcp_1.connectMcp.tagName]: connect_mcp_1.connectMcp.schema,
86
88
  };
87
89
  //# sourceMappingURL=default.js.map
@@ -54,7 +54,6 @@ exports.card = {
54
54
  },
55
55
  to: { type: String, resolver: 'link' },
56
56
  },
57
- children: ['paragraph', 'tag', 'list'],
58
57
  },
59
58
  tagName: 'card',
60
59
  };
@@ -63,6 +63,7 @@ exports.codeWalkthrough = {
63
63
  },
64
64
  validate(node) {
65
65
  const errors = [];
66
+ /* eslint-disable-next-line no-warning-comments */
66
67
  // code-walk-todo: validate when/unless for steps, toggles, inputs, and chunks
67
68
  const toggleIds = Object.keys(collectTogglesFromChildren(node.children));
68
69
  if ((0, utils_1.isObject)(node.attributes.filters)) {
@@ -0,0 +1,2 @@
1
+ import type { MarkdocSchemaWrapper } from '../../markdoc/tags/types';
2
+ export declare const connectMcp: MarkdocSchemaWrapper;
@@ -0,0 +1,27 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.connectMcp = void 0;
4
+ exports.connectMcp = {
5
+ schema: {
6
+ render: 'ConnectMCP',
7
+ attributes: {
8
+ placement: {
9
+ type: String,
10
+ default: 'bottom',
11
+ matches: ['top', 'bottom'],
12
+ },
13
+ alignment: {
14
+ type: String,
15
+ default: 'start',
16
+ matches: ['start', 'end'],
17
+ },
18
+ options: {
19
+ type: Array,
20
+ default: ['cursor', 'vscode', 'copy'],
21
+ },
22
+ },
23
+ selfClosing: true,
24
+ },
25
+ tagName: 'connect-mcp',
26
+ };
27
+ //# sourceMappingURL=connect-mcp.js.map
@@ -14,6 +14,7 @@ exports.html = {
14
14
  name: { type: String, required: true },
15
15
  attrs: { type: Object },
16
16
  },
17
+ /* eslint-disable-next-line @typescript-eslint/no-explicit-any */
17
18
  transform(node, config) {
18
19
  const { name, attrs } = node.attributes;
19
20
  const children = node.transformChildren(config);
package/package.json CHANGED
@@ -1,13 +1,13 @@
1
1
  {
2
2
  "name": "@redocly/theme",
3
- "version": "0.59.0-rc.3",
3
+ "version": "0.60.0-custom.2",
4
4
  "description": "Shared UI components lib",
5
5
  "keywords": [
6
6
  "theme",
7
7
  "redocly"
8
8
  ],
9
9
  "author": "team@redocly.com",
10
- "license": "SEE LICENSE IN LICENSE",
10
+ "license": "MIT",
11
11
  "main": "lib/index.js",
12
12
  "types": "lib/index.d.ts",
13
13
  "exports": {
@@ -44,7 +44,7 @@
44
44
  "@types/highlight-words-core": "1.2.3",
45
45
  "@types/lodash.debounce": "4.0.9",
46
46
  "@types/lodash.throttle": "4.1.9",
47
- "@types/node": "22.15.3",
47
+ "@types/node": "22.18.13",
48
48
  "@types/nprogress": "0.2.3",
49
49
  "@types/react": "^19.1.4",
50
50
  "@types/react-dom": "^19.1.4",
@@ -84,11 +84,11 @@
84
84
  "lodash.debounce": "^4.0.8",
85
85
  "lodash.throttle": "4.1.1",
86
86
  "nprogress": "0.2.0",
87
- "openapi-sampler": "1.6.1",
87
+ "openapi-sampler": "1.6.2",
88
88
  "react-calendar": "5.1.0",
89
89
  "react-date-picker": "11.0.0",
90
- "@redocly/config": "0.36.0-rc.1",
91
- "@redocly/realm-asyncapi-sdk": "0.5.0-next.0"
90
+ "@redocly/config": "0.38.0-custom.0",
91
+ "@redocly/realm-asyncapi-sdk": "0.6.0-next.0"
92
92
  },
93
93
  "scripts": {
94
94
  "watch": "tsc -p tsconfig.build.json && (concurrently \"tsc -w -p tsconfig.build.json\" \"tsc-alias -w -p tsconfig.build.json\")",
@@ -6,4 +6,5 @@
6
6
  // return null;
7
7
  // }
8
8
 
9
+ /* eslint-disable-next-line @typescript-eslint/no-explicit-any */
9
10
  export const AfterAsyncApiChannelDescription: any = null;
@@ -32,6 +32,7 @@ export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElemen
32
32
  iconPosition?: 'left' | 'right';
33
33
  title?: string;
34
34
  tabIndex?: number;
35
+ /* eslint-disable-next-line @typescript-eslint/no-explicit-any */
35
36
  onClick?: (e?: any) => void;
36
37
  ref?: React.Ref<HTMLButtonElement>;
37
38
  }
@@ -21,7 +21,7 @@ interface AIAssistantButtonConfig {
21
21
  const defaultConfig: Required<AIAssistantButtonConfig> = {
22
22
  hide: false,
23
23
  inputType: 'button',
24
- inputIcon: 'redocly',
24
+ inputIcon: 'sparkles',
25
25
  };
26
26
 
27
27
  const getIcon = (
@@ -56,8 +56,9 @@ const getIcon = (
56
56
  export function AIAssistantButton() {
57
57
  const [isOpen, setIsOpen] = useState(false);
58
58
  const themeConfig = useThemeConfig();
59
- const { useTranslate } = useThemeHooks();
59
+ const { useTranslate, useTelemetry } = useThemeHooks();
60
60
  const { translate } = useTranslate();
61
+ const telemetry = useTelemetry();
61
62
 
62
63
  const buttonConfig = {
63
64
  ...defaultConfig,
@@ -75,6 +76,9 @@ export function AIAssistantButton() {
75
76
 
76
77
  const handleOpen = () => {
77
78
  setIsOpen(true);
79
+ telemetry.sendSearchAiOpenedMessage({
80
+ method: 'ai_trigger_button',
81
+ });
78
82
  };
79
83
 
80
84
  const handleClose = () => {
@@ -0,0 +1,180 @@
1
+ import React, { useMemo } from 'react';
2
+ import styled from 'styled-components';
3
+
4
+ import type { JSX } from 'react';
5
+ import type { MCPOption } from '@redocly/theme/core/types';
6
+
7
+ import { Dropdown } from '@redocly/theme/components/Dropdown/Dropdown';
8
+ import { DropdownMenu } from '@redocly/theme/components/Dropdown/DropdownMenu';
9
+ import { DropdownMenuItem } from '@redocly/theme/components/Dropdown/DropdownMenuItem';
10
+ import { Button } from '@redocly/theme/components/Button/Button';
11
+ import { CursorIcon } from '@redocly/theme/icons/CursorIcon/CursorIcon';
12
+ import { VSCodeIcon } from '@redocly/theme/icons/VSCodeIcon/VSCodeIcon';
13
+ import { CopyIcon } from '@redocly/theme/icons/CopyIcon/CopyIcon';
14
+ import { CheckmarkFilledIcon } from '@redocly/theme/icons/CheckmarkFilledIcon/CheckmarkFilledIcon';
15
+ import { ConnectIcon } from '@redocly/theme/icons/ConnectIcon/ConnectIcon';
16
+ import { useConnectMCPButton } from '@redocly/theme/core/hooks';
17
+ import { useThemeHooks } from '@redocly/theme/core/hooks';
18
+
19
+ type TriggerButtonProps = {
20
+ text: string;
21
+ };
22
+
23
+ const TriggerButton = React.memo(({ text }: TriggerButtonProps): JSX.Element => {
24
+ return (
25
+ <StyledButton variant="secondary" icon={<ConnectIcon />}>
26
+ {text}
27
+ </StyledButton>
28
+ );
29
+ });
30
+
31
+ type MenuOption = {
32
+ key: MCPOption;
33
+ icon: React.ComponentType;
34
+ titleTranslationKey: string;
35
+ titleDefault: string;
36
+ descriptionTranslationKey: string;
37
+ descriptionDefault: string;
38
+ };
39
+
40
+ const MENU_OPTIONS: MenuOption[] = [
41
+ {
42
+ key: 'cursor',
43
+ icon: CursorIcon,
44
+ titleTranslationKey: 'page.actions.connectMcp.cursor',
45
+ titleDefault: 'Connect to Cursor',
46
+ descriptionTranslationKey: 'page.actions.connectMcp.cursorDescription',
47
+ descriptionDefault: 'Install MCP server on Cursor',
48
+ },
49
+ {
50
+ key: 'vscode',
51
+ icon: VSCodeIcon,
52
+ titleTranslationKey: 'page.actions.connectMcp.vscode',
53
+ titleDefault: 'Connect to VS Code',
54
+ descriptionTranslationKey: 'page.actions.connectMcp.vscodeDescription',
55
+ descriptionDefault: 'Install MCP server on VS Code',
56
+ },
57
+ {
58
+ key: 'copy',
59
+ icon: CopyIcon,
60
+ titleTranslationKey: 'page.actions.connectMcp.copyConfig',
61
+ titleDefault: 'Copy MCP Configuration',
62
+ descriptionTranslationKey: 'page.actions.connectMcp.copyConfigDescription',
63
+ descriptionDefault: 'Copy MCP JSON Configuration',
64
+ },
65
+ ];
66
+
67
+ export type ConnectMCPButtonProps = {
68
+ placement?: 'top' | 'bottom';
69
+ alignment?: 'start' | 'end';
70
+ options?: MCPOption[];
71
+ };
72
+
73
+ export function ConnectMCPButton({
74
+ placement = 'bottom',
75
+ alignment = 'end',
76
+ options = ['cursor', 'vscode', 'copy'],
77
+ }: ConnectMCPButtonProps): JSX.Element {
78
+ const { useTranslate } = useThemeHooks();
79
+ const { translate } = useTranslate();
80
+
81
+ const { isCopied, triggerButtonText, visibleOptions, handleAction } = useConnectMCPButton({
82
+ options,
83
+ });
84
+
85
+ const menuOptions = useMemo(
86
+ () => MENU_OPTIONS.filter((option) => visibleOptions.includes(option.key)),
87
+ [visibleOptions],
88
+ );
89
+
90
+ return (
91
+ <ConnectMCPButtonWrapper data-component-name="Buttons/ConnectMCPButton">
92
+ <Dropdown
93
+ trigger={<TriggerButton text={triggerButtonText} />}
94
+ triggerEvent="hover"
95
+ placement={placement}
96
+ alignment={alignment}
97
+ closeOnClick={false}
98
+ >
99
+ <DropdownMenu>
100
+ {menuOptions.map((option) => {
101
+ const Icon = option.icon;
102
+ const showCheckmark = option.key === 'copy' && isCopied;
103
+
104
+ return (
105
+ <DropdownMenuItem key={option.key} onAction={() => handleAction(option.key)}>
106
+ <MenuItemContent>
107
+ <MenuItemIcon>
108
+ {showCheckmark ? (
109
+ <CheckmarkFilledIcon color="var(--color-success-base)" />
110
+ ) : (
111
+ <Icon />
112
+ )}
113
+ </MenuItemIcon>
114
+ <MenuItemText>
115
+ <MenuItemTitle>
116
+ {translate(option.titleTranslationKey, option.titleDefault)}
117
+ </MenuItemTitle>
118
+ <MenuItemDescription>
119
+ {translate(option.descriptionTranslationKey, option.descriptionDefault)}
120
+ </MenuItemDescription>
121
+ </MenuItemText>
122
+ </MenuItemContent>
123
+ </DropdownMenuItem>
124
+ );
125
+ })}
126
+ </DropdownMenu>
127
+ </Dropdown>
128
+ </ConnectMCPButtonWrapper>
129
+ );
130
+ }
131
+
132
+ const ConnectMCPButtonWrapper = styled.div`
133
+ display: inline-block;
134
+ position: relative;
135
+ `;
136
+
137
+ const StyledButton = styled(Button)`
138
+ --button-gap: var(--connect-mcp-button-gap);
139
+ `;
140
+
141
+ const MenuItemContent = styled.div`
142
+ display: flex;
143
+ align-items: center;
144
+ gap: var(--connect-mcp-button-menu-item-gap);
145
+ padding: var(--connect-mcp-button-menu-item-padding-block)
146
+ var(--connect-mcp-button-menu-item-padding-inline);
147
+ `;
148
+
149
+ const MenuItemIcon = styled.div`
150
+ display: flex;
151
+ align-items: center;
152
+ justify-content: center;
153
+ width: var(--connect-mcp-button-menu-item-icon-size);
154
+ height: var(--connect-mcp-button-menu-item-icon-size);
155
+ flex-shrink: 0;
156
+ border: var(--connect-mcp-button-menu-item-icon-border);
157
+ border-radius: var(--connect-mcp-button-menu-item-icon-border-radius);
158
+ color: var(--connect-mcp-button-menu-item-icon-color);
159
+ `;
160
+
161
+ const MenuItemText = styled.div`
162
+ display: flex;
163
+ flex-direction: column;
164
+ gap: var(--connect-mcp-button-menu-item-text-gap);
165
+ flex: 1;
166
+ `;
167
+
168
+ const MenuItemTitle = styled.div`
169
+ font-size: var(--connect-mcp-button-menu-item-title-font-size);
170
+ font-weight: var(--connect-mcp-button-menu-item-title-font-weight);
171
+ line-height: var(--connect-mcp-button-menu-item-title-line-height);
172
+ color: var(--connect-mcp-button-menu-item-title-color);
173
+ `;
174
+
175
+ const MenuItemDescription = styled.div`
176
+ font-size: var(--connect-mcp-button-menu-item-description-font-size);
177
+ font-weight: var(--connect-mcp-button-menu-item-description-font-weight);
178
+ line-height: var(--connect-mcp-button-menu-item-description-line-height);
179
+ color: var(--connect-mcp-button-menu-item-description-color);
180
+ `;
@@ -1,5 +1,6 @@
1
1
  import { css } from 'styled-components';
2
2
 
3
+ /* eslint-disable theme/no-raw-colors-in-styles */
3
4
  export const aiAssistantButton = css`
4
5
  /**
5
6
  * @tokens AI Assistant Button
@@ -21,7 +22,7 @@ export const aiAssistantButton = css`
21
22
  /* Positioning */
22
23
  --ai-assistant-button-bottom: var(--spacing-xl);
23
24
  --ai-assistant-button-right: var(--spacing-xl);
24
- --ai-assistant-button-z-index: 1000;
25
+ --ai-assistant-button-z-index: 50
25
26
 
26
27
  /* Typography */
27
28
  --ai-assistant-button-font-size: var(--font-size-base);
@@ -46,3 +47,45 @@ export const aiAssistantButton = css`
46
47
  /* Transition */
47
48
  --ai-assistant-button-transition: box-shadow 0.3s ease, transform 0.2s ease;
48
49
  `;
50
+ /* eslint-enable theme/no-raw-colors-in-styles */
51
+
52
+ export const connectMCPButton = css`
53
+ /**
54
+ * @tokens Connect MCP Button
55
+ * @presenter Color
56
+ */
57
+
58
+ /* Button gap */
59
+ --connect-mcp-button-gap: var(--spacing-xs);
60
+
61
+ /* Menu item layout */
62
+ --connect-mcp-button-menu-item-gap: var(--spacing-sm);
63
+ --connect-mcp-button-menu-item-padding-block: var(--spacing-xxs);
64
+ --connect-mcp-button-menu-item-padding-inline: 0;
65
+
66
+ /* Menu item icon */
67
+ --connect-mcp-button-menu-item-icon-size: 32px;
68
+ --connect-mcp-button-menu-item-icon-border-color: var(--border-color-secondary);
69
+ --connect-mcp-button-menu-item-icon-border-style: solid;
70
+ --connect-mcp-button-menu-item-icon-border-width: 1px;
71
+ --connect-mcp-button-menu-item-icon-border: var(--connect-mcp-button-menu-item-icon-border-width)
72
+ var(--connect-mcp-button-menu-item-icon-border-style)
73
+ var(--connect-mcp-button-menu-item-icon-border-color);
74
+ --connect-mcp-button-menu-item-icon-border-radius: var(--border-radius);
75
+ --connect-mcp-button-menu-item-icon-color: var(--icon-color-secondary);
76
+
77
+ /* Menu item text */
78
+ --connect-mcp-button-menu-item-text-gap: var(--spacing-xxs);
79
+
80
+ /* Menu item title */
81
+ --connect-mcp-button-menu-item-title-font-size: var(--font-size-base);
82
+ --connect-mcp-button-menu-item-title-font-weight: var(--font-weight-regular);
83
+ --connect-mcp-button-menu-item-title-line-height: var(--line-height-base);
84
+ --connect-mcp-button-menu-item-title-color: var(--text-color-secondary);
85
+
86
+ /* Menu item description */
87
+ --connect-mcp-button-menu-item-description-font-size: var(--font-size-sm);
88
+ --connect-mcp-button-menu-item-description-font-weight: var(--font-weight-regular);
89
+ --connect-mcp-button-menu-item-description-line-height: var(--line-height-sm);
90
+ --connect-mcp-button-menu-item-description-color: var(--text-color-description);
91
+ `;
@@ -18,7 +18,8 @@ export type CatalogCardProps = {
18
18
  };
19
19
 
20
20
  export function CatalogCard({ entity, catalogConfig }: CatalogCardProps): JSX.Element {
21
- const { useTelemetry } = useThemeHooks();
21
+ const { useTelemetry, useTranslate } = useThemeHooks();
22
+ const { translate } = useTranslate();
22
23
  const telemetry = useTelemetry();
23
24
  const pathPrefix = getPathPrefix();
24
25
 
@@ -49,7 +50,7 @@ export function CatalogCard({ entity, catalogConfig }: CatalogCardProps): JSX.El
49
50
 
50
51
  <CardMetadataSection>
51
52
  <MetadataRow>
52
- <MetadataLabel>Domains:</MetadataLabel>
53
+ <MetadataLabel>{translate('catalog.metadata.domains', 'Domains:')}</MetadataLabel>
53
54
  <CatalogTagsWithTooltip
54
55
  items={entity.domains?.map((domain) => domain.title) || []}
55
56
  tagProps={{
@@ -64,7 +65,7 @@ export function CatalogCard({ entity, catalogConfig }: CatalogCardProps): JSX.El
64
65
  </MetadataRow>
65
66
 
66
67
  <MetadataRow>
67
- <MetadataLabel>Owners:</MetadataLabel>
68
+ <MetadataLabel>{translate('catalog.metadata.owners', 'Owners:')}</MetadataLabel>
68
69
  <CatalogTagsWithTooltip
69
70
  items={entity.owners?.map((owner) => owner.key) || []}
70
71
  tagProps={{
@@ -22,7 +22,9 @@ import { CatalogEntityMethodAndPath } from '@redocly/theme/components/Catalog/Ca
22
22
  import { CatalogEntityRelationsGraph } from '@redocly/theme/components/Catalog/CatalogEntity/CatalogEntityGraph/CatalogEntityRelationsGraph.lazy';
23
23
 
24
24
  export type CatalogEntityProps = {
25
+ /* eslint-disable-next-line @typescript-eslint/no-explicit-any */
25
26
  RedocSchema: React.ComponentType<any>;
27
+ /* eslint-disable-next-line @typescript-eslint/no-explicit-any */
26
28
  StoreProvider: React.ComponentType<any>;
27
29
  GraphqlTypeRenderer?: React.ComponentType<{ sdl: string; typeName: string }>;
28
30
  };
@@ -49,7 +51,9 @@ const renderFirstColumnEntitySection = (entity: BffCatalogEntity): React.ReactEl
49
51
  const renderDataSchemaSection = (
50
52
  entity: BffCatalogEntity,
51
53
  relatedEntity: BffCatalogRelatedEntity | null,
54
+ /* eslint-disable-next-line @typescript-eslint/no-explicit-any */
52
55
  RedocSchema: React.ComponentType<any>,
56
+ /* eslint-disable-next-line @typescript-eslint/no-explicit-any */
53
57
  StoreProvider: React.ComponentType<any>,
54
58
  GraphqlTypeRenderer?: React.ComponentType<{ sdl: string; typeName: string }>,
55
59
  ): React.ReactElement | null => {
@@ -4,7 +4,7 @@ import styled from 'styled-components';
4
4
 
5
5
  import { BffCatalogEntity } from '@redocly/theme/core/types';
6
6
  import { useColorSwitcher, useThemeHooks } from '@redocly/theme/core/hooks';
7
- import { useGraph } from '@redocly/theme/core/hooks/catalog/useGraph';
7
+ import { useGraph } from '@redocly/theme/core/hooks';
8
8
  import { CatalogEntityRelationsNode } from '@redocly/theme/components/Catalog/CatalogEntity/CatalogEntityGraph/CatalogEntityRelationsNode';
9
9
  import { CatalogEntityRelationsEdge } from '@redocly/theme/components/Catalog/CatalogEntity/CatalogEntityGraph/CatalogEntityRelationsEdge';
10
10
  import { xyflow } from '@redocly/theme/core/styles';
@@ -41,6 +41,7 @@ const InfoBarWrapper = styled.div<{ hoverEffect: boolean }>`
41
41
  transition: all 0.2s ease-in-out;
42
42
  height: 100%;
43
43
  padding: var(--catalog-card-gap);
44
+ margin-bottom: var(--spacing-xs);
44
45
 
45
46
  ${({ hoverEffect }) =>
46
47
  hoverEffect &&
@@ -6,12 +6,16 @@ import { LaunchIcon } from '@redocly/theme/icons/LaunchIcon/LaunchIcon';
6
6
  import { LinkIcon } from '@redocly/theme/icons/LinkIcon/LinkIcon';
7
7
  import { CatalogEntityInfoBar } from '@redocly/theme/components/Catalog/CatalogEntity/CatalogEntityInfoBar';
8
8
  import { Link } from '@redocly/theme/components/Link/Link';
9
+ import { useThemeHooks } from '@redocly/theme/core/hooks';
9
10
 
10
11
  export type CatalogEntityLinksProps = {
11
12
  entity: BffCatalogEntity;
12
13
  };
13
14
 
14
15
  export function CatalogEntityLinks({ entity }: CatalogEntityLinksProps) {
16
+ const { useTranslate } = useThemeHooks();
17
+ const { translate } = useTranslate();
18
+
15
19
  const links = Object.entries(entity.links || []);
16
20
 
17
21
  if (!links.length) {
@@ -20,7 +24,7 @@ export function CatalogEntityLinks({ entity }: CatalogEntityLinksProps) {
20
24
 
21
25
  return (
22
26
  <LinksWrapper data-component-name="Catalog/CatalogEntity/CatalogEntityLinks">
23
- <Heading>Links</Heading>
27
+ <Heading>{translate('catalog.links.label', 'Links')}</Heading>
24
28
  {links.map(([key, value]) => (
25
29
  <Link key={key} color="var(--catalog-metadata-link-color)" to={value.url} target="_blank">
26
30
  <CatalogEntityInfoBar
@@ -14,6 +14,7 @@ export type CatalogEntityMetadataProps = {
14
14
  entity: BffCatalogEntity;
15
15
  };
16
16
 
17
+ /* eslint-disable-next-line @typescript-eslint/no-explicit-any */
17
18
  function renderMetadataValue(value: any): React.JSX.Element {
18
19
  if (isPlainObject(value)) {
19
20
  return <JsonViewerWrapper data={value} expandLevel={3} controls={false} />;