@farming-labs/docs 0.2.118 → 0.2.120

package/dist/sidebar-CMPbVfGP.d.mts

@@ -0,0 +1,63 @@
+import { Cr as DocsTelemetryConfig, Dr as DocsTelemetryFeatures, Or as DocsTelemetryFramework, Sr as DocsTelemetryAgentSurface, Wt as DocsConfig, di as SidebarFolderIndexBehavior, ui as SidebarConfig, wr as DocsTelemetryEvent } from "./types-BJFeMXWZ.mjs";
+
+//#region src/telemetry.d.ts
+interface ResolvedDocsTelemetryConfig {
+  enabled: boolean;
+  endpoint?: string;
+}
+interface DocsTelemetryContext {
+  framework?: DocsTelemetryFramework;
+  request?: Request;
+  siteOrigin?: string;
+  properties?: Record<string, unknown>;
+}
+interface DocsTelemetryAgentSurfaceContext extends DocsTelemetryContext {
+  surface: DocsTelemetryAgentSurface;
+}
+interface DocsTelemetryPageViewContext {
+  framework?: DocsTelemetryFramework;
+  siteOrigin?: string;
+  path?: string;
+  locale?: string;
+}
+interface DocsTelemetryAgentSurfaceRequestOptions {
+  entry: string;
+  llmsTxt?: DocsConfig["llmsTxt"];
+  feedback?: DocsConfig["feedback"];
+}
+declare function resolveDocsTelemetryConfig(telemetry?: boolean | DocsTelemetryConfig): ResolvedDocsTelemetryConfig;
+/** Normalize an HTTP(S) telemetry site value to its origin. */
+declare function normalizeDocsTelemetryOrigin(candidate: string | undefined): string | undefined;
+/** Return whether a telemetry origin points at a local development server. */
+declare function isLocalDocsTelemetryOrigin(candidate: string | undefined): boolean;
+declare function getDocsTelemetryFeatures(config: Partial<DocsConfig>): DocsTelemetryFeatures;
+declare function emitDocsTelemetryEvent(telemetry: boolean | DocsTelemetryConfig | undefined, event: DocsTelemetryEvent): Promise<void>;
+declare function emitDocsTelemetryProjectEvent(config: Partial<DocsConfig>, context?: DocsTelemetryContext): void;
+/**
+ * Emit a privacy-preserving browser page view for the maintainer telemetry dashboard.
+ *
+ * Page views include only the public site origin, pathname, locale, framework, and package
+ * metadata. They never include a query string, referrer, visitor id, IP address, or user agent.
+ */
+declare function emitDocsTelemetryPageViewEvent(telemetry: boolean | DocsTelemetryConfig | undefined, context?: DocsTelemetryPageViewContext): void;
+declare function emitDocsTelemetryAgentSurfaceEvent(config: Partial<DocsConfig>, context: DocsTelemetryAgentSurfaceContext): void;
+declare function emitDocsTelemetryMcpToolEvent(config: Partial<DocsConfig>, context: DocsTelemetryContext & {
+  tool: string;
+  locale?: string;
+  resultCount?: number;
+}): void;
+declare function inferDocsTelemetryAgentSurface(request: Request, options: DocsTelemetryAgentSurfaceRequestOptions): DocsTelemetryAgentSurface | undefined;
+//#endregion
+//#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 { isLocalDocsTelemetryOrigin as _, DocsTelemetryAgentSurfaceContext as a, DocsTelemetryPageViewContext as c, emitDocsTelemetryEvent as d, emitDocsTelemetryMcpToolEvent as f, inferDocsTelemetryAgentSurface as g, getDocsTelemetryFeatures as h, resolveSidebarFolderIndexBehaviorForPath as i, ResolvedDocsTelemetryConfig as l, emitDocsTelemetryProjectEvent as m, resolvePageSidebarFolderIndexBehavior as n, DocsTelemetryAgentSurfaceRequestOptions as o, emitDocsTelemetryPageViewEvent as p, resolveSidebarFolderIndexBehavior as r, DocsTelemetryContext as s, applySidebarFolderIndexBehavior as t, emitDocsTelemetryAgentSurfaceEvent as u, normalizeDocsTelemetryOrigin as v, resolveDocsTelemetryConfig as y };

