@farming-labs/docs 0.2.118 → 0.2.119

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.
Files changed (84) hide show
  1. package/dist/{agent-DAjdIdoL.mjs → agent-CYk2DxY7.mjs} +3 -3
  2. package/dist/{agent-BErhm-eR.mjs → agent-DkAidqtV.mjs} +9 -3
  3. package/dist/{agent-evals-BHXe_A2m.mjs → agent-evals-BLNLvXbG.mjs} +3 -3
  4. package/dist/{agent-export-B849tzbg.mjs → agent-export-Cxljt6RP.mjs} +16 -15
  5. package/dist/agent-skills-bundle.d.mts +1 -1
  6. package/dist/{agent-skills-progressive-disclosure-1XPV0wCN.mjs → agent-skills-progressive-disclosure-PjPtTYL-.mjs} +1 -1
  7. package/dist/{agent-skills-server-CJh3EGWC.mjs → agent-skills-server-BC7md56k.mjs} +1 -1
  8. package/dist/{agent-skills-server-DiXUcYNy.d.mts → agent-skills-server-CTNWr23x.d.mts} +2 -2
  9. package/dist/agent-skills-vite.d.mts +3 -3
  10. package/dist/agent-skills-vite.mjs +2 -2
  11. package/dist/{agents-Dwys0Wr7.mjs → agents-jtn256sz.mjs} +14 -13
  12. package/dist/{analytics-BvUjK_oC.d.mts → analytics-B8RZiKUt.d.mts} +1 -1
  13. package/dist/{api-reference-DafuHRtc.mjs → api-reference-By_LokQ-.mjs} +2 -2
  14. package/dist/{authoring-BqcSw2Ok.mjs → authoring-C2ymvYWl.mjs} +6 -5
  15. package/dist/{authoring-mcp-BmohXL7E.mjs → authoring-mcp-CiCUQe3o.mjs} +2 -2
  16. package/dist/browser.d.mts +4 -4
  17. package/dist/browser.mjs +6 -3
  18. package/dist/cli/index.mjs +38 -38
  19. package/dist/client/react.d.mts +1 -1
  20. package/dist/{cloud-BllEwBht.mjs → cloud-6eKrlmKd.mjs} +3 -3
  21. package/dist/{cloud-ask-ai-nlKU13he.d.mts → cloud-ask-ai-BOahlsIZ.d.mts} +1 -1
  22. package/dist/{codeblocks-Cbo7uzxr.mjs → codeblocks-CHpgAwY-.mjs} +2 -2
  23. package/dist/{content-change-hydration-Cr07LmBu.d.mts → content-change-hydration-CvHJadhE.d.mts} +3 -3
  24. package/dist/{dev-QxIXdG0G.mjs → dev-Bnn-NUNa.mjs} +2 -2
  25. package/dist/docs-cloud-server.d.mts +2 -2
  26. package/dist/docs-cloud-server.mjs +1 -1
  27. package/dist/{doctor-Cysov9LX.mjs → doctor-CUMgbglt.mjs} +21 -20
  28. package/dist/{downgrade-Cx3FnovE.mjs → downgrade-CHMta85e.mjs} +2 -2
  29. package/dist/{feedback-Dfgt_WD5.mjs → feedback-DL4T5oIO.mjs} +1 -1
  30. package/dist/{feedback-evals-DI_JNN5M.mjs → feedback-evals-DMilg9pY.mjs} +1 -1
  31. package/dist/{golden-evaluations-BqdWUUE7.mjs → golden-evaluations-CLUViycJ.mjs} +2 -2
  32. package/dist/index.d.mts +9 -44
  33. package/dist/index.mjs +11 -12
  34. package/dist/{init-CW922o9v.mjs → init-K0LmXDZ5.mjs} +3 -3
  35. package/dist/{mcp-CqtJYU0Y.mjs → mcp-Bvha6_mG.mjs} +15 -14
  36. package/dist/mcp.d.mts +3 -3
  37. package/dist/mcp.mjs +5 -5
  38. package/dist/{openapi-diff-Cf1dguBv.mjs → openapi-diff-BOESBfnP.mjs} +5 -5
  39. package/dist/{openapi-mcp-gbEUXMkc.mjs → openapi-mcp-BIOTLiA7.mjs} +3 -315
  40. package/dist/{openapi-sdk-G7RtjWc5.mjs → openapi-sdk-DJutz2AC.mjs} +5 -5
  41. package/dist/{openapi-source-1ubEyHMO.mjs → openapi-source-CiX3hwFp.mjs} +1 -1
  42. package/dist/{package-version-CiVXOONu.mjs → package-version-HJhYeq4M.mjs} +1 -1
  43. package/dist/{prompt-references-C1nDPYdm.mjs → prompt-references-DMgbu_dz.mjs} +3 -3
  44. package/dist/{propose-B_yerUFm.mjs → propose-JmUv_BTt.mjs} +1 -1
  45. package/dist/{retrieval-digest-ueYW3S6P.d.mts → retrieval-digest-DLAQsQmx.d.mts} +1 -1
  46. package/dist/{review-Df62iFE4.mjs → review-C6EmbV0l.mjs} +12 -11
  47. package/dist/{robots-CRIXPOiX.mjs → robots-BYJAVeI6.mjs} +2 -2
  48. package/dist/{robots-vdQ4tLzZ.mjs → robots-DteZB8vl.mjs} +5 -5
  49. package/dist/runtime.d.mts +3 -3
  50. package/dist/runtime.mjs +7 -6
  51. package/dist/{search-Cso57KVB.mjs → search-DKcdZgGx.mjs} +16 -15
  52. package/dist/server.d.mts +8 -8
  53. package/dist/server.mjs +14 -13
  54. package/dist/sidebar-C2LKcU7n.d.mts +63 -0
  55. package/dist/sidebar-CFHBj29f.mjs +421 -0
  56. package/dist/{sitemap-Du2wWBmo.mjs → sitemap-CBQoERNz.mjs} +14 -13
  57. package/dist/{sitemap-BEUEeKbt.d.mts → sitemap-DafdOrxK.d.mts} +2 -2
  58. package/dist/{sitemap-server-DNsVKCnP.d.mts → sitemap-server-C9r22_06.d.mts} +2 -2
  59. package/dist/{sitemap-server-CClBRp7_.mjs → sitemap-server-Lg3YhUx4.mjs} +1 -1
  60. package/dist/{skills-BC0GTdUM.mjs → skills-a90P31sJ.mjs} +14 -13
  61. package/dist/{standards-discovery-C3AB6qNv.d.mts → standards-discovery-1fiUVDAo.d.mts} +1 -1
  62. package/dist/{types-Ba9Dd_fe.d.mts → types-BncG8J3g.d.mts} +1 -1
  63. package/dist/{upgrade-CXIQlLWx.mjs → upgrade-DlQMOFV1.mjs} +2 -2
  64. package/package.json +2 -2
  65. package/dist/audience-exposure-P69ZKRec.mjs +0 -8
  66. package/dist/sidebar-CAncgoWu.d.mts +0 -15
  67. package/dist/sidebar-mI70dH_0.mjs +0 -73
  68. /package/dist/{agent-feedback-evaluations-UhAdMoIY.mjs → agent-feedback-evaluations-CcMGlgsO.mjs} +0 -0
  69. /package/dist/{agent-feedback-loop-DpZ9ZdFB.mjs → agent-feedback-loop-CcZL_sb1.mjs} +0 -0
  70. /package/dist/{agent-maintenance-CZLly8It.mjs → agent-maintenance-CuZ7iAKq.mjs} +0 -0
  71. /package/dist/{audience-exposure-PMCEve-s.d.mts → audience-exposure-DBrFWULA.d.mts} +0 -0
  72. /package/dist/{cloud-ask-ai-Bq_njfjh.mjs → cloud-ask-ai-BqKhjpS5.mjs} +0 -0
  73. /package/dist/{code-blocks-BE3sEayp.mjs → code-blocks-GYdvS3BH.mjs} +0 -0
  74. /package/dist/{config-DDuQ4Qma.mjs → config-BZnKAj_Y.mjs} +0 -0
  75. /package/dist/{errors-CBmy95z2.mjs → errors-BtnVLhNF.mjs} +0 -0
  76. /package/dist/{i18n-DKGg_G0f.mjs → i18n-B1gJ9EW0.mjs} +0 -0
  77. /package/dist/{metadata-DoUinS1I.mjs → metadata-BOHn0Y5K.mjs} +0 -0
  78. /package/dist/{openapi-BkQGpZEg.mjs → openapi-CfCzX_a1.mjs} +0 -0
  79. /package/dist/{openapi-mcp-node-DiqMH9Ao.mjs → openapi-mcp-node-C4jUpZG6.mjs} +0 -0
  80. /package/dist/{openapi-operations-CsXLUD3Z.mjs → openapi-operations-DFpaqOqA.mjs} +0 -0
  81. /package/dist/{prompt-utils-Dj8-I3Jw.mjs → prompt-utils-B5g-bv7o.mjs} +0 -0
  82. /package/dist/{standards-discovery-BQQ3CAzz.mjs → standards-discovery-sSEojU80.mjs} +0 -0
  83. /package/dist/{templates-2nnlhcmo.mjs → templates-BuQ8YsGv.mjs} +0 -0
  84. /package/dist/{utils-8H7dkC8w.mjs → utils-C7KDrPpA.mjs} +0 -0
