@fern-api/fern-api-dev 3.41.1 → 3.42.0

package/cli.cjs

@@ -1415659,7 +1415659,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "3.41.1",
+          version: "3.42.0",
           usingAccessToken: true
         }
       });
@@ -1415758,7 +1415758,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "3.41.1",
+        version: "3.42.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -1495949,7 +1495949,7 @@ var CliContext = class {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "3.41.1";
+    return "3.42.0";
   }
   getCliName() {
     if (false) {
@@ -1582513,7 +1582513,7 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
       link: async (value) => this.toLinkNode(value),
       changelog: async (value) => this.toChangelogNode(value, parentSlug),
       // Library sections are handled by FDR during registration, returning placeholder
-      pythonDocsSection: async () => this.toPythonDocsSectionPlaceholder(parentSlug)
+      pythonDocsSection: async (value) => this.toPythonDocsSectionPlaceholder(value, parentSlug)
     });
   }
   async toNavigationChild({ prefix: prefix2, item, parentSlug, hideChildren, parentAvailability }) {
@@ -1582524,7 +1582524,7 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
       link: async (value) => this.toLinkNode(value),
       changelog: async (value) => this.toChangelogNode(value, parentSlug, hideChildren),
       // Library sections are handled by FDR during registration, returning placeholder
-      pythonDocsSection: async () => this.toPythonDocsSectionPlaceholder(parentSlug)
+      pythonDocsSection: async (value) => this.toPythonDocsSectionPlaceholder(value, parentSlug)
     });
   }
   async toApiSectionNode({ item, parentSlug, hideChildren, parentAvailability }) {
@@ -1582642,28 +1582642,72 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
    * The CLI starts the generation job, polls for completion, and passes the jobId to FDR.
    * FDR then merges the generated Python docs into the navigation.
    *
-   * This placeholder returns a hidden section that will be replaced/augmented by FDR.
+   * In dev mode (fern docs dev), this placeholder returns a visible page with helpful content
+   * explaining that Python library docs are only generated during `fern generate --docs`.
+   *
+   * In production mode, FDR replaces/augments this with the actual generated documentation.
    */
-  toPythonDocsSectionPlaceholder(parentSlug) {
-    const slug = parentSlug.apply({ urlSlug: "python-docs", skipUrlSlug: true });
+  toPythonDocsSectionPlaceholder(item, parentSlug) {
+    const title5 = item.title ?? "Python Reference";
+    const urlSlug = item.slug ?? "python-docs";
+    const slug = parentSlug.apply({ urlSlug });
+    const syntheticPageId = `__python-docs-placeholder-${urlSlug}__.mdx`;
+    const pageId = navigation_exports2.PageId(syntheticPageId);
+    const placeholderMarkdown = `---
+title: ${title5}
+---
+
+<Warning>
+Python library documentation is not yet supported with \`fern docs dev\`. This feature will be added in a future release. To view the generated documentation, run \`fern generate --docs --preview\`.
+</Warning>
+
+## About Python Library Docs
+
+When you publish your documentation using \`fern generate --docs\`, Fern will:
+
+1. Clone and analyze your Python repository from: \`${item.githubUrl}\`
+2. Parse the Python source code to extract docstrings and type information
+3. Generate comprehensive API reference documentation
+4. Integrate the generated docs into your documentation site
+
+## How to Generate
+
+To generate the full Python library documentation, run:
+
+\`\`\`bash
+fern generate --docs
+\`\`\`
+
+Or to preview without publishing:
+
+\`\`\`bash
+fern generate --docs --preview
+\`\`\`
+
+The generated documentation will replace this placeholder page with complete API reference content including:
+
+- Module and package documentation
+- Class and function references
+- Type annotations and signatures
+- Docstring content
+`;
+    this.parsedDocsConfig.pages[RelativeFilePath2.of(syntheticPageId)] = placeholderMarkdown;
+    const id2 = this.#idgen.get(pageId);
     return {
-      type: "section",
-      id: this.#idgen.get("python-docs-placeholder"),
+      id: id2,
+      type: "page",
       slug: slug.get(),
-      title: "Python Reference",
-      collapsed: false,
-      hidden: true,
-      // Hidden - actual content comes from FDR
-      children: [],
-      overviewPageId: void 0,
+      title: title5,
       icon: void 0,
+      hidden: false,
       viewers: void 0,
       orphaned: void 0,
+      pageId,
       authed: void 0,
-      pointsTo: void 0,
-      availability: void 0,
+      noindex: true,
+      // Don't index placeholder pages
       featureFlags: void 0,
-      noindex: void 0
+      availability: void 0
     };
   }
   async toPageNode({ item, parentSlug, hideChildren, parentAvailability }) {
@@ -1591686,7 +1591730,7 @@ var import_path37 = __toESM(require("path"), 1);
 var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 function getCliSource() {
-  const version6 = "3.41.1";
+  const version6 = "3.42.0";
   return `cli@${version6}`;
 }
 var DebugLogger = class {

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "3.41.1",
+  "version": "3.42.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",