@brainfish-ai/devdoc 0.1.21

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 (268) hide show
  1. package/LICENSE +33 -0
  2. package/README.md +415 -0
  3. package/bin/devdoc.js +13 -0
  4. package/dist/cli/commands/build.d.ts +5 -0
  5. package/dist/cli/commands/build.js +87 -0
  6. package/dist/cli/commands/check.d.ts +1 -0
  7. package/dist/cli/commands/check.js +143 -0
  8. package/dist/cli/commands/create.d.ts +24 -0
  9. package/dist/cli/commands/create.js +387 -0
  10. package/dist/cli/commands/deploy.d.ts +9 -0
  11. package/dist/cli/commands/deploy.js +433 -0
  12. package/dist/cli/commands/dev.d.ts +6 -0
  13. package/dist/cli/commands/dev.js +139 -0
  14. package/dist/cli/commands/init.d.ts +11 -0
  15. package/dist/cli/commands/init.js +238 -0
  16. package/dist/cli/commands/keys.d.ts +12 -0
  17. package/dist/cli/commands/keys.js +165 -0
  18. package/dist/cli/commands/start.d.ts +5 -0
  19. package/dist/cli/commands/start.js +56 -0
  20. package/dist/cli/commands/upload.d.ts +13 -0
  21. package/dist/cli/commands/upload.js +238 -0
  22. package/dist/cli/commands/whoami.d.ts +8 -0
  23. package/dist/cli/commands/whoami.js +91 -0
  24. package/dist/cli/index.d.ts +1 -0
  25. package/dist/cli/index.js +106 -0
  26. package/dist/config/index.d.ts +80 -0
  27. package/dist/config/index.js +133 -0
  28. package/dist/constants.d.ts +9 -0
  29. package/dist/constants.js +13 -0
  30. package/dist/index.d.ts +7 -0
  31. package/dist/index.js +12 -0
  32. package/dist/utils/logger.d.ts +16 -0
  33. package/dist/utils/logger.js +61 -0
  34. package/dist/utils/paths.d.ts +16 -0
  35. package/dist/utils/paths.js +50 -0
  36. package/package.json +51 -0
  37. package/renderer/app/api/assets/[...path]/route.ts +123 -0
  38. package/renderer/app/api/assets/route.ts +124 -0
  39. package/renderer/app/api/assets/upload/route.ts +177 -0
  40. package/renderer/app/api/auth-schemes/route.ts +77 -0
  41. package/renderer/app/api/chat/route.ts +858 -0
  42. package/renderer/app/api/codegen/route.ts +72 -0
  43. package/renderer/app/api/collections/route.ts +1016 -0
  44. package/renderer/app/api/debug/route.ts +53 -0
  45. package/renderer/app/api/deploy/route.ts +234 -0
  46. package/renderer/app/api/device/route.ts +42 -0
  47. package/renderer/app/api/docs/route.ts +187 -0
  48. package/renderer/app/api/keys/regenerate/route.ts +80 -0
  49. package/renderer/app/api/openapi-spec/route.ts +151 -0
  50. package/renderer/app/api/projects/[slug]/route.ts +153 -0
  51. package/renderer/app/api/projects/[slug]/stats/route.ts +96 -0
  52. package/renderer/app/api/projects/register/route.ts +152 -0
  53. package/renderer/app/api/proxy/route.ts +149 -0
  54. package/renderer/app/api/proxy-stream/route.ts +168 -0
  55. package/renderer/app/api/redirects/route.ts +47 -0
  56. package/renderer/app/api/schema/route.ts +65 -0
  57. package/renderer/app/api/subdomains/check/route.ts +172 -0
  58. package/renderer/app/api/suggestions/route.ts +144 -0
  59. package/renderer/app/favicon.ico +0 -0
  60. package/renderer/app/globals.css +1103 -0
  61. package/renderer/app/layout.tsx +47 -0
  62. package/renderer/app/llms-full.txt/route.ts +346 -0
  63. package/renderer/app/llms.txt/route.ts +279 -0
  64. package/renderer/app/page.tsx +14 -0
  65. package/renderer/app/robots.txt/route.ts +84 -0
  66. package/renderer/app/sitemap.xml/route.ts +199 -0
  67. package/renderer/components/docs/index.ts +12 -0
  68. package/renderer/components/docs/mdx/accordion.tsx +169 -0
  69. package/renderer/components/docs/mdx/badge.tsx +132 -0
  70. package/renderer/components/docs/mdx/callouts.tsx +154 -0
  71. package/renderer/components/docs/mdx/cards.tsx +213 -0
  72. package/renderer/components/docs/mdx/changelog.tsx +120 -0
  73. package/renderer/components/docs/mdx/code-block.tsx +186 -0
  74. package/renderer/components/docs/mdx/code-group.tsx +421 -0
  75. package/renderer/components/docs/mdx/file-embeds.tsx +105 -0
  76. package/renderer/components/docs/mdx/frame.tsx +112 -0
  77. package/renderer/components/docs/mdx/highlight.tsx +151 -0
  78. package/renderer/components/docs/mdx/iframe.tsx +134 -0
  79. package/renderer/components/docs/mdx/image.tsx +235 -0
  80. package/renderer/components/docs/mdx/index.ts +204 -0
  81. package/renderer/components/docs/mdx/mermaid.tsx +240 -0
  82. package/renderer/components/docs/mdx/param-field.tsx +200 -0
  83. package/renderer/components/docs/mdx/steps.tsx +113 -0
  84. package/renderer/components/docs/mdx/tabs.tsx +86 -0
  85. package/renderer/components/docs/mdx-renderer.tsx +100 -0
  86. package/renderer/components/docs/navigation/breadcrumbs.tsx +76 -0
  87. package/renderer/components/docs/navigation/index.ts +8 -0
  88. package/renderer/components/docs/navigation/page-nav.tsx +64 -0
  89. package/renderer/components/docs/navigation/sidebar.tsx +515 -0
  90. package/renderer/components/docs/navigation/toc.tsx +113 -0
  91. package/renderer/components/docs/notice.tsx +105 -0
  92. package/renderer/components/docs-header.tsx +274 -0
  93. package/renderer/components/docs-viewer/agent/agent-chat.tsx +2076 -0
  94. package/renderer/components/docs-viewer/agent/cards/debug-context-card.tsx +90 -0
  95. package/renderer/components/docs-viewer/agent/cards/endpoint-context-card.tsx +49 -0
  96. package/renderer/components/docs-viewer/agent/cards/index.tsx +50 -0
  97. package/renderer/components/docs-viewer/agent/cards/response-options-card.tsx +212 -0
  98. package/renderer/components/docs-viewer/agent/cards/types.ts +84 -0
  99. package/renderer/components/docs-viewer/agent/chat-message.tsx +17 -0
  100. package/renderer/components/docs-viewer/agent/index.tsx +6 -0
  101. package/renderer/components/docs-viewer/agent/messages/assistant-message.tsx +119 -0
  102. package/renderer/components/docs-viewer/agent/messages/chat-message.tsx +46 -0
  103. package/renderer/components/docs-viewer/agent/messages/index.ts +17 -0
  104. package/renderer/components/docs-viewer/agent/messages/tool-call-display.tsx +721 -0
  105. package/renderer/components/docs-viewer/agent/messages/types.ts +61 -0
  106. package/renderer/components/docs-viewer/agent/messages/typing-indicator.tsx +24 -0
  107. package/renderer/components/docs-viewer/agent/messages/user-message.tsx +51 -0
  108. package/renderer/components/docs-viewer/code-editor/index.tsx +2 -0
  109. package/renderer/components/docs-viewer/code-editor/notes-mode.tsx +1283 -0
  110. package/renderer/components/docs-viewer/content/changelog-page.tsx +331 -0
  111. package/renderer/components/docs-viewer/content/doc-page.tsx +285 -0
  112. package/renderer/components/docs-viewer/content/documentation-viewer.tsx +17 -0
  113. package/renderer/components/docs-viewer/content/index.tsx +29 -0
  114. package/renderer/components/docs-viewer/content/introduction.tsx +21 -0
  115. package/renderer/components/docs-viewer/content/request-details.tsx +330 -0
  116. package/renderer/components/docs-viewer/content/sections/auth.tsx +69 -0
  117. package/renderer/components/docs-viewer/content/sections/body.tsx +66 -0
  118. package/renderer/components/docs-viewer/content/sections/headers.tsx +43 -0
  119. package/renderer/components/docs-viewer/content/sections/overview.tsx +40 -0
  120. package/renderer/components/docs-viewer/content/sections/parameters.tsx +43 -0
  121. package/renderer/components/docs-viewer/content/sections/responses.tsx +87 -0
  122. package/renderer/components/docs-viewer/global-auth-modal.tsx +352 -0
  123. package/renderer/components/docs-viewer/index.tsx +1466 -0
  124. package/renderer/components/docs-viewer/playground/auth-editor.tsx +280 -0
  125. package/renderer/components/docs-viewer/playground/body-editor.tsx +221 -0
  126. package/renderer/components/docs-viewer/playground/code-editor.tsx +224 -0
  127. package/renderer/components/docs-viewer/playground/code-snippet.tsx +387 -0
  128. package/renderer/components/docs-viewer/playground/graphql-playground.tsx +745 -0
  129. package/renderer/components/docs-viewer/playground/index.tsx +671 -0
  130. package/renderer/components/docs-viewer/playground/key-value-editor.tsx +261 -0
  131. package/renderer/components/docs-viewer/playground/method-selector.tsx +60 -0
  132. package/renderer/components/docs-viewer/playground/request-builder.tsx +179 -0
  133. package/renderer/components/docs-viewer/playground/request-tabs.tsx +237 -0
  134. package/renderer/components/docs-viewer/playground/response-cards/idle-card.tsx +21 -0
  135. package/renderer/components/docs-viewer/playground/response-cards/index.tsx +93 -0
  136. package/renderer/components/docs-viewer/playground/response-cards/loading-card.tsx +16 -0
  137. package/renderer/components/docs-viewer/playground/response-cards/network-error-card.tsx +23 -0
  138. package/renderer/components/docs-viewer/playground/response-cards/response-body-card.tsx +268 -0
  139. package/renderer/components/docs-viewer/playground/response-cards/types.ts +82 -0
  140. package/renderer/components/docs-viewer/playground/response-viewer.tsx +43 -0
  141. package/renderer/components/docs-viewer/search/index.ts +2 -0
  142. package/renderer/components/docs-viewer/search/search-dialog.tsx +331 -0
  143. package/renderer/components/docs-viewer/search/use-search.ts +117 -0
  144. package/renderer/components/docs-viewer/shared/markdown-renderer.tsx +431 -0
  145. package/renderer/components/docs-viewer/shared/method-badge.tsx +41 -0
  146. package/renderer/components/docs-viewer/shared/schema-viewer.tsx +349 -0
  147. package/renderer/components/docs-viewer/sidebar/collection-tree.tsx +239 -0
  148. package/renderer/components/docs-viewer/sidebar/endpoint-options.tsx +316 -0
  149. package/renderer/components/docs-viewer/sidebar/index.tsx +343 -0
  150. package/renderer/components/docs-viewer/sidebar/right-sidebar.tsx +202 -0
  151. package/renderer/components/docs-viewer/sidebar/sidebar-group.tsx +118 -0
  152. package/renderer/components/docs-viewer/sidebar/sidebar-item.tsx +226 -0
  153. package/renderer/components/docs-viewer/sidebar/sidebar-section.tsx +52 -0
  154. package/renderer/components/theme-provider.tsx +11 -0
  155. package/renderer/components/theme-toggle.tsx +76 -0
  156. package/renderer/components/ui/badge.tsx +46 -0
  157. package/renderer/components/ui/button.tsx +59 -0
  158. package/renderer/components/ui/dialog.tsx +118 -0
  159. package/renderer/components/ui/dropdown-menu.tsx +257 -0
  160. package/renderer/components/ui/input.tsx +21 -0
  161. package/renderer/components/ui/label.tsx +24 -0
  162. package/renderer/components/ui/navigation-menu.tsx +168 -0
  163. package/renderer/components/ui/select.tsx +190 -0
  164. package/renderer/components/ui/spinner.tsx +114 -0
  165. package/renderer/components/ui/tabs.tsx +66 -0
  166. package/renderer/components/ui/tooltip.tsx +61 -0
  167. package/renderer/hooks/use-code-copy.ts +88 -0
  168. package/renderer/hooks/use-openapi-title.ts +44 -0
  169. package/renderer/lib/api-docs/agent/index.ts +6 -0
  170. package/renderer/lib/api-docs/agent/indexer.ts +323 -0
  171. package/renderer/lib/api-docs/agent/spec-summary.ts +335 -0
  172. package/renderer/lib/api-docs/agent/types.ts +116 -0
  173. package/renderer/lib/api-docs/auth/auth-context.tsx +225 -0
  174. package/renderer/lib/api-docs/auth/auth-storage.ts +87 -0
  175. package/renderer/lib/api-docs/auth/crypto.ts +89 -0
  176. package/renderer/lib/api-docs/auth/index.ts +4 -0
  177. package/renderer/lib/api-docs/code-editor/db.ts +164 -0
  178. package/renderer/lib/api-docs/code-editor/hooks.ts +266 -0
  179. package/renderer/lib/api-docs/code-editor/index.ts +6 -0
  180. package/renderer/lib/api-docs/code-editor/mode-context.tsx +207 -0
  181. package/renderer/lib/api-docs/code-editor/types.ts +105 -0
  182. package/renderer/lib/api-docs/codegen/definitions.ts +297 -0
  183. package/renderer/lib/api-docs/codegen/har.ts +251 -0
  184. package/renderer/lib/api-docs/codegen/index.ts +159 -0
  185. package/renderer/lib/api-docs/factories.ts +151 -0
  186. package/renderer/lib/api-docs/index.ts +17 -0
  187. package/renderer/lib/api-docs/mobile-context.tsx +112 -0
  188. package/renderer/lib/api-docs/navigation-context.tsx +88 -0
  189. package/renderer/lib/api-docs/parsers/graphql/README.md +129 -0
  190. package/renderer/lib/api-docs/parsers/graphql/index.ts +91 -0
  191. package/renderer/lib/api-docs/parsers/graphql/parser.ts +491 -0
  192. package/renderer/lib/api-docs/parsers/graphql/transformer.ts +246 -0
  193. package/renderer/lib/api-docs/parsers/graphql/types.ts +283 -0
  194. package/renderer/lib/api-docs/parsers/openapi/README.md +32 -0
  195. package/renderer/lib/api-docs/parsers/openapi/dereferencer.ts +60 -0
  196. package/renderer/lib/api-docs/parsers/openapi/extractors/auth.ts +574 -0
  197. package/renderer/lib/api-docs/parsers/openapi/extractors/body.ts +403 -0
  198. package/renderer/lib/api-docs/parsers/openapi/extractors/index.ts +232 -0
  199. package/renderer/lib/api-docs/parsers/openapi/index.ts +171 -0
  200. package/renderer/lib/api-docs/parsers/openapi/transformer.ts +277 -0
  201. package/renderer/lib/api-docs/parsers/openapi/validator.ts +31 -0
  202. package/renderer/lib/api-docs/playground/context.tsx +107 -0
  203. package/renderer/lib/api-docs/playground/navigation-context.tsx +124 -0
  204. package/renderer/lib/api-docs/playground/request-builder.ts +223 -0
  205. package/renderer/lib/api-docs/playground/request-runner.ts +282 -0
  206. package/renderer/lib/api-docs/playground/types.ts +35 -0
  207. package/renderer/lib/api-docs/types.ts +269 -0
  208. package/renderer/lib/api-docs/utils.ts +311 -0
  209. package/renderer/lib/cache.ts +193 -0
  210. package/renderer/lib/docs/config/index.ts +29 -0
  211. package/renderer/lib/docs/config/loader.ts +142 -0
  212. package/renderer/lib/docs/config/schema.ts +298 -0
  213. package/renderer/lib/docs/index.ts +12 -0
  214. package/renderer/lib/docs/mdx/compiler.ts +176 -0
  215. package/renderer/lib/docs/mdx/frontmatter.ts +80 -0
  216. package/renderer/lib/docs/mdx/index.ts +26 -0
  217. package/renderer/lib/docs/navigation/generator.ts +348 -0
  218. package/renderer/lib/docs/navigation/index.ts +12 -0
  219. package/renderer/lib/docs/navigation/types.ts +123 -0
  220. package/renderer/lib/docs-navigation-context.tsx +80 -0
  221. package/renderer/lib/multi-tenant/context.ts +105 -0
  222. package/renderer/lib/storage/blob.ts +845 -0
  223. package/renderer/lib/utils.ts +6 -0
  224. package/renderer/next.config.ts +76 -0
  225. package/renderer/package.json +66 -0
  226. package/renderer/postcss.config.mjs +5 -0
  227. package/renderer/public/assets/images/screenshot.png +0 -0
  228. package/renderer/public/assets/logo/dark.svg +9 -0
  229. package/renderer/public/assets/logo/light.svg +9 -0
  230. package/renderer/public/assets/logo.svg +9 -0
  231. package/renderer/public/file.svg +1 -0
  232. package/renderer/public/globe.svg +1 -0
  233. package/renderer/public/icon.png +0 -0
  234. package/renderer/public/logo.svg +9 -0
  235. package/renderer/public/window.svg +1 -0
  236. package/renderer/tsconfig.json +28 -0
  237. package/templates/basic/README.md +139 -0
  238. package/templates/basic/assets/favicon.svg +4 -0
  239. package/templates/basic/assets/logo.svg +9 -0
  240. package/templates/basic/docs.json +47 -0
  241. package/templates/basic/guides/configuration.mdx +149 -0
  242. package/templates/basic/guides/overview.mdx +96 -0
  243. package/templates/basic/index.mdx +39 -0
  244. package/templates/basic/package.json +14 -0
  245. package/templates/basic/quickstart.mdx +92 -0
  246. package/templates/basic/vercel.json +6 -0
  247. package/templates/graphql/README.md +139 -0
  248. package/templates/graphql/api-reference/schema.graphql +305 -0
  249. package/templates/graphql/assets/favicon.svg +4 -0
  250. package/templates/graphql/assets/logo.svg +9 -0
  251. package/templates/graphql/docs.json +54 -0
  252. package/templates/graphql/guides/configuration.mdx +149 -0
  253. package/templates/graphql/guides/overview.mdx +96 -0
  254. package/templates/graphql/index.mdx +39 -0
  255. package/templates/graphql/package.json +14 -0
  256. package/templates/graphql/quickstart.mdx +92 -0
  257. package/templates/graphql/vercel.json +6 -0
  258. package/templates/openapi/README.md +139 -0
  259. package/templates/openapi/api-reference/openapi.json +419 -0
  260. package/templates/openapi/assets/favicon.svg +4 -0
  261. package/templates/openapi/assets/logo.svg +9 -0
  262. package/templates/openapi/docs.json +61 -0
  263. package/templates/openapi/guides/configuration.mdx +149 -0
  264. package/templates/openapi/guides/overview.mdx +96 -0
  265. package/templates/openapi/index.mdx +39 -0
  266. package/templates/openapi/package.json +14 -0
  267. package/templates/openapi/quickstart.mdx +92 -0
  268. package/templates/openapi/vercel.json +6 -0