@@ -1,5 +1,5 @@
1
- import { oi as ResolvedDocsRelatedLink, yr as DocsSitemapConfig } from "./types-Ba9Dd_fe.mjs";
2
- import { R as DocsDiscoveryApiRouteOptions } from "./standards-discovery-C3AB6qNv.mjs";
1
+ import { oi as ResolvedDocsRelatedLink, yr as DocsSitemapConfig } from "./types-BncG8J3g.mjs";
2
+ import { R as DocsDiscoveryApiRouteOptions } from "./standards-discovery-1fiUVDAo.mjs";
3
3
 
4
4
  //#region src/sitemap.d.ts
5
5
  declare const DEFAULT_SITEMAP_XML_ROUTE = "/sitemap.xml";
@@ -1,5 +1,5 @@
1
- import { Ht as DocsConfig, a as ApiReferenceRenderer, gr as DocsSearchSourcePage, vn as DocsOkfConfig, wn as DocsOpenApiMcpConfig, yr as DocsSitemapConfig } from "./types-Ba9Dd_fe.mjs";
2
- import { s as DocsSitemapManifest } from "./sitemap-BEUEeKbt.mjs";
1
+ import { Ht as DocsConfig, a as ApiReferenceRenderer, gr as DocsSearchSourcePage, vn as DocsOkfConfig, wn as DocsOpenApiMcpConfig, yr as DocsSitemapConfig } from "./types-BncG8J3g.mjs";
2
+ import { s as DocsSitemapManifest } from "./sitemap-DafdOrxK.mjs";
3
3
 
