@farming-labs/docs 0.0.9-beta.1 → 0.0.10

package/dist/index.d.mts

@@ -962,6 +962,20 @@ interface OrderingItem {
   /** Ordering for child pages within this folder */
   children?: OrderingItem[];
 }
+/**
+ * Data passed to the `onCopyClick` callback when the user clicks the copy button
+ * on a code block in the docs.
+ */
+interface CodeBlockCopyData {
+  /** Title of the code block (e.g. from the fenced code block meta string), if present */
+  title?: string;
+  /** Raw code content (the text that was copied to the clipboard) */
+  content: string;
+  /** Current page URL at the time of copy */
+  url: string;
+  /** Language / syntax hint (e.g. "tsx", "bash"), if present */
+  language?: string;
+}
 interface DocsConfig {
   /** Entry folder for docs (e.g. "docs" → /docs) */
   entry: string;
@@ -1058,6 +1072,24 @@ interface DocsConfig {
    * ```
    */
   components?: Record<string, unknown>;
+  /**
+   * Callback fired when the user clicks the copy button on a code block.
+   * Called in addition to the default copy-to-clipboard behavior.
+   * Use it for analytics, logging, or custom behavior.
+   *
+   * @example
+   * ```ts
+   * export default defineDocs({
+   *   entry: "docs",
+   *   theme: fumadocs(),
+   *   onCopyClick(data) {
+   *     console.log("Code copied", data.title, data.language, data.url);
+   *     analytics.track("code_block_copy", { title: data.title, url: data.url });
+   *   },
+   * });
+   * ```
+   */
+  onCopyClick?: (data: CodeBlockCopyData) => void;
   /**
    * Icon registry for sidebar items.
    *
@@ -1282,4 +1314,4 @@ declare function resolveTitle(pageTitle: string, metadata?: DocsMetadata): strin
  */
 declare function resolveOGImage(page: PageFrontmatter, ogConfig?: OGConfig, baseUrl?: string): string | undefined;
 //#endregion
-export { type AIConfig, type BreadcrumbConfig, type CopyMarkdownConfig, type DocsConfig, type DocsMetadata, type DocsNav, type DocsTheme, type FontStyle, type GithubConfig, type LastUpdatedConfig, type LlmsTxtConfig, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, type OrderingItem, type PageActionsConfig, type PageFrontmatter, type SidebarComponentProps, type SidebarConfig, type SidebarFolderNode, type SidebarNode, type SidebarPageNode, type SidebarTree, type ThemeToggleConfig, type TypographyConfig, type UIConfig, createTheme, deepMerge, defineDocs, extendTheme, resolveOGImage, resolveTitle };
+export { type AIConfig, type BreadcrumbConfig, type CodeBlockCopyData, type CopyMarkdownConfig, type DocsConfig, type DocsMetadata, type DocsNav, type DocsTheme, type FontStyle, type GithubConfig, type LastUpdatedConfig, type LlmsTxtConfig, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, type OrderingItem, type PageActionsConfig, type PageFrontmatter, type SidebarComponentProps, type SidebarConfig, type SidebarFolderNode, type SidebarNode, type SidebarPageNode, type SidebarTree, type ThemeToggleConfig, type TypographyConfig, type UIConfig, createTheme, deepMerge, defineDocs, extendTheme, resolveOGImage, resolveTitle };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.0.9-beta.1",
+  "version": "0.0.10",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",