@farming-labs/docs 0.2.120 → 0.2.122

package/dist/prompt-references.mjs

@@ -0,0 +1,132 @@
+//#region src/prompt-references.ts
+function isDocsMarkdownPromptNode(node) {
+	return (node.type === "mdxJsxFlowElement" || node.type === "mdxJsxTextElement") && node.name === "Prompt";
+}
+function normalizeDocsMarkdownReferenceIdentifier(value) {
+	return typeof value === "string" ? value.trim().replace(/\s+/gu, " ").toLowerCase() : "";
+}
+function readDocsMarkdownPromptReferenceSource(value) {
+	const source = typeof value === "string" ? value : value instanceof Uint8Array ? new TextDecoder().decode(value) : void 0;
+	if (source === void 0) return void 0;
+	return source.startsWith("") ? source.slice(1) : source;
+}
+function sliceDocsMarkdownPromptReferenceSource(node, source) {
+	if (source === void 0) return void 0;
+	const start = node.position?.start?.offset;
+	const end = node.position?.end?.offset;
+	if (typeof start !== "number" || typeof end !== "number" || !Number.isInteger(start) || !Number.isInteger(end) || start < 0 || end < start || end > source.length) return;
+	return source.slice(start, end);
+}
+function sliceDocsMarkdownPromptChildrenSource(node, source) {
+	const nodeSource = sliceDocsMarkdownPromptReferenceSource(node, source);
+	if (nodeSource === void 0) return void 0;
+	const closingStart = nodeSource.lastIndexOf("</Prompt");
+	if (closingStart < 0) return void 0;
+	const children = node.children ?? [];
+	const isolatedChild = children.length === 1 ? children[0] : void 0;
+	if (isolatedChild?.type === "text" && typeof isolatedChild.value === "string" && isolatedChild.position === void 0) return isolatedChild.value;
+	const nodeStart = node.position?.start?.offset;
+	if (typeof nodeStart !== "number") return void 0;
+	let firstChildStart;
+	for (const child of children) {
+		const childStart = child.position?.start?.offset;
+		if (typeof childStart === "number" && Number.isInteger(childStart) && childStart >= nodeStart && (firstChildStart === void 0 || childStart - nodeStart < firstChildStart)) firstChildStart = childStart - nodeStart;
+	}
+	if (children.length > 0 && firstChildStart === void 0) return void 0;
+	const openingEnd = nodeSource.lastIndexOf(">", (firstChildStart ?? closingStart) - 1);
+	if (openingEnd < 0 || openingEnd >= closingStart) return void 0;
+	return nodeSource.slice(openingEnd + 1, closingStart);
+}
+function flattenDocsMarkdownPromptReferenceNode(node) {
+	if (typeof node.value === "string") return node.value;
+	return (node.children ?? []).map((child) => flattenDocsMarkdownPromptReferenceNode(child)).join("");
+}
+function formatDocsMarkdownPromptReference(node) {
+	const image = node.type === "imageReference";
+	const visibleLabel = image ? typeof node.alt === "string" ? node.alt : "" : flattenDocsMarkdownPromptReferenceNode(node);
+	const referenceLabel = typeof node.label === "string" ? node.label : typeof node.identifier === "string" ? node.identifier : visibleLabel;
+	const prefix = image ? "!" : "";
+	if (node.referenceType === "collapsed") return `${prefix}[${visibleLabel}][]`;
+	if (node.referenceType === "shortcut") return `${prefix}[${visibleLabel}]`;
+	return `${prefix}[${visibleLabel}][${referenceLabel}]`;
+}
+function formatDocsMarkdownPromptDefinition(node) {
+	const label = typeof node.label === "string" ? node.label : typeof node.identifier === "string" ? node.identifier : "";
+	const rawUrl = typeof node.url === "string" ? node.url : "";
+	return `[${label}]: ${/[<>\s]/u.test(rawUrl) ? `<${rawUrl.replace(/>/gu, "\\>")}>` : rawUrl}${typeof node.title === "string" ? ` "${node.title.replace(/"/gu, "\\\"")}"` : ""}`;
+}
+function createDocsMarkdownPromptReferenceText(node, source) {
+	return {
+		type: "text",
+		value: sliceDocsMarkdownPromptReferenceSource(node, source) ?? formatDocsMarkdownPromptReference(node),
+		position: node.position
+	};
+}
+function createDocsMarkdownPromptDefinitionParagraph(node, source) {
+	return {
+		type: "paragraph",
+		children: [{
+			type: "text",
+			value: sliceDocsMarkdownPromptReferenceSource(node, source) ?? formatDocsMarkdownPromptDefinition(node),
+			position: node.position
+		}],
+		position: node.position
+	};
+}
+/**
+* Keep `<Prompt>` children literal before Markdown reference definitions are
+* resolved by the MDX compiler.
+*
+* Definitions inside Prompt are copyable source, not page-level definitions.
+* References inside Prompt always remain source text, while references outside
+* Prompt only remain live when they have a definition outside Prompt.
+*/
+function isolateDocsMarkdownPromptReferences(root, value) {
+	if (!root || typeof root !== "object") return;
+	const source = readDocsMarkdownPromptReferenceSource(value);
+	const promptDefinitions = /* @__PURE__ */ new Set();
+	const pageDefinitions = /* @__PURE__ */ new Set();
+	let hasPrompt = false;
+	const collectDefinitions = (node, insidePrompt) => {
+		const prompt = isDocsMarkdownPromptNode(node);
+		const literal = insidePrompt || prompt;
+		if (prompt) hasPrompt = true;
+		if (node.type === "definition") {
+			const identifier = normalizeDocsMarkdownReferenceIdentifier(node.identifier);
+			if (identifier) (literal ? promptDefinitions : pageDefinitions).add(identifier);
+		}
+		for (const child of node.children ?? []) collectDefinitions(child, literal);
+	};
+	collectDefinitions(root, false);
+	if (!hasPrompt) return;
+	const isolateReferences = (node, insidePrompt) => {
+		const prompt = isDocsMarkdownPromptNode(node);
+		if (prompt) {
+			const promptSource = sliceDocsMarkdownPromptChildrenSource(node, source);
+			if (promptSource !== void 0) {
+				node.children = [{
+					type: "text",
+					value: promptSource
+				}];
+				return;
+			}
+		}
+		const literal = insidePrompt || prompt;
+		const children = node.children;
+		if (!children) return;
+		node.children = children.map((child) => {
+			const childInsidePrompt = literal || isDocsMarkdownPromptNode(child);
+			if (childInsidePrompt && child.type === "definition") return createDocsMarkdownPromptDefinitionParagraph(child, source);
+			if (child.type === "linkReference" || child.type === "imageReference") {
+				const identifier = normalizeDocsMarkdownReferenceIdentifier(child.identifier);
+				if (childInsidePrompt || promptDefinitions.has(identifier) && !pageDefinitions.has(identifier)) return createDocsMarkdownPromptReferenceText(child, source);
+			}
+			isolateReferences(child, childInsidePrompt);
+			return child;
+		});
+	};
+	isolateReferences(root, false);
+}
+
+//#endregion
+export { isolateDocsMarkdownPromptReferences };