4
4
  //#region src/api-reference.d.ts
5
5
  type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD";
@@ -1,4 +1,4 @@
1
- import { Rt as resolveDocsSitemapConfig } from "./agent-BErhm-eR.mjs";
1
+ import { Rt as resolveDocsSitemapConfig } from "./agent-DkAidqtV.mjs";
2
2
  import { existsSync, readFileSync } from "node:fs";
3
3
  import path from "node:path";
4
4
 
@@ -1,21 +1,22 @@
1
1
  import "./http-body-DkAPk6D5.mjs";
2
2
  import { _ as hasStructuredPageAgentContract, v as normalizePageAgentFrontmatter } from "./markdown-sections-9Oxr33b-.mjs";
3
- import "./agent-BErhm-eR.mjs";
4
- import "./standards-discovery-BQQ3CAzz.mjs";
3
+ import "./agent-DkAidqtV.mjs";
4
+ import "./standards-discovery-sSEojU80.mjs";
5
5
  import { isDocsAgentSkillName, validateDocsAgentSkillFrontmatter } from "./agent-skills-spec.mjs";
6
- import "./openapi-mcp-gbEUXMkc.mjs";
7
- import "./prompt-utils-Dj8-I3Jw.mjs";
8
- import "./api-reference-DafuHRtc.mjs";
9
- import "./agent-skills-server-CJh3EGWC.mjs";
10
- import "./agent-evals-BHXe_A2m.mjs";
6
+ import "./sidebar-CFHBj29f.mjs";
7
+ import "./openapi-mcp-BIOTLiA7.mjs";
8
+ import "./prompt-utils-B5g-bv7o.mjs";
9
+ import "./api-reference-By_LokQ-.mjs";
10
+ import "./agent-skills-server-BC7md56k.mjs";
11
+ import "./agent-evals-BLNLvXbG.mjs";
11
12
  import { createFilesystemDocsMcpSource } from "./mcp.mjs";
12
- import "./authoring-mcp-BmohXL7E.mjs";
13
- import "./cloud-ask-ai-Bq_njfjh.mjs";
14
- import "./code-blocks-BE3sEayp.mjs";
15
- import "./sitemap-server-CClBRp7_.mjs";
13
+ import "./authoring-mcp-CiCUQe3o.mjs";
14
+ import "./cloud-ask-ai-BqKhjpS5.mjs";
15
+ import "./code-blocks-GYdvS3BH.mjs";
16
+ import "./sitemap-server-Lg3YhUx4.mjs";
16
17
  import "./server.mjs";
