@vercel/geistdocs 1.25.1-canary.4e75e60 → 1.25.1-canary.62250e6
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/code-block-tabs.js +1 -1
- package/dist/components/code-block.d.ts.map +1 -1
- package/dist/components/code-block.js +1 -1
- package/dist/components/copy-prompt.js +1 -1
- package/dist/components/image.d.ts +19 -0
- package/dist/components/image.d.ts.map +1 -0
- package/dist/components/image.js +9 -0
- package/dist/components/steps.d.ts +9 -0
- package/dist/components/steps.d.ts.map +1 -0
- package/dist/components/steps.js +9 -0
- package/dist/internal/chat/activity.d.ts +20 -0
- package/dist/internal/chat/activity.d.ts.map +1 -0
- package/dist/internal/chat/activity.js +43 -0
- package/dist/internal/chat/message-metadata.d.ts.map +1 -1
- package/dist/internal/chat/message-metadata.js +15 -30
- package/dist/internal/chat/message-sources.d.ts +3 -0
- package/dist/internal/chat/message-sources.d.ts.map +1 -0
- package/dist/internal/chat/message-sources.js +23 -0
- package/dist/internal/chat/message.d.ts.map +1 -1
- package/dist/internal/chat/message.js +44 -10
- package/dist/internal/chat/shell.d.ts.map +1 -1
- package/dist/internal/chat/shell.js +7 -2
- package/dist/internal/chat/source-chunks.d.ts +9 -0
- package/dist/internal/chat/source-chunks.d.ts.map +1 -0
- package/dist/internal/chat/source-chunks.js +7 -0
- package/dist/internal/chat/sources.d.ts +1 -1
- package/dist/internal/chat/sources.d.ts.map +1 -1
- package/dist/internal/chat/sources.js +6 -3
- package/dist/internal/link-href.d.ts +13 -0
- package/dist/internal/link-href.d.ts.map +1 -0
- package/dist/internal/link-href.js +51 -0
- package/dist/internal/mdx-to-markdown.d.ts +3 -0
- package/dist/internal/mdx-to-markdown.d.ts.map +1 -0
- package/dist/internal/mdx-to-markdown.js +166 -0
- package/dist/internal/react-node-text.d.ts +4 -0
- package/dist/internal/react-node-text.d.ts.map +1 -0
- package/dist/internal/react-node-text.js +11 -0
- package/dist/internal/search.js +1 -1
- package/dist/internal/sidebar-tree.d.ts.map +1 -1
- package/dist/internal/sidebar-tree.js +6 -1
- package/dist/internal/toc-items.d.ts.map +1 -1
- package/dist/internal/toc-items.js +2 -1
- package/dist/mdx.d.ts.map +1 -1
- package/dist/mdx.js +5 -0
- package/dist/pages/docs.d.ts.map +1 -1
- package/dist/pages/docs.js +10 -5
- package/dist/routes/chat.d.ts.map +1 -1
- package/dist/routes/chat.js +30 -13
- package/dist/routes/llms.d.ts +1 -1
- package/dist/routes/llms.d.ts.map +1 -1
- package/dist/routes/llms.js +12 -2
- package/dist/source-config.d.ts +10 -0
- package/dist/source-config.d.ts.map +1 -1
- package/dist/source-config.js +20 -2
- package/dist/source.d.ts +10 -1
- package/dist/source.d.ts.map +1 -1
- package/dist/source.js +75 -34
- package/dist/versions.js +2 -2
- package/docs/agents.md +5 -3
- package/docs/llms.txt +388 -28
- package/docs/manifest.json +21 -3
- package/docs/pages/components/steps.md +129 -0
- package/docs/pages/deployment.md +30 -5
- package/docs/pages/getting-started.md +38 -12
- package/docs/pages/guides/nested-navigation.md +1 -1
- package/docs/pages/md.md +24 -5
- package/docs/pages/migration-2.md +106 -0
- package/docs/pages/migration.md +5 -2
- package/docs/pages/syntax.md +42 -0
- package/docs/sitemap.md +4 -2
- package/package.json +14 -4
- package/source-config.js +37 -2
- package/template/content/docs/components/meta.json +4 -0
- package/template/content/docs/components/steps.mdx +125 -0
- package/template/content/docs/deployment.mdx +31 -6
- package/template/content/docs/getting-started.mdx +39 -13
- package/template/content/docs/guides/nested-navigation.mdx +1 -1
- package/template/content/docs/md.mdx +24 -5
- package/template/content/docs/meta.json +3 -0
- package/template/content/docs/migration-2.mdx +106 -0
- package/template/content/docs/migration.mdx +5 -1
- package/template/content/docs/syntax.mdx +42 -0
- package/template/next.config.ts +9 -0
- package/template/package.json +3 -3
- package/theme.css +50 -4
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
|
};
|
package/dist/source.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../src/source.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,aAAa,EAClB,MAAM,EAEP,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,oBAAoB,EAG1B,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../src/source.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,aAAa,EAClB,MAAM,EAEP,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,oBAAoB,EAG1B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,KAAK,qBAAqB,EAE3B,MAAM,6BAA6B,CAAC;AAErC,YAAY,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEzE,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AA0FlD,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,IAAI,aAAa,CAAC,QAAQ,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACrC,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE;QACJ,IAAI,EAAE,uBAAuB,CAAC;QAC9B,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED,MAAM,MAAM,iCAAiC,GACzC,OAAO,GACP,IAAI,GACJ,MAAM,GACN,SAAS,MAAM,EAAE,GACjB,MAAM,GACN,IAAI,GACJ,SAAS,CAAC;AAEd,MAAM,MAAM,4BAA4B,GAAG,MAAM,CAC/C,MAAM,EACN,iCAAiC,CAClC,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,oEAAoE;IACpE,WAAW,CAAC,EAAE,CACZ,QAAQ,EAAE,QAAQ,CAAC,4BAA4B,CAAC,EAChD,OAAO,EAAE,wBAAwB,KAC9B,4BAA4B,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAC1E,SAAS,CAAC,EAAE,CACV,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,wBAAwB,KAC9B,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,IAAI,CACV,eAAe,EACf,OAAO,GAAG,UAAU,GAAG,iBAAiB,GAAG,SAAS,GAAG,cAAc,CACtE,GACC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1C,IAAI,EAAE,kBAAkB,CAAC;IACzB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,wBAAwB,CAAC;CACrC;AAED,MAAM,WAAW,yBACf,SAAQ,IAAI,CAAC,mBAAmB,EAAE,QAAQ,CAAC;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kCACf,SAAQ,yBAAyB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACtC,OAAO,EAAE,yBAAyB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,kCAAkC,EAAE,CAAC;CAChD;AA4FD,eAAO,MAAM,YAAY,GAAI,iDAO1B,mBAAmB;;;;;;;;;;;;;;;;yBAiBQ,aAAa;;;OAAe;;;;4BASnB,aAAa;;;OAAe;CAyGlE,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AAEpE,eAAO,MAAM,uBAAuB,GAClC,QAAQ,OAAO,KACd,MAAM,IAAI,qBAKC,CAAC;AAEf,eAAO,MAAM,aAAa,GAAI,qBAAqB,oBAAoB;;;;;;;;;;;;;;;;;;;;iCA/HzC,aAAa;;;eAAe;;;;oCASnB,aAAa;;;eAAe;;;UA0I1D,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC;CAE7C,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,gCAIpC,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;iCA3JF,aAAa;;;eAAe;;;;oCASnB,aAAa;;;eAAe;;;;;;;;;;;;;;;;;;;6BATrC,aAAa;;;WAAe;;;;gCASnB,aAAa;;;WAAe;;;;;;;;;;;;;;;;;;6BATrC,aAAa;;;WAAe;;;;gCASnB,aAAa;;;WAAe;;;CAqLlE,CAAC;AAEF,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE;YAAE,KAAK,EAAE,MAAM,EAAE,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,KAAK,MAAM,CAAC;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,qBAAqB,GAAG,qBAAqB,EAAE,CAAC;CAC1D;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAAI,6CAKjC,0BAA0B,KAAG,MAAM,EAYrC,CAAC;AAEF,MAAM,WAAW,gCAAgC;IAC/C,UAAU,CAAC,EAAE,0BAA0B,CAAC,YAAY,CAAC,CAAC;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,sBAAsB,CAAC,EAAE,KAAK,CAAC,CAAC;CAClE;AAED;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GAAI,iCAIvC,gCAAgC,KAAG,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAiBvE,CAAC"}
|
package/dist/source.js
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { defineI18n } from "fumadocs-core/i18n";
|
|
2
2
|
import { loader, } from "fumadocs-core/source";
|
|
3
3
|
import { getPublicPath, withBasePath, } from "./config.js";
|
|
4
|
+
import { mdxToMarkdown } from "./internal/mdx-to-markdown.js";
|
|
4
5
|
import { stripVersionRoutePrefix, } from "./internal/version-paths.js";
|
|
5
6
|
const MARKDOWN_LINK_PATTERN = /(\]\()(\/(?!\/)[^)\s]*)/g;
|
|
6
7
|
const ROOT_ATTRIBUTE_PATTERN = /(\b(?:href|src)=["'])(\/(?!\/)[^"']*)/g;
|
|
@@ -64,6 +65,40 @@ const getLanguages = (config) => {
|
|
|
64
65
|
languages: Array.from(new Set([defaultLanguage, ...languages])),
|
|
65
66
|
};
|
|
66
67
|
};
|
|
68
|
+
const YAML_NEEDS_QUOTING = /[:#{}[\]&*!|>'"%@`]/;
|
|
69
|
+
const ALWAYS_QUOTED_FRONTMATTER = new Set(["badge", "navTitle"]);
|
|
70
|
+
const formatFrontmatterValue = (value, forceQuotes = false) => {
|
|
71
|
+
if (value instanceof Date) {
|
|
72
|
+
return value.toISOString().slice(0, 10);
|
|
73
|
+
}
|
|
74
|
+
if (typeof value === "string") {
|
|
75
|
+
return forceQuotes ||
|
|
76
|
+
YAML_NEEDS_QUOTING.test(value) ||
|
|
77
|
+
value.trim() !== value
|
|
78
|
+
? JSON.stringify(value)
|
|
79
|
+
: value;
|
|
80
|
+
}
|
|
81
|
+
return String(value);
|
|
82
|
+
};
|
|
83
|
+
const formatFrontmatter = (fields) => {
|
|
84
|
+
const lines = ["---"];
|
|
85
|
+
const isStringArray = (value) => Array.isArray(value);
|
|
86
|
+
for (const [key, value] of Object.entries(fields)) {
|
|
87
|
+
if (value == null || value === false) {
|
|
88
|
+
continue;
|
|
89
|
+
}
|
|
90
|
+
if (isStringArray(value)) {
|
|
91
|
+
if (value.length === 0) {
|
|
92
|
+
continue;
|
|
93
|
+
}
|
|
94
|
+
lines.push(`${key}:`, ...value.map((entry) => ` - ${formatFrontmatterValue(entry)}`));
|
|
95
|
+
continue;
|
|
96
|
+
}
|
|
97
|
+
lines.push(`${key}: ${formatFrontmatterValue(value, ALWAYS_QUOTED_FRONTMATTER.has(key))}`);
|
|
98
|
+
}
|
|
99
|
+
lines.push("---");
|
|
100
|
+
return lines.join("\n");
|
|
101
|
+
};
|
|
67
102
|
const pageTreeTransformer = {
|
|
68
103
|
file(node, filePath) {
|
|
69
104
|
if (!filePath) {
|
|
@@ -107,51 +142,56 @@ export const createSource = ({ docs, config, baseUrl = "/docs", id, label, markd
|
|
|
107
142
|
};
|
|
108
143
|
const getPageMarkdown = async (page) => {
|
|
109
144
|
const data = page.data;
|
|
110
|
-
const
|
|
111
|
-
const { title, description, badge, product, type, summary, prerequisites, related, navTitle, internal, noindex, canonical, tags, keywords, excludeFrom, } = data;
|
|
112
|
-
const frontmatter = [
|
|
113
|
-
"---",
|
|
114
|
-
`title: ${title}`,
|
|
115
|
-
description && `description: ${description}`,
|
|
116
|
-
badge && `badge: ${JSON.stringify(badge)}`,
|
|
117
|
-
product && `product: ${product}`,
|
|
118
|
-
navTitle && `navTitle: ${JSON.stringify(navTitle)}`,
|
|
119
|
-
type && `type: ${type}`,
|
|
120
|
-
summary && `summary: ${summary}`,
|
|
121
|
-
internal && "internal: true",
|
|
122
|
-
noindex && "noindex: true",
|
|
123
|
-
canonical && `canonical: ${canonical}`,
|
|
124
|
-
tags?.length && `tags:\n${tags.map((tag) => ` - ${tag}`).join("\n")}`,
|
|
125
|
-
keywords?.length &&
|
|
126
|
-
`keywords:\n${keywords.map((keyword) => ` - ${keyword}`).join("\n")}`,
|
|
127
|
-
excludeFrom?.length &&
|
|
128
|
-
`excludeFrom:\n${excludeFrom.map((surface) => ` - ${surface}`).join("\n")}`,
|
|
129
|
-
prerequisites?.length &&
|
|
130
|
-
`prerequisites:\n${prerequisites
|
|
131
|
-
.map((prerequisite) => ` - ${prerequisite}`)
|
|
132
|
-
.join("\n")}`,
|
|
133
|
-
related?.length &&
|
|
134
|
-
`related:\n${related
|
|
135
|
-
.map((entry) => ` - ${entry}`)
|
|
136
|
-
.join("\n")}`,
|
|
137
|
-
"---",
|
|
138
|
-
]
|
|
139
|
-
.filter(Boolean)
|
|
140
|
-
.join("\n");
|
|
145
|
+
const content = await mdxToMarkdown(await data.getText("processed"));
|
|
146
|
+
const { title, description, badge, product, type, summary, prerequisites, related, navTitle, internal, noindex, canonical, tags, keywords, excludeFrom, lastModified, } = data;
|
|
141
147
|
const sitemapPath = "/sitemap.md";
|
|
142
148
|
const llmsPath = "/llms.txt";
|
|
143
149
|
const agentsPath = "/agents.md";
|
|
144
150
|
const sitemapLabel = getPublicPath(sitemapPath, config.basePath);
|
|
145
151
|
const llmsLabel = getPublicPath(llmsPath, config.basePath);
|
|
146
152
|
const agentsLabel = getPublicPath(agentsPath, config.basePath);
|
|
153
|
+
const pagePath = canonical
|
|
154
|
+
? withBasePath(canonical, config.basePath)
|
|
155
|
+
: getPublicPath(page.url, config.basePath);
|
|
156
|
+
const defaults = {
|
|
157
|
+
title,
|
|
158
|
+
description,
|
|
159
|
+
url: config.siteUrl
|
|
160
|
+
? new URL(pagePath, config.siteUrl).toString()
|
|
161
|
+
: undefined,
|
|
162
|
+
docs_index: llmsLabel,
|
|
163
|
+
lastUpdated: lastModified,
|
|
164
|
+
badge,
|
|
165
|
+
product,
|
|
166
|
+
navTitle,
|
|
167
|
+
type,
|
|
168
|
+
summary,
|
|
169
|
+
internal,
|
|
170
|
+
noindex,
|
|
171
|
+
canonical,
|
|
172
|
+
tags,
|
|
173
|
+
keywords,
|
|
174
|
+
excludeFrom,
|
|
175
|
+
prerequisites,
|
|
176
|
+
related,
|
|
177
|
+
};
|
|
178
|
+
const context = {
|
|
179
|
+
page: page,
|
|
180
|
+
};
|
|
181
|
+
const overrides = markdown?.frontmatter
|
|
182
|
+
? await markdown.frontmatter(defaults, context)
|
|
183
|
+
: {};
|
|
184
|
+
const fields = { ...defaults, ...overrides };
|
|
185
|
+
const frontmatter = formatFrontmatter(fields);
|
|
186
|
+
const docsIndex = typeof fields.docs_index === "string" ? fields.docs_index : llmsLabel;
|
|
147
187
|
const agentDiscoveryLink = config.agent && config.agent.enabled !== false
|
|
148
188
|
? `\n\nFor agent-facing discovery, including API and MCP surfaces, see [${agentsLabel}](${agentsPath})`
|
|
149
189
|
: "";
|
|
150
190
|
const rendered = `${frontmatter}
|
|
151
191
|
|
|
152
|
-
|
|
192
|
+
> For an index of all documentation, see [${docsIndex}](${docsIndex}).
|
|
153
193
|
|
|
154
|
-
${
|
|
194
|
+
${content}
|
|
155
195
|
|
|
156
196
|
---
|
|
157
197
|
|
|
@@ -160,7 +200,7 @@ For a semantic overview of all documentation, see [${sitemapLabel}](${sitemapPat
|
|
|
160
200
|
For an index of all available documentation, see [${llmsLabel}](${llmsPath})${agentDiscoveryLink}`;
|
|
161
201
|
const transformed = markdown?.transform
|
|
162
202
|
? await markdown.transform(rendered, {
|
|
163
|
-
|
|
203
|
+
...context,
|
|
164
204
|
})
|
|
165
205
|
: rendered;
|
|
166
206
|
return prefixMarkdownLinks(transformed, config.basePath);
|
|
@@ -171,6 +211,7 @@ For an index of all available documentation, see [${llmsLabel}](${llmsPath})${ag
|
|
|
171
211
|
agent: config.agent,
|
|
172
212
|
basePath: config.basePath,
|
|
173
213
|
defaultLanguage: config.defaultLanguage,
|
|
214
|
+
siteUrl: config.siteUrl,
|
|
174
215
|
title: config.title,
|
|
175
216
|
translations: config.translations,
|
|
176
217
|
},
|
package/dist/versions.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
"use client";
|
|
2
2
|
import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
|
|
3
3
|
import { cn } from "@vercel/geistcn/utils";
|
|
4
|
-
import { IconArchive, IconBox, IconCheck,
|
|
4
|
+
import { IconArchive, IconBox, IconCheck, IconChevronUpDown, } from "@vercel/geistcn-assets/icons";
|
|
5
5
|
import { usePathname, useRouter } from "next/navigation";
|
|
6
6
|
import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuTrigger, } from "./internal/ui/dropdown-menu";
|
|
7
7
|
import { resolveVersionSwitchPath, } from "./internal/version-paths.js";
|
|
@@ -73,7 +73,7 @@ export const GeistdocsRouteSelect = ({ ariaLabel = "Select route", className, cu
|
|
|
73
73
|
const currentDescription = currentItem
|
|
74
74
|
? getDescription({ active: true, item: currentItem })
|
|
75
75
|
: null;
|
|
76
|
-
return (_jsxs(DropdownMenu, { children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsxs("button", { "aria-label": ariaLabel, className: cn("group flex w-full items-center gap-2 rounded-md px-2 py-2 text-left outline-none transition-colors duration-150 ease-[cubic-bezier(0.175,0.885,0.32,1.1)] hover:bg-gray-alpha-100 focus-visible:shadow-[var(--ds-focus-ring)] active:bg-gray-alpha-300 data-[state=open]:bg-gray-alpha-100 motion-reduce:transition-none", className), type: "button", children: [currentItem ? renderIcon({ active: true, item: currentItem }) : null, _jsxs("span", { className: "min-w-0 flex-1", children: [_jsx("span", { className: "block truncate text-button-14 text-gray-1000", children: currentItem?.label ?? currentId }), currentDescription ? (_jsx("span", { className: "block truncate text-gray-900 text-label-13", children: currentDescription })) : null] }), _jsx(
|
|
76
|
+
return (_jsxs(DropdownMenu, { children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsxs("button", { "aria-label": ariaLabel, className: cn("group flex w-full items-center gap-2 rounded-md px-2 py-2 text-left outline-none transition-colors duration-150 ease-[cubic-bezier(0.175,0.885,0.32,1.1)] hover:bg-gray-alpha-100 focus-visible:shadow-[var(--ds-focus-ring)] active:bg-gray-alpha-300 data-[state=open]:bg-gray-alpha-100 motion-reduce:transition-none", className), type: "button", children: [currentItem ? renderIcon({ active: true, item: currentItem }) : null, _jsxs("span", { className: "min-w-0 flex-1", children: [_jsx("span", { className: "block truncate text-button-14 text-gray-1000", children: currentItem?.label ?? currentId }), currentDescription ? (_jsx("span", { className: "block truncate text-gray-900 text-label-13", children: currentDescription })) : null] }), _jsx(IconChevronUpDown, { className: "size-4 shrink-0 text-gray-900" })] }) }), _jsx(DropdownMenuContent, { align: "start", className: "w-(--radix-dropdown-menu-trigger-width) min-w-64 rounded-xl bg-background-100 p-1 shadow-(--ds-shadow-menu)", children: items.map((item) => {
|
|
77
77
|
const active = item.id === currentId;
|
|
78
78
|
const description = getDescription({ active, item });
|
|
79
79
|
return (_jsxs(DropdownMenuItem, { "aria-current": active ? "page" : undefined, className: "flex cursor-pointer items-center gap-2 rounded-md px-2 py-2", onSelect: () => navigateToItem(item), children: [renderIcon({ active, item }), _jsxs("span", { className: "min-w-0 flex-1", children: [_jsx("span", { className: "block truncate text-button-14 text-gray-1000", children: item.label }), description ? (_jsx("span", { className: "block truncate text-gray-900 text-label-13", children: description })) : null] }), active ? _jsx(IconCheck, { className: "size-4 text-blue-900" }) : null] }, item.id));
|
package/docs/agents.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Geistdocs Package Docs
|
|
2
2
|
|
|
3
|
-
These docs are bundled with `@vercel/geistdocs` 1.25.1-canary.
|
|
3
|
+
These docs are bundled with `@vercel/geistdocs` 1.25.1-canary.62250e6 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
|
|
@@ -25,8 +25,9 @@ They are generated from `apps/template/content/docs` during the package build.
|
|
|
25
25
|
- [Overview](pages/index.md): Geistdocs is a packaged documentation system for creating Next.js and Fumadocs sites with shared runtime features.
|
|
26
26
|
- [Getting Started](pages/getting-started.md): Create a Geistdocs project, run it locally, and edit your first documentation page.
|
|
27
27
|
- [Environment Variables](pages/env.md): Environment variables required by Geistdocs for AI chat, proxy mode, and production URL configuration.
|
|
28
|
-
- [Deploy to Vercel](pages/deployment.md): Deploy
|
|
29
|
-
- [
|
|
28
|
+
- [Deploy to Vercel](pages/deployment.md): Deploy a Geistdocs site to Vercel with the required project settings, environment variables, and private-package access.
|
|
29
|
+
- [Migrate to Geistdocs](pages/migration.md): Move an existing documentation site to @vercel/geistdocs while keeping local content, routing, middleware behavior, and AI-readable surfaces intact.
|
|
30
|
+
- [Migrate from Geistdocs 1.x to 2.0](pages/migration-2.md): A concise, agent-friendly checklist for upgrading an existing Geistdocs 1.x site to 2.0.
|
|
30
31
|
- [Configuration](pages/configuration.md): Configure site metadata, navigation, AI features, page actions, translations, and local adapters.
|
|
31
32
|
- [Syntax](pages/syntax.md): Supported MDX syntax including text formatting, code blocks, line highlighting, and Mermaid diagrams.
|
|
32
33
|
- [Geistdocs Provider](pages/provider.md): The root provider component that wraps your application to handle toast notifications, search, and analytics.
|
|
@@ -42,4 +43,5 @@ They are generated from `apps/template/content/docs` during the package build.
|
|
|
42
43
|
- [llms.txt](pages/llms-txt.md): A single endpoint that returns all documentation as plain Markdown text following the llms.txt standard.
|
|
43
44
|
- [Open in Chat](pages/open-in-chat.md): Transfer documentation context to AI chat platforms like ChatGPT, Claude, Cursor, and v0 with a single click.
|
|
44
45
|
- [RSS](pages/rss.md): An automatically generated RSS 2.0 feed that keeps users informed when documentation is published or updated.
|
|
46
|
+
- [Steps](pages/components/steps.md): Write consecutive headings that start with a number, such as "### 1. Install", to render a numbered step list. The Steps and Step components cover cases where a heading must be wrapped in another component.
|
|
45
47
|
- [Table of contents](pages/table-of-contents.md): Geistdocs builds the "On this page" outline from your headings, indents sub-headings under their parent, and tracks the active section along a straight vertical guide rail.
|