@farming-labs/docs 0.2.120 → 0.2.121

package/dist/{audience-exposure-DBrFWULA.d.mts → audience-exposure.d.mts}

@@ -4,4 +4,4 @@ type DocsContentAudience = "human" | "agent";
 /** Resolve whether content with an optional audience restriction is visible. */
 declare function resolveDocsAudienceExposure(only: unknown, audience: DocsContentAudience): boolean;
 //#endregion
-export { resolveDocsAudienceExposure as n, DocsContentAudience as t };
+export { DocsContentAudience, resolveDocsAudienceExposure };

package/dist/audience-exposure.mjs

@@ -0,0 +1,8 @@
+//#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 };

package/dist/audience.d.mts

@@ -0,0 +1,44 @@
+import { DocsContentAudience, resolveDocsAudienceExposure } from "./audience-exposure.mjs";
+
+//#region src/audience.d.ts
+interface DocsMarkdownPromptBlock {
+  /** Raw JSX attributes between the Prompt name and opening bracket. */
+  attributes: string;
+  /** Literal source between the Prompt tags, with enclosing Markdown container prefixes removed. */
+  children: string;
+  /** Collision-safe placeholder carried through document-level rendering. */
+  token: string;
+}
+interface ExtractedDocsMarkdownPromptBlocks {
+  blocks: DocsMarkdownPromptBlock[];
+  markdown: string;
+}
+interface DocsAudienceMdxIssue {
+  code: "missing-only" | "invalid-only" | "dynamic-only" | "ignored-agent-only" | "ignored-human-only";
+  index: number;
+  message: string;
+}
+/**
+ * Extract live MDX Prompt blocks while leaving Markdown literals untouched.
+ *
+ * Prompt bodies are copyable source, so callers can safely run audience,
+ * reference-definition, and heading passes over `markdown`, then restore each
+ * block from its token. Fences (including container fences), inline code, links,
+ * comments, raw elements, and other literal contexts are never extracted.
+ */
+declare function extractDocsMarkdownPromptBlocks(content: string): ExtractedDocsMarkdownPromptBlocks;
+/** Find audience declarations that cannot be projected consistently at build time. */
+declare function findDocsAudienceMdxIssues(content: string): DocsAudienceMdxIssue[];
+/**
+ * Resolve MDX into its human or agent projection.
+ *
+ * `<Agent>` is shorthand for `<Audience only="agent">`, while `<Human>` is
+ * shorthand for `<Audience only="human">`. Unknown `Audience.only` values are
+ * treated as shared content so an authoring typo never silently deletes content.
+ * These primitives shape content for each surface; they are not an access-control boundary.
+ */
+declare function resolveDocsAudienceMdxContent(content: string, audience: DocsContentAudience): string;
+/** Backwards-compatible name retained for existing integrations. */
+declare function resolveDocsAgentMdxContent(content: string, audience: DocsContentAudience): string;
+//#endregion
+export { DocsAudienceMdxIssue, DocsMarkdownPromptBlock, ExtractedDocsMarkdownPromptBlocks, extractDocsMarkdownPromptBlocks, findDocsAudienceMdxIssues, resolveDocsAgentMdxContent, resolveDocsAudienceMdxContent };