package/dist/prompt-utils.d.mts

@@ -0,0 +1,36 @@
+import { OpenDocsProvider, OpenDocsTarget } from "./types.mjs";
+
+//#region src/prompt-utils.d.ts
+type PromptAction = "copy" | "open";
+interface SerializedOpenDocsProvider {
+  name: string;
+  iconHtml?: string;
+  urlTemplate: string;
+  promptUrlTemplate?: string;
+  target?: OpenDocsTarget;
+  prompt?: string;
+}
+interface PromptProviderChoice {
+  name: string;
+  iconHtml?: string;
+  urlTemplate: string;
+}
+type PromptProviderInput = Pick<SerializedOpenDocsProvider, "name" | "iconHtml"> & Partial<Pick<SerializedOpenDocsProvider, "promptUrlTemplate" | "urlTemplate">>;
+interface SerializeOpenDocsProviderOptions {
+  target?: OpenDocsTarget;
+  prompt?: string;
+}
+declare const DEFAULT_PROMPT_PROVIDER_TEMPLATES: Record<string, string>;
+declare const DEFAULT_OPEN_DOCS_TARGET: OpenDocsTarget;
+declare const DEFAULT_OPEN_DOCS_PROMPT = "Read this documentation: {url}";
+declare const DEFAULT_OPEN_DOCS_PROVIDER_IDS: readonly ["chatgpt", "claude"];
+declare function normalizePromptProviderName(name: string): string;
+declare function serializeDocsIcon(icon: unknown): string | undefined;
+declare function serializeDocsIconRegistry(icons?: Record<string, unknown>): Record<string, string> | undefined;
+declare function serializeOpenDocsProviders(providers?: OpenDocsProvider[], options?: SerializeOpenDocsProviderOptions): SerializedOpenDocsProvider[] | undefined;
+declare function serializeOpenDocsProvider(provider: OpenDocsProvider, options?: SerializeOpenDocsProviderOptions): SerializedOpenDocsProvider | undefined;
+declare function parsePromptStringArray(value: unknown): string[] | undefined;
+declare function resolvePromptProviderChoices(availableProviders?: PromptProviderInput[], preferredNames?: string[]): PromptProviderChoice[];
+declare function sanitizePromptText(text: string): string;
+//#endregion
+export { DEFAULT_OPEN_DOCS_PROMPT, DEFAULT_OPEN_DOCS_PROVIDER_IDS, DEFAULT_OPEN_DOCS_TARGET, DEFAULT_PROMPT_PROVIDER_TEMPLATES, PromptAction, PromptProviderChoice, SerializeOpenDocsProviderOptions, SerializedOpenDocsProvider, normalizePromptProviderName, parsePromptStringArray, resolvePromptProviderChoices, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProvider, serializeOpenDocsProviders };

