@lukoweb/apitogo 0.2.22 → 0.2.24

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 (599) hide show
  1. package/README.md +94 -94
  2. package/cli.js +13 -13
  3. package/client.d.ts +8 -8
  4. package/dist/cli/cli.js +561 -232
  5. package/dist/declarations/cli/platform/client/platform-api.d.ts +18 -0
  6. package/dist/declarations/config/validators/InputNavigationSchema.d.ts +7 -7
  7. package/dist/declarations/config/validators/ZudokuConfig.d.ts +1 -1
  8. package/docs/cli/commands.md +75 -75
  9. package/docs/cli/go-live.md +123 -123
  10. package/docs/cli/overview.md +91 -91
  11. package/docs/cli/setup.md +141 -141
  12. package/docs/cli/shape.md +127 -127
  13. package/docs/components/alert.mdx +130 -130
  14. package/docs/components/badge.mdx +70 -70
  15. package/docs/components/button.mdx +132 -132
  16. package/docs/components/callout.mdx +112 -112
  17. package/docs/components/card.mdx +104 -104
  18. package/docs/components/checkbox.mdx +72 -72
  19. package/docs/components/client-only.mdx +79 -79
  20. package/docs/components/code-tabs.mdx +179 -179
  21. package/docs/components/dialog.mdx +167 -167
  22. package/docs/components/head.mdx +200 -200
  23. package/docs/components/icons.mdx +27 -27
  24. package/docs/components/input.mdx +96 -96
  25. package/docs/components/label.mdx +86 -86
  26. package/docs/components/link.mdx +242 -242
  27. package/docs/components/markdown.mdx +151 -151
  28. package/docs/components/mermaid.mdx +81 -81
  29. package/docs/components/playground.mdx +85 -85
  30. package/docs/components/secret.mdx +79 -79
  31. package/docs/components/select.mdx +176 -176
  32. package/docs/components/shadcn.mdx +73 -73
  33. package/docs/components/slider.mdx +108 -108
  34. package/docs/components/slot.mdx +119 -119
  35. package/docs/components/stepper.mdx +138 -138
  36. package/docs/components/switch.mdx +96 -96
  37. package/docs/components/syntax-highlight.mdx +602 -602
  38. package/docs/components/textarea.mdx +78 -78
  39. package/docs/components/tooltip.mdx +195 -195
  40. package/docs/components/typography.mdx +61 -61
  41. package/docs/components.mdx +60 -60
  42. package/docs/concepts/auth-provider-api-identities.md +105 -105
  43. package/docs/configuration/ai-assistants.md +65 -65
  44. package/docs/configuration/api-catalog.md +109 -109
  45. package/docs/configuration/api-reference.md +397 -397
  46. package/docs/configuration/authentication-auth0.md +181 -181
  47. package/docs/configuration/authentication-azure-ad.md +245 -245
  48. package/docs/configuration/authentication-clerk.md +117 -117
  49. package/docs/configuration/authentication-firebase.md +69 -69
  50. package/docs/configuration/authentication-pingfederate.md +143 -143
  51. package/docs/configuration/authentication-supabase.md +233 -233
  52. package/docs/configuration/authentication.md +159 -159
  53. package/docs/configuration/build-configuration.mdx +147 -147
  54. package/docs/configuration/docs.md +282 -282
  55. package/docs/configuration/footer.mdx +118 -118
  56. package/docs/configuration/gateway.md +221 -221
  57. package/docs/configuration/llms.md +90 -90
  58. package/docs/configuration/make-config.mdx +124 -124
  59. package/docs/configuration/manifest.md +128 -128
  60. package/docs/configuration/navigation.mdx +421 -421
  61. package/docs/configuration/overview.md +166 -166
  62. package/docs/configuration/plans.md +153 -153
  63. package/docs/configuration/protected-routes.md +150 -150
  64. package/docs/configuration/search.md +164 -164
  65. package/docs/configuration/sentry.mdx +44 -44
  66. package/docs/configuration/site.md +124 -124
  67. package/docs/configuration/slots.mdx +125 -125
  68. package/docs/configuration/vite-config.md +18 -18
  69. package/docs/custom-plugins.md +285 -285
  70. package/docs/customization/colors-theme.mdx +278 -278
  71. package/docs/customization/fonts.md +110 -110
  72. package/docs/customization/landing-page.md +188 -188
  73. package/docs/deploy/apache-nginx.md +41 -41
  74. package/docs/deploy/apitogo.md +17 -17
  75. package/docs/deploy/cloudflare-pages.md +74 -74
  76. package/docs/deploy/direct-upload.md +17 -17
  77. package/docs/deploy/github-pages.md +49 -49
  78. package/docs/deploy/vercel.md +101 -101
  79. package/docs/deployment.md +9 -9
  80. package/docs/extending/events.md +124 -124
  81. package/docs/guides/custom-pages.md +110 -110
  82. package/docs/guides/environment-variables.md +94 -94
  83. package/docs/guides/managing-api-keys-and-identities.md +89 -89
  84. package/docs/guides/mermaid.mdx +70 -70
  85. package/docs/guides/navigation-rules.mdx +203 -203
  86. package/docs/guides/processors.mdx +234 -234
  87. package/docs/guides/static-files.md +55 -55
  88. package/docs/guides/transforming-examples.md +156 -156
  89. package/docs/guides/using-multiple-apis.md +87 -87
  90. package/docs/markdown/admonitions.md +128 -128
  91. package/docs/markdown/code-blocks.md +196 -196
  92. package/docs/markdown/frontmatter.md +173 -173
  93. package/docs/markdown/mdx.md +68 -68
  94. package/docs/markdown/overview.md +275 -275
  95. package/docs/mcp/go-live.md +100 -100
  96. package/docs/mcp/overview.md +76 -76
  97. package/docs/mcp/setup.md +173 -173
  98. package/docs/mcp/shape.md +77 -77
  99. package/docs/mcp/tools.md +102 -102
  100. package/docs/plugins.md +24 -24
  101. package/docs/quickstart.md +72 -72
  102. package/docs/writing.mdx +72 -72
  103. package/package.json +1 -1
  104. package/src/app/ZuploBuildConfig.ts +36 -36
  105. package/src/app/apitogoBrandTheme.ts +47 -47
  106. package/src/app/defaultTheme.css +77 -77
  107. package/src/app/demo-cdn.html +37 -37
  108. package/src/app/demo.html +21 -21
  109. package/src/app/demo.tsx +77 -77
  110. package/src/app/entry.client.tsx +107 -107
  111. package/src/app/entry.server.tsx +160 -160
  112. package/src/app/env.ts +40 -40
  113. package/src/app/main.css +400 -400
  114. package/src/app/main.tsx +167 -167
  115. package/src/app/polyfills.ts +47 -47
  116. package/src/app/processRoutes.tsx +51 -51
  117. package/src/app/sentry.ts +24 -24
  118. package/src/app/standalone.html +23 -23
  119. package/src/app/standalone.tsx +60 -60
  120. package/src/app/utils/createRedirectRoutes.ts +11 -11
  121. package/src/config/apitogo-config-core.ts +7 -3
  122. package/src/config/apitogo-config-loader.browser.ts +17 -17
  123. package/src/config/apitogo-config-loader.node.ts +88 -88
  124. package/src/config/apitogo-config-loader.ts +6 -6
  125. package/src/config/build-apitogo-config.ts +61 -61
  126. package/src/config/config.ts +74 -74
  127. package/src/config/create-plugin.ts +71 -71
  128. package/src/config/default-landing-content.ts +149 -149
  129. package/src/config/file-exists.ts +6 -6
  130. package/src/config/gateway-limits.ts +128 -128
  131. package/src/config/landing-manifest.ts +11 -11
  132. package/src/config/landing-openapi-showcase.ts +124 -124
  133. package/src/config/loader.ts +375 -375
  134. package/src/config/local-manifest.ts +545 -545
  135. package/src/config/resolve-modules.ts +354 -354
  136. package/src/config/v2/__fixtures__/scenario-a-docs-only.json +6 -6
  137. package/src/config/v2/__fixtures__/scenario-b-managed-origin.json +14 -14
  138. package/src/config/v2/__fixtures__/scenario-c-proxy-oidc.json +15 -15
  139. package/src/config/v2/__fixtures__/scenario-h-full-stack.json +28 -28
  140. package/src/config/v2/docs-navigation.ts +72 -72
  141. package/src/config/v2/errors.ts +42 -42
  142. package/src/config/v2/gateway-reference.ts +220 -220
  143. package/src/config/v2/gateway-request.ts +123 -123
  144. package/src/config/v2/home-redirect.ts +98 -98
  145. package/src/config/v2/index.ts +126 -126
  146. package/src/config/v2/init.ts +273 -273
  147. package/src/config/v2/layout.ts +237 -237
  148. package/src/config/v2/ledger.ts +235 -235
  149. package/src/config/v2/link-directory.ts +34 -0
  150. package/src/config/v2/load.ts +70 -70
  151. package/src/config/v2/manifest.ts +452 -452
  152. package/src/config/v2/parse.ts +214 -214
  153. package/src/config/v2/paths.ts +54 -54
  154. package/src/config/v2/portal-profile.ts +88 -88
  155. package/src/config/v2/resolve.ts +188 -188
  156. package/src/config/v2/rules.ts +714 -714
  157. package/src/config/v2/schema.ts +245 -245
  158. package/src/config/v2/services.ts +663 -663
  159. package/src/config/v2/workspace.ts +3 -2
  160. package/src/config/v2/wrapper.ts +24 -2
  161. package/src/config/validators/BuildSchema.ts +95 -95
  162. package/src/config/validators/HeaderNavigationSchema.ts +44 -44
  163. package/src/config/validators/InputNavigationSchema.test-d.ts +178 -178
  164. package/src/config/validators/InputNavigationSchema.ts +206 -206
  165. package/src/config/validators/ModulesSchema.ts +502 -502
  166. package/src/config/validators/NavigationSchema.ts +352 -352
  167. package/src/config/validators/ProtectedRoutesSchema.ts +35 -35
  168. package/src/config/validators/ZudokuConfig.ts +792 -792
  169. package/src/config/validators/auth.ts +3 -3
  170. package/src/config/validators/reason-codes.ts +7 -7
  171. package/src/env.d.ts +11 -11
  172. package/src/index.ts +83 -83
  173. package/src/lib/MissingIcon.tsx +22 -22
  174. package/src/lib/assets/language-icons/bun.tsx +50 -50
  175. package/src/lib/assets/language-icons/c.tsx +31 -31
  176. package/src/lib/assets/language-icons/commonlisp.tsx +22 -22
  177. package/src/lib/assets/language-icons/cpp.tsx +35 -35
  178. package/src/lib/assets/language-icons/csharp.tsx +35 -35
  179. package/src/lib/assets/language-icons/css.tsx +36 -36
  180. package/src/lib/assets/language-icons/dart.tsx +39 -39
  181. package/src/lib/assets/language-icons/elixir.tsx +19 -19
  182. package/src/lib/assets/language-icons/go.tsx +19 -19
  183. package/src/lib/assets/language-icons/graphql.tsx +19 -19
  184. package/src/lib/assets/language-icons/html.tsx +24 -24
  185. package/src/lib/assets/language-icons/java.tsx +35 -35
  186. package/src/lib/assets/language-icons/javascript.tsx +11 -11
  187. package/src/lib/assets/language-icons/json.tsx +19 -19
  188. package/src/lib/assets/language-icons/kotlin.tsx +30 -30
  189. package/src/lib/assets/language-icons/markdown.tsx +19 -19
  190. package/src/lib/assets/language-icons/mdx.tsx +23 -23
  191. package/src/lib/assets/language-icons/npm.tsx +15 -15
  192. package/src/lib/assets/language-icons/objectivec.tsx +23 -23
  193. package/src/lib/assets/language-icons/ocaml.tsx +34 -34
  194. package/src/lib/assets/language-icons/php.tsx +19 -19
  195. package/src/lib/assets/language-icons/pnpm.tsx +32 -32
  196. package/src/lib/assets/language-icons/powershell.tsx +27 -27
  197. package/src/lib/assets/language-icons/python.tsx +23 -23
  198. package/src/lib/assets/language-icons/react.tsx +21 -21
  199. package/src/lib/assets/language-icons/ruby.tsx +19 -19
  200. package/src/lib/assets/language-icons/rust.tsx +19 -19
  201. package/src/lib/assets/language-icons/scala.tsx +19 -19
  202. package/src/lib/assets/language-icons/shell.tsx +19 -19
  203. package/src/lib/assets/language-icons/swift.tsx +19 -19
  204. package/src/lib/assets/language-icons/toml.tsx +23 -23
  205. package/src/lib/assets/language-icons/typescript.tsx +23 -23
  206. package/src/lib/assets/language-icons/xml.tsx +19 -19
  207. package/src/lib/assets/language-icons/yaml.tsx +23 -23
  208. package/src/lib/assets/language-icons/yarn.tsx +17 -17
  209. package/src/lib/assets/language-icons/zig.tsx +32 -32
  210. package/src/lib/auth/issuer.ts +34 -34
  211. package/src/lib/authentication/AuthenticationPlugin.tsx +33 -33
  212. package/src/lib/authentication/auth-header-nav.ts +46 -46
  213. package/src/lib/authentication/authentication.ts +51 -51
  214. package/src/lib/authentication/components/CallbackHandler.tsx +45 -45
  215. package/src/lib/authentication/components/OAuthErrorPage.tsx +197 -197
  216. package/src/lib/authentication/components/ProductionUnlockPage.tsx +26 -26
  217. package/src/lib/authentication/components/SignIn.tsx +46 -46
  218. package/src/lib/authentication/components/SignOut.tsx +15 -15
  219. package/src/lib/authentication/components/SignUp.tsx +48 -48
  220. package/src/lib/authentication/constants.ts +1 -1
  221. package/src/lib/authentication/errors.ts +34 -34
  222. package/src/lib/authentication/header-nav-filter.ts +35 -35
  223. package/src/lib/authentication/hook.ts +141 -141
  224. package/src/lib/authentication/providers/auth0.tsx +91 -91
  225. package/src/lib/authentication/providers/azureb2c.tsx +223 -223
  226. package/src/lib/authentication/providers/clerk.tsx +224 -224
  227. package/src/lib/authentication/providers/dev-portal-auth-pages.tsx +602 -602
  228. package/src/lib/authentication/providers/dev-portal-constants.ts +38 -38
  229. package/src/lib/authentication/providers/dev-portal-demo.ts +151 -151
  230. package/src/lib/authentication/providers/dev-portal-utils.ts +279 -279
  231. package/src/lib/authentication/providers/dev-portal.tsx +448 -448
  232. package/src/lib/authentication/providers/firebase.tsx +486 -486
  233. package/src/lib/authentication/providers/openid.tsx +516 -516
  234. package/src/lib/authentication/providers/supabase.tsx +412 -412
  235. package/src/lib/authentication/providers/util.ts +26 -26
  236. package/src/lib/authentication/state.ts +180 -180
  237. package/src/lib/authentication/ui/AuthCard.tsx +7 -7
  238. package/src/lib/authentication/ui/EmailLinkCallbackUi.tsx +129 -129
  239. package/src/lib/authentication/ui/EmailLinkSentUi.tsx +105 -105
  240. package/src/lib/authentication/ui/EmailLinkSignInUi.tsx +100 -100
  241. package/src/lib/authentication/ui/EmailVerificationUi.tsx +128 -128
  242. package/src/lib/authentication/ui/ZudokuAuthUi.tsx +620 -620
  243. package/src/lib/authentication/ui/icons/Apple.tsx +10 -10
  244. package/src/lib/authentication/ui/icons/Facebook.tsx +15 -15
  245. package/src/lib/authentication/ui/icons/Github.tsx +16 -16
  246. package/src/lib/authentication/ui/icons/Google.tsx +16 -16
  247. package/src/lib/authentication/ui/icons/Microsoft.tsx +12 -12
  248. package/src/lib/authentication/ui/icons/X.tsx +10 -10
  249. package/src/lib/authentication/utils/relativeRedirectUrl.ts +16 -16
  250. package/src/lib/components/AiAssistantMenuItems.tsx +102 -102
  251. package/src/lib/components/AnchorLink.tsx +24 -24
  252. package/src/lib/components/Autocomplete.tsx +123 -123
  253. package/src/lib/components/Banner.tsx +52 -52
  254. package/src/lib/components/Bootstrap.tsx +77 -77
  255. package/src/lib/components/BuildCheck.tsx +87 -87
  256. package/src/lib/components/CategoryHeading.tsx +19 -19
  257. package/src/lib/components/ClientOnly.tsx +19 -19
  258. package/src/lib/components/DeveloperHint.tsx +39 -39
  259. package/src/lib/components/ErrorPage.tsx +26 -26
  260. package/src/lib/components/Footer.tsx +146 -146
  261. package/src/lib/components/Framed.tsx +51 -51
  262. package/src/lib/components/Header.tsx +261 -261
  263. package/src/lib/components/HeaderAuthActions.tsx +32 -32
  264. package/src/lib/components/HeaderNavigation.tsx +176 -176
  265. package/src/lib/components/Heading.tsx +84 -84
  266. package/src/lib/components/InlineCode.tsx +15 -15
  267. package/src/lib/components/LandingLayout.tsx +27 -27
  268. package/src/lib/components/LanguageIcon.tsx +199 -199
  269. package/src/lib/components/Layout.tsx +59 -59
  270. package/src/lib/components/Main.tsx +52 -52
  271. package/src/lib/components/Markdown.tsx +55 -55
  272. package/src/lib/components/Mermaid.tsx +74 -74
  273. package/src/lib/components/Meta.tsx +46 -46
  274. package/src/lib/components/MobileTopNavigation.tsx +283 -283
  275. package/src/lib/components/MultiSelect.tsx +86 -86
  276. package/src/lib/components/NotFoundPage.tsx +37 -37
  277. package/src/lib/components/PageProgress.tsx +28 -28
  278. package/src/lib/components/PagefindSearchMeta.tsx +14 -14
  279. package/src/lib/components/Pagination.tsx +44 -44
  280. package/src/lib/components/PathRenderer.tsx +61 -61
  281. package/src/lib/components/PluginHeads.tsx +17 -17
  282. package/src/lib/components/Search.tsx +70 -70
  283. package/src/lib/components/SiteTitle.tsx +58 -58
  284. package/src/lib/components/Slot.tsx +65 -65
  285. package/src/lib/components/Spinner.tsx +5 -5
  286. package/src/lib/components/StatusPage.tsx +96 -96
  287. package/src/lib/components/ThemeSwitch.tsx +99 -99
  288. package/src/lib/components/TopNavigation.tsx +90 -90
  289. package/src/lib/components/Typography.tsx +12 -12
  290. package/src/lib/components/Zudoku.tsx +105 -105
  291. package/src/lib/components/cache.ts +27 -27
  292. package/src/lib/components/context/RenderContext.ts +11 -11
  293. package/src/lib/components/context/RouterEventsEmitter.tsx +19 -19
  294. package/src/lib/components/context/SlotProvider.tsx +149 -149
  295. package/src/lib/components/context/ViewportAnchorContext.tsx +137 -137
  296. package/src/lib/components/context/ZudokuContext.ts +140 -140
  297. package/src/lib/components/context/ZudokuProvider.tsx +20 -20
  298. package/src/lib/components/context/ZudokuReactContext.tsx +17 -17
  299. package/src/lib/components/index.ts +36 -36
  300. package/src/lib/components/navigation/Navigation.tsx +51 -51
  301. package/src/lib/components/navigation/NavigationBadge.tsx +48 -48
  302. package/src/lib/components/navigation/NavigationCategory.tsx +157 -157
  303. package/src/lib/components/navigation/NavigationFilterContext.tsx +28 -28
  304. package/src/lib/components/navigation/NavigationFilterInput.tsx +35 -35
  305. package/src/lib/components/navigation/NavigationItem.tsx +181 -181
  306. package/src/lib/components/navigation/NavigationWrapper.tsx +49 -49
  307. package/src/lib/components/navigation/PoweredByZudoku.tsx +39 -39
  308. package/src/lib/components/navigation/Toc.tsx +137 -137
  309. package/src/lib/components/navigation/ZudokuLogo.tsx +25 -25
  310. package/src/lib/components/navigation/ZuploLogo.tsx +14 -14
  311. package/src/lib/components/navigation/utils.ts +234 -234
  312. package/src/lib/core/RouteGuard.tsx +260 -260
  313. package/src/lib/core/ZudokuContext.ts +272 -272
  314. package/src/lib/core/plugins.ts +139 -139
  315. package/src/lib/core/react-query.ts +1 -1
  316. package/src/lib/core/router.ts +1 -1
  317. package/src/lib/core/transform-config.ts +67 -67
  318. package/src/lib/demo/DemoAnnouncement.tsx +17 -17
  319. package/src/lib/errors/ErrorAlert.tsx +28 -28
  320. package/src/lib/errors/ErrorMessage.tsx +50 -50
  321. package/src/lib/errors/RouterError.tsx +18 -18
  322. package/src/lib/errors/ServerError.tsx +5 -5
  323. package/src/lib/errors/TopLevelError.tsx +6 -6
  324. package/src/lib/hooks/index.ts +13 -13
  325. package/src/lib/hooks/useEvent.ts +41 -41
  326. package/src/lib/hooks/useHighlighter.ts +15 -15
  327. package/src/lib/hooks/useHotkey.ts +70 -70
  328. package/src/lib/icons.ts +2 -2
  329. package/src/lib/navigation/applyRules.ts +127 -127
  330. package/src/lib/navigation/pathMatcher.ts +81 -81
  331. package/src/lib/oas/graphql/circular.ts +69 -69
  332. package/src/lib/oas/graphql/constants.ts +2 -2
  333. package/src/lib/oas/graphql/index.ts +791 -791
  334. package/src/lib/oas/parser/dereference/index.ts +84 -84
  335. package/src/lib/oas/parser/dereference/resolveRef.ts +32 -32
  336. package/src/lib/oas/parser/index.ts +129 -129
  337. package/src/lib/oas/parser/schemas/v3.0.json +1489 -1489
  338. package/src/lib/oas/parser/schemas/v3.1.json +1298 -1298
  339. package/src/lib/oas/parser/upgrade/index.ts +174 -174
  340. package/src/lib/plugins/api-catalog/Catalog.tsx +80 -80
  341. package/src/lib/plugins/api-catalog/index.tsx +119 -119
  342. package/src/lib/plugins/api-keys/CreateApiKey.tsx +128 -128
  343. package/src/lib/plugins/api-keys/CreateApiKeyDialog.tsx +49 -49
  344. package/src/lib/plugins/api-keys/ProtectedRoute.tsx +33 -33
  345. package/src/lib/plugins/api-keys/SettingsApiKeys.tsx +72 -72
  346. package/src/lib/plugins/api-keys/index.tsx +274 -274
  347. package/src/lib/plugins/api-keys/settings/ApiKeyItem.tsx +342 -342
  348. package/src/lib/plugins/api-keys/settings/ApiKeyList.tsx +67 -67
  349. package/src/lib/plugins/api-keys/settings/RevealApiKey.tsx +127 -127
  350. package/src/lib/plugins/custom-pages/index.tsx +32 -32
  351. package/src/lib/plugins/markdown/MdxPage.tsx +260 -260
  352. package/src/lib/plugins/markdown/assets/ChatGPTLogo.tsx +11 -11
  353. package/src/lib/plugins/markdown/assets/ClaudeLogo.tsx +19 -19
  354. package/src/lib/plugins/markdown/index.tsx +82 -82
  355. package/src/lib/plugins/openapi/ApiHeader.tsx +96 -96
  356. package/src/lib/plugins/openapi/CollapsibleCode.tsx +88 -88
  357. package/src/lib/plugins/openapi/ColorizedParam.tsx +115 -115
  358. package/src/lib/plugins/openapi/DownloadSchemaButton.tsx +94 -94
  359. package/src/lib/plugins/openapi/Endpoint.tsx +85 -85
  360. package/src/lib/plugins/openapi/GeneratedExampleSidecarBox.tsx +52 -52
  361. package/src/lib/plugins/openapi/MCPEndpoint.tsx +273 -273
  362. package/src/lib/plugins/openapi/OasProvider.tsx +74 -74
  363. package/src/lib/plugins/openapi/OperationList.tsx +275 -275
  364. package/src/lib/plugins/openapi/OperationListItem.tsx +183 -183
  365. package/src/lib/plugins/openapi/ParamInfos.tsx +96 -96
  366. package/src/lib/plugins/openapi/ParameterList.tsx +53 -53
  367. package/src/lib/plugins/openapi/ParameterListItem.tsx +161 -161
  368. package/src/lib/plugins/openapi/PlaygroundDialogWrapper.tsx +67 -67
  369. package/src/lib/plugins/openapi/RequestBodySidecarBox.tsx +63 -63
  370. package/src/lib/plugins/openapi/ResponsesSidecarBox.tsx +120 -120
  371. package/src/lib/plugins/openapi/SchemaInfo.tsx +344 -344
  372. package/src/lib/plugins/openapi/SchemaList.tsx +113 -113
  373. package/src/lib/plugins/openapi/Sidecar.tsx +314 -314
  374. package/src/lib/plugins/openapi/SidecarBox.tsx +57 -57
  375. package/src/lib/plugins/openapi/SidecarExamples.tsx +177 -177
  376. package/src/lib/plugins/openapi/SimpleSelect.tsx +46 -46
  377. package/src/lib/plugins/openapi/client/GraphQLClient.tsx +73 -73
  378. package/src/lib/plugins/openapi/client/GraphQLContext.tsx +16 -16
  379. package/src/lib/plugins/openapi/client/createServer.ts +35 -35
  380. package/src/lib/plugins/openapi/client/useCreateQuery.ts +44 -44
  381. package/src/lib/plugins/openapi/components/ConstValue.tsx +24 -24
  382. package/src/lib/plugins/openapi/components/EnumValues.tsx +58 -58
  383. package/src/lib/plugins/openapi/components/NonHighlightedCode.tsx +22 -22
  384. package/src/lib/plugins/openapi/components/ResponseContent.tsx +117 -117
  385. package/src/lib/plugins/openapi/components/SelectOnClick.tsx +29 -29
  386. package/src/lib/plugins/openapi/context.tsx +16 -16
  387. package/src/lib/plugins/openapi/graphql/fragment-masking.ts +104 -104
  388. package/src/lib/plugins/openapi/graphql/gql.ts +95 -95
  389. package/src/lib/plugins/openapi/graphql/graphql.ts +835 -835
  390. package/src/lib/plugins/openapi/graphql/index.ts +2 -2
  391. package/src/lib/plugins/openapi/index.tsx +221 -221
  392. package/src/lib/plugins/openapi/interfaces.ts +100 -100
  393. package/src/lib/plugins/openapi/playground/BodyPanel.tsx +274 -274
  394. package/src/lib/plugins/openapi/playground/CollapsibleHeader.tsx +51 -51
  395. package/src/lib/plugins/openapi/playground/ExamplesDropdown.tsx +60 -60
  396. package/src/lib/plugins/openapi/playground/Headers.tsx +194 -194
  397. package/src/lib/plugins/openapi/playground/IdentityDialog.tsx +75 -75
  398. package/src/lib/plugins/openapi/playground/IdentitySelector.tsx +38 -38
  399. package/src/lib/plugins/openapi/playground/ParamsGrid.tsx +45 -45
  400. package/src/lib/plugins/openapi/playground/PathParams.tsx +53 -53
  401. package/src/lib/plugins/openapi/playground/Playground.tsx +602 -602
  402. package/src/lib/plugins/openapi/playground/PlaygroundDialog.tsx +62 -62
  403. package/src/lib/plugins/openapi/playground/QueryParams.tsx +151 -151
  404. package/src/lib/plugins/openapi/playground/RequestLoginDialog.tsx +70 -70
  405. package/src/lib/plugins/openapi/playground/Spinner.tsx +87 -87
  406. package/src/lib/plugins/openapi/playground/createUrl.ts +25 -25
  407. package/src/lib/plugins/openapi/playground/fileUtils.ts +36 -36
  408. package/src/lib/plugins/openapi/playground/rememberedIdentity.ts +26 -26
  409. package/src/lib/plugins/openapi/playground/request-panel/MultipartField.tsx +91 -91
  410. package/src/lib/plugins/openapi/playground/request-panel/UrlPath.tsx +31 -31
  411. package/src/lib/plugins/openapi/playground/request-panel/UrlQueryParams.tsx +29 -29
  412. package/src/lib/plugins/openapi/playground/request-panel/useKeyValueFieldManager.ts +340 -340
  413. package/src/lib/plugins/openapi/playground/result-panel/AudioPlayer.tsx +50 -50
  414. package/src/lib/plugins/openapi/playground/result-panel/ResponseStatusBar.tsx +117 -117
  415. package/src/lib/plugins/openapi/playground/result-panel/ResponseTab.tsx +355 -355
  416. package/src/lib/plugins/openapi/playground/result-panel/ResultPanel.tsx +106 -106
  417. package/src/lib/plugins/openapi/playground/result-panel/convertToTypes.ts +36 -36
  418. package/src/lib/plugins/openapi/playground/serializeQueryParams.ts +125 -125
  419. package/src/lib/plugins/openapi/playground/useRememberSkipLoginDialog.tsx +23 -23
  420. package/src/lib/plugins/openapi/processors/injectApitogoGatewayServer.ts +36 -36
  421. package/src/lib/plugins/openapi/processors/removeExtensions.ts +29 -29
  422. package/src/lib/plugins/openapi/processors/removeParameters.ts +103 -103
  423. package/src/lib/plugins/openapi/processors/removePaths.ts +57 -57
  424. package/src/lib/plugins/openapi/processors/traverse.ts +1 -1
  425. package/src/lib/plugins/openapi/schema/SchemaExampleAndDefault.tsx +39 -39
  426. package/src/lib/plugins/openapi/schema/SchemaPropertyItem.tsx +189 -189
  427. package/src/lib/plugins/openapi/schema/SchemaView.tsx +299 -299
  428. package/src/lib/plugins/openapi/schema/UnionView.tsx +132 -132
  429. package/src/lib/plugins/openapi/schema/union-helpers.ts +123 -123
  430. package/src/lib/plugins/openapi/schema/utils.ts +49 -49
  431. package/src/lib/plugins/openapi/state.ts +36 -36
  432. package/src/lib/plugins/openapi/util/buildTagCategories.ts +54 -54
  433. package/src/lib/plugins/openapi/util/createHttpSnippet.ts +135 -135
  434. package/src/lib/plugins/openapi/util/createNavigationCategory.tsx +39 -39
  435. package/src/lib/plugins/openapi/util/generateSchemaExample.ts +191 -191
  436. package/src/lib/plugins/openapi/util/getRoutes.tsx +265 -265
  437. package/src/lib/plugins/openapi/util/methodColorMap.tsx +11 -11
  438. package/src/lib/plugins/openapi/util/methodToColor.ts +27 -27
  439. package/src/lib/plugins/openapi/util/sanitizeMarkdownForMetatag.tsx +32 -32
  440. package/src/lib/plugins/openapi/util/useWarmupSchema.ts +23 -23
  441. package/src/lib/plugins/search-inkeep/index.tsx +108 -108
  442. package/src/lib/plugins/search-inkeep/inkeep.ts +24 -24
  443. package/src/lib/plugins/search-pagefind/IndexingDialog.tsx +162 -162
  444. package/src/lib/plugins/search-pagefind/PagefindSearch.tsx +202 -202
  445. package/src/lib/plugins/search-pagefind/ResultList.tsx +122 -122
  446. package/src/lib/plugins/search-pagefind/get-results.tsx +74 -74
  447. package/src/lib/plugins/search-pagefind/index.tsx +21 -21
  448. package/src/lib/plugins/search-pagefind/types.ts +118 -118
  449. package/src/lib/shiki-constants.ts +24 -24
  450. package/src/lib/shiki.ts +179 -179
  451. package/src/lib/testing/index.tsx +147 -147
  452. package/src/lib/ui/Accordion.tsx +55 -55
  453. package/src/lib/ui/ActionButton.tsx +21 -21
  454. package/src/lib/ui/Alert.tsx +84 -84
  455. package/src/lib/ui/AlertDialog.tsx +195 -195
  456. package/src/lib/ui/AspectRatio.tsx +5 -5
  457. package/src/lib/ui/Badge.tsx +48 -48
  458. package/src/lib/ui/Breadcrumb.tsx +115 -115
  459. package/src/lib/ui/Button.tsx +65 -65
  460. package/src/lib/ui/ButtonGroup.tsx +80 -80
  461. package/src/lib/ui/Callout.tsx +113 -113
  462. package/src/lib/ui/Card.tsx +95 -95
  463. package/src/lib/ui/Carousel.tsx +259 -259
  464. package/src/lib/ui/Checkbox.tsx +28 -28
  465. package/src/lib/ui/CodeBlock.tsx +92 -92
  466. package/src/lib/ui/CodeTabPanel.tsx +13 -13
  467. package/src/lib/ui/CodeTabs.tsx +161 -161
  468. package/src/lib/ui/Collapsible.tsx +31 -31
  469. package/src/lib/ui/Command.tsx +191 -191
  470. package/src/lib/ui/Dialog.tsx +138 -138
  471. package/src/lib/ui/DismissibleAlert.tsx +74 -74
  472. package/src/lib/ui/Drawer.tsx +121 -121
  473. package/src/lib/ui/DropdownMenu.tsx +254 -254
  474. package/src/lib/ui/EmbeddedCodeBlock.tsx +99 -99
  475. package/src/lib/ui/Form.tsx +176 -176
  476. package/src/lib/ui/Frame.tsx +81 -81
  477. package/src/lib/ui/HoverCard.tsx +26 -26
  478. package/src/lib/ui/Input.tsx +23 -23
  479. package/src/lib/ui/InputGroup.tsx +168 -168
  480. package/src/lib/ui/Item.tsx +213 -213
  481. package/src/lib/ui/Kbd.tsx +28 -28
  482. package/src/lib/ui/Label.tsx +23 -23
  483. package/src/lib/ui/NativeSelect.tsx +48 -48
  484. package/src/lib/ui/NavigationMenu.tsx +169 -169
  485. package/src/lib/ui/Pagination.tsx +115 -115
  486. package/src/lib/ui/Popover.tsx +28 -28
  487. package/src/lib/ui/Progress.tsx +25 -25
  488. package/src/lib/ui/RadioGroup.tsx +41 -41
  489. package/src/lib/ui/ReactComponentDoc.tsx +68 -68
  490. package/src/lib/ui/ScrollArea.tsx +45 -45
  491. package/src/lib/ui/Secret.tsx +133 -133
  492. package/src/lib/ui/Select.tsx +184 -184
  493. package/src/lib/ui/Separator.tsx +25 -25
  494. package/src/lib/ui/Skeleton.tsx +15 -15
  495. package/src/lib/ui/Slider.tsx +25 -25
  496. package/src/lib/ui/Stepper.tsx +8 -8
  497. package/src/lib/ui/Switch.tsx +26 -26
  498. package/src/lib/ui/SyntaxHighlight.tsx +54 -54
  499. package/src/lib/ui/Tabs.tsx +52 -52
  500. package/src/lib/ui/Textarea.tsx +22 -22
  501. package/src/lib/ui/Toggle.tsx +42 -42
  502. package/src/lib/ui/ToggleGroup.tsx +58 -58
  503. package/src/lib/ui/Tooltip.tsx +65 -65
  504. package/src/lib/ui/Value.tsx +42 -42
  505. package/src/lib/ui/util.tsx +8 -8
  506. package/src/lib/util/MdxComponents.tsx +150 -150
  507. package/src/lib/util/cn.ts +6 -6
  508. package/src/lib/util/createVariantComponent.tsx +61 -61
  509. package/src/lib/util/ensureArray.ts +3 -3
  510. package/src/lib/util/flattenAllOf.ts +72 -72
  511. package/src/lib/util/flattenAllOfProcessor.ts +74 -74
  512. package/src/lib/util/hastToJsx.tsx +67 -67
  513. package/src/lib/util/humanFileSize.ts +15 -15
  514. package/src/lib/util/invariant.ts +52 -52
  515. package/src/lib/util/joinUrl.ts +60 -60
  516. package/src/lib/util/logInit.ts +9 -9
  517. package/src/lib/util/objectEntries.ts +5 -5
  518. package/src/lib/util/os.ts +18 -18
  519. package/src/lib/util/pastellize.ts +25 -25
  520. package/src/lib/util/problemJson.ts +63 -63
  521. package/src/lib/util/readFrontmatter.ts +14 -14
  522. package/src/lib/util/renderIf.ts +4 -4
  523. package/src/lib/util/scrollIntoViewIfNeeded.ts +18 -18
  524. package/src/lib/util/slugify.ts +21 -21
  525. package/src/lib/util/syncZustandState.ts +22 -22
  526. package/src/lib/util/traverse.ts +70 -70
  527. package/src/lib/util/types.ts +7 -7
  528. package/src/lib/util/url.ts +18 -18
  529. package/src/lib/util/useCopyToClipboard.ts +17 -17
  530. package/src/lib/util/useExposedProps.tsx +27 -27
  531. package/src/lib/util/useIsomorphicLayoutEffect.ts +6 -6
  532. package/src/lib/util/useLatest.ts +18 -18
  533. package/src/lib/util/useOnScreen.ts +34 -34
  534. package/src/lib/util/useScrollToAnchor.ts +75 -75
  535. package/src/lib/util/useScrollToTop.ts +18 -18
  536. package/src/types.d.ts +66 -66
  537. package/src/vite/api/SchemaManager.ts +371 -371
  538. package/src/vite/api/schema-codegen.ts +163 -163
  539. package/src/vite/build.ts +237 -237
  540. package/src/vite/config.ts +273 -273
  541. package/src/vite/css/collect.ts +42 -42
  542. package/src/vite/css/plugin.ts +105 -105
  543. package/src/vite/debug.ts +18 -18
  544. package/src/vite/dev-portal-env.ts +29 -29
  545. package/src/vite/dev-server.ts +294 -294
  546. package/src/vite/html.ts +52 -52
  547. package/src/vite/index.ts +2 -2
  548. package/src/vite/llms.ts +99 -99
  549. package/src/vite/mdx/rehype-extract-toc-with-jsx-export.ts +19 -19
  550. package/src/vite/mdx/rehype-extract-toc-with-jsx.ts +70 -70
  551. package/src/vite/mdx/remark-code-tabs.ts +47 -47
  552. package/src/vite/mdx/remark-inject-filepath.ts +13 -13
  553. package/src/vite/mdx/remark-last-modified.ts +103 -103
  554. package/src/vite/mdx/remark-link-rewrite.ts +23 -23
  555. package/src/vite/mdx/remark-normalize-image-url.ts +15 -15
  556. package/src/vite/mdx/remark-static-generation.ts +149 -149
  557. package/src/vite/mdx/utils.ts +32 -32
  558. package/src/vite/output.ts +261 -261
  559. package/src/vite/package-root.ts +12 -12
  560. package/src/vite/pagefind-dev-index.ts +100 -100
  561. package/src/vite/pagefind-dev-stub.ts +17 -17
  562. package/src/vite/plugin-api-keys.ts +55 -55
  563. package/src/vite/plugin-api.ts +328 -328
  564. package/src/vite/plugin-auth.ts +41 -41
  565. package/src/vite/plugin-component.ts +45 -45
  566. package/src/vite/plugin-config-reload.ts +47 -47
  567. package/src/vite/plugin-config.ts +131 -131
  568. package/src/vite/plugin-custom-pages.ts +36 -36
  569. package/src/vite/plugin-doc-metadata.ts +45 -45
  570. package/src/vite/plugin-docs.ts +205 -205
  571. package/src/vite/plugin-local-manifest.ts +100 -100
  572. package/src/vite/plugin-markdown-export.ts +214 -214
  573. package/src/vite/plugin-mdx.ts +149 -149
  574. package/src/vite/plugin-metadata.ts +30 -30
  575. package/src/vite/plugin-modules.ts +188 -188
  576. package/src/vite/plugin-navigation.ts +106 -106
  577. package/src/vite/plugin-offroot-resolve.ts +67 -67
  578. package/src/vite/plugin-search.ts +59 -59
  579. package/src/vite/plugin-shiki-register.ts +97 -97
  580. package/src/vite/plugin-theme.ts +458 -458
  581. package/src/vite/plugin.ts +48 -48
  582. package/src/vite/prerender/prerender.ts +242 -242
  583. package/src/vite/prerender/utils.ts +76 -76
  584. package/src/vite/prerender/worker.ts +118 -118
  585. package/src/vite/reporter.ts +34 -34
  586. package/src/vite/shadcn-registry.ts +48 -48
  587. package/src/vite/sitemap.ts +78 -78
  588. package/src/vite/ssr-templates/cloudflare.ts +19 -19
  589. package/src/vite/ssr-templates/node.ts +25 -25
  590. package/src/vite/ssr-templates/vercel.ts +22 -22
  591. package/src/vite/watch-ignore.ts +70 -70
  592. package/src/vite/zuplo.ts +30 -30
  593. package/src/vite-env.d.ts +6 -6
  594. package/src/zuplo/enrich-with-zuplo-mcp.ts +168 -168
  595. package/src/zuplo/enrich-with-zuplo.ts +256 -256
  596. package/src/zuplo/policy-types.ts +46 -46
  597. package/src/zuplo/with-zuplo-processors.ts +36 -36
  598. package/src/zuplo/with-zuplo.ts +14 -14
  599. package/dist/declarations/cli/platform/client/deploy-server.d.ts +0 -16
