@farming-labs/docs 0.2.117 → 0.2.119

package/dist/sitemap-server-Lg3YhUx4.mjs

@@ -0,0 +1,18 @@
+import { Rt as resolveDocsSitemapConfig } from "./agent-DkAidqtV.mjs";
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+
+//#region src/sitemap-server.ts
+function readDocsSitemapManifest(rootDir, sitemap) {
+	const resolved = resolveDocsSitemapConfig(sitemap);
+	const manifestPath = path.resolve(rootDir, resolved.manifestPath);
+	if (!existsSync(manifestPath)) return null;
+	try {
+		return JSON.parse(readFileSync(manifestPath, "utf-8"));
+	} catch {
+		return null;
+	}
+}
+
+//#endregion
+export { readDocsSitemapManifest as t };

package/dist/{skills-B6wl1bUL.mjs → skills-a90P31sJ.mjs}

@@ -1,18 +1,22 @@
-import { _ as hasStructuredPageAgentContract, v as normalizePageAgentFrontmatter } from "./markdown-sections-BKy4labo.mjs";
-import "./agent-CEZCaYto.mjs";
-import "./standards-discovery-Bpz90VYq.mjs";
+import "./http-body-DkAPk6D5.mjs";
+import { _ as hasStructuredPageAgentContract, v as normalizePageAgentFrontmatter } from "./markdown-sections-9Oxr33b-.mjs";
+import "./agent-DkAidqtV.mjs";
+import "./standards-discovery-sSEojU80.mjs";
 import { isDocsAgentSkillName, validateDocsAgentSkillFrontmatter } from "./agent-skills-spec.mjs";
-import "./openapi-mcp-UF4Cx885.mjs";
-import "./sitemap-server-C4bpuoLi.mjs";
-import "./api-reference-0XdEWya8.mjs";
-import "./agent-skills-server-Ddm90WL6.mjs";
-import "./agent-evals-CmeTjDMC.mjs";
+import "./sidebar-CFHBj29f.mjs";
+import "./openapi-mcp-BIOTLiA7.mjs";
+import "./prompt-utils-B5g-bv7o.mjs";
+import "./api-reference-By_LokQ-.mjs";
+import "./agent-skills-server-BC7md56k.mjs";
+import "./agent-evals-BLNLvXbG.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
-import "./authoring-mcp-C35lj3cI.mjs";
+import "./authoring-mcp-CiCUQe3o.mjs";
+import "./cloud-ask-ai-BqKhjpS5.mjs";
 import "./code-blocks-GYdvS3BH.mjs";
+import "./sitemap-server-Lg3YhUx4.mjs";
 import "./server.mjs";
