@farming-labs/svelte 0.2.137 → 0.2.138
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/server.d.ts +6 -0
- package/dist/server.js +33 -1
- package/package.json +2 -2
package/dist/server.d.ts
CHANGED
|
@@ -70,5 +70,11 @@ export interface DocsServer {
|
|
|
70
70
|
* Pass `_preloadedContent` (from `import.meta.glob`) to bundle markdown files
|
|
71
71
|
* at build time — required for serverless deployments (Vercel, Netlify, etc.)
|
|
72
72
|
* where the filesystem is not available at runtime.
|
|
73
|
+
*
|
|
74
|
+
* With `config.roots`, it serves each extra docs set too: `load` and page requests answer for the
|
|
75
|
+
* root whose `entry` owns the path, and the API route answers for the root named by `?root=`,
|
|
76
|
+
* then `?pathname=`, then the page that asked (its `Referer`). The first root serves the
|
|
77
|
+
* site-wide files (`llms.txt`, sitemap, robots) and MCP. The preloaded content must cover every
|
|
78
|
+
* root's content directory.
|
|
73
79
|
*/
|
|
74
80
|
export declare function createDocsServer(config?: Record<string, any>): DocsServer;
|
package/dist/server.js
CHANGED
|
@@ -31,7 +31,7 @@ import fs from "node:fs";
|
|
|
31
31
|
import path from "node:path";
|
|
32
32
|
import matter from "gray-matter";
|
|
33
33
|
import { applySidebarFolderIndexBehavior, buildDocsAskAIContext, buildDocsSearchFacets, buildDocsAgentDiscoverySpec, compactDocsAgentDiscoverySpec, buildDocsConfigMap, buildDocsDiagnostics, createDocsContentChangeFeed, createDocsContentChangesHttpResponse, createDocsCacheableResponse, createDocsStandardsDiscoveryResponse, createDocsMarkdownResponse, createDocsRobotsResponse, createDocsSitemapResponse, createDocsAgentTraceContext, createDocsAgentTraceId, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryProjectEvent, formatDocsAskAIPackageHints, formatDocsLastModifiedDate, findDocsMarkdownPage, getDocsLlmsTxtMaxCharsIssue, getDocsAgentManifestLinkHeader, getDocsDiscoveryLinkHeader, isDocsAgentDiscoveryRequest, isDocsContentChangesRequest, isDocsAgentsRequest, isDocsConfigRequest, isDocsDiagnosticsRequest, isDocsSkillRequest, normalizeDocsRelated, normalizePageAgentFrontmatter, normalizeDocsOkfTrustMetadataInput, parseDocsAgentFeedbackData, performDocsSearch, performDocsSearchWithMetadata, renderDocsMarkdownDocument, renderDocsLlmsTxt, renderDocsAgentsDocument, renderDocsSkillDocument, readDocsSitemapManifestFromContentMap, stripGeneratedAgentProvenance, resolveDocsAudienceMdxContent, resolveDocsAgentFeedbackConfig, resolveDocsAgentFeedbackRequest, resolvePageSidebarFolderIndexBehavior, resolveAskAISearchRequestConfig, resolveDocsSearchAudience, resolveDocsSearchError, resolveDocsSearchRequest, resolveSearchRequestConfig, resolveDocsI18n, resolveDocsLlmsTxtRequest, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsMetadataBaseUrl, resolveDocsContentChangesConfig, resolveDocsRequestApiRoute, resolveDocsRetrievalLastModified, resolveDocsPublishedAgentSkill, resolveDocsStandardsDiscoveryRequest, resolveDocsPath, resolvePageReadingTime, resolveReadingTimeOptions, resolveDocsSitemapPageLastmod, resolveDocsAgentsFormat, resolveDocsSkillFormat, inferDocsTelemetryAgentSurface, renderDocsPageStructuredDataJson, selectDocsLlmsTxtContent, validateDocsAgentFeedbackPayload, withDocsOpenApiOperationCounts, } from "@farming-labs/docs";
|
|
34
|
-
import { buildApiReferenceOpenApiDocumentAsync, buildApiReferenceOperationPagesAsync, createApiReferenceOperationMarkdownResponse, createDocsCloudAskAIResponse, createDocsMcpHttpHandler, isDocsCloudAskAIProvider, readDocsSitemapManifest, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveDocsMcpConfig, resolveConfiguredAgentSkills, serializeDocsIconRegistry, serializeOpenDocsProviders, readDocsAppVersion, } from "@farming-labs/docs/server";
|
|
34
|
+
import { buildApiReferenceOpenApiDocumentAsync, buildApiReferenceOperationPagesAsync, createApiReferenceOperationMarkdownResponse, createDocsCloudAskAIResponse, createDocsMcpHttpHandler, createDocsRootRouter, isDocsCloudAskAIProvider, readDocsSitemapManifest, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveDocsMcpConfig, resolveConfiguredAgentSkills, serializeDocsIconRegistry, serializeOpenDocsProviders, readDocsAppVersion, resolveDocsRoots, withVaryReferer, } from "@farming-labs/docs/server";
|
|
35
35
|
import { loadDocsNavTree, loadDocsContent, flattenNavTree, normalizeDocsFrontmatterLastmod, } from "./content.js";
|
|
36
36
|
import { renderMarkdown } from "./markdown.js";
|
|
37
37
|
export { createSvelteApiReference } from "./api-reference.js";
|
|
@@ -398,8 +398,40 @@ function findPageInMap(contentMap, dirPrefix, slug) {
|
|
|
398
398
|
* Pass `_preloadedContent` (from `import.meta.glob`) to bundle markdown files
|
|
399
399
|
* at build time — required for serverless deployments (Vercel, Netlify, etc.)
|
|
400
400
|
* where the filesystem is not available at runtime.
|
|
401
|
+
*
|
|
402
|
+
* With `config.roots`, it serves each extra docs set too: `load` and page requests answer for the
|
|
403
|
+
* root whose `entry` owns the path, and the API route answers for the root named by `?root=`,
|
|
404
|
+
* then `?pathname=`, then the page that asked (its `Referer`). The first root serves the
|
|
405
|
+
* site-wide files (`llms.txt`, sitemap, robots) and MCP. The preloaded content must cover every
|
|
406
|
+
* root's content directory.
|
|
401
407
|
*/
|
|
402
408
|
export function createDocsServer(config = {}) {
|
|
409
|
+
if (!config.roots?.length)
|
|
410
|
+
return createDocsRootServer(config);
|
|
411
|
+
const roots = resolveDocsRoots(config).map((root) => ({
|
|
412
|
+
entry: root.entry ?? "docs",
|
|
413
|
+
server: createDocsRootServer(root),
|
|
414
|
+
}));
|
|
415
|
+
const apiRoute = config.cloud?.apiRoute;
|
|
416
|
+
const router = createDocsRootRouter(roots, {
|
|
417
|
+
apiRoute: typeof apiRoute === "string" && apiRoute.trim() ? apiRoute : undefined,
|
|
418
|
+
});
|
|
419
|
+
function dispatch(method) {
|
|
420
|
+
return async (event) => {
|
|
421
|
+
const { root, varyReferer } = router.select(event.request);
|
|
422
|
+
const response = await root.server[method](event);
|
|
423
|
+
return varyReferer ? withVaryReferer(response) : response;
|
|
424
|
+
};
|
|
425
|
+
}
|
|
426
|
+
return {
|
|
427
|
+
load: (event) => (router.match(event.url.pathname) ?? router.primary).server.load(event),
|
|
428
|
+
GET: dispatch("GET"),
|
|
429
|
+
HEAD: dispatch("HEAD"),
|
|
430
|
+
POST: dispatch("POST"),
|
|
431
|
+
MCP: router.primary.server.MCP,
|
|
432
|
+
};
|
|
433
|
+
}
|
|
434
|
+
function createDocsRootServer(config) {
|
|
403
435
|
const entry = config.entry ?? "docs";
|
|
404
436
|
const analytics = config.analytics;
|
|
405
437
|
const observability = config.observability;
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@farming-labs/svelte",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.138",
|
|
4
4
|
"description": "SvelteKit adapter for @farming-labs/docs — content loading and navigation utilities",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"docs",
|
|
@@ -57,7 +57,7 @@
|
|
|
57
57
|
"@types/node": "^22.10.0",
|
|
58
58
|
"typescript": "^5.9.3",
|
|
59
59
|
"vitest": "^4.1.8",
|
|
60
|
-
"@farming-labs/docs": "0.2.
|
|
60
|
+
"@farming-labs/docs": "0.2.138"
|
|
61
61
|
},
|
|
62
62
|
"peerDependencies": {
|
|
63
63
|
"@farming-labs/docs": ">=0.2.73 || ^0.2.133-perf.0"
|