@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
|
@@ -15,7 +15,7 @@ export function NavigationMenuItem({ className, ...props }) {
|
|
|
15
15
|
}
|
|
16
16
|
export const navigationMenuTriggerStyle = cva("group relative inline-flex w-max items-center justify-center gap-1 px-3 text-gray-900 text-sm transition-colors hover:text-gray-1000 focus:text-gray-1000 focus:outline-none disabled:pointer-events-none disabled:opacity-50 data-[active]:text-gray-1000 data-[state=open]:text-gray-1000");
|
|
17
17
|
export function NavigationMenuTrigger({ className, children, ...props }) {
|
|
18
|
-
return (_jsxs(NavigationMenuPrimitive.Trigger, { className: cn(navigationMenuTriggerStyle(), "group", className), "data-slot": "navigation-menu-trigger", ...props, children: [children, _jsx(IconChevronDownSmall, { "aria-hidden": "true", className: "ease relative top-px size-3.5 text-gray-900 transition-
|
|
18
|
+
return (_jsxs(NavigationMenuPrimitive.Trigger, { className: cn(navigationMenuTriggerStyle(), "group", className), "data-slot": "navigation-menu-trigger", ...props, children: [children, _jsx(IconChevronDownSmall, { "aria-hidden": "true", className: "ease relative top-px size-3.5 text-gray-900 transition-[transform,color] duration-200 group-hover:text-gray-1000 group-data-[state=open]:rotate-180" }), _jsx("div", { className: "absolute inset-x-0 bottom-0 z-50 -mx-12 hidden h-[18px] group-data-[state=open]:flex" })] }));
|
|
19
19
|
}
|
|
20
20
|
export function NavigationMenuContent({ className, ...props }) {
|
|
21
21
|
return (_jsx(NavigationMenuPrimitive.Content, { className: cn("data-[motion^=from-]:fade-in data-[motion^=to-]:fade-out top-0 left-0 w-full data-[motion^=from-]:animate-in data-[motion^=to-]:animate-out md:absolute md:w-auto", "group-data-[viewport=false]/navigation-menu:data-[state=closed]:fade-out-0 group-data-[viewport=false]/navigation-menu:data-[state=open]:fade-in-0 group-data-[viewport=false]/navigation-menu:data-[state=closed]:zoom-out-95 group-data-[viewport=false]/navigation-menu:data-[state=open]:zoom-in-95 **:data-[slot=navigation-menu-link]:focus:outline-none **:data-[slot=navigation-menu-link]:focus:ring-0 group-data-[viewport=false]/navigation-menu:top-full group-data-[viewport=false]/navigation-menu:mt-1.5 group-data-[viewport=false]/navigation-menu:overflow-hidden group-data-[viewport=false]/navigation-menu:rounded-lg group-data-[viewport=false]/navigation-menu:bg-background-100 group-data-[viewport=false]/navigation-menu:text-gray-1000 group-data-[viewport=false]/navigation-menu:shadow group-data-[viewport=false]/navigation-menu:duration-200 group-data-[viewport=false]/navigation-menu:data-[state=closed]:animate-out group-data-[viewport=false]/navigation-menu:data-[state=open]:animate-in", className), "data-slot": "navigation-menu-content", ...props }));
|
|
@@ -27,5 +27,5 @@ export function NavigationMenuLink({ className, ...props }) {
|
|
|
27
27
|
return (_jsx(NavigationMenuPrimitive.Link, { className: cn("block w-full text-sm outline-none transition-colors", className), "data-slot": "navigation-menu-link", ...props }));
|
|
28
28
|
}
|
|
29
29
|
export function NavigationMenuIndicator({ className, ...props }) {
|
|
30
|
-
return (_jsx(NavigationMenuPrimitive.Indicator, { className: cn("data-[state=hidden]:fade-out data-[state=visible]:fade-in top-[70%] z-[1] flex items-end justify-center overflow-hidden transition-
|
|
30
|
+
return (_jsx(NavigationMenuPrimitive.Indicator, { className: cn("data-[state=hidden]:fade-out data-[state=visible]:fade-in top-[70%] z-[1] flex items-end justify-center overflow-hidden transition-[transform,opacity] duration-200 data-[state=hidden]:animate-out data-[state=visible]:animate-in", className), "data-slot": "navigation-menu-indicator", ...props, children: _jsx("div", { className: "relative top-[6.5px] size-4 rotate-45 rounded-tl-sm border border-gray-200 border-r-0 border-b-0 bg-white" }) }));
|
|
31
31
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"use-mobile.d.ts","sourceRoot":"","sources":["../../src/internal/use-mobile.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,WAAW,
|
|
1
|
+
{"version":3,"file":"use-mobile.d.ts","sourceRoot":"","sources":["../../src/internal/use-mobile.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,WAAW,eAEvB,CAAC"}
|
|
@@ -1,16 +1,6 @@
|
|
|
1
1
|
"use client";
|
|
2
|
-
import {
|
|
2
|
+
import { useMediaQuery } from "phase/react";
|
|
3
3
|
const MOBILE_BREAKPOINT = 768;
|
|
4
4
|
export const useIsMobile = () => {
|
|
5
|
-
|
|
6
|
-
useEffect(() => {
|
|
7
|
-
const mql = window.matchMedia(`(max-width: ${MOBILE_BREAKPOINT - 1}px)`);
|
|
8
|
-
const onChange = () => {
|
|
9
|
-
setIsMobile(window.innerWidth < MOBILE_BREAKPOINT);
|
|
10
|
-
};
|
|
11
|
-
mql.addEventListener("change", onChange);
|
|
12
|
-
setIsMobile(window.innerWidth < MOBILE_BREAKPOINT);
|
|
13
|
-
return () => mql.removeEventListener("change", onChange);
|
|
14
|
-
}, []);
|
|
15
|
-
return !!isMobile;
|
|
5
|
+
return useMediaQuery(`(max-width: ${MOBILE_BREAKPOINT - 1}px)`);
|
|
16
6
|
};
|
package/dist/layout.d.ts
CHANGED
|
@@ -3,6 +3,7 @@ import type { ComponentProps, ReactNode } from "react";
|
|
|
3
3
|
import type { GeistdocsConfig } from "./config";
|
|
4
4
|
import { type GeistdocsSidebarMode } from "./sidebar";
|
|
5
5
|
export declare const GeistdocsProvider: (props: import("./internal/provider-client").GeistdocsProviderProps) => import("react/jsx-runtime").JSX.Element;
|
|
6
|
+
export declare const GeistdocsThemeScript: () => import("react/jsx-runtime").JSX.Element;
|
|
6
7
|
interface GeistdocsDocsLayoutProps {
|
|
7
8
|
children: ReactNode;
|
|
8
9
|
config: Pick<GeistdocsConfig, "defaultLanguage" | "translations">;
|
package/dist/layout.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../src/layout.tsx"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../src/layout.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,IAAI,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAIhD,OAAO,EAAE,KAAK,oBAAoB,EAA4B,MAAM,WAAW,CAAC;AAEhF,eAAO,MAAM,iBAAiB,iHAA0B,CAAC;AAEzD,eAAO,MAAM,oBAAoB,+CAEhC,CAAC;AAEF,UAAU,wBAAwB;IAChC,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,iBAAiB,GAAG,cAAc,CAAC,CAAC;IAClE,cAAc,CAAC,EAAE,cAAc,CAAC,OAAO,kBAAkB,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC7E,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,IAAI,EAAE,cAAc,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;CACzD;AAED,eAAO,MAAM,mBAAmB,GAAI,sEAOjC,wBAAwB,4CAkC1B,CAAC"}
|
package/dist/layout.js
CHANGED
|
@@ -1,10 +1,12 @@
|
|
|
1
1
|
import { jsx as _jsx } from "react/jsx-runtime";
|
|
2
|
+
import { GeistThemeScript } from "@vercel/geistcn/core";
|
|
2
3
|
import { DocsLayout as FumadocsDocsLayout } from "fumadocs-ui/layouts/docs";
|
|
3
4
|
import { createGeistdocsI18n } from "./internal/i18n";
|
|
4
5
|
import { GeistdocsProvider as GeistdocsProviderClient } from "./internal/provider-client";
|
|
5
6
|
import { GeistdocsSidebar } from "./internal/sidebar";
|
|
6
7
|
import { GeistdocsSidebarProvider } from "./sidebar";
|
|
7
8
|
export const GeistdocsProvider = GeistdocsProviderClient;
|
|
9
|
+
export const GeistdocsThemeScript = () => (_jsx(GeistThemeScript, { storageKey: "geistdocs-theme" }));
|
|
8
10
|
export const GeistdocsDocsLayout = ({ config, containerProps, sidebarMode, sidebarTop, tree, children, }) => {
|
|
9
11
|
const { i18n } = createGeistdocsI18n(config);
|
|
10
12
|
return (_jsx(GeistdocsSidebarProvider, { children: _jsx(FumadocsDocsLayout, { containerProps: {
|
package/dist/mdx.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"mdx.d.ts","sourceRoot":"","sources":["../src/mdx.tsx"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"mdx.d.ts","sourceRoot":"","sources":["../src/mdx.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAsB/C,OAAO,EAGL,KAAK,4BAA4B,IAAI,mBAAmB,EAGzD,MAAM,iBAAiB,CAAC;AAEzB,eAAO,MAAM,2BAA2B,8EAAe,CAAC;AACxD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAAoB,CAAC;AAC5D,eAAO,MAAM,mBAAmB;;;;;;;gCAAa,CAAC;AAC9C,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;CAAa,CAAC;AAC1C,MAAM,MAAM,4BAA4B,GAAG,mBAAmB,CAAC;AAE/D,MAAM,MAAM,sBAAsB,GAAG,aAAa,CAAC;AAEnD,eAAO,MAAM,yBAAyB,GACpC,aAAa,sBAAsB,KAClC,sBAiDD,CAAC;AAEH,eAAO,MAAM,mBAAmB,GAC9B,aAAa,sBAAsB,KAClC,sBAA+D,CAAC;AAEnE,eAAO,MAAM,2BAA2B,GACtC,GAAG,eAAe,KAAK,CAAC,sBAAsB,GAAG,SAAS,CAAC,KAC1D,sBACkD,CAAC"}
|
package/dist/mdx.js
CHANGED
|
@@ -1,6 +1,5 @@
|
|
|
1
|
-
import { jsx as _jsx
|
|
1
|
+
import { jsx as _jsx } from "react/jsx-runtime";
|
|
2
2
|
import { cn } from "@vercel/geistcn/utils";
|
|
3
|
-
import { IconArrowUpRightSmall } from "@vercel/geistcn-assets/icons";
|
|
4
3
|
import { TypeTable } from "fumadocs-ui/components/type-table";
|
|
5
4
|
import defaultMdxComponents from "fumadocs-ui/mdx";
|
|
6
5
|
import { Blockquote } from "./components/blockquote";
|
|
@@ -8,6 +7,7 @@ import { Callout, CalloutContainer, CalloutDescription, CalloutTitle, } from "./
|
|
|
8
7
|
import { CodeBlock } from "./components/code-block";
|
|
9
8
|
import { CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, CompactCodeBlockTabs, } from "./components/code-block-tabs";
|
|
10
9
|
import { CopyPrompt } from "./components/copy-prompt";
|
|
10
|
+
import { Heading } from "./components/heading";
|
|
11
11
|
import { Mermaid } from "./components/mermaid";
|
|
12
12
|
import { Table } from "./components/table";
|
|
13
13
|
import { Video } from "./components/video";
|
|
@@ -17,13 +17,18 @@ export const defineGeistdocsSourceConfig = sourceConfig;
|
|
|
17
17
|
export const geistdocsFrontmatterSchema = frontmatterSchema;
|
|
18
18
|
export const geistdocsMetaSchema = metaSchema;
|
|
19
19
|
export const geistShikiTheme = shikiTheme;
|
|
20
|
-
const HTTP_URL = /^https?:\/\//;
|
|
21
20
|
export const getGeistdocsMDXComponents = (components) => ({
|
|
22
21
|
...defaultMdxComponents,
|
|
22
|
+
h1: (props) => _jsx(Heading, { as: "h1", ...props }),
|
|
23
|
+
h2: (props) => _jsx(Heading, { as: "h2", ...props }),
|
|
24
|
+
h3: (props) => _jsx(Heading, { as: "h3", ...props }),
|
|
25
|
+
h4: (props) => _jsx(Heading, { as: "h4", ...props }),
|
|
26
|
+
h5: (props) => _jsx(Heading, { as: "h5", ...props }),
|
|
27
|
+
h6: (props) => _jsx(Heading, { as: "h6", ...props }),
|
|
23
28
|
pre: CodeBlock,
|
|
24
29
|
blockquote: Blockquote,
|
|
25
30
|
table: Table,
|
|
26
|
-
a: ({ children, className, href, ...props }) => typeof href === "string" && href.startsWith("/") ? (_jsx(LocalizedLink, { className: cn("font-normal text-gray-1000! underline decoration-1 decoration-gray-700 underline-offset-4 hover:text-gray-1000! hover:decoration-gray-1000 hover:opacity-100!", className), href: href, ...props, children: children })) : (
|
|
31
|
+
a: ({ children, className, href, ...props }) => typeof href === "string" && href.startsWith("/") ? (_jsx(LocalizedLink, { className: cn("font-normal text-gray-1000! underline decoration-1 decoration-gray-700 underline-offset-4 hover:text-gray-1000! hover:decoration-gray-1000 hover:opacity-100!", className), href: href, ...props, children: children })) : (_jsx("a", { className: cn("font-normal text-gray-1000! underline decoration-1 decoration-gray-700 underline-offset-4 hover:text-gray-1000! hover:decoration-gray-1000 hover:opacity-100!", className), href: href, ...props, children: children })),
|
|
27
32
|
CodeBlockTabs,
|
|
28
33
|
CompactCodeBlockTabs,
|
|
29
34
|
CodeBlockTabsList,
|
package/dist/pages/docs.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/pages/docs.tsx"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/pages/docs.tsx"],"names":[],"mappings":"AAEA,OAAO,EAGL,QAAQ,IAAI,gBAAgB,EAE7B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAErC,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACtE,OAAO,EAAE,KAAK,eAAe,EAA+B,MAAM,WAAW,CAAC;AAa9E,OAAO,EACL,KAAK,2BAA2B,EAEjC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD,KAAK,YAAY,GAAG,qBAAqB,CAAC;AAC1C,KAAK,aAAa,GAAG,WAAW,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAChF,KAAK,iBAAiB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC9D,KAAK,YAAY,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;AACvC,KAAK,qBAAqB,GAAG,WAAW,CACtC,cAAc,CAAC,OAAO,gBAAgB,CAAC,CAAC,gBAAgB,CAAC,CAC1D,CAAC;AAEF,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,KAAK,WAAW,GACZ,aAAa,GACb,CAAC,CAAC,OAAO,EAAE;IACT,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;CACtB,KAAK,aAAa,CAAC,CAAC;AAEzB,KAAK,eAAe,GAAG,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AAEpE,UAAU,wBAAwB;IAChC,MAAM,CAAC,EAAE,OAAO,GAAG,eAAe,CAAC;CACpC;AAyBD,UAAU,cAAc;IACtB,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,UAAU,oBAAqB,SAAQ,cAAc;IACnD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,kBAAmB,SAAQ,oBAAoB;IACvD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,sBAAsB,GACjC,SAAS,6BAA6B,WACI,CAAC;AAE7C,UAAU,YAAa,SAAQ,2BAA2B;IACxD,IAAI,EAAE,aAAa,CAAC;QAAE,UAAU,CAAC,EAAE,aAAa,CAAA;KAAE,CAAC,CAAC;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,cAAc,CAAC,OAAO,gBAAgB,CAAC,CAAC,KAAK,CAAC,CAAC;CACrD;AAED,UAAU,qBAAqB;IAC7B,MAAM,EAAE,IAAI,CACV,eAAe,EACb,IAAI,GACJ,UAAU,GACV,UAAU,GACV,QAAQ,GACR,aAAa,GACb,QAAQ,GACR,SAAS,CACZ,CAAC;IACF,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC;IACzD,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,MAAM,CAAC;IACzD,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,MAAM,CAAC;IACjD,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,MAAM,CAAC;IAC7D,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE;QACnB,QAAQ,EAAE,QAAQ,CAAC;QACnB,IAAI,EAAE,aAAa,CAAC;QACpB,MAAM,EAAE,cAAc,CAAC;KACxB,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,SAAS,CAAC,EAAE,wBAAwB,CAAC;IACrC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE;QACpB,IAAI,EAAE,YAAY,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,aAAa,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;KACvB,KAAK,SAAS,CAAC;IAChB,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE;QACtB,IAAI,EAAE,YAAY,CAAC;QACnB,IAAI,EAAE,aAAa,CAAC;QACpB,MAAM,EAAE,YAAY,CAAC;KACtB,KAAK,YAAY,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,qBAAqB,CAAC,EAAE,cAAc,CACpC,OAAO,gBAAgB,CACxB,CAAC,uBAAuB,CAAC,CAAC;CAC5B;AAyCD,eAAO,MAAM,cAAc,GAAI,6LAe5B,qBAAqB;wBAoMnB;QACD,MAAM,EAAE,OAAO,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,CAAC;KACpD;;oCAcE;QACD,MAAM,EAAE,OAAO,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,CAAC;KACpD,KAAG,OAAO,CAAC,QAAQ,CAAC;CAwDtB,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;CAA4B,CAAC"}
|
package/dist/pages/docs.js
CHANGED
|
@@ -1,6 +1,5 @@
|
|
|
1
|
-
import { jsx as _jsx,
|
|
1
|
+
import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
|
|
2
2
|
import { cn } from "@vercel/geistcn/utils";
|
|
3
|
-
import { IconArrowUpRightSmall } from "@vercel/geistcn-assets/icons";
|
|
4
3
|
import Link from "fumadocs-core/link";
|
|
5
4
|
import { DocsBody as FumadocsDocsBody, DocsDescription as FumadocsDocsDescription, DocsPage as FumadocsDocsPage, DocsTitle as FumadocsDocsTitle, } from "fumadocs-ui/layouts/docs/page";
|
|
6
5
|
import { createRelativeLink } from "fumadocs-ui/mdx";
|
|
@@ -19,7 +18,7 @@ import { getPageRobots, } from "../page-visibility";
|
|
|
19
18
|
const HTTP_URL = /^https?:\/\//;
|
|
20
19
|
const PrefetchedDocsLink = ({ children, className, href, ...props }) => {
|
|
21
20
|
const external = typeof href === "string" && HTTP_URL.test(href);
|
|
22
|
-
return (
|
|
21
|
+
return (_jsx(Link, { ...props, className: cn("font-normal text-gray-1000! underline decoration-1 decoration-gray-700 underline-offset-4 hover:text-gray-1000! hover:decoration-gray-1000 hover:opacity-100!", className), href: href, prefetch: !external, children: children }));
|
|
23
22
|
};
|
|
24
23
|
export const resolvePageMarkdownUrl = (options) => resolveInternalPageMarkdownUrl(options);
|
|
25
24
|
const DocsTitle = ({ className, ...props }) => (_jsx(FumadocsDocsTitle, { className: cn("mb-4 text-balance", className), ...props }));
|
|
@@ -107,7 +106,10 @@ export const createDocsPage = ({ config, source, mdx, pageActions = createIntern
|
|
|
107
106
|
single: true,
|
|
108
107
|
...tableOfContent,
|
|
109
108
|
component: tocComponent,
|
|
110
|
-
}, tableOfContentPopover:
|
|
109
|
+
}, tableOfContentPopover: {
|
|
110
|
+
enabled: false,
|
|
111
|
+
...tableOfContentPopover,
|
|
112
|
+
}, toc: data.toc, children: [renderTop?.({
|
|
111
113
|
data,
|
|
112
114
|
markdown: markdown ?? "",
|
|
113
115
|
markdownUrl,
|
package/dist/routes/chat.d.ts
CHANGED
|
@@ -29,7 +29,7 @@ interface CreateChatRouteOptions {
|
|
|
29
29
|
* Accepts any AI SDK `LanguageModel`, including AI Gateway model strings
|
|
30
30
|
* such as `"xai/grok-4.5"`. Ignored in proxy and eve agent modes, where
|
|
31
31
|
* the external service selects the model. Defaults to
|
|
32
|
-
* `"openai/gpt-
|
|
32
|
+
* `"openai/gpt-5.6-sol"`.
|
|
33
33
|
*/
|
|
34
34
|
model?: LanguageModel;
|
|
35
35
|
proxy?: ChatProxyConfig;
|
package/dist/routes/chat.js
CHANGED
|
@@ -5,7 +5,7 @@ import { z } from "zod";
|
|
|
5
5
|
import { getPublicPath } from "../config";
|
|
6
6
|
import { buildEveAgentTranscript, capLastUserMessageText, getEveAgentSessionHandle, resolveEveAgentUrl, runEveAgentTurn, } from "../internal/eve-agent";
|
|
7
7
|
import { isPageVisibleForSurface } from "../page-visibility";
|
|
8
|
-
const DEFAULT_CHAT_MODEL = "openai/gpt-
|
|
8
|
+
const DEFAULT_CHAT_MODEL = "openai/gpt-5.6-sol";
|
|
9
9
|
const MAX_CONTEXT_CHARS = 1500;
|
|
10
10
|
const MAX_EVE_AGENT_MESSAGE_CHARS = 4000;
|
|
11
11
|
const MAX_PROXY_RELATED_PAGES = 5;
|
package/dist/versions.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
"use client";
|
|
2
2
|
import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
|
|
3
3
|
import { cn } from "@vercel/geistcn/utils";
|
|
4
|
-
import { IconArchive, IconBox, IconCheck,
|
|
4
|
+
import { IconArchive, IconBox, IconCheck, IconChevronDownSmall, } from "@vercel/geistcn-assets/icons";
|
|
5
5
|
import { usePathname, useRouter } from "next/navigation";
|
|
6
6
|
import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuTrigger, } from "./internal/ui/dropdown-menu";
|
|
7
7
|
import { resolveVersionSwitchPath, } from "./internal/version-paths.js";
|
|
@@ -73,7 +73,7 @@ export const GeistdocsRouteSelect = ({ ariaLabel = "Select route", className, cu
|
|
|
73
73
|
const currentDescription = currentItem
|
|
74
74
|
? getDescription({ active: true, item: currentItem })
|
|
75
75
|
: null;
|
|
76
|
-
return (_jsxs(DropdownMenu, { children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsxs("button", { "aria-label": ariaLabel, className: cn("group flex w-full items-center gap-2 rounded-md px-2 py-2 text-left outline-none transition-colors duration-150 ease-[cubic-bezier(0.175,0.885,0.32,1.1)] hover:bg-gray-alpha-100 focus-visible:shadow-[var(--ds-focus-ring)] active:bg-gray-alpha-300 data-[state=open]:bg-gray-alpha-100 motion-reduce:transition-none", className), type: "button", children: [currentItem ? renderIcon({ active: true, item: currentItem }) : null, _jsxs("span", { className: "min-w-0 flex-1", children: [_jsx("span", { className: "block truncate text-button-14 text-gray-1000", children: currentItem?.label ?? currentId }), currentDescription ? (_jsx("span", { className: "block truncate text-gray-900 text-label-13", children: currentDescription })) : null] }), _jsx(
|
|
76
|
+
return (_jsxs(DropdownMenu, { children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsxs("button", { "aria-label": ariaLabel, className: cn("group flex w-full items-center gap-2 rounded-md px-2 py-2 text-left outline-none transition-colors duration-150 ease-[cubic-bezier(0.175,0.885,0.32,1.1)] hover:bg-gray-alpha-100 focus-visible:shadow-[var(--ds-focus-ring)] active:bg-gray-alpha-300 data-[state=open]:bg-gray-alpha-100 motion-reduce:transition-none", className), type: "button", children: [currentItem ? renderIcon({ active: true, item: currentItem }) : null, _jsxs("span", { className: "min-w-0 flex-1", children: [_jsx("span", { className: "block truncate text-button-14 text-gray-1000", children: currentItem?.label ?? currentId }), currentDescription ? (_jsx("span", { className: "block truncate text-gray-900 text-label-13", children: currentDescription })) : null] }), _jsx(IconChevronDownSmall, { className: "size-4 shrink-0 text-gray-900 transition-transform duration-150 ease-[cubic-bezier(0.175,0.885,0.32,1.1)] group-data-[state=open]:rotate-180 motion-reduce:transition-none" })] }) }), _jsx(DropdownMenuContent, { align: "start", className: "w-(--radix-dropdown-menu-trigger-width) min-w-64 rounded-xl bg-background-100 p-1 shadow-(--ds-shadow-menu)", children: items.map((item) => {
|
|
77
77
|
const active = item.id === currentId;
|
|
78
78
|
const description = getDescription({ active, item });
|
|
79
79
|
return (_jsxs(DropdownMenuItem, { "aria-current": active ? "page" : undefined, className: "flex cursor-pointer items-center gap-2 rounded-md px-2 py-2", onSelect: () => navigateToItem(item), children: [renderIcon({ active, item }), _jsxs("span", { className: "min-w-0 flex-1", children: [_jsx("span", { className: "block truncate text-button-14 text-gray-1000", children: item.label }), description ? (_jsx("span", { className: "block truncate text-gray-900 text-label-13", children: description })) : null] }), active ? _jsx(IconCheck, { className: "size-4 text-blue-900" }) : null] }, item.id));
|
package/docs/agents.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Geistdocs Package Docs
|
|
2
2
|
|
|
3
|
-
These docs are bundled with `@vercel/geistdocs` 1.25.1-canary.
|
|
3
|
+
These docs are bundled with `@vercel/geistdocs` 1.25.1-canary.eec231d so agents can understand the installed package without web access.
|
|
4
4
|
They are generated from `apps/template/content/docs` during the package build.
|
|
5
5
|
|
|
6
6
|
## How to use these files
|
package/docs/llms.txt
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Geistdocs Package Documentation
|
|
2
2
|
|
|
3
|
-
These docs are bundled with `@vercel/geistdocs` 1.25.1-canary.
|
|
3
|
+
These docs are bundled with `@vercel/geistdocs` 1.25.1-canary.eec231d.
|
|
4
4
|
They describe how to build package-backed Geistdocs sites and how to use the package APIs from generated project adapters.
|
|
5
5
|
|
|
6
6
|
## Documentation Index
|
|
@@ -1302,6 +1302,68 @@ Callouts can also contain a title and lists:
|
|
|
1302
1302
|
package.json for tooling and ecosystem compatibility.
|
|
1303
1303
|
- The `Pages Router` uses the React version from your `package.json`.
|
|
1304
1304
|
|
|
1305
|
+
Callouts support rich inline Markdown, including code, emphasis, and links:
|
|
1306
|
+
|
|
1307
|
+
```mdx
|
|
1308
|
+
<Callout title="Good to know">
|
|
1309
|
+
Global styles can be imported into any layout, page, or component inside the
|
|
1310
|
+
`app` directory. However, since Next.js uses React's built-in support for
|
|
1311
|
+
stylesheets to integrate with Suspense, this currently does not remove
|
|
1312
|
+
stylesheets as you navigate between routes which can lead to conflicts. We
|
|
1313
|
+
recommend using global styles for _truly global_ CSS (like Tailwind's base
|
|
1314
|
+
styles), [Tailwind CSS](https://tailwindcss.com) for component styling, and
|
|
1315
|
+
[CSS Modules](https://nextjs.org/docs/app/getting-started/css#css-modules) for
|
|
1316
|
+
custom scoped CSS when needed.
|
|
1317
|
+
</Callout>
|
|
1318
|
+
```
|
|
1319
|
+
|
|
1320
|
+
This renders as:
|
|
1321
|
+
|
|
1322
|
+
> Note:
|
|
1323
|
+
Global styles can be imported into any layout, page, or component inside the
|
|
1324
|
+
`app` directory. However, since Next.js uses React's built-in support for
|
|
1325
|
+
stylesheets to integrate with Suspense, this currently does not remove
|
|
1326
|
+
stylesheets as you navigate between routes which can lead to conflicts. We
|
|
1327
|
+
recommend using global styles for _truly global_ CSS (like Tailwind's base
|
|
1328
|
+
styles), [Tailwind CSS](https://tailwindcss.com) for component styling, and
|
|
1329
|
+
[CSS Modules](https://nextjs.org/docs/app/getting-started/css#css-modules) for
|
|
1330
|
+
custom scoped CSS when needed.
|
|
1331
|
+
|
|
1332
|
+
### Copy Prompts
|
|
1333
|
+
|
|
1334
|
+
Short prompts render in full without an expansion control:
|
|
1335
|
+
|
|
1336
|
+
```mdx
|
|
1337
|
+
<CopyPrompt text="Summarize this documentation page and list the key concepts.">
|
|
1338
|
+
Summarize this documentation page and list the key concepts.
|
|
1339
|
+
</CopyPrompt>
|
|
1340
|
+
```
|
|
1341
|
+
|
|
1342
|
+
This renders as:
|
|
1343
|
+
|
|
1344
|
+
Summarize this documentation page and list the key concepts.
|
|
1345
|
+
|
|
1346
|
+
Long prompts initially show a preview with a **Show more** control:
|
|
1347
|
+
|
|
1348
|
+
```mdx
|
|
1349
|
+
<CopyPrompt collapsible text="Write a detailed migration plan for this project.">
|
|
1350
|
+
Write a detailed migration plan for this project. Include prerequisites,
|
|
1351
|
+
implementation steps, validation, rollback guidance, and common pitfalls.
|
|
1352
|
+
</CopyPrompt>
|
|
1353
|
+
```
|
|
1354
|
+
|
|
1355
|
+
Set the boolean `collapsible` prop when the prompt should initially render as a
|
|
1356
|
+
two-line preview. This renders as:
|
|
1357
|
+
|
|
1358
|
+
Review this Geistdocs project in detail. Explain how the `@vercel/geistdocs`
|
|
1359
|
+
package, application layouts, local adapter files, source configuration,
|
|
1360
|
+
`content/docs` directory, navigation metadata, MDX components, syntax
|
|
1361
|
+
highlighting, search routes, and deployment configuration work together.
|
|
1362
|
+
Then identify the safest first files to edit, describe the effect of each
|
|
1363
|
+
change, call out common mistakes, and propose a step-by-step plan for
|
|
1364
|
+
customizing the documentation site without breaking routing, generated
|
|
1365
|
+
Markdown, or accessibility behavior.
|
|
1366
|
+
|
|
1305
1367
|
### Links
|
|
1306
1368
|
|
|
1307
1369
|
Create links with `[text](url)`:
|
|
@@ -1309,15 +1371,25 @@ Create links with `[text](url)`:
|
|
|
1309
1371
|
- [External link](https://vercel.com)
|
|
1310
1372
|
- [Internal link](/docs/getting-started)
|
|
1311
1373
|
|
|
1312
|
-
Use an absolute `https://` or `http://` URL
|
|
1313
|
-
|
|
1314
|
-
|
|
1374
|
+
Use an absolute `https://` or `http://` URL for an external destination. Use a
|
|
1375
|
+
root-relative path beginning with `/` for an internal link. Both use the same
|
|
1376
|
+
visual styling:
|
|
1315
1377
|
|
|
1316
1378
|
```md
|
|
1317
1379
|
[External link](https://vercel.com)
|
|
1318
1380
|
[Internal link](/docs/getting-started)
|
|
1319
1381
|
```
|
|
1320
1382
|
|
|
1383
|
+
Links can also contain inline code:
|
|
1384
|
+
|
|
1385
|
+
```md
|
|
1386
|
+
Run independent requests in parallel with [`Promise.all`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise/all).
|
|
1387
|
+
```
|
|
1388
|
+
|
|
1389
|
+
This renders as:
|
|
1390
|
+
|
|
1391
|
+
Run independent requests in parallel with [`Promise.all`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise/all).
|
|
1392
|
+
|
|
1321
1393
|
### Images
|
|
1322
1394
|
|
|
1323
1395
|
Add images with ``:
|
|
@@ -2397,7 +2469,7 @@ The `.mdx` version returns:
|
|
|
2397
2469
|
|
|
2398
2470
|
For a docs section mounted at `/docs`, the section root remains `/docs.md`. For a source mounted at the app root with `baseUrl: "/"`, Geistdocs uses `/index.md` for the root page. If Next.js has `basePath: "/docs"`, that public root Markdown URL is `/docs/index.md`.
|
|
2399
2471
|
|
|
2400
|
-
Copy Page, View as Markdown, and the `text/markdown` metadata alternate all use the same package resolver. Use `createDocsPage({ getMarkdownUrl })` only when the deployment needs a different public contract.
|
|
2472
|
+
Copy Page, View as Markdown, and the `text/markdown` metadata alternate all use the same package resolver. View as Markdown opens the resolved `.md` URL in a new tab from a button, which keeps the URL shareable without adding an anchor to the page. Use `createDocsPage({ getMarkdownUrl })` only when the deployment needs a different public contract.
|
|
2401
2473
|
|
|
2402
2474
|
## Use cases
|
|
2403
2475
|
|
|
@@ -2729,7 +2801,7 @@ In this mode, Geistdocs uses the local `search_docs` tool during the AI SDK `str
|
|
|
2729
2801
|
|
|
2730
2802
|
#### Choose a model
|
|
2731
2803
|
|
|
2732
|
-
Pass the `model` option to `createChatRoute` to control which model answers Ask AI requests. It accepts any AI SDK `LanguageModel`, including AI Gateway model strings, and defaults to `openai/gpt-
|
|
2804
|
+
Pass the `model` option to `createChatRoute` to control which model answers Ask AI requests. It accepts any AI SDK `LanguageModel`, including AI Gateway model strings, and defaults to `openai/gpt-5.6-sol`.
|
|
2733
2805
|
|
|
2734
2806
|
```ts title="app/api/chat/route.ts"
|
|
2735
2807
|
import { createChatRoute } from "@vercel/geistdocs/routes/chat";
|
|
@@ -2838,7 +2910,7 @@ The chat interface adapts to different screen sizes:
|
|
|
2838
2910
|
|
|
2839
2911
|
The environment variables `AI_GATEWAY_API_KEY` and `NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL` must be set for the default AI Gateway mode. Set `GEISTDOCS_CHAT_PROXY_URL` to route Ask AI through a Vertex-backed proxy instead. You can read more in the [Environment Variables](/docs/env) section.
|
|
2840
2912
|
|
|
2841
|
-
In default AI Gateway mode, Geistdocs uses `openai/gpt-
|
|
2913
|
+
In default AI Gateway mode, Geistdocs uses `openai/gpt-5.6-sol` via the Vercel AI Gateway. In Vertex-backed proxy mode, the configured proxy controls the upstream model.
|
|
2842
2914
|
|
|
2843
2915
|
## Suggested Prompts
|
|
2844
2916
|
|
package/docs/manifest.json
CHANGED
package/docs/pages/ask-ai.md
CHANGED
|
@@ -93,7 +93,7 @@ In this mode, Geistdocs uses the local `search_docs` tool during the AI SDK `str
|
|
|
93
93
|
|
|
94
94
|
#### Choose a model
|
|
95
95
|
|
|
96
|
-
Pass the `model` option to `createChatRoute` to control which model answers Ask AI requests. It accepts any AI SDK `LanguageModel`, including AI Gateway model strings, and defaults to `openai/gpt-
|
|
96
|
+
Pass the `model` option to `createChatRoute` to control which model answers Ask AI requests. It accepts any AI SDK `LanguageModel`, including AI Gateway model strings, and defaults to `openai/gpt-5.6-sol`.
|
|
97
97
|
|
|
98
98
|
```ts title="app/api/chat/route.ts"
|
|
99
99
|
import { createChatRoute } from "@vercel/geistdocs/routes/chat";
|
|
@@ -202,7 +202,7 @@ The chat interface adapts to different screen sizes:
|
|
|
202
202
|
|
|
203
203
|
The environment variables `AI_GATEWAY_API_KEY` and `NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL` must be set for the default AI Gateway mode. Set `GEISTDOCS_CHAT_PROXY_URL` to route Ask AI through a Vertex-backed proxy instead. You can read more in the [Environment Variables](/docs/env) section.
|
|
204
204
|
|
|
205
|
-
In default AI Gateway mode, Geistdocs uses `openai/gpt-
|
|
205
|
+
In default AI Gateway mode, Geistdocs uses `openai/gpt-5.6-sol` via the Vercel AI Gateway. In Vertex-backed proxy mode, the configured proxy controls the upstream model.
|
|
206
206
|
|
|
207
207
|
## Suggested Prompts
|
|
208
208
|
|
package/docs/pages/md.md
CHANGED
|
@@ -39,7 +39,7 @@ The `.mdx` version returns:
|
|
|
39
39
|
|
|
40
40
|
For a docs section mounted at `/docs`, the section root remains `/docs.md`. For a source mounted at the app root with `baseUrl: "/"`, Geistdocs uses `/index.md` for the root page. If Next.js has `basePath: "/docs"`, that public root Markdown URL is `/docs/index.md`.
|
|
41
41
|
|
|
42
|
-
Copy Page, View as Markdown, and the `text/markdown` metadata alternate all use the same package resolver. Use `createDocsPage({ getMarkdownUrl })` only when the deployment needs a different public contract.
|
|
42
|
+
Copy Page, View as Markdown, and the `text/markdown` metadata alternate all use the same package resolver. View as Markdown opens the resolved `.md` URL in a new tab from a button, which keeps the URL shareable without adding an anchor to the page. Use `createDocsPage({ getMarkdownUrl })` only when the deployment needs a different public contract.
|
|
43
43
|
|
|
44
44
|
## Use cases
|
|
45
45
|
|
package/docs/pages/syntax.md
CHANGED
|
@@ -115,6 +115,68 @@ Callouts can also contain a title and lists:
|
|
|
115
115
|
package.json for tooling and ecosystem compatibility.
|
|
116
116
|
- The `Pages Router` uses the React version from your `package.json`.
|
|
117
117
|
|
|
118
|
+
Callouts support rich inline Markdown, including code, emphasis, and links:
|
|
119
|
+
|
|
120
|
+
```mdx
|
|
121
|
+
<Callout title="Good to know">
|
|
122
|
+
Global styles can be imported into any layout, page, or component inside the
|
|
123
|
+
`app` directory. However, since Next.js uses React's built-in support for
|
|
124
|
+
stylesheets to integrate with Suspense, this currently does not remove
|
|
125
|
+
stylesheets as you navigate between routes which can lead to conflicts. We
|
|
126
|
+
recommend using global styles for _truly global_ CSS (like Tailwind's base
|
|
127
|
+
styles), [Tailwind CSS](https://tailwindcss.com) for component styling, and
|
|
128
|
+
[CSS Modules](https://nextjs.org/docs/app/getting-started/css#css-modules) for
|
|
129
|
+
custom scoped CSS when needed.
|
|
130
|
+
</Callout>
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
This renders as:
|
|
134
|
+
|
|
135
|
+
> Note:
|
|
136
|
+
Global styles can be imported into any layout, page, or component inside the
|
|
137
|
+
`app` directory. However, since Next.js uses React's built-in support for
|
|
138
|
+
stylesheets to integrate with Suspense, this currently does not remove
|
|
139
|
+
stylesheets as you navigate between routes which can lead to conflicts. We
|
|
140
|
+
recommend using global styles for _truly global_ CSS (like Tailwind's base
|
|
141
|
+
styles), [Tailwind CSS](https://tailwindcss.com) for component styling, and
|
|
142
|
+
[CSS Modules](https://nextjs.org/docs/app/getting-started/css#css-modules) for
|
|
143
|
+
custom scoped CSS when needed.
|
|
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
|
+
Summarize this documentation page and list the key concepts.
|
|
158
|
+
|
|
159
|
+
Long prompts initially show a preview with a **Show more** control:
|
|
160
|
+
|
|
161
|
+
```mdx
|
|
162
|
+
<CopyPrompt collapsible text="Write a detailed migration plan for this project.">
|
|
163
|
+
Write a detailed migration plan for this project. Include prerequisites,
|
|
164
|
+
implementation steps, validation, rollback guidance, and common pitfalls.
|
|
165
|
+
</CopyPrompt>
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
Set the boolean `collapsible` prop when the prompt should initially render as a
|
|
169
|
+
two-line preview. This renders as:
|
|
170
|
+
|
|
171
|
+
Review this Geistdocs project in detail. Explain how the `@vercel/geistdocs`
|
|
172
|
+
package, application layouts, local adapter files, source configuration,
|
|
173
|
+
`content/docs` directory, navigation metadata, MDX components, syntax
|
|
174
|
+
highlighting, search routes, and deployment configuration work together.
|
|
175
|
+
Then identify the safest first files to edit, describe the effect of each
|
|
176
|
+
change, call out common mistakes, and propose a step-by-step plan for
|
|
177
|
+
customizing the documentation site without breaking routing, generated
|
|
178
|
+
Markdown, or accessibility behavior.
|
|
179
|
+
|
|
118
180
|
### Links
|
|
119
181
|
|
|
120
182
|
Create links with `[text](url)`:
|
|
@@ -122,15 +184,25 @@ Create links with `[text](url)`:
|
|
|
122
184
|
- [External link](https://vercel.com)
|
|
123
185
|
- [Internal link](/docs/getting-started)
|
|
124
186
|
|
|
125
|
-
Use an absolute `https://` or `http://` URL
|
|
126
|
-
|
|
127
|
-
|
|
187
|
+
Use an absolute `https://` or `http://` URL for an external destination. Use a
|
|
188
|
+
root-relative path beginning with `/` for an internal link. Both use the same
|
|
189
|
+
visual styling:
|
|
128
190
|
|
|
129
191
|
```md
|
|
130
192
|
[External link](https://vercel.com)
|
|
131
193
|
[Internal link](/docs/getting-started)
|
|
132
194
|
```
|
|
133
195
|
|
|
196
|
+
Links can also contain inline code:
|
|
197
|
+
|
|
198
|
+
```md
|
|
199
|
+
Run independent requests in parallel with [`Promise.all`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise/all).
|
|
200
|
+
```
|
|
201
|
+
|
|
202
|
+
This renders as:
|
|
203
|
+
|
|
204
|
+
Run independent requests in parallel with [`Promise.all`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise/all).
|
|
205
|
+
|
|
134
206
|
### Images
|
|
135
207
|
|
|
136
208
|
Add images with ``:
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@vercel/geistdocs",
|
|
3
3
|
"description": "Runtime and CLI for Geistdocs projects.",
|
|
4
|
-
"version": "1.25.1-canary.
|
|
4
|
+
"version": "1.25.1-canary.eec231d",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"repository": {
|
|
7
7
|
"type": "git",
|
|
@@ -209,6 +209,7 @@
|
|
|
209
209
|
"mermaid": "^11.12.2",
|
|
210
210
|
"motion": "^12.23.25",
|
|
211
211
|
"next-themes": "^0.4.6",
|
|
212
|
+
"phase": "^0.5.4",
|
|
212
213
|
"radix-ui": "1.6.4",
|
|
213
214
|
"react-player": "^3.4.0",
|
|
214
215
|
"remark-frontmatter": "^5.0.0",
|
|
@@ -3,6 +3,7 @@ import { geistFontClasses } from "@vercel/geistcn/core";
|
|
|
3
3
|
import { cn } from "@vercel/geistcn/utils";
|
|
4
4
|
import "@/lib/geistdocs/site-url-warning";
|
|
5
5
|
import { Footer } from "@vercel/geistdocs/footer";
|
|
6
|
+
import { GeistdocsThemeScript } from "@vercel/geistdocs/layout";
|
|
6
7
|
import { Navbar } from "@vercel/geistdocs/navbar";
|
|
7
8
|
import type { Metadata } from "next";
|
|
8
9
|
import { GeistdocsProvider } from "@/components/geistdocs/provider";
|
|
@@ -30,6 +31,9 @@ const Layout = async ({ children }: LayoutProps<"/[lang]">) => {
|
|
|
30
31
|
lang={lang}
|
|
31
32
|
suppressHydrationWarning
|
|
32
33
|
>
|
|
34
|
+
<head>
|
|
35
|
+
<GeistdocsThemeScript />
|
|
36
|
+
</head>
|
|
33
37
|
<body style={{ backgroundColor: "var(--ds-background-200)" }}>
|
|
34
38
|
<GeistdocsProvider basePath={config.basePath} lang={lang}>
|
|
35
39
|
<Navbar config={config} />
|
|
@@ -5,7 +5,7 @@ import { cva, type VariantProps } from "class-variance-authority"
|
|
|
5
5
|
import { cn } from "@/lib/utils"
|
|
6
6
|
|
|
7
7
|
const buttonVariants = cva(
|
|
8
|
-
"inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium transition-
|
|
8
|
+
"inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium transition-colors disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4 shrink-0 [&_svg]:shrink-0 outline-none focus-visible:border-gray-600 focus-visible:ring-gray-600/50 focus-visible:ring-[3px] aria-invalid:ring-red-800/20 dark:aria-invalid:ring-red-800/40 aria-invalid:border-red-800",
|
|
9
9
|
{
|
|
10
10
|
variants: {
|
|
11
11
|
variant: {
|
|
@@ -78,8 +78,8 @@ The chat interface adapts to different screen sizes:
|
|
|
78
78
|
|
|
79
79
|
The environment variables `AI_GATEWAY_API_KEY` and `NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL` must be set, which you can read more about in the [环境变量](/docs/env) section.
|
|
80
80
|
|
|
81
|
-
The model used is `openai/gpt-
|
|
81
|
+
The model used is `openai/gpt-5.6-sol` via the Vercel AI Gateway.
|
|
82
82
|
|
|
83
83
|
## 建议的提示
|
|
84
84
|
|
|
85
|
-
You can customize the initial suggested prompts shown to users. These are configured in the Geistdocs configuration file, which you can read more about in the [配置](/docs/configuration) section.
|
|
85
|
+
You can customize the initial suggested prompts shown to users. These are configured in the Geistdocs configuration file, which you can read more about in the [配置](/docs/configuration) section.
|
|
@@ -91,7 +91,7 @@ In this mode, Geistdocs uses the local `search_docs` tool during the AI SDK `str
|
|
|
91
91
|
|
|
92
92
|
#### Choose a model
|
|
93
93
|
|
|
94
|
-
Pass the `model` option to `createChatRoute` to control which model answers Ask AI requests. It accepts any AI SDK `LanguageModel`, including AI Gateway model strings, and defaults to `openai/gpt-
|
|
94
|
+
Pass the `model` option to `createChatRoute` to control which model answers Ask AI requests. It accepts any AI SDK `LanguageModel`, including AI Gateway model strings, and defaults to `openai/gpt-5.6-sol`.
|
|
95
95
|
|
|
96
96
|
```ts title="app/api/chat/route.ts"
|
|
97
97
|
import { createChatRoute } from "@vercel/geistdocs/routes/chat";
|
|
@@ -200,7 +200,7 @@ The chat interface adapts to different screen sizes:
|
|
|
200
200
|
|
|
201
201
|
The environment variables `AI_GATEWAY_API_KEY` and `NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL` must be set for the default AI Gateway mode. Set `GEISTDOCS_CHAT_PROXY_URL` to route Ask AI through a Vertex-backed proxy instead. You can read more in the [Environment Variables](/docs/env) section.
|
|
202
202
|
|
|
203
|
-
In default AI Gateway mode, Geistdocs uses `openai/gpt-
|
|
203
|
+
In default AI Gateway mode, Geistdocs uses `openai/gpt-5.6-sol` via the Vercel AI Gateway. In Vertex-backed proxy mode, the configured proxy controls the upstream model.
|
|
204
204
|
|
|
205
205
|
## Suggested Prompts
|
|
206
206
|
|
|
@@ -37,7 +37,7 @@ The `.mdx` version returns:
|
|
|
37
37
|
|
|
38
38
|
For a docs section mounted at `/docs`, the section root remains `/docs.md`. For a source mounted at the app root with `baseUrl: "/"`, Geistdocs uses `/index.md` for the root page. If Next.js has `basePath: "/docs"`, that public root Markdown URL is `/docs/index.md`.
|
|
39
39
|
|
|
40
|
-
Copy Page, View as Markdown, and the `text/markdown` metadata alternate all use the same package resolver. Use `createDocsPage({ getMarkdownUrl })` only when the deployment needs a different public contract.
|
|
40
|
+
Copy Page, View as Markdown, and the `text/markdown` metadata alternate all use the same package resolver. View as Markdown opens the resolved `.md` URL in a new tab from a button, which keeps the URL shareable without adding an anchor to the page. Use `createDocsPage({ getMarkdownUrl })` only when the deployment needs a different public contract.
|
|
41
41
|
|
|
42
42
|
## Use cases
|
|
43
43
|
|