@lukoweb/apitogo 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (91) hide show
  1. package/dist/cli/cli.js +37 -147
  2. package/dist/declarations/lib/ui/Command.d.ts +1 -1
  3. package/dist/declarations/lib/util/MdxComponents.d.ts +1 -1
  4. package/package.json +1 -1
  5. package/src/app/main.tsx +150 -150
  6. package/src/config/loader.ts +245 -245
  7. package/src/index.ts +33 -33
  8. package/src/lib/authentication/components/CallbackHandler.tsx +45 -45
  9. package/src/lib/authentication/components/SignIn.tsx +46 -46
  10. package/src/lib/authentication/components/SignUp.tsx +48 -48
  11. package/src/lib/authentication/providers/clerk.tsx +224 -224
  12. package/src/lib/authentication/ui/AuthCard.tsx +7 -7
  13. package/src/lib/authentication/ui/EmailLinkCallbackUi.tsx +129 -125
  14. package/src/lib/authentication/ui/EmailLinkSentUi.tsx +105 -101
  15. package/src/lib/authentication/ui/EmailLinkSignInUi.tsx +100 -96
  16. package/src/lib/authentication/ui/EmailVerificationUi.tsx +128 -124
  17. package/src/lib/authentication/ui/ZudokuAuthUi.tsx +620 -616
  18. package/src/lib/components/AiAssistantMenuItems.tsx +102 -102
  19. package/src/lib/components/Autocomplete.tsx +123 -123
  20. package/src/lib/components/DeveloperHint.tsx +39 -35
  21. package/src/lib/components/Header.tsx +260 -260
  22. package/src/lib/components/Layout.tsx +53 -53
  23. package/src/lib/components/Main.tsx +51 -51
  24. package/src/lib/components/Mermaid.tsx +74 -70
  25. package/src/lib/components/MobileTopNavigation.tsx +276 -276
  26. package/src/lib/components/MultiSelect.tsx +86 -82
  27. package/src/lib/components/TopNavigation.tsx +103 -103
  28. package/src/lib/components/index.ts +26 -26
  29. package/src/lib/components/navigation/NavigationCategory.tsx +157 -157
  30. package/src/lib/components/navigation/NavigationFilterInput.tsx +35 -35
  31. package/src/lib/components/navigation/NavigationItem.tsx +181 -177
  32. package/src/lib/core/RouteGuard.tsx +193 -193
  33. package/src/lib/errors/ErrorMessage.tsx +50 -46
  34. package/src/lib/plugins/api-catalog/Catalog.tsx +80 -80
  35. package/src/lib/plugins/api-keys/CreateApiKey.tsx +128 -124
  36. package/src/lib/plugins/api-keys/CreateApiKeyDialog.tsx +49 -49
  37. package/src/lib/plugins/api-keys/SettingsApiKeys.tsx +72 -72
  38. package/src/lib/plugins/api-keys/settings/ApiKeyItem.tsx +342 -342
  39. package/src/lib/plugins/api-keys/settings/RevealApiKey.tsx +127 -127
  40. package/src/lib/plugins/markdown/MdxPage.tsx +285 -285
  41. package/src/lib/plugins/openapi/ApiHeader.tsx +96 -96
  42. package/src/lib/plugins/openapi/CollapsibleCode.tsx +88 -88
  43. package/src/lib/plugins/openapi/DownloadSchemaButton.tsx +94 -94
  44. package/src/lib/plugins/openapi/GeneratedExampleSidecarBox.tsx +52 -52
  45. package/src/lib/plugins/openapi/OperationListItem.tsx +183 -183
  46. package/src/lib/plugins/openapi/RequestBodySidecarBox.tsx +63 -63
  47. package/src/lib/plugins/openapi/ResponsesSidecarBox.tsx +120 -117
  48. package/src/lib/plugins/openapi/SchemaInfo.tsx +344 -344
  49. package/src/lib/plugins/openapi/SchemaList.tsx +113 -113
  50. package/src/lib/plugins/openapi/Sidecar.tsx +312 -309
  51. package/src/lib/plugins/openapi/SidecarExamples.tsx +177 -174
  52. package/src/lib/plugins/openapi/components/EnumValues.tsx +58 -58
  53. package/src/lib/plugins/openapi/components/ResponseContent.tsx +117 -114
  54. package/src/lib/plugins/openapi/playground/BodyPanel.tsx +274 -271
  55. package/src/lib/plugins/openapi/playground/CollapsibleHeader.tsx +51 -51
  56. package/src/lib/plugins/openapi/playground/ExamplesDropdown.tsx +60 -60
  57. package/src/lib/plugins/openapi/playground/Headers.tsx +188 -181
  58. package/src/lib/plugins/openapi/playground/IdentityDialog.tsx +75 -75
  59. package/src/lib/plugins/openapi/playground/IdentitySelector.tsx +38 -38
  60. package/src/lib/plugins/openapi/playground/ParamsGrid.tsx +45 -45
  61. package/src/lib/plugins/openapi/playground/Playground.tsx +602 -599
  62. package/src/lib/plugins/openapi/playground/PlaygroundDialog.tsx +56 -56
  63. package/src/lib/plugins/openapi/playground/QueryParams.tsx +151 -148
  64. package/src/lib/plugins/openapi/playground/RequestLoginDialog.tsx +70 -70
  65. package/src/lib/plugins/openapi/playground/request-panel/MultipartField.tsx +91 -91
  66. package/src/lib/plugins/openapi/playground/result-panel/AudioPlayer.tsx +50 -50
  67. package/src/lib/plugins/openapi/playground/result-panel/ResponseTab.tsx +355 -355
  68. package/src/lib/plugins/openapi/playground/result-panel/ResultPanel.tsx +106 -102
  69. package/src/lib/plugins/openapi/schema/SchemaPropertyItem.tsx +189 -184
  70. package/src/lib/plugins/openapi/schema/SchemaView.tsx +299 -299
  71. package/src/lib/plugins/search-pagefind/IndexingDialog.tsx +162 -162
  72. package/src/lib/plugins/search-pagefind/PagefindSearch.tsx +202 -202
  73. package/src/lib/plugins/search-pagefind/ResultList.tsx +122 -118
  74. package/src/lib/ui/ActionButton.tsx +21 -21
  75. package/src/lib/ui/Command.tsx +191 -191
  76. package/src/lib/util/MdxComponents.tsx +150 -150
  77. package/src/vite/config.ts +234 -231
  78. package/src/vite/dev-server.ts +291 -291
  79. package/src/vite/plugin-api-keys.ts +50 -50
  80. package/src/vite/plugin-api.ts +320 -318
  81. package/src/vite/plugin-auth.ts +38 -38
  82. package/src/vite/plugin-component.ts +45 -39
  83. package/src/vite/plugin-config.ts +75 -75
  84. package/src/vite/plugin-custom-pages.ts +36 -36
  85. package/src/vite/plugin-docs.ts +202 -202
  86. package/src/vite/plugin-markdown-export.ts +214 -214
  87. package/src/vite/plugin-mdx.ts +149 -149
  88. package/src/vite/plugin-navigation.ts +106 -106
  89. package/src/vite/plugin-search.ts +47 -47
  90. package/src/vite/plugin.ts +42 -42
  91. package/src/vite/prerender/prerender.ts +233 -233
