@vercel/geistdocs 1.25.1-canary.eec231d → 1.25.1-canary.fb7a9dd

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (112) hide show
  1. package/dist/cli/index.js +1 -1
  2. package/dist/components/code-block-tabs.js +1 -1
  3. package/dist/components/code-block.d.ts.map +1 -1
  4. package/dist/components/code-block.js +1 -1
  5. package/dist/components/copy-prompt.js +1 -1
  6. package/dist/components/image.d.ts +19 -0
  7. package/dist/components/image.d.ts.map +1 -0
  8. package/dist/components/image.js +9 -0
  9. package/dist/components/steps.d.ts +9 -0
  10. package/dist/components/steps.d.ts.map +1 -0
  11. package/dist/components/steps.js +9 -0
  12. package/dist/internal/chat/activity.d.ts +20 -0
  13. package/dist/internal/chat/activity.d.ts.map +1 -0
  14. package/dist/internal/chat/activity.js +43 -0
  15. package/dist/internal/chat/message-metadata.d.ts.map +1 -1
  16. package/dist/internal/chat/message-metadata.js +15 -30
  17. package/dist/internal/chat/message-sources.d.ts +3 -0
  18. package/dist/internal/chat/message-sources.d.ts.map +1 -0
  19. package/dist/internal/chat/message-sources.js +23 -0
  20. package/dist/internal/chat/message.d.ts.map +1 -1
  21. package/dist/internal/chat/message.js +44 -10
  22. package/dist/internal/chat/shell.d.ts.map +1 -1
  23. package/dist/internal/chat/shell.js +7 -2
  24. package/dist/internal/chat/source-chunks.d.ts +9 -0
  25. package/dist/internal/chat/source-chunks.d.ts.map +1 -0
  26. package/dist/internal/chat/source-chunks.js +7 -0
  27. package/dist/internal/chat/sources.d.ts +1 -1
  28. package/dist/internal/chat/sources.d.ts.map +1 -1
  29. package/dist/internal/chat/sources.js +6 -3
  30. package/dist/internal/link-href.d.ts +13 -0
  31. package/dist/internal/link-href.d.ts.map +1 -0
  32. package/dist/internal/link-href.js +51 -0
  33. package/dist/internal/mdx-to-markdown.d.ts +3 -0
  34. package/dist/internal/mdx-to-markdown.d.ts.map +1 -0
  35. package/dist/internal/mdx-to-markdown.js +166 -0
  36. package/dist/internal/mousedown-navigation-utils.d.ts +5 -0
  37. package/dist/internal/mousedown-navigation-utils.d.ts.map +1 -0
  38. package/dist/internal/mousedown-navigation-utils.js +95 -0
  39. package/dist/internal/mousedown-navigation.d.ts +10 -0
  40. package/dist/internal/mousedown-navigation.d.ts.map +1 -0
  41. package/dist/internal/mousedown-navigation.js +42 -0
  42. package/dist/internal/navbar/navbar-shell.d.ts.map +1 -1
  43. package/dist/internal/navbar/navbar-shell.js +2 -1
  44. package/dist/internal/provider-client.d.ts.map +1 -1
  45. package/dist/internal/provider-client.js +1 -11
  46. package/dist/internal/react-node-text.d.ts +4 -0
  47. package/dist/internal/react-node-text.d.ts.map +1 -0
  48. package/dist/internal/react-node-text.js +11 -0
  49. package/dist/internal/search.js +1 -1
  50. package/dist/internal/sidebar-tree.d.ts.map +1 -1
  51. package/dist/internal/sidebar-tree.js +6 -1
  52. package/dist/internal/sidebar.d.ts.map +1 -1
  53. package/dist/internal/sidebar.js +15 -14
  54. package/dist/internal/table-of-contents-visibility.d.ts +27 -0
  55. package/dist/internal/table-of-contents-visibility.d.ts.map +1 -0
  56. package/dist/internal/table-of-contents-visibility.js +15 -0
  57. package/dist/internal/toc-items.d.ts.map +1 -1
  58. package/dist/internal/toc-items.js +2 -1
  59. package/dist/mdx.d.ts +1 -0
  60. package/dist/mdx.d.ts.map +1 -1
  61. package/dist/mdx.js +5 -0
  62. package/dist/page.d.ts +35 -0
  63. package/dist/page.d.ts.map +1 -0
  64. package/dist/page.js +26 -0
  65. package/dist/pages/docs.d.ts +6 -0
  66. package/dist/pages/docs.d.ts.map +1 -1
  67. package/dist/pages/docs.js +28 -15
  68. package/dist/routes/chat.d.ts.map +1 -1
  69. package/dist/routes/chat.js +30 -13
  70. package/dist/routes/llms.d.ts +1 -1
  71. package/dist/routes/llms.d.ts.map +1 -1
  72. package/dist/routes/llms.js +12 -2
  73. package/dist/source-config.d.ts +11 -0
  74. package/dist/source-config.d.ts.map +1 -1
  75. package/dist/source-config.js +21 -2
  76. package/dist/source.d.ts +10 -1
  77. package/dist/source.d.ts.map +1 -1
  78. package/dist/source.js +75 -34
  79. package/dist/versions.js +2 -2
  80. package/docs/agents.md +6 -3
  81. package/docs/llms.txt +464 -28
  82. package/docs/manifest.json +30 -3
  83. package/docs/pages/components/steps.md +129 -0
  84. package/docs/pages/deployment.md +30 -5
  85. package/docs/pages/getting-started.md +38 -12
  86. package/docs/pages/guides/hidden-outline.md +31 -0
  87. package/docs/pages/guides/nested-navigation.md +1 -1
  88. package/docs/pages/md.md +24 -5
  89. package/docs/pages/migration-2.md +106 -0
  90. package/docs/pages/migration.md +5 -2
  91. package/docs/pages/syntax.md +42 -0
  92. package/docs/pages/table-of-contents.md +40 -0
  93. package/docs/sitemap.md +5 -2
  94. package/package.json +19 -5
  95. package/source-config.js +38 -2
  96. package/template/app/[lang]/docs/custom-page/page.tsx +49 -0
  97. package/template/content/docs/components/meta.json +4 -0
  98. package/template/content/docs/components/steps.mdx +125 -0
  99. package/template/content/docs/deployment.mdx +31 -6
  100. package/template/content/docs/getting-started.mdx +39 -13
  101. package/template/content/docs/guides/hidden-outline.mdx +28 -0
  102. package/template/content/docs/guides/meta.json +1 -1
  103. package/template/content/docs/guides/nested-navigation.mdx +1 -1
  104. package/template/content/docs/md.mdx +24 -5
  105. package/template/content/docs/meta.json +3 -0
  106. package/template/content/docs/migration-2.mdx +106 -0
  107. package/template/content/docs/migration.mdx +5 -1
  108. package/template/content/docs/syntax.mdx +42 -0
  109. package/template/content/docs/table-of-contents.mdx +40 -0
  110. package/template/next.config.ts +9 -0
  111. package/template/package.json +4 -4
  112. package/theme.css +56 -4
