@farming-labs/tanstack-start 0.0.33 → 0.1.1-beta.2

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 (157) hide show
  1. package/dist/api-reference.d.ts +3 -0
  2. package/dist/api-reference.d.ts.map +1 -0
  3. package/dist/api-reference.js +20 -0
  4. package/dist/api-reference.js.map +1 -0
  5. package/dist/dist.bak/content.d.ts +40 -0
  6. package/dist/dist.bak/content.d.ts.map +1 -0
  7. package/dist/dist.bak/content.js +189 -0
  8. package/dist/dist.bak/content.js.map +1 -0
  9. package/dist/dist.bak/docs/src/api-reference.d.ts +23 -0
  10. package/dist/dist.bak/docs/src/api-reference.d.ts.map +1 -0
  11. package/dist/dist.bak/docs/src/api-reference.js +564 -0
  12. package/dist/dist.bak/docs/src/api-reference.js.map +1 -0
  13. package/dist/dist.bak/docs/src/create-theme.d.ts +74 -0
  14. package/dist/dist.bak/docs/src/create-theme.d.ts.map +1 -0
  15. package/dist/dist.bak/docs/src/create-theme.js +86 -0
  16. package/dist/dist.bak/docs/src/create-theme.js.map +1 -0
  17. package/dist/dist.bak/docs/src/define-docs.d.ts +6 -0
  18. package/dist/dist.bak/docs/src/define-docs.d.ts.map +1 -0
  19. package/dist/dist.bak/docs/src/define-docs.js +27 -0
  20. package/dist/dist.bak/docs/src/define-docs.js.map +1 -0
  21. package/dist/dist.bak/docs/src/i18n.d.ts +15 -0
  22. package/dist/dist.bak/docs/src/i18n.d.ts.map +1 -0
  23. package/dist/dist.bak/docs/src/i18n.js +48 -0
  24. package/dist/dist.bak/docs/src/i18n.js.map +1 -0
  25. package/dist/dist.bak/docs/src/index.d.ts +16 -0
  26. package/dist/dist.bak/docs/src/index.d.ts.map +1 -0
  27. package/dist/dist.bak/docs/src/index.js +14 -0
  28. package/dist/dist.bak/docs/src/index.js.map +1 -0
  29. package/dist/dist.bak/docs/src/metadata.d.ts +24 -0
  30. package/dist/dist.bak/docs/src/metadata.d.ts.map +1 -0
  31. package/dist/dist.bak/docs/src/metadata.js +90 -0
  32. package/dist/dist.bak/docs/src/metadata.js.map +1 -0
  33. package/dist/dist.bak/docs/src/server.d.ts +3 -0
  34. package/dist/dist.bak/docs/src/server.d.ts.map +1 -0
  35. package/dist/dist.bak/docs/src/server.js +2 -0
  36. package/dist/dist.bak/docs/src/server.js.map +1 -0
  37. package/dist/dist.bak/docs/src/types.d.ts +1344 -0
  38. package/dist/dist.bak/docs/src/types.d.ts.map +1 -0
  39. package/dist/dist.bak/docs/src/types.js +6 -0
  40. package/dist/dist.bak/docs/src/types.js.map +1 -0
  41. package/dist/dist.bak/docs/src/utils.d.ts +6 -0
  42. package/dist/dist.bak/docs/src/utils.d.ts.map +1 -0
  43. package/dist/dist.bak/docs/src/utils.js +32 -0
  44. package/dist/dist.bak/docs/src/utils.js.map +1 -0
  45. package/dist/dist.bak/index.d.ts +12 -0
  46. package/dist/dist.bak/index.d.ts.map +1 -0
  47. package/dist/dist.bak/index.js +12 -0
  48. package/dist/dist.bak/index.js.map +1 -0
  49. package/dist/dist.bak/react.d.ts +7 -0
  50. package/dist/dist.bak/react.d.ts.map +1 -0
  51. package/dist/dist.bak/react.js +22 -0
  52. package/dist/dist.bak/react.js.map +1 -0
  53. package/dist/dist.bak/server.d.ts +31 -0
  54. package/dist/dist.bak/server.d.ts.map +1 -0
  55. package/dist/dist.bak/server.js +638 -0
  56. package/dist/dist.bak/server.js.map +1 -0
  57. package/dist/dist.bak/tanstack-start/src/api-reference.d.ts +3 -0
  58. package/dist/dist.bak/tanstack-start/src/api-reference.d.ts.map +1 -0
  59. package/dist/dist.bak/tanstack-start/src/api-reference.js +41 -0
  60. package/dist/dist.bak/tanstack-start/src/api-reference.js.map +1 -0
  61. package/dist/dist.bak/tanstack-start/src/content.d.ts +40 -0
  62. package/dist/dist.bak/tanstack-start/src/content.d.ts.map +1 -0
  63. package/dist/dist.bak/tanstack-start/src/content.js +189 -0
  64. package/dist/dist.bak/tanstack-start/src/content.js.map +1 -0
  65. package/dist/dist.bak/tanstack-start/src/index.d.ts +12 -0
  66. package/dist/dist.bak/tanstack-start/src/index.d.ts.map +1 -0
  67. package/dist/dist.bak/tanstack-start/src/index.js +12 -0
  68. package/dist/dist.bak/tanstack-start/src/index.js.map +1 -0
  69. package/dist/dist.bak/tanstack-start/src/react.d.ts +7 -0
  70. package/dist/dist.bak/tanstack-start/src/react.d.ts.map +1 -0
  71. package/dist/dist.bak/tanstack-start/src/react.js +22 -0
  72. package/dist/dist.bak/tanstack-start/src/react.js.map +1 -0
  73. package/dist/dist.bak/tanstack-start/src/server.d.ts +32 -0
  74. package/dist/dist.bak/tanstack-start/src/server.d.ts.map +1 -0
  75. package/dist/dist.bak/tanstack-start/src/server.js +639 -0
  76. package/dist/dist.bak/tanstack-start/src/server.js.map +1 -0
  77. package/dist/dist.bak/tanstack-start/src/vite.d.ts +3 -0
  78. package/dist/dist.bak/tanstack-start/src/vite.d.ts.map +1 -0
  79. package/dist/dist.bak/tanstack-start/src/vite.js +137 -0
  80. package/dist/dist.bak/tanstack-start/src/vite.js.map +1 -0
  81. package/dist/dist.bak/vite.d.ts +3 -0
  82. package/dist/dist.bak/vite.d.ts.map +1 -0
  83. package/dist/dist.bak/vite.js +137 -0
  84. package/dist/dist.bak/vite.js.map +1 -0
  85. package/dist/docs/src/api-reference.d.ts +27 -0
  86. package/dist/docs/src/api-reference.d.ts.map +1 -0
  87. package/dist/docs/src/api-reference.js +594 -0
  88. package/dist/docs/src/api-reference.js.map +1 -0
  89. package/dist/docs/src/create-theme.d.ts +74 -0
  90. package/dist/docs/src/create-theme.d.ts.map +1 -0
  91. package/dist/docs/src/create-theme.js +86 -0
  92. package/dist/docs/src/create-theme.js.map +1 -0
  93. package/dist/docs/src/define-docs.d.ts +6 -0
  94. package/dist/docs/src/define-docs.d.ts.map +1 -0
  95. package/dist/docs/src/define-docs.js +27 -0
  96. package/dist/docs/src/define-docs.js.map +1 -0
  97. package/dist/docs/src/i18n.d.ts +15 -0
  98. package/dist/docs/src/i18n.d.ts.map +1 -0
  99. package/dist/docs/src/i18n.js +48 -0
  100. package/dist/docs/src/i18n.js.map +1 -0
  101. package/dist/docs/src/index.d.ts +16 -0
  102. package/dist/docs/src/index.d.ts.map +1 -0
  103. package/dist/docs/src/index.js +14 -0
  104. package/dist/docs/src/index.js.map +1 -0
  105. package/dist/docs/src/metadata.d.ts +24 -0
  106. package/dist/docs/src/metadata.d.ts.map +1 -0
  107. package/dist/docs/src/metadata.js +90 -0
  108. package/dist/docs/src/metadata.js.map +1 -0
  109. package/dist/docs/src/server.d.ts +3 -0
  110. package/dist/docs/src/server.d.ts.map +1 -0
  111. package/dist/docs/src/server.js +2 -0
  112. package/dist/docs/src/server.js.map +1 -0
  113. package/dist/docs/src/types.d.ts +1344 -0
  114. package/dist/docs/src/types.d.ts.map +1 -0
  115. package/dist/docs/src/types.js +6 -0
  116. package/dist/docs/src/types.js.map +1 -0
  117. package/dist/docs/src/utils.d.ts +6 -0
  118. package/dist/docs/src/utils.d.ts.map +1 -0
  119. package/dist/docs/src/utils.js +32 -0
  120. package/dist/docs/src/utils.js.map +1 -0
  121. package/dist/react.d.ts.map +1 -1
  122. package/dist/react.js +8 -4
  123. package/dist/react.js.map +1 -1
  124. package/dist/server.d.ts +1 -0
  125. package/dist/server.d.ts.map +1 -1
  126. package/dist/server.js +1 -0
  127. package/dist/server.js.map +1 -1
  128. package/dist/tanstack-start/src/api-reference.d.ts +3 -0
  129. package/dist/tanstack-start/src/api-reference.d.ts.map +1 -0
  130. package/dist/tanstack-start/src/api-reference.js +20 -0
  131. package/dist/tanstack-start/src/api-reference.js.map +1 -0
  132. package/dist/tanstack-start/src/content.d.ts +40 -0
  133. package/dist/tanstack-start/src/content.d.ts.map +1 -0
  134. package/dist/tanstack-start/src/content.js +189 -0
  135. package/dist/tanstack-start/src/content.js.map +1 -0
  136. package/dist/tanstack-start/src/index.d.ts +12 -0
  137. package/dist/tanstack-start/src/index.d.ts.map +1 -0
  138. package/dist/tanstack-start/src/index.js +12 -0
  139. package/dist/tanstack-start/src/index.js.map +1 -0
  140. package/dist/tanstack-start/src/react.d.ts +7 -0
  141. package/dist/tanstack-start/src/react.d.ts.map +1 -0
  142. package/dist/tanstack-start/src/react.js +22 -0
  143. package/dist/tanstack-start/src/react.js.map +1 -0
  144. package/dist/tanstack-start/src/server.d.ts +32 -0
  145. package/dist/tanstack-start/src/server.d.ts.map +1 -0
  146. package/dist/tanstack-start/src/server.js +639 -0
  147. package/dist/tanstack-start/src/server.js.map +1 -0
  148. package/dist/tanstack-start/src/vite.d.ts +3 -0
  149. package/dist/tanstack-start/src/vite.d.ts.map +1 -0
  150. package/dist/tanstack-start/src/vite.js +137 -0
  151. package/dist/tanstack-start/src/vite.js.map +1 -0
  152. package/dist/vite.d.ts +1 -1
  153. package/dist/vite.d.ts.map +1 -1
  154. package/dist/vite.js +135 -13
  155. package/dist/vite.js.map +1 -1
  156. package/package.json +15 -8
  157. package/src/vite.ts +152 -0
