@farming-labs/docs 0.2.57 → 0.2.58

package/dist/{init-Dm0yDz6v.mjs → init-B_9ENq8Z.mjs}

@@ -1,5 +1,5 @@
-import { a as devInstallCommand, c as fileExists, d as readFileSafe, f as spawnAndWaitFor, i as detectPackageManagerFromProject, l as formatPackageManagerDetection, n as detectGlobalCssFiles, o as exec, p as writeFileSafe, r as detectNextAppDir, t as detectFramework, u as installCommand } from "./utils-DBCCkkJS.mjs";
-import { $ as svelteDocsPublicHookTemplate, A as nextConfigMergedTemplate, B as nuxtServerApiDocsRouteTemplate, C as injectRootProviderIntoLayout, D as injectTanstackVitePlugins, E as injectTanstackRootProviderIntoRoute, F as nuxtDocsConfigTemplate, G as quickstartPageTemplate, H as nuxtServerDocsPublicMiddlewareTemplate, I as nuxtDocsPageTemplate, J as svelteDocsApiRouteTemplate, K as rootLayoutTemplate, L as nuxtGlobalCssTemplate, M as nextLocaleDocPageTemplate, N as nextLocalizedPageTemplate, O as installationPageTemplate, P as nuxtConfigTemplate, Q as svelteDocsPageTemplate, R as nuxtInstallationPageTemplate, S as injectNuxtCssImport, T as injectSvelteDocsPublicHook, U as nuxtWelcomePageTemplate, V as nuxtServerApiReferenceRouteTemplate, W as postcssConfigTemplate, X as svelteDocsLayoutServerTemplate, Y as svelteDocsConfigTemplate, Z as svelteDocsLayoutTemplate, _ as getAstroAdapterPkg, _t as tanstackViteConfigTemplate, a as astroDocsIndexTemplate, at as svelteWelcomePageTemplate, b as injectAstroDocsMiddleware, bt as welcomePageTemplate, c as astroDocsServerTemplate, ct as tanstackDocsCatchAllRouteTemplate, d as astroQuickstartPageTemplate, dt as tanstackDocsIndexRouteTemplate, et as svelteDocsServerTemplate, f as astroWelcomePageTemplate, ft as tanstackDocsPublicRouteTemplate, g as docsLayoutTemplate, gt as tanstackRootRouteTemplate, h as docsConfigTemplate, ht as tanstackQuickstartPageTemplate, i as astroDocsConfigTemplate, it as svelteRootLayoutTemplate, j as nextConfigTemplate, k as nextApiReferencePageTemplate, l as astroGlobalCssTemplate, lt as tanstackDocsConfigTemplate, m as customThemeTsTemplate, mt as tanstackInstallationPageTemplate, n as astroApiRouteTemplate, nt as svelteInstallationPageTemplate, o as astroDocsMiddlewareTemplate, ot as tanstackApiDocsRouteTemplate, p as customThemeCssTemplate, pt as tanstackDocsServerTemplate, q as svelteApiReferenceRouteTemplate, r as astroConfigTemplate, rt as svelteQuickstartPageTemplate, s as astroDocsPageTemplate, st as tanstackApiReferenceRouteTemplate, t as astroApiReferenceRouteTemplate, tt as svelteGlobalCssTemplate, u as astroInstallationPageTemplate, ut as tanstackDocsFunctionsTemplate, v as globalCssTemplate, vt as tanstackWelcomePageTemplate, w as injectSvelteCssImport, x as injectCssImport, y as injectAstroCssImport, yt as tsconfigTemplate, z as nuxtQuickstartPageTemplate } from "./templates-1Cod8KrJ.mjs";
+import { a as devInstallCommand, c as fileExists, d as readFileSafe, f as spawnAndWaitFor, i as detectPackageManagerFromProject, l as formatPackageManagerDetection, n as detectGlobalCssFiles, o as exec, p as writeFileSafe, r as detectNextAppDir, t as detectFramework, u as installCommand } from "./utils-6UCLxv4B.mjs";
+import { $ as svelteDocsPublicHookTemplate, A as nextConfigMergedTemplate, B as nuxtServerApiDocsRouteTemplate, C as injectRootProviderIntoLayout, D as injectTanstackVitePlugins, E as injectTanstackRootProviderIntoRoute, F as nuxtDocsConfigTemplate, G as quickstartPageTemplate, H as nuxtServerDocsPublicMiddlewareTemplate, I as nuxtDocsPageTemplate, J as svelteDocsApiRouteTemplate, K as rootLayoutTemplate, L as nuxtGlobalCssTemplate, M as nextLocaleDocPageTemplate, N as nextLocalizedPageTemplate, O as installationPageTemplate, P as nuxtConfigTemplate, Q as svelteDocsPageTemplate, R as nuxtInstallationPageTemplate, S as injectNuxtCssImport, T as injectSvelteDocsPublicHook, U as nuxtWelcomePageTemplate, V as nuxtServerApiReferenceRouteTemplate, W as postcssConfigTemplate, X as svelteDocsLayoutServerTemplate, Y as svelteDocsConfigTemplate, Z as svelteDocsLayoutTemplate, _ as getAstroAdapterPkg, _t as tanstackViteConfigTemplate, a as astroDocsIndexTemplate, at as svelteWelcomePageTemplate, b as injectAstroDocsMiddleware, bt as welcomePageTemplate, c as astroDocsServerTemplate, ct as tanstackDocsCatchAllRouteTemplate, d as astroQuickstartPageTemplate, dt as tanstackDocsIndexRouteTemplate, et as svelteDocsServerTemplate, f as astroWelcomePageTemplate, ft as tanstackDocsPublicRouteTemplate, g as docsLayoutTemplate, gt as tanstackRootRouteTemplate, h as docsConfigTemplate, ht as tanstackQuickstartPageTemplate, i as astroDocsConfigTemplate, it as svelteRootLayoutTemplate, j as nextConfigTemplate, k as nextApiReferencePageTemplate, l as astroGlobalCssTemplate, lt as tanstackDocsConfigTemplate, m as customThemeTsTemplate, mt as tanstackInstallationPageTemplate, n as astroApiRouteTemplate, nt as svelteInstallationPageTemplate, o as astroDocsMiddlewareTemplate, ot as tanstackApiDocsRouteTemplate, p as customThemeCssTemplate, pt as tanstackDocsServerTemplate, q as svelteApiReferenceRouteTemplate, r as astroConfigTemplate, rt as svelteQuickstartPageTemplate, s as astroDocsPageTemplate, st as tanstackApiReferenceRouteTemplate, t as astroApiReferenceRouteTemplate, tt as svelteGlobalCssTemplate, u as astroInstallationPageTemplate, ut as tanstackDocsFunctionsTemplate, v as globalCssTemplate, vt as tanstackWelcomePageTemplate, w as injectSvelteCssImport, x as injectCssImport, y as injectAstroCssImport, yt as tsconfigTemplate, z as nuxtQuickstartPageTemplate } from "./templates-CfQjpDWW.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import pc from "picocolors";
@@ -188,7 +188,7 @@ async function configureDocsCloudOnboarding(options) {
 		enabled = cloudAnswer;
 	}
 	if (!enabled) return;
