@lukoweb/apitogo 0.1.23 → 0.1.37
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.
- package/README.md +92 -0
- package/cli.js +13 -13
- package/client.d.ts +8 -8
- package/dist/cli/cli.js +1117 -624
- package/dist/declarations/config/config.d.ts +4 -0
- package/dist/declarations/config/loader.d.ts +2 -0
- package/dist/declarations/config/resolve-modules.d.ts +34 -0
- package/dist/declarations/config/validators/InputNavigationSchema.d.ts +7 -7
- package/dist/declarations/config/validators/ModulesSchema.d.ts +417 -0
- package/dist/declarations/config/validators/ZudokuConfig.d.ts +123 -4
- package/dist/declarations/index.d.ts +3 -1
- package/dist/declarations/lib/authentication/components/ProductionUnlockPage.d.ts +1 -0
- package/dist/declarations/lib/authentication/hook.d.ts +3 -19
- package/dist/declarations/lib/authentication/providers/dev-portal-constants.d.ts +16 -0
- package/dist/declarations/lib/authentication/providers/dev-portal-utils.d.ts +9 -0
- package/dist/declarations/lib/authentication/providers/dev-portal.d.ts +39 -0
- package/dist/declarations/lib/authentication/state.d.ts +12 -26
- package/dist/declarations/lib/components/LandingLayout.d.ts +4 -0
- package/dist/declarations/lib/components/index.d.ts +2 -0
- package/dist/declarations/lib/plugins/api-keys/index.d.ts +2 -1
- package/dist/flat-config.d.ts +209 -24
- package/docs/components/alert.mdx +130 -0
- package/docs/components/badge.mdx +70 -0
- package/docs/components/button.mdx +132 -0
- package/docs/components/callout.mdx +112 -0
- package/docs/components/card.mdx +104 -0
- package/docs/components/checkbox.mdx +72 -0
- package/docs/components/client-only.mdx +79 -0
- package/docs/components/code-tabs.mdx +179 -0
- package/docs/components/dialog.mdx +167 -0
- package/docs/components/head.mdx +200 -0
- package/docs/components/icons.mdx +27 -0
- package/docs/components/input.mdx +96 -0
- package/docs/components/label.mdx +86 -0
- package/docs/components/link.mdx +242 -0
- package/docs/components/markdown.mdx +151 -0
- package/docs/components/mermaid.mdx +81 -0
- package/docs/components/playground.mdx +87 -0
- package/docs/components/secret.mdx +79 -0
- package/docs/components/select.mdx +176 -0
- package/docs/components/shadcn.mdx +73 -0
- package/docs/components/slider.mdx +108 -0
- package/docs/components/slot.mdx +119 -0
- package/docs/components/stepper.mdx +138 -0
- package/docs/components/switch.mdx +96 -0
- package/docs/components/syntax-highlight.mdx +602 -0
- package/docs/components/textarea.mdx +78 -0
- package/docs/components/tooltip.mdx +195 -0
- package/docs/components/typography.mdx +61 -0
- package/docs/concepts/auth-provider-api-identities.md +109 -0
- package/docs/configuration/ai-assistants.md +65 -0
- package/docs/configuration/api-catalog.md +109 -0
- package/docs/configuration/api-reference.md +397 -0
- package/docs/configuration/authentication-auth0.md +174 -0
- package/docs/configuration/authentication-azure-ad.md +238 -0
- package/docs/configuration/authentication-clerk.md +110 -0
- package/docs/configuration/authentication-firebase.md +62 -0
- package/docs/configuration/authentication-pingfederate.md +136 -0
- package/docs/configuration/authentication-supabase.md +226 -0
- package/docs/configuration/authentication.md +231 -0
- package/docs/configuration/build-configuration.mdx +147 -0
- package/docs/configuration/docs.md +282 -0
- package/docs/configuration/footer.mdx +214 -0
- package/docs/configuration/llms.md +90 -0
- package/docs/configuration/make-config.mdx +90 -0
- package/docs/configuration/navigation.mdx +422 -0
- package/docs/configuration/overview.md +380 -0
- package/docs/configuration/protected-routes.md +150 -0
- package/docs/configuration/search.md +163 -0
- package/docs/configuration/sentry.mdx +44 -0
- package/docs/configuration/site.md +124 -0
- package/docs/configuration/slots.mdx +125 -0
- package/docs/configuration/vite-config.md +18 -0
- package/docs/custom-plugins.md +285 -0
- package/docs/customization/colors-theme.mdx +276 -0
- package/docs/customization/fonts.md +110 -0
- package/docs/deploy/apache-nginx.md +41 -0
- package/docs/deploy/apitogo.md +139 -0
- package/docs/deploy/cloudflare-pages.md +75 -0
- package/docs/deploy/direct-upload.md +18 -0
- package/docs/deploy/github-pages.md +50 -0
- package/docs/deploy/vercel.md +103 -0
- package/docs/deployment.md +21 -0
- package/docs/extending/events.md +124 -0
- package/docs/guides/custom-pages.md +106 -0
- package/docs/guides/environment-variables.md +99 -0
- package/docs/guides/managing-api-keys-and-identities.md +172 -0
- package/docs/guides/mermaid.mdx +70 -0
- package/docs/guides/navigation-migration.md +87 -0
- package/docs/guides/navigation-rules.mdx +203 -0
- package/docs/guides/processors.mdx +234 -0
- package/docs/guides/static-files.md +55 -0
- package/docs/guides/transforming-examples.md +156 -0
- package/docs/guides/using-multiple-apis.md +87 -0
- package/docs/markdown/admonitions.md +128 -0
- package/docs/markdown/code-blocks.md +196 -0
- package/docs/markdown/frontmatter.md +173 -0
- package/docs/markdown/mdx.md +68 -0
- package/docs/markdown/overview.md +275 -0
- package/docs/plugins.md +5 -0
- package/docs/quickstart.md +87 -0
- package/docs/writing.mdx +72 -0
- package/package.json +170 -116
- package/src/app/ZuploBuildConfig.ts +36 -36
- package/src/app/defaultTheme.css +77 -77
- package/src/app/demo-cdn.html +37 -37
- package/src/app/demo.html +21 -21
- package/src/app/demo.tsx +77 -77
- package/src/app/entry.client.tsx +118 -118
- package/src/app/entry.server.tsx +160 -160
- package/src/app/env.ts +40 -40
- package/src/app/font.geist.css +73 -73
- package/src/app/main.css +390 -390
- package/src/app/main.tsx +8 -1
- package/src/app/polyfills.ts +47 -47
- package/src/app/processRoutes.tsx +51 -25
- package/src/app/sentry.ts +24 -24
- package/src/app/standalone.html +23 -23
- package/src/app/standalone.tsx +60 -60
- package/src/app/utils/createRedirectRoutes.ts +11 -11
- package/src/config/config.ts +32 -0
- package/src/config/create-plugin.ts +71 -71
- package/src/config/file-exists.ts +6 -6
- package/src/config/loader.ts +11 -1
- package/src/config/resolve-modules.ts +260 -0
- package/src/config/validators/BuildSchema.ts +95 -95
- package/src/config/validators/HeaderNavigationSchema.ts +41 -41
- package/src/config/validators/InputNavigationSchema.test-d.ts +178 -178
- package/src/config/validators/InputNavigationSchema.ts +206 -206
- package/src/config/validators/ModulesSchema.ts +312 -0
- package/src/config/validators/ProtectedRoutesSchema.ts +35 -35
- package/src/config/validators/ZudokuConfig.ts +766 -729
- package/src/config/validators/auth.ts +3 -3
- package/src/config/validators/reason-codes.ts +7 -7
- package/src/env.d.ts +11 -11
- package/src/index.ts +31 -0
- package/src/lib/MissingIcon.tsx +22 -22
- package/src/lib/assets/language-icons/bun.tsx +50 -50
- package/src/lib/assets/language-icons/c.tsx +31 -31
- package/src/lib/assets/language-icons/commonlisp.tsx +22 -22
- package/src/lib/assets/language-icons/cpp.tsx +35 -35
- package/src/lib/assets/language-icons/csharp.tsx +35 -35
- package/src/lib/assets/language-icons/css.tsx +36 -36
- package/src/lib/assets/language-icons/dart.tsx +39 -39
- package/src/lib/assets/language-icons/elixir.tsx +19 -19
- package/src/lib/assets/language-icons/go.tsx +19 -19
- package/src/lib/assets/language-icons/graphql.tsx +19 -19
- package/src/lib/assets/language-icons/html.tsx +24 -24
- package/src/lib/assets/language-icons/java.tsx +35 -35
- package/src/lib/assets/language-icons/javascript.tsx +11 -11
- package/src/lib/assets/language-icons/json.tsx +19 -19
- package/src/lib/assets/language-icons/kotlin.tsx +30 -30
- package/src/lib/assets/language-icons/markdown.tsx +19 -19
- package/src/lib/assets/language-icons/mdx.tsx +23 -23
- package/src/lib/assets/language-icons/npm.tsx +15 -15
- package/src/lib/assets/language-icons/objectivec.tsx +23 -23
- package/src/lib/assets/language-icons/ocaml.tsx +34 -34
- package/src/lib/assets/language-icons/php.tsx +19 -19
- package/src/lib/assets/language-icons/pnpm.tsx +32 -32
- package/src/lib/assets/language-icons/powershell.tsx +27 -27
- package/src/lib/assets/language-icons/python.tsx +23 -23
- package/src/lib/assets/language-icons/react.tsx +21 -21
- package/src/lib/assets/language-icons/ruby.tsx +19 -19
- package/src/lib/assets/language-icons/rust.tsx +19 -19
- package/src/lib/assets/language-icons/scala.tsx +19 -19
- package/src/lib/assets/language-icons/shell.tsx +19 -19
- package/src/lib/assets/language-icons/swift.tsx +19 -19
- package/src/lib/assets/language-icons/toml.tsx +23 -23
- package/src/lib/assets/language-icons/typescript.tsx +23 -23
- package/src/lib/assets/language-icons/xml.tsx +19 -19
- package/src/lib/assets/language-icons/yaml.tsx +23 -23
- package/src/lib/assets/language-icons/yarn.tsx +17 -17
- package/src/lib/assets/language-icons/zig.tsx +32 -32
- package/src/lib/auth/issuer.ts +34 -31
- package/src/lib/authentication/AuthenticationPlugin.tsx +33 -33
- package/src/lib/authentication/authentication.ts +48 -48
- package/src/lib/authentication/components/OAuthErrorPage.tsx +197 -197
- package/src/lib/authentication/components/ProductionUnlockPage.tsx +27 -0
- package/src/lib/authentication/components/SignOut.tsx +15 -15
- package/src/lib/authentication/constants.ts +1 -1
- package/src/lib/authentication/errors.ts +34 -34
- package/src/lib/authentication/hook.ts +141 -139
- package/src/lib/authentication/providers/auth0.tsx +91 -91
- package/src/lib/authentication/providers/azureb2c.tsx +223 -223
- package/src/lib/authentication/providers/dev-portal-constants.ts +21 -0
- package/src/lib/authentication/providers/dev-portal-utils.ts +107 -0
- package/src/lib/authentication/providers/dev-portal.tsx +270 -0
- package/src/lib/authentication/providers/firebase.tsx +486 -486
- package/src/lib/authentication/providers/openid.tsx +516 -516
- package/src/lib/authentication/providers/supabase.tsx +412 -412
- package/src/lib/authentication/providers/util.ts +26 -26
- package/src/lib/authentication/state.ts +179 -91
- package/src/lib/authentication/ui/icons/Apple.tsx +10 -10
- package/src/lib/authentication/ui/icons/Facebook.tsx +15 -15
- package/src/lib/authentication/ui/icons/Github.tsx +16 -16
- package/src/lib/authentication/ui/icons/Google.tsx +16 -16
- package/src/lib/authentication/ui/icons/Microsoft.tsx +12 -12
- package/src/lib/authentication/ui/icons/X.tsx +10 -10
- package/src/lib/authentication/utils/relativeRedirectUrl.ts +16 -16
- package/src/lib/components/AnchorLink.tsx +24 -24
- package/src/lib/components/Banner.tsx +52 -52
- package/src/lib/components/Bootstrap.tsx +77 -77
- package/src/lib/components/BuildCheck.tsx +87 -87
- package/src/lib/components/CategoryHeading.tsx +19 -19
- package/src/lib/components/ClientOnly.tsx +19 -19
- package/src/lib/components/ErrorPage.tsx +26 -26
- package/src/lib/components/Footer.tsx +140 -140
- package/src/lib/components/Framed.tsx +51 -51
- package/src/lib/components/Header.tsx +11 -3
- package/src/lib/components/HeaderNavigation.tsx +148 -148
- package/src/lib/components/Heading.tsx +84 -84
- package/src/lib/components/InlineCode.tsx +15 -15
- package/src/lib/components/LandingLayout.tsx +21 -0
- package/src/lib/components/LanguageIcon.tsx +199 -199
- package/src/lib/components/Markdown.tsx +55 -55
- package/src/lib/components/Meta.tsx +46 -46
- package/src/lib/components/MobileTopNavigation.tsx +11 -3
- package/src/lib/components/NotFoundPage.tsx +37 -37
- package/src/lib/components/PageProgress.tsx +28 -28
- package/src/lib/components/PagefindSearchMeta.tsx +14 -14
- package/src/lib/components/Pagination.tsx +44 -44
- package/src/lib/components/PathRenderer.tsx +61 -61
- package/src/lib/components/PluginHeads.tsx +17 -17
- package/src/lib/components/Search.tsx +70 -70
- package/src/lib/components/Slot.tsx +64 -64
- package/src/lib/components/Spinner.tsx +5 -5
- package/src/lib/components/StatusPage.tsx +96 -96
- package/src/lib/components/ThemeSwitch.tsx +49 -49
- package/src/lib/components/Typography.tsx +12 -12
- package/src/lib/components/Zudoku.tsx +106 -106
- package/src/lib/components/cache.ts +27 -27
- package/src/lib/components/context/RenderContext.ts +11 -11
- package/src/lib/components/context/RouterEventsEmitter.tsx +19 -19
- package/src/lib/components/context/SlotProvider.tsx +149 -149
- package/src/lib/components/context/ViewportAnchorContext.tsx +137 -137
- package/src/lib/components/context/ZudokuContext.ts +140 -140
- package/src/lib/components/context/ZudokuProvider.tsx +22 -22
- package/src/lib/components/context/ZudokuReactContext.tsx +17 -17
- package/src/lib/components/index.ts +2 -0
- package/src/lib/components/navigation/Navigation.tsx +51 -51
- package/src/lib/components/navigation/NavigationBadge.tsx +48 -48
- package/src/lib/components/navigation/NavigationFilterContext.tsx +28 -28
- package/src/lib/components/navigation/NavigationWrapper.tsx +49 -49
- package/src/lib/components/navigation/Toc.tsx +137 -137
- package/src/lib/components/navigation/ZudokuLogo.tsx +25 -25
- package/src/lib/components/navigation/ZuploLogo.tsx +14 -14
- package/src/lib/components/navigation/utils.ts +234 -234
- package/src/lib/core/RouteGuard.tsx +11 -1
- package/src/lib/core/ZudokuContext.ts +271 -271
- package/src/lib/core/plugins.ts +138 -138
- package/src/lib/core/react-query.ts +1 -1
- package/src/lib/core/router.ts +1 -1
- package/src/lib/core/transform-config.ts +67 -67
- package/src/lib/demo/DemoAnnouncement.tsx +17 -17
- package/src/lib/errors/ErrorAlert.tsx +28 -28
- package/src/lib/errors/RouterError.tsx +18 -18
- package/src/lib/errors/ServerError.tsx +5 -5
- package/src/lib/errors/TopLevelError.tsx +6 -6
- package/src/lib/hooks/index.ts +13 -13
- package/src/lib/hooks/useEvent.ts +41 -41
- package/src/lib/hooks/useHighlighter.ts +15 -15
- package/src/lib/hooks/useHotkey.ts +70 -70
- package/src/lib/icons.ts +2 -2
- package/src/lib/navigation/applyRules.ts +127 -127
- package/src/lib/navigation/pathMatcher.ts +81 -81
- package/src/lib/oas/graphql/circular.ts +69 -69
- package/src/lib/oas/graphql/constants.ts +2 -2
- package/src/lib/oas/graphql/index.ts +791 -791
- package/src/lib/oas/parser/dereference/index.ts +84 -84
- package/src/lib/oas/parser/dereference/resolveRef.ts +32 -32
- package/src/lib/oas/parser/index.ts +129 -129
- package/src/lib/oas/parser/schemas/v3.0.json +1489 -1489
- package/src/lib/oas/parser/schemas/v3.1.json +1298 -1298
- package/src/lib/oas/parser/upgrade/index.ts +174 -174
- package/src/lib/plugins/api-catalog/index.tsx +119 -119
- package/src/lib/plugins/api-keys/ProtectedRoute.tsx +33 -33
- package/src/lib/plugins/api-keys/index.tsx +274 -272
- package/src/lib/plugins/api-keys/settings/ApiKeyList.tsx +67 -67
- package/src/lib/plugins/custom-pages/index.tsx +32 -32
- package/src/lib/plugins/markdown/assets/ChatGPTLogo.tsx +11 -11
- package/src/lib/plugins/markdown/assets/ClaudeLogo.tsx +19 -19
- package/src/lib/plugins/markdown/index.tsx +62 -62
- package/src/lib/plugins/openapi/ColorizedParam.tsx +115 -115
- package/src/lib/plugins/openapi/Endpoint.tsx +85 -85
- package/src/lib/plugins/openapi/MCPEndpoint.tsx +273 -273
- package/src/lib/plugins/openapi/OasProvider.tsx +74 -74
- package/src/lib/plugins/openapi/OperationList.tsx +275 -275
- package/src/lib/plugins/openapi/ParamInfos.tsx +96 -96
- package/src/lib/plugins/openapi/ParameterList.tsx +53 -53
- package/src/lib/plugins/openapi/ParameterListItem.tsx +161 -161
- package/src/lib/plugins/openapi/PlaygroundDialogWrapper.tsx +67 -67
- package/src/lib/plugins/openapi/SidecarBox.tsx +57 -57
- package/src/lib/plugins/openapi/SimpleSelect.tsx +46 -46
- package/src/lib/plugins/openapi/client/GraphQLClient.tsx +73 -73
- package/src/lib/plugins/openapi/client/GraphQLContext.tsx +16 -16
- package/src/lib/plugins/openapi/client/createServer.ts +35 -35
- package/src/lib/plugins/openapi/client/useCreateQuery.ts +44 -44
- package/src/lib/plugins/openapi/components/ConstValue.tsx +24 -24
- package/src/lib/plugins/openapi/components/NonHighlightedCode.tsx +22 -22
- package/src/lib/plugins/openapi/components/SelectOnClick.tsx +29 -29
- package/src/lib/plugins/openapi/context.tsx +16 -16
- package/src/lib/plugins/openapi/graphql/fragment-masking.ts +104 -104
- package/src/lib/plugins/openapi/graphql/gql.ts +95 -95
- package/src/lib/plugins/openapi/graphql/graphql.ts +835 -835
- package/src/lib/plugins/openapi/graphql/index.ts +2 -2
- package/src/lib/plugins/openapi/index.tsx +221 -221
- package/src/lib/plugins/openapi/interfaces.ts +100 -100
- package/src/lib/plugins/openapi/playground/Headers.tsx +6 -6
- package/src/lib/plugins/openapi/playground/PathParams.tsx +53 -53
- package/src/lib/plugins/openapi/playground/Spinner.tsx +87 -87
- package/src/lib/plugins/openapi/playground/createUrl.ts +25 -25
- package/src/lib/plugins/openapi/playground/fileUtils.ts +36 -36
- package/src/lib/plugins/openapi/playground/rememberedIdentity.ts +26 -26
- package/src/lib/plugins/openapi/playground/request-panel/UrlPath.tsx +31 -31
- package/src/lib/plugins/openapi/playground/request-panel/UrlQueryParams.tsx +29 -29
- package/src/lib/plugins/openapi/playground/request-panel/useKeyValueFieldManager.ts +340 -340
- package/src/lib/plugins/openapi/playground/result-panel/ResponseStatusBar.tsx +117 -117
- package/src/lib/plugins/openapi/playground/result-panel/convertToTypes.ts +36 -36
- package/src/lib/plugins/openapi/playground/serializeQueryParams.ts +125 -125
- package/src/lib/plugins/openapi/playground/useRememberSkipLoginDialog.tsx +23 -23
- package/src/lib/plugins/openapi/processors/removeExtensions.ts +29 -29
- package/src/lib/plugins/openapi/processors/removeParameters.ts +103 -103
- package/src/lib/plugins/openapi/processors/removePaths.ts +57 -57
- package/src/lib/plugins/openapi/processors/traverse.ts +1 -1
- package/src/lib/plugins/openapi/schema/SchemaExampleAndDefault.tsx +39 -39
- package/src/lib/plugins/openapi/schema/UnionView.tsx +132 -132
- package/src/lib/plugins/openapi/schema/union-helpers.ts +123 -123
- package/src/lib/plugins/openapi/schema/utils.ts +49 -49
- package/src/lib/plugins/openapi/state.ts +36 -36
- package/src/lib/plugins/openapi/util/buildTagCategories.ts +54 -54
- package/src/lib/plugins/openapi/util/createHttpSnippet.ts +135 -135
- package/src/lib/plugins/openapi/util/createNavigationCategory.tsx +39 -39
- package/src/lib/plugins/openapi/util/generateSchemaExample.ts +191 -191
- package/src/lib/plugins/openapi/util/getRoutes.tsx +265 -265
- package/src/lib/plugins/openapi/util/methodColorMap.tsx +11 -11
- package/src/lib/plugins/openapi/util/methodToColor.ts +27 -27
- package/src/lib/plugins/openapi/util/sanitizeMarkdownForMetatag.tsx +32 -32
- package/src/lib/plugins/openapi/util/useWarmupSchema.ts +23 -23
- package/src/lib/plugins/search-inkeep/index.tsx +108 -108
- package/src/lib/plugins/search-inkeep/inkeep.ts +24 -24
- package/src/lib/plugins/search-pagefind/get-results.tsx +74 -74
- package/src/lib/plugins/search-pagefind/index.tsx +21 -21
- package/src/lib/plugins/search-pagefind/types.ts +118 -118
- package/src/lib/shiki-constants.ts +24 -24
- package/src/lib/testing/index.tsx +146 -146
- package/src/lib/ui/Accordion.tsx +55 -55
- package/src/lib/ui/Alert.tsx +84 -84
- package/src/lib/ui/AlertDialog.tsx +195 -195
- package/src/lib/ui/AspectRatio.tsx +5 -5
- package/src/lib/ui/Badge.tsx +48 -48
- package/src/lib/ui/Breadcrumb.tsx +115 -115
- package/src/lib/ui/Button.tsx +65 -65
- package/src/lib/ui/ButtonGroup.tsx +80 -80
- package/src/lib/ui/Callout.tsx +113 -113
- package/src/lib/ui/Card.tsx +95 -95
- package/src/lib/ui/Carousel.tsx +259 -259
- package/src/lib/ui/Checkbox.tsx +28 -28
- package/src/lib/ui/CodeBlock.tsx +92 -92
- package/src/lib/ui/CodeTabPanel.tsx +13 -13
- package/src/lib/ui/CodeTabs.tsx +161 -161
- package/src/lib/ui/Collapsible.tsx +31 -31
- package/src/lib/ui/Dialog.tsx +138 -138
- package/src/lib/ui/DismissibleAlert.tsx +74 -74
- package/src/lib/ui/Drawer.tsx +121 -121
- package/src/lib/ui/DropdownMenu.tsx +254 -254
- package/src/lib/ui/EmbeddedCodeBlock.tsx +99 -99
- package/src/lib/ui/Form.tsx +176 -176
- package/src/lib/ui/Frame.tsx +81 -81
- package/src/lib/ui/HoverCard.tsx +26 -26
- package/src/lib/ui/Input.tsx +23 -23
- package/src/lib/ui/InputGroup.tsx +168 -168
- package/src/lib/ui/Item.tsx +213 -213
- package/src/lib/ui/Kbd.tsx +28 -28
- package/src/lib/ui/Label.tsx +23 -23
- package/src/lib/ui/NativeSelect.tsx +48 -48
- package/src/lib/ui/NavigationMenu.tsx +169 -169
- package/src/lib/ui/Pagination.tsx +115 -115
- package/src/lib/ui/Popover.tsx +28 -28
- package/src/lib/ui/Progress.tsx +25 -25
- package/src/lib/ui/RadioGroup.tsx +41 -41
- package/src/lib/ui/ReactComponentDoc.tsx +68 -68
- package/src/lib/ui/ScrollArea.tsx +45 -45
- package/src/lib/ui/Secret.tsx +133 -133
- package/src/lib/ui/Select.tsx +184 -184
- package/src/lib/ui/Separator.tsx +25 -25
- package/src/lib/ui/Skeleton.tsx +15 -15
- package/src/lib/ui/Slider.tsx +25 -25
- package/src/lib/ui/Stepper.tsx +8 -8
- package/src/lib/ui/Switch.tsx +26 -26
- package/src/lib/ui/SyntaxHighlight.tsx +54 -54
- package/src/lib/ui/Tabs.tsx +52 -52
- package/src/lib/ui/Textarea.tsx +22 -22
- package/src/lib/ui/Toggle.tsx +42 -42
- package/src/lib/ui/ToggleGroup.tsx +58 -58
- package/src/lib/ui/Tooltip.tsx +65 -65
- package/src/lib/ui/Value.tsx +42 -42
- package/src/lib/ui/util.tsx +8 -8
- package/src/lib/util/cn.ts +6 -6
- package/src/lib/util/createVariantComponent.tsx +61 -61
- package/src/lib/util/ensureArray.ts +3 -3
- package/src/lib/util/flattenAllOf.ts +72 -72
- package/src/lib/util/flattenAllOfProcessor.ts +74 -74
- package/src/lib/util/hastToJsx.tsx +67 -67
- package/src/lib/util/humanFileSize.ts +15 -15
- package/src/lib/util/invariant.ts +52 -52
- package/src/lib/util/joinUrl.ts +60 -60
- package/src/lib/util/logInit.ts +9 -9
- package/src/lib/util/objectEntries.ts +5 -5
- package/src/lib/util/os.ts +18 -18
- package/src/lib/util/pastellize.ts +25 -25
- package/src/lib/util/problemJson.ts +63 -63
- package/src/lib/util/readFrontmatter.ts +14 -14
- package/src/lib/util/renderIf.ts +4 -4
- package/src/lib/util/scrollIntoViewIfNeeded.ts +18 -18
- package/src/lib/util/slugify.ts +21 -21
- package/src/lib/util/syncZustandState.ts +22 -22
- package/src/lib/util/traverse.ts +70 -70
- package/src/lib/util/types.ts +7 -7
- package/src/lib/util/url.ts +18 -18
- package/src/lib/util/useCopyToClipboard.ts +17 -17
- package/src/lib/util/useExposedProps.tsx +27 -27
- package/src/lib/util/useIsomorphicLayoutEffect.ts +6 -6
- package/src/lib/util/useLatest.ts +18 -18
- package/src/lib/util/useOnScreen.ts +34 -34
- package/src/lib/util/useScrollToAnchor.ts +70 -70
- package/src/lib/util/useScrollToTop.ts +18 -18
- package/src/types.d.ts +57 -53
- package/src/vite/api/SchemaManager.ts +371 -371
- package/src/vite/api/schema-codegen.ts +163 -163
- package/src/vite/config.ts +5 -1
- package/src/vite/css/collect.ts +42 -42
- package/src/vite/css/plugin.ts +105 -105
- package/src/vite/debug.ts +18 -18
- package/src/vite/dev-portal-env.ts +93 -0
- package/src/vite/html.ts +54 -54
- package/src/vite/index.ts +2 -2
- package/src/vite/mdx/rehype-extract-toc-with-jsx-export.ts +19 -19
- package/src/vite/mdx/rehype-extract-toc-with-jsx.ts +70 -70
- package/src/vite/mdx/remark-code-tabs.ts +47 -47
- package/src/vite/mdx/remark-inject-filepath.ts +13 -13
- package/src/vite/mdx/remark-last-modified.ts +103 -103
- package/src/vite/mdx/remark-link-rewrite.ts +23 -23
- package/src/vite/mdx/remark-normalize-image-url.ts +15 -15
- package/src/vite/mdx/remark-static-generation.ts +149 -149
- package/src/vite/mdx/utils.ts +32 -32
- package/src/vite/output.ts +261 -261
- package/src/vite/package-root.ts +12 -12
- package/src/vite/pagefind-dev-index.ts +100 -100
- package/src/vite/plugin-api-keys.ts +6 -1
- package/src/vite/plugin-api.ts +4 -1
- package/src/vite/plugin-auth.ts +5 -1
- package/src/vite/plugin-component.ts +1 -1
- package/src/vite/plugin-config-reload.ts +49 -49
- package/src/vite/plugin-doc-metadata.ts +45 -45
- package/src/vite/plugin-docs.ts +4 -1
- package/src/vite/plugin-metadata.ts +30 -30
- package/src/vite/plugin-modules.ts +144 -0
- package/src/vite/plugin-shiki-register.ts +97 -97
- package/src/vite/plugin-theme.ts +399 -399
- package/src/vite/plugin.ts +2 -0
- package/src/vite/prerender/utils.ts +76 -76
- package/src/vite/prerender/worker.ts +118 -118
- package/src/vite/reporter.ts +34 -34
- package/src/vite/shadcn-registry.ts +48 -48
- package/src/vite/sitemap.ts +78 -78
- package/src/vite/ssr-templates/cloudflare.ts +19 -19
- package/src/vite/ssr-templates/node.ts +25 -25
- package/src/vite/ssr-templates/vercel.ts +22 -22
- package/src/vite/zuplo.ts +30 -30
- package/src/vite-env.d.ts +6 -6
- package/src/zuplo/enrich-with-zuplo-mcp.ts +168 -168
- package/src/zuplo/enrich-with-zuplo.ts +256 -256
- package/src/zuplo/policy-types.ts +46 -46
- package/src/zuplo/with-zuplo-processors.ts +36 -36
- package/src/zuplo/with-zuplo.ts +14 -14
- package/LICENSE.md +0 -18
- package/dist/declarations/lib/components/navigation/ZudokuLogo.d.ts +0 -6
package/src/vite/debug.ts
CHANGED
|
@@ -1,18 +1,18 @@
|
|
|
1
|
-
import { mkdir, writeFile } from "node:fs/promises";
|
|
2
|
-
import path from "node:path";
|
|
3
|
-
|
|
4
|
-
export async function writePluginDebugCode(
|
|
5
|
-
rootDir: string,
|
|
6
|
-
pluginName: string,
|
|
7
|
-
code: string | string[],
|
|
8
|
-
extension: string = "js",
|
|
9
|
-
) {
|
|
10
|
-
if (process.env.ZUDOKU_BUILD_DEBUG) {
|
|
11
|
-
const debugDir = path.join(rootDir, "dist", "debug");
|
|
12
|
-
await mkdir(debugDir, { recursive: true });
|
|
13
|
-
await writeFile(
|
|
14
|
-
path.join(debugDir, `${pluginName}.${extension}`),
|
|
15
|
-
typeof code === "string" ? code : code.join("\n"),
|
|
16
|
-
);
|
|
17
|
-
}
|
|
18
|
-
}
|
|
1
|
+
import { mkdir, writeFile } from "node:fs/promises";
|
|
2
|
+
import path from "node:path";
|
|
3
|
+
|
|
4
|
+
export async function writePluginDebugCode(
|
|
5
|
+
rootDir: string,
|
|
6
|
+
pluginName: string,
|
|
7
|
+
code: string | string[],
|
|
8
|
+
extension: string = "js",
|
|
9
|
+
) {
|
|
10
|
+
if (process.env.ZUDOKU_BUILD_DEBUG) {
|
|
11
|
+
const debugDir = path.join(rootDir, "dist", "debug");
|
|
12
|
+
await mkdir(debugDir, { recursive: true });
|
|
13
|
+
await writeFile(
|
|
14
|
+
path.join(debugDir, `${pluginName}.${extension}`),
|
|
15
|
+
typeof code === "string" ? code : code.join("\n"),
|
|
16
|
+
);
|
|
17
|
+
}
|
|
18
|
+
}
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
import { readFile } from "node:fs/promises";
|
|
2
|
+
import path from "node:path";
|
|
3
|
+
import { loadEnv } from "vite";
|
|
4
|
+
|
|
5
|
+
export const DEV_PORTAL_MANIFEST_FILENAME = "apitogo.local.json";
|
|
6
|
+
|
|
7
|
+
export const DEV_PORTAL_VITE_ENV_KEYS = [
|
|
8
|
+
"VITE_APITOGO_DEV_PORTAL_API_URL",
|
|
9
|
+
"VITE_APITOGO_DEV_PORTAL_MOCK_PLANS",
|
|
10
|
+
] as const;
|
|
11
|
+
|
|
12
|
+
interface ManifestPlanInput {
|
|
13
|
+
sku: string;
|
|
14
|
+
displayName: string;
|
|
15
|
+
isFree: boolean;
|
|
16
|
+
priceAmount?: number;
|
|
17
|
+
priceCurrency?: string;
|
|
18
|
+
billingPeriod?: string;
|
|
19
|
+
limitsJson?: string;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
interface DevPortalLocalManifest {
|
|
23
|
+
plans?: ManifestPlanInput[];
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
function normalizeBillingPeriod(period?: string): string {
|
|
27
|
+
if (!period) {
|
|
28
|
+
return "monthly";
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
const normalized = period.toLowerCase();
|
|
32
|
+
if (normalized === "month") {
|
|
33
|
+
return "monthly";
|
|
34
|
+
}
|
|
35
|
+
if (normalized === "year") {
|
|
36
|
+
return "annual";
|
|
37
|
+
}
|
|
38
|
+
return normalized;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
export function plansToMockEnvValue(
|
|
42
|
+
plans: ManifestPlanInput[] | undefined,
|
|
43
|
+
): string | null {
|
|
44
|
+
if (!plans?.length) {
|
|
45
|
+
return null;
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
const mockPlans = plans.map((plan) => ({
|
|
49
|
+
sku: plan.sku,
|
|
50
|
+
displayName: plan.displayName,
|
|
51
|
+
isFree: plan.isFree,
|
|
52
|
+
priceAmount: plan.priceAmount ?? 0,
|
|
53
|
+
priceCurrency: plan.priceCurrency ?? "usd",
|
|
54
|
+
billingPeriod: normalizeBillingPeriod(plan.billingPeriod),
|
|
55
|
+
limitsJson: plan.limitsJson ?? null,
|
|
56
|
+
}));
|
|
57
|
+
|
|
58
|
+
return JSON.stringify(mockPlans);
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
export async function readDevPortalManifest(
|
|
62
|
+
rootDir: string,
|
|
63
|
+
): Promise<DevPortalLocalManifest | null> {
|
|
64
|
+
const manifestPath = path.join(rootDir, DEV_PORTAL_MANIFEST_FILENAME);
|
|
65
|
+
|
|
66
|
+
try {
|
|
67
|
+
const raw = await readFile(manifestPath, "utf8");
|
|
68
|
+
return JSON.parse(raw) as DevPortalLocalManifest;
|
|
69
|
+
} catch {
|
|
70
|
+
return null;
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
export async function loadDevPortalViteDefines(
|
|
75
|
+
rootDir: string,
|
|
76
|
+
mode: string,
|
|
77
|
+
): Promise<Record<string, string>> {
|
|
78
|
+
const env = loadEnv(mode, rootDir, "VITE_");
|
|
79
|
+
const defines: Record<string, string> = {};
|
|
80
|
+
|
|
81
|
+
const apiUrl = env.VITE_APITOGO_DEV_PORTAL_API_URL?.trim();
|
|
82
|
+
if (apiUrl) {
|
|
83
|
+
defines.VITE_APITOGO_DEV_PORTAL_API_URL = JSON.stringify(apiUrl);
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
const manifest = await readDevPortalManifest(rootDir);
|
|
87
|
+
const mockPlansValue = plansToMockEnvValue(manifest?.plans);
|
|
88
|
+
if (mockPlansValue) {
|
|
89
|
+
defines.VITE_APITOGO_DEV_PORTAL_MOCK_PLANS = JSON.stringify(mockPlansValue);
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
return defines;
|
|
93
|
+
}
|
package/src/vite/html.ts
CHANGED
|
@@ -1,54 +1,54 @@
|
|
|
1
|
-
export function getDevHtml({
|
|
2
|
-
jsEntry,
|
|
3
|
-
dir,
|
|
4
|
-
}: {
|
|
5
|
-
jsEntry: string;
|
|
6
|
-
dir?: "ltr" | "rtl";
|
|
7
|
-
}) {
|
|
8
|
-
return `
|
|
9
|
-
<!doctype html>
|
|
10
|
-
<html lang="en" ${dir ? `dir="${dir}"` : ""}>
|
|
11
|
-
<head>
|
|
12
|
-
<meta charset="UTF-8" />
|
|
13
|
-
<meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0">
|
|
14
|
-
<!--app-helmet-->
|
|
15
|
-
<link rel="preconnect" href="https://cdn.zudoku.dev/">
|
|
16
|
-
</head>
|
|
17
|
-
<body>
|
|
18
|
-
<div id="root"><!--app-html--></div>
|
|
19
|
-
<script type="module" src="${jsEntry}"></script>
|
|
20
|
-
</body>
|
|
21
|
-
</html>
|
|
22
|
-
`.trim();
|
|
23
|
-
}
|
|
24
|
-
|
|
25
|
-
export function getBuildHtml({
|
|
26
|
-
jsEntry,
|
|
27
|
-
cssEntries,
|
|
28
|
-
dir,
|
|
29
|
-
}: {
|
|
30
|
-
jsEntry: string;
|
|
31
|
-
cssEntries: string[];
|
|
32
|
-
dir?: "ltr" | "rtl";
|
|
33
|
-
}) {
|
|
34
|
-
const cssLinks = cssEntries
|
|
35
|
-
.map((css) => ` <link rel="stylesheet" crossorigin href="${css}">`)
|
|
36
|
-
.join("\n");
|
|
37
|
-
|
|
38
|
-
return `
|
|
39
|
-
<!doctype html>
|
|
40
|
-
<html lang="en" ${dir ? `dir="${dir}"` : ""}>
|
|
41
|
-
<head>
|
|
42
|
-
<meta charset="UTF-8" />
|
|
43
|
-
<meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0">
|
|
44
|
-
<script type="module" crossorigin src="${jsEntry}"></script>
|
|
45
|
-
${cssLinks}
|
|
46
|
-
<!--app-helmet-->
|
|
47
|
-
<link rel="preconnect" href="https://cdn.zudoku.dev/">
|
|
48
|
-
</head>
|
|
49
|
-
<body>
|
|
50
|
-
<div id="root"><!--app-html--></div>
|
|
51
|
-
</body>
|
|
52
|
-
</html>
|
|
53
|
-
`.trim();
|
|
54
|
-
}
|
|
1
|
+
export function getDevHtml({
|
|
2
|
+
jsEntry,
|
|
3
|
+
dir,
|
|
4
|
+
}: {
|
|
5
|
+
jsEntry: string;
|
|
6
|
+
dir?: "ltr" | "rtl";
|
|
7
|
+
}) {
|
|
8
|
+
return `
|
|
9
|
+
<!doctype html>
|
|
10
|
+
<html lang="en" ${dir ? `dir="${dir}"` : ""}>
|
|
11
|
+
<head>
|
|
12
|
+
<meta charset="UTF-8" />
|
|
13
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0">
|
|
14
|
+
<!--app-helmet-->
|
|
15
|
+
<link rel="preconnect" href="https://cdn.zudoku.dev/">
|
|
16
|
+
</head>
|
|
17
|
+
<body>
|
|
18
|
+
<div id="root"><!--app-html--></div>
|
|
19
|
+
<script type="module" src="${jsEntry}"></script>
|
|
20
|
+
</body>
|
|
21
|
+
</html>
|
|
22
|
+
`.trim();
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
export function getBuildHtml({
|
|
26
|
+
jsEntry,
|
|
27
|
+
cssEntries,
|
|
28
|
+
dir,
|
|
29
|
+
}: {
|
|
30
|
+
jsEntry: string;
|
|
31
|
+
cssEntries: string[];
|
|
32
|
+
dir?: "ltr" | "rtl";
|
|
33
|
+
}) {
|
|
34
|
+
const cssLinks = cssEntries
|
|
35
|
+
.map((css) => ` <link rel="stylesheet" crossorigin href="${css}">`)
|
|
36
|
+
.join("\n");
|
|
37
|
+
|
|
38
|
+
return `
|
|
39
|
+
<!doctype html>
|
|
40
|
+
<html lang="en" ${dir ? `dir="${dir}"` : ""}>
|
|
41
|
+
<head>
|
|
42
|
+
<meta charset="UTF-8" />
|
|
43
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0">
|
|
44
|
+
<script type="module" crossorigin src="${jsEntry}"></script>
|
|
45
|
+
${cssLinks}
|
|
46
|
+
<!--app-helmet-->
|
|
47
|
+
<link rel="preconnect" href="https://cdn.zudoku.dev/">
|
|
48
|
+
</head>
|
|
49
|
+
<body>
|
|
50
|
+
<div id="root"><!--app-html--></div>
|
|
51
|
+
</body>
|
|
52
|
+
</html>
|
|
53
|
+
`.trim();
|
|
54
|
+
}
|
package/src/vite/index.ts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export type { ConfigEnv, Plugin, PluginOption, UserConfig } from "vite";
|
|
2
|
-
export { defineConfig, mergeConfig } from "vite";
|
|
1
|
+
export type { ConfigEnv, Plugin, PluginOption, UserConfig } from "vite";
|
|
2
|
+
export { defineConfig, mergeConfig } from "vite";
|
|
@@ -1,19 +1,19 @@
|
|
|
1
|
-
import { name as isIdentifierName } from "estree-util-is-identifier-name";
|
|
2
|
-
import type { Root } from "hast";
|
|
3
|
-
import type { Plugin } from "unified";
|
|
4
|
-
import { exportMdxjsConst } from "./utils.js";
|
|
5
|
-
|
|
6
|
-
const rehypeExtractTocWithJsxExport: Plugin<[{ name?: string }?], Root> = ({
|
|
7
|
-
name = "tableOfContents",
|
|
8
|
-
} = {}) => {
|
|
9
|
-
if (!isIdentifierName(name)) {
|
|
10
|
-
throw new Error(`Invalid identifier name: ${JSON.stringify(name)}`);
|
|
11
|
-
}
|
|
12
|
-
|
|
13
|
-
return (tree, vfile) => {
|
|
14
|
-
if (vfile.data.toc == null) return;
|
|
15
|
-
tree.children.unshift(exportMdxjsConst(name, vfile.data.toc));
|
|
16
|
-
};
|
|
17
|
-
};
|
|
18
|
-
|
|
19
|
-
export default rehypeExtractTocWithJsxExport;
|
|
1
|
+
import { name as isIdentifierName } from "estree-util-is-identifier-name";
|
|
2
|
+
import type { Root } from "hast";
|
|
3
|
+
import type { Plugin } from "unified";
|
|
4
|
+
import { exportMdxjsConst } from "./utils.js";
|
|
5
|
+
|
|
6
|
+
const rehypeExtractTocWithJsxExport: Plugin<[{ name?: string }?], Root> = ({
|
|
7
|
+
name = "tableOfContents",
|
|
8
|
+
} = {}) => {
|
|
9
|
+
if (!isIdentifierName(name)) {
|
|
10
|
+
throw new Error(`Invalid identifier name: ${JSON.stringify(name)}`);
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
return (tree, vfile) => {
|
|
14
|
+
if (vfile.data.toc == null) return;
|
|
15
|
+
tree.children.unshift(exportMdxjsConst(name, vfile.data.toc));
|
|
16
|
+
};
|
|
17
|
+
};
|
|
18
|
+
|
|
19
|
+
export default rehypeExtractTocWithJsxExport;
|
|
@@ -1,70 +1,70 @@
|
|
|
1
|
-
import type { Element, RootContent } from "hast";
|
|
2
|
-
import { headingRank } from "hast-util-heading-rank";
|
|
3
|
-
import { toString as hastToString } from "hast-util-to-string";
|
|
4
|
-
import type { Plugin } from "unified";
|
|
5
|
-
import { visit } from "unist-util-visit";
|
|
6
|
-
|
|
7
|
-
export type TocEntry = {
|
|
8
|
-
depth: number;
|
|
9
|
-
text: string;
|
|
10
|
-
id?: string;
|
|
11
|
-
children?: TocEntry[];
|
|
12
|
-
/** Rich AST nodes for rendering (includes JSX components) */
|
|
13
|
-
rich?: RootContent[];
|
|
14
|
-
};
|
|
15
|
-
|
|
16
|
-
export type Toc = TocEntry[];
|
|
17
|
-
|
|
18
|
-
declare module "vfile" {
|
|
19
|
-
interface DataMap {
|
|
20
|
-
toc: Toc;
|
|
21
|
-
}
|
|
22
|
-
}
|
|
23
|
-
|
|
24
|
-
const rehypeExtractTocWithJsx: Plugin<[]> = () => (tree, vfile) => {
|
|
25
|
-
const headings: TocEntry[] = [];
|
|
26
|
-
|
|
27
|
-
visit(tree, "element", (node: Element) => {
|
|
28
|
-
const level = headingRank(node);
|
|
29
|
-
|
|
30
|
-
if (!level) return;
|
|
31
|
-
|
|
32
|
-
const richChildren = node.children as RootContent[];
|
|
33
|
-
const hasRichContent = richChildren.some((child) => child.type !== "text");
|
|
34
|
-
|
|
35
|
-
const heading: TocEntry = {
|
|
36
|
-
depth: level,
|
|
37
|
-
text: hastToString(node),
|
|
38
|
-
...(hasRichContent ? { rich: richChildren } : {}),
|
|
39
|
-
};
|
|
40
|
-
|
|
41
|
-
if (node.properties?.id) {
|
|
42
|
-
heading.id = String(node.properties.id);
|
|
43
|
-
}
|
|
44
|
-
|
|
45
|
-
headings.push(heading);
|
|
46
|
-
});
|
|
47
|
-
|
|
48
|
-
vfile.data.toc = createTree(headings);
|
|
49
|
-
};
|
|
50
|
-
|
|
51
|
-
const createTree = (headings: TocEntry[]): Toc => {
|
|
52
|
-
const root: TocEntry = { depth: 0, text: "", children: [] };
|
|
53
|
-
const stack: TocEntry[] = [root];
|
|
54
|
-
|
|
55
|
-
for (const heading of headings) {
|
|
56
|
-
// biome-ignore lint/style/noNonNullAssertion: We check the length of the stack before
|
|
57
|
-
while (stack.length > 1 && stack.at(-1)!.depth >= heading.depth) {
|
|
58
|
-
stack.pop();
|
|
59
|
-
}
|
|
60
|
-
|
|
61
|
-
const parent = stack.at(-1) ?? root;
|
|
62
|
-
parent.children ??= [];
|
|
63
|
-
parent.children.push(heading);
|
|
64
|
-
stack.push(heading);
|
|
65
|
-
}
|
|
66
|
-
|
|
67
|
-
return root.children ?? [];
|
|
68
|
-
};
|
|
69
|
-
|
|
70
|
-
export default rehypeExtractTocWithJsx;
|
|
1
|
+
import type { Element, RootContent } from "hast";
|
|
2
|
+
import { headingRank } from "hast-util-heading-rank";
|
|
3
|
+
import { toString as hastToString } from "hast-util-to-string";
|
|
4
|
+
import type { Plugin } from "unified";
|
|
5
|
+
import { visit } from "unist-util-visit";
|
|
6
|
+
|
|
7
|
+
export type TocEntry = {
|
|
8
|
+
depth: number;
|
|
9
|
+
text: string;
|
|
10
|
+
id?: string;
|
|
11
|
+
children?: TocEntry[];
|
|
12
|
+
/** Rich AST nodes for rendering (includes JSX components) */
|
|
13
|
+
rich?: RootContent[];
|
|
14
|
+
};
|
|
15
|
+
|
|
16
|
+
export type Toc = TocEntry[];
|
|
17
|
+
|
|
18
|
+
declare module "vfile" {
|
|
19
|
+
interface DataMap {
|
|
20
|
+
toc: Toc;
|
|
21
|
+
}
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
const rehypeExtractTocWithJsx: Plugin<[]> = () => (tree, vfile) => {
|
|
25
|
+
const headings: TocEntry[] = [];
|
|
26
|
+
|
|
27
|
+
visit(tree, "element", (node: Element) => {
|
|
28
|
+
const level = headingRank(node);
|
|
29
|
+
|
|
30
|
+
if (!level) return;
|
|
31
|
+
|
|
32
|
+
const richChildren = node.children as RootContent[];
|
|
33
|
+
const hasRichContent = richChildren.some((child) => child.type !== "text");
|
|
34
|
+
|
|
35
|
+
const heading: TocEntry = {
|
|
36
|
+
depth: level,
|
|
37
|
+
text: hastToString(node),
|
|
38
|
+
...(hasRichContent ? { rich: richChildren } : {}),
|
|
39
|
+
};
|
|
40
|
+
|
|
41
|
+
if (node.properties?.id) {
|
|
42
|
+
heading.id = String(node.properties.id);
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
headings.push(heading);
|
|
46
|
+
});
|
|
47
|
+
|
|
48
|
+
vfile.data.toc = createTree(headings);
|
|
49
|
+
};
|
|
50
|
+
|
|
51
|
+
const createTree = (headings: TocEntry[]): Toc => {
|
|
52
|
+
const root: TocEntry = { depth: 0, text: "", children: [] };
|
|
53
|
+
const stack: TocEntry[] = [root];
|
|
54
|
+
|
|
55
|
+
for (const heading of headings) {
|
|
56
|
+
// biome-ignore lint/style/noNonNullAssertion: We check the length of the stack before
|
|
57
|
+
while (stack.length > 1 && stack.at(-1)!.depth >= heading.depth) {
|
|
58
|
+
stack.pop();
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
const parent = stack.at(-1) ?? root;
|
|
62
|
+
parent.children ??= [];
|
|
63
|
+
parent.children.push(heading);
|
|
64
|
+
stack.push(heading);
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
return root.children ?? [];
|
|
68
|
+
};
|
|
69
|
+
|
|
70
|
+
export default rehypeExtractTocWithJsx;
|
|
@@ -1,47 +1,47 @@
|
|
|
1
|
-
import type { Root } from "mdast";
|
|
2
|
-
import type { MdxJsxAttribute, MdxJsxFlowElement } from "mdast-util-mdx";
|
|
3
|
-
import { visit } from "unist-util-visit";
|
|
4
|
-
|
|
5
|
-
const attr = (
|
|
6
|
-
name: string,
|
|
7
|
-
value: string | null | undefined,
|
|
8
|
-
): MdxJsxAttribute | undefined =>
|
|
9
|
-
value != null ? { type: "mdxJsxAttribute", name, value } : undefined;
|
|
10
|
-
|
|
11
|
-
export const remarkCodeTabs = () => (tree: Root) => {
|
|
12
|
-
visit(tree, "mdxJsxFlowElement", (node: MdxJsxFlowElement) => {
|
|
13
|
-
if (node.name !== "CodeTabs") return;
|
|
14
|
-
|
|
15
|
-
const newChildren: MdxJsxFlowElement["children"] = [];
|
|
16
|
-
for (const child of node.children) {
|
|
17
|
-
if (child.type === "code") {
|
|
18
|
-
const attributes = [
|
|
19
|
-
attr("language", child.lang),
|
|
20
|
-
attr("meta", child.meta),
|
|
21
|
-
attr("code", child.value),
|
|
22
|
-
].filter((a) => a !== undefined);
|
|
23
|
-
|
|
24
|
-
newChildren.push({
|
|
25
|
-
type: "mdxJsxFlowElement",
|
|
26
|
-
name: "CodeTabPanel",
|
|
27
|
-
attributes,
|
|
28
|
-
children: [],
|
|
29
|
-
data: { _mdxExplicitJsx: true },
|
|
30
|
-
} as MdxJsxFlowElement);
|
|
31
|
-
continue;
|
|
32
|
-
}
|
|
33
|
-
|
|
34
|
-
// Skip whitespace-only paragraph nodes between code blocks
|
|
35
|
-
if (
|
|
36
|
-
child.type === "paragraph" &&
|
|
37
|
-
child.children.every((c) => c.type === "text" && !c.value.trim())
|
|
38
|
-
) {
|
|
39
|
-
continue;
|
|
40
|
-
}
|
|
41
|
-
|
|
42
|
-
newChildren.push(child);
|
|
43
|
-
}
|
|
44
|
-
|
|
45
|
-
node.children = newChildren;
|
|
46
|
-
});
|
|
47
|
-
};
|
|
1
|
+
import type { Root } from "mdast";
|
|
2
|
+
import type { MdxJsxAttribute, MdxJsxFlowElement } from "mdast-util-mdx";
|
|
3
|
+
import { visit } from "unist-util-visit";
|
|
4
|
+
|
|
5
|
+
const attr = (
|
|
6
|
+
name: string,
|
|
7
|
+
value: string | null | undefined,
|
|
8
|
+
): MdxJsxAttribute | undefined =>
|
|
9
|
+
value != null ? { type: "mdxJsxAttribute", name, value } : undefined;
|
|
10
|
+
|
|
11
|
+
export const remarkCodeTabs = () => (tree: Root) => {
|
|
12
|
+
visit(tree, "mdxJsxFlowElement", (node: MdxJsxFlowElement) => {
|
|
13
|
+
if (node.name !== "CodeTabs") return;
|
|
14
|
+
|
|
15
|
+
const newChildren: MdxJsxFlowElement["children"] = [];
|
|
16
|
+
for (const child of node.children) {
|
|
17
|
+
if (child.type === "code") {
|
|
18
|
+
const attributes = [
|
|
19
|
+
attr("language", child.lang),
|
|
20
|
+
attr("meta", child.meta),
|
|
21
|
+
attr("code", child.value),
|
|
22
|
+
].filter((a) => a !== undefined);
|
|
23
|
+
|
|
24
|
+
newChildren.push({
|
|
25
|
+
type: "mdxJsxFlowElement",
|
|
26
|
+
name: "CodeTabPanel",
|
|
27
|
+
attributes,
|
|
28
|
+
children: [],
|
|
29
|
+
data: { _mdxExplicitJsx: true },
|
|
30
|
+
} as MdxJsxFlowElement);
|
|
31
|
+
continue;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
// Skip whitespace-only paragraph nodes between code blocks
|
|
35
|
+
if (
|
|
36
|
+
child.type === "paragraph" &&
|
|
37
|
+
child.children.every((c) => c.type === "text" && !c.value.trim())
|
|
38
|
+
) {
|
|
39
|
+
continue;
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
newChildren.push(child);
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
node.children = newChildren;
|
|
46
|
+
});
|
|
47
|
+
};
|
|
@@ -1,13 +1,13 @@
|
|
|
1
|
-
import path from "node:path";
|
|
2
|
-
import type { Root } from "mdast";
|
|
3
|
-
import type { VFile } from "vfile";
|
|
4
|
-
import { exportMdxjsConst } from "./utils.js";
|
|
5
|
-
|
|
6
|
-
export const remarkInjectFilepath =
|
|
7
|
-
(rootDir: string) => (tree: Root, vfile: VFile) => {
|
|
8
|
-
const relativePath = path
|
|
9
|
-
.relative(rootDir, vfile.path)
|
|
10
|
-
.split(path.sep)
|
|
11
|
-
.join(path.posix.sep);
|
|
12
|
-
tree.children.unshift(exportMdxjsConst("__filepath", relativePath));
|
|
13
|
-
};
|
|
1
|
+
import path from "node:path";
|
|
2
|
+
import type { Root } from "mdast";
|
|
3
|
+
import type { VFile } from "vfile";
|
|
4
|
+
import { exportMdxjsConst } from "./utils.js";
|
|
5
|
+
|
|
6
|
+
export const remarkInjectFilepath =
|
|
7
|
+
(rootDir: string) => (tree: Root, vfile: VFile) => {
|
|
8
|
+
const relativePath = path
|
|
9
|
+
.relative(rootDir, vfile.path)
|
|
10
|
+
.split(path.sep)
|
|
11
|
+
.join(path.posix.sep);
|
|
12
|
+
tree.children.unshift(exportMdxjsConst("__filepath", relativePath));
|
|
13
|
+
};
|