@@ -0,0 +1,639 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ import matter from "gray-matter";
4
+ import { resolveDocsI18n, resolveDocsLocale, resolveDocsPath } from "@farming-labs/docs";
5
+ import { loadDocsNavTree, loadDocsContent, flattenNavTree } from "./content.js";
6
+ export { createTanstackApiReference } from "./api-reference.js";
7
+ function resolveAIModelAndProvider(aiConfig, requestedModelId) {
8
+ const raw = aiConfig.model;
9
+ const modelList = (typeof raw === "object" && raw?.models) || [];
10
+ let modelId = requestedModelId;
11
+ if (!modelId) {
12
+ if (typeof raw === "string")
13
+ modelId = raw;
14
+ else if (typeof raw === "object")
15
+ modelId = raw.defaultModel ?? raw.models?.[0]?.id;
16
+ if (!modelId)
17
+ modelId = "gpt-4o-mini";
18
+ }
19
+ const entry = modelList.find((model) => model.id === modelId);
20
+ const providerKey = entry?.provider;
21
+ const providerConfig = providerKey && aiConfig.providers?.[providerKey];
22
+ const baseUrl = ((providerConfig && providerConfig.baseUrl) ||
23
+ aiConfig.baseUrl ||
24
+ "https://api.openai.com/v1").replace(/\/$/, "");
25
+ const apiKey = (providerConfig && providerConfig.apiKey) || aiConfig.apiKey || process.env?.OPENAI_API_KEY;
26
+ return { model: modelId, baseUrl, apiKey };
27
+ }
28
+ function resolvePreloadedContent(value) {
29
+ if (!value || typeof value !== "object")
30
+ return null;
31
+ const entries = Object.entries(value);
32
+ const normalized = {};
33
+ for (const [key, entryValue] of entries) {
34
+ if (typeof entryValue === "string") {
35
+ normalized[key] = entryValue;
36
+ continue;
37
+ }
38
+ if (entryValue &&
39
+ typeof entryValue === "object" &&
40
+ typeof entryValue.default === "string") {
41
+ normalized[key] = entryValue.default;
42
+ continue;
43
+ }
44
+ return null;
45
+ }
46
+ return normalized;
47
+ }
48
+ function stripMarkdownText(content) {
49
+ return content
50
+ .replace(/^(import|export)\s.*$/gm, "")
51
+ .replace(/<[^>]+\/>/g, "")
52
+ .replace(/<\/?[A-Z][^>]*>/g, "")
53
+ .replace(/<\/?[a-z][^>]*>/g, "")
54
+ .replace(/!\[([^\]]*)\]\([^)]+\)/g, "$1")
55
+ .replace(/\[([^\]]+)\]\([^)]+\)/g, "$1")
56
+ .replace(/^#{1,6}\s+/gm, "")
57
+ .replace(/(\*{1,3}|_{1,3})(.*?)\1/g, "$2")
58
+ .replace(/```[\s\S]*?```/g, "")
59
+ .replace(/`([^`]+)`/g, "$1")
60
+ .replace(/^>\s+/gm, "")
61
+ .replace(/^[-*_]{3,}\s*$/gm, "")
62
+ .replace(/\n{3,}/g, "\n\n")
63
+ .trim();
64
+ }
65
+ function normalizePathSegment(value) {
66
+ return value.replace(/^\/+|\/+$/g, "");
67
+ }
68
+ function joinPathParts(...parts) {
69
+ return parts
70
+ .map((part) => normalizePathSegment(part))
71
+ .filter(Boolean)
72
+ .join("/");
73
+ }
74
+ function toPosixPath(value) {
75
+ return value.replace(/\\/g, "/");
76
+ }
77
+ function buildDirPrefix(contentDir, rootDir) {
78
+ const rel = path.isAbsolute(contentDir)
79
+ ? toPosixPath(path.relative(rootDir, contentDir))
80
+ : toPosixPath(contentDir);
81
+ const normalized = normalizePathSegment(rel);
82
+ return normalized ? `/${normalized}/` : "/";
83
+ }
84
+ function toSourcePath(contentDir, relPath, rootDir) {
85
+ const base = path.isAbsolute(contentDir)
86
+ ? toPosixPath(path.relative(rootDir, contentDir))
87
+ : toPosixPath(contentDir);
88
+ return `/${joinPathParts(base, toPosixPath(relPath))}`;
89
+ }
90
+ function navTreeFromMap(contentMap, dirPrefix, entry, ordering) {
91
+ const dirs = [];
92
+ for (const key of Object.keys(contentMap)) {
93
+ if (!key.startsWith(dirPrefix))
94
+ continue;
95
+ const rel = key.slice(dirPrefix.length);
96
+ const segments = rel.split("/");
97
+ const fileName = segments.pop();
98
+ const base = fileName.replace(/\.(md|mdx)$/, "");
99
+ if (base !== "page" && base !== "index")
100
+ continue;
101
+ const { data } = matter(contentMap[key]);
102
+ const dirParts = segments;
103
+ const slug = dirParts.join("/");
104
+ const url = slug ? `/${entry}/${slug}` : `/${entry}`;
105
+ const fallbackTitle = dirParts.length > 0
106
+ ? dirParts[dirParts.length - 1]
107
+ .replace(/-/g, " ")
108
+ .replace(/\b\w/g, (char) => char.toUpperCase())
109
+ : "Documentation";
110
+ dirs.push({
111
+ parts: dirParts,
112
+ title: data.title ?? fallbackTitle,
113
+ url,
114
+ icon: data.icon,
115
+ order: typeof data.order === "number" ? data.order : Infinity,
116
+ });
117
+ }
118
+ dirs.sort((a, b) => {
119
+ if (a.parts.length !== b.parts.length)
120
+ return a.parts.length - b.parts.length;
121
+ return a.parts.join("/").localeCompare(b.parts.join("/"));
122
+ });
123
+ const children = [];
124
+ const rootInfo = dirs.find((dir) => dir.parts.length === 0);
125
+ if (rootInfo) {
126
+ children.push({
127
+ type: "page",
128
+ name: rootInfo.title,
129
+ url: rootInfo.url,
130
+ icon: rootInfo.icon,
131
+ });
132
+ }
133
+ function findSlugOrder(parentParts) {
134
+ if (!Array.isArray(ordering))
135
+ return undefined;
136
+ let items = ordering;
137
+ for (const part of parentParts) {
138
+ const found = items.find((item) => item.slug === part);
139
+ if (!found?.children)
140
+ return undefined;
141
+ items = found.children;
142
+ }
143
+ return items;
144
+ }
145
+ function buildLevel(parentParts) {
146
+ const depth = parentParts.length;
147
+ const directChildren = dirs.filter((dir) => {
148
+ if (dir.parts.length !== depth + 1)
149
+ return false;
150
+ for (let index = 0; index < depth; index++) {
151
+ if (dir.parts[index] !== parentParts[index])
152
+ return false;
153
+ }
154
+ return true;
155
+ });
156
+ const slugOrder = findSlugOrder(parentParts);
157
+ if (slugOrder) {
158
+ const slugMap = new Set(slugOrder.map((item) => item.slug));
159
+ const ordered = [];
160
+ for (const item of slugOrder) {
161
+ const match = directChildren.find((child) => child.parts[depth] === item.slug);
162
+ if (match)
163
+ ordered.push(match);
164
+ }
165
+ for (const child of directChildren) {
166
+ if (!slugMap.has(child.parts[depth]))
167
+ ordered.push(child);
168
+ }
169
+ return ordered.map((child) => {
170
+ const hasGrandChildren = dirs.some((dir) => {
171
+ if (dir.parts.length <= child.parts.length)
172
+ return false;
173
+ return child.parts.every((part, index) => dir.parts[index] === part);
174
+ });
175
+ if (hasGrandChildren) {
176
+ return {
177
+ type: "folder",
178
+ name: child.title,
179
+ icon: child.icon,
180
+ index: { type: "page", name: child.title, url: child.url, icon: child.icon },
181
+ children: buildLevel(child.parts),
182
+ };
183
+ }
184
+ return {
185
+ type: "page",
186
+ name: child.title,
187
+ url: child.url,
188
+ icon: child.icon,
189
+ };
190
+ });
191
+ }
192
+ if (ordering === "numeric") {
193
+ directChildren.sort((a, b) => a.order - b.order);
194
+ }
195
+ return directChildren.map((child) => {
196
+ const hasGrandChildren = dirs.some((dir) => {
197
+ if (dir.parts.length <= child.parts.length)
198
+ return false;
199
+ return child.parts.every((part, index) => dir.parts[index] === part);
200
+ });
201
+ if (hasGrandChildren) {
202
+ return {
203
+ type: "folder",
204
+ name: child.title,
205
+ icon: child.icon,
206
+ index: { type: "page", name: child.title, url: child.url, icon: child.icon },
207
+ children: buildLevel(child.parts),
208
+ };
209
+ }
210
+ return {
211
+ type: "page",
212
+ name: child.title,
213
+ url: child.url,
214
+ icon: child.icon,
215
+ };
216
+ });
217
+ }
218
+ children.push(...buildLevel([]));
219
+ return { name: "Docs", children };
220
+ }
221
+ function searchIndexFromMap(contentMap, dirPrefix, entry) {
222
+ const pages = [];
223
+ for (const key of Object.keys(contentMap)) {
224
+ if (!key.startsWith(dirPrefix))
225
+ continue;
226
+ const rel = key.slice(dirPrefix.length);
227
+ const segments = rel.split("/");
228
+ const fileName = segments.pop();
229
+ const base = fileName.replace(/\.(md|mdx)$/, "");
230
+ if (base !== "page" && base !== "index")
231
+ continue;
232
+ const raw = contentMap[key];
233
+ const { data, content } = matter(raw);
234
+ const slug = segments.join("/");
235
+ const url = slug ? `/${entry}/${slug}` : `/${entry}`;
236
+ const fallbackTitle = segments.length > 0
237
+ ? segments[segments.length - 1]
238
+ .replace(/-/g, " ")
239
+ .replace(/\b\w/g, (char) => char.toUpperCase())
240
+ : "Documentation";
241
+ pages.push({
242
+ slug,
243
+ url,
244
+ title: data.title ?? fallbackTitle,
245
+ description: data.description,
246
+ icon: data.icon,
247
+ content: stripMarkdownText(content),
248
+ rawContent: content,
249
+ });
250
+ }
251
+ return pages;
252
+ }
253
+ function findPageInMap(contentMap, dirPrefix, slug) {
254
+ const candidates = slug
255
+ ? [
256
+ `${dirPrefix}${slug}/page.md`,
257
+ `${dirPrefix}${slug}/page.mdx`,
258
+ `${dirPrefix}${slug}/index.md`,
259
+ `${dirPrefix}${slug}/index.mdx`,
260
+ ]
261
+ : [
262
+ `${dirPrefix}page.md`,
263
+ `${dirPrefix}page.mdx`,
264
+ `${dirPrefix}index.md`,
265
+ `${dirPrefix}index.mdx`,
266
+ ];
267
+ for (const key of candidates) {
268
+ const raw = contentMap[key];
269
+ if (raw) {
270
+ return {
271
+ raw,
272
+ relPath: key.slice(dirPrefix.length),
273
+ };
274
+ }
275
+ }
276
+ return null;
277
+ }
278
+ export function createDocsServer(config) {
279
+ const entry = config.entry ?? "docs";
280
+ const ordering = config.ordering;
281
+ const contentDirBase = config.contentDir ?? entry;
282
+ const rootDir = path.resolve(config.rootDir ?? process.cwd());
283
+ const preloaded = resolvePreloadedContent(config._preloadedContent);
284
+ const i18n = resolveDocsI18n(config.i18n);
285
+ const githubRaw = config.github;
286
+ const githubRepo = typeof githubRaw === "string"
287
+ ? githubRaw.replace(/\/$/, "")
288
+ : githubRaw?.url.replace(/\/$/, "");
289
+ const githubBranch = typeof githubRaw === "object" ? (githubRaw.branch ?? "main") : "main";
290
+ const githubContentPath = typeof githubRaw === "object" ? githubRaw.directory?.replace(/^\/|\/$/g, "") : undefined;
291
+ const aiConfig = { enabled: false, ...config.ai };
292
+ if (config.apiKey && !aiConfig.apiKey) {
293
+ aiConfig.apiKey = config.apiKey;
294
+ }
295
+ function normalizePathname(pathname) {
296
+ const trimmed = pathname.replace(/\/+$/, "");
297
+ return trimmed || "/";
298
+ }
299
+ function resolveContentDirRel(locale) {
300
+ if (!locale)
301
+ return contentDirBase;
302
+ if (path.isAbsolute(contentDirBase))
303
+ return path.join(contentDirBase, locale);
304
+ return joinPathParts(contentDirBase, locale);
305
+ }
306
+ function resolveContextFromPath(pathname, locale) {
307
+ const match = resolveDocsPath(normalizePathname(pathname), entry);
308
+ const contentDirRel = resolveContentDirRel(locale);
309
+ return {
310
+ ...match,
311
+ locale,
312
+ contentDirRel,
313
+ contentDirAbs: path.isAbsolute(contentDirRel)
314
+ ? contentDirRel
315
+ : path.resolve(rootDir, contentDirRel),
316
+ dirPrefix: buildDirPrefix(contentDirRel, rootDir),
317
+ };
318
+ }
319
+ function resolveLocaleFromRequest(request) {
320
+ if (!i18n)
321
+ return undefined;
322
+ const url = new URL(request.url);
323
+ const direct = resolveDocsLocale(url.searchParams, i18n);
324
+ if (direct)
325
+ return direct;
326
+ const referrer = request.headers.get("referer") ?? request.headers.get("referrer");
327
+ if (referrer) {
328
+ try {
329
+ const refUrl = new URL(referrer);
330
+ const fromRef = resolveDocsLocale(refUrl.searchParams, i18n);
331
+ if (fromRef)
332
+ return fromRef;
333
+ }
334
+ catch {
335
+ // ignore malformed referrer URLs
336
+ }
337
+ }
338
+ return i18n.defaultLocale;
339
+ }
340
+ function resolveContextFromRequest(request) {
341
+ const locale = resolveLocaleFromRequest(request);
342
+ const url = new URL(request.url);
343
+ const pathnameParam = url.searchParams.get("pathname");
344
+ const referrer = request.headers.get("referer") ?? request.headers.get("referrer");
345
+ let refPath;
346
+ if (referrer) {
347
+ try {
348
+ refPath = new URL(referrer).pathname;
349
+ }
350
+ catch {
351
+ refPath = undefined;
352
+ }
353
+ }
354
+ const pathname = pathnameParam ?? refPath ?? `/${entry}`;
355
+ return resolveContextFromPath(pathname, locale);
356
+ }
357
+ async function load({ pathname, locale }) {
358
+ const resolvedLocale = (i18n && locale && i18n.locales.includes(locale) ? locale : undefined) ?? i18n?.defaultLocale;
359
+ const ctx = resolveContextFromPath(pathname, resolvedLocale);
360
+ const tree = preloaded
361
+ ? navTreeFromMap(preloaded, ctx.dirPrefix, entry, ordering)
362
+ : loadDocsNavTree(ctx.contentDirAbs, entry, ordering);
363
+ const flatPages = flattenNavTree(tree);
364
+ const slug = ctx.slug;
365
+ const isIndex = slug === "";
366
+ let raw;
367
+ let relPath;
368
+ let lastModified;
369
+ if (preloaded) {
370
+ const result = findPageInMap(preloaded, ctx.dirPrefix, slug);
371
+ if (!result) {
372
+ const error = new Error(`Page not found: /${entry}/${slug}`);
373
+ error.status = 404;
374
+ throw error;
375
+ }
376
+ raw = result.raw;
377
+ relPath = result.relPath;
378
+ lastModified = new Date().toLocaleDateString("en-US", {
379
+ year: "numeric",
380
+ month: "long",
381
+ day: "numeric",
382
+ });
383
+ }
384
+ else {
385
+ let filePath = null;
386
+ relPath = "";
387
+ if (isIndex) {
388
+ for (const name of ["page.md", "page.mdx", "index.md", "index.mdx"]) {
389
+ const candidate = path.join(ctx.contentDirAbs, name);
390
+ if (fs.existsSync(candidate)) {
391
+ filePath = candidate;
392
+ relPath = name;
393
+ break;
394
+ }
395
+ }
396
+ }
397
+ else {
398
+ const candidates = [
399
+ path.join(ctx.contentDirAbs, slug, "page.md"),
400
+ path.join(ctx.contentDirAbs, slug, "page.mdx"),
401
+ path.join(ctx.contentDirAbs, slug, "index.md"),
402
+ path.join(ctx.contentDirAbs, slug, "index.mdx"),
403
+ ];
404
+ for (const candidate of candidates) {
405
+ if (fs.existsSync(candidate)) {
406
+ filePath = candidate;
407
+ relPath = path.relative(ctx.contentDirAbs, candidate);
408
+ break;
409
+ }
410
+ }
411
+ }
412
+ if (!filePath) {
413
+ const error = new Error(`Page not found: /${entry}/${slug}`);
414
+ error.status = 404;
415
+ throw error;
416
+ }
417
+ raw = fs.readFileSync(filePath, "utf-8");
418
+ const stat = fs.statSync(filePath);
419
+ lastModified = stat.mtime.toLocaleDateString("en-US", {
420
+ year: "numeric",
421
+ month: "long",
422
+ day: "numeric",
423
+ });
424
+ }
425
+ const { data, content } = matter(raw);
426
+ const currentUrl = isIndex ? `/${entry}` : `/${entry}/${slug}`;
427
+ const currentIndex = flatPages.findIndex((page) => page.url === currentUrl);
428
+ const previousPage = currentIndex > 0 ? flatPages[currentIndex - 1] : null;
429
+ const nextPage = currentIndex < flatPages.length - 1 ? flatPages[currentIndex + 1] : null;
430
+ let editOnGithub;
431
+ if (githubRepo && githubContentPath) {
432
+ const trimmed = githubContentPath.replace(/\/+$/, "");
433
+ const localePrefix = ctx.locale ? `${ctx.locale}/` : "";
434
+ editOnGithub = `${githubRepo}/blob/${githubBranch}/${trimmed}/${localePrefix}${toPosixPath(relPath)}`;
435
+ }
436
+ const fallbackTitle = isIndex
437
+ ? "Documentation"
438
+ : (slug.split("/").pop()?.replace(/-/g, " ") ?? "Documentation");
439
+ return {
440
+ tree,
441
+ flatPages,
442
+ title: data.title ?? fallbackTitle,
443
+ description: data.description,
444
+ rawContent: content,
445
+ sourcePath: toSourcePath(ctx.contentDirRel, relPath, rootDir),
446
+ entry,
447
+ locale: ctx.locale,
448
+ ...(isIndex ? {} : { slug }),
449
+ previousPage,
450
+ nextPage,
451
+ editOnGithub,
452
+ lastModified,
453
+ };
454
+ }
455
+ const searchIndexByEntry = new Map();
456
+ function getSearchIndex(ctx) {
457
+ const key = ctx.locale ?? "__default__";
458
+ const cached = searchIndexByEntry.get(key);
459
+ if (cached)
460
+ return cached;
461
+ const index = preloaded
462
+ ? searchIndexFromMap(preloaded, ctx.dirPrefix, entry)
463
+ : loadDocsContent(ctx.contentDirAbs, entry);
464
+ searchIndexByEntry.set(key, index);
465
+ return index;
466
+ }
467
+ function searchByQuery(query, ctx) {
468
+ const index = getSearchIndex(ctx);
469
+ return index
470
+ .map((page) => {
471
+ const titleMatch = page.title.toLowerCase().includes(query) ? 10 : 0;
472
+ const words = query.split(/\s+/);
473
+ const contentMatch = words.reduce((score, word) => {
474
+ return score + (page.content.toLowerCase().includes(word) ? 1 : 0);
475
+ }, 0);
476
+ return { ...page, score: titleMatch + contentMatch };
477
+ })
478
+ .filter((result) => result.score > 0)
479
+ .sort((a, b) => b.score - a.score);
480
+ }
481
+ const llmsSiteTitle = typeof config.nav === "object" && typeof config.nav?.title === "string"
482
+ ? config.nav.title
483
+ : "Documentation";
484
+ const llmsTxtConfig = config.llmsTxt;
485
+ const llmsBaseUrl = typeof llmsTxtConfig === "object" ? (llmsTxtConfig.baseUrl ?? "") : "";
486
+ const llmsTitle = typeof llmsTxtConfig === "object" ? (llmsTxtConfig.siteTitle ?? llmsSiteTitle) : llmsSiteTitle;
487
+ const llmsDesc = typeof llmsTxtConfig === "object" ? llmsTxtConfig.siteDescription : undefined;
488
+ const llmsCache = new Map();
489
+ function getLlmsContent(ctx) {
490
+ const key = ctx.locale ?? "__default__";
491
+ const cached = llmsCache.get(key);
492
+ if (cached)
493
+ return cached;
494
+ const pages = getSearchIndex(ctx);
495
+ let llmsTxt = `# ${llmsTitle}\n\n`;
496
+ let llmsFullTxt = `# ${llmsTitle}\n\n`;
497
+ if (llmsDesc) {
498
+ llmsTxt += `> ${llmsDesc}\n\n`;
499
+ llmsFullTxt += `> ${llmsDesc}\n\n`;
500
+ }
501
+ llmsTxt += "## Pages\n\n";
502
+ for (const page of pages) {
503
+ llmsTxt += `- [${page.title}](${llmsBaseUrl}${page.url})`;
504
+ if (page.description)
505
+ llmsTxt += `: ${page.description}`;
506
+ llmsTxt += "\n";
507
+ llmsFullTxt += `## ${page.title}\n\n`;
508
+ llmsFullTxt += `URL: ${llmsBaseUrl}${page.url}\n\n`;
509
+ if (page.description)
510
+ llmsFullTxt += `${page.description}\n\n`;
511
+ llmsFullTxt += `${page.content}\n\n---\n\n`;
512
+ }
513
+ const next = { llmsTxt, llmsFullTxt };
514
+ llmsCache.set(key, next);
515
+ return next;
516
+ }
517
+ function GET(event) {
518
+ const ctx = resolveContextFromRequest(event.request);
519
+ const url = new URL(event.request.url);
520
+ const format = url.searchParams.get("format");
521
+ if (format === "llms" || format === "llms-full") {
522
+ const llmsContent = getLlmsContent(ctx);
523
+ return new Response(format === "llms-full" ? llmsContent.llmsFullTxt : llmsContent.llmsTxt, {
524
+ headers: {
525
+ "Content-Type": "text/plain; charset=utf-8",
526
+ "Cache-Control": "public, max-age=3600",
527
+ },
528
+ });
529
+ }
530
+ const query = url.searchParams.get("query")?.toLowerCase().trim();
531
+ if (!query) {
532
+ return new Response(JSON.stringify([]), {
533
+ headers: { "Content-Type": "application/json" },
534
+ });
535
+ }
536
+ const results = searchByQuery(query, ctx)
537
+ .slice(0, 10)
538
+ .map(({ title, url: pageUrl, description }) => ({
539
+ content: title,
540
+ url: pageUrl,
541
+ description,
542
+ }));
543
+ return new Response(JSON.stringify(results), {
544
+ headers: { "Content-Type": "application/json" },
545
+ });
546
+ }
547
+ const projectName = typeof config.nav?.title === "string" ? config.nav.title : null;
548
+ const packageName = aiConfig.packageName;
549
+ const docsUrl = aiConfig.docsUrl;
550
+ function buildDefaultSystemPrompt() {
551
+ const lines = [
552
+ `You are a helpful documentation assistant${projectName ? ` for ${projectName}` : ""}.`,
553
+ "Answer questions based on the provided documentation context.",
554
+ "Be concise and accurate. If the answer is not in the context, say so honestly.",
555
+ "Use markdown formatting for code examples and links.",
556
+ ];
557
+ if (packageName) {
558
+ lines.push(`When showing import examples, always use "${packageName}" as the package name.`);
559
+ }
560
+ if (docsUrl) {
561
+ lines.push(`When linking to documentation pages, use "${docsUrl}" as the base URL (e.g. ${docsUrl}/docs/get-started).`);
562
+ }
563
+ return lines.join(" ");
564
+ }
565
+ const DEFAULT_SYSTEM_PROMPT = buildDefaultSystemPrompt();
566
+ async function POST(event) {
567
+ if (!aiConfig.enabled) {
568
+ return new Response(JSON.stringify({
569
+ error: "AI is not enabled. Set `ai: { enabled: true }` in your docs config to enable it.",
570
+ }), { status: 404, headers: { "Content-Type": "application/json" } });
571
+ }
572
+ const resolvedKey = aiConfig.apiKey ?? process.env?.OPENAI_API_KEY;
573
+ if (!resolvedKey) {
574
+ return new Response(JSON.stringify({
575
+ error: "AI is enabled but no API key was found. Set `apiKey` in your docs config `ai` section or add OPENAI_API_KEY to your environment.",
576
+ }), { status: 500, headers: { "Content-Type": "application/json" } });
577
+ }
578
+ const ctx = resolveContextFromRequest(event.request);
579
+ let body;
580
+ try {
581
+ body = await event.request.json();
582
+ }
583
+ catch {
584
+ return new Response(JSON.stringify({ error: "Invalid JSON body. Expected { messages: [...] }" }), { status: 400, headers: { "Content-Type": "application/json" } });
585
+ }
586
+ const messages = body.messages;
587
+ if (!Array.isArray(messages) || messages.length === 0) {
588
+ return new Response(JSON.stringify({ error: "messages array is required and must not be empty." }), { status: 400, headers: { "Content-Type": "application/json" } });
589
+ }
590
+ const lastUserMessage = [...messages].reverse().find((message) => message.role === "user");
591
+ if (!lastUserMessage) {
592
+ return new Response(JSON.stringify({ error: "At least one user message is required." }), {
593
+ status: 400,
594
+ headers: { "Content-Type": "application/json" },
595
+ });
596
+ }
597
+ const maxResults = aiConfig.maxResults ?? 5;
598
+ const scored = searchByQuery(lastUserMessage.content.toLowerCase(), ctx).slice(0, maxResults);
599
+ const contextParts = scored.map((doc) => `## ${doc.title}\nURL: ${doc.url}\n${doc.description ? `Description: ${doc.description}\n` : ""}\n${doc.content}`);
600
+ const context = contextParts.join("\n\n---\n\n");
601
+ const systemPrompt = aiConfig.systemPrompt ?? DEFAULT_SYSTEM_PROMPT;
602
+ const systemMessage = {
603
+ role: "system",
604
+ content: context
605
+ ? `${systemPrompt}\n\n---\n\nDocumentation context:\n\n${context}`
606
+ : systemPrompt,
607
+ };
608
+ const llmMessages = [
609
+ systemMessage,
610
+ ...messages.filter((message) => message.role !== "system"),
611
+ ];
612
+ const requestedModel = typeof body.model === "string" && body.model.trim().length > 0
613
+ ? body.model.trim()
614
+ : undefined;
615
+ const resolved = resolveAIModelAndProvider(aiConfig, requestedModel);
616
+ const finalKey = resolved.apiKey ?? resolvedKey;
617
+ const llmResponse = await fetch(`${resolved.baseUrl}/chat/completions`, {
618
+ method: "POST",
619
+ headers: {
620
+ "Content-Type": "application/json",
621
+ Authorization: `Bearer ${finalKey}`,
622
+ },
623
+ body: JSON.stringify({ model: resolved.model, stream: true, messages: llmMessages }),
624
+ });
625
+ if (!llmResponse.ok) {
626
+ const errText = await llmResponse.text().catch(() => "Unknown error");
627
+ return new Response(JSON.stringify({ error: `LLM API error (${llmResponse.status}): ${errText}` }), { status: 502, headers: { "Content-Type": "application/json" } });
628
+ }
629
+ return new Response(llmResponse.body, {
630
+ headers: {
631
+ "Content-Type": "text/event-stream",
632
+ "Cache-Control": "no-cache",
633
+ Connection: "keep-alive",
634
+ },
635
+ });
636
+ }
637
+ return { load, GET, POST };
638
+ }
639
+ //# sourceMappingURL=server.js.map