-import { _ as resolveDocsContentDir, a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-BnUOoj07.mjs";
-import { n as estimateAgentSkillInstructionTokens, r as resolveDocsAgentSkillsProgressiveDisclosureConfig } from "./agent-skills-progressive-disclosure-BDSjGGFd.mjs";
+import { _ as resolveDocsContentDir, a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-BZnKAj_Y.mjs";
+import { n as estimateAgentSkillInstructionTokens, r as resolveDocsAgentSkillsProgressiveDisclosureConfig } from "./agent-skills-progressive-disclosure-PjPtTYL-.mjs";
 import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import { createHash } from "node:crypto";

package/dist/{standards-discovery-C1RLKwV9.d.mts → standards-discovery-1fiUVDAo.d.mts}

@@ -1,4 +1,4 @@
-import { F as DocsAgentA2ASkill, M as DocsAgentA2ASecurityRequirement, N as DocsAgentA2ASecurityScheme, _ as DocsAgentA2ACapabilities, j as DocsAgentA2AProtocolBinding, v as DocsAgentA2AConfig } from "./types-Dkl2DUfp.mjs";
+import { F as DocsAgentA2ASkill, M as DocsAgentA2ASecurityRequirement, N as DocsAgentA2ASecurityScheme, _ as DocsAgentA2ACapabilities, j as DocsAgentA2AProtocolBinding, v as DocsAgentA2AConfig } from "./types-BncG8J3g.mjs";
 
 //#region src/standards-discovery.d.ts
 declare const DEFAULT_API_CATALOG_ROUTE = "/.well-known/api-catalog";

package/dist/{standards-discovery-Bpz90VYq.mjs → standards-discovery-sSEojU80.mjs}

@@ -1,4 +1,4 @@
-import { i as sha256DocsContent } from "./retrieval-digest-B-SgtXKK.mjs";
+import { i as sha256DocsContent } from "./retrieval-digest-CT-eIEcp.mjs";
 import { parseDocsAgentSkillFrontmatter, validateDocsAgentSkillFrontmatter } from "./agent-skills-spec.mjs";
 
 //#region src/http-cache.ts

package/dist/{types-Dkl2DUfp.d.mts → types-BncG8J3g.d.mts}

@@ -904,7 +904,7 @@ interface DocsAnalyticsConfig {
   cloud?: boolean;
 }
 type DocsTelemetryFramework = "next" | "tanstack-start" | "farmjs" | "sveltekit" | "astro" | "nuxt" | "mcp" | (string & {});
-type DocsTelemetryEventType = "project_detected" | "agent_surface_used" | "mcp_request" | "mcp_tool_used" | (string & {});
+type DocsTelemetryEventType = "project_detected" | "page_view" | "agent_surface_used" | "mcp_request" | "mcp_tool_used" | (string & {});
 type DocsTelemetryAgentSurface = "agent_spec" | "agents" | "skill" | "markdown" | "llms" | "agent_feedback_schema" | "agent_feedback_submit" | "content_changes" | "ask_ai" | "mcp";
 interface DocsTelemetryConfig {
   /** Enable Farming Labs maintainer telemetry. Defaults to production-only enabled. */

package/dist/{upgrade-8zStRidw.mjs → upgrade-DlQMOFV1.mjs}

@@ -1,5 +1,5 @@
-import { c as fileExists, o as exec } from "./utils-c9arebCi.mjs";
-import { a as getPackagesForFramework, c as resolveDocsPackageManager, i as frameworkFromPreset, l as validateUpgradeVersion, n as PRESETS, o as presetFromFramework, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework, t as PACKAGES_BY_FRAMEWORK } from "./package-version-CTkii52k.mjs";
+import { c as fileExists, o as exec } from "./utils-C7KDrPpA.mjs";
+import { a as getPackagesForFramework, c as resolveDocsPackageManager, i as frameworkFromPreset, l as validateUpgradeVersion, n as PRESETS, o as presetFromFramework, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework, t as PACKAGES_BY_FRAMEWORK } from "./package-version-HJhYeq4M.mjs";
 import path from "node:path";
 import pc from "picocolors";
 import * as p from "@clack/prompts";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.2.117",
+  "version": "0.2.119",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",
@@ -34,6 +34,11 @@
       "import": "./dist/server.mjs",
       "default": "./dist/server.mjs"
     },
+    "./runtime": {
+      "types": "./dist/runtime.d.mts",
+      "import": "./dist/runtime.mjs",
+      "default": "./dist/runtime.mjs"
+    },
     "./markdown-rendering": {
       "types": "./dist/markdown-rendering.d.mts",
       "import": "./dist/markdown-rendering.mjs",
@@ -89,7 +94,7 @@
     "parse-entities": "^4.0.2",
     "picocolors": "^1.1.1",
     "remark-gfm": "^4.0.1",
-    "yaml": "^2.8.2",
+    "yaml": "^2.8.3",
     "zod": "^4.3.6"
   },
   "peerDependencies": {
@@ -101,7 +106,7 @@
     }
   },
   "devDependencies": {
-    "@modelcontextprotocol/client": "2.0.0",
+    "@modelcontextprotocol/client": "2.2.0",
     "@types/node": "^22.10.0",
     "@types/react": "^19.2.2",
     "ajv": "^8.18.0",

package/dist/audience-exposure-DVsfT9Sx.mjs

@@ -1,8 +0,0 @@
-//#region src/audience-exposure.ts
-/** Resolve whether content with an optional audience restriction is visible. */
-function resolveDocsAudienceExposure(only, audience) {
-	return only !== "human" && only !== "agent" || only === audience;
-}
-
-//#endregion
-export { resolveDocsAudienceExposure as t };

package/dist/sidebar-3W51s2sF.mjs

@@ -1,73 +0,0 @@
-//#region src/sidebar.ts
-function resolvePageSidebarFolderIndexBehavior(sidebar) {
-	if (!sidebar || typeof sidebar !== "object") return void 0;
-	const value = sidebar.folderIndexBehavior;
-	return value === "link" || value === "toggle" || value === "hidden" ? value : void 0;
-}
-function normalizeSidebarFolderBehaviorPath(path) {
-	if (!path) return void 0;
-	let value = path.trim();
-	if (!value) return void 0;
-	if (/^[a-zA-Z][a-zA-Z\d+\-.]*:\/\//.test(value)) try {
-		value = new URL(value).pathname;
-	} catch {
-		return;
-	}
-	else value = value.split("#", 1)[0]?.split("?", 1)[0] ?? value;
-	if (!value.startsWith("/")) value = `/${value}`;
-	return value.replace(/\/$/, "") || "/";
-}
-function resolveSidebarFolderIndexBehavior(sidebar, defaultBehavior = "link") {
-	if (sidebar === void 0 || sidebar === true || sidebar === false) return defaultBehavior;
-	if (sidebar.folderIndexBehavior === "toggle") return "toggle";
-	if (sidebar.folderIndexBehavior === "hidden") return "hidden";
-	if (sidebar.folderIndexBehavior === "link") return "link";
-	return defaultBehavior;
-}
-function resolveSidebarFolderIndexBehaviorForPath(sidebar, folderPath, defaultBehavior = "link") {
-	const fallback = resolveSidebarFolderIndexBehavior(sidebar, defaultBehavior);
-	if (!sidebar || typeof sidebar !== "object") return fallback;
-	const normalizedPath = normalizeSidebarFolderBehaviorPath(folderPath);
-	if (!normalizedPath) return fallback;
-	for (const [rawPath, override] of Object.entries(sidebar.folderIndexBehaviorOverrides ?? {})) if (normalizeSidebarFolderBehaviorPath(rawPath) === normalizedPath) return override === "link" || override === "toggle" || override === "hidden" ? override : fallback;
-	return fallback;
-}
-function applySidebarFolderIndexBehavior(tree, behaviorOrOptions) {
-	const resolveBehavior = typeof behaviorOrOptions === "string" ? () => behaviorOrOptions : (folderPath) => resolveSidebarFolderIndexBehaviorForPath(behaviorOrOptions.sidebar, folderPath, behaviorOrOptions.defaultBehavior);
-	function mapNode(node) {
-		if (!node || typeof node !== "object") return node;
-		const candidate = node;
-		if (candidate.type !== "folder" || !Array.isArray(candidate.children)) return node;
-		const children = candidate.children.map(mapNode);
-		const index = candidate.index ? mapNode(candidate.index) : void 0;
-		const folderPath = (typeof candidate.url === "string" ? candidate.url : void 0) || (candidate.index && typeof candidate.index === "object" && "url" in candidate.index && typeof candidate.index.url === "string" ? candidate.index.url ?? void 0 : void 0);
-		const behavior = (candidate.folderIndexBehavior === "link" || candidate.folderIndexBehavior === "toggle" || candidate.folderIndexBehavior === "hidden" ? candidate.folderIndexBehavior : void 0) ?? resolveBehavior(folderPath);
-		if (behavior === "link") return {
-			...candidate,
-			folderIndexBehavior: void 0,
-			index,
-			children
-		};
-		if (behavior === "hidden") return {
-			...candidate,
-			folderIndexBehavior: void 0,
-			index: void 0,
-			url: void 0,
-			children
-		};
-		return {
-			...candidate,
-			folderIndexBehavior: void 0,
-			index: void 0,
-			url: void 0,
-			children: index ? [index, ...children] : children
-		};
-	}
-	return {
-		...tree,
-		children: tree.children.map(mapNode)
-	};
-}
-
-//#endregion
-export { resolveSidebarFolderIndexBehaviorForPath as i, resolvePageSidebarFolderIndexBehavior as n, resolveSidebarFolderIndexBehavior as r, applySidebarFolderIndexBehavior as t };

package/dist/sidebar-CGbvEPTX.d.mts

@@ -1,15 +0,0 @@
-import { ci as SidebarConfig, li as SidebarFolderIndexBehavior } from "./types-Dkl2DUfp.mjs";
-
-//#region src/sidebar.d.ts
-interface SidebarFolderIndexBehaviorOptions {
-  sidebar: boolean | SidebarConfig | undefined;
-  defaultBehavior?: SidebarFolderIndexBehavior;
-}
-declare function resolvePageSidebarFolderIndexBehavior(sidebar: unknown): SidebarFolderIndexBehavior | undefined;
-declare function resolveSidebarFolderIndexBehavior(sidebar: boolean | SidebarConfig | undefined, defaultBehavior?: SidebarFolderIndexBehavior): SidebarFolderIndexBehavior;
-declare function resolveSidebarFolderIndexBehaviorForPath(sidebar: boolean | SidebarConfig | undefined, folderPath: string | undefined, defaultBehavior?: SidebarFolderIndexBehavior): SidebarFolderIndexBehavior;
-declare function applySidebarFolderIndexBehavior<TTree extends {
-  children: unknown[];
-}>(tree: TTree, behaviorOrOptions: SidebarFolderIndexBehavior | SidebarFolderIndexBehaviorOptions): TTree;
-//#endregion
-export { resolveSidebarFolderIndexBehaviorForPath as i, resolvePageSidebarFolderIndexBehavior as n, resolveSidebarFolderIndexBehavior as r, applySidebarFolderIndexBehavior as t };