package/dist/{prompt-utils-B5g-bv7o.mjs → prompt-utils.mjs}

@@ -1,61 +1,5 @@
 import { createRequire } from "node:module";
 
-//#region src/code-group-mdx.ts
-const codeGroupTitleAttributes = [
-	"title",
-	"filename",
-	"file",
-	"name",
-	"label"
-];
-const ignoredBareMetaTokens = new Set([
-	"copy",
-	"no-copy",
-	"nocopy",
-	"line-numbers",
-	"linenumbers",
-	"runnable",
-	"show-line-numbers",
-	"showlinenumbers",
-	"wrap"
-]);
-function escapeMetaAttribute(value) {
-	return value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
-}
-function readCodeGroupTitleAttribute(meta) {
-	for (const name of codeGroupTitleAttributes) {
-		const match = meta.match(new RegExp(`(?:^|\\s)${name}=["']([^"']+)["']`));
-		if (match?.[1]?.trim()) return match[1].trim();
-	}
-}
-function readBareCodeGroupTitle(meta) {
-	return meta.replace(/\{[^}]*\}/g, " ").split(/\s+/).find((part) => part && !part.includes("=") && !ignoredBareMetaTokens.has(part.toLowerCase()))?.replace(/^["']|["']$/g, "");
-}
-function resolveCodeGroupCodeTitle(meta) {
-	const trimmed = meta?.trim();
-	if (!trimmed) return void 0;
-	return readCodeGroupTitleAttribute(trimmed) ?? readBareCodeGroupTitle(trimmed);
-}
-function ensureCodeGroupCodeTitle(node) {
-	const title = resolveCodeGroupCodeTitle(node.meta);
-	if (!title) return;
-	const meta = node.meta?.trim() ?? "";
-	if (/(?:^|\s)title=["']/.test(meta)) return;
-	node.meta = `title="${escapeMetaAttribute(title)}"${meta ? ` ${meta}` : ""}`;
-}
-function visitCodeGroups(node) {
-	if (node.type === "mdxJsxFlowElement" && node.name === "CodeGroup") {
-		for (const child of node.children ?? []) if (child.type === "code") ensureCodeGroupCodeTitle(child);
-	}
-	for (const child of node.children ?? []) visitCodeGroups(child);
-}
-function remarkCodeGroup() {
-	return (tree) => {
-		visitCodeGroups(tree);
-	};
-}
-
-//#endregion
 //#region src/prompt-utils.ts
 const DEFAULT_PROMPT_PROVIDER_TEMPLATES = {
 	chatgpt: "https://chatgpt.com/?q={prompt}",
@@ -216,4 +160,4 @@ function sanitizePromptText(text) {
 }
 
 //#endregion
-export { normalizePromptProviderName as a, sanitizePromptText as c, serializeOpenDocsProvider as d, serializeOpenDocsProviders as f, DEFAULT_PROMPT_PROVIDER_TEMPLATES as i, serializeDocsIcon as l, DEFAULT_OPEN_DOCS_PROVIDER_IDS as n, parsePromptStringArray as o, remarkCodeGroup as p, DEFAULT_OPEN_DOCS_TARGET as r, resolvePromptProviderChoices as s, DEFAULT_OPEN_DOCS_PROMPT as t, serializeDocsIconRegistry as u };
+export { DEFAULT_OPEN_DOCS_PROMPT, DEFAULT_OPEN_DOCS_PROVIDER_IDS, DEFAULT_OPEN_DOCS_TARGET, DEFAULT_PROMPT_PROVIDER_TEMPLATES, normalizePromptProviderName, parsePromptStringArray, resolvePromptProviderChoices, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProvider, serializeOpenDocsProviders };

package/dist/reading-time.d.mts

@@ -0,0 +1,23 @@
+import { PageFrontmatter, ReadingTimeConfig, ReadingTimeFormat } from "./types.mjs";
+
+//#region src/reading-time.d.ts
+interface ResolvedReadingTimeOptions {
+  enabled: boolean;
+  wordsPerMinute?: number;
+  format: ReadingTimeFormat;
+  includeCode: boolean;
+}
+interface ReadingTimeEstimateOptions {
+  includeCode?: boolean;
+}
+declare function estimateReadingTimeMinutes(content: string, wordsPerMinute?: number, options?: ReadingTimeEstimateOptions): number;
+declare function resolveReadingTimeOptions(readingTime: boolean | ReadingTimeConfig | null | undefined): ResolvedReadingTimeOptions;
+declare function resolveReadingTimeFromContent(frontmatter: Partial<PageFrontmatter> | undefined, content: string, wordsPerMinute?: number, options?: ReadingTimeEstimateOptions): number | null;
+declare function resolvePageReadingTime(frontmatter: Partial<PageFrontmatter> | undefined, content: string, options?: {
+  enabledByDefault?: boolean;
+  wordsPerMinute?: number;
+  includeCode?: boolean;
+}): number | null | undefined;
+declare function resolveReadingTimeFromSource(source: string, wordsPerMinute?: number, options?: ReadingTimeEstimateOptions): number | null;
+//#endregion
+export { estimateReadingTimeMinutes, resolvePageReadingTime, resolveReadingTimeFromContent, resolveReadingTimeFromSource, resolveReadingTimeOptions };

package/dist/reading-time.mjs

@@ -0,0 +1,58 @@
+import matter from "gray-matter";
+
+//#region src/reading-time.ts
+function hasExplicitReadingTime(frontmatter) {
+	return Object.prototype.hasOwnProperty.call(frontmatter ?? {}, "readingTime");
+}
+function normalizeWordsPerMinute(wordsPerMinute) {
+	if (typeof wordsPerMinute !== "number" || !Number.isFinite(wordsPerMinute)) return 220;
+	return Math.max(1, Math.floor(wordsPerMinute));
+}
+function stripNonReadingContent(content, options) {
+	const includeCode = options?.includeCode === true;
+	return (includeCode ? content.replace(/^(`{3,}|~{3,})[^\n]*$/gm, " ").replace(/`([^`\n]+)`/g, " $1 ") : content.replace(/(`{3,})[^\n]*\n[\s\S]*?\1/g, " ").replace(/(~{3,})[^\n]*\n[\s\S]*?\1/g, " ").replace(/`[^`\n]+`/g, " ")).replace(/!\[[^\]]*\]\([^)]+\)/g, " ").replace(/\[([^\]]+)\]\([^)]+\)/g, " $1 ").replace(/<[^>]+>/g, " ").replace(includeCode ? /[{}]/g : /\{[^{}]*\}/g, " ").replace(/https?:\/\/\S+/g, " ").replace(/[#>*_~|]/g, " ");
+}
+function estimateReadingTimeMinutes(content, wordsPerMinute, options) {
+	const wordCount = stripNonReadingContent(content, options).match(/\b[\p{L}\p{N}][\p{L}\p{N}'’-]*\b/gu)?.length ?? 0;
+	return Math.max(1, Math.ceil(wordCount / normalizeWordsPerMinute(wordsPerMinute)));
+}
+function resolveReadingTimeOptions(readingTime) {
+	if (readingTime === true) return {
+		enabled: true,
+		format: "long",
+		includeCode: false
+	};
+	if (readingTime === false || readingTime === void 0 || readingTime === null) return {
+		enabled: false,
+		format: "long",
+		includeCode: false
+	};
+	if (typeof readingTime !== "object") return {
+		enabled: false,
+		format: "long",
+		includeCode: false
+	};
+	return {
+		enabled: readingTime.enabled === true,
+		wordsPerMinute: typeof readingTime.wordsPerMinute === "number" && Number.isFinite(readingTime.wordsPerMinute) ? readingTime.wordsPerMinute : void 0,
+		format: readingTime.format === "short" ? "short" : "long",
+		includeCode: readingTime.includeCode === true
+	};
+}
+function resolveReadingTimeFromContent(frontmatter, content, wordsPerMinute, options) {
+	const pageData = frontmatter ?? {};
+	if (pageData.readingTime === false) return null;
+	if (typeof pageData.readingTime === "number" && Number.isFinite(pageData.readingTime)) return Math.max(1, Math.ceil(pageData.readingTime));
+	return estimateReadingTimeMinutes(content, wordsPerMinute, options);
+}
+function resolvePageReadingTime(frontmatter, content, options) {
+	if (!(options?.enabledByDefault ?? false) && !hasExplicitReadingTime(frontmatter)) return;
+	return resolveReadingTimeFromContent(frontmatter, content, options?.wordsPerMinute, { includeCode: options?.includeCode });
+}
+function resolveReadingTimeFromSource(source, wordsPerMinute, options) {
+	const { data, content } = matter(source);
+	return resolveReadingTimeFromContent(data, content, wordsPerMinute, options);
+}
+
+//#endregion
+export { estimateReadingTimeMinutes, resolvePageReadingTime, resolveReadingTimeFromContent, resolveReadingTimeFromSource, resolveReadingTimeOptions };

package/dist/related.d.mts

@@ -0,0 +1,7 @@
+import { ResolvedDocsRelatedLink } from "./types.mjs";
+
+//#region src/related.d.ts
+declare function normalizeDocsRelated(value: unknown): ResolvedDocsRelatedLink[];
+declare function renderDocsRelatedMarkdownLines(related: ResolvedDocsRelatedLink[] | undefined): string[];
+//#endregion
+export { normalizeDocsRelated, renderDocsRelatedMarkdownLines };

package/dist/related.mjs

@@ -0,0 +1,50 @@
+//#region src/related.ts
+function normalizeDocsRelated(value) {
+	if (!Array.isArray(value)) return [];
+	const seen = /* @__PURE__ */ new Set();
+	const links = [];
+	for (const item of value) {
+		const parsed = parseRelatedInput(item);
+		if (!parsed) continue;
+		const dedupeKey = normalizeRelatedLookupPath(parsed.href) ?? parsed.href;
+		if (seen.has(dedupeKey)) continue;
+		seen.add(dedupeKey);
+		links.push({ href: parsed.href });
+	}
+	return links;
+}
+function renderDocsRelatedMarkdownLines(related) {
+	if (!related?.length) return [];
+	return [`Related: ${related.map((link) => normalizeInlineText(link.href)).join(", ")}`];
+}
+function parseRelatedInput(value) {
+	if (typeof value === "string") {
+		const href = cleanString(value);
+		return href ? { href } : null;
+	}
+	return null;
+}
+function cleanString(value) {
+	if (typeof value !== "string") return void 0;
+	return value.trim() || void 0;
+}
+function normalizeRelatedLookupPath(value) {
+	const trimmed = value.trim();
+	if (!trimmed) return null;
+	let pathname = trimmed;
+	try {
+		pathname = new URL(trimmed, "https://docs.local").pathname;
+	} catch {
+		pathname = trimmed.split(/[?#]/, 1)[0] ?? trimmed;
+	}
+	pathname = pathname.replace(/\/+/g, "/").replace(/\.md$/i, "");
+	if (!pathname.startsWith("/")) pathname = `/${pathname}`;
+	if (pathname !== "/") pathname = pathname.replace(/\/+$/, "");
+	return pathname;
+}
+function normalizeInlineText(value) {
+	return value.replace(/\s+/g, " ").trim();
+}
+
+//#endregion
+export { normalizeDocsRelated, renderDocsRelatedMarkdownLines };

package/dist/retrieval-digest.d.mts

@@ -0,0 +1,16 @@
+//#region src/retrieval-digest.d.ts
+/** Validate the bounded HTTP(S) URL or root-relative URI reference used by provenance. */
+declare function isDocsRetrievalCanonicalUrl(value: string): boolean;
+/** Hash exact bytes with portable SHA-256 in Node, edge, and browser runtimes. */
+declare function sha256DocsContent(value: string | Uint8Array): string;
+/** Hash exact message-content bytes with portable SHA-256. */
+declare function digestDocsContent(value: string | Uint8Array): `sha256:${string}`;
+/**
+ * Hash the normalized retrieval projection used by search provenance.
+ *
+ * The projection removes one leading BOM, normalizes line endings to LF, and trims
+ * trailing whitespace. This deliberately differs from HTTP digests over exact bytes.
+ */
+declare function digestDocsRetrievalContent(value: string): `sha256:${string}`;
+//#endregion
+export { digestDocsContent, digestDocsRetrievalContent, isDocsRetrievalCanonicalUrl, sha256DocsContent };

package/dist/{retrieval-digest-CT-eIEcp.mjs → retrieval-digest.mjs}

@@ -174,4 +174,4 @@ function digestDocsRetrievalContent(value) {
 }
 
 //#endregion
-export { sha256DocsContent as i, digestDocsRetrievalContent as n, isDocsRetrievalCanonicalUrl as r, digestDocsContent as t };
+export { digestDocsContent, digestDocsRetrievalContent, isDocsRetrievalCanonicalUrl, sha256DocsContent };

package/dist/review.d.mts

@@ -0,0 +1,69 @@
+import { DocsConfig, DocsReviewCiMode, DocsReviewConfig, DocsReviewRulesConfig } from "./types.mjs";
+
+//#region src/review.d.ts
+declare const DEFAULT_DOCS_REVIEW_WORKFLOW_PATH = ".github/workflows/docs-review.yml";
+declare const DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD = 80;
+interface ResolvedDocsReviewConfig {
+  enabled: boolean;
+  ci: {
+    enabled: boolean;
+    name: string;
+    mode: DocsReviewCiMode;
+    annotations: boolean;
+    comment: boolean;
+  };
+  score: {
+    threshold: number;
+    weights: {
+      error: number;
+      warn: number;
+      suggestion: number;
+    };
+  };
+  rules: Required<DocsReviewRulesConfig>;
+}
+interface DocsReviewWorkflowOptions {
+  packageManager?: "npm" | "pnpm" | "yarn" | "bun";
+  ciName?: string;
+  reusableWorkflow?: string;
+  pnpmVersion?: string;
+  projectDir?: string;
+  configPath?: string;
+  buildCommand?: string;
+  reviewCommand?: string;
+  pathFilters?: string[];
+}
+interface EnsureDocsReviewWorkflowOptions {
+  rootDir: string;
+  config?: DocsConfig;
+  configPath?: string;
+  configContent?: string;
+  workflowPath?: string;
+  log?: (message: string) => void;
+}
+type EnsureDocsReviewWorkflowResult = {
+  status: "created";
+  path: string;
+  relativePath: string;
+} | {
+  status: "exists";
+  path: string;
+  relativePath: string;
+} | {
+  status: "disabled";
+  path: string;
+  relativePath: string;
+};
+declare function resolveDocsReviewConfig(review?: boolean | DocsReviewConfig): ResolvedDocsReviewConfig;
+declare function buildDocsReviewWorkflow(options?: DocsReviewWorkflowOptions): string;
+declare function ensureDocsReviewWorkflow(options: EnsureDocsReviewWorkflowOptions): EnsureDocsReviewWorkflowResult;
+declare function readDocsReviewConfigFromSource(content?: string): boolean | DocsReviewConfig | undefined;
+declare function buildDocsReviewWorkflowPathFilters(options: {
+  rootDir: string;
+  repoRoot?: string;
+  config?: DocsConfig;
+  configPath?: string;
+  configContent?: string;
+}): string[];
+//#endregion
+export { DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD, DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, ResolvedDocsReviewConfig, buildDocsReviewWorkflow, buildDocsReviewWorkflowPathFilters, ensureDocsReviewWorkflow, readDocsReviewConfigFromSource, resolveDocsReviewConfig };