@farming-labs/svelte 0.2.136 → 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 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.136",
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.136"
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"