@@ -4,6 +4,7 @@ import { cn } from "@vercel/geistcn/utils";
4
4
  import { TOCItem as TOCItemLink, useActiveAnchors, } from "fumadocs-core/toc";
5
5
  import { useTOCItems } from "fumadocs-ui/components/toc/index";
6
6
  import { useCallback, useEffect, useRef, useState, } from "react";
7
+ import { reactNodeToText } from "./react-node-text";
7
8
  // Text indentation per heading depth; the guide rail stays straight.
8
9
  const getItemOffset = (depth) => {
9
10
  if (depth <= 2) {
@@ -17,7 +18,7 @@ const getItemOffset = (depth) => {
17
18
  // Ignore programmatic scrolling this long after a click/deep-link so the jump
18
19
  // to the anchor does not immediately release the selection.
19
20
  const ANCHOR_SCROLL_MS = 600;
20
- const TOCItem = ({ item, active, onSelect, }) => (_jsx(TOCItemLink, { className: "prose wrap-anywhere border-fd-foreground/10 border-s py-1.5 text-gray-900 text-sm transition-colors first:pt-0 last:pb-0 hover:text-fd-accent-foreground data-[active=true]:border-fd-primary data-[active=true]:text-fd-primary", "data-active": active ? "true" : undefined, href: item.url, onClick: onSelect, style: { paddingInlineStart: getItemOffset(item.depth) }, children: item.title }));
21
+ const TOCItem = ({ item, active, onSelect, }) => (_jsx(TOCItemLink, { className: "prose wrap-anywhere border-fd-foreground/10 border-s py-1.5 text-gray-900 text-sm transition-colors first:pt-0 last:pb-0 hover:text-fd-accent-foreground data-[active=true]:border-fd-primary data-[active=true]:text-fd-primary", "data-active": active ? "true" : undefined, href: item.url, onClick: onSelect, style: { paddingInlineStart: getItemOffset(item.depth) }, children: reactNodeToText(item.title) }));
21
22
  export const TOCItems = ({ className, ...props }) => {
22
23
  const items = useTOCItems();
23
24
  const anchors = useActiveAnchors();
package/dist/mdx.d.ts CHANGED
@@ -23,6 +23,7 @@ export declare const geistdocsFrontmatterSchema: import("zod").ZodObject<{
23
23
  related: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
24
24
  summary: import("zod").ZodOptional<import("zod").ZodString>;
25
25
  lastModified: import("zod").ZodOptional<import("zod").ZodCoercedDate<unknown>>;
26
+ tableOfContents: import("zod").ZodOptional<import("zod").ZodBoolean>;
26
27
  internal: import("zod").ZodOptional<import("zod").ZodBoolean>;
27
28
  noindex: import("zod").ZodOptional<import("zod").ZodBoolean>;
28
29
  tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
package/dist/mdx.d.ts.map CHANGED
@@ -1 +1 @@
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"}
1
+ {"version":3,"file":"mdx.d.ts","sourceRoot":"","sources":["../src/mdx.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAwB/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,sBAoDD,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
@@ -8,7 +8,9 @@ import { CodeBlock } from "./components/code-block";
8
8
  import { CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, CompactCodeBlockTabs, } from "./components/code-block-tabs";
9
9
  import { CopyPrompt } from "./components/copy-prompt";
10
10
  import { Heading } from "./components/heading";
11
+ import { Image } from "./components/image";
11
12
  import { Mermaid } from "./components/mermaid";
13
+ import { Step, Steps } from "./components/steps";
12
14
  import { Table } from "./components/table";
13
15
  import { Video } from "./components/video";
14
16
  import { LocalizedLink } from "./internal/localized-link";
@@ -40,7 +42,10 @@ export const getGeistdocsMDXComponents = (components) => ({
40
42
  CalloutTitle,
41
43
  CalloutDescription,
42
44
  CopyPrompt,
45
+ Image,
43
46
  Mermaid,
47
+ Steps,
48
+ Step,
44
49
  Video,
45
50
  ...components,
46
51
  });
package/dist/page.d.ts ADDED
@@ -0,0 +1,35 @@
1
+ import type { TableOfContents } from "fumadocs-core/toc";
2
+ import { DocsBody as FumadocsDocsBody, DocsDescription as FumadocsDocsDescription, DocsTitle as FumadocsDocsTitle } from "fumadocs-ui/layouts/docs/page";
3
+ import type { ComponentProps, ReactNode } from "react";
4
+ export interface GeistdocsPageTableOfContentsOptions {
5
+ /** Rendered below the outline, after the page actions. */
6
+ footer?: ReactNode;
7
+ /** Rendered above the outline. */
8
+ header?: ReactNode;
9
+ }
10
+ export interface GeistdocsPageProps {
11
+ /** Breadcrumb rendered above the page content. Omit to hide it. */
12
+ breadcrumb?: ReactNode;
13
+ children: ReactNode;
14
+ /** Footer rendered below the page content, such as previous/next links. */
15
+ footer?: ReactNode;
16
+ /**
17
+ * Show the "On this page" outline. Pass `false` to hide it and let the
18
+ * content span its column, or an options object to customize a visible
19
+ * outline. Defaults to shown.
20
+ */
21
+ tableOfContents?: boolean | GeistdocsPageTableOfContentsOptions;
22
+ /** Outline items; usually the `toc` export from a compiled MDX page. */
23
+ toc?: TableOfContents;
24
+ }
25
+ /**
26
+ * Page shell for App Router routes that render inside `GeistdocsDocsLayout`
27
+ * without going through `createDocsPage`, such as landing pages built in
28
+ * TSX. Applies the same layout and table-of-contents behavior as MDX pages.
29
+ */
30
+ export declare const GeistdocsPage: ({ breadcrumb, children, footer, tableOfContents, toc, }: GeistdocsPageProps) => import("react/jsx-runtime").JSX.Element;
31
+ export declare const GeistdocsPageTitle: ({ className, ...props }: ComponentProps<typeof FumadocsDocsTitle>) => import("react/jsx-runtime").JSX.Element;
32
+ export declare const GeistdocsPageDescription: ({ className, ...props }: ComponentProps<typeof FumadocsDocsDescription>) => import("react/jsx-runtime").JSX.Element;
33
+ /** Prose container for page content; MDX pages render their body inside it. */
34
+ export declare const GeistdocsPageBody: ({ className, ...props }: ComponentProps<typeof FumadocsDocsBody>) => import("react/jsx-runtime").JSX.Element;
35
+ //# sourceMappingURL=page.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../src/page.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EACL,QAAQ,IAAI,gBAAgB,EAC5B,eAAe,IAAI,uBAAuB,EAE1C,SAAS,IAAI,iBAAiB,EAC/B,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMvD,MAAM,WAAW,mCAAmC;IAClD,0DAA0D;IAC1D,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,kCAAkC;IAClC,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,QAAQ,EAAE,SAAS,CAAC;IACpB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,GAAG,mCAAmC,CAAC;IAChE,wEAAwE;IACxE,GAAG,CAAC,EAAE,eAAe,CAAC;CACvB;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,yDAM3B,kBAAkB,4CAgCpB,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,yBAGhC,cAAc,CAAC,OAAO,iBAAiB,CAAC,4CAK1C,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,yBAGtC,cAAc,CAAC,OAAO,uBAAuB,CAAC,4CAKhD,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,iBAAiB,GAAI,yBAG/B,cAAc,CAAC,OAAO,gBAAgB,CAAC,4CAEzC,CAAC"}
package/dist/page.js ADDED
@@ -0,0 +1,26 @@
1
+ import { jsx as _jsx } from "react/jsx-runtime";
2
+ import { cn } from "@vercel/geistcn/utils";
3
+ import { DocsBody as FumadocsDocsBody, DocsDescription as FumadocsDocsDescription, DocsPage as FumadocsDocsPage, DocsTitle as FumadocsDocsTitle, } from "fumadocs-ui/layouts/docs/page";
4
+ import { GeistdocsTableOfContents } from "./internal/table-of-contents";
5
+ import { resolveTableOfContentsEnabled } from "./internal/table-of-contents-visibility";
6
+ /**
7
+ * Page shell for App Router routes that render inside `GeistdocsDocsLayout`
8
+ * without going through `createDocsPage`, such as landing pages built in
9
+ * TSX. Applies the same layout and table-of-contents behavior as MDX pages.
10
+ */
11
+ export const GeistdocsPage = ({ breadcrumb, children, footer, tableOfContents, toc = [], }) => {
12
+ const tocOptions = typeof tableOfContents === "object" ? tableOfContents : undefined;
13
+ const tocEnabled = resolveTableOfContentsEnabled({
14
+ pageEnabled: typeof tableOfContents === "boolean" ? tableOfContents : undefined,
15
+ });
16
+ const tableOfContent = {
17
+ enabled: tocEnabled,
18
+ single: true,
19
+ component: (_jsx(GeistdocsTableOfContents, { footer: tocOptions?.footer, header: tocOptions?.header, toc: toc })),
20
+ };
21
+ return (_jsx(FumadocsDocsPage, { breadcrumb: breadcrumb ? { component: breadcrumb } : { enabled: false }, footer: footer ? { component: footer } : { enabled: false }, full: !tocEnabled, tableOfContent: tableOfContent, tableOfContentPopover: { enabled: false }, toc: toc, children: children }));
22
+ };
23
+ export const GeistdocsPageTitle = ({ className, ...props }) => (_jsx(FumadocsDocsTitle, { className: cn("mb-4 text-balance", className), ...props }));
24
+ export const GeistdocsPageDescription = ({ className, ...props }) => (_jsx(FumadocsDocsDescription, { className: cn("text-gray-900", className), ...props }));
25
+ /** Prose container for page content; MDX pages render their body inside it. */
26
+ export const GeistdocsPageBody = ({ className, ...props }) => (_jsx(FumadocsDocsBody, { className: cn("mx-auto w-full", className), ...props }));
@@ -45,7 +45,13 @@ interface DocsPageData extends GeistdocsPageVisibilityData {
45
45
  components?: MDXComponents;
46
46
  }>;
47
47
  description?: string;
48
+ /** Fumadocs `full`; read as an alias for `tableOfContents: false`. */
48
49
  full?: boolean;
50
+ /**
51
+ * Frontmatter `tableOfContents`; when `false` the outline is hidden and the
52
+ * content spans its column.
53
+ */
54
+ tableOfContents?: boolean;
49
55
  title: string;
50
56
  toc: ComponentProps<typeof FumadocsDocsPage>["toc"];
51
57
  }
@@ -1 +1 @@
1
- {"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/pages/docs.tsx"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/pages/docs.tsx"],"names":[],"mappings":"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"}
@@ -1,35 +1,39 @@
1
1
  import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
2
2
  import { cn } from "@vercel/geistcn/utils";
3
3
  import Link from "fumadocs-core/link";
4
- import { DocsBody as FumadocsDocsBody, DocsDescription as FumadocsDocsDescription, DocsPage as FumadocsDocsPage, DocsTitle as FumadocsDocsTitle, } from "fumadocs-ui/layouts/docs/page";
4
+ import { DocsPage as FumadocsDocsPage } from "fumadocs-ui/layouts/docs/page";
5
5
  import { createRelativeLink } from "fumadocs-ui/mdx";
6
6
  import { notFound } from "next/navigation";
7
7
  import { getPublicPath, withBasePath } from "../config";
8
8
  import { DocsPageErrorBoundary } from "../internal/docs-page-error-boundary";
9
9
  import { resolveDocumentTitle } from "../internal/document-title";
10
+ import { resolveLinkHref, stripBasePathFromHref } from "../internal/link-href";
10
11
  import { resolvePageMarkdownUrl as resolveInternalPageMarkdownUrl } from "../internal/markdown-url.js";
11
12
  import { createPageActions as createInternalPageActions } from "../internal/page-actions";
12
13
  import { GeistdocsPageActions, GeistdocsTableOfContentsActions, } from "../internal/page-actions-client";
13
14
  import { PageBreadcrumb } from "../internal/page-breadcrumb";
14
15
  import { getPageFooterItems, PageFooter } from "../internal/page-footer";
15
16
  import { GeistdocsTableOfContents } from "../internal/table-of-contents";
17
+ import { resolveTableOfContents } from "../internal/table-of-contents-visibility";
16
18
  import { createMdxComponents } from "../mdx";
19
+ import { GeistdocsPageBody as DocsBody, GeistdocsPageDescription as DocsDescription, GeistdocsPageTitle as DocsTitle, } from "../page";
17
20
  import { getPageRobots, } from "../page-visibility";
18
- const HTTP_URL = /^https?:\/\//;
19
- const PrefetchedDocsLink = ({ children, className, href, ...props }) => {
20
- const external = typeof href === "string" && HTTP_URL.test(href);
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 }));
21
+ const renderPrefetchedDocsLink = (siteUrl, basePath, { children, className, href, rel, target, ...props }) => {
22
+ const originalHref = String(href ?? "");
23
+ const resolved = resolveLinkHref(originalHref, siteUrl);
24
+ const linkHref = resolved.href === originalHref
25
+ ? resolved.href
26
+ : stripBasePathFromHref(resolved.href, basePath);
27
+ 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: linkHref, prefetch: !resolved.external, rel: resolved.external ? rel : undefined, target: resolved.external ? target : undefined, children: children }));
22
28
  };
23
29
  export const resolvePageMarkdownUrl = (options) => resolveInternalPageMarkdownUrl(options);
24
- const DocsTitle = ({ className, ...props }) => (_jsx(FumadocsDocsTitle, { className: cn("mb-4 text-balance", className), ...props }));
25
- const DocsDescription = ({ className, ...props }) => (_jsx(FumadocsDocsDescription, { className: cn("text-gray-900", className), ...props }));
26
- const DocsBody = ({ className, ...props }) => (_jsx(FumadocsDocsBody, { className: cn("mx-auto w-full", className), ...props }));
27
30
  /** App-provided footer content below the table-of-contents actions. */
28
31
  const TocFooterSlot = ({ children }) => children ? _jsx("div", { className: "mt-4", children: children }) : null;
29
32
  const hasTableOfContentsActions = (config, extraActions) => config.pageActions?.scrollTop !== false ||
30
33
  config.feedback?.enabled !== false ||
31
34
  extraActions.length > 0;
32
35
  export const createDocsPage = ({ config, source, mdx, pageActions = createInternalPageActions({ config }), filterStaticParams, getMarkdownUrl, getPageUrl, getPublicPageUrl, metadata, openGraph, renderTop, resolveLink, tableOfContent, tableOfContentPopover, }) => {
36
+ const DocsLink = renderPrefetchedDocsLink.bind(null, config.siteUrl, config.basePath);
33
37
  const resolvePageUrls = (page, params) => {
34
38
  const pageUrl = getPageUrl?.({ page, params }) ?? page.url;
35
39
  const publicPageUrl = getPublicPageUrl?.({ page, params, pageUrl }) ??
@@ -52,7 +56,7 @@ export const createDocsPage = ({ config, source, mdx, pageActions = createIntern
52
56
  }
53
57
  const data = page.data;
54
58
  const MDX = data.body;
55
- const defaultLink = createRelativeLink(source.source, page, PrefetchedDocsLink);
59
+ const defaultLink = createRelativeLink(source.source, page, DocsLink);
56
60
  const link = resolveLink
57
61
  ? resolveLink({ link: defaultLink, page, source })
58
62
  : defaultLink;
@@ -95,22 +99,31 @@ export const createDocsPage = ({ config, source, mdx, pageActions = createIntern
95
99
  }) ?? [])
96
100
  : [];
97
101
  const hasTocActions = hasTableOfContentsActions(pageActions.config, footerActions);
102
+ // A hidden outline stays hidden everywhere: the desktop column and any
103
+ // app-rendered surfaces such as the mobile docs bar read the same list.
104
+ const { enabled: tocEnabled, items: visibleToc } = resolveTableOfContents(data.toc, {
105
+ appEnabled: tableOfContent?.enabled,
106
+ full: data.full,
107
+ pageEnabled: data.tableOfContents,
108
+ });
109
+ const pageData = { ...data, toc: visibleToc };
110
+ const hasTocLinks = visibleToc.length > 0;
98
111
  // Actions stay adjacent to the table of contents; the app-provided
99
112
  // footer (promos and other custom content) renders below them.
100
- 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 tocComponent = tableOfContent?.component ?? (_jsx(GeistdocsTableOfContents, { footer: tocFooter, header: tableOfContent?.header, toc: data.toc ?? [] }));
113
+ 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 })] }));
114
+ const tocComponent = tableOfContent?.component ?? (_jsx(GeistdocsTableOfContents, { footer: tocFooter, header: tableOfContent?.header, toc: visibleToc }));
102
115
  return (_jsxs(FumadocsDocsPage, { breadcrumb: {
103
116
  component: (_jsx(PageBreadcrumb, { tree: source.source.getPageTree(lang), url: page.url })),
104
- }, footer: { component: _jsx(PageFooter, { ...resolvedFooterItems }) }, full: data.full, tableOfContent: {
105
- enabled: true,
117
+ }, footer: { component: _jsx(PageFooter, { ...resolvedFooterItems }) }, full: !tocEnabled, tableOfContent: {
106
118
  single: true,
107
119
  ...tableOfContent,
120
+ enabled: tocEnabled,
108
121
  component: tocComponent,
109
122
  }, tableOfContentPopover: {
110
123
  enabled: false,
111
124
  ...tableOfContentPopover,
112
- }, toc: data.toc, children: [renderTop?.({
113
- data,
125
+ }, toc: visibleToc, children: [renderTop?.({
126
+ data: pageData,
114
127
  markdown: markdown ?? "",
115
128
  markdownUrl,
116
129
  page,
@@ -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;AAShE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD,KAAK,YAAY,GAAG,qBAAqB,CAAC;AAyB1C,UAAU,eAAe;IACvB,OAAO,CAAC,EAAE,WAAW,GAAG,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IACnE,GAAG,EAAE,MAAM,CAAC;CACb;AAED,UAAU,mBAAmB;IAC3B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,WAAW,GAAG,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IACnE,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,UAAU,sBAAsB;IAC9B,MAAM,EAAE,IAAI,CACV,eAAe,EACf,IAAI,GAAG,UAAU,GAAG,iBAAiB,GAAG,cAAc,CACvD,CAAC;IACF;;;OAGG;IACH,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B;;;;;;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;AAm0BD,eAAO,MAAM,eAAe,GAAI,sDAO7B,sBAAsB;gBASE,OAAO;;CA0JjC,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;AAahE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD,KAAK,YAAY,GAAG,qBAAqB,CAAC;AAyB1C,UAAU,eAAe;IACvB,OAAO,CAAC,EAAE,WAAW,GAAG,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IACnE,GAAG,EAAE,MAAM,CAAC;CACb;AAED,UAAU,mBAAmB;IAC3B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,WAAW,GAAG,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IACnE,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,UAAU,sBAAsB;IAC9B,MAAM,EAAE,IAAI,CACV,eAAe,EACf,IAAI,GAAG,UAAU,GAAG,iBAAiB,GAAG,cAAc,CACvD,CAAC;IACF;;;OAGG;IACH,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B;;;;;;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;AAk0BD,eAAO,MAAM,eAAe,GAAI,sDAO7B,sBAAsB;gBASE,OAAO;;CA+KjC,CAAC"}
@@ -3,6 +3,7 @@ import { convertToModelMessages, createUIMessageStream, createUIMessageStreamRes
3
3
  import { initAdvancedSearch } from "fumadocs-core/search/server";
4
4
  import { z } from "zod";
5
5
  import { getPublicPath } from "../config";
6
+ import { createSourceChunk, createSourceChunks, } from "../internal/chat/source-chunks";
6
7
  import { buildEveAgentTranscript, capLastUserMessageText, getEveAgentSessionHandle, resolveEveAgentUrl, runEveAgentTurn, } from "../internal/eve-agent";
7
8
  import { isPageVisibleForSurface } from "../page-visibility";
8
9
  const DEFAULT_CHAT_MODEL = "openai/gpt-5.6-sol";
@@ -178,12 +179,6 @@ const getCurrentPageDoc = async ({ basePath, currentRoute, lang, pageContext, so
178
179
  };
179
180
  };
180
181
  const isFirstUserMessage = (messages) => messages.filter((message) => message.role === "user").length === 1;
181
- const createSourceChunks = (docs) => docs.map((doc, index) => ({
182
- type: "source-url",
183
- sourceId: `doc-${index}-${doc.slug}`,
184
- url: doc.url,
185
- title: doc.title,
186
- }));
187
182
  const buildProxyMessages = async ({ actualMessages, config, currentRoute, defaultLanguage, languages, pageContext, routeSources, }) => {
188
183
  if (!isFirstUserMessage(actualMessages)) {
189
184
  return { messages: actualMessages, sourceDocs: [] };
@@ -406,12 +401,7 @@ const createTools = (writer, sources, defaultLanguage, basePath) => {
406
401
  return `No documentation found for query: "${query}"`;
407
402
  }
408
403
  for (const [index, doc] of trimmedResults.entries()) {
409
- writer.write({
410
- type: "source-url",
411
- sourceId: `doc-${index}-${doc.slug}`,
412
- url: doc.url,
413
- title: doc.title,
414
- });
404
+ writer.write(createSourceChunk(doc, index));
415
405
  }
416
406
  const formattedResultsString = trimmedResults
417
407
  .map((doc) => `${formatDocForContext(doc)}\n\n---\n`)
@@ -447,7 +437,15 @@ const createTools = (writer, sources, defaultLanguage, basePath) => {
447
437
  if (!doc) {
448
438
  return `Documentation page not found: "${slug}"`;
449
439
  }
450
- return await doc.source.getPageMarkdown(doc.page);
440
+ const content = await doc.source.getPageMarkdown(doc.page);
441
+ const data = getPageData(doc.page);
442
+ const url = getPublicPath(doc.page.url, basePath);
443
+ writer.write(createSourceChunk({
444
+ slug: doc.page.url,
445
+ title: data.title ?? doc.page.url,
446
+ url,
447
+ }));
448
+ return content;
451
449
  },
452
450
  });
453
451
  const list_docs = tool({
@@ -604,10 +602,26 @@ export const createChatRoute = ({ config, eveAgent, model = DEFAULT_CHAT_MODEL,
604
602
  return createUIMessageStreamResponse({ stream });
605
603
  }
606
604
  let processedMessages = actualMessages;
605
+ let localSourceDocs = [];
607
606
  if (pageContext && actualMessages.length > 0) {
608
607
  const lastMessage = actualMessages.at(-1);
609
608
  if (lastMessage?.role === "user") {
610
609
  const userQuestion = getMessageText(lastMessage);
610
+ const contextDoc = await getCurrentPageDoc({
611
+ basePath: config.basePath,
612
+ currentRoute,
613
+ lang: getRequestLanguage({
614
+ basePath: config.basePath,
615
+ currentRoute,
616
+ defaultLanguage,
617
+ languages,
618
+ }),
619
+ pageContext,
620
+ sources: routeSources,
621
+ });
622
+ if (contextDoc) {
623
+ localSourceDocs = [contextDoc];
624
+ }
611
625
  processedMessages = [
612
626
  ...actualMessages.slice(0, -1),
613
627
  {
@@ -625,6 +639,9 @@ export const createChatRoute = ({ config, eveAgent, model = DEFAULT_CHAT_MODEL,
625
639
  const stream = createUIMessageStream({
626
640
  originalMessages: messages,
627
641
  execute: async ({ writer }) => {
642
+ for (const chunk of createSourceChunks(localSourceDocs)) {
643
+ writer.write(chunk);
644
+ }
628
645
  const modelMessages = await convertToModelMessages(processedMessages);
629
646
  const result = streamText({
630
647
  model,
@@ -30,7 +30,7 @@ export declare const createLlmsRoute: ({ filterPage, source, sources, transform,
30
30
  revalidate: false;
31
31
  };
32
32
  export interface CreateDocsMarkdownRouteOptions {
33
- config?: Pick<GeistdocsConfig, "basePath" | "defaultLanguage" | "translations">;
33
+ config?: Pick<GeistdocsConfig, "basePath" | "defaultLanguage" | "siteUrl" | "translations">;
34
34
  filterStaticParams?: (params: DocsMarkdownParams) => boolean;
35
35
  /** Customize the agent-readable Markdown response for missing pages, or disable it. */
36
36
  notFound?: false | MarkdownNotFoundOptions;
@@ -1 +1 @@
1
- {"version":3,"file":"llms.d.ts","sourceRoot":"","sources":["../../src/routes/llms.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EACL,KAAK,eAAe,EAIrB,MAAM,cAAc,CAAC;AAStB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE1D,KAAK,YAAY,GAAG,qBAAqB,CAAC;AAC1C,KAAK,aAAa,GAAG,WAAW,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAahF,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,UAAU,wBAAwB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,KAAK,iBAAiB,GAAG,CACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,wBAAwB,KAC9B,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;AAE9B,UAAU,sBAAsB;IAC9B,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;IACzE,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAqOD,eAAO,MAAM,eAAe,GAAI,6CAK7B,sBAAsB;gBAIf,WAAW,cACL;QAAE,MAAM,EAAE,OAAO,CAAC;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE;;CAoCpD,CAAC;AAEF,MAAM,WAAW,8BAA8B;IAC7C,MAAM,CAAC,EAAE,IAAI,CACX,eAAe,EACf,UAAU,GAAG,iBAAiB,GAAG,cAAc,CAChD,CAAC;IACF,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC;IAC7D,uFAAuF;IACvF,QAAQ,CAAC,EAAE,KAAK,GAAG,uBAAuB,CAAC;IAC3C,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE;QAC7B,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,aAAa,CAAC;QACpB,MAAM,EAAE,YAAY,CAAC;KACtB,KAAK,MAAM,CAAC;IACb;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,KAAK,MAAM,CAAC;IACzE,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;CAC1B;AAED,eAAO,MAAM,uBAAuB,GAAI,wFAOrC,8BAA8B;mBAkLpB,OAAO,cACJ;QAAE,MAAM,EAAE,OAAO,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,CAAA;KAAE;yCA6CjE;QACD,MAAM,CAAC,EAAE,OAAO,CAAC;YAAE,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACrC;;CAgBF,CAAC"}
1
+ {"version":3,"file":"llms.d.ts","sourceRoot":"","sources":["../../src/routes/llms.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EACL,KAAK,eAAe,EAIrB,MAAM,cAAc,CAAC;AAStB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE1D,KAAK,YAAY,GAAG,qBAAqB,CAAC;AAC1C,KAAK,aAAa,GAAG,WAAW,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAehF,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,UAAU,wBAAwB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,KAAK,iBAAiB,GAAG,CACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,wBAAwB,KAC9B,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;AAE9B,UAAU,sBAAsB;IAC9B,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;IACzE,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAqOD,eAAO,MAAM,eAAe,GAAI,6CAK7B,sBAAsB;gBAIf,WAAW,cACL;QAAE,MAAM,EAAE,OAAO,CAAC;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE;;CAoCpD,CAAC;AAEF,MAAM,WAAW,8BAA8B;IAC7C,MAAM,CAAC,EAAE,IAAI,CACX,eAAe,EACf,UAAU,GAAG,iBAAiB,GAAG,SAAS,GAAG,cAAc,CAC5D,CAAC;IACF,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC;IAC7D,uFAAuF;IACvF,QAAQ,CAAC,EAAE,KAAK,GAAG,uBAAuB,CAAC;IAC3C,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE;QAC7B,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,aAAa,CAAC;QACpB,MAAM,EAAE,YAAY,CAAC;KACtB,KAAK,MAAM,CAAC;IACb;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,KAAK,MAAM,CAAC;IACzE,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;CAC1B;AAED,eAAO,MAAM,uBAAuB,GAAI,wFAOrC,8BAA8B;mBAqLpB,OAAO,cACJ;QAAE,MAAM,EAAE,OAAO,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,CAAA;KAAE;yCAmDjE;QACD,MAAM,CAAC,EAAE,OAAO,CAAC;YAAE,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACrC;;CAgBF,CAAC"}
@@ -7,6 +7,7 @@ import { findSmartNotFoundSuggestions, renderSmartNotFoundMarkdown, } from "../i
7
7
  import { isPageVisibleForSurface } from "../page-visibility.js";
8
8
  const INDEX_MARKDOWN_PATTERN = /\/index\.md$/;
9
9
  const MARKDOWN_PATTERN = /\.md$/;
10
+ const MARKDOWN_CACHE_CONTROL = "public, max-age=0, s-maxage=86400, stale-while-revalidate=604800";
10
11
  const resolveSources = (source, sources, caller) => {
11
12
  const resolvedSources = sources ?? (source ? [source] : []);
12
13
  if (resolvedSources.length === 0) {
@@ -158,7 +159,10 @@ export const createLlmsRoute = ({ filterPage, source, sources, transform, }) =>
158
159
  };
159
160
  export const createDocsMarkdownRoute = ({ config, filterStaticParams, notFound: notFoundOptions = {}, source, sources, transform, }) => {
160
161
  const routeSources = resolveSources(source, sources, "createDocsMarkdownRoute");
161
- const routingConfig = config ?? routeSources[0].routingConfig ?? {};
162
+ const routingConfig = {
163
+ ...(routeSources[0].routingConfig ?? {}),
164
+ ...config,
165
+ };
162
166
  const smartNotFoundOptions = notFoundOptions === false ? {} : notFoundOptions;
163
167
  const supportedLanguages = new Set([
164
168
  routingConfig.defaultLanguage ?? "en",
@@ -292,7 +296,13 @@ export const createDocsMarkdownRoute = ({ config, filterStaticParams, notFound:
292
296
  const rendered = await pageSource.getPageMarkdown(page);
293
297
  const pageData = page.data;
294
298
  const canonicalPath = withBasePath(pageData.canonical ?? page.url, routingConfig.basePath);
295
- const headers = applyMarkdownHeaders(new Headers({ "Content-Type": "text/markdown" }), { canonicalUrl: new URL(canonicalPath, request.url) });
299
+ const canonicalUrl = routingConfig.siteUrl
300
+ ? new URL(canonicalPath, routingConfig.siteUrl)
301
+ : new URL(canonicalPath, request.url);
302
+ const headers = applyMarkdownHeaders(new Headers({
303
+ "Cache-Control": MARKDOWN_CACHE_CONTROL,
304
+ "Content-Type": "text/markdown",
305
+ }), { canonicalUrl });
296
306
  return new Response(transform
297
307
  ? await transform(rendered, { lang, page, source: pageSource })
298
308
  : rendered, {
@@ -1,10 +1,20 @@
1
1
  import { type DefaultMDXOptions, defineConfig as defineFumadocsConfig } from "fumadocs-mdx/config";
2
+ import type { Pluggable } from "unified";
2
3
  import { z } from "zod";
3
4
  type FumadocsConfigInput = NonNullable<Parameters<typeof defineFumadocsConfig>[0]>;
4
5
  export interface GeistdocsSourceConfigOptions {
5
6
  mdxOptions?: DefaultMDXOptions;
6
7
  plugins?: FumadocsConfigInput["plugins"];
7
8
  }
9
+ /**
10
+ * Builds the remark pipeline from Fumadocs' resolved defaults.
11
+ *
12
+ * `remarkSteps` must run before `remarkHeading`, otherwise the `1. ` prefix
13
+ * that marks a step heading leaks into the heading slug and table of contents.
14
+ * Geistdocs and consumer plugins keep their previous slot ahead of
15
+ * `remarkStructure` so search indexing sees their output.
16
+ */
17
+ export declare const resolveGeistdocsRemarkPlugins: (defaults: Pluggable[], consumerPlugins?: Pluggable[]) => Pluggable[];
8
18
  export declare const geistShikiTheme: {
9
19
  name: string;
10
20
  type: "dark";
@@ -46,6 +56,7 @@ export declare const geistdocsFrontmatterSchema: z.ZodObject<{
46
56
  related: z.ZodOptional<z.ZodArray<z.ZodString>>;
47
57
  summary: z.ZodOptional<z.ZodString>;
48
58
  lastModified: z.ZodOptional<z.ZodCoercedDate<unknown>>;
59
+ tableOfContents: z.ZodOptional<z.ZodBoolean>;
49
60
  internal: z.ZodOptional<z.ZodBoolean>;
50
61
  noindex: z.ZodOptional<z.ZodBoolean>;
51
62
  tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -1 +1 @@
1
- {"version":3,"file":"source-config.d.ts","sourceRoot":"","sources":["../src/source-config.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,iBAAiB,EACtB,YAAY,IAAI,oBAAoB,EAGrC,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,KAAK,mBAAmB,GAAG,WAAW,CACpC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAC3C,CAAC;AAEF,MAAM,WAAW,4BAA4B;IAC3C,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,OAAO,CAAC,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;CAC1C;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;CAsG3B,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwCrC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;iBAAa,CAAC;AAE9C,eAAO,MAAM,2BAA2B,GACtC,SAAQ,4BAAiC,+CAuB1C,CAAC"}
1
+ {"version":3,"file":"source-config.d.ts","sourceRoot":"","sources":["../src/source-config.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,KAAK,iBAAiB,EACtB,YAAY,IAAI,oBAAoB,EAGrC,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,KAAK,mBAAmB,GAAG,WAAW,CACpC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAC3C,CAAC;AAEF,MAAM,WAAW,4BAA4B;IAC3C,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,OAAO,CAAC,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;CAC1C;AAQD;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,GACxC,UAAU,SAAS,EAAE,EACrB,kBAAiB,SAAS,EAAO,KAChC,SAAS,EAeX,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;CAsG3B,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyCrC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;iBAAa,CAAC;AAE9C,eAAO,MAAM,2BAA2B,GACtC,SAAQ,4BAAiC,+CAwB1C,CAAC"}
@@ -1,8 +1,26 @@
1
- import { remarkMdxMermaid } from "fumadocs-core/mdx-plugins";
1
+ import { remarkHeading, remarkMdxMermaid, remarkSteps, remarkStructure, } from "fumadocs-core/mdx-plugins";
2
2
  import { defineConfig as defineFumadocsConfig, frontmatterSchema, metaSchema, } from "fumadocs-mdx/config";
3
3
  import lastModified from "fumadocs-mdx/plugins/last-modified";
4
4
  import { z } from "zod";
5
5
  import { getLastModified } from "./internal/last-modified.js";
6
+ const pluginOf = (entry) => Array.isArray(entry) ? entry[0] : entry;
7
+ const indexOfPlugin = (list, plugin) => list.findIndex((entry) => pluginOf(entry) === plugin);
8
+ /**
9
+ * Builds the remark pipeline from Fumadocs' resolved defaults.
10
+ *
11
+ * `remarkSteps` must run before `remarkHeading`, otherwise the `1. ` prefix
12
+ * that marks a step heading leaks into the heading slug and table of contents.
13
+ * Geistdocs and consumer plugins keep their previous slot ahead of
14
+ * `remarkStructure` so search indexing sees their output.
15
+ */
16
+ export const resolveGeistdocsRemarkPlugins = (defaults, consumerPlugins = []) => {
17
+ const list = [...defaults];
18
+ const headingIndex = indexOfPlugin(list, remarkHeading);
19
+ list.splice(headingIndex === -1 ? 0 : headingIndex, 0, remarkSteps);
20
+ const structureIndex = indexOfPlugin(list, remarkStructure);
21
+ list.splice(structureIndex === -1 ? list.length : structureIndex, 0, remarkMdxMermaid, ...consumerPlugins);
22
+ return list;
23
+ };
6
24
  export const geistShikiTheme = {
7
25
  name: "geist",
8
26
  type: "dark",
@@ -134,6 +152,7 @@ export const geistdocsFrontmatterSchema = frontmatterSchema.extend({
134
152
  .optional(),
135
153
  summary: z.string().optional(),
136
154
  lastModified: z.coerce.date().optional(),
155
+ tableOfContents: z.boolean().optional(),
137
156
  internal: z.boolean().optional(),
138
157
  noindex: z.boolean().optional(),
139
158
  tags: z.array(z.string()).optional(),
@@ -153,7 +172,7 @@ export const defineGeistdocsSourceConfig = (config = {}) => {
153
172
  ...config,
154
173
  mdxOptions: {
155
174
  ...config.mdxOptions,
156
- remarkPlugins: [remarkMdxMermaid, ...existingRemarkPlugins],
175
+ remarkPlugins: (defaults) => resolveGeistdocsRemarkPlugins(defaults, existingRemarkPlugins),
157
176
  rehypeCodeOptions: {
158
177
  ...config.mdxOptions?.rehypeCodeOptions,
159
178
  themes: { light: geistShikiTheme, dark: geistShikiTheme },
package/dist/source.d.ts CHANGED
@@ -33,12 +33,16 @@ export interface GeistdocsMarkdownContext {
33
33
  url: string;
34
34
  };
35
35
  }
36
+ export type GeistdocsMarkdownFrontmatterValue = boolean | Date | number | readonly string[] | string | null | undefined;
37
+ export type GeistdocsMarkdownFrontmatter = Record<string, GeistdocsMarkdownFrontmatterValue>;
36
38
  export interface GeistdocsMarkdownOptions {
39
+ /** Add or override fields in the generated Markdown frontmatter. */
40
+ frontmatter?: (defaults: Readonly<GeistdocsMarkdownFrontmatter>, context: GeistdocsMarkdownContext) => GeistdocsMarkdownFrontmatter | Promise<GeistdocsMarkdownFrontmatter>;
37
41
  transform?: (markdown: string, context: GeistdocsMarkdownContext) => Promise<string> | string;
38
42
  }
39
43
  export interface CreateSourceOptions {
40
44
  baseUrl?: string;
41
- config: Pick<GeistdocsConfig, "agent" | "basePath" | "defaultLanguage" | "translations"> & Partial<Pick<GeistdocsConfig, "title">>;
45
+ config: Pick<GeistdocsConfig, "agent" | "basePath" | "defaultLanguage" | "siteUrl" | "translations"> & Partial<Pick<GeistdocsConfig, "title">>;
42
46
  docs: FumadocsCollection;
43
47
  id?: string;
44
48
  label?: string;
@@ -68,6 +72,7 @@ export declare const createSource: ({ docs, config, baseUrl, id, label, markdown
68
72
  agent: import("./config.js").GeistdocsAgentReadinessConfig | undefined;
69
73
  basePath: string | undefined;
70
74
  defaultLanguage: string | undefined;
75
+ siteUrl: string | undefined;
71
76
  title: string | undefined;
72
77
  translations: import("./config.js").GeistdocsTranslations | undefined;
73
78
  };
@@ -101,6 +106,7 @@ export declare const createSources: ({ config, sources }: CreateSourcesOptions)
101
106
  agent: import("./config.js").GeistdocsAgentReadinessConfig | undefined;
102
107
  basePath: string | undefined;
103
108
  defaultLanguage: string | undefined;
109
+ siteUrl: string | undefined;
104
110
  title: string | undefined;
105
111
  translations: import("./config.js").GeistdocsTranslations | undefined;
106
112
  };
@@ -138,6 +144,7 @@ export declare const createVersionedSources: ({ config, current, versions, }: Cr
138
144
  agent: import("./config.js").GeistdocsAgentReadinessConfig | undefined;
139
145
  basePath: string | undefined;
140
146
  defaultLanguage: string | undefined;
147
+ siteUrl: string | undefined;
141
148
  title: string | undefined;
142
149
  translations: import("./config.js").GeistdocsTranslations | undefined;
143
150
  };
@@ -166,6 +173,7 @@ export declare const createVersionedSources: ({ config, current, versions, }: Cr
166
173
  agent: import("./config.js").GeistdocsAgentReadinessConfig | undefined;
167
174
  basePath: string | undefined;
168
175
  defaultLanguage: string | undefined;
176
+ siteUrl: string | undefined;
169
177
  title: string | undefined;
170
178
  translations: import("./config.js").GeistdocsTranslations | undefined;
171
179
  };
@@ -193,6 +201,7 @@ export declare const createVersionedSources: ({ config, current, versions, }: Cr
193
201
  agent: import("./config.js").GeistdocsAgentReadinessConfig | undefined;
194
202
  basePath: string | undefined;
195
203
  defaultLanguage: string | undefined;
204
+ siteUrl: string | undefined;
196
205
  title: string | undefined;
197
206
  translations: import("./config.js").GeistdocsTranslations | undefined;
198
207
  };
@@ -1 +1 @@
1
- {"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../src/source.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../src/source.ts"],"names":[],"mappings":"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"}