@vercel/geistdocs 2.15.4-canary.2a54b38 → 2.16.0-canary.abbda54

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 (81) hide show
  1. package/dist/cli/index.js +1 -1
  2. package/dist/config.d.ts +3 -3
  3. package/dist/config.d.ts.map +1 -1
  4. package/dist/internal/mdx-to-markdown.d.ts.map +1 -1
  5. package/dist/internal/mdx-to-markdown.js +0 -9
  6. package/dist/internal/navbar/mobile-menu.d.ts +3 -3
  7. package/dist/internal/navbar/mobile-menu.d.ts.map +1 -1
  8. package/dist/internal/navbar/mobile-menu.js +3 -3
  9. package/dist/internal/navbar/navbar-logo.d.ts +5 -3
  10. package/dist/internal/navbar/navbar-logo.d.ts.map +1 -1
  11. package/dist/internal/navbar/navbar-logo.js +71 -14
  12. package/dist/internal/page-actions.d.ts +4 -4
  13. package/dist/internal/page-actions.d.ts.map +1 -1
  14. package/dist/internal/page-actions.js +1 -6
  15. package/dist/mdx.d.ts +25 -3
  16. package/dist/mdx.d.ts.map +1 -1
  17. package/dist/mdx.js +61 -8
  18. package/dist/navbar.js +4 -3
  19. package/dist/next.d.ts +15 -12
  20. package/dist/next.d.ts.map +1 -1
  21. package/dist/next.js +28 -86
  22. package/dist/pages/docs.d.ts +98 -5
  23. package/dist/pages/docs.d.ts.map +1 -1
  24. package/dist/pages/docs.js +250 -13
  25. package/dist/routes/search.d.ts +8 -1
  26. package/dist/routes/search.d.ts.map +1 -1
  27. package/dist/routes/search.js +120 -82
  28. package/dist/source-config.d.ts +3 -10
  29. package/dist/source-config.d.ts.map +1 -1
  30. package/dist/source-config.js +12 -21
  31. package/dist/source.d.ts +17 -6
  32. package/dist/source.d.ts.map +1 -1
  33. package/dist/source.js +75 -2
  34. package/docs/agents.md +1 -1
  35. package/docs/llms.txt +70 -14
  36. package/docs/manifest.json +1 -1
  37. package/docs/pages/configuration.md +69 -13
  38. package/package.json +20 -35
  39. package/rehype-code-highlights.d.ts +1 -1
  40. package/rehype-code-highlights.js +49 -1
  41. package/search-index.d.ts +14 -0
  42. package/search-index.js +447 -0
  43. package/source-config-public.d.ts +15 -0
  44. package/source-config-public.js +47 -0
  45. package/source-config.js +12 -27
  46. package/template/AGENTS.md +4 -0
  47. package/template/app/api/search/route.ts +7 -2
  48. package/template/content/docs/configuration.mdx +69 -13
  49. package/template/lib/geistdocs/search-source.ts +6 -0
  50. package/template/next.config.ts +1 -1
  51. package/template/package.json +4 -7
  52. package/template/source.config.ts +1 -1
  53. package/dist/internal/source-loader.d.ts +0 -28
  54. package/dist/internal/source-loader.d.ts.map +0 -1
  55. package/dist/internal/source-loader.js +0 -77
  56. package/dist/mdx-basic.d.ts +0 -27
  57. package/dist/mdx-basic.d.ts.map +0 -1
  58. package/dist/mdx-basic.js +0 -61
  59. package/dist/navigation.d.ts +0 -11
  60. package/dist/navigation.d.ts.map +0 -1
  61. package/dist/navigation.js +0 -8
  62. package/dist/pages/docs-custom.d.ts +0 -111
  63. package/dist/pages/docs-custom.d.ts.map +0 -1
  64. package/dist/pages/docs-custom.js +0 -250
  65. package/native-mdx/LICENSE-mdxjs-rs +0 -22
  66. package/native-mdx/UPSTREAM.md +0 -16
  67. package/native-mdx/binaries/darwin-arm64.node +0 -0
  68. package/native-mdx/binaries/linux-x64-gnu.node +0 -0
  69. package/native-mdx/data-entry.d.mts +0 -15
  70. package/native-mdx/data-entry.mjs +0 -97
  71. package/native-mdx/data-projection.mjs +0 -205
  72. package/native-mdx/fumadocs-adapter.mjs +0 -36
  73. package/native-mdx/index-emitter.mjs +0 -34
  74. package/native-mdx/loader-data.cjs +0 -36
  75. package/native-mdx/loader-mdx.cjs +0 -9
  76. package/native-mdx/loader-mdx.mjs +0 -419
  77. package/native-mdx/native-binding.cjs +0 -27
  78. package/native-mdx/navigation-entry.d.mts +0 -11
  79. package/native-mdx/navigation-entry.mjs +0 -136
  80. package/native-mdx/navigation-title.mjs +0 -53
  81. package/template/pnpm-workspace.yaml +0 -3