@@ -0,0 +1,224 @@
1
+ 'use client'
2
+
3
+ import { useRef, useCallback, useMemo } from 'react'
4
+ import Editor, { OnMount, OnChange, loader } from '@monaco-editor/react'
5
+ import type { editor } from 'monaco-editor'
6
+
7
+ // Configure Monaco to use CDN
8
+ loader.config({
9
+ paths: {
10
+ vs: 'https://cdn.jsdelivr.net/npm/monaco-editor@0.45.0/min/vs',
11
+ },
12
+ })
13
+
14
+ export type SupportedLanguage =
15
+ | 'json'
16
+ | 'xml'
17
+ | 'html'
18
+ | 'plaintext'
19
+ | 'javascript'
20
+ | 'typescript'
21
+ | 'shell'
22
+ | 'python'
23
+ | 'go'
24
+ | 'java'
25
+ | 'csharp'
26
+ | 'ruby'
27
+ | 'php'
28
+ | 'swift'
29
+ | 'kotlin'
30
+ | 'rust'
31
+ | 'c'
32
+ | 'powershell'
33
+ | 'clojure'
34
+ | 'objective-c'
35
+ | 'r'
36
+
37
+ interface CodeEditorProps {
38
+ value: string
39
+ onChange?: (value: string) => void
40
+ language?: SupportedLanguage
41
+ readOnly?: boolean
42
+ height?: string | number
43
+ minHeight?: number
44
+ maxHeight?: number
45
+ className?: string
46
+ placeholder?: string
47
+ theme?: 'light' | 'dark'
48
+ showBorder?: boolean
49
+ rounded?: boolean
50
+ showLineNumbers?: boolean
51
+ }
52
+
53
+ // Helper to format JSON properly
54
+ function formatValue(value: string, language: string): string {
55
+ if (language === 'json') {
56
+ try {
57
+ // Try to parse and re-stringify with proper formatting
58
+ const parsed = JSON.parse(value)
59
+ return JSON.stringify(parsed, null, 2)
60
+ } catch {
61
+ // If it's not valid JSON, return as-is
62
+ return value
63
+ }
64
+ }
65
+ return value
66
+ }
67
+
68
+ // Calculate height based on content lines
69
+ function calculateHeight(value: string, minHeight: number, maxHeight?: number): number {
70
+ const lineHeight = 20 // Approximate line height in pixels
71
+ const padding = 24 // Top + bottom padding
72
+ const lines = value.split('\n').length
73
+ const contentHeight = (lines * lineHeight) + padding
74
+
75
+ let height = Math.max(contentHeight, minHeight)
76
+ if (maxHeight) {
77
+ height = Math.min(height, maxHeight)
78
+ }
79
+ return height
80
+ }
81
+
82
+ export function CodeEditor({
83
+ value,
84
+ onChange,
85
+ language = 'json',
86
+ readOnly = false,
87
+ height = '100%',
88
+ minHeight = 100,
89
+ maxHeight,
90
+ className = '',
91
+ placeholder,
92
+ theme = 'light',
93
+ showBorder = true,
94
+ rounded = true,
95
+ showLineNumbers = true,
96
+ }: CodeEditorProps) {
97
+ const editorRef = useRef<editor.IStandaloneCodeEditor | null>(null)
98
+
99
+ // Format value for display
100
+ const formattedValue = useMemo(() => formatValue(value, language), [value, language])
101
+
102
+ const handleMount: OnMount = useCallback((editor) => {
103
+ editorRef.current = editor
104
+ }, [])
105
+
106
+ const handleChange: OnChange = useCallback(
107
+ (newValue) => {
108
+ if (onChange && newValue !== undefined) {
109
+ onChange(newValue)
110
+ }
111
+ },
112
+ [onChange]
113
+ )
114
+
115
+ const monacoTheme = theme === 'dark' ? 'vs-dark' : 'vs'
116
+ const bgColor = theme === 'dark' ? '!bg-[#1e1e1e]' : 'bg-white'
117
+
118
+ // Calculate the actual height for Monaco
119
+ const computedHeight = height === 'auto'
120
+ ? calculateHeight(formattedValue, minHeight, maxHeight)
121
+ : (typeof height === 'number' ? height : height)
122
+
123
+ const borderClass = showBorder ? 'border border-border' : ''
124
+ const roundedClass = rounded ? 'rounded-sm' : ''
125
+
126
+ const inlineStyle = {
127
+ height: typeof computedHeight === 'number' ? `${computedHeight}px` : computedHeight,
128
+ backgroundColor: theme === 'dark' ? '#1e1e1e' : undefined,
129
+ }
130
+
131
+ return (
132
+ <div
133
+ className={`relative overflow-hidden ${borderClass} ${roundedClass} ${bgColor} ${className}`}
134
+ style={inlineStyle}
135
+ >
136
+ {!formattedValue && placeholder && (
137
+ <div className="absolute inset-0 flex items-center justify-center text-gray-500 text-sm z-10 pointer-events-none">
138
+ {placeholder}
139
+ </div>
140
+ )}
141
+ <Editor
142
+ height="100%"
143
+ language={language}
144
+ value={formattedValue}
145
+ onChange={handleChange}
146
+ onMount={handleMount}
147
+ theme={monacoTheme}
148
+ options={{
149
+ readOnly,
150
+ domReadOnly: readOnly,
151
+ contextmenu: !readOnly,
152
+ minimap: { enabled: false },
153
+ scrollBeyondLastLine: false,
154
+ fontSize: 13,
155
+ fontFamily: "'JetBrains Mono', 'Fira Code', 'SF Mono', Consolas, monospace",
156
+ lineNumbers: showLineNumbers ? (readOnly ? 'on' : 'on') : 'off',
157
+ renderLineHighlight: readOnly ? 'none' : 'line',
158
+ scrollbar: {
159
+ vertical: 'auto',
160
+ horizontal: 'auto',
161
+ },
162
+ padding: { top: 12, bottom: 12 },
163
+ wordWrap: 'on',
164
+ automaticLayout: true,
165
+ overviewRulerBorder: false,
166
+ overviewRulerLanes: 0,
167
+ hideCursorInOverviewRuler: true,
168
+ guides: { indentation: !readOnly },
169
+ cursorBlinking: readOnly ? 'solid' : 'smooth',
170
+ lineDecorationsWidth: showLineNumbers ? 8 : 0,
171
+ lineNumbersMinChars: showLineNumbers ? 3 : 0,
172
+ }}
173
+ loading={
174
+ <div className="flex items-center justify-center h-full text-muted-foreground text-sm">
175
+ Loading editor...
176
+ </div>
177
+ }
178
+ />
179
+ </div>
180
+ )
181
+ }
182
+
183
+ // Lightweight read-only viewer version
184
+ interface CodeViewerProps {
185
+ value: string
186
+ language?: SupportedLanguage
187
+ height?: string | number
188
+ minHeight?: number
189
+ maxHeight?: number
190
+ className?: string
191
+ theme?: 'light' | 'dark'
192
+ showBorder?: boolean
193
+ rounded?: boolean
194
+ showLineNumbers?: boolean
195
+ }
196
+
197
+ export function CodeViewer({
198
+ value,
199
+ language = 'json',
200
+ height = 'auto',
201
+ minHeight = 100,
202
+ maxHeight,
203
+ className = '',
204
+ theme = 'light',
205
+ showBorder = false,
206
+ rounded = false,
207
+ showLineNumbers = true,
208
+ }: CodeViewerProps) {
209
+ return (
210
+ <CodeEditor
211
+ value={value}
212
+ language={language}
213
+ readOnly={true}
214
+ height={height}
215
+ minHeight={minHeight}
216
+ maxHeight={maxHeight}
217
+ className={className}
218
+ theme={theme}
219
+ showBorder={showBorder}
220
+ rounded={rounded}
221
+ showLineNumbers={showLineNumbers}
222
+ />
223
+ )
224
+ }
@@ -0,0 +1,387 @@
1
+ 'use client'
2
+
3
+ import React, { useState, useMemo, useCallback, useEffect } from 'react'
4
+ import { Copy, Check, Spinner, Code, MagnifyingGlass } from '@phosphor-icons/react'
5
+ import {
6
+ Select,
7
+ SelectContent,
8
+ SelectGroup,
9
+ SelectItem,
10
+ SelectLabel,
11
+ SelectTrigger,
12
+ SelectValue,
13
+ } from '@/components/ui/select'
14
+ import { Button } from '@/components/ui/button'
15
+ import { Input } from '@/components/ui/input'
16
+ import {
17
+ Tooltip,
18
+ TooltipContent,
19
+ TooltipProvider,
20
+ TooltipTrigger,
21
+ } from '@/components/ui/tooltip'
22
+ import { CodeViewer, type SupportedLanguage } from './code-editor'
23
+ import {
24
+ generateCodeAsync,
25
+ getCodegenByCategory,
26
+ getMonacoLanguage,
27
+ type CodegenName,
28
+ } from '@/lib/api-docs/codegen'
29
+ import type { BrainfishRESTRequest } from '@/lib/api-docs/types'
30
+
31
+ interface CodeSnippetProps {
32
+ request: BrainfishRESTRequest
33
+ defaultLanguage?: CodegenName
34
+ className?: string
35
+ }
36
+
37
+ export function CodeSnippet({
38
+ request,
39
+ defaultLanguage = 'shell-curl',
40
+ className = '',
41
+ }: CodeSnippetProps) {
42
+ const [selectedLanguage, setSelectedLanguage] = useState<CodegenName>(defaultLanguage)
43
+ const [copied, setCopied] = useState(false)
44
+ const [searchQuery, setSearchQuery] = useState('')
45
+ const [generatedCode, setGeneratedCode] = useState<string>('// Loading...')
46
+ const [isLoading, setIsLoading] = useState(true)
47
+
48
+ // Get codegen definitions grouped by category
49
+ const codegenByCategory = useMemo(() => getCodegenByCategory(), [])
50
+
51
+ // Filter definitions based on search
52
+ const filteredCategories = useMemo(() => {
53
+ if (!searchQuery) return codegenByCategory
54
+
55
+ const filtered: typeof codegenByCategory = {}
56
+ const query = searchQuery.toLowerCase()
57
+
58
+ for (const [category, definitions] of Object.entries(codegenByCategory)) {
59
+ const matchedDefs = definitions.filter(
60
+ (def) =>
61
+ def.caption.toLowerCase().includes(query) ||
62
+ def.category.toLowerCase().includes(query) ||
63
+ def.lang.toLowerCase().includes(query)
64
+ )
65
+ if (matchedDefs.length > 0) {
66
+ filtered[category] = matchedDefs
67
+ }
68
+ }
69
+
70
+ return filtered
71
+ }, [codegenByCategory, searchQuery])
72
+
73
+ // Generate code async when language or request changes
74
+ useEffect(() => {
75
+ let cancelled = false
76
+ setIsLoading(true)
77
+
78
+ generateCodeAsync(selectedLanguage, request).then((result) => {
79
+ if (!cancelled) {
80
+ setGeneratedCode(result.success ? result.code || '' : `// Error: ${result.error}`)
81
+ setIsLoading(false)
82
+ }
83
+ })
84
+
85
+ return () => {
86
+ cancelled = true
87
+ }
88
+ }, [selectedLanguage, request])
89
+
90
+ // Get Monaco language for syntax highlighting
91
+ const monacoLanguage = useMemo(
92
+ () => getMonacoLanguage(selectedLanguage),
93
+ [selectedLanguage]
94
+ )
95
+
96
+ // Handle copy to clipboard
97
+ const handleCopy = useCallback(async () => {
98
+ try {
99
+ await navigator.clipboard.writeText(generatedCode)
100
+ setCopied(true)
101
+ setTimeout(() => setCopied(false), 2000)
102
+ } catch (err) {
103
+ console.error('Failed to copy:', err)
104
+ }
105
+ }, [generatedCode])
106
+
107
+ // Get current language display name
108
+ const currentLanguageDisplay = useMemo(() => {
109
+ for (const definitions of Object.values(codegenByCategory)) {
110
+ const found = definitions.find((def) => def.name === selectedLanguage)
111
+ if (found) {
112
+ return `${found.category} - ${found.caption}`
113
+ }
114
+ }
115
+ return selectedLanguage
116
+ }, [codegenByCategory, selectedLanguage])
117
+
118
+ return (
119
+ <div className={`flex flex-col h-full ${className}`}>
120
+ {/* Header */}
121
+ <div className="flex items-center justify-between gap-2 border-b border-border bg-muted/30 px-4 py-2">
122
+ <div className="flex items-center gap-2 flex-1">
123
+ <Code size={16} className="text-muted-foreground" />
124
+ <span className="text-sm font-medium text-muted-foreground">Code Snippet</span>
125
+ </div>
126
+
127
+ {/* Language Selector */}
128
+ <Select
129
+ value={selectedLanguage}
130
+ onValueChange={(value) => setSelectedLanguage(value as CodegenName)}
131
+ >
132
+ <SelectTrigger className="w-[200px] h-8 text-xs">
133
+ <SelectValue placeholder="Select language">
134
+ {currentLanguageDisplay}
135
+ </SelectValue>
136
+ </SelectTrigger>
137
+ <SelectContent className="max-h-[300px]">
138
+ {/* Search */}
139
+ <div className="sticky top-0 bg-popover p-2 border-b border-border">
140
+ <div className="relative">
141
+ <MagnifyingGlass
142
+ size={14}
143
+ className="absolute left-2 top-1/2 -translate-y-1/2 text-muted-foreground"
144
+ />
145
+ <Input
146
+ placeholder="Search languages..."
147
+ value={searchQuery}
148
+ onChange={(e) => setSearchQuery(e.target.value)}
149
+ className="h-7 pl-7 text-xs"
150
+ />
151
+ </div>
152
+ </div>
153
+
154
+ {/* Grouped languages */}
155
+ {Object.entries(filteredCategories).map(([category, definitions]) => (
156
+ <SelectGroup key={category}>
157
+ <SelectLabel className="text-xs text-muted-foreground font-medium px-2 py-1">
158
+ {category}
159
+ </SelectLabel>
160
+ {definitions.map((def) => (
161
+ <SelectItem
162
+ key={def.name}
163
+ value={def.name}
164
+ className="text-xs pl-4"
165
+ >
166
+ <div className="flex items-center gap-2">
167
+ <span>{def.caption}</span>
168
+ {def.name === selectedLanguage && (
169
+ <Check size={12} className="text-primary" />
170
+ )}
171
+ </div>
172
+ </SelectItem>
173
+ ))}
174
+ </SelectGroup>
175
+ ))}
176
+
177
+ {Object.keys(filteredCategories).length === 0 && (
178
+ <div className="p-4 text-center text-sm text-muted-foreground">
179
+ No languages found for &ldquo;{searchQuery}&rdquo;
180
+ </div>
181
+ )}
182
+ </SelectContent>
183
+ </Select>
184
+
185
+ {/* Copy Button */}
186
+ <TooltipProvider>
187
+ <Tooltip>
188
+ <TooltipTrigger asChild>
189
+ <Button
190
+ variant="ghost"
191
+ size="icon"
192
+ className="h-8 w-8"
193
+ onClick={handleCopy}
194
+ disabled={isLoading}
195
+ >
196
+ {copied ? (
197
+ <Check size={16} className="text-green-500" />
198
+ ) : (
199
+ <Copy size={16} />
200
+ )}
201
+ </Button>
202
+ </TooltipTrigger>
203
+ <TooltipContent>
204
+ <p>{copied ? 'Copied!' : 'Copy to clipboard'}</p>
205
+ </TooltipContent>
206
+ </Tooltip>
207
+ </TooltipProvider>
208
+ </div>
209
+
210
+ {/* Code Display */}
211
+ <div className="flex-1 min-h-0 relative">
212
+ {isLoading && (
213
+ <div className="absolute inset-0 flex items-center justify-center bg-background/80 z-10">
214
+ <Spinner size={24} className="animate-spin text-muted-foreground" />
215
+ </div>
216
+ )}
217
+ <CodeViewer
218
+ value={generatedCode}
219
+ language={monacoLanguage as SupportedLanguage}
220
+ height="100%"
221
+ theme="dark"
222
+ showLineNumbers={false}
223
+ className="border-0"
224
+ />
225
+ </div>
226
+ </div>
227
+ )
228
+ }
229
+
230
+ /**
231
+ * Compact version for sidebar - styled like the reference image
232
+ */
233
+ interface CodeSnippetCompactProps {
234
+ request: BrainfishRESTRequest
235
+ }
236
+
237
+ // Method color mapping
238
+ const methodColors: Record<string, string> = {
239
+ GET: 'text-green-400',
240
+ POST: 'text-blue-400',
241
+ PUT: 'text-orange-400',
242
+ PATCH: 'text-yellow-400',
243
+ DELETE: 'text-red-400',
244
+ HEAD: 'text-purple-400',
245
+ OPTIONS: 'text-gray-400',
246
+ }
247
+
248
+ export function CodeSnippetCompact({ request }: CodeSnippetCompactProps) {
249
+ const [selectedLanguage, setSelectedLanguage] = useState<CodegenName>('shell-curl')
250
+ const [copied, setCopied] = useState(false)
251
+ const [generatedCode, setGeneratedCode] = useState<string>('// Loading...')
252
+ const [isLoading, setIsLoading] = useState(true)
253
+
254
+ const codegenByCategory = useMemo(() => getCodegenByCategory(), [])
255
+
256
+ // Generate code async when language or request changes
257
+ useEffect(() => {
258
+ let cancelled = false
259
+ setIsLoading(true)
260
+
261
+ generateCodeAsync(selectedLanguage, request).then((result) => {
262
+ if (!cancelled) {
263
+ setGeneratedCode(result.success ? result.code || '' : `// Error: ${result.error}`)
264
+ setIsLoading(false)
265
+ }
266
+ })
267
+
268
+ return () => {
269
+ cancelled = true
270
+ }
271
+ }, [selectedLanguage, request])
272
+
273
+ const monacoLanguage = useMemo(
274
+ () => getMonacoLanguage(selectedLanguage),
275
+ [selectedLanguage]
276
+ )
277
+
278
+ const handleCopy = useCallback(async () => {
279
+ try {
280
+ await navigator.clipboard.writeText(generatedCode)
281
+ setCopied(true)
282
+ setTimeout(() => setCopied(false), 2000)
283
+ } catch (err) {
284
+ console.error('Failed to copy:', err)
285
+ }
286
+ }, [generatedCode])
287
+
288
+ const currentCaption = useMemo(() => {
289
+ for (const definitions of Object.values(codegenByCategory)) {
290
+ const found = definitions.find((def) => def.name === selectedLanguage)
291
+ if (found) return `${found.category} ${found.caption}`
292
+ }
293
+ return 'Shell Curl'
294
+ }, [codegenByCategory, selectedLanguage])
295
+
296
+ // Get shortened endpoint path (decode URL-encoded characters like <<id>>)
297
+ const endpointPath = useMemo(() => {
298
+ try {
299
+ const url = new URL(request.endpoint)
300
+ // Decode URL-encoded characters to show original path placeholders like <<id>>
301
+ return decodeURIComponent(url.pathname)
302
+ } catch {
303
+ return request.endpoint
304
+ }
305
+ }, [request.endpoint])
306
+
307
+ return (
308
+ <div className="border-b border-border">
309
+ {/* Dark code block container */}
310
+ <div className="bg-[#1e1e1e] overflow-hidden">
311
+ {/* Header with method, path, and language selector */}
312
+ <div className="flex items-center justify-between px-4 py-2 border-b border-[#333]">
313
+ <div className="flex items-center gap-2 font-mono text-sm">
314
+ <span className={`font-semibold ${methodColors[request.method] || 'text-gray-400'}`}>
315
+ {request.method}
316
+ </span>
317
+ <span className="text-gray-300">{endpointPath}</span>
318
+ </div>
319
+
320
+ {/* Language Selector */}
321
+ <Select
322
+ value={selectedLanguage}
323
+ onValueChange={(value) => setSelectedLanguage(value as CodegenName)}
324
+ >
325
+ <SelectTrigger className="h-7 w-auto gap-1 border-0 bg-transparent text-gray-300 text-xs hover:bg-[#333] focus:ring-0 focus:ring-offset-0">
326
+ <SelectValue>{currentCaption}</SelectValue>
327
+ </SelectTrigger>
328
+ <SelectContent className="max-h-[300px]">
329
+ {Object.entries(codegenByCategory).map(([category, definitions]) => (
330
+ <SelectGroup key={category}>
331
+ <SelectLabel className="text-xs">{category}</SelectLabel>
332
+ {definitions.map((def) => (
333
+ <SelectItem key={def.name} value={def.name} className="text-xs">
334
+ {def.caption}
335
+ </SelectItem>
336
+ ))}
337
+ </SelectGroup>
338
+ ))}
339
+ </SelectContent>
340
+ </Select>
341
+ </div>
342
+
343
+ {/* Code Display */}
344
+ <div className="relative bg-[#1e1e1e] dark-editor">
345
+ {isLoading && (
346
+ <div className="absolute inset-0 flex items-center justify-center bg-[#1e1e1e]/80 z-10">
347
+ <Spinner size={20} className="animate-spin text-gray-400" />
348
+ </div>
349
+ )}
350
+ <CodeViewer
351
+ value={generatedCode}
352
+ language={monacoLanguage as SupportedLanguage}
353
+ height="auto"
354
+ minHeight={80}
355
+ maxHeight={200}
356
+ theme="dark"
357
+ showLineNumbers={false}
358
+ className="!bg-[#1e1e1e]"
359
+ />
360
+ </div>
361
+ </div>
362
+
363
+ {/* Copy button row */}
364
+ <div className="flex justify-end px-2 py-1 bg-muted/30">
365
+ <Button
366
+ variant="ghost"
367
+ size="sm"
368
+ className="h-6 text-xs gap-1"
369
+ onClick={handleCopy}
370
+ disabled={isLoading}
371
+ >
372
+ {copied ? (
373
+ <>
374
+ <Check size={12} className="text-green-500" />
375
+ Copied
376
+ </>
377
+ ) : (
378
+ <>
379
+ <Copy size={12} />
380
+ Copy
381
+ </>
382
+ )}
383
+ </Button>
384
+ </div>
385
+ </div>
386
+ )
387
+ }