17
- 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";
18
- import { n as estimateAgentSkillInstructionTokens, r as resolveDocsAgentSkillsProgressiveDisclosureConfig } from "./agent-skills-progressive-disclosure-1XPV0wCN.mjs";
18
+ 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";
19
+ import { n as estimateAgentSkillInstructionTokens, r as resolveDocsAgentSkillsProgressiveDisclosureConfig } from "./agent-skills-progressive-disclosure-PjPtTYL-.mjs";
19
20
  import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
20
21
  import path from "node:path";
21
22
  import { createHash } from "node:crypto";
@@ -1,4 +1,4 @@
1
- import { F as DocsAgentA2ASkill, M as DocsAgentA2ASecurityRequirement, N as DocsAgentA2ASecurityScheme, _ as DocsAgentA2ACapabilities, j as DocsAgentA2AProtocolBinding, v as DocsAgentA2AConfig } from "./types-Ba9Dd_fe.mjs";
1
+ import { F as DocsAgentA2ASkill, M as DocsAgentA2ASecurityRequirement, N as DocsAgentA2ASecurityScheme, _ as DocsAgentA2ACapabilities, j as DocsAgentA2AProtocolBinding, v as DocsAgentA2AConfig } from "./types-BncG8J3g.mjs";
2
2
 
3
3
  //#region src/standards-discovery.d.ts
4
4
  declare const DEFAULT_API_CATALOG_ROUTE = "/.well-known/api-catalog";
@@ -904,7 +904,7 @@ interface DocsAnalyticsConfig {
904
904
  cloud?: boolean;
905
905
  }
906
906
  type DocsTelemetryFramework = "next" | "tanstack-start" | "farmjs" | "sveltekit" | "astro" | "nuxt" | "mcp" | (string & {});
907
- type DocsTelemetryEventType = "project_detected" | "agent_surface_used" | "mcp_request" | "mcp_tool_used" | (string & {});
907
+ type DocsTelemetryEventType = "project_detected" | "page_view" | "agent_surface_used" | "mcp_request" | "mcp_tool_used" | (string & {});
908
908
  type DocsTelemetryAgentSurface = "agent_spec" | "agents" | "skill" | "markdown" | "llms" | "agent_feedback_schema" | "agent_feedback_submit" | "content_changes" | "ask_ai" | "mcp";
909
909
  interface DocsTelemetryConfig {
910
910
  /** Enable Farming Labs maintainer telemetry. Defaults to production-only enabled. */
@@ -1,5 +1,5 @@
1
- import { c as fileExists, o as exec } from "./utils-8H7dkC8w.mjs";
2
- 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";
1
+ import { c as fileExists, o as exec } from "./utils-C7KDrPpA.mjs";
2
+ 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";
3
3
  import path from "node:path";
4
4
  import pc from "picocolors";
5
5
  import * as p from "@clack/prompts";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@farming-labs/docs",
3
- "version": "0.2.118",
3
+ "version": "0.2.119",
4
4
  "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
5
5
  "keywords": [
6
6
  "docs",
@@ -106,7 +106,7 @@
106
106
  }
107
107
  },