@@ -103,7 +103,7 @@ export const navbarBrand: GeistdocsNavbarBrand = "labs";
103
103
 
104
104
  The generated `lib/geistdocs/config.tsx` forwards this export to `defineConfig`. Existing sites can forward it in their adapter or set `navbarBrand: "labs"` directly in `defineConfig`. Private projects use the type from `@vercel/geistdocs-private/config`.
105
105
 
106
- Labs links to [vercel.com/labs](https://vercel.com/labs) and adapts to light and dark themes. Brand selection is independent of `navbarVariant`, which selects the `"oss"` (default) or `"vercel"` layout; either supports both brands. The previous `"standard"` value remains supported as an alias for `"vercel"`. The OSS layout keeps your project's `Logo` and `logoHref` separate from the brand. The Vercel layout shows only the selected brand mark, with no separator, project logo, or OSS products menu.
106
+ Labs links to [vercel.com/labs](https://vercel.com/labs) and adapts to light and dark themes. Set `navbarVariant: "vercel-labs"` in `defineConfig` to use the Labs mark and show the Labs products and experiments menu. The previous `"standard"` value remains supported as an alias for `"vercel"`. The `"oss"` (default) layout keeps your project's `Logo` and `logoHref` separate from the brand and shows the OSS product menu. The `"vercel"` layout shows the selected brand mark, with no separator, project logo, or product menu.
107
107
 
108
108
  For new projects, both CLIs accept `--brand labs`; omitting it or using `--brand vercel` preserves the defaults. See [Create a Labs starter](/docs/getting-started#create-a-labs-starter).
109
109
 
@@ -283,32 +283,88 @@ export const docs = defineDocs({
283
283
  export default defineGeistdocsSourceConfig();
284
284
  ```
285
285
 
286
- ### MDX compiler
286
+ ### Search-only collections
287
287
 
288
- `createGeistdocs()` uses the native Rust MDX compiler by default with both Turbopack and webpack. Compatible pages compile natively; custom plugins, Shiki, unsupported content and platforms without a native binary use the JS pipeline automatically. Build output reports fallback reasons.
288
+ Enable generation of search data without compiled page bodies:
289
289
 
290
- Select a compiler in `next.config.ts`:
290
+ ```ts title="source.config.ts"
291
+ export default defineGeistdocsSourceConfig({ searchIndex: true });
292
+ ```
291
293
 
292
- ```ts
293
- const withGeistdocs = createGeistdocs({ mdxCompiler: "auto" });
294
+ Also enable preparation in the Next wrapper. It waits for codegen before bundling
295
+ and skips source extraction in `next start`:
296
+
297
+ ```ts title="next.config.ts"
298
+ const withGeistdocs = createGeistdocs({ searchIndex: true });
299
+ export default withGeistdocs(config);
294
300
  ```
295
301
 
296
- - `"auto"` (default): native when compatible, JS otherwise.
297
- - `"native"`: fail if a page needs JS fallback; useful for checking native coverage.
298
- - `"js"`: use the existing JS compiler for every page.
302
+ With this option, the wrapper returns a phase-aware Next config function. Export
303
+ it directly as above; apply other Next config wrappers to `config` first.
299
304
 
300
- Frontmatter-only requests do not compile page bodies. Native binaries ship with Geistdocs for macOS arm64 and Linux x64 (glibc 2.31+); consumers do not install Rust or a separate compiler package. Unsupported native content currently includes npm fences, Markdown images, includes, explicit code-tab wrappers and math. Actual native compiler errors fail the build instead of silently switching compilers.
305
+ Run your existing `fumadocs-mdx` postinstall command to generate
306
+ `.source/search/<collection>.ts`. Each module exports a collection compatible
307
+ with `createSource`; its frontmatter, sections, and metadata contain no MDX
308
+ imports. Keep the same source options (base URL, slugs, locales, page-tree
309
+ customization) as your rendering source, in a shared module that does not import
310
+ `.source/server`.
301
311
 
302
- ### Code highlighter
312
+ ```ts title="lib/geistdocs/search-source.ts"
313
+ import { createSource } from "@vercel/geistdocs/source";
314
+ import docs from "@/.source/search/docs";
315
+ import { config } from "./config";
303
316
 
304
- For a custom highlighter, pass `highlighter: false` to `defineGeistdocsSourceConfig`; the native compiler will fall back to JS so your plugins run. Passing `mdxOptions.rehypeCodeOptions: false` to the helper also disables built-in highlighting.
317
+ export const searchSource = createSource({ docs, config });
318
+ ```
305
319
 
306
- Code blocks are tokenized by [Highlights](https://diffs.com/highlights), which uses hand-written WebAssembly lexers, and rendered with the same HTML as Shiki: Geist colors, titles, icons, tabs, and `[!code ...]` notation all work. Languages without a built-in Highlights lexer render as plain text. To use Shiki's TextMate grammars instead, for example for an unsupported language, pass `highlighter: "shiki"`:
320
+ ```ts title="app/api/search/route.ts"
321
+ import { createSearchRoute } from "@vercel/geistdocs/routes/search";
322
+ import { config } from "@/lib/geistdocs/config";
323
+
324
+ export const GET = createSearchRoute({
325
+ config,
326
+ loadSources: async () => {
327
+ const { searchSource } = await import("@/lib/geistdocs/search-source");
328
+ return [searchSource];
329
+ },
330
+ });
331
+ ```
332
+
333
+ Use either `loadSources` or the existing `source`/`sources` options. Concurrent
334
+ requests share initialization; a failed initialization can be retried. Only the
335
+ requested locale's indexes are built. For versioned sites, create one lazy route
336
+ per version and dispatch to it using your existing version selector. Do not
337
+ import a barrel that also loads the rendering sources.
338
+
339
+ The generator runs the collection's schemas, frontmatter/VFile/metadata hooks,
340
+ and resolved remark plugins, including Markdown includes. It skips highlighting,
341
+ rehype, and recma, and adds a separate remark pass during codegen. Custom search
342
+ content must be recorded in `structuredData` by the remark pipeline. Collection
343
+ MDX overrides must retain `remarkStructure`. Metadata must serialize as JSON
344
+ values or Dates; custom runtime exports, page bodies, and Markdown methods are
345
+ not available on search-only pages. Filters must use stable metadata, not render
346
+ or load page bodies. Keep generated modules server-only: internal pages and
347
+ custom metadata may be present, with `internal`, `excludeFrom`, and `filterPage`
348
+ applied by the search route before returning results.
349
+
350
+ This works in development, previews, and production, in both packages. Content,
351
+ metadata, and registered include dependencies regenerate on edits; generation
352
+ errors invalidate old output and fail production/codegen commands. Orama still
353
+ builds its indexes on first search. Keep `.source/server` for docs rendering,
354
+ Markdown exports, and chat.
355
+
356
+ ### Code highlighter (public package)
357
+
358
+ The public package uses [Highlights](https://diffs.com/highlights), which tokenizes code with WebAssembly lexers while keeping the JavaScript MDX compiler. Geist colors, titles, icons, tabs and `[!code ...]` annotations are preserved. Some token colors differ from Shiki, and unsupported languages render as plain text. To use Shiki's TextMate grammars instead, pass `highlighter: "shiki"`:
307
359
 
308
360
  ```ts title="source.config.ts"
309
361
  export default defineGeistdocsSourceConfig({ highlighter: "shiki" });
310
362
  ```
311
363
 
364
+ Set `highlighter: false` or `mdxOptions.rehypeCodeOptions: false` to disable built-in highlighting when providing your own plugin. A `rehypePlugins` callback can also remove or replace Fumadocs' default highlighter without Highlights being added back.
365
+
366
+ The private package retains its existing Shiki pipeline. The `highlighter` option above is available only in the public package.
367
+
312
368
  To serve docs from the site root, use `route: "/"` in `content` and `baseUrl: "/"` in `createSource`. Root-mounted docs need explicit `markdownRoutes`; Geistdocs does not infer a broad `/*path` mapping because it can capture homepages and non-docs app routes.
313
369
 
314
370
  ## Page URLs
@@ -0,0 +1,6 @@
1
+ import { createSource } from "@vercel/geistdocs/source";
2
+ import docs from "@/.source/search/docs";
3
+ import { config } from "./config";
4
+
5
+ // Search-only metadata and sections. Keep .source/server out of this module.
6
+ export const searchSource = createSource({ docs, config });
@@ -3,7 +3,7 @@ import { join } from "node:path";
3
3
  import { createGeistdocs } from "@vercel/geistdocs/next";
4
4
  import type { NextConfig } from "next";
5
5
 
6
- const withGeistdocs = createGeistdocs();
6
+ const withGeistdocs = createGeistdocs({ searchIndex: true });
7
7
 
8
8
  // In this monorepo, compile @vercel/geistdocs from its workspace source so edits
9
9
  // to the package hot-reload in the running dev server (no rebuild/restart).
@@ -17,7 +17,7 @@
17
17
  "@streamdown/code": "^1.0.1",
18
18
  "@vercel/agent-readability": "^0.7.0",
19
19
  "@vercel/analytics": "^1.6.1",
20
- "@vercel/geistdocs": "2.15.4-canary.2a54b38",
20
+ "@vercel/geistdocs": "2.16.0-canary.abbda54",
21
21
  "@vercel/speed-insights": "^1.3.1",
22
22
  "ai": "^6.0.132",
23
23
  "clsx": "^2.1.1",
@@ -29,9 +29,9 @@
29
29
  "fumadocs-ui": "16.2.2",
30
30
  "geist": "1.7.1",
31
31
  "jotai": "^2.15.2",
32
- "mermaid": "^11.16.1",
32
+ "mermaid": "^11.12.2",
33
33
  "nanoid": "^5.1.6",
34
- "next": "16.4.5",
34
+ "next": "16.3.3",
35
35
  "next-themes": "^0.4.6",
36
36
  "react": "^19.2.3",
37
37
  "react-dom": "^19.2.3",
@@ -40,7 +40,7 @@
40
40
  "streamdown": "^2.1.0",
41
41
  "tailwind-merge": "^3.4.0",
42
42
  "use-stick-to-bottom": "^1.1.1",
43
- "zod": "^4.6.6"
43
+ "zod": "^4.1.13"
44
44
  },
45
45
  "devDependencies": {
46
46
  "@tailwindcss/postcss": "^4.1.17",
@@ -52,8 +52,5 @@
52
52
  "tailwindcss": "^4.1.17",
53
53
  "tw-animate-css": "^1.4.0",
54
54
  "typescript": "^5.9.3"
55
- },
56
- "overrides": {
57
- "katex": "0.18.2"
58
55
  }
59
56
  }
@@ -20,4 +20,4 @@ export const docs = defineDocs({
20
20
  },
21
21
  });
22
22
 
23
- export default defineGeistdocsSourceConfig();
23
+ export default defineGeistdocsSourceConfig({ searchIndex: true });
@@ -1,28 +0,0 @@
1
- import { loader } from "fumadocs-core/source";
2
- import type { GeistdocsConfig } from "../config.js";
3
- type LoaderOptions = Parameters<typeof loader>[0];
4
- export interface FumadocsCollection {
5
- toFumadocsSource(): LoaderOptions["source"];
6
- }
7
- export interface GeistdocsSlugsContext {
8
- /** Content file path relative to the content directory, including any language suffix, such as `errors/NOT_FOUND.mdx` or `guide.cn.mdx`. */
9
- path: string;
10
- /** Default slugs derived from the path, without folder groups or a trailing `index`. */
11
- slugs: string[];
12
- }
13
- export interface CreateNavigationOptions {
14
- baseUrl?: string;
15
- config: Pick<GeistdocsConfig, "agent" | "basePath" | "defaultLanguage" | "singleLanguage" | "siteUrl" | "translations"> & Partial<Pick<GeistdocsConfig, "title">>;
16
- docs: FumadocsCollection;
17
- /**
18
- * Transform each page's URL slugs. Use the same transform for navigation
19
- * and createSource so tree links match page routes.
20
- */
21
- slugs?: (context: GeistdocsSlugsContext) => string[];
22
- }
23
- export declare const createSourceLoader: ({ docs, config, baseUrl, slugs, }: CreateNavigationOptions) => import("fumadocs-core/source").LoaderOutput<{
24
- source: import("fumadocs-core/source").SourceConfig;
25
- i18n: import("fumadocs-core/i18n").I18nConfig<string>;
26
- }>;
27
- export {};
28
- //# sourceMappingURL=source-loader.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"source-loader.d.ts","sourceRoot":"","sources":["../../src/internal/source-loader.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,MAAM,EAEP,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAElD,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,IAAI,aAAa,CAAC,QAAQ,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,qBAAqB;IACpC,4IAA4I;IAC5I,IAAI,EAAE,MAAM,CAAC;IACb,wFAAwF;IACxF,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,IAAI,CACV,eAAe,EACb,OAAO,GACP,UAAU,GACV,iBAAiB,GACjB,gBAAgB,GAChB,SAAS,GACT,cAAc,CACjB,GACC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1C,IAAI,EAAE,kBAAkB,CAAC;IACzB;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,MAAM,EAAE,CAAC;CACtD;AA6ED,eAAO,MAAM,kBAAkB,GAAI,mCAKhC,uBAAuB;;;EAiBzB,CAAC"}
@@ -1,77 +0,0 @@
1
- import { defineI18n } from "fumadocs-core/i18n";
2
- import { loader, } from "fumadocs-core/source";
3
- const createSlugsPlugin = (transform) => {
4
- // Each locale's storage inherits fallback pages from the default locale by
5
- // reference, so transform every page object once.
6
- const transformed = new WeakSet();
7
- return {
8
- name: "geistdocs:slugs",
9
- // Runs after Fumadocs assigns the default slugs, so `index` pages and
10
- // folder groups resolve before the transform sees them.
11
- enforce: "post",
12
- transformStorage({ storage }) {
13
- const pathsByUrl = new Map();
14
- for (const key of storage.getFiles()) {
15
- const file = storage.read(key);
16
- if (file?.format !== "page") {
17
- continue;
18
- }
19
- if (!transformed.has(file)) {
20
- // Storage keys drop the locale; `file.path` is the content file path.
21
- file.slugs = transform({ path: file.path, slugs: [...file.slugs] });
22
- transformed.add(file);
23
- }
24
- const url = file.slugs.join("/");
25
- const existing = pathsByUrl.get(url);
26
- if (existing) {
27
- throw new Error(`Geistdocs slugs: ${existing} and ${file.path} both resolve to "/${url}".`);
28
- }
29
- pathsByUrl.set(url, file.path);
30
- }
31
- },
32
- };
33
- };
34
- const getLanguages = (config) => {
35
- const defaultLanguage = config.defaultLanguage ?? "en";
36
- const languages = Object.keys(config.translations ?? {});
37
- return {
38
- defaultLanguage,
39
- languages: Array.from(new Set([defaultLanguage, ...languages])),
40
- };
41
- };
42
- const pageTreeTransformer = {
43
- file(node, filePath) {
44
- if (!filePath) {
45
- return node;
46
- }
47
- const file = this.storage.read(filePath);
48
- if (file?.format !== "page") {
49
- return node;
50
- }
51
- const { badge, navTitle } = file.data;
52
- return {
53
- ...node,
54
- ...(typeof badge === "string" && badge.length > 0 ? { badge } : {}),
55
- ...(typeof navTitle === "string" && navTitle.length > 0
56
- ? { name: navTitle }
57
- : {}),
58
- };
59
- },
60
- };
61
- export const createSourceLoader = ({ docs, config, baseUrl = "/docs", slugs, }) => {
62
- const { defaultLanguage, languages } = getLanguages(config);
63
- const i18n = defineI18n({
64
- defaultLanguage,
65
- languages,
66
- hideLocale: "default-locale",
67
- });
68
- return loader({
69
- i18n,
70
- baseUrl,
71
- pageTree: {
72
- transformers: [pageTreeTransformer],
73
- },
74
- plugins: slugs ? [createSlugsPlugin(slugs)] : undefined,
75
- source: docs.toFumadocsSource(),
76
- });
77
- };
@@ -1,27 +0,0 @@
1
- import type { MDXComponents } from "mdx/types";
2
- import type { GeistdocsSourceConfigOptions as SourceConfigOptions } from "./source-config";
3
- export declare const geistShikiTheme: {
4
- name: string;
5
- type: "dark";
6
- colors: {
7
- "editor.foreground": string;
8
- "editor.background": string;
9
- };
10
- tokenColors: ({
11
- scope: string[];
12
- settings: {
13
- foreground: string;
14
- };
15
- } | {
16
- scope: string;
17
- settings: {
18
- foreground: string;
19
- };
20
- })[];
21
- };
22
- export type GeistdocsSourceConfigOptions = SourceConfigOptions;
23
- export type GeistdocsMDXComponents = MDXComponents;
24
- export declare const getGeistdocsMDXComponents: (components?: GeistdocsMDXComponents) => GeistdocsMDXComponents;
25
- export declare const createMdxComponents: (components?: GeistdocsMDXComponents) => GeistdocsMDXComponents;
26
- export declare const mergeGeistdocsMDXComponents: (...componentSets: Array<GeistdocsMDXComponents | undefined>) => GeistdocsMDXComponents;
27
- //# sourceMappingURL=mdx-basic.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"mdx-basic.d.ts","sourceRoot":"","sources":["../src/mdx-basic.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAoB/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,sBA2DD,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-basic.js DELETED
@@ -1,61 +0,0 @@
1
- import { jsx as _jsx } from "react/jsx-runtime";
2
- import { Image as FrameworkImage } from "fumadocs-core/framework";
3
- import { Card, Cards } from "fumadocs-ui/components/card";
4
- import Link from "next/link";
5
- import { cn } from "#geistdocs-ui/utils";
6
- import { Blockquote } from "./components/blockquote";
7
- import { Button } from "./components/button";
8
- import { Callout, CalloutContainer, CalloutDescription, CalloutTitle, } from "./components/callout";
9
- import { CodeBlock } from "./components/code-block";
10
- import { Details, Summary } from "./components/details";
11
- import { Heading } from "./components/heading";
12
- import { Image } from "./components/image";
13
- import { Step, Steps } from "./components/steps";
14
- import { Table } from "./components/table";
15
- import { TypeTable } from "./components/type-table";
16
- import { LocalizedLink } from "./internal/localized-link";
17
- import { geistShikiTheme as shikiTheme } from "./shiki-theme";
18
- // The source-config exports live on @vercel/geistdocs/source-config. Importing
19
- // them here would pull fumadocs-mdx/config, and through it Shiki with every
20
- // language grammar, into every server function that renders MDX.
21
- export const geistShikiTheme = shikiTheme;
22
- export const getGeistdocsMDXComponents = (components) => ({
23
- Card,
24
- Cards,
25
- img: (props) => (_jsx(FrameworkImage, { sizes: "(max-width: 768px) 100vw, (max-width: 1200px) 70vw, 900px", ...props, className: cn("rounded-lg", props.className), src: props.src })),
26
- h1: (props) => _jsx(Heading, { as: "h1", ...props }),
27
- h2: (props) => _jsx(Heading, { as: "h2", ...props }),
28
- h3: (props) => _jsx(Heading, { as: "h3", ...props }),
29
- h4: (props) => _jsx(Heading, { as: "h4", ...props }),
30
- h5: (props) => _jsx(Heading, { as: "h5", ...props }),
31
- h6: (props) => _jsx(Heading, { as: "h6", ...props }),
32
- pre: CodeBlock,
33
- blockquote: Blockquote,
34
- table: Table,
35
- Table,
36
- a: ({ children, className, href, ...props }) => {
37
- const linkClassName = 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);
38
- if (typeof href === "string" && href.startsWith("/")) {
39
- return (_jsx(LocalizedLink, { className: linkClassName, href: href, ...props, children: children }));
40
- }
41
- // next/link keeps same-page fragment entries restorable by the App Router.
42
- if (typeof href === "string" && href.startsWith("#")) {
43
- return (_jsx(Link, { className: linkClassName, href: href, prefetch: false, ...props, children: children }));
44
- }
45
- return (_jsx("a", { className: linkClassName, href: href, ...props, children: children }));
46
- },
47
- Button,
48
- TypeTable,
49
- Callout,
50
- CalloutContainer,
51
- CalloutTitle,
52
- CalloutDescription,
53
- Details,
54
- Summary,
55
- Image,
56
- Steps,
57
- Step,
58
- ...components,
59
- });
60
- export const createMdxComponents = (components) => getGeistdocsMDXComponents(components);
61
- export const mergeGeistdocsMDXComponents = (...componentSets) => Object.assign({}, ...componentSets.filter(Boolean));
@@ -1,11 +0,0 @@
1
- import { type CreateNavigationOptions } from "./internal/source-loader.js";
2
- export type { CreateNavigationOptions, FumadocsCollection, GeistdocsSlugsContext, } from "./internal/source-loader.js";
3
- /**
4
- * Create navigation from a Fumadocs collection without Markdown conversion.
5
- * Pass a metadata-only collection to keep MDX bodies out of the import graph.
6
- */
7
- export declare const createNavigation: (options: CreateNavigationOptions) => {
8
- pageTree: Record<string, import("fumadocs-core/page-tree").Root>;
9
- };
10
- export type GeistdocsNavigationBundle = ReturnType<typeof createNavigation>;
11
- //# sourceMappingURL=navigation.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../src/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,uBAAuB,EAE7B,MAAM,6BAA6B,CAAC;AAErC,YAAY,EACV,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AAErC;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,SAAS,uBAAuB;;CAE/D,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC"}
@@ -1,8 +0,0 @@
1
- import { createSourceLoader, } from "./internal/source-loader.js";
2
- /**
3
- * Create navigation from a Fumadocs collection without Markdown conversion.
4
- * Pass a metadata-only collection to keep MDX bodies out of the import graph.
5
- */
6
- export const createNavigation = (options) => ({
7
- pageTree: createSourceLoader(options).pageTree,
8
- });
@@ -1,111 +0,0 @@
1
- import { DocsPage as FumadocsDocsPage } from "fumadocs-ui/layouts/docs/page";
2
- import type { MDXComponents } from "mdx/types";
3
- import type { Metadata } from "next";
4
- import { type ComponentProps, type ComponentType, type ReactNode } from "react";
5
- import { NativeDocsLink } from "../components/link";
6
- import { type GeistdocsConfig } from "../config";
7
- import { type GeistdocsPageVisibilityData } from "../page-visibility";
8
- import type { GeistdocsSourceBundle } from "../source";
9
- type SourceBundle = GeistdocsSourceBundle;
10
- type GeistdocsPage = NonNullable<ReturnType<SourceBundle["source"]["getPage"]>>;
11
- type PageActionsBundle = ReturnType<typeof createPageActions>;
12
- type DocsPageLink = MDXComponents["a"];
13
- type TableOfContentOptions = NonNullable<ComponentProps<typeof FumadocsDocsPage>["tableOfContent"]>;
14
- export interface DocsPageParams extends Record<string, string | string[] | undefined> {
15
- lang: string;
16
- slug?: string[];
17
- }
18
- export interface DocsPageAccessContext<Params extends DocsPageParams = DocsPageParams> {
19
- params: Params;
20
- source: SourceBundle;
21
- }
22
- export type DocsPageAccessFilter<Params extends DocsPageParams = DocsPageParams> = (page: GeistdocsPage, context: DocsPageAccessContext<Params>) => boolean | Promise<boolean>;
23
- type DocsPageMdx = MDXComponents | ((context: {
24
- link: DocsPageLink;
25
- page: GeistdocsPage;
26
- source: SourceBundle;
27
- }) => MDXComponents);
28
- type OpenGraphImages = NonNullable<Metadata["openGraph"]>["images"];
29
- interface DocsPageOpenGraphOptions {
30
- images?: boolean | OpenGraphImages;
31
- }
32
- interface PageUrlContext<Params extends DocsPageParams = DocsPageParams> {
33
- page: GeistdocsPage;
34
- params: Params;
35
- }
36
- interface PublicPageUrlContext<Params extends DocsPageParams = DocsPageParams> extends PageUrlContext<Params> {
37
- pageUrl: string;
38
- }
39
- interface MarkdownUrlContext<Params extends DocsPageParams = DocsPageParams> extends PublicPageUrlContext<Params> {
40
- publicPageUrl: string;
41
- }
42
- export interface ResolvePageMarkdownUrlOptions {
43
- basePath?: string;
44
- isRootMountedPage?: boolean;
45
- pageUrl: string;
46
- publicPageUrl?: string;
47
- }
48
- export declare const resolvePageMarkdownUrl: (options: ResolvePageMarkdownUrlOptions) => string;
49
- interface DocsPageData extends GeistdocsPageVisibilityData {
50
- body: ComponentType<{
51
- components?: MDXComponents;
52
- }>;
53
- description?: string;
54
- full?: boolean;
55
- title: string;
56
- toc: ComponentProps<typeof FumadocsDocsPage>["toc"];
57
- }
58
- export interface CreateDocsPageOptions<Params extends DocsPageParams = DocsPageParams> {
59
- /** Return false to make a page unavailable for the current route params. */
60
- canViewPage?: DocsPageAccessFilter<Params>;
61
- config: Pick<GeistdocsConfig, "ai" | "basePath" | "defaultLanguage" | "feedback" | "github" | "pageActions" | "siteId" | "singleLanguage" | "siteUrl">;
62
- filterStaticParams?: (params: DocsPageParams) => boolean;
63
- getMarkdownUrl?: (context: MarkdownUrlContext<Params>) => string;
64
- getPageUrl?: (context: PageUrlContext<Params>) => string;
65
- getPublicPageUrl?: (context: PublicPageUrlContext<Params>) => string;
66
- mdx?: DocsPageMdx;
67
- metadata?: (context: {
68
- metadata: Metadata;
69
- page: GeistdocsPage;
70
- params: Params;
71
- }) => Metadata | Promise<Metadata>;
72
- openGraph?: DocsPageOpenGraphOptions;
73
- pageActions?: PageActionsBundle;
74
- /** Static content skips Markdown conversion; callbacks receive full context. */
75
- renderTop?: ReactNode | ((context: {
76
- data: DocsPageData;
77
- markdown: string;
78
- markdownUrl: string;
79
- page: GeistdocsPage;
80
- pageUrl: string;
81
- publicPageUrl: string;
82
- }) => ReactNode);
83
- resolveLink?: (context: {
84
- link: DocsPageLink;
85
- nativeLink: typeof NativeDocsLink;
86
- page: GeistdocsPage;
87
- source: SourceBundle;
88
- }) => DocsPageLink;
89
- source: SourceBundle;
90
- tableOfContent?: TableOfContentOptions;
91
- tableOfContentPopover?: ComponentProps<typeof FumadocsDocsPage>["tableOfContentPopover"];
92
- }
93
- /** A page factory with no implicit MDX registry; provide every named component. */
94
- export type CreateCustomDocsPageOptions<Params extends DocsPageParams = DocsPageParams> = Omit<CreateDocsPageOptions<Params>, "mdx"> & {
95
- mdx: DocsPageMdx;
96
- };
97
- export declare const createDocsPage: <Params extends DocsPageParams = DocsPageParams>({ canViewPage, config, source, mdx, pageActions, filterStaticParams, getMarkdownUrl, getPageUrl, getPublicPageUrl, metadata, openGraph, renderTop, resolveLink, tableOfContent, tableOfContentPopover, }: CreateCustomDocsPageOptions<Params>) => {
98
- Page: ({ params }: {
99
- params: Promise<Params>;
100
- }) => import("react/jsx-runtime").JSX.Element;
101
- getPageTree: (params: Params) => Promise<import("fumadocs-core/page-tree").Root>;
102
- generateStaticParams: () => (Omit<DocsPageParams, "lang"> & {
103
- lang?: string;
104
- })[];
105
- generateMetadata: ({ params, }: {
106
- params: Promise<Params>;
107
- }) => Promise<Metadata>;
108
- };
109
- export declare const createPageActions: ({ config, extraActions, getExtraActions, }: import("../internal/page-actions").CreatePageActionsOptions) => import("../internal/page-actions").CreatePageActionsOptions;
110
- export {};
111
- //# sourceMappingURL=docs-custom.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"docs-custom.d.ts","sourceRoot":"","sources":["../../src/pages/docs-custom.tsx"],"names":[],"mappings":"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"}