-	const { initCloudConfig } = await import("./cloud-C45jpBtp.mjs");
+	const { initCloudConfig } = await import("./cloud-BH_sHX64.mjs");
 	printDocsCloudOnboardingInstructions(await initCloudConfig({
 		rootDir: options.rootDir,
 		configPath: getDocsCloudConfigPathForFramework(options.framework)

package/dist/{mcp-BYIgKsPn.mjs → mcp-CiNww-Wu.mjs}

@@ -1,11 +1,11 @@
 import "./agent-CxDzPqtl.mjs";
-import "./search-OHp36znm.mjs";
-import "./sitemap-server-zFYctvCa.mjs";
-import "./agent-evals-BD17jOqL.mjs";
+import "./search-Bo9ubPVO.mjs";
+import "./sitemap-server-BYwE0zXs.mjs";
+import "./agent-evals-BW0vEc-F.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
-import "./code-blocks-C9awWzEQ.mjs";
+import "./code-blocks-qe0T8-xe.mjs";
 import "./server.mjs";
-import { d as readStringProperty, h as resolveDocsContentDir, l as readNavTitle, m as resolveDocsConfigPath, n as extractObjectLiteral, s as readBooleanProperty } from "./config-DZbZiYEa.mjs";
+import { d as readStringProperty, h as resolveDocsContentDir, l as readNavTitle, m as resolveDocsConfigPath, n as extractObjectLiteral, s as readBooleanProperty } from "./config-DASewQ0x.mjs";
 import { readFileSync } from "node:fs";
 import pc from "picocolors";
 

package/dist/mcp.d.mts

@@ -1,4 +1,4 @@
-import { Ft as DocsSearchSourcePage, Rt as DocsTelemetryConfig, T as DocsAnalyticsConfig, Ut as DocsTelemetryFramework, fn as PageAgentFrontmatter, kt as DocsSearchConfig, nt as DocsMcpAuthPrincipal, ot as DocsMcpConfig, pt as DocsObservabilityConfig, rt as DocsMcpAuthenticate, sn as OrderingItem, tt as DocsMcpAllowedOrigins } from "./types-R-DN23yw.mjs";
+import { $t as DocsTelemetryFramework, Ct as DocsObservabilityConfig, F as DocsAnalyticsConfig, Gt as DocsSearchSourcePage, Jt as DocsTelemetryConfig, Sn as PageAgentFrontmatter, _n as OrderingItem, dt as DocsMcpAllowedOrigins, ft as DocsMcpAuthPrincipal, gt as DocsMcpConfig, pt as DocsMcpAuthenticate, zt as DocsSearchConfig } from "./types-C1nPRXqo.mjs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 //#region src/mcp.d.ts

package/dist/mcp.mjs

@@ -1,7 +1,7 @@
 import { a as emitDocsAnalyticsEvent, i as emitDocsAgentTraceEvent, n as createDocsAgentTraceContext, r as createDocsAgentTraceId } from "./analytics-Bx44lg6d.mjs";
 import { Et as resolveDocsAudienceMdxContent, Ht as renderDocsRelatedMarkdownLines, Vt as normalizeDocsRelated, Xt as normalizePageAgentFrontmatter, Yt as hasStructuredPageAgentContract, en as upsertPageAgentContractMarkdown } from "./agent-CxDzPqtl.mjs";
-import { C as resolvePageSidebarFolderIndexBehavior, E as emitDocsTelemetryAgentSurfaceEvent, O as emitDocsTelemetryMcpToolEvent, k as emitDocsTelemetryProjectEvent, m as parseDocsMarkdownSections, p as findDocsMarkdownSection, u as performDocsSearch, x as stripGeneratedAgentProvenance } from "./search-OHp36znm.mjs";
-import { a as normalizeAgentScopeValues, i as normalizeAgentLocale, n as agentVersionConstraintsOverlap, r as normalizeAgentFramework, t as agentVersionConstraintMatches } from "./agent-scope-B8lptqCd.mjs";
+import { C as resolvePageSidebarFolderIndexBehavior, E as emitDocsTelemetryAgentSurfaceEvent, O as emitDocsTelemetryMcpToolEvent, k as emitDocsTelemetryProjectEvent, m as parseDocsMarkdownSections, p as findDocsMarkdownSection, u as performDocsSearch, x as stripGeneratedAgentProvenance } from "./search-Bo9ubPVO.mjs";
+import { a as normalizeAgentScopeValues, i as normalizeAgentLocale, n as agentVersionConstraintsOverlap, r as normalizeAgentFramework, t as agentVersionConstraintMatches } from "./agent-scope-CCaIY1aK.mjs";
 import matter from "gray-matter";
 import fs from "node:fs";
 import path from "node:path";
@@ -220,7 +220,7 @@ const DOCS_CONFIG_SCHEMA_OPTIONS_TEMPLATE = [
 		path: "agent",
 		name: "agent",
 		type: "DocsAgentConfig",
-		description: "Agent compaction defaults and deterministic usefulness evaluations.",
+		description: "Agent compaction defaults and offline-by-default usefulness evaluations.",
 		docs: "/docs/getting-started/agent-ready-docs",
 		children: [{
 			path: "agent.compact",
@@ -282,7 +282,7 @@ const DOCS_CONFIG_SCHEMA_OPTIONS_TEMPLATE = [
 			path: "agent.evaluations",
 			name: "evaluations",
 			type: "boolean | DocsAgentEvaluationsConfig",
-			description: "Deterministic golden tasks for retrieval, citation, version, example, and budget evaluation.",
+			description: "Offline-by-default golden tasks for retrieval, citation, version, example, answer, and budget evaluation, with explicit external-provider and execution opt-ins.",
 			children: [
 				{
 					path: "agent.evaluations.enabled",
@@ -305,11 +305,77 @@ const DOCS_CONFIG_SCHEMA_OPTIONS_TEMPLATE = [
 					default: 5,
 					description: "Default number of ranked search results evaluated per task."
 				},
+				{
+					path: "agent.evaluations.surface",
+					name: "surface",
+					type: "\"mcp-context\" | \"configured-search\" | \"ask-ai-context\"",
+					default: "mcp-context",
+					description: "Retrieval/context surface measured by the golden task suite."
+				},
+				{
+					path: "agent.evaluations.allowNetwork",
+					name: "allowNetwork",
+					type: "boolean",
+					default: false,
+					description: "Allow external search, HTTP answers, and explicit executable-example verification during evaluation."
+				},
+				{
+					path: "agent.evaluations.searchTimeoutMs",
+					name: "searchTimeoutMs",
+					type: "number",
+					default: 3e4,
+					description: "Per-task configured search and Ask AI retrieval timeout in milliseconds."
+				},
+				{
+					path: "agent.evaluations.answer",
+					name: "answer",
+					type: "DocsAgentEvaluationAnswerProvider",
+					description: "Opt-in callback or HTTP provider used to evaluate actual generated answers and citations.",
+					children: [
+						{
+							path: "agent.evaluations.answer.provider",
+							name: "provider",
+							type: "\"callback\" | \"http\"",
+							description: "Answer evaluation provider kind."
+						},
+						{
+							path: "agent.evaluations.answer.run",
+							name: "run",
+							type: "DocsAgentEvaluationAnswerRunner",
+							description: "Callback invoked with retrieved context and source references."
+						},
+						{
+							path: "agent.evaluations.answer.endpoint",
+							name: "endpoint",
+							type: "string",
+							description: "HTTP endpoint used by the opt-in HTTP answer provider."
+						},
+						{
+							path: "agent.evaluations.answer.headers",
+							name: "headers",
+							type: "Record<string, string>",
+							description: "Optional HTTP request headers; values are never reported.",
+							children: [{
+								path: "agent.evaluations.answer.headers.*",
+								name: "header",
+								type: "string",
+								description: "One custom HTTP header value."
+							}]
+						},
+						{
+							path: "agent.evaluations.answer.timeoutMs",
+							name: "timeoutMs",
+							type: "number",
+							default: 3e4,
+							description: "Callback or HTTP answer provider timeout in milliseconds."
+						}
+					]
+				},
 				{
 					path: "agent.evaluations.tasks",
 					name: "tasks",
 					type: "DocsAgentGoldenTask[]",
-					description: "Offline golden task fixtures evaluated by docs doctor and docs review.",
+					description: "Golden task fixtures evaluated by docs doctor and docs review; the default MCP context surface runs offline.",
 					children: [
 						{
 							path: "agent.evaluations.tasks[]",
@@ -341,6 +407,12 @@ const DOCS_CONFIG_SCHEMA_OPTIONS_TEMPLATE = [
 							type: "number",
 							description: "Per-task ranked retrieval depth override."
 						},
+						{
+							path: "agent.evaluations.tasks[].surface",
+							name: "surface",
+							type: "\"mcp-context\" | \"configured-search\" | \"ask-ai-context\"",
+							description: "Per-task evaluation surface override."
+						},
 						{
 							path: "agent.evaluations.tasks[].filters",
 							name: "filters",
@@ -371,7 +443,7 @@ const DOCS_CONFIG_SCHEMA_OPTIONS_TEMPLATE = [
 							path: "agent.evaluations.tasks[].expect",
 							name: "expect",
 							type: "DocsAgentGoldenTaskExpectation",
-							description: "Deterministic sources, rank, citation, example, and budget expectations.",
+							description: "Evaluator-only source, rank, citation, scope, answer, example, and budget expectations.",
 							children: [
 								{
 									path: "agent.evaluations.tasks[].expect.relevantSources",
@@ -416,6 +488,70 @@ const DOCS_CONFIG_SCHEMA_OPTIONS_TEMPLATE = [
 									type: "number",
 									description: "Minimum share of context bytes supplied by relevant sources."
 								},
+								{
+									path: "agent.evaluations.tasks[].expect.scope",
+									name: "scope",
+									type: "DocsAgentGoldenTaskFilters",
+									description: "Framework, version, and locale assertions checked against returned sources without pre-filtering retrieval.",
+									children: [
+										{
+											path: "agent.evaluations.tasks[].expect.scope.framework",
+											name: "framework",
+											type: "string",
+											description: "Framework the returned sources must select."
+										},
+										{
+											path: "agent.evaluations.tasks[].expect.scope.version",
+											name: "version",
+											type: "string",
+											description: "Version the returned sources must select."
+										},
+										{
+											path: "agent.evaluations.tasks[].expect.scope.locale",
+											name: "locale",
+											type: "string",
+											description: "Locale the returned sources must select."
+										}
+									]
+								},
+								{
+									path: "agent.evaluations.tasks[].expect.answer",
+									name: "answer",
+									type: "DocsAgentGoldenAnswerExpectation",
+									description: "Required answer text and citation assertions for an explicitly configured answer provider.",
+									children: [
+										{
+											path: "agent.evaluations.tasks[].expect.answer.includes",
+											name: "includes",
+											type: "string[]",
+											description: "Literal fragments required in the actual answer."
+										},
+										{
+											path: "agent.evaluations.tasks[].expect.answer.excludes",
+											name: "excludes",
+											type: "string[]",
+											description: "Literal fragments forbidden in the actual answer."
+										},
+										{
+											path: "agent.evaluations.tasks[].expect.answer.requiredCitations",
+											name: "requiredCitations",
+											type: "string[]",
+											description: "Citations required in the actual answer."
+										},
+										{
+											path: "agent.evaluations.tasks[].expect.answer.allowedCitations",
+											name: "allowedCitations",
+											type: "string[]",
+											description: "Additional valid actual-answer citations."
+										},
+										{
+											path: "agent.evaluations.tasks[].expect.answer.forbiddenCitations",
+											name: "forbiddenCitations",
+											type: "string[]",
+											description: "Citations forbidden in the actual answer."
+										}
+									]
+								},
 								{
 									path: "agent.evaluations.tasks[].expect.examples",
 									name: "examples",
@@ -470,6 +606,12 @@ const DOCS_CONFIG_SCHEMA_OPTIONS_TEMPLATE = [
 											name: "includes",
 											type: "string[]",
 											description: "Literal code fragments that must appear."
+										},
+										{
+											path: "agent.evaluations.tasks[].expect.examples[].verification",
+											name: "verification",
+											type: "\"present\" | \"syntax\" | \"execute\"",
+											description: "Required verification strength; defaults to present when runnable is false and syntax otherwise. Runtime execution is always explicit."
 										}
 									]
 								}

package/dist/metadata-3ljRN9MM.mjs

@@ -0,0 +1,237 @@
+import { Xt as normalizePageAgentFrontmatter, Yt as hasStructuredPageAgentContract } from "./agent-CxDzPqtl.mjs";
+
+//#region src/metadata.ts
+/**
+* Resolve page title using metadata titleTemplate.
+* %s is replaced with page title.
+*/
+function resolveTitle(pageTitle, metadata) {
+	return (metadata?.titleTemplate ?? "%s").replace("%s", pageTitle);
+}
+/**
+* Resolve OG image URL for a page.
+* Prefers page.openGraph.images[0], then page.ogImage, then config endpoint/default.
+*/
+function resolveOGImage(page, ogConfig, baseUrl) {
+	if (page.openGraph?.images?.length) return resolveImageUrl(page.openGraph.images[0].url, baseUrl);
+	if (!ogConfig?.enabled) return void 0;
+	if (page.ogImage) return resolveImageUrl(page.ogImage, baseUrl);
+	if (ogConfig.type === "dynamic" && ogConfig.endpoint) return `${baseUrl ?? ""}${ogConfig.endpoint}`;
+	return ogConfig.defaultImage;
+}
+function resolveImageUrl(url, baseUrl) {
+	if (url.startsWith("/") || url.startsWith("http")) return url;
+	const base = baseUrl ?? "";
+	return `${base}${base.length > 0 && !base.endsWith("/") ? "/" : ""}${url}`;
+}
+/**
+* Build the Open Graph metadata object for a page.
+* When the page has openGraph in frontmatter, uses it (with title/description filled from page if omitted).
+* Otherwise uses ogImage or config (dynamic endpoint / defaultImage).
+*/
+function buildPageOpenGraph(page, ogConfig, baseUrl) {
+	if (page.openGraph) {
+		const images = page.openGraph.images?.length ? page.openGraph.images.map((img) => ({
+			url: resolveImageUrl(img.url, baseUrl),
+			width: img.width ?? 1200,
+			height: img.height ?? 630
+		})) : void 0;
+		return {
+			title: page.openGraph.title ?? page.title,
+			description: page.openGraph.description ?? page.description,
+			...images && { images }
+		};
+	}
+	const url = resolveOGImage(page, ogConfig, baseUrl);
+	if (!url) return void 0;
+	return {
+		title: page.title,
+		...page.description && { description: page.description },
+		images: [{
+			url,
+			width: 1200,
+			height: 630
+		}]
+	};
+}
+/**
+* Build the Twitter card metadata object for a page.
+* When the page has twitter in frontmatter, uses it.
+* Otherwise builds from ogImage or config (dynamic endpoint).
+*/
+function buildPageTwitter(page, ogConfig, baseUrl) {
+	if (page.twitter) {
+		const images = page.twitter.images?.length ? page.twitter.images.map((url) => resolveImageUrl(url, baseUrl)) : void 0;
+		return {
+			...page.twitter.card && { card: page.twitter.card },
+			...page.twitter.title !== void 0 && { title: page.twitter.title },
+			...page.twitter.description !== void 0 && { description: page.twitter.description },
+			...images && { images }
+		};
+	}
+	const url = resolveOGImage(page, ogConfig, baseUrl);
+	if (!url) return void 0;
+	return {
+		card: "summary_large_image",
+		title: page.title,
+		...page.description && { description: page.description },
+		images: [url]
+	};
+}
+function normalizeBaseUrl(value) {
+	if (!value) return void 0;
+	try {
+		const url = new URL(value);
+		if (url.protocol !== "http:" && url.protocol !== "https:") return void 0;
+		return url.toString().replace(/\/+$/, "");
+	} catch {
+		return;
+	}
+}
+function absolutizeUrl(url, baseUrl) {
+	const base = normalizeBaseUrl(baseUrl);
+	if (!base) return url;
+	try {
+		return new URL(url, `${base}/`).toString();
+	} catch {
+		return url;
+	}
+}
+function titleFromSegment(segment) {
+	return segment.replace(/\.[a-z0-9]+$/i, "").replace(/[-_]+/g, " ").replace(/\b\w/g, (char) => char.toUpperCase());
+}
+function normalizeRoutePath(url) {
+	try {
+		return new URL(url, "https://farming-labs.local").pathname.replace(/\/+$/, "") || "/";
+	} catch {
+		return `/${url.replace(/^\/+/, "")}`.replace(/\/+$/, "") || "/";
+	}
+}
+function buildDefaultBreadcrumbs(input) {
+	const routePath = normalizeRoutePath(input.url);
+	const entry = (input.entry ?? "docs").replace(/^\/+|\/+$/g, "") || "docs";
+	const segments = routePath.split("/").filter(Boolean);
+	const entryParts = entry.split("/").filter(Boolean);
+	const contentSegments = segments.slice(0, entryParts.length).join("/") === entryParts.join("/") ? segments.slice(entryParts.length) : segments;
+	const breadcrumbs = [{
+		name: titleFromSegment(entryParts[entryParts.length - 1] ?? "Docs"),
+		url: `/${entry}`
+	}];
+	let current = `/${entry}`;
+	contentSegments.forEach((segment, index) => {
+		current = `${current}/${segment}`.replace(/\/+/g, "/");
+		breadcrumbs.push({
+			name: index === contentSegments.length - 1 ? input.title : titleFromSegment(segment),
+			url: current
+		});
+	});
+	return breadcrumbs;
+}
+function normalizeDateModified(value) {
+	if (!value) return void 0;
+	const date = new Date(value);
+	return Number.isNaN(date.getTime()) ? value : date.toISOString();
+}
+function buildAgentContractHowTo(value, fallback) {
+	const agent = normalizePageAgentFrontmatter(value);
+	if (!agent || !hasStructuredPageAgentContract(agent)) return void 0;
+	const steps = [];
+	for (const command of agent.commands ?? []) {
+		const run = typeof command === "string" ? command : command.run;
+		const description = typeof command === "string" ? void 0 : command.description;
+		const cwd = typeof command === "string" ? void 0 : command.cwd;
+		steps.push({
+			"@type": "HowToStep",
+			position: steps.length + 1,
+			name: description ?? "Run command",
+			text: cwd ? `${run} (from ${cwd})` : run
+		});
+	}
+	for (const verification of agent.verification ?? []) {
+		const description = typeof verification === "string" ? verification : verification.description ?? "Verify the result";
+		const details = typeof verification === "string" ? verification : [verification.run, verification.expect ? `Expected: ${verification.expect}` : void 0].filter(Boolean).join(". ");
+		steps.push({
+			"@type": "HowToStep",
+			position: steps.length + 1,
+			name: description,
+			text: details || description
+		});
+	}
+	const supplies = [...(agent.prerequisites ?? []).map((name) => ({
+		"@type": "HowToSupply",
+		name
+	})), ...(agent.files ?? []).map((name) => ({
+		"@type": "HowToSupply",
+		name
+	}))];
+	const about = Object.entries(agent.appliesTo ?? {}).flatMap(([kind, values]) => (typeof values === "string" ? [values] : values ?? []).map((name) => ({
+		"@type": "Thing",
+		name: `${kind}: ${name}`
+	})));
+	return {
+		"@type": "HowTo",
+		name: agent.task ?? fallback.title,
+		...agent.outcome ?? fallback.description ? { description: agent.outcome ?? fallback.description } : {},
+		...about.length > 0 ? { about } : {},
+		...supplies.length > 0 ? { supply: supplies } : {},
+		...steps.length > 0 ? { step: steps } : {}
+	};
+}
+/**
+* Resolve the public docs site URL from existing agent-facing config.
+*
+* The framework intentionally reuses `sitemap.baseUrl`, `llmsTxt.baseUrl`,
+* `robots.baseUrl`, or `ai.docsUrl` instead of requiring another setting.
+*/
+function resolveDocsMetadataBaseUrl(config) {
+	return [
+		typeof config.sitemap === "object" ? config.sitemap.baseUrl : void 0,
+		typeof config.llmsTxt === "object" ? config.llmsTxt.baseUrl : void 0,
+		typeof config.robots === "object" ? config.robots.baseUrl : void 0,
+		config.ai?.docsUrl
+	].map((value) => normalizeBaseUrl(value)).find((value) => Boolean(value));
+}
+/**
+* Build Schema.org JSON-LD for a docs page.
+*
+* The shape follows Vercel's agent readability guidance: a `TechArticle`
+* with title, description, canonical URL, freshness, and breadcrumbs.
+*/
+function buildDocsPageStructuredData(input) {
+	const breadcrumbs = input.breadcrumbs?.length ? input.breadcrumbs : buildDefaultBreadcrumbs(input);
+	const result = {
+		"@context": "https://schema.org",
+		"@type": "TechArticle",
+		headline: input.title,
+		name: input.title,
+		url: absolutizeUrl(input.url, input.baseUrl),
+		mainEntityOfPage: {
+			"@type": "WebPage",
+			"@id": absolutizeUrl(input.url, input.baseUrl)
+		},
+		breadcrumb: {
+			"@type": "BreadcrumbList",
+			itemListElement: breadcrumbs.map((item, index) => ({
+				"@type": "ListItem",
+				position: index + 1,
+				name: item.name,
+				item: absolutizeUrl(item.url, input.baseUrl)
+			}))
+		}
+	};
+	if (input.description) result.description = input.description;
+	const agentContract = buildAgentContractHowTo(input.agent, input);
+	if (agentContract) result.mainEntity = agentContract;
+	const dateModified = normalizeDateModified(input.dateModified);
+	if (dateModified) result.dateModified = dateModified;
+	return result;
+}
+/**
+* Serialize Schema.org JSON-LD for safe insertion into a `<script>` tag.
+*/
+function renderDocsPageStructuredDataJson(input) {
+	return JSON.stringify(buildDocsPageStructuredData(input)).replace(/</g, "\\u003c");
+}
+
+//#endregion
+export { resolveDocsMetadataBaseUrl as a, renderDocsPageStructuredDataJson as i, buildPageOpenGraph as n, resolveOGImage as o, buildPageTwitter as r, resolveTitle as s, buildDocsPageStructuredData as t };

package/dist/{package-version-DRIc08EU.mjs → package-version-qik_4J6C.mjs}

@@ -1,4 +1,4 @@
-import { i as detectPackageManagerFromProject, l as formatPackageManagerDetection, t as detectFramework, u as installCommand } from "./utils-DBCCkkJS.mjs";
+import { i as detectPackageManagerFromProject, l as formatPackageManagerDetection, t as detectFramework, u as installCommand } from "./utils-6UCLxv4B.mjs";
 import pc from "picocolors";
 import * as p from "@clack/prompts";