@@ -1,82 +1,86 @@
1
- import { CheckIcon, ChevronDownIcon } from "lucide-react";
2
- import { useState } from "react";
3
- import { Popover, PopoverContent, PopoverTrigger } from "@lukoweb/apitogo/ui/Popover.js";
4
- import { cn } from "../util/cn.js";
5
-
6
- type MultiSelectProps = {
7
- options: readonly string[];
8
- value: string[];
9
- onChange: (value: string[]) => void;
10
- placeholder?: string;
11
- className?: string;
12
- };
13
-
14
- export const MultiSelect = ({
15
- options,
16
- value,
17
- onChange,
18
- placeholder = "Select values...",
19
- className,
20
- }: MultiSelectProps) => {
21
- const [open, setOpen] = useState(false);
22
-
23
- const toggleValue = (option: string) => {
24
- if (value.includes(option)) {
25
- onChange(value.filter((v) => v !== option));
26
- } else {
27
- onChange([...value, option]);
28
- }
29
- };
30
-
31
- return (
32
- <Popover open={open} onOpenChange={setOpen}>
33
- <PopoverTrigger asChild>
34
- <button
35
- type="button"
36
- className={cn(
37
- "flex items-center justify-between w-full h-9 bg-transparent text-xs font-mono text-left truncate",
38
- !value.length && "text-muted-foreground",
39
- className,
40
- )}
41
- >
42
- <span className="truncate">
43
- {value.length > 0 ? value.join(", ") : placeholder}
44
- </span>
45
- <ChevronDownIcon className="size-3.5 shrink-0 opacity-50" />
46
- </button>
47
- </PopoverTrigger>
48
- <PopoverContent
49
- className="p-1 w-(--radix-popover-trigger-width)"
50
- align="start"
51
- side="bottom"
52
- onWheel={(e) => e.stopPropagation()}
53
- onTouchMove={(e) => e.stopPropagation()}
54
- >
55
- <div className="max-h-[140px] overflow-y-auto">
56
- {options.map((option) => {
57
- const isSelected = value.includes(option);
58
- return (
59
- <button
60
- key={option}
61
- type="button"
62
- className="flex items-center gap-2 w-full rounded-xs px-2 py-1.5 text-sm cursor-pointer hover:bg-accent hover:text-accent-foreground"
63
- onClick={() => toggleValue(option)}
64
- >
65
- <span
66
- className={cn(
67
- "flex size-4 shrink-0 items-center justify-center rounded-[4px] border",
68
- isSelected &&
69
- "bg-primary border-primary text-primary-foreground",
70
- )}
71
- >
72
- {isSelected && <CheckIcon className="size-3" />}
73
- </span>
74
- <span className="truncate font-mono text-xs">{option}</span>
75
- </button>
76
- );
77
- })}
78
- </div>
79
- </PopoverContent>
80
- </Popover>
81
- );
82
- };
1
+ import {
2
+ Popover,
3
+ PopoverContent,
4
+ PopoverTrigger,
5
+ } from "@lukoweb/apitogo/ui/Popover.js";
6
+ import { CheckIcon, ChevronDownIcon } from "lucide-react";
7
+ import { useState } from "react";
8
+ import { cn } from "../util/cn.js";
9
+
10
+ type MultiSelectProps = {
11
+ options: readonly string[];
12
+ value: string[];
13
+ onChange: (value: string[]) => void;
14
+ placeholder?: string;
15
+ className?: string;
16
+ };
17
+
18
+ export const MultiSelect = ({
19
+ options,
20
+ value,
21
+ onChange,
22
+ placeholder = "Select values...",
23
+ className,
24
+ }: MultiSelectProps) => {
25
+ const [open, setOpen] = useState(false);
26
+
27
+ const toggleValue = (option: string) => {
28
+ if (value.includes(option)) {
29
+ onChange(value.filter((v) => v !== option));
30
+ } else {
31
+ onChange([...value, option]);
32
+ }
33
+ };
34
+
35
+ return (
36
+ <Popover open={open} onOpenChange={setOpen}>
37
+ <PopoverTrigger asChild>
38
+ <button
39
+ type="button"
40
+ className={cn(
41
+ "flex items-center justify-between w-full h-9 bg-transparent text-xs font-mono text-left truncate",
42
+ !value.length && "text-muted-foreground",
43
+ className,
44
+ )}
45
+ >
46
+ <span className="truncate">
47
+ {value.length > 0 ? value.join(", ") : placeholder}
48
+ </span>
49
+ <ChevronDownIcon className="size-3.5 shrink-0 opacity-50" />
50
+ </button>
51
+ </PopoverTrigger>
52
+ <PopoverContent
53
+ className="p-1 w-(--radix-popover-trigger-width)"
54
+ align="start"
55
+ side="bottom"
56
+ onWheel={(e) => e.stopPropagation()}
57
+ onTouchMove={(e) => e.stopPropagation()}
58
+ >
59
+ <div className="max-h-[140px] overflow-y-auto">
60
+ {options.map((option) => {
61
+ const isSelected = value.includes(option);
62
+ return (
63
+ <button
64
+ key={option}
65
+ type="button"
66
+ className="flex items-center gap-2 w-full rounded-xs px-2 py-1.5 text-sm cursor-pointer hover:bg-accent hover:text-accent-foreground"
67
+ onClick={() => toggleValue(option)}
68
+ >
69
+ <span
70
+ className={cn(
71
+ "flex size-4 shrink-0 items-center justify-center rounded-[4px] border",
72
+ isSelected &&
73
+ "bg-primary border-primary text-primary-foreground",
74
+ )}
75
+ >
76
+ {isSelected && <CheckIcon className="size-3" />}
77
+ </span>
78
+ <span className="truncate font-mono text-xs">{option}</span>
79
+ </button>
80
+ );
81
+ })}
82
+ </div>
83
+ </PopoverContent>
84
+ </Popover>
85
+ );
86
+ };
@@ -1,103 +1,103 @@
1
- import { cx } from "class-variance-authority";
2
- import { deepEqual } from "fast-equals";
3
- import { Suspense } from "react";
4
- import { NavLink, type NavLinkProps } from "react-router";
5
- import { Separator } from "@lukoweb/apitogo/ui/Separator.js";
6
- import type { NavigationItem } from "../../config/validators/NavigationSchema.js";
7
- import { useAuth } from "../authentication/hook.js";
8
- import { useCurrentNavigation, useZudoku } from "./context/ZudokuContext.js";
9
- import { getFirstMatchingPath, shouldShowItem } from "./navigation/utils.js";
10
- import { Slot } from "./Slot.js";
11
-
12
- export const TopNavigation = () => {
13
- const context = useZudoku();
14
- const {
15
- options: { navigation = [] },
16
- } = context;
17
- const auth = useAuth();
18
- const filteredItems = navigation.filter(shouldShowItem({ auth, context }));
19
-
20
- if (filteredItems.length === 0 || import.meta.env.MODE === "standalone") {
21
- return <style>{`:root { --top-nav-height: 0px; }`}</style>;
22
- }
23
-
24
- return (
25
- <Suspense>
26
- <div className="items-center justify-between px-8 h-(--top-nav-height) hidden lg:flex text-sm relative">
27
- <nav className="text-sm">
28
- <ul className="flex flex-row items-center gap-8">
29
- {filteredItems.map((item) =>
30
- item.type === "separator" ? (
31
- <li key={item.label} className="-mx-4 h-7">
32
- <Separator orientation="vertical" />
33
- </li>
34
- ) : item.type !== "section" && item.type !== "filter" ? (
35
- <li key={item.label + item.type}>
36
- <TopNavItem {...item} />
37
- </li>
38
- ) : null,
39
- )}
40
- </ul>
41
- </nav>
42
- <Slot.Target name="top-navigation-side" />
43
- </div>
44
- {/* <PageProgress /> */}
45
- </Suspense>
46
- );
47
- };
48
-
49
- export const TopNavLink = ({
50
- isActive,
51
- children,
52
- ...props
53
- }: {
54
- isActive?: boolean;
55
- children: React.ReactNode;
56
- } & NavLinkProps) => {
57
- return (
58
- <NavLink
59
- viewTransition
60
- className={({ isActive: isActiveNavLink, isPending }) => {
61
- const isActiveReal = isActiveNavLink || isActive;
62
- return cx(
63
- "flex items-center gap-2 lg:py-3.5 font-medium -mb-px transition duration-150 delay-75 relative",
64
- isActiveReal || isPending
65
- ? [
66
- "text-foreground",
67
- // underline with view transition animation
68
- "after:content-[''] after:absolute after:bottom-0 after:left-0 after:right-0",
69
- "after:h-0.5 after:bg-primary",
70
- isActiveReal &&
71
- "after:[view-transition-name:top-nav-underline]",
72
- isPending && "after:bg-primary/25",
73
- ]
74
- : "text-foreground/75 hover:text-foreground",
75
- );
76
- }}
77
- {...props}
78
- >
79
- {children}
80
- </NavLink>
81
- );
82
- };
83
-
84
- export const TopNavItem = (
85
- item: Exclude<
86
- NavigationItem,
87
- { type: "separator" } | { type: "section" } | { type: "filter" }
88
- >,
89
- ) => {
90
- const currentNav = useCurrentNavigation();
91
- const isActiveTopNavItem = deepEqual(currentNav.topNavItem, item);
92
-
93
- const path = getFirstMatchingPath(item);
94
-
95
- return (
96
- // We don't use isActive here because it has to be inside the navigation,
97
- // the top nav id doesn't necessarily start with the navigation id
98
- <TopNavLink to={path} isActive={isActiveTopNavItem}>
99
- {item.icon && <item.icon size={16} className="align-[-0.125em]" />}
100
- {item.label}
101
- </TopNavLink>
102
- );
103
- };
1
+ import { Separator } from "@lukoweb/apitogo/ui/Separator.js";
2
+ import { cx } from "class-variance-authority";
3
+ import { deepEqual } from "fast-equals";
4
+ import { Suspense } from "react";
5
+ import { NavLink, type NavLinkProps } from "react-router";
6
+ import type { NavigationItem } from "../../config/validators/NavigationSchema.js";
7
+ import { useAuth } from "../authentication/hook.js";
8
+ import { useCurrentNavigation, useZudoku } from "./context/ZudokuContext.js";
9
+ import { getFirstMatchingPath, shouldShowItem } from "./navigation/utils.js";
10
+ import { Slot } from "./Slot.js";
11
+
12
+ export const TopNavigation = () => {
13
+ const context = useZudoku();
14
+ const {
15
+ options: { navigation = [] },
16
+ } = context;
17
+ const auth = useAuth();
18
+ const filteredItems = navigation.filter(shouldShowItem({ auth, context }));
19
+
20
+ if (filteredItems.length === 0 || import.meta.env.MODE === "standalone") {
21
+ return <style>{`:root { --top-nav-height: 0px; }`}</style>;
22
+ }
23
+
24
+ return (
25
+ <Suspense>
26
+ <div className="items-center justify-between px-8 h-(--top-nav-height) hidden lg:flex text-sm relative">
27
+ <nav className="text-sm">
28
+ <ul className="flex flex-row items-center gap-8">
29
+ {filteredItems.map((item) =>
30
+ item.type === "separator" ? (
31
+ <li key={item.label} className="-mx-4 h-7">
32
+ <Separator orientation="vertical" />
33
+ </li>
34
+ ) : item.type !== "section" && item.type !== "filter" ? (
35
+ <li key={item.label + item.type}>
36
+ <TopNavItem {...item} />
37
+ </li>
38
+ ) : null,
39
+ )}
40
+ </ul>
41
+ </nav>
42
+ <Slot.Target name="top-navigation-side" />
43
+ </div>
44
+ {/* <PageProgress /> */}
45
+ </Suspense>
46
+ );
47
+ };
48
+
49
+ export const TopNavLink = ({
50
+ isActive,
51
+ children,
52
+ ...props
53
+ }: {
54
+ isActive?: boolean;
55
+ children: React.ReactNode;
56
+ } & NavLinkProps) => {
57
+ return (
58
+ <NavLink
59
+ viewTransition
60
+ className={({ isActive: isActiveNavLink, isPending }) => {
61
+ const isActiveReal = isActiveNavLink || isActive;
62
+ return cx(
63
+ "flex items-center gap-2 lg:py-3.5 font-medium -mb-px transition duration-150 delay-75 relative",
64
+ isActiveReal || isPending
65
+ ? [
66
+ "text-foreground",
67
+ // underline with view transition animation
68
+ "after:content-[''] after:absolute after:bottom-0 after:left-0 after:right-0",
69
+ "after:h-0.5 after:bg-primary",
70
+ isActiveReal &&
71
+ "after:[view-transition-name:top-nav-underline]",
72
+ isPending && "after:bg-primary/25",
73
+ ]
74
+ : "text-foreground/75 hover:text-foreground",
75
+ );
76
+ }}
77
+ {...props}
78
+ >
79
+ {children}
80
+ </NavLink>
81
+ );
82
+ };
83
+
84
+ export const TopNavItem = (
85
+ item: Exclude<
86
+ NavigationItem,
87
+ { type: "separator" } | { type: "section" } | { type: "filter" }
88
+ >,
89
+ ) => {
90
+ const currentNav = useCurrentNavigation();
91
+ const isActiveTopNavItem = deepEqual(currentNav.topNavItem, item);
92
+
93
+ const path = getFirstMatchingPath(item);
94
+
95
+ return (
96
+ // We don't use isActive here because it has to be inside the navigation,
97
+ // the top nav id doesn't necessarily start with the navigation id
98
+ <TopNavLink to={path} isActive={isActiveTopNavItem}>
99
+ {item.icon && <item.icon size={16} className="align-[-0.125em]" />}
100
+ {item.label}
101
+ </TopNavLink>
102
+ );
103
+ };
@@ -1,26 +1,26 @@
1
- export { Helmet as Head } from "@zudoku/react-helmet-async";
2
- export { Link } from "react-router";
3
- export { Button } from "../ui/Button.js";
4
- export { Callout } from "../ui/Callout.js";
5
- export { ZudokuError } from "../util/invariant.js";
6
- export { ClientOnly } from "./ClientOnly.js";
7
- export { Heading } from "./Heading.js";
8
- export { Markdown } from "./Markdown.js";
9
- export { Search } from "./Search.js";
10
- export { type CustomSlotNames, Slot } from "./Slot.js";
11
- export { Spinner } from "./Spinner.js";
12
- export { Typography } from "./Typography.js";
13
- export { Zudoku } from "./Zudoku.js";
14
-
15
- //
16
-
17
- /** @deprecated Import from `apitogo/hooks` instead */
18
- export { useMDXComponents } from "@mdx-js/react";
19
- /** @deprecated Import from `apitogo/hooks` instead */
20
- export { useTheme } from "next-themes";
21
- /** @deprecated Import from `apitogo/hooks` instead */
22
- export { useAuth } from "../authentication/hook.js";
23
- /** @deprecated Import from `apitogo/hooks` instead */
24
- export { CACHE_KEYS, useCache } from "./cache.js";
25
- /** @deprecated Import from `apitogo/hooks` instead */
26
- export { useZudoku } from "./context/ZudokuContext.js";
1
+ export { Helmet as Head } from "@zudoku/react-helmet-async";
2
+ export { Link } from "react-router";
3
+ export { Button } from "../ui/Button.js";
4
+ export { Callout } from "../ui/Callout.js";
5
+ export { ZudokuError } from "../util/invariant.js";
6
+ export { ClientOnly } from "./ClientOnly.js";
7
+ export { Heading } from "./Heading.js";
8
+ export { Markdown } from "./Markdown.js";
9
+ export { Search } from "./Search.js";
10
+ export { type CustomSlotNames, Slot } from "./Slot.js";
11
+ export { Spinner } from "./Spinner.js";
12
+ export { Typography } from "./Typography.js";
13
+ export { Zudoku } from "./Zudoku.js";
14
+
15
+ //
16
+
17
+ /** @deprecated Import from `apitogo/hooks` instead */
18
+ export { useMDXComponents } from "@mdx-js/react";
19
+ /** @deprecated Import from `apitogo/hooks` instead */
20
+ export { useTheme } from "next-themes";
21
+ /** @deprecated Import from `apitogo/hooks` instead */
22
+ export { useAuth } from "../authentication/hook.js";
23
+ /** @deprecated Import from `apitogo/hooks` instead */
24
+ export { CACHE_KEYS, useCache } from "./cache.js";
25
+ /** @deprecated Import from `apitogo/hooks` instead */
26
+ export { useZudoku } from "./context/ZudokuContext.js";