108
108
  "devDependencies": {
109
- "@modelcontextprotocol/client": "2.0.0",
109
+ "@modelcontextprotocol/client": "2.2.0",
110
110
  "@types/node": "^22.10.0",
111
111
  "@types/react": "^19.2.2",
112
112
  "ajv": "^8.18.0",
@@ -1,8 +0,0 @@
1
- //#region src/audience-exposure.ts
2
- /** Resolve whether content with an optional audience restriction is visible. */
3
- function resolveDocsAudienceExposure(only, audience) {
4
- return only !== "human" && only !== "agent" || only === audience;
5
- }
6
-
7
- //#endregion
8
- export { resolveDocsAudienceExposure as t };
@@ -1,15 +0,0 @@
1
- import { ci as SidebarConfig, li as SidebarFolderIndexBehavior } from "./types-Ba9Dd_fe.mjs";
2
-
3
- //#region src/sidebar.d.ts
4
- interface SidebarFolderIndexBehaviorOptions {
5
- sidebar: boolean | SidebarConfig | undefined;
6
- defaultBehavior?: SidebarFolderIndexBehavior;
7
- }
8
- declare function resolvePageSidebarFolderIndexBehavior(sidebar: unknown): SidebarFolderIndexBehavior | undefined;
9
- declare function resolveSidebarFolderIndexBehavior(sidebar: boolean | SidebarConfig | undefined, defaultBehavior?: SidebarFolderIndexBehavior): SidebarFolderIndexBehavior;
10
- declare function resolveSidebarFolderIndexBehaviorForPath(sidebar: boolean | SidebarConfig | undefined, folderPath: string | undefined, defaultBehavior?: SidebarFolderIndexBehavior): SidebarFolderIndexBehavior;
11
- declare function applySidebarFolderIndexBehavior<TTree extends {
12
- children: unknown[];
13
- }>(tree: TTree, behaviorOrOptions: SidebarFolderIndexBehavior | SidebarFolderIndexBehaviorOptions): TTree;
14
- //#endregion
15
- export { resolveSidebarFolderIndexBehaviorForPath as i, resolvePageSidebarFolderIndexBehavior as n, resolveSidebarFolderIndexBehavior as r, applySidebarFolderIndexBehavior as t };
@@ -1,73 +0,0 @@
1
- //#region src/sidebar.ts
2
- function resolvePageSidebarFolderIndexBehavior(sidebar) {
3
- if (!sidebar || typeof sidebar !== "object") return void 0;
4
- const value = sidebar.folderIndexBehavior;
5
- return value === "link" || value === "toggle" || value === "hidden" ? value : void 0;
6
- }
7
- function normalizeSidebarFolderBehaviorPath(path) {
8
- if (!path) return void 0;
9
- let value = path.trim();
10
- if (!value) return void 0;
11
- if (/^[a-zA-Z][a-zA-Z\d+\-.]*:\/\//.test(value)) try {
12
- value = new URL(value).pathname;
13
- } catch {
14
- return;
15
- }
16
- else value = value.split("#", 1)[0]?.split("?", 1)[0] ?? value;
17
- if (!value.startsWith("/")) value = `/${value}`;
18
- return value.replace(/\/$/, "") || "/";
19
- }
20
- function resolveSidebarFolderIndexBehavior(sidebar, defaultBehavior = "link") {
21
- if (sidebar === void 0 || sidebar === true || sidebar === false) return defaultBehavior;
22
- if (sidebar.folderIndexBehavior === "toggle") return "toggle";
23
- if (sidebar.folderIndexBehavior === "hidden") return "hidden";
24
- if (sidebar.folderIndexBehavior === "link") return "link";
25
- return defaultBehavior;
26
- }
27
- function resolveSidebarFolderIndexBehaviorForPath(sidebar, folderPath, defaultBehavior = "link") {
28
- const fallback = resolveSidebarFolderIndexBehavior(sidebar, defaultBehavior);
29
- if (!sidebar || typeof sidebar !== "object") return fallback;
30
- const normalizedPath = normalizeSidebarFolderBehaviorPath(folderPath);
31
- if (!normalizedPath) return fallback;
32
- for (const [rawPath, override] of Object.entries(sidebar.folderIndexBehaviorOverrides ?? {})) if (normalizeSidebarFolderBehaviorPath(rawPath) === normalizedPath) return override === "link" || override === "toggle" || override === "hidden" ? override : fallback;
33
- return fallback;
34
- }
35
- function applySidebarFolderIndexBehavior(tree, behaviorOrOptions) {
36
- const resolveBehavior = typeof behaviorOrOptions === "string" ? () => behaviorOrOptions : (folderPath) => resolveSidebarFolderIndexBehaviorForPath(behaviorOrOptions.sidebar, folderPath, behaviorOrOptions.defaultBehavior);
37
- function mapNode(node) {
38
- if (!node || typeof node !== "object") return node;
39
- const candidate = node;
40
- if (candidate.type !== "folder" || !Array.isArray(candidate.children)) return node;
41
- const children = candidate.children.map(mapNode);
42
- const index = candidate.index ? mapNode(candidate.index) : void 0;
43
- 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);
44
- const behavior = (candidate.folderIndexBehavior === "link" || candidate.folderIndexBehavior === "toggle" || candidate.folderIndexBehavior === "hidden" ? candidate.folderIndexBehavior : void 0) ?? resolveBehavior(folderPath);
45
- if (behavior === "link") return {
46
- ...candidate,
47
- folderIndexBehavior: void 0,
48
- index,
49
- children
50
- };
51
- if (behavior === "hidden") return {
52
- ...candidate,
53
- folderIndexBehavior: void 0,
54
- index: void 0,
55
- url: void 0,
56
- children
57
- };
58
- return {
59
- ...candidate,
60
- folderIndexBehavior: void 0,
61
- index: void 0,
62
- url: void 0,
63
- children: index ? [index, ...children] : children
64
- };
65
- }
66
- return {
67
- ...tree,
68
- children: tree.children.map(mapNode)
69
- };
70
- }
71
-
72
- //#endregion
73
- export { resolveSidebarFolderIndexBehaviorForPath as i, resolvePageSidebarFolderIndexBehavior as n, resolveSidebarFolderIndexBehavior as r, applySidebarFolderIndexBehavior as t };
File without changes
File without changes