@vercel/geistdocs 1.25.1-canary.47f1ad5 → 1.25.1-canary.4e75e60
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 +1 -1
- package/dist/controls.d.ts.map +1 -1
- package/dist/controls.js +3 -2
- 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/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 +9 -14
- package/dist/internal/chat/sources.d.ts.map +1 -1
- package/dist/internal/chat/sources.js +4 -1
- package/dist/internal/mousedown-navigation-utils.d.ts +5 -0
- package/dist/internal/mousedown-navigation-utils.d.ts.map +1 -0
- package/dist/internal/mousedown-navigation-utils.js +95 -0
- package/dist/internal/mousedown-navigation.d.ts +10 -0
- package/dist/internal/mousedown-navigation.d.ts.map +1 -0
- package/dist/internal/mousedown-navigation.js +42 -0
- package/dist/internal/navbar/navbar-shell.d.ts.map +1 -1
- package/dist/internal/navbar/navbar-shell.js +2 -1
- package/dist/internal/page-actions-client.d.ts.map +1 -1
- package/dist/internal/page-actions-client.js +4 -21
- package/dist/internal/provider-client.d.ts.map +1 -1
- package/dist/internal/provider-client.js +28 -4
- package/dist/internal/sidebar.d.ts.map +1 -1
- package/dist/internal/sidebar.js +15 -14
- package/dist/mdx.d.ts.map +1 -1
- package/dist/mdx.js +2 -4
- package/dist/pages/docs.d.ts.map +1 -1
- package/dist/pages/docs.js +8 -5
- package/dist/routes/chat.d.ts +1 -1
- package/dist/routes/chat.js +1 -1
- package/docs/agents.md +1 -1
- package/docs/llms.txt +35 -9
- 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 +31 -5
- package/package.json +2 -2
- 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 +32 -5
- package/template/package.json +2 -2
|
@@ -4,21 +4,45 @@ import { Toasts } from "@vercel/geistcn/components/toasts";
|
|
|
4
4
|
import { GeistProvider } from "@vercel/geistcn/core";
|
|
5
5
|
import { cn } from "@vercel/geistcn/utils";
|
|
6
6
|
import { RootProvider } from "fumadocs-ui/provider/next";
|
|
7
|
-
import { useCallback } from "react";
|
|
7
|
+
import { lazy, Suspense, useCallback, useEffect, } from "react";
|
|
8
8
|
import { GeistdocsChatProvider, useGeistdocsChat } from "./chat/context";
|
|
9
|
-
import {
|
|
9
|
+
import { ChatLoadingSkeleton } from "./chat/loading-skeleton";
|
|
10
10
|
import { GeistdocsConfigProvider } from "./config-context";
|
|
11
11
|
import { createGeistdocsI18n } from "./i18n";
|
|
12
12
|
import { GeistdocsSearchDialog } from "./search";
|
|
13
13
|
import { useIsMobile } from "./use-mobile";
|
|
14
|
+
const GeistdocsChatShell = lazy(() => import("./chat/shell").then(({ GeistdocsChatShell: Component }) => ({
|
|
15
|
+
default: Component,
|
|
16
|
+
})));
|
|
14
17
|
const GeistdocsProviderInner = ({ config, search, theme: _theme, lang, ...props }) => {
|
|
15
18
|
const { i18n, i18nProvider } = createGeistdocsI18n(config);
|
|
16
|
-
const { enabled, isOpen } = useGeistdocsChat();
|
|
19
|
+
const { enabled, hasBeenOpened, isOpen, setIsOpen } = useGeistdocsChat();
|
|
17
20
|
const isMobile = useIsMobile();
|
|
21
|
+
useEffect(() => {
|
|
22
|
+
if (!enabled) {
|
|
23
|
+
return;
|
|
24
|
+
}
|
|
25
|
+
const handleKeyDown = (event) => {
|
|
26
|
+
if (event.key === "Escape" && isOpen) {
|
|
27
|
+
event.preventDefault();
|
|
28
|
+
setIsOpen(false);
|
|
29
|
+
return;
|
|
30
|
+
}
|
|
31
|
+
if ((event.metaKey || event.ctrlKey) &&
|
|
32
|
+
!event.altKey &&
|
|
33
|
+
!event.shiftKey &&
|
|
34
|
+
event.key.toLowerCase() === "i") {
|
|
35
|
+
event.preventDefault();
|
|
36
|
+
setIsOpen((open) => !open);
|
|
37
|
+
}
|
|
38
|
+
};
|
|
39
|
+
document.addEventListener("keydown", handleKeyDown, true);
|
|
40
|
+
return () => document.removeEventListener("keydown", handleKeyDown, true);
|
|
41
|
+
}, [enabled, isOpen, setIsOpen]);
|
|
18
42
|
const SearchDialogComponent = useCallback((searchProps) => (_jsx(GeistdocsSearchDialog, { basePath: config.basePath, ...searchProps })), [config.basePath]);
|
|
19
43
|
return (_jsxs("div", { className: cn("@container transition-[padding-right] duration-150 ease-[cubic-bezier(0.175,0.885,0.32,1.1)] motion-reduce:transition-none", enabled && isOpen && !isMobile ? "pr-[400px]!" : null), "data-geistdocs-container": true, children: [_jsx(RootProvider, { i18n: i18nProvider(lang ?? i18n.defaultLanguage), search: {
|
|
20
44
|
SearchDialog: SearchDialogComponent,
|
|
21
45
|
...search,
|
|
22
|
-
}, theme: { enabled: false }, ...props }), _jsx(Toasts, {}), _jsx(GeistdocsChatShell, {})] }));
|
|
46
|
+
}, theme: { enabled: false }, ...props }), _jsx(Toasts, {}), hasBeenOpened ? (_jsx(Suspense, { fallback: isOpen ? (_jsx(ChatLoadingSkeleton, { isMobile: isMobile, title: config.title })) : null, children: _jsx(GeistdocsChatShell, {}) })) : null] }));
|
|
23
47
|
};
|
|
24
48
|
export const GeistdocsProvider = (props) => (_jsx(GeistProvider, { storageKey: "geistdocs-theme", withScript: false, children: _jsx(GeistdocsConfigProvider, { config: props.config, children: _jsx(GeistdocsChatProvider, { config: props.config, children: _jsx(GeistdocsProviderInner, { ...props }) }) }) }));
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sidebar.d.ts","sourceRoot":"","sources":["../../src/internal/sidebar.tsx"],"names":[],"mappings":"AAmBA,OAAO,EAEL,KAAK,SAAS,EAQf,MAAM,OAAO,CAAC;AAEf,OAAO,EAAE,KAAK,oBAAoB,EAAuB,MAAM,YAAY,CAAC;
|
|
1
|
+
{"version":3,"file":"sidebar.d.ts","sourceRoot":"","sources":["../../src/internal/sidebar.tsx"],"names":[],"mappings":"AAmBA,OAAO,EAEL,KAAK,SAAS,EAQf,MAAM,OAAO,CAAC;AAEf,OAAO,EAAE,KAAK,oBAAoB,EAAuB,MAAM,YAAY,CAAC;AAk9B5E,eAAO,MAAM,gBAAgB,GAAI,6BAI9B;IACD,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,SAAS,CAAC;CACjB,4CAiEA,CAAC"}
|
package/dist/internal/sidebar.js
CHANGED
|
@@ -10,6 +10,7 @@ import { useSize } from "phase/react";
|
|
|
10
10
|
import { useEffect, useId, useLayoutEffect, useMemo, useRef, useState, } from "react";
|
|
11
11
|
import { SearchButton } from "../controls";
|
|
12
12
|
import { useGeistdocsSidebar } from "../sidebar";
|
|
13
|
+
import { MouseDownNavigation } from "./mousedown-navigation";
|
|
13
14
|
import { SIDEBAR_DESKTOP_MIN_WIDTH } from "./sidebar-responsive";
|
|
14
15
|
import { findActiveRootSection, getDescendantFolderIds, getInitialOpenFolderIds, getSidebarBadgeTone, getSidebarItemBadge, getSidebarNodeId, getSidebarRootGroups, getSidebarSectionItems, hasSeparateRootDisclosure, isExternalSidebarItem, isExternalSidebarUrl, } from "./sidebar-tree";
|
|
15
16
|
const UNSAFE_ID_CHARACTERS = /[^a-zA-Z0-9_-]/g;
|
|
@@ -315,27 +316,27 @@ const DesktopSectionsSidebar = ({ activeUrl, nodes, rootScope, top, }) => {
|
|
|
315
316
|
shouldFocusRootRef.current = false;
|
|
316
317
|
}
|
|
317
318
|
}, [sectionShown]);
|
|
318
|
-
return (_jsx("div", { className: "pointer-events-none sticky top-(--fd-docs-row-1) z-20 @min-[961px]:block hidden h-[calc(var(--fd-docs-height)-var(--fd-docs-row-1))] @min-[961px]:layout:[--fd-sidebar-width:300px] [grid-area:sidebar] *:pointer-events-auto", "data-sidebar-placeholder": true, children: _jsx("aside", { className: "h-full w-[300px] pr-3 text-gray-900", children: _jsxs("nav", { "aria-label": "Documentation", className: "geistdocs-sidebar-scroll h-full w-full overflow-auto overflow-x-hidden px-1 pt-14 pb-1 outline-none", "data-geistdocs-sidebar-scroll": true, ref: navRef, children: [top ? _jsx("div", { className: "px-2 pb-3", children: top }) : null, _jsxs("div", { className: "relative overflow-hidden", children: [_jsx("div", { className: cn("geistdocs-sidebar-pane", rootHidden &&
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
319
|
+
return (_jsx("div", { className: "pointer-events-none sticky top-(--fd-docs-row-1) z-20 @min-[961px]:block hidden h-[calc(var(--fd-docs-height)-var(--fd-docs-row-1))] @min-[961px]:layout:[--fd-sidebar-width:300px] [grid-area:sidebar] *:pointer-events-auto", "data-sidebar-placeholder": true, children: _jsx("aside", { className: "h-full w-[300px] pr-3 text-gray-900", children: _jsx(MouseDownNavigation, { children: _jsxs("nav", { "aria-label": "Documentation", className: "geistdocs-sidebar-scroll h-full w-full overflow-auto overflow-x-hidden px-1 pt-14 pb-1 outline-none", "data-geistdocs-sidebar-scroll": true, ref: navRef, children: [top ? _jsx("div", { className: "px-2 pb-3", children: top }) : null, _jsxs("div", { className: "relative overflow-hidden", children: [_jsx("div", { className: cn("geistdocs-sidebar-pane", rootHidden &&
|
|
320
|
+
"pointer-events-none absolute inset-x-0 top-0 opacity-0 [transform:translateX(-8px)] motion-reduce:invisible"), "data-sidebar-pane": "root", inert: rootHidden || undefined, children: _jsx(SidebarRootList, { activeSection: activeSection, activeUrl: activeUrl, groups: groups, onSelect: (section, trigger) => {
|
|
321
|
+
returnFocusRef.current = trigger;
|
|
322
|
+
shouldFocusSectionRef.current = true;
|
|
323
|
+
setSelectedSection(section);
|
|
324
|
+
setView("section");
|
|
325
|
+
}, visible: !rootHidden }) }), activeSection ? (_jsxs("div", { className: cn("geistdocs-sidebar-pane", sectionHidden &&
|
|
326
|
+
"pointer-events-none absolute inset-x-0 top-0 opacity-0 [transform:translateX(8px)] motion-reduce:invisible"), "data-sidebar-pane": "section", inert: sectionHidden || undefined, children: [_jsx(SidebarSectionHeader, { buttonRef: sectionHeaderRef, onBack: () => {
|
|
327
|
+
shouldFocusRootRef.current = true;
|
|
328
|
+
setSelectedSection(null);
|
|
329
|
+
setView("root");
|
|
330
|
+
}, section: activeSection }), _jsx("div", { className: "px-2", children: _jsx(SidebarTree, { activeUrl: activeUrl, idScope: sectionScope, nodes: sectionItems, openFirstLevel: true, scrollActive: true, visible: !sectionHidden }) })] })) : null] })] }) }) }) }));
|
|
330
331
|
};
|
|
331
|
-
const DesktopTreeSidebar = ({ activeUrl, nodes, rootScope, top, }) => (_jsx("div", { className: "pointer-events-none sticky top-(--fd-docs-row-1) z-20 @min-[961px]:block hidden h-[calc(var(--fd-docs-height)-var(--fd-docs-row-1))] @min-[961px]:layout:[--fd-sidebar-width:300px] [grid-area:sidebar] *:pointer-events-auto", "data-sidebar-mode": "tree", "data-sidebar-placeholder": true, children: _jsx("aside", { className: "h-full w-[300px] pr-3 text-gray-900", children: _jsxs("nav", { "aria-label": "Documentation", className: "geistdocs-sidebar-scroll h-full w-full overflow-auto overflow-x-hidden px-3 pt-14 pb-1 outline-none", "data-geistdocs-sidebar-scroll": true, children: [top ? _jsx("div", { className: "pb-3", children: top }) : null, _jsx(SidebarTree, { activeUrl: activeUrl, idScope: rootScope, nodes: nodes, openFirstLevel: true, scrollActive: true })] }) }) }));
|
|
332
|
+
const DesktopTreeSidebar = ({ activeUrl, nodes, rootScope, top, }) => (_jsx("div", { className: "pointer-events-none sticky top-(--fd-docs-row-1) z-20 @min-[961px]:block hidden h-[calc(var(--fd-docs-height)-var(--fd-docs-row-1))] @min-[961px]:layout:[--fd-sidebar-width:300px] [grid-area:sidebar] *:pointer-events-auto", "data-sidebar-mode": "tree", "data-sidebar-placeholder": true, children: _jsx("aside", { className: "h-full w-[300px] pr-3 text-gray-900", children: _jsx(MouseDownNavigation, { children: _jsxs("nav", { "aria-label": "Documentation", className: "geistdocs-sidebar-scroll h-full w-full overflow-auto overflow-x-hidden px-3 pt-14 pb-1 outline-none", "data-geistdocs-sidebar-scroll": true, children: [top ? _jsx("div", { className: "pb-3", children: top }) : null, _jsx(SidebarTree, { activeUrl: activeUrl, idScope: rootScope, nodes: nodes, openFirstLevel: true, scrollActive: true })] }) }) }) }));
|
|
332
333
|
const DesktopSidebar = ({ mode, ...props }) => {
|
|
333
334
|
if (mode === "tree") {
|
|
334
335
|
return _jsx(DesktopTreeSidebar, { ...props });
|
|
335
336
|
}
|
|
336
337
|
return _jsx(DesktopSectionsSidebar, { ...props });
|
|
337
338
|
};
|
|
338
|
-
const MobileSidebar = ({ activeUrl, idScope, nodes, onOpenChange, open, top, }) => (_jsx(Sheet, { onOpenChange: onOpenChange, open: open, children: _jsxs(SheetContent, { className: "w-full gap-0 bg-background-200 p-0 sm:max-w-none", "data-geistdocs-mobile-sidebar": true, noOverlay: true, side: "left", children: [_jsxs(SheetHeader, { className: "h-16 shrink-0 justify-center border-b px-4 py-0", children: [_jsx(SheetTitle, { className: "text-label-16", children: "Browse" }), _jsx(SheetDescription, { className: "sr-only", children: "Navigation for the documentation." })] }), _jsxs("nav", { "aria-label": "Documentation", className: "flex-1 overflow-y-auto overflow-x-hidden overscroll-contain px-2 py-3 text-gray-900", "data-geistdocs-sidebar-scroll": true, children: [_jsx("div", { className: "pb-4 [&>button]:w-full", children: _jsx(SearchButton, { onClick: () => onOpenChange(false) }) }), top ? _jsx("div", { className: "pb-4", children: top }) : null, _jsx(SidebarTree, { activeUrl: activeUrl, idScope: idScope, nodes: nodes, onNavigate: () => onOpenChange(false), scrollActive: true, visible: open })] })] }) }));
|
|
339
|
+
const MobileSidebar = ({ activeUrl, idScope, nodes, onOpenChange, open, top, }) => (_jsx(Sheet, { onOpenChange: onOpenChange, open: open, children: _jsxs(SheetContent, { className: "w-full gap-0 bg-background-200 p-0 sm:max-w-none", "data-geistdocs-mobile-sidebar": true, noOverlay: true, side: "left", children: [_jsxs(SheetHeader, { className: "h-16 shrink-0 justify-center border-b px-4 py-0", children: [_jsx(SheetTitle, { className: "text-label-16", children: "Browse" }), _jsx(SheetDescription, { className: "sr-only", children: "Navigation for the documentation." })] }), _jsx(MouseDownNavigation, { children: _jsxs("nav", { "aria-label": "Documentation", className: "flex-1 overflow-y-auto overflow-x-hidden overscroll-contain px-2 py-3 text-gray-900", "data-geistdocs-sidebar-scroll": true, children: [_jsx("div", { className: "pb-4 [&>button]:w-full", children: _jsx(SearchButton, { onClick: () => onOpenChange(false) }) }), top ? _jsx("div", { className: "pb-4", children: top }) : null, _jsx(SidebarTree, { activeUrl: activeUrl, idScope: idScope, nodes: nodes, onNavigate: () => onOpenChange(false), scrollActive: true, visible: open })] }) })] }) }));
|
|
339
340
|
export const GeistdocsSidebar = ({ mode = "sections", showDesktop = true, top, }) => {
|
|
340
341
|
const { root, full } = useTreeContext();
|
|
341
342
|
const { isOpen, setIsOpen } = useGeistdocsSidebar();
|
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";
|
|
@@ -18,7 +17,6 @@ export const defineGeistdocsSourceConfig = sourceConfig;
|
|
|
18
17
|
export const geistdocsFrontmatterSchema = frontmatterSchema;
|
|
19
18
|
export const geistdocsMetaSchema = metaSchema;
|
|
20
19
|
export const geistShikiTheme = shikiTheme;
|
|
21
|
-
const HTTP_URL = /^https?:\/\//;
|
|
22
20
|
export const getGeistdocsMDXComponents = (components) => ({
|
|
23
21
|
...defaultMdxComponents,
|
|
24
22
|
h1: (props) => _jsx(Heading, { as: "h1", ...props }),
|
|
@@ -30,7 +28,7 @@ export const getGeistdocsMDXComponents = (components) => ({
|
|
|
30
28
|
pre: CodeBlock,
|
|
31
29
|
blockquote: Blockquote,
|
|
32
30
|
table: Table,
|
|
33
|
-
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 })),
|
|
34
32
|
CodeBlockTabs,
|
|
35
33
|
CompactCodeBlockTabs,
|
|
36
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":"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"}
|
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 }));
|
|
@@ -96,9 +95,10 @@ export const createDocsPage = ({ config, source, mdx, pageActions = createIntern
|
|
|
96
95
|
}) ?? [])
|
|
97
96
|
: [];
|
|
98
97
|
const hasTocActions = hasTableOfContentsActions(pageActions.config, footerActions);
|
|
98
|
+
const hasTocLinks = Boolean(data.toc?.length);
|
|
99
99
|
// Actions stay adjacent to the table of contents; the app-provided
|
|
100
100
|
// footer (promos and other custom content) renders below them.
|
|
101
|
-
const tocFooter = (_jsxs(_Fragment, { children: [hasTocActions ? (_jsx("div", { className: "mt-4 border-gray-alpha-400 border-t pt-4", children: _jsx("nav", { "aria-label": "Page actions", className: "flex min-w-0 flex-col gap-1", children: _jsx(GeistdocsTableOfContentsActions, { config: pageActions.config, extraActions: footerActions }) }) })) : null, _jsx(TocFooterSlot, { children: tableOfContent?.footer })] }));
|
|
101
|
+
const tocFooter = (_jsxs(_Fragment, { children: [hasTocLinks && hasTocActions ? (_jsx("div", { className: "mt-4 border-gray-alpha-400 border-t pt-4", children: _jsx("nav", { "aria-label": "Page actions", className: "flex min-w-0 flex-col gap-1", children: _jsx(GeistdocsTableOfContentsActions, { config: pageActions.config, extraActions: footerActions }) }) })) : null, _jsx(TocFooterSlot, { children: tableOfContent?.footer })] }));
|
|
102
102
|
const tocComponent = tableOfContent?.component ?? (_jsx(GeistdocsTableOfContents, { footer: tocFooter, header: tableOfContent?.header, toc: data.toc ?? [] }));
|
|
103
103
|
return (_jsxs(FumadocsDocsPage, { breadcrumb: {
|
|
104
104
|
component: (_jsx(PageBreadcrumb, { tree: source.source.getPageTree(lang), url: page.url })),
|
|
@@ -107,7 +107,10 @@ export const createDocsPage = ({ config, source, mdx, pageActions = createIntern
|
|
|
107
107
|
single: true,
|
|
108
108
|
...tableOfContent,
|
|
109
109
|
component: tocComponent,
|
|
110
|
-
}, tableOfContentPopover:
|
|
110
|
+
}, tableOfContentPopover: {
|
|
111
|
+
enabled: false,
|
|
112
|
+
...tableOfContentPopover,
|
|
113
|
+
}, toc: data.toc, children: [renderTop?.({
|
|
111
114
|
data,
|
|
112
115
|
markdown: markdown ?? "",
|
|
113
116
|
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/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.4e75e60 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.4e75e60.
|
|
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,33 @@ 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
|
+
|
|
1305
1332
|
### Copy Prompts
|
|
1306
1333
|
|
|
1307
1334
|
Short prompts render in full without an expansion control:
|
|
@@ -1344,17 +1371,16 @@ Create links with `[text](url)`:
|
|
|
1344
1371
|
- [External link](https://vercel.com)
|
|
1345
1372
|
- [Internal link](/docs/getting-started)
|
|
1346
1373
|
|
|
1347
|
-
Use an absolute `https://` or `http://` URL
|
|
1348
|
-
|
|
1349
|
-
|
|
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:
|
|
1350
1377
|
|
|
1351
1378
|
```md
|
|
1352
1379
|
[External link](https://vercel.com)
|
|
1353
1380
|
[Internal link](/docs/getting-started)
|
|
1354
1381
|
```
|
|
1355
1382
|
|
|
1356
|
-
|
|
1357
|
-
but not the external-link icon:
|
|
1383
|
+
Links can also contain inline code:
|
|
1358
1384
|
|
|
1359
1385
|
```md
|
|
1360
1386
|
Run independent requests in parallel with [`Promise.all`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise/all).
|
|
@@ -2443,7 +2469,7 @@ The `.mdx` version returns:
|
|
|
2443
2469
|
|
|
2444
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`.
|
|
2445
2471
|
|
|
2446
|
-
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.
|
|
2447
2473
|
|
|
2448
2474
|
## Use cases
|
|
2449
2475
|
|
|
@@ -2775,7 +2801,7 @@ In this mode, Geistdocs uses the local `search_docs` tool during the AI SDK `str
|
|
|
2775
2801
|
|
|
2776
2802
|
#### Choose a model
|
|
2777
2803
|
|
|
2778
|
-
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`.
|
|
2779
2805
|
|
|
2780
2806
|
```ts title="app/api/chat/route.ts"
|
|
2781
2807
|
import { createChatRoute } from "@vercel/geistdocs/routes/chat";
|
|
@@ -2884,7 +2910,7 @@ The chat interface adapts to different screen sizes:
|
|
|
2884
2910
|
|
|
2885
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.
|
|
2886
2912
|
|
|
2887
|
-
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.
|
|
2888
2914
|
|
|
2889
2915
|
## Suggested Prompts
|
|
2890
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,33 @@ 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
|
+
|
|
118
145
|
### Copy Prompts
|
|
119
146
|
|
|
120
147
|
Short prompts render in full without an expansion control:
|
|
@@ -157,17 +184,16 @@ Create links with `[text](url)`:
|
|
|
157
184
|
- [External link](https://vercel.com)
|
|
158
185
|
- [Internal link](/docs/getting-started)
|
|
159
186
|
|
|
160
|
-
Use an absolute `https://` or `http://` URL
|
|
161
|
-
|
|
162
|
-
|
|
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:
|
|
163
190
|
|
|
164
191
|
```md
|
|
165
192
|
[External link](https://vercel.com)
|
|
166
193
|
[Internal link](/docs/getting-started)
|
|
167
194
|
```
|
|
168
195
|
|
|
169
|
-
|
|
170
|
-
but not the external-link icon:
|
|
196
|
+
Links can also contain inline code:
|
|
171
197
|
|
|
172
198
|
```md
|
|
173
199
|
Run independent requests in parallel with [`Promise.all`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise/all).
|
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.4e75e60",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"repository": {
|
|
7
7
|
"type": "git",
|
|
@@ -193,7 +193,7 @@
|
|
|
193
193
|
"@orama/tokenizers": "^3.1.16",
|
|
194
194
|
"@streamdown/cjk": "^1.0.1",
|
|
195
195
|
"@streamdown/code": "^1.0.1",
|
|
196
|
-
"@vercel/agent-readability": "^0.
|
|
196
|
+
"@vercel/agent-readability": "^0.7.0",
|
|
197
197
|
"@vercel/geistcn": "1.0.3",
|
|
198
198
|
"@vercel/geistcn-assets": "2.0.1",
|
|
199
199
|
"@vercel/oidc": "^3.4.1",
|
|
@@ -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
|
|
|
@@ -114,6 +114,34 @@ 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
|
+
|
|
117
145
|
### Copy Prompts
|
|
118
146
|
|
|
119
147
|
Short prompts render in full without an expansion control:
|
|
@@ -160,17 +188,16 @@ Create links with `[text](url)`:
|
|
|
160
188
|
- [External link](https://vercel.com)
|
|
161
189
|
- [Internal link](/docs/getting-started)
|
|
162
190
|
|
|
163
|
-
Use an absolute `https://` or `http://` URL
|
|
164
|
-
|
|
165
|
-
|
|
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:
|
|
166
194
|
|
|
167
195
|
```md
|
|
168
196
|
[External link](https://vercel.com)
|
|
169
197
|
[Internal link](/docs/getting-started)
|
|
170
198
|
```
|
|
171
199
|
|
|
172
|
-
|
|
173
|
-
but not the external-link icon:
|
|
200
|
+
Links can also contain inline code:
|
|
174
201
|
|
|
175
202
|
```md
|
|
176
203
|
Run independent requests in parallel with [`Promise.all`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise/all).
|
package/template/package.json
CHANGED
|
@@ -15,11 +15,11 @@
|
|
|
15
15
|
"@orama/tokenizers": "^3.1.16",
|
|
16
16
|
"@streamdown/cjk": "^1.0.1",
|
|
17
17
|
"@streamdown/code": "^1.0.1",
|
|
18
|
-
"@vercel/agent-readability": "^0.
|
|
18
|
+
"@vercel/agent-readability": "^0.7.0",
|
|
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.4e75e60",
|
|
23
23
|
"@vercel/speed-insights": "^1.3.1",
|
|
24
24
|
"ai": "^6.0.132",
|
|
25
25
|
"class-variance-authority": "^0.7.1",
|