@vercel/geistdocs 1.25.1-canary.e417a18 → 1.25.1-canary.eec231d
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/dist/cli/index.js +1 -1
- package/dist/components/callout.d.ts.map +1 -1
- package/dist/components/callout.js +2 -2
- package/dist/components/command-prompt.d.ts.map +1 -1
- package/dist/components/command-prompt.js +15 -22
- package/dist/components/copy-prompt.d.ts +2 -1
- package/dist/components/copy-prompt.d.ts.map +1 -1
- package/dist/components/copy-prompt.js +2 -2
- package/dist/components/heading.d.ts +7 -0
- package/dist/components/heading.d.ts.map +1 -0
- package/dist/components/heading.js +14 -0
- package/dist/controls.d.ts.map +1 -1
- package/dist/controls.js +4 -3
- package/dist/internal/chat/context.d.ts +2 -0
- package/dist/internal/chat/context.d.ts.map +1 -1
- package/dist/internal/chat/context.js +24 -3
- package/dist/internal/chat/dots-spinner.d.ts.map +1 -1
- package/dist/internal/chat/dots-spinner.js +15 -9
- package/dist/internal/chat/loading-skeleton.d.ts +7 -0
- package/dist/internal/chat/loading-skeleton.d.ts.map +1 -0
- package/dist/internal/chat/loading-skeleton.js +46 -0
- package/dist/internal/chat/message.d.ts.map +1 -1
- package/dist/internal/chat/message.js +23 -3
- package/dist/internal/chat/shell.d.ts.map +1 -1
- package/dist/internal/chat/shell.js +10 -15
- package/dist/internal/chat/sources.d.ts.map +1 -1
- package/dist/internal/chat/sources.js +4 -1
- package/dist/internal/navbar/desktop-menu.js +1 -1
- package/dist/internal/navbar/mobile-menu.d.ts.map +1 -1
- package/dist/internal/navbar/mobile-menu.js +8 -13
- package/dist/internal/page-actions-client.d.ts.map +1 -1
- package/dist/internal/page-actions-client.js +36 -32
- package/dist/internal/provider-client.d.ts.map +1 -1
- package/dist/internal/provider-client.js +39 -5
- package/dist/internal/sidebar-responsive.d.ts +0 -1
- package/dist/internal/sidebar-responsive.d.ts.map +1 -1
- package/dist/internal/sidebar-responsive.js +0 -9
- package/dist/internal/sidebar.d.ts.map +1 -1
- package/dist/internal/sidebar.js +50 -25
- package/dist/internal/table-of-contents.d.ts.map +1 -1
- package/dist/internal/table-of-contents.js +1 -1
- package/dist/internal/toc-items.d.ts.map +1 -1
- package/dist/internal/toc-items.js +16 -6
- package/dist/internal/ui/dropdown-menu.js +6 -6
- package/dist/internal/ui/navigation-menu.js +2 -2
- package/dist/internal/use-mobile.d.ts.map +1 -1
- package/dist/internal/use-mobile.js +2 -12
- package/dist/layout.d.ts +1 -0
- package/dist/layout.d.ts.map +1 -1
- package/dist/layout.js +2 -0
- package/dist/mdx.d.ts.map +1 -1
- package/dist/mdx.js +9 -4
- package/dist/pages/docs.d.ts.map +1 -1
- package/dist/pages/docs.js +6 -4
- package/dist/routes/chat.d.ts +1 -1
- package/dist/routes/chat.js +1 -1
- package/dist/versions.js +2 -2
- package/docs/agents.md +1 -1
- package/docs/llms.txt +79 -7
- package/docs/manifest.json +1 -1
- package/docs/pages/ask-ai.md +2 -2
- package/docs/pages/md.md +1 -1
- package/docs/pages/syntax.md +75 -3
- package/package.json +2 -1
- package/template/app/[lang]/layout.tsx +4 -0
- package/template/app/styles/geistdocs.css +1 -1
- package/template/components/ui/button.tsx +1 -1
- package/template/content/docs/ask-ai.cn.mdx +2 -2
- package/template/content/docs/ask-ai.mdx +2 -2
- package/template/content/docs/md.mdx +1 -1
- package/template/content/docs/syntax.mdx +80 -3
- package/template/package.json +1 -1
- package/theme.css +7 -0
|
@@ -114,6 +114,73 @@ Callouts can also contain a title and lists:
|
|
|
114
114
|
- The `Pages Router` uses the React version from your `package.json`.
|
|
115
115
|
</Callout>
|
|
116
116
|
|
|
117
|
+
Callouts support rich inline Markdown, including code, emphasis, and links:
|
|
118
|
+
|
|
119
|
+
```mdx
|
|
120
|
+
<Callout title="Good to know">
|
|
121
|
+
Global styles can be imported into any layout, page, or component inside the
|
|
122
|
+
`app` directory. However, since Next.js uses React's built-in support for
|
|
123
|
+
stylesheets to integrate with Suspense, this currently does not remove
|
|
124
|
+
stylesheets as you navigate between routes which can lead to conflicts. We
|
|
125
|
+
recommend using global styles for _truly global_ CSS (like Tailwind's base
|
|
126
|
+
styles), [Tailwind CSS](https://tailwindcss.com) for component styling, and
|
|
127
|
+
[CSS Modules](https://nextjs.org/docs/app/getting-started/css#css-modules) for
|
|
128
|
+
custom scoped CSS when needed.
|
|
129
|
+
</Callout>
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
This renders as:
|
|
133
|
+
|
|
134
|
+
<Callout title="Good to know">
|
|
135
|
+
Global styles can be imported into any layout, page, or component inside the
|
|
136
|
+
`app` directory. However, since Next.js uses React's built-in support for
|
|
137
|
+
stylesheets to integrate with Suspense, this currently does not remove
|
|
138
|
+
stylesheets as you navigate between routes which can lead to conflicts. We
|
|
139
|
+
recommend using global styles for _truly global_ CSS (like Tailwind's base
|
|
140
|
+
styles), [Tailwind CSS](https://tailwindcss.com) for component styling, and
|
|
141
|
+
[CSS Modules](https://nextjs.org/docs/app/getting-started/css#css-modules) for
|
|
142
|
+
custom scoped CSS when needed.
|
|
143
|
+
</Callout>
|
|
144
|
+
|
|
145
|
+
### Copy Prompts
|
|
146
|
+
|
|
147
|
+
Short prompts render in full without an expansion control:
|
|
148
|
+
|
|
149
|
+
```mdx
|
|
150
|
+
<CopyPrompt text="Summarize this documentation page and list the key concepts.">
|
|
151
|
+
Summarize this documentation page and list the key concepts.
|
|
152
|
+
</CopyPrompt>
|
|
153
|
+
```
|
|
154
|
+
|
|
155
|
+
This renders as:
|
|
156
|
+
|
|
157
|
+
<CopyPrompt text="Summarize this documentation page and list the key concepts.">
|
|
158
|
+
Summarize this documentation page and list the key concepts.
|
|
159
|
+
</CopyPrompt>
|
|
160
|
+
|
|
161
|
+
Long prompts initially show a preview with a **Show more** control:
|
|
162
|
+
|
|
163
|
+
```mdx
|
|
164
|
+
<CopyPrompt collapsible text="Write a detailed migration plan for this project.">
|
|
165
|
+
Write a detailed migration plan for this project. Include prerequisites,
|
|
166
|
+
implementation steps, validation, rollback guidance, and common pitfalls.
|
|
167
|
+
</CopyPrompt>
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
Set the boolean `collapsible` prop when the prompt should initially render as a
|
|
171
|
+
two-line preview. This renders as:
|
|
172
|
+
|
|
173
|
+
<CopyPrompt collapsible text="Review this Geistdocs project in detail. Explain how the @vercel/geistdocs package, application layouts, local adapter files, source configuration, content/docs directory, navigation metadata, MDX components, syntax highlighting, search routes, and deployment configuration work together. Then identify the safest first files to edit, describe the effect of each change, call out common mistakes, and propose a step-by-step plan for customizing the documentation site without breaking routing, generated Markdown, or accessibility behavior.">
|
|
174
|
+
Review this Geistdocs project in detail. Explain how the `@vercel/geistdocs`
|
|
175
|
+
package, application layouts, local adapter files, source configuration,
|
|
176
|
+
`content/docs` directory, navigation metadata, MDX components, syntax
|
|
177
|
+
highlighting, search routes, and deployment configuration work together.
|
|
178
|
+
Then identify the safest first files to edit, describe the effect of each
|
|
179
|
+
change, call out common mistakes, and propose a step-by-step plan for
|
|
180
|
+
customizing the documentation site without breaking routing, generated
|
|
181
|
+
Markdown, or accessibility behavior.
|
|
182
|
+
</CopyPrompt>
|
|
183
|
+
|
|
117
184
|
### Links
|
|
118
185
|
|
|
119
186
|
Create links with `[text](url)`:
|
|
@@ -121,15 +188,25 @@ Create links with `[text](url)`:
|
|
|
121
188
|
- [External link](https://vercel.com)
|
|
122
189
|
- [Internal link](/docs/getting-started)
|
|
123
190
|
|
|
124
|
-
Use an absolute `https://` or `http://` URL
|
|
125
|
-
|
|
126
|
-
|
|
191
|
+
Use an absolute `https://` or `http://` URL for an external destination. Use a
|
|
192
|
+
root-relative path beginning with `/` for an internal link. Both use the same
|
|
193
|
+
visual styling:
|
|
127
194
|
|
|
128
195
|
```md
|
|
129
196
|
[External link](https://vercel.com)
|
|
130
197
|
[Internal link](/docs/getting-started)
|
|
131
198
|
```
|
|
132
199
|
|
|
200
|
+
Links can also contain inline code:
|
|
201
|
+
|
|
202
|
+
```md
|
|
203
|
+
Run independent requests in parallel with [`Promise.all`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise/all).
|
|
204
|
+
```
|
|
205
|
+
|
|
206
|
+
This renders as:
|
|
207
|
+
|
|
208
|
+
Run independent requests in parallel with [`Promise.all`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise/all).
|
|
209
|
+
|
|
133
210
|
### Images
|
|
134
211
|
|
|
135
212
|
Add images with ``:
|
package/template/package.json
CHANGED
|
@@ -19,7 +19,7 @@
|
|
|
19
19
|
"@vercel/analytics": "^1.6.1",
|
|
20
20
|
"@vercel/geistcn": "1.0.3",
|
|
21
21
|
"@vercel/geistcn-assets": "2.0.1",
|
|
22
|
-
"@vercel/geistdocs": "1.25.1-canary.
|
|
22
|
+
"@vercel/geistdocs": "1.25.1-canary.eec231d",
|
|
23
23
|
"@vercel/speed-insights": "^1.3.1",
|
|
24
24
|
"ai": "^6.0.132",
|
|
25
25
|
"class-variance-authority": "^0.7.1",
|
package/theme.css
CHANGED
|
@@ -64,6 +64,13 @@ button:not(:disabled, [aria-disabled="true"]) {
|
|
|
64
64
|
@apply text-heading-40 tracking-tighter;
|
|
65
65
|
}
|
|
66
66
|
|
|
67
|
+
@media (width >= 80rem) {
|
|
68
|
+
#nd-page {
|
|
69
|
+
max-width: 780px;
|
|
70
|
+
transform: translateX(-20px);
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
|
|
67
74
|
@layer utilities {
|
|
68
75
|
.line-numbers code {
|
|
69
76
|
counter-reset: step;
|