package/src/app/main.tsx CHANGED
@@ -1,167 +1,167 @@
1
- import { Apitogo } from "@lukoweb/apitogo/components";
2
- import { Outlet } from "@lukoweb/apitogo/router";
3
- import type { RouteObject } from "react-router";
4
- import type { HighlighterCore } from "shiki";
5
- import { configuredApiKeysPlugin } from "virtual:zudoku-api-keys-plugin";
6
- import {
7
- configuredApiCatalogPlugins,
8
- configuredApiPlugins,
9
- } from "virtual:zudoku-api-plugins";
10
- import { configuredAuthProvider } from "virtual:zudoku-auth";
11
- import { configuredCustomPagesPlugin } from "virtual:zudoku-custom-pages-plugin";
12
- import { configuredDocsPlugin } from "virtual:zudoku-docs-plugin";
13
- import {
14
- configuredModulesPlugins,
15
- configuredModulesSlots,
16
- } from "virtual:zudoku-modules-plugin";
17
- import "virtual:zudoku-theme.css";
18
- import {
19
- configuredHeaderNavigation,
20
- configuredNavigation,
21
- configuredNavigationRules,
22
- } from "virtual:zudoku-navigation";
23
- import { configuredSearchPlugin } from "virtual:zudoku-search-plugin";
24
- import type { ApitogoConfig } from "../config/config.js";
25
- import {
26
- resolveModulesConfig,
27
- getEffectiveRedirects,
28
- } from "../config/resolve-modules.js";
29
- import { BuildCheck } from "../lib/components/BuildCheck.js";
30
- import "./main.css";
31
- import { Meta } from "../lib/components/Meta.js";
32
- import "./polyfills.js";
33
- import { StatusPage } from "../lib/components/StatusPage.js";
34
- import { isNavigationPlugin } from "../lib/core/plugins.js";
35
- import { RouteGuard } from "../lib/core/RouteGuard.js";
36
- import type { ZudokuContextOptions } from "../lib/core/ZudokuContext.js";
37
- import { RouterError } from "../lib/errors/RouterError.js";
38
- import { ZuploEnv } from "./env.js";
39
- import { processRoutes } from "./processRoutes.js";
40
- import { createRedirectRoutes } from "./utils/createRedirectRoutes.js";
41
-
42
- export const shikiReady: Promise<HighlighterCore> =
43
- import("../lib/shiki.js").then(async ({ highlighterPromise }) => {
44
- const highlighter = await highlighterPromise;
45
- const { registerShiki } = await import("virtual:zudoku-shiki-register");
46
- await registerShiki(highlighter);
47
- return highlighter;
48
- });
49
-
50
- export const convertApitogoConfigToOptions = (
51
- config: ApitogoConfig,
52
- ): ZudokuContextOptions => {
53
- const siteTitle =
54
- config.metadata?.applicationName ?? config.site?.title ?? "API ToGo";
55
-
56
- return {
57
- basePath: config.basePath,
58
- canonicalUrlOrigin: config.canonicalUrlOrigin,
59
- aiAssistants: config.aiAssistants,
60
- protectedRoutes: config.protectedRoutes,
61
- site: {
62
- ...config.site,
63
- showPoweredBy: ZuploEnv.buildConfig?.entitlements.devPortalZuploBranding,
64
- logo: config.site?.logo,
65
- },
66
- slots: { ...configuredModulesSlots, ...config.slots },
67
- metadata: {
68
- applicationName: siteTitle,
69
- defaultTitle: siteTitle,
70
- title: `%s - ${siteTitle}`,
71
- ...config.metadata,
72
- },
73
- header: {
74
- navigation: configuredHeaderNavigation,
75
- placements: config.header?.placements,
76
- },
77
- navigation: configuredNavigation,
78
- navigationRules: configuredNavigationRules,
79
- mdx: config.mdx,
80
- plugins: [
81
- ...(configuredAuthProvider ? [configuredAuthProvider] : []),
82
- ...(configuredDocsPlugin ? [configuredDocsPlugin] : []),
83
- ...configuredApiPlugins,
84
- ...(configuredSearchPlugin ? [configuredSearchPlugin] : []),
85
- ...(configuredApiKeysPlugin ? [configuredApiKeysPlugin] : []),
86
- ...(configuredCustomPagesPlugin ? [configuredCustomPagesPlugin] : []),
87
- ...configuredModulesPlugins,
88
- ...configuredApiCatalogPlugins,
89
- ...(config.plugins ?? []),
90
- ],
91
- syntaxHighlighting: {
92
- highlighterPromise: shikiReady,
93
- themes: config.syntaxHighlighting?.themes,
94
- },
95
- };
96
- };
97
-
98
- /**
99
- * @deprecated Use {@link convertApitogoConfigToOptions} instead.
100
- */
101
- export const convertZudokuConfigToOptions = convertApitogoConfigToOptions;
102
-
103
- export const getRoutesByOptions = (
104
- options: ZudokuContextOptions,
105
- enableStatusPages = true,
106
- ) => {
107
- const allPlugins = [
108
- ...(options.plugins ?? []),
109
- ...(options.authentication ? [options.authentication] : []),
110
- ];
111
-
112
- const routes = allPlugins
113
- .flatMap((plugin) => (isNavigationPlugin(plugin) ? plugin.getRoutes() : []))
114
- .concat(
115
- enableStatusPages
116
- ? [400, 404, 500].map((statusCode) => ({
117
- path: `/${statusCode}`,
118
- element: <StatusPage statusCode={statusCode} />,
119
- }))
120
- : [],
121
- )
122
- .concat([{ path: "*", element: <StatusPage statusCode={404} /> }])
123
- .map((route) => ({
124
- ...route,
125
- errorElement: <RouterError className="w-full m-0" />,
126
- }));
127
-
128
- // @TODO Detect conflicts in routes and log warning
129
-
130
- return routes;
131
- };
132
-
133
- export const getRoutesByConfig = (config: ApitogoConfig): RouteObject[] => {
134
- const resolvedModules = resolveModulesConfig(config);
135
- const options = convertApitogoConfigToOptions(config);
136
- const routes = getRoutesByOptions(
137
- options,
138
- import.meta.env.IS_ZUPLO || config.enableStatusPages,
139
- );
140
-
141
- return [
142
- ...createRedirectRoutes(getEffectiveRedirects(config, resolvedModules)),
143
- {
144
- element: (
145
- <Apitogo {...options} env={import.meta.env}>
146
- <BuildCheck
147
- buildId={import.meta.env.ZUPLO_BUILD_ID}
148
- environmentType={import.meta.env.ZUPLO_ENVIRONMENT_TYPE}
149
- />
150
- <Outlet />
151
- </Apitogo>
152
- ),
153
- hydrateFallbackElement: <div>Loading...</div>,
154
- children: [
155
- {
156
- element: (
157
- <Meta>
158
- <RouteGuard />
159
- </Meta>
160
- ),
161
- errorElement: <RouterError />,
162
- children: processRoutes(routes),
163
- },
164
- ],
165
- },
166
- ];
167
- };
1
+ import { Apitogo } from "@lukoweb/apitogo/components";
2
+ import { Outlet } from "@lukoweb/apitogo/router";
3
+ import type { RouteObject } from "react-router";
4
+ import type { HighlighterCore } from "shiki";
5
+ import { configuredApiKeysPlugin } from "virtual:zudoku-api-keys-plugin";
6
+ import {
7
+ configuredApiCatalogPlugins,
8
+ configuredApiPlugins,
9
+ } from "virtual:zudoku-api-plugins";
10
+ import { configuredAuthProvider } from "virtual:zudoku-auth";
11
+ import { configuredCustomPagesPlugin } from "virtual:zudoku-custom-pages-plugin";
12
+ import { configuredDocsPlugin } from "virtual:zudoku-docs-plugin";
13
+ import {
14
+ configuredModulesPlugins,
15
+ configuredModulesSlots,
16
+ } from "virtual:zudoku-modules-plugin";
17
+ import "virtual:zudoku-theme.css";
18
+ import {
19
+ configuredHeaderNavigation,
20
+ configuredNavigation,
21
+ configuredNavigationRules,
22
+ } from "virtual:zudoku-navigation";
23
+ import { configuredSearchPlugin } from "virtual:zudoku-search-plugin";
24
+ import type { ApitogoConfig } from "../config/config.js";
25
+ import {
26
+ resolveModulesConfig,
27
+ getEffectiveRedirects,
28
+ } from "../config/resolve-modules.js";
29
+ import { BuildCheck } from "../lib/components/BuildCheck.js";
30
+ import "./main.css";
31
+ import { Meta } from "../lib/components/Meta.js";
32
+ import "./polyfills.js";
33
+ import { StatusPage } from "../lib/components/StatusPage.js";
34
+ import { isNavigationPlugin } from "../lib/core/plugins.js";
35
+ import { RouteGuard } from "../lib/core/RouteGuard.js";
36
+ import type { ZudokuContextOptions } from "../lib/core/ZudokuContext.js";
37
+ import { RouterError } from "../lib/errors/RouterError.js";
38
+ import { ZuploEnv } from "./env.js";
39
+ import { processRoutes } from "./processRoutes.js";
40
+ import { createRedirectRoutes } from "./utils/createRedirectRoutes.js";
41
+
42
+ export const shikiReady: Promise<HighlighterCore> =
43
+ import("../lib/shiki.js").then(async ({ highlighterPromise }) => {
44
+ const highlighter = await highlighterPromise;
45
+ const { registerShiki } = await import("virtual:zudoku-shiki-register");
46
+ await registerShiki(highlighter);
47
+ return highlighter;
48
+ });
49
+
50
+ export const convertApitogoConfigToOptions = (
51
+ config: ApitogoConfig,
52
+ ): ZudokuContextOptions => {
53
+ const siteTitle =
54
+ config.metadata?.applicationName ?? config.site?.title ?? "API ToGo";
55
+
56
+ return {
57
+ basePath: config.basePath,
58
+ canonicalUrlOrigin: config.canonicalUrlOrigin,
59
+ aiAssistants: config.aiAssistants,
60
+ protectedRoutes: config.protectedRoutes,
61
+ site: {
62
+ ...config.site,
63
+ showPoweredBy: ZuploEnv.buildConfig?.entitlements.devPortalZuploBranding,
64
+ logo: config.site?.logo,
65
+ },
66
+ slots: { ...configuredModulesSlots, ...config.slots },
67
+ metadata: {
68
+ applicationName: siteTitle,
69
+ defaultTitle: siteTitle,
70
+ title: `%s - ${siteTitle}`,
71
+ ...config.metadata,
72
+ },
73
+ header: {
74
+ navigation: configuredHeaderNavigation,
75
+ placements: config.header?.placements,
76
+ },
77
+ navigation: configuredNavigation,
78
+ navigationRules: configuredNavigationRules,
79
+ mdx: config.mdx,
80
+ plugins: [
81
+ ...(configuredAuthProvider ? [configuredAuthProvider] : []),
82
+ ...(configuredDocsPlugin ? [configuredDocsPlugin] : []),
83
+ ...configuredApiPlugins,
84
+ ...(configuredSearchPlugin ? [configuredSearchPlugin] : []),
85
+ ...(configuredApiKeysPlugin ? [configuredApiKeysPlugin] : []),
86
+ ...(configuredCustomPagesPlugin ? [configuredCustomPagesPlugin] : []),
87
+ ...configuredModulesPlugins,
88
+ ...configuredApiCatalogPlugins,
89
+ ...(config.plugins ?? []),
90
+ ],
91
+ syntaxHighlighting: {
92
+ highlighterPromise: shikiReady,
93
+ themes: config.syntaxHighlighting?.themes,
94
+ },
95
+ };
96
+ };
97
+
98
+ /**
99
+ * @deprecated Use {@link convertApitogoConfigToOptions} instead.
100
+ */
101
+ export const convertZudokuConfigToOptions = convertApitogoConfigToOptions;
102
+
103
+ export const getRoutesByOptions = (
104
+ options: ZudokuContextOptions,
105
+ enableStatusPages = true,
106
+ ) => {
107
+ const allPlugins = [
108
+ ...(options.plugins ?? []),
109
+ ...(options.authentication ? [options.authentication] : []),
110
+ ];
111
+
112
+ const routes = allPlugins
113
+ .flatMap((plugin) => (isNavigationPlugin(plugin) ? plugin.getRoutes() : []))
114
+ .concat(
115
+ enableStatusPages
116
+ ? [400, 404, 500].map((statusCode) => ({
117
+ path: `/${statusCode}`,
118
+ element: <StatusPage statusCode={statusCode} />,
119
+ }))
120
+ : [],
121
+ )
122
+ .concat([{ path: "*", element: <StatusPage statusCode={404} /> }])
123
+ .map((route) => ({
124
+ ...route,
125
+ errorElement: <RouterError className="w-full m-0" />,
126
+ }));
127
+
128
+ // @TODO Detect conflicts in routes and log warning
129
+
130
+ return routes;
131
+ };
132
+
133
+ export const getRoutesByConfig = (config: ApitogoConfig): RouteObject[] => {
134
+ const resolvedModules = resolveModulesConfig(config);
135
+ const options = convertApitogoConfigToOptions(config);
136
+ const routes = getRoutesByOptions(
137
+ options,
138
+ import.meta.env.IS_ZUPLO || config.enableStatusPages,
139
+ );
140
+
141
+ return [
142
+ ...createRedirectRoutes(getEffectiveRedirects(config, resolvedModules)),
143
+ {
144
+ element: (
145
+ <Apitogo {...options} env={import.meta.env}>
146
+ <BuildCheck
147
+ buildId={import.meta.env.ZUPLO_BUILD_ID}
148
+ environmentType={import.meta.env.ZUPLO_ENVIRONMENT_TYPE}
149
+ />
150
+ <Outlet />
151
+ </Apitogo>
152
+ ),
153
+ hydrateFallbackElement: <div>Loading...</div>,
154
+ children: [
155
+ {
156
+ element: (
157
+ <Meta>
158
+ <RouteGuard />
159
+ </Meta>
160
+ ),
161
+ errorElement: <RouterError />,
162
+ children: processRoutes(routes),
163
+ },
164
+ ],
165
+ },
166
+ ];
167
+ };
@@ -1,47 +1,47 @@
1
- if (typeof Object.groupBy === "undefined") {
2
- Object.groupBy = <K extends PropertyKey, T>(
3
- items: Iterable<T>,
4
- keySelector: (item: T, index: number) => K,
5
- ): Partial<Record<K, T[]>> => {
6
- const result = {} as Record<K, T[]>;
7
- let index = 0;
8
-
9
- for (const item of items) {
10
- const key = keySelector(item, index++);
11
-
12
- result[key] ??= [];
13
- result[key].push(item);
14
- }
15
- return result;
16
- };
17
- }
18
-
19
- // Freeze --scrollbar-width when react-remove-scroll locks the body, preventing
20
- // the CSS calc(100vw - 100%) from recalculating to 0 and causing layout shift.
21
- if (typeof window !== "undefined") {
22
- new MutationObserver(() => {
23
- const locked = document.body.hasAttribute("data-scroll-locked");
24
- const gap = locked
25
- ? getComputedStyle(document.body).getPropertyValue(
26
- "--removed-body-scroll-bar-size",
27
- )
28
- : "";
29
-
30
- if (gap) {
31
- document.documentElement.style.setProperty("--scrollbar-width", gap);
32
- } else {
33
- document.documentElement.style.removeProperty("--scrollbar-width");
34
- }
35
- }).observe(document.body, {
36
- attributes: true,
37
- attributeFilter: ["data-scroll-locked"],
38
- });
39
- }
40
-
41
- if (typeof window !== "undefined" && !window.requestIdleCallback) {
42
- window.requestIdleCallback = (cb: IdleRequestCallback) =>
43
- Number(
44
- setTimeout(() => cb({ didTimeout: false, timeRemaining: () => 50 }), 1),
45
- );
46
- window.cancelIdleCallback = (id: number) => clearTimeout(id);
47
- }
1
+ if (typeof Object.groupBy === "undefined") {
2
+ Object.groupBy = <K extends PropertyKey, T>(
3
+ items: Iterable<T>,
4
+ keySelector: (item: T, index: number) => K,
5
+ ): Partial<Record<K, T[]>> => {
6
+ const result = {} as Record<K, T[]>;
7
+ let index = 0;
8
+
9
+ for (const item of items) {
10
+ const key = keySelector(item, index++);
11
+
12
+ result[key] ??= [];
13
+ result[key].push(item);
14
+ }
15
+ return result;
16
+ };
17
+ }
18
+
19
+ // Freeze --scrollbar-width when react-remove-scroll locks the body, preventing
20
+ // the CSS calc(100vw - 100%) from recalculating to 0 and causing layout shift.
21
+ if (typeof window !== "undefined") {
22
+ new MutationObserver(() => {
23
+ const locked = document.body.hasAttribute("data-scroll-locked");
24
+ const gap = locked
25
+ ? getComputedStyle(document.body).getPropertyValue(
26
+ "--removed-body-scroll-bar-size",
27
+ )
28
+ : "";
29
+
30
+ if (gap) {
31
+ document.documentElement.style.setProperty("--scrollbar-width", gap);
32
+ } else {
33
+ document.documentElement.style.removeProperty("--scrollbar-width");
34
+ }
35
+ }).observe(document.body, {
36
+ attributes: true,
37
+ attributeFilter: ["data-scroll-locked"],
38
+ });
39
+ }
40
+
41
+ if (typeof window !== "undefined" && !window.requestIdleCallback) {
42
+ window.requestIdleCallback = (cb: IdleRequestCallback) =>
43
+ Number(
44
+ setTimeout(() => cb({ didTimeout: false, timeRemaining: () => 50 }), 1),
45
+ );
46
+ window.cancelIdleCallback = (id: number) => clearTimeout(id);
47
+ }
@@ -1,51 +1,51 @@
1
- import type { RouteObject } from "react-router";
2
- import { LandingLayout } from "../lib/components/LandingLayout.js";
3
- import { Layout } from "../lib/components/Layout.js";
4
-
5
- type LayoutMode = "default" | "landing" | "none";
6
-
7
- const resolveLayoutComponent = (layout: LayoutMode | undefined) => {
8
- if (layout === "landing") {
9
- return LandingLayout;
10
- }
11
-
12
- return Layout;
13
- };
14
-
15
- const shouldWrapRoute = (
16
- layout: LayoutMode | undefined,
17
- layoutDisabled?: boolean,
18
- ) => {
19
- if (layout === "none") {
20
- return false;
21
- }
22
-
23
- if (layoutDisabled) {
24
- return layout === "default" || layout === "landing";
25
- }
26
-
27
- return true;
28
- };
29
-
30
- export const processRoutes = (
31
- routes: RouteObject[],
32
- layoutDisabled?: boolean,
33
- ): RouteObject[] =>
34
- routes.map((r) => {
35
- const layout = r.handle?.layout as LayoutMode | undefined;
36
- const wrapRoute = shouldWrapRoute(layout, layoutDisabled);
37
- const LayoutComponent = wrapRoute ? resolveLayoutComponent(layout) : null;
38
-
39
- const route = r.children
40
- ? {
41
- ...r,
42
- children: LayoutComponent
43
- ? r.children
44
- : processRoutes(r.children, true),
45
- }
46
- : r;
47
-
48
- return LayoutComponent
49
- ? { element: <LayoutComponent />, children: [route] }
50
- : route;
51
- });
1
+ import type { RouteObject } from "react-router";
2
+ import { LandingLayout } from "../lib/components/LandingLayout.js";
3
+ import { Layout } from "../lib/components/Layout.js";
4
+
5
+ type LayoutMode = "default" | "landing" | "none";
6
+
7
+ const resolveLayoutComponent = (layout: LayoutMode | undefined) => {
8
+ if (layout === "landing") {
9
+ return LandingLayout;
10
+ }
11
+
12
+ return Layout;
13
+ };
14
+
15
+ const shouldWrapRoute = (
16
+ layout: LayoutMode | undefined,
17
+ layoutDisabled?: boolean,
18
+ ) => {
19
+ if (layout === "none") {
20
+ return false;
21
+ }
22
+
23
+ if (layoutDisabled) {
24
+ return layout === "default" || layout === "landing";
25
+ }
26
+
27
+ return true;
28
+ };
29
+
30
+ export const processRoutes = (
31
+ routes: RouteObject[],
32
+ layoutDisabled?: boolean,
33
+ ): RouteObject[] =>
34
+ routes.map((r) => {
35
+ const layout = r.handle?.layout as LayoutMode | undefined;
36
+ const wrapRoute = shouldWrapRoute(layout, layoutDisabled);
37
+ const LayoutComponent = wrapRoute ? resolveLayoutComponent(layout) : null;
38
+
39
+ const route = r.children
40
+ ? {
41
+ ...r,
42
+ children: LayoutComponent
43
+ ? r.children
44
+ : processRoutes(r.children, true),
45
+ }
46
+ : r;
47
+
48
+ return LayoutComponent
49
+ ? { element: <LayoutComponent />, children: [route] }
50
+ : route;
51
+ });
package/src/app/sentry.ts CHANGED
@@ -1,24 +1,24 @@
1
- import * as Sentry from "@sentry/react";
2
- import { useEffect } from "react";
3
- import {
4
- createRoutesFromChildren,
5
- matchRoutes,
6
- useLocation,
7
- useNavigationType,
8
- } from "react-router";
9
-
10
- export const initSentry = ({ dsn }: { dsn: string }) => {
11
- Sentry.init({
12
- dsn,
13
- integrations: [
14
- Sentry.reactRouterV7BrowserTracingIntegration({
15
- useEffect,
16
- useLocation,
17
- useNavigationType,
18
- createRoutesFromChildren,
19
- matchRoutes,
20
- }),
21
- Sentry.replayIntegration(),
22
- ],
23
- });
24
- };
1
+ import * as Sentry from "@sentry/react";
2
+ import { useEffect } from "react";
3
+ import {
4
+ createRoutesFromChildren,
5
+ matchRoutes,
6
+ useLocation,
7
+ useNavigationType,
8
+ } from "react-router";
9
+
10
+ export const initSentry = ({ dsn }: { dsn: string }) => {
11
+ Sentry.init({
12
+ dsn,
13
+ integrations: [
14
+ Sentry.reactRouterV7BrowserTracingIntegration({
15
+ useEffect,
16
+ useLocation,
17
+ useNavigationType,
18
+ createRoutesFromChildren,
19
+ matchRoutes,
20
+ }),
21
+ Sentry.replayIntegration(),
22
+ ],
23
+ });
24
+ };
@@ -1,23 +1,23 @@
1
- <!doctype html>
2
- <html lang="en">
3
- <head>
4
- <meta charset="UTF-8" />
5
- <link
6
- rel="icon"
7
- type="image/svg+xml"
8
- href="https://cdn.zudoku.dev/logos/favicon.svg"
9
- />
10
- <meta
11
- name="viewport"
12
- content="width=device-width, initial-scale=1.0, minimum-scale=1.0"
13
- />
14
- <title>Zudoku</title>
15
- <script type="module" crossorigin src="./main.js"></script>
16
- <link rel="stylesheet" crossorigin href="./zudoku.css" />
17
- </head>
18
- <body>
19
- <div
20
- data-api-url="https://blue-sloth-main-afc3428.d2.zuplo.dev/schemas/rewiring-america"
21
- ></div>
22
- </body>
23
- </html>
1
+ <!doctype html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8" />
5
+ <link
6
+ rel="icon"
7
+ type="image/svg+xml"
8
+ href="https://cdn.zudoku.dev/logos/favicon.svg"
9
+ />
10
+ <meta
11
+ name="viewport"
12
+ content="width=device-width, initial-scale=1.0, minimum-scale=1.0"
13
+ />
14
+ <title>Zudoku</title>
15
+ <script type="module" crossorigin src="./main.js"></script>
16
+ <link rel="stylesheet" crossorigin href="./zudoku.css" />
17
+ </head>
18
+ <body>
19
+ <div
20
+ data-api-url="https://blue-sloth-main-afc3428.d2.zuplo.dev/schemas/rewiring-america"
21
+ ></div>
22
+ </body>
23
+ </html>