@vercel/geistdocs 2.14.6 → 2.14.7-canary.6ce58a6
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 +5 -5
- package/dist/config.d.ts +23 -3
- package/dist/config.d.ts.map +1 -1
- package/dist/controls.d.ts +3 -40
- package/dist/controls.d.ts.map +1 -1
- package/dist/controls.js +5 -96
- package/dist/internal/chat-retrieval.d.ts +10 -9
- package/dist/internal/chat-retrieval.d.ts.map +1 -1
- package/dist/internal/chat-retrieval.js +32 -68
- package/dist/internal/controls-client.d.ts +40 -0
- package/dist/internal/controls-client.d.ts.map +1 -0
- package/dist/internal/controls-client.js +87 -0
- package/dist/internal/language-selector.d.ts +2 -0
- package/dist/internal/language-selector.d.ts.map +1 -0
- package/dist/internal/language-selector.js +12 -0
- package/dist/internal/mixedbread-store.d.ts +53 -0
- package/dist/internal/mixedbread-store.d.ts.map +1 -0
- package/dist/internal/mixedbread-store.js +129 -0
- package/dist/internal/navbar/mobile-menu.js +1 -1
- package/dist/internal/page-action-options.d.ts +37 -0
- package/dist/internal/page-action-options.d.ts.map +1 -0
- package/dist/internal/page-action-options.js +39 -0
- package/dist/internal/page-actions-client.d.ts +1 -31
- package/dist/internal/page-actions-client.d.ts.map +1 -1
- package/dist/internal/page-actions-client.js +5 -103
- package/dist/internal/page-actions-gate.d.ts +3 -0
- package/dist/internal/page-actions-gate.d.ts.map +1 -0
- package/dist/internal/page-actions-gate.js +15 -0
- package/dist/internal/provider-client.d.ts.map +1 -1
- package/dist/internal/provider-client.js +26 -1
- package/dist/internal/relative-docs-link.d.ts +7 -0
- package/dist/internal/relative-docs-link.d.ts.map +1 -0
- package/dist/internal/relative-docs-link.js +22 -0
- package/dist/internal/sidebar.d.ts.map +1 -1
- package/dist/internal/sidebar.js +1 -1
- package/dist/internal/toc-actions-client.d.ts +9 -0
- package/dist/internal/toc-actions-client.d.ts.map +1 -0
- package/dist/internal/toc-actions-client.js +78 -0
- package/dist/mdx.d.ts.map +1 -1
- package/dist/mdx.js +5 -2
- package/dist/navbar.js +1 -1
- package/dist/pages/changelog.js +1 -1
- package/dist/pages/docs.d.ts.map +1 -1
- package/dist/pages/docs.js +4 -3
- package/dist/routes/chat.d.ts +4 -4
- package/dist/routes/chat.d.ts.map +1 -1
- package/dist/routes/chat.js +19 -34
- package/dist/routes/openapi.d.ts.map +1 -1
- package/dist/routes/openapi.js +13 -5
- package/dist/routes/search-export.d.ts +1 -1
- package/dist/routes/search-export.d.ts.map +1 -1
- package/dist/routes/search-export.js +5 -2
- package/dist/routes/search.d.ts +10 -2
- package/dist/routes/search.d.ts.map +1 -1
- package/dist/routes/search.js +215 -55
- package/docs/agents.md +3 -3
- package/docs/llms.txt +214 -32
- package/docs/manifest.json +5 -5
- package/docs/pages/ask-ai.md +1 -1
- package/docs/pages/configuration.md +26 -3
- package/docs/pages/env.md +5 -5
- package/docs/pages/index.md +1 -1
- package/docs/pages/llms-txt.md +1 -1
- package/docs/pages/mixedbread-retrieval.md +174 -18
- package/docs/pages/provider.md +3 -0
- package/docs/sitemap.md +2 -2
- package/package.json +6 -6
- package/template/.env.example +1 -0
- package/template/AGENTS.md +11 -7
- package/template/content/docs/ask-ai.mdx +1 -1
- package/template/content/docs/configuration.mdx +26 -3
- package/template/content/docs/env.mdx +5 -5
- package/template/content/docs/index.mdx +1 -1
- package/template/content/docs/llms-txt.mdx +1 -1
- package/template/content/docs/mixedbread-retrieval.mdx +174 -18
- package/template/content/docs/provider.mdx +3 -0
- package/template/geistdocs.tsx +6 -1
- package/template/lib/geistdocs/config.tsx +2 -0
- package/template/package.json +1 -1
|
@@ -3,7 +3,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
|
|
|
3
3
|
import { RootProvider } from "fumadocs-ui/provider/next";
|
|
4
4
|
import { lazy, Suspense, useCallback, useEffect, } from "react";
|
|
5
5
|
import { Toasts } from "#geistdocs-ui/components/toasts";
|
|
6
|
-
import { GeistProvider } from "#geistdocs-ui/core";
|
|
6
|
+
import { GeistProvider, useTheme } from "#geistdocs-ui/core";
|
|
7
7
|
import { GeistdocsChatProvider, useGeistdocsChatContext } from "./chat/context";
|
|
8
8
|
import { ChatLoadingSkeleton } from "./chat/loading-skeleton";
|
|
9
9
|
import { GeistdocsConfigProvider } from "./config-context";
|
|
@@ -18,6 +18,7 @@ const GeistdocsProviderInner = ({ config, search, theme: _theme, lang, ...props
|
|
|
18
18
|
const { i18n, i18nProvider } = createGeistdocsI18n(config);
|
|
19
19
|
const { enabled, hasBeenOpened, isExpanded, isOpen, setIsExpanded, setIsOpen, } = useGeistdocsChatContext();
|
|
20
20
|
const isMobile = useIsMobile();
|
|
21
|
+
const { forcedTheme, resolvedTheme, setTheme } = useTheme();
|
|
21
22
|
useEffect(() => {
|
|
22
23
|
if (!enabled) {
|
|
23
24
|
return;
|
|
@@ -57,6 +58,30 @@ const GeistdocsProviderInner = ({ config, search, theme: _theme, lang, ...props
|
|
|
57
58
|
document.removeEventListener("keydown", handleShortcut, true);
|
|
58
59
|
};
|
|
59
60
|
}, [enabled, isExpanded, isMobile, isOpen, setIsExpanded, setIsOpen]);
|
|
61
|
+
useEffect(() => {
|
|
62
|
+
if (forcedTheme) {
|
|
63
|
+
return;
|
|
64
|
+
}
|
|
65
|
+
const handleThemeShortcut = (event) => {
|
|
66
|
+
if (event.metaKey ||
|
|
67
|
+
event.ctrlKey ||
|
|
68
|
+
event.altKey ||
|
|
69
|
+
event.shiftKey ||
|
|
70
|
+
event.key.toLowerCase() !== "t") {
|
|
71
|
+
return;
|
|
72
|
+
}
|
|
73
|
+
const activeElement = document.activeElement;
|
|
74
|
+
if (activeElement &&
|
|
75
|
+
activeElement !== document.body &&
|
|
76
|
+
activeElement !== document.documentElement) {
|
|
77
|
+
return;
|
|
78
|
+
}
|
|
79
|
+
event.preventDefault();
|
|
80
|
+
setTheme(resolvedTheme === "dark" ? "light" : "dark");
|
|
81
|
+
};
|
|
82
|
+
window.addEventListener("keydown", handleThemeShortcut);
|
|
83
|
+
return () => window.removeEventListener("keydown", handleThemeShortcut);
|
|
84
|
+
}, [forcedTheme, resolvedTheme, setTheme]);
|
|
60
85
|
// fumadocs spreads the provider's `search.options` onto the dialog, which is
|
|
61
86
|
// how a consumer reaches `tag`. Typed here so it survives the hand-off.
|
|
62
87
|
const SearchDialogComponent = useCallback((searchProps) => (_jsx(GeistdocsLazySearchDialog, { basePath: config.basePath, ...searchProps })), [config.basePath]);
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import type { ComponentProps, ComponentType } from "react";
|
|
2
|
+
import type { GeistdocsSourceBundle } from "../source";
|
|
3
|
+
export declare const createRelativeDocsLink: (source: Pick<GeistdocsSourceBundle["source"], "getPageByHref">, page: {
|
|
4
|
+
locale?: string;
|
|
5
|
+
path: string;
|
|
6
|
+
}, Link: ComponentType<ComponentProps<"a">>) => ({ href, ...props }: ComponentProps<"a">) => import("react/jsx-runtime").JSX.Element;
|
|
7
|
+
//# sourceMappingURL=relative-docs-link.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"relative-docs-link.d.ts","sourceRoot":"","sources":["../../src/internal/relative-docs-link.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAIvD,eAAO,MAAM,sBAAsB,GACjC,QAAQ,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC,EAC9D,MAAM;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACvC,MAAM,aAAa,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,0BAEM,cAAc,CAAC,GAAG,CAAC,4CAgBlE,CAAC"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { jsx as _jsx } from "react/jsx-runtime";
|
|
2
|
+
import { dirname } from "node:path";
|
|
3
|
+
// Resolve through the same source loader without importing Fumadocs' entire
|
|
4
|
+
// default MDX component map just to get its relative-link helper.
|
|
5
|
+
export const createRelativeDocsLink = (source, page, Link) => {
|
|
6
|
+
const RelativeDocsLink = ({ href, ...props }) => {
|
|
7
|
+
let resolvedHref = href;
|
|
8
|
+
if (href?.startsWith(".")) {
|
|
9
|
+
const target = source.getPageByHref(href, {
|
|
10
|
+
dir: dirname(page.path),
|
|
11
|
+
language: page.locale,
|
|
12
|
+
});
|
|
13
|
+
if (target) {
|
|
14
|
+
resolvedHref = target.hash
|
|
15
|
+
? `${target.page.url}#${target.hash}`
|
|
16
|
+
: target.page.url;
|
|
17
|
+
}
|
|
18
|
+
}
|
|
19
|
+
return _jsx(Link, { href: resolvedHref, ...props });
|
|
20
|
+
};
|
|
21
|
+
return RelativeDocsLink;
|
|
22
|
+
};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sidebar.d.ts","sourceRoot":"","sources":["../../src/internal/sidebar.tsx"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,SAAS,EAQf,MAAM,OAAO,CAAC;
|
|
1
|
+
{"version":3,"file":"sidebar.d.ts","sourceRoot":"","sources":["../../src/internal/sidebar.tsx"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,SAAS,EAQf,MAAM,OAAO,CAAC;AAef,OAAO,EAAE,KAAK,oBAAoB,EAAuB,MAAM,YAAY,CAAC;AAw/B5E,eAAO,MAAM,gBAAgB,GAAI,6CAK9B;IACD,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B,2EAA2E;IAC3E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,SAAS,CAAC;CACjB,4CAkEA,CAAC"}
|
package/dist/internal/sidebar.js
CHANGED
|
@@ -8,8 +8,8 @@ import { useEffect, useId, useLayoutEffect, useMemo, useRef, useState, } from "r
|
|
|
8
8
|
import { IconArrowUpRightSmall, IconChevronRightSmall, IconCross, } from "#geistdocs-assets/icons";
|
|
9
9
|
import { Sheet, SheetClose, SheetContent, SheetDescription, SheetHeader, SheetTitle, } from "#geistdocs-ui/components/sheet";
|
|
10
10
|
import { cn } from "#geistdocs-ui/utils";
|
|
11
|
-
import { SearchButton } from "../controls";
|
|
12
11
|
import { useGeistdocsSidebar } from "../sidebar";
|
|
12
|
+
import { SearchButton } from "./controls-client";
|
|
13
13
|
import { MouseDownNavigation } from "./mousedown-navigation";
|
|
14
14
|
import { SIDEBAR_DESKTOP_MIN_WIDTH } from "./sidebar-responsive";
|
|
15
15
|
import { findActiveRootSection, getDescendantFolderIds, getFolderLinkClickAction, getInitialOpenFolderIds, getSidebarBadgeTone, getSidebarItemBadge, getSidebarNodeId, getSidebarRootGroups, getSidebarSectionItems, hasSeparateRootDisclosure, isExternalSidebarItem, isExternalSidebarUrl, isSidebarItemCurrent, openFolderId, toggleFolderId, } from "./sidebar-tree";
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import { type ReactNode } from "react";
|
|
2
|
+
import type { GeistdocsConfig } from "../config";
|
|
3
|
+
interface GeistdocsTableOfContentsActionsProps {
|
|
4
|
+
config: Pick<GeistdocsConfig, "feedback" | "pageActions" | "siteId">;
|
|
5
|
+
extraActions: ReactNode[];
|
|
6
|
+
}
|
|
7
|
+
export declare const GeistdocsTableOfContentsActions: ({ config, extraActions, }: GeistdocsTableOfContentsActionsProps) => import("react/jsx-runtime").JSX.Element;
|
|
8
|
+
export {};
|
|
9
|
+
//# sourceMappingURL=toc-actions-client.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"toc-actions-client.d.ts","sourceRoot":"","sources":["../../src/internal/toc-actions-client.tsx"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,SAAS,EAIf,MAAM,OAAO,CAAC;AAQf,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAKjD,UAAU,oCAAoC;IAC5C,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,aAAa,GAAG,QAAQ,CAAC,CAAC;IACrE,YAAY,EAAE,SAAS,EAAE,CAAC;CAC3B;AAwKD,eAAO,MAAM,+BAA+B,GAAI,2BAG7C,oCAAoC,4CAiBtC,CAAC"}
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
|
|
3
|
+
import { usePathname } from "next/navigation";
|
|
4
|
+
import { useEffect, useState, useTransition, } from "react";
|
|
5
|
+
import { IconAcronymMarkdown, IconArrowCircleUp, IconThumbUp, } from "#geistdocs-assets/icons";
|
|
6
|
+
import { Button } from "#geistdocs-ui/components/button";
|
|
7
|
+
import { Textarea } from "#geistdocs-ui/components/textarea";
|
|
8
|
+
import { sendFeedback } from "./feedback-action";
|
|
9
|
+
import { Popover, PopoverContent, PopoverTrigger } from "./ui/popover";
|
|
10
|
+
import { useIsMobile } from "./use-mobile";
|
|
11
|
+
const actionClassName = "group flex min-h-8 w-full min-w-0 touch-manipulation items-center gap-2 rounded-md text-left text-gray-900 text-label-14 transition-colors hover:text-gray-1000 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-700 focus-visible:ring-offset-2 focus-visible:ring-offset-background-100 motion-reduce:transition-none [&_svg]:size-4 [&_svg]:shrink-0 [&_span]:min-w-0 [&_span]:truncate";
|
|
12
|
+
const feedbackEmotions = [
|
|
13
|
+
{ name: "cry", emoji: "😭" },
|
|
14
|
+
{ name: "sad", emoji: "😕" },
|
|
15
|
+
{ name: "happy", emoji: "🙂" },
|
|
16
|
+
{ name: "amazed", emoji: "🤩" },
|
|
17
|
+
];
|
|
18
|
+
const ScrollTopAction = () => (_jsxs("button", { className: actionClassName, onClick: () => {
|
|
19
|
+
const reduceMotion = window.matchMedia("(prefers-reduced-motion: reduce)").matches;
|
|
20
|
+
window.scrollTo({ top: 0, behavior: reduceMotion ? "auto" : "smooth" });
|
|
21
|
+
}, type: "button", children: [_jsx(IconArrowCircleUp, { className: "size-3.5" }), _jsx("span", { children: "Scroll to top" })] }));
|
|
22
|
+
const FeedbackAction = ({ siteId }) => {
|
|
23
|
+
const isMobile = useIsMobile();
|
|
24
|
+
const url = usePathname();
|
|
25
|
+
const [submitted, setSubmitted] = useState(false);
|
|
26
|
+
const [emotion, setEmotion] = useState(null);
|
|
27
|
+
const [message, setMessage] = useState("");
|
|
28
|
+
const [failed, setFailed] = useState(false);
|
|
29
|
+
const [isPending, startTransition] = useTransition();
|
|
30
|
+
useEffect(() => {
|
|
31
|
+
const item = localStorage.getItem(`docs-feedback-${url}`);
|
|
32
|
+
if (!item) {
|
|
33
|
+
return;
|
|
34
|
+
}
|
|
35
|
+
setSubmitted(true);
|
|
36
|
+
}, [url]);
|
|
37
|
+
const submit = (event) => {
|
|
38
|
+
event.preventDefault();
|
|
39
|
+
if (!emotion) {
|
|
40
|
+
return;
|
|
41
|
+
}
|
|
42
|
+
startTransition(async () => {
|
|
43
|
+
const feedback = {
|
|
44
|
+
emotion,
|
|
45
|
+
message,
|
|
46
|
+
};
|
|
47
|
+
const result = await sendFeedback({ url, feedback, siteId });
|
|
48
|
+
// Keep the form (and the visitor's text) so a failed submission can
|
|
49
|
+
// be retried.
|
|
50
|
+
if (!result.success) {
|
|
51
|
+
setFailed(true);
|
|
52
|
+
return;
|
|
53
|
+
}
|
|
54
|
+
setFailed(false);
|
|
55
|
+
setSubmitted(true);
|
|
56
|
+
localStorage.setItem(`docs-feedback-${url}`, "1");
|
|
57
|
+
setMessage("");
|
|
58
|
+
setEmotion(null);
|
|
59
|
+
});
|
|
60
|
+
};
|
|
61
|
+
return (_jsxs(Popover, { children: [_jsx(PopoverTrigger, { asChild: true, children: _jsxs("button", { className: actionClassName, type: "button", children: [_jsx(IconThumbUp, { className: "size-3.5" }), _jsx("span", { children: "Give feedback" })] }) }), _jsx(PopoverContent, { className: "overflow-hidden p-0", children: _jsx("div", { className: "overflow-visible", children: submitted ? (_jsx("div", { className: "flex flex-col items-center gap-3 rounded-xl bg-background-200 px-3 py-6 text-center text-copy-14", role: "status", children: _jsx("p", { children: "Thank you for your feedback!" }) })) : (_jsxs("form", { className: "flex flex-col", onSubmit: submit, children: [_jsx("div", { className: "p-2", children: _jsx(Textarea, { "aria-label": "Feedback", autoComplete: "off", autoFocus: !isMobile, className: "max-h-48 min-h-24 shadow-none", name: "feedback", onChange: (event) => setMessage(event.target.value), onKeyDown: (event) => {
|
|
62
|
+
if (!event.shiftKey && event.key === "Enter") {
|
|
63
|
+
event.currentTarget.form?.requestSubmit();
|
|
64
|
+
}
|
|
65
|
+
}, placeholder: "Leave your feedback\u2026", required: true, value: message }) }), _jsxs("div", { className: "flex items-center justify-end gap-1 px-2 text-gray-900", children: [_jsx(IconAcronymMarkdown, { "aria-hidden": "true", className: "inline size-3" }), _jsx("p", { className: "text-label-12", children: " supported" })] }), failed ? (_jsx("p", { className: "px-2 pb-1 text-label-12 text-red-900", role: "alert", children: "Sending feedback failed. Please try again." })) : null, _jsxs("div", { className: "mt-2 flex items-center justify-between border-t bg-background-200 p-2", children: [_jsx("div", { className: "flex items-center gap-px", children: feedbackEmotions.map((entry) => (_jsxs(Button, { className: emotion === entry.name
|
|
66
|
+
? "bg-gray-100 text-gray-1000"
|
|
67
|
+
: "text-gray-900 hover:text-gray-1000", onClick: () => setEmotion(entry.name), size: "small", type: "unstyled", typeName: "button", children: [entry.emoji, _jsx("span", { className: "sr-only", children: entry.name })] }, entry.name))) }), _jsx(Button, { disabled: isPending || !emotion || !message, size: "small", typeName: "submit", children: "Send" })] })] })) }) })] }));
|
|
68
|
+
};
|
|
69
|
+
export const GeistdocsTableOfContentsActions = ({ config, extraActions, }) => {
|
|
70
|
+
const actions = [];
|
|
71
|
+
if (config.pageActions?.scrollTop !== false) {
|
|
72
|
+
actions.push(_jsx(ScrollTopAction, {}, "scroll-top"));
|
|
73
|
+
}
|
|
74
|
+
if (config.feedback?.enabled !== false) {
|
|
75
|
+
actions.push(_jsx(FeedbackAction, { siteId: config.siteId }, "feedback"));
|
|
76
|
+
}
|
|
77
|
+
return (_jsxs(_Fragment, { children: [actions, extraActions] }));
|
|
78
|
+
};
|
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":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAiC/C,OAAO,KAAK,EAAE,4BAA4B,IAAI,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAK3F,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,sBAsED,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,5 +1,6 @@
|
|
|
1
1
|
import { jsx as _jsx } from "react/jsx-runtime";
|
|
2
|
-
import
|
|
2
|
+
import { Image as FrameworkImage } from "fumadocs-core/framework";
|
|
3
|
+
import { Card, Cards } from "fumadocs-ui/components/card";
|
|
3
4
|
import Link from "next/link";
|
|
4
5
|
import { cn } from "#geistdocs-ui/utils";
|
|
5
6
|
import { Blockquote } from "./components/blockquote";
|
|
@@ -21,7 +22,9 @@ import { geistShikiTheme as shikiTheme } from "./shiki-theme";
|
|
|
21
22
|
// language grammar, into every server function that renders MDX.
|
|
22
23
|
export const geistShikiTheme = shikiTheme;
|
|
23
24
|
export const getGeistdocsMDXComponents = (components) => ({
|
|
24
|
-
|
|
25
|
+
Card,
|
|
26
|
+
Cards,
|
|
27
|
+
img: (props) => (_jsx(FrameworkImage, { sizes: "(max-width: 768px) 100vw, (max-width: 1200px) 70vw, 900px", ...props, className: cn("rounded-lg", props.className), src: props.src })),
|
|
25
28
|
h1: (props) => _jsx(Heading, { as: "h1", ...props }),
|
|
26
29
|
h2: (props) => _jsx(Heading, { as: "h2", ...props }),
|
|
27
30
|
h3: (props) => _jsx(Heading, { as: "h3", ...props }),
|
package/dist/navbar.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
|
|
2
|
-
import { AskAIButton, SearchButton } from "./controls";
|
|
2
|
+
import { AskAIButton, SearchButton } from "./internal/controls-client";
|
|
3
3
|
import { GitHubButton, getGithubRepoUrl } from "./internal/github-button";
|
|
4
4
|
import { DesktopMenu } from "./internal/navbar/desktop-menu";
|
|
5
5
|
import { MobileMenu } from "./internal/navbar/mobile-menu";
|
package/dist/pages/changelog.js
CHANGED
|
@@ -3,7 +3,7 @@ import { notFound, redirect } from "next/navigation";
|
|
|
3
3
|
import { getChangelogPage, getChangelogPageParams, getChangelogPagePath, getChangelogPath, parseChangelogPage, } from "../internal/changelog";
|
|
4
4
|
import { ChangelogFeed } from "../internal/changelog-feed";
|
|
5
5
|
import { getGeistdocsLanguageConfig, getLanguageStaticParams, omitLanguageParam, resolveRouteLanguage, } from "../internal/languages";
|
|
6
|
-
import { GeistdocsPageActions } from "../internal/page-actions-
|
|
6
|
+
import { GeistdocsPageActions } from "../internal/page-actions-gate";
|
|
7
7
|
const TRAILING_SLASH_PATTERN = /\/$/;
|
|
8
8
|
export const createChangelogPage = (options) => {
|
|
9
9
|
const { config, source, path = "/changelog", title = "Changelog", description = "The latest releases, improvements, and fixes.", getLang, markdownPath, dataPath, pageSize = 10, } = options;
|
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":"AACA,OAAO,EAEL,QAAQ,IAAI,gBAAgB,EAE7B,MAAM,+BAA+B,CAAC;
|
|
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,7 +1,6 @@
|
|
|
1
1
|
import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
|
|
2
2
|
import Link from "fumadocs-core/link";
|
|
3
3
|
import { DocsBody as FumadocsDocsBody, DocsPage as FumadocsDocsPage, DocsTitle as FumadocsDocsTitle, } from "fumadocs-ui/layouts/docs/page";
|
|
4
|
-
import { createRelativeLink } from "fumadocs-ui/mdx";
|
|
5
4
|
import { notFound } from "next/navigation";
|
|
6
5
|
import { cache, } from "react";
|
|
7
6
|
import { cn } from "#geistdocs-ui/utils";
|
|
@@ -14,11 +13,13 @@ import { omitLanguageParam, resolveRouteLanguage } from "../internal/languages";
|
|
|
14
13
|
import { resolveLinkHref, stripBasePathFromHref } from "../internal/link-href";
|
|
15
14
|
import { resolvePageMarkdownUrl as resolveInternalPageMarkdownUrl } from "../internal/markdown-url.js";
|
|
16
15
|
import { createPageActions as createInternalPageActions } from "../internal/page-actions";
|
|
17
|
-
import { GeistdocsPageActions
|
|
16
|
+
import { GeistdocsPageActions } from "../internal/page-actions-gate";
|
|
18
17
|
import { PageBreadcrumb } from "../internal/page-breadcrumb";
|
|
19
18
|
import { getPageFooterItems, PageFooter } from "../internal/page-footer";
|
|
20
19
|
import { filterPageTree } from "../internal/page-tree-visibility";
|
|
20
|
+
import { createRelativeDocsLink } from "../internal/relative-docs-link";
|
|
21
21
|
import { GeistdocsTableOfContents } from "../internal/table-of-contents";
|
|
22
|
+
import { GeistdocsTableOfContentsActions } from "../internal/toc-actions-client";
|
|
22
23
|
import { createMdxComponents } from "../mdx";
|
|
23
24
|
import { getPageRobots, } from "../page-visibility";
|
|
24
25
|
const renderPrefetchedDocsLink = (siteUrl, basePath, { children, className, href, rel, target, ...props }) => {
|
|
@@ -106,7 +107,7 @@ export const createDocsPage = ({ canViewPage, config, source, mdx, pageActions =
|
|
|
106
107
|
const pageTree = await getPageTree(resolvedParams);
|
|
107
108
|
const data = page.data;
|
|
108
109
|
const MDX = data.body;
|
|
109
|
-
const defaultLink =
|
|
110
|
+
const defaultLink = createRelativeDocsLink(source.source, page, DocsLink);
|
|
110
111
|
const link = resolveLink
|
|
111
112
|
? resolveLink({
|
|
112
113
|
link: defaultLink,
|
package/dist/routes/chat.d.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { type LanguageModel } from "ai";
|
|
2
2
|
import { type GeistdocsConfig } from "../config";
|
|
3
|
-
import { type ChatMixedbreadOptions } from "../internal/chat-retrieval";
|
|
4
3
|
import { type EveAgentClientContext } from "../internal/eve-agent";
|
|
4
|
+
import { type GeistdocsMixedbreadOptions } from "../internal/mixedbread-store";
|
|
5
5
|
import { type GeistdocsPageFilter } from "../page-visibility";
|
|
6
6
|
import type { GeistdocsSourceBundle } from "../source";
|
|
7
7
|
type SourceBundle = GeistdocsSourceBundle;
|
|
@@ -130,10 +130,10 @@ interface CreateChatRouteOptions {
|
|
|
130
130
|
*/
|
|
131
131
|
limits?: ChatRequestLimits;
|
|
132
132
|
/**
|
|
133
|
-
* Server-only Mixedbread overrides.
|
|
134
|
-
*
|
|
133
|
+
* Server-only Mixedbread overrides. `MXBAI_API_KEY` and `MXBAI_STORE_ID`
|
|
134
|
+
* fill omitted credentials.
|
|
135
135
|
*/
|
|
136
|
-
mixedbread?:
|
|
136
|
+
mixedbread?: GeistdocsMixedbreadOptions;
|
|
137
137
|
/**
|
|
138
138
|
* Model used to answer Ask AI requests in the default AI Gateway mode.
|
|
139
139
|
* Accepts any AI SDK `LanguageModel`, including AI Gateway model strings
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/routes/chat.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,aAAa,EAQnB,MAAM,IAAI,CAAC;AAGZ,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,WAAW,CAAC;
|
|
1
|
+
{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/routes/chat.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,aAAa,EAQnB,MAAM,IAAI,CAAC;AAGZ,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,WAAW,CAAC;AAWhE,OAAO,EAIL,KAAK,qBAAqB,EAU3B,MAAM,uBAAuB,CAAC;AAW/B,OAAO,EACL,KAAK,0BAA0B,EAEhC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD,KAAK,YAAY,GAAG,qBAAqB,CAAC;AA4B1C;;;GAGG;AACH,KAAK,mBAAmB,GACpB,WAAW,GACX,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;AAE/D,UAAU,eAAe;IACvB,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;GAOG;AACH,KAAK,oBAAoB,GAAG,MAAM,GAAG,WAAW,CAAC;AAEjD,+EAA+E;AAC/E,UAAU,uBAAuB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,2EAA2E;AAC3E,KAAK,iCAAiC,GAAG,CAAC,OAAO,EAAE;IACjD,WAAW,CAAC,EAAE,uBAAuB,CAAC;CACvC,KAAK,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAE7D,UAAU,mBAAmB;IAC3B;;;;;;;;;;;;;;OAcG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,iCAAiC,CAAC;IAC5D;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,UAAU,iBAAiB;IACzB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,UAAU,sBAAsB;IAC9B,MAAM,EAAE,IAAI,CACV,eAAe,EACb,IAAI,GACJ,UAAU,GACV,iBAAiB,GACjB,QAAQ,GACR,SAAS,GACT,cAAc,CACjB,CAAC;IACF;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;IACxC;;;OAGG;IACH,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,4DAA4D;IAC5D,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC;;;OAGG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B;;;OAGG;IACH,UAAU,CAAC,EAAE,0BAA0B,CAAC;IACxC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;CAC1B;AAstDD,eAAO,MAAM,eAAe,GAAI,wGAW7B,sBAAsB;gBAqBE,OAAO;;CAkMjC,CAAC"}
|
package/dist/routes/chat.js
CHANGED
|
@@ -8,6 +8,7 @@ import { createSourceChunk, createSourceChunks, } from "../internal/chat/source-
|
|
|
8
8
|
import { createChatDocumentSearch, } from "../internal/chat-retrieval";
|
|
9
9
|
import { buildEveAgentTranscript, capLastUserMessageText, createEmptyEveAgentSession, getEveAgentMessageMetadata, hasPriorEveAgentTurn, normalizeAgentUrl, prewarmExistingEveAgentSession, resolveEveAgentUrl, startOrContinueEveAgentSession, streamEveAgentTurn, } from "../internal/eve-agent";
|
|
10
10
|
import { CHAT_SECRET_ENV, createEveAgentSessionCookieCodec, EVE_AGENT_SESSION_COOKIE, isSameSessionTag, readCookieValues, serializeEveAgentSessionCookie, } from "../internal/eve-agent-session-cookie";
|
|
11
|
+
import { getReaderProvider, } from "../internal/mixedbread-store";
|
|
11
12
|
import { isPageVisibleForSurface, } from "../page-visibility";
|
|
12
13
|
const DEFAULT_CHAT_MODEL = "openai/gpt-5.6-sol";
|
|
13
14
|
const DEFAULT_MAX_REQUEST_BYTES = 1_000_000;
|
|
@@ -159,46 +160,30 @@ const searchDocsWithOrama = async ({ basePath, filterPage, lang, limit, query, s
|
|
|
159
160
|
})
|
|
160
161
|
.slice(0, limit);
|
|
161
162
|
};
|
|
162
|
-
const createDocumentSearch = ({ config, filterPage, mixedbread, sources, }) => {
|
|
163
|
-
|
|
163
|
+
const createDocumentSearch = ({ config, filterPage, mixedbread, sources, }) => createChatDocumentSearch({
|
|
164
|
+
basePath: config.basePath,
|
|
165
|
+
fallback: ({ lang, limit, query }) => searchDocsWithOrama({
|
|
164
166
|
basePath: config.basePath,
|
|
165
167
|
filterPage,
|
|
166
168
|
lang,
|
|
167
169
|
limit,
|
|
168
170
|
query,
|
|
169
171
|
sources,
|
|
170
|
-
})
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
},
|
|
186
|
-
provider: config.ai?.retrieval,
|
|
187
|
-
siteId: config.siteId,
|
|
188
|
-
});
|
|
189
|
-
return async (input) => {
|
|
190
|
-
const documents = await search({ ...input, limit: input.limit * 3 });
|
|
191
|
-
return documents
|
|
192
|
-
.filter((document) => sources.some((source) => {
|
|
193
|
-
const result = source.source.getPageByHref(document.slug, {
|
|
194
|
-
language: input.lang,
|
|
195
|
-
});
|
|
196
|
-
return Boolean(result?.page &&
|
|
197
|
-
isChatPageVisible(result.page, input.lang, source, filterPage));
|
|
198
|
-
}))
|
|
199
|
-
.slice(0, input.limit);
|
|
200
|
-
};
|
|
201
|
-
};
|
|
172
|
+
}),
|
|
173
|
+
filterPage,
|
|
174
|
+
mixedbread,
|
|
175
|
+
onWarning: (message, error) => {
|
|
176
|
+
if (error === undefined) {
|
|
177
|
+
console.warn(message);
|
|
178
|
+
}
|
|
179
|
+
else {
|
|
180
|
+
console.warn(message, error);
|
|
181
|
+
}
|
|
182
|
+
},
|
|
183
|
+
provider: getReaderProvider(config, "chat"),
|
|
184
|
+
siteId: config.siteId,
|
|
185
|
+
sources,
|
|
186
|
+
});
|
|
202
187
|
const formatDocForContext = (doc) => `**${doc.title}**\nURL: ${doc.url}\n${doc.description || ""}\n\n${doc.content.slice(0, MAX_CONTEXT_CHARS)}${doc.content.length > MAX_CONTEXT_CHARS ? "..." : ""}`;
|
|
203
188
|
const getRouteCandidates = ({ basePath, currentRoute, lang, }) => {
|
|
204
189
|
const pathname = normalizePathname(currentRoute);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../src/routes/openapi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,KAAK,eAAe,EAA+B,MAAM,WAAW,CAAC;AAS9E,eAAO,MAAM,yBAAyB,kBAAkB,CAAC;AAEzD,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,IAAI,CACV,eAAe,EACb,OAAO,GACP,IAAI,GACJ,UAAU,GACV,SAAS,GACT,iBAAiB,GACjB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,OAAO,GACP,cAAc,CACjB,CAAC;IACF;;;;;OAKG;IACH,SAAS,CAAC,EAAE;QACV,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,SAAS,CAAC,EAAE,CACV,QAAQ,EAAE,wBAAwB,EAClC,OAAO,EAAE;QAAE,OAAO,EAAE,WAAW,CAAA;KAAE,KAC9B,OAAO,CAAC,wBAAwB,CAAC,GAAG,wBAAwB,CAAC;CACnE;AAID,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C,UAAU,gBAAgB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE;QACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;KACrC,CAAC;IACF,IAAI,EAAE;QACJ,OAAO,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;QACxC,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;IACxD,QAAQ,EAAE,KAAK,EAAE,CAAC;IAClB,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAChD,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC/C;
|
|
1
|
+
{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../src/routes/openapi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,KAAK,eAAe,EAA+B,MAAM,WAAW,CAAC;AAS9E,eAAO,MAAM,yBAAyB,kBAAkB,CAAC;AAEzD,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,IAAI,CACV,eAAe,EACb,OAAO,GACP,IAAI,GACJ,UAAU,GACV,SAAS,GACT,iBAAiB,GACjB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,OAAO,GACP,cAAc,CACjB,CAAC;IACF;;;;;OAKG;IACH,SAAS,CAAC,EAAE;QACV,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,SAAS,CAAC,EAAE,CACV,QAAQ,EAAE,wBAAwB,EAClC,OAAO,EAAE;QAAE,OAAO,EAAE,WAAW,CAAA;KAAE,KAC9B,OAAO,CAAC,wBAAwB,CAAC,GAAG,wBAAwB,CAAC;CACnE;AAID,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C,UAAU,gBAAgB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE;QACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;KACrC,CAAC;IACF,IAAI,EAAE;QACJ,OAAO,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;QACxC,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;IACxD,QAAQ,EAAE,KAAK,EAAE,CAAC;IAClB,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAChD,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC/C;AAglBD,eAAO,MAAM,kBAAkB,GAAI,mCAIhC,yBAAyB;mBAmBE,WAAW;;;;;CA6BxC,CAAC"}
|
package/dist/routes/openapi.js
CHANGED
|
@@ -41,8 +41,9 @@ const present = (parts) => parts.filter((part) => Boolean(part));
|
|
|
41
41
|
const joinList = (parts) => parts.length > 2
|
|
42
42
|
? `${parts.slice(0, -1).join(", ")}, and ${parts.at(-1)}`
|
|
43
43
|
: parts.join(" and ");
|
|
44
|
+
const isSemanticSearch = (config) => config.search?.provider === "mixedbread";
|
|
44
45
|
/** Prose for the endpoint families the document actually lists. */
|
|
45
|
-
const describeEndpointFamilies = (endpoints) => {
|
|
46
|
+
const describeEndpointFamilies = (endpoints, config) => {
|
|
46
47
|
const apiPaths = present([
|
|
47
48
|
endpoints.search ? "`/api/search`" : undefined,
|
|
48
49
|
endpoints.chat ? `\`${endpoints.chatPath}\`` : undefined,
|
|
@@ -51,6 +52,9 @@ const describeEndpointFamilies = (endpoints) => {
|
|
|
51
52
|
endpoints.search ? "the `locale` parameter" : undefined,
|
|
52
53
|
endpoints.chat ? "the `currentRoute` field" : undefined,
|
|
53
54
|
]);
|
|
55
|
+
const searchLabel = isSemanticSearch(config)
|
|
56
|
+
? "semantic search"
|
|
57
|
+
: "full-text search";
|
|
54
58
|
return {
|
|
55
59
|
summary: joinList(present([
|
|
56
60
|
endpoints.search ? "Search" : undefined,
|
|
@@ -58,7 +62,7 @@ const describeEndpointFamilies = (endpoints) => {
|
|
|
58
62
|
"Markdown discovery",
|
|
59
63
|
])),
|
|
60
64
|
description: joinList(present([
|
|
61
|
-
endpoints.search ?
|
|
65
|
+
endpoints.search ? searchLabel : undefined,
|
|
62
66
|
endpoints.chat ? "the Ask AI assistant" : undefined,
|
|
63
67
|
"Markdown versions of every page",
|
|
64
68
|
])),
|
|
@@ -75,7 +79,7 @@ const buildInfo = (config, endpoints, origin) => {
|
|
|
75
79
|
.filter((lang) => lang !== defaultLanguage)
|
|
76
80
|
.map((lang) => `\`/${lang}\``)
|
|
77
81
|
.join(", ");
|
|
78
|
-
const families = describeEndpointFamilies(endpoints);
|
|
82
|
+
const families = describeEndpointFamilies(endpoints, config);
|
|
79
83
|
const description = [
|
|
80
84
|
`HTTP endpoints served by the ${name} documentation site: ${families.description}.`,
|
|
81
85
|
`This document describes the documentation site only. It does not describe a ${name} product API.`,
|
|
@@ -111,7 +115,9 @@ const buildSearchPath = (config) => {
|
|
|
111
115
|
operationId: "searchDocs",
|
|
112
116
|
tags: ["Search"],
|
|
113
117
|
summary: "Search the documentation",
|
|
114
|
-
description:
|
|
118
|
+
description: isSemanticSearch(config)
|
|
119
|
+
? "Runs a semantic search over all documentation pages and returns matching pages, headings, and text fragments ranked by relevance. Answers from full-text search when the semantic index cannot. Returns an empty array when `query` is omitted or empty."
|
|
120
|
+
: "Runs a full-text search over all documentation pages and returns matching pages, headings, and text fragments ranked by relevance. Returns an empty array when `query` is omitted or empty.",
|
|
115
121
|
parameters: [
|
|
116
122
|
{
|
|
117
123
|
name: "query",
|
|
@@ -435,7 +441,9 @@ const buildDocument = ({ config, endpoints, origin, selfPath, }) => {
|
|
|
435
441
|
schemas.add("SearchResult");
|
|
436
442
|
tags.push({
|
|
437
443
|
name: "Search",
|
|
438
|
-
description:
|
|
444
|
+
description: isSemanticSearch(config)
|
|
445
|
+
? "Semantic search over the documentation."
|
|
446
|
+
: "Full-text search over the documentation.",
|
|
439
447
|
});
|
|
440
448
|
}
|
|
441
449
|
if (endpoints.chat) {
|
|
@@ -2,7 +2,7 @@ import { type GeistdocsConfig } from "../config";
|
|
|
2
2
|
import { type GeistdocsPageFilter } from "../page-visibility";
|
|
3
3
|
import type { GeistdocsSourceBundle } from "../source";
|
|
4
4
|
interface CreateSearchExportRouteOptions {
|
|
5
|
-
config: Pick<GeistdocsConfig, "ai" | "basePath" | "defaultLanguage" | "siteId" | "translations">;
|
|
5
|
+
config: Pick<GeistdocsConfig, "ai" | "basePath" | "defaultLanguage" | "search" | "siteId" | "translations">;
|
|
6
6
|
filterPage?: GeistdocsPageFilter;
|
|
7
7
|
source?: GeistdocsSourceBundle;
|
|
8
8
|
sources?: GeistdocsSourceBundle[];
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"search-export.d.ts","sourceRoot":"","sources":["../../src/routes/search-export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,WAAW,CAAC;
|
|
1
|
+
{"version":3,"file":"search-export.d.ts","sourceRoot":"","sources":["../../src/routes/search-export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,WAAW,CAAC;AAOhE,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD,UAAU,8BAA8B;IACtC,MAAM,EAAE,IAAI,CACV,eAAe,EACf,IAAI,GAAG,UAAU,GAAG,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,GAAG,cAAc,CAC7E,CAAC;IACF,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,OAAO,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACnC;AAwBD,eAAO,MAAM,uBAAuB,GAAI,0CAKrC,8BAA8B;;CAiDhC,CAAC"}
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { getPublicPath } from "../config";
|
|
2
|
+
import { getMixedbreadReaders } from "../internal/mixedbread-store";
|
|
2
3
|
import { GEISTDOCS_SEARCH_EXPORT_VERSION, } from "../internal/search-export";
|
|
3
4
|
import { isPageVisibleForSurface, } from "../page-visibility";
|
|
4
5
|
const resolveSources = (source, sources) => {
|
|
@@ -14,12 +15,14 @@ const getLanguages = (config) => {
|
|
|
14
15
|
};
|
|
15
16
|
export const createSearchExportRoute = ({ config, filterPage, source, sources, }) => {
|
|
16
17
|
const routeSources = resolveSources(source, sources);
|
|
18
|
+
const readers = getMixedbreadReaders(config);
|
|
19
|
+
const surfaces = readers.length > 0 ? readers : ["chat"];
|
|
17
20
|
const GET = async () => {
|
|
18
21
|
const documents = await Promise.all(getLanguages(config).flatMap((locale) => routeSources.flatMap((entry, sourceIndex) => {
|
|
19
22
|
const sourceId = entry.id ?? `source-${sourceIndex + 1}`;
|
|
20
23
|
return entry.source
|
|
21
24
|
.getPages(locale)
|
|
22
|
-
.filter((page) => isPageVisibleForSurface(page,
|
|
25
|
+
.filter((page) => surfaces.some((surface) => isPageVisibleForSurface(page, surface)) &&
|
|
23
26
|
(filterPage?.(page, { lang: locale, source: entry }) ?? true))
|
|
24
27
|
.map(async (page) => ({
|
|
25
28
|
content: await entry.getPageMarkdown(page),
|
|
@@ -35,7 +38,7 @@ export const createSearchExportRoute = ({ config, filterPage, source, sources, }
|
|
|
35
38
|
documents.sort((left, right) => left.id.localeCompare(right.id));
|
|
36
39
|
const exported = {
|
|
37
40
|
documents,
|
|
38
|
-
provider:
|
|
41
|
+
provider: readers.length > 0 ? "mixedbread" : "local",
|
|
39
42
|
siteId: config.siteId,
|
|
40
43
|
version: GEISTDOCS_SEARCH_EXPORT_VERSION,
|
|
41
44
|
};
|
package/dist/routes/search.d.ts
CHANGED
|
@@ -1,15 +1,23 @@
|
|
|
1
1
|
import type { GeistdocsConfig } from "../config";
|
|
2
|
+
import { type GeistdocsMixedbreadOptions } from "../internal/mixedbread-store";
|
|
2
3
|
import { type GeistdocsPageFilter } from "../page-visibility";
|
|
3
4
|
import { type GeistdocsSourceBundle } from "../source";
|
|
4
5
|
type SourceBundle = GeistdocsSourceBundle;
|
|
5
6
|
type SearchSource = SourceBundle["source"];
|
|
6
7
|
type SearchSourceInput = SearchSource | SourceBundle;
|
|
8
|
+
type SearchGET = (request: Request) => Promise<Response>;
|
|
7
9
|
interface CreateSearchRouteOptions {
|
|
8
|
-
config: Pick<GeistdocsConfig, "defaultLanguage" | "translations">;
|
|
10
|
+
config: Pick<GeistdocsConfig, "defaultLanguage" | "search" | "siteId" | "translations">;
|
|
9
11
|
filterPage?: GeistdocsPageFilter<ReturnType<SearchSource["getPages"]>[number], SearchSourceInput>;
|
|
12
|
+
/**
|
|
13
|
+
* Server-only Mixedbread overrides, used when `config.search.provider` is
|
|
14
|
+
* `"mixedbread"`. `MXBAI_API_KEY` and `MXBAI_STORE_ID` fill omitted
|
|
15
|
+
* credentials.
|
|
16
|
+
*/
|
|
17
|
+
mixedbread?: GeistdocsMixedbreadOptions;
|
|
10
18
|
source?: SearchSourceInput;
|
|
11
19
|
sources?: SearchSourceInput[];
|
|
12
20
|
}
|
|
13
|
-
export declare const createSearchRoute: ({ config, filterPage, source, sources, }: CreateSearchRouteOptions) =>
|
|
21
|
+
export declare const createSearchRoute: ({ config, filterPage, mixedbread, source, sources, }: CreateSearchRouteOptions) => SearchGET;
|
|
14
22
|
export {};
|
|
15
23
|
//# sourceMappingURL=search.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/routes/search.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/routes/search.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAEL,KAAK,0BAA0B,EAKhC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,KAAK,qBAAqB,EAA2B,MAAM,WAAW,CAAC;AAEhF,KAAK,YAAY,GAAG,qBAAqB,CAAC;AAC1C,KAAK,YAAY,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;AAC3C,KAAK,iBAAiB,GAAG,YAAY,GAAG,YAAY,CAAC;AACrD,KAAK,SAAS,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAIzD,UAAU,wBAAwB;IAChC,MAAM,EAAE,IAAI,CACV,eAAe,EACf,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,GAAG,cAAc,CACzD,CAAC;IACF,UAAU,CAAC,EAAE,mBAAmB,CAC9B,UAAU,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,EAC5C,iBAAiB,CAClB,CAAC;IACF;;;;OAIG;IACH,UAAU,CAAC,EAAE,0BAA0B,CAAC;IACxC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AA6ND,eAAO,MAAM,iBAAiB,GAAI,sDAM/B,wBAAwB,KAAG,SA+J7B,CAAC"}
|