package/dist/{sitemap-BEUEeKbt.d.mts → sitemap-Cl8vrixd.d.mts}

@@ -1,5 +1,5 @@
-import { oi as ResolvedDocsRelatedLink, yr as DocsSitemapConfig } from "./types-Ba9Dd_fe.mjs";
-import { R as DocsDiscoveryApiRouteOptions } from "./standards-discovery-C3AB6qNv.mjs";
+import { ci as ResolvedDocsRelatedLink, xr as DocsSitemapConfig } from "./types-BJFeMXWZ.mjs";
+import { R as DocsDiscoveryApiRouteOptions } from "./standards-discovery-BHPc7YIX.mjs";
 
 //#region src/sitemap.d.ts
 declare const DEFAULT_SITEMAP_XML_ROUTE = "/sitemap.xml";

package/dist/{sitemap-Du2wWBmo.mjs → sitemap-DW5LDKDa.mjs}

@@ -1,20 +1,21 @@
 import "./http-body-DkAPk6D5.mjs";
 import "./markdown-sections-9Oxr33b-.mjs";
-import { It as renderDocsSitemapMarkdown, Lt as renderDocsSitemapXml, Nt as buildDocsSitemapManifest, Rt as resolveDocsSitemapConfig } from "./agent-BErhm-eR.mjs";
-import "./standards-discovery-BQQ3CAzz.mjs";
-import "./openapi-mcp-gbEUXMkc.mjs";
-import "./prompt-utils-Dj8-I3Jw.mjs";
-import "./api-reference-DafuHRtc.mjs";
-import "./agent-skills-server-CJh3EGWC.mjs";
-import "./agent-evals-BHXe_A2m.mjs";
+import { It as renderDocsSitemapMarkdown, Lt as renderDocsSitemapXml, Nt as buildDocsSitemapManifest, Rt as resolveDocsSitemapConfig } from "./agent-DkAidqtV.mjs";
+import "./standards-discovery-sSEojU80.mjs";
+import "./sidebar-CFHBj29f.mjs";
+import "./openapi-mcp-BIOTLiA7.mjs";
+import "./prompt-utils-B5g-bv7o.mjs";
+import "./api-reference-BYee4zMo.mjs";
+import "./agent-skills-server-BC7md56k.mjs";
+import "./agent-evals-BLNLvXbG.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
-import "./authoring-mcp-BmohXL7E.mjs";
-import "./cloud-ask-ai-Bq_njfjh.mjs";
-import "./code-blocks-BE3sEayp.mjs";
-import "./sitemap-server-CClBRp7_.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, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-DDuQ4Qma.mjs";
-import { t as detectFramework } from "./utils-8H7dkC8w.mjs";
+import { _ as resolveDocsContentDir, a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-BZnKAj_Y.mjs";
+import { t as detectFramework } from "./utils-C7KDrPpA.mjs";
 import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import { execFileSync } from "node:child_process";

package/dist/{sitemap-server-DNsVKCnP.d.mts → sitemap-server-BUdPBcGs.d.mts}

@@ -1,5 +1,5 @@
-import { Ht as DocsConfig, a as ApiReferenceRenderer, gr as DocsSearchSourcePage, vn as DocsOkfConfig, wn as DocsOpenApiMcpConfig, yr as DocsSitemapConfig } from "./types-Ba9Dd_fe.mjs";
-import { s as DocsSitemapManifest } from "./sitemap-BEUEeKbt.mjs";
+import { En as DocsOpenApiMcpConfig, Wt as DocsConfig, a as ApiReferenceRenderer, bn as DocsOkfConfig, vr as DocsSearchSourcePage, xr as DocsSitemapConfig } from "./types-BJFeMXWZ.mjs";
+import { s as DocsSitemapManifest } from "./sitemap-Cl8vrixd.mjs";
 
 //#region src/api-reference.d.ts
 type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD";
@@ -23,6 +23,7 @@ interface ResolvedApiReferenceConfig {
   defaultVersion?: string;
   catalogTargets?: string[];
   renderer?: ApiReferenceRenderer;
+  rendererOptions?: Readonly<Record<string, unknown>>;
   mcp?: DocsOpenApiMcpConfig;
   routeRoot: string;
   exclude: string[];

package/dist/{sitemap-server-CClBRp7_.mjs → sitemap-server-Lg3YhUx4.mjs}

@@ -1,4 +1,4 @@
-import { Rt as resolveDocsSitemapConfig } from "./agent-BErhm-eR.mjs";
+import { Rt as resolveDocsSitemapConfig } from "./agent-DkAidqtV.mjs";
 import { existsSync, readFileSync } from "node:fs";
 import path from "node:path";
 

package/dist/{skills-BC0GTdUM.mjs → skills-BAPQLSCm.mjs}

@@ -1,21 +1,22 @@
 import "./http-body-DkAPk6D5.mjs";
 import { _ as hasStructuredPageAgentContract, v as normalizePageAgentFrontmatter } from "./markdown-sections-9Oxr33b-.mjs";
-import "./agent-BErhm-eR.mjs";
-import "./standards-discovery-BQQ3CAzz.mjs";
+import "./agent-DkAidqtV.mjs";
+import "./standards-discovery-sSEojU80.mjs";
 import { isDocsAgentSkillName, validateDocsAgentSkillFrontmatter } from "./agent-skills-spec.mjs";
-import "./openapi-mcp-gbEUXMkc.mjs";
-import "./prompt-utils-Dj8-I3Jw.mjs";
-import "./api-reference-DafuHRtc.mjs";
-import "./agent-skills-server-CJh3EGWC.mjs";
-import "./agent-evals-BHXe_A2m.mjs";
+import "./sidebar-CFHBj29f.mjs";
+import "./openapi-mcp-BIOTLiA7.mjs";
+import "./prompt-utils-B5g-bv7o.mjs";
+import "./api-reference-BYee4zMo.mjs";
+import "./agent-skills-server-BC7md56k.mjs";
+import "./agent-evals-BLNLvXbG.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
-import "./authoring-mcp-BmohXL7E.mjs";
-import "./cloud-ask-ai-Bq_njfjh.mjs";
-import "./code-blocks-BE3sEayp.mjs";
-import "./sitemap-server-CClBRp7_.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-DDuQ4Qma.mjs";
-import { n as estimateAgentSkillInstructionTokens, r as resolveDocsAgentSkillsProgressiveDisclosureConfig } from "./agent-skills-progressive-disclosure-1XPV0wCN.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-C3AB6qNv.d.mts → standards-discovery-BHPc7YIX.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-Ba9Dd_fe.mjs";
+import { F as DocsAgentA2ASecurityScheme, L as DocsAgentA2ASkill, N as DocsAgentA2AProtocolBinding, P as DocsAgentA2ASecurityRequirement, b as DocsAgentA2AConfig, y as DocsAgentA2ACapabilities } from "./types-BJFeMXWZ.mjs";
 
 //#region src/standards-discovery.d.ts
 declare const DEFAULT_API_CATALOG_ROUTE = "/.well-known/api-catalog";

package/dist/{types-Ba9Dd_fe.d.mts → types-BJFeMXWZ.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. */
@@ -2739,6 +2739,19 @@ interface ChangelogConfig {
   actionsComponent?: unknown;
 }
 type ApiReferenceRenderer = "farming-labs" | "fumadocs" | "scalar";
+/** Renderer selection with renderer-specific options supplied by a framework adapter. */
+interface ApiReferenceRendererConfig {
+  /** Renderer implementation to use. */
+  name: ApiReferenceRenderer;
+  /**
+   * Options forwarded to the selected renderer.
+   *
+   * Use the framework adapter's typed renderer helper when available. For example,
+   * Next.js exports `fumadocsRenderer()` from `@farming-labs/next/fumadocs-renderer`.
+   */
+  options?: Readonly<Record<string, unknown>>;
+}
+type ApiReferenceRendererInput = ApiReferenceRenderer | ApiReferenceRendererConfig;
 interface ApiReferenceVersionConfig {
   /** OpenAPI JSON or YAML source for this stable version identifier. */
   specUrl: string;
@@ -2860,10 +2873,14 @@ interface ApiReferenceConfig {
    * - `"farming-labs"` uses the framework-neutral renderer backed by the normalized operation model
    * - `"fumadocs"` uses the Fumadocs OpenAPI renderer bundled by `@farming-labs/next`
    * - `"scalar"` uses the Scalar renderer bundled by `@farming-labs/docs` and the adapters
+   * - `{ name, options }` selects a renderer and forwards adapter-specific options
+   *
+   * Next.js provides `fumadocsRenderer()` from `@farming-labs/next/fumadocs-renderer` for typed
+   * Fumadocs playground and runtime options.
    *
    * @default "farming-labs"
    */
-  renderer?: ApiReferenceRenderer;
+  renderer?: ApiReferenceRendererInput;
   /**
    * Explicitly expose selected OpenAPI operations as MCP tools. This is deny-by-default:
    * set `operations`, or mark an operation with `x-farming-labs-mcp.enabled: true`.
@@ -4175,4 +4192,4 @@ interface DocsConfig {
   og?: OGConfig;
 }
 //#endregion
-export { DocsAgentGoldenExampleVerification as $, DocsSearchFacetValue as $n, PageAgentVerification as $r, DocsI18nConfig as $t, DocsAgentA2AOpenIdConnectSecurityScheme as A, DocsRetrievalSourceProvenance as An, GithubConfig as Ar, DocsCloudConfig as At, DocsAgentEvaluationAnswerProvider as B, DocsSearchAdapter as Bn, OpenDocsProviderConfig as Br, DocsCodeBlocksValidationMode as Bt, DocsAgentA2AOAuth2SecurityScheme as C, DocsOkfTrustTier as Cn, DocsTelemetryEventInput as Cr, DocsAskAIActionType as Ct, DocsAgentA2AOAuthFlows as D, DocsPageAccessPolicy as Dn, DocsTheme as Dr, DocsAskAIFeedbackValue as Dt, DocsAgentA2AOAuthDeviceCodeFlow as E, DocsOpenApiMcpHeaders as En, DocsTelemetryFramework as Er, DocsAskAIFeedbackMessage as Et, DocsAgentA2ASkill as F, DocsReviewRulesConfig as Fn, LlmsTxtSectionConfig as Fr, DocsCodeBlocksPlannerConfig as Ft, DocsAgentEvaluationSurface as G, DocsSearchAmbiguityDecisionStatus as Gn, PageActionConnectMcpConfig as Gr, DocsContentChangeSnapshotLoader as Gt, DocsAgentEvaluationAnswerResult as H, DocsSearchAdapterFactory as Hn, OpenDocsTarget as Hr, DocsConfig as Ht, DocsAgentCompactConfig as I, DocsReviewScoreConfig as In, McpDocsSearchConfig as Ir, DocsCodeBlocksPlannerProvider as It, DocsAgentFeedbackContext as J, DocsSearchConfig as Jn, PageActionsConfig as Jr, DocsContentChangesResponse as Jt, DocsAgentEvaluationTaskInput as K, DocsSearchAmbiguityResolution as Kn, PageActionInstallSkillsConfig as Kr, DocsContentChangeSnapshotSaver as Kt, DocsAgentConfig as L, DocsReviewSeverity as Ln, OGConfig as Lr, DocsCodeBlocksRunnerConfig as Lt, DocsAgentA2ASecurityRequirement as M, DocsReviewCiConfig as Mn, LlmsTxtConfig as Mr, DocsCloudPreviewConfig as Mt, DocsAgentA2ASecurityScheme as N, DocsReviewCiMode as Nn, LlmsTxtMaxCharsConfig as Nr, DocsCloudPublishConfig as Nt, DocsAgentA2AOAuthImplicitFlow as O, DocsPaginatedSearchResponse as On, FeedbackConfig as Or, DocsAskAIMcpConfig as Ot, DocsAgentA2ASecurityScopeList as P, DocsReviewConfig as Pn, LlmsTxtMaxCharsMode as Pr, DocsCodeBlocksConfig as Pt, DocsAgentGoldenCoverageApplicability as Q, DocsSearchFacet as Qn, PageAgentFrontmatter as Qr, DocsFeedbackValue as Qt, DocsAgentContentChangesConfig as R, DocsRobotsConfig as Rn, OpenDocsConfig as Rr, DocsCodeBlocksRunnerProvider as Rt, DocsAgentA2AMutualTlsSecurityScheme as S, DocsOkfTrustMetadataInput as Sn, DocsTelemetryEvent as Sr, DocsAskAIActionData as St, DocsAgentA2AOAuthClientCredentialsFlow as T, DocsOpenApiMcpCredentialContext as Tn, DocsTelemetryFeatures as Tr, DocsAskAIFeedbackData as Tt, DocsAgentEvaluationAnswerRunner as U, DocsSearchAdapterPage as Un, OpenGraphImage as Ur, DocsContentChangeDocument as Ut, DocsAgentEvaluationAnswerRequest as V, DocsSearchAdapterContext as Vn, OpenDocsProviderId as Vr, DocsCodeBlocksValidationPolicy as Vt, DocsAgentEvaluationSourceReference as W, DocsSearchAmbiguityDecision as Wn, OrderingItem as Wr, DocsContentChangeSnapshotContext as Wt, DocsAgentGoldenAnswerExpectation as X, DocsSearchEmbeddingsConfig as Xn, PageAgentCommand as Xr, DocsContentSnapshotDocument as Xt, DocsAgentFeedbackData as Y, DocsSearchDocument as Yn, PageAgentAppliesTo as Yr, DocsContentSnapshot as Yt, DocsAgentGoldenAuthenticatedContentExpectation as Z, DocsSearchExplanation as Zn, PageAgentFailureMode as Zr, DocsFeedbackData as Zt, DocsAgentA2ACapabilities as _, TypographyConfig as _i, DocsOkfActorTimestamp as _n, DocsSearchWarning as _r, DocsAnalyticsEvent as _t, ApiReferenceRenderer as a, ReadingTimeFormat as ai, DocsMcpConfig as an, DocsSearchFilters as ar, DocsAgentGoldenSafetyExpectation as at, DocsAgentA2AHttpAuthSecurityScheme as b, DocsOkfStatus as bn, DocsTelemetryAgentSurface as br, DocsAnalyticsInput as bt, ChangelogConfig as c, SidebarConfig as ci, DocsMcpPromptsConfig as cn, DocsSearchQuery as cr, DocsAgentGoldenTaskFilters as ct, CopyMarkdownConfig as d, SidebarNode as di, DocsMcpToolsConfig as dn, DocsSearchRankingStrategy as dr, DocsAgentSkillsInput as dt, PageFrontmatter as ei, DocsMcpAllowedOrigins as en, DocsSearchFacetsResponse as er, DocsAgentGoldenExpectedExample as et, CopyMarkdownFormat as f, SidebarPageNode as fi, DocsMetadata as fn, DocsSearchRequest as fr, DocsAgentSkillsProgressiveDisclosureConfig as ft, DocsAgentA2AApiKeySecurityScheme as g, TypesenseDocsSearchConfig as gi, DocsObservabilityEventInput as gn, DocsSearchSourcePage as gr, DocsAnalyticsConfig as gt, DocsAccessPrincipal as h, ThemeToggleConfig as hi, DocsObservabilityEvent as hn, DocsSearchResultType as hr, DocsAgentTraceStatus as ht, ApiReferenceConfig as i, ReadingTimeConfig as ii, DocsMcpAuthenticateResult as in, DocsSearchFilterInput as ir, DocsAgentGoldenQueryVariantKind as it, DocsAgentA2AProtocolBinding as j, DocsRetrievalSourceScope as jn, LastUpdatedConfig as jr, DocsCloudFeatureConfig as jt, DocsAgentA2AOAuthPasswordFlow as k, DocsRelatedItem as kn, FontStyle as kr, DocsCloudApiKeyConfig as kt, ChangelogFrontmatter as l, SidebarFolderIndexBehavior as li, DocsMcpProtectedResourceConfig as ln, DocsSearchRankingReason as lr, DocsAgentSkillsCompatibilityPolicy as lt, DocsAccessClaimValue as m, SimpleDocsSearchConfig as mi, DocsObservabilityConfig as mn, DocsSearchResult as mr, DocsAgentTraceEventType as mt, AgentFeedbackConfig as n, PageSidebarFrontmatter as ni, DocsMcpAuthenticate as nn, DocsSearchFilterDecisionOutcome as nr, DocsAgentGoldenPromptInjectionExpectation as nt, ApiReferenceVersionConfig as o, ResolvedDocsRelatedLink as oi, DocsMcpCorsConfig as on, DocsSearchMatchField as or, DocsAgentGoldenTask as ot, CustomDocsSearchConfig as p, SidebarTree as pi, DocsNav as pn, DocsSearchResponse as pr, DocsAgentTraceEventInput as pt, DocsAgentEvaluationsConfig as q, DocsSearchChunkingConfig as qn, PageActionMcpProvider as qr, DocsContentChangedDocument as qt, AlgoliaDocsSearchConfig as r, PageTwitter as ri, DocsMcpAuthenticateContext as rn, DocsSearchFilterField as rr, DocsAgentGoldenQueryVariant as rt, BreadcrumbConfig as s, SidebarComponentProps as si, DocsMcpOriginContext as sn, DocsSearchMatchedTerm as sr, DocsAgentGoldenTaskExpectation as st, AIConfig as t, PageOpenGraph as ti, DocsMcpAuthPrincipal as tn, DocsSearchFilterDecision as tr, DocsAgentGoldenFreshnessExpectation as tt, CodeBlockCopyData as u, SidebarFolderNode as ui, DocsMcpSecurityConfig as un, DocsSearchRankingReasonCode as ur, DocsAgentSkillsConfig as ut, DocsAgentA2AConfig as v, UIConfig as vi, DocsOkfConfig as vn, DocsSearchWarningCode as vr, DocsAnalyticsEventInput as vt, DocsAgentA2AOAuthAuthorizationCodeFlow as w, DocsOpenApiMcpConfig as wn, DocsTelemetryEventType as wr, DocsAskAIFeedbackConfig as wt, DocsAgentA2AInterfaceConfig as x, DocsOkfTrustMetadata as xn, DocsTelemetryConfig as xr, DocsAnalyticsSource as xt, DocsAgentA2AExtension as y, DocsOkfSource as yn, DocsSitemapConfig as yr, DocsAnalyticsEventType as yt, DocsAgentEvaluationAnswerInput as z, DocsRobotsRule as zn, OpenDocsProvider as zr, DocsCodeBlocksValidateConfig as zt };
+export { DocsAgentGoldenAuthenticatedContentExpectation as $, DocsSearchExplanation as $n, PageAgentFailureMode as $r, DocsFeedbackData as $t, DocsAgentA2AOAuthImplicitFlow as A, DocsPaginatedSearchResponse as An, FeedbackConfig as Ar, DocsAskAIMcpConfig as At, DocsAgentContentChangesConfig as B, DocsRobotsConfig as Bn, OpenDocsConfig as Br, DocsCodeBlocksRunnerProvider as Bt, DocsAgentA2AInterfaceConfig as C, DocsOkfTrustMetadata as Cn, DocsTelemetryConfig as Cr, DocsAnalyticsSource as Ct, DocsAgentA2AOAuthClientCredentialsFlow as D, DocsOpenApiMcpCredentialContext as Dn, DocsTelemetryFeatures as Dr, DocsAskAIFeedbackData as Dt, DocsAgentA2AOAuthAuthorizationCodeFlow as E, DocsOpenApiMcpConfig as En, DocsTelemetryEventType as Er, DocsAskAIFeedbackConfig as Et, DocsAgentA2ASecurityScheme as F, DocsReviewCiMode as Fn, LlmsTxtMaxCharsConfig as Fr, DocsCloudPublishConfig as Ft, DocsAgentEvaluationAnswerRunner as G, DocsSearchAdapterPage as Gn, OpenGraphImage as Gr, DocsContentChangeDocument as Gt, DocsAgentEvaluationAnswerProvider as H, DocsSearchAdapter as Hn, OpenDocsProviderConfig as Hr, DocsCodeBlocksValidationMode as Ht, DocsAgentA2ASecurityScopeList as I, DocsReviewConfig as In, LlmsTxtMaxCharsMode as Ir, DocsCodeBlocksConfig as It, DocsAgentEvaluationTaskInput as J, DocsSearchAmbiguityResolution as Jn, PageActionInstallSkillsConfig as Jr, DocsContentChangeSnapshotSaver as Jt, DocsAgentEvaluationSourceReference as K, DocsSearchAmbiguityDecision as Kn, OrderingItem as Kr, DocsContentChangeSnapshotContext as Kt, DocsAgentA2ASkill as L, DocsReviewRulesConfig as Ln, LlmsTxtSectionConfig as Lr, DocsCodeBlocksPlannerConfig as Lt, DocsAgentA2AOpenIdConnectSecurityScheme as M, DocsRetrievalSourceProvenance as Mn, GithubConfig as Mr, DocsCloudConfig as Mt, DocsAgentA2AProtocolBinding as N, DocsRetrievalSourceScope as Nn, LastUpdatedConfig as Nr, DocsCloudFeatureConfig as Nt, DocsAgentA2AOAuthDeviceCodeFlow as O, DocsOpenApiMcpHeaders as On, DocsTelemetryFramework as Or, DocsAskAIFeedbackMessage as Ot, DocsAgentA2ASecurityRequirement as P, DocsReviewCiConfig as Pn, LlmsTxtConfig as Pr, DocsCloudPreviewConfig as Pt, DocsAgentGoldenAnswerExpectation as Q, DocsSearchEmbeddingsConfig as Qn, PageAgentCommand as Qr, DocsContentSnapshotDocument as Qt, DocsAgentCompactConfig as R, DocsReviewScoreConfig as Rn, McpDocsSearchConfig as Rr, DocsCodeBlocksPlannerProvider as Rt, DocsAgentA2AHttpAuthSecurityScheme as S, DocsOkfStatus as Sn, DocsTelemetryAgentSurface as Sr, DocsAnalyticsInput as St, DocsAgentA2AOAuth2SecurityScheme as T, DocsOkfTrustTier as Tn, DocsTelemetryEventInput as Tr, DocsAskAIActionType as Tt, DocsAgentEvaluationAnswerRequest as U, DocsSearchAdapterContext as Un, OpenDocsProviderId as Ur, DocsCodeBlocksValidationPolicy as Ut, DocsAgentEvaluationAnswerInput as V, DocsRobotsRule as Vn, OpenDocsProvider as Vr, DocsCodeBlocksValidateConfig as Vt, DocsAgentEvaluationAnswerResult as W, DocsSearchAdapterFactory as Wn, OpenDocsTarget as Wr, DocsConfig as Wt, DocsAgentFeedbackContext as X, DocsSearchConfig as Xn, PageActionsConfig as Xr, DocsContentChangesResponse as Xt, DocsAgentEvaluationsConfig as Y, DocsSearchChunkingConfig as Yn, PageActionMcpProvider as Yr, DocsContentChangedDocument as Yt, DocsAgentFeedbackData as Z, DocsSearchDocument as Zn, PageAgentAppliesTo as Zr, DocsContentSnapshot as Zt, DocsAccessPrincipal as _, ThemeToggleConfig as _i, DocsObservabilityEvent as _n, DocsSearchResultType as _r, DocsAgentTraceStatus as _t, ApiReferenceRenderer as a, PageTwitter as ai, DocsMcpAuthenticateContext as an, DocsSearchFilterField as ar, DocsAgentGoldenQueryVariant as at, DocsAgentA2AConfig as b, UIConfig as bi, DocsOkfConfig as bn, DocsSearchWarningCode as br, DocsAnalyticsEventInput as bt, ApiReferenceVersionConfig as c, ResolvedDocsRelatedLink as ci, DocsMcpCorsConfig as cn, DocsSearchMatchField as cr, DocsAgentGoldenTask as ct, ChangelogFrontmatter as d, SidebarFolderIndexBehavior as di, DocsMcpProtectedResourceConfig as dn, DocsSearchRankingReason as dr, DocsAgentSkillsCompatibilityPolicy as dt, PageAgentFrontmatter as ei, DocsFeedbackValue as en, DocsSearchFacet as er, DocsAgentGoldenCoverageApplicability as et, CodeBlockCopyData as f, SidebarFolderNode as fi, DocsMcpSecurityConfig as fn, DocsSearchRankingReasonCode as fr, DocsAgentSkillsConfig as ft, DocsAccessClaimValue as g, SimpleDocsSearchConfig as gi, DocsObservabilityConfig as gn, DocsSearchResult as gr, DocsAgentTraceEventType as gt, CustomDocsSearchConfig as h, SidebarTree as hi, DocsNav as hn, DocsSearchResponse as hr, DocsAgentTraceEventInput as ht, ApiReferenceConfig as i, PageSidebarFrontmatter as ii, DocsMcpAuthenticate as in, DocsSearchFilterDecisionOutcome as ir, DocsAgentGoldenPromptInjectionExpectation as it, DocsAgentA2AOAuthPasswordFlow as j, DocsRelatedItem as jn, FontStyle as jr, DocsCloudApiKeyConfig as jt, DocsAgentA2AOAuthFlows as k, DocsPageAccessPolicy as kn, DocsTheme as kr, DocsAskAIFeedbackValue as kt, BreadcrumbConfig as l, SidebarComponentProps as li, DocsMcpOriginContext as ln, DocsSearchMatchedTerm as lr, DocsAgentGoldenTaskExpectation as lt, CopyMarkdownFormat as m, SidebarPageNode as mi, DocsMetadata as mn, DocsSearchRequest as mr, DocsAgentSkillsProgressiveDisclosureConfig as mt, AgentFeedbackConfig as n, PageFrontmatter as ni, DocsMcpAllowedOrigins as nn, DocsSearchFacetsResponse as nr, DocsAgentGoldenExpectedExample as nt, ApiReferenceRendererConfig as o, ReadingTimeConfig as oi, DocsMcpAuthenticateResult as on, DocsSearchFilterInput as or, DocsAgentGoldenQueryVariantKind as ot, CopyMarkdownConfig as p, SidebarNode as pi, DocsMcpToolsConfig as pn, DocsSearchRankingStrategy as pr, DocsAgentSkillsInput as pt, DocsAgentEvaluationSurface as q, DocsSearchAmbiguityDecisionStatus as qn, PageActionConnectMcpConfig as qr, DocsContentChangeSnapshotLoader as qt, AlgoliaDocsSearchConfig as r, PageOpenGraph as ri, DocsMcpAuthPrincipal as rn, DocsSearchFilterDecision as rr, DocsAgentGoldenFreshnessExpectation as rt, ApiReferenceRendererInput as s, ReadingTimeFormat as si, DocsMcpConfig as sn, DocsSearchFilters as sr, DocsAgentGoldenSafetyExpectation as st, AIConfig as t, PageAgentVerification as ti, DocsI18nConfig as tn, DocsSearchFacetValue as tr, DocsAgentGoldenExampleVerification as tt, ChangelogConfig as u, SidebarConfig as ui, DocsMcpPromptsConfig as un, DocsSearchQuery as ur, DocsAgentGoldenTaskFilters as ut, DocsAgentA2AApiKeySecurityScheme as v, TypesenseDocsSearchConfig as vi, DocsObservabilityEventInput as vn, DocsSearchSourcePage as vr, DocsAnalyticsConfig as vt, DocsAgentA2AMutualTlsSecurityScheme as w, DocsOkfTrustMetadataInput as wn, DocsTelemetryEvent as wr, DocsAskAIActionData as wt, DocsAgentA2AExtension as x, DocsOkfSource as xn, DocsSitemapConfig as xr, DocsAnalyticsEventType as xt, DocsAgentA2ACapabilities as y, TypographyConfig as yi, DocsOkfActorTimestamp as yn, DocsSearchWarning as yr, DocsAnalyticsEvent as yt, DocsAgentConfig as z, DocsReviewSeverity as zn, OGConfig as zr, DocsCodeBlocksRunnerConfig as zt };

package/dist/{upgrade-CXIQlLWx.mjs → upgrade-DlQMOFV1.mjs}

@@ -1,5 +1,5 @@
-import { c as fileExists, o as exec } from "./utils-8H7dkC8w.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-CiVXOONu.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.118",
+  "version": "0.2.120",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",
@@ -106,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-P69ZKRec.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-CAncgoWu.d.mts

@@ -1,15 +0,0 @@
-import { ci as SidebarConfig, li as SidebarFolderIndexBehavior } from "./types-Ba9Dd_fe.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 };

package/dist/sidebar-mI70dH_0.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 };