@fern-api/fern-api-dev 5.23.3-1507-g3fdf51652f8 → 5.23.3-1514-g653125ed301

package/cli.cjs

@@ -691149,7 +691149,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.23.3-1507-g3fdf51652f8",
+          version: "5.23.3-1514-g653125ed301",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -691215,7 +691215,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.23.3-1507-g3fdf51652f8",
+        version: "5.23.3-1514-g653125ed301",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -872320,7 +872320,7 @@ var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 var MAX_LOGS_DIR_SIZE_BYTES = 100 * 1024 * 1024;
 function getCliSource() {
-  const version7 = "5.23.3-1507-g3fdf51652f8";
+  const version7 = "5.23.3-1514-g653125ed301";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -875598,6 +875598,8 @@ var SnippetDependencyTracker = class {
   snippetToPages = /* @__PURE__ */ new Map();
   // Map: page file path -> Set of snippet files it references
   pageToSnippets = /* @__PURE__ */ new Map();
+  // Whether a full scan has populated the maps at least once.
+  hasBuiltInitialMap = false;
   constructor(context3) {
     this.context = context3;
   }
@@ -875643,21 +875645,77 @@ var SnippetDependencyTracker = class {
           const content5 = await (0, import_promises101.readFile)(markdownFile, "utf-8");
           const referencedFiles = this.extractReferences(content5, markdownFile, docsWorkspace.absoluteFilePath);
           this.pageToSnippets.set(markdownFile, referencedFiles);
-          for (const referencedFile of referencedFiles) {
-            if (!this.snippetToPages.has(referencedFile)) {
-              this.snippetToPages.set(referencedFile, /* @__PURE__ */ new Set());
-            }
-            this.snippetToPages.get(referencedFile)?.add(markdownFile);
-          }
         } catch (error50) {
           this.context.logger.debug(`Failed to read markdown file ${markdownFile}: ${error50}`);
         }
       }
+      this.rebuildReverseMap();
+      this.hasBuiltInitialMap = true;
       this.context.logger.debug(`Built dependency map: ${this.snippetToPages.size} snippets, ${this.pageToSnippets.size} pages`);
     } catch (error50) {
       this.context.logger.debug(`Failed to build dependency map: ${error50}`);
     }
   }
+  /**
+   * Incrementally updates the dependency maps for a set of changed markdown files,
+   * avoiding a full re-scan of every page in the workspace.
+   *
+   * Only content-only (`.md`/`.mdx`) reloads take this path. For each changed file we
+   * re-read it and recompute its outgoing references (the page -> snippets forward
+   * edge); deleted files are dropped. We then rebuild the snippet -> pages reverse
+   * map from the forward map in memory (no disk I/O), so the reverse map is always
+   * fully consistent with the forward map and can never accumulate stale edges.
+   *
+   * Reloads never overlap (the watcher handler serializes them behind `isReloading`),
+   * so these mutations are not subject to concurrent access. Falls back to a full
+   * scan if an initial map has not been built yet.
+   */
+  async updateDependencyMapForFiles(changedFiles, project) {
+    const docsWorkspace = project.docsWorkspaces;
+    if (!docsWorkspace) {
+      return;
+    }
+    if (!this.hasBuiltInitialMap) {
+      await this.buildDependencyMap(project);
+      return;
+    }
+    for (const changedFile of changedFiles) {
+      const lower = changedFile.toLowerCase();
+      if (!lower.endsWith(".md") && !lower.endsWith(".mdx")) {
+        continue;
+      }
+      if (!await doesPathExist(changedFile)) {
+        this.pageToSnippets.delete(changedFile);
+        continue;
+      }
+      try {
+        const content5 = await (0, import_promises101.readFile)(changedFile, "utf-8");
+        const referencedFiles = this.extractReferences(content5, changedFile, docsWorkspace.absoluteFilePath);
+        this.pageToSnippets.set(changedFile, referencedFiles);
+      } catch (error50) {
+        this.context.logger.debug(`Failed to read markdown file ${changedFile}: ${error50}`);
+        this.pageToSnippets.delete(changedFile);
+      }
+    }
+    this.rebuildReverseMap();
+  }
+  /**
+   * Rebuilds the snippet -> pages (reverse) map from the page -> snippets (forward)
+   * map. A pure in-memory transformation, so it can never leave stale reverse edges.
+   */
+  rebuildReverseMap() {
+    this.snippetToPages.clear();
+    for (const [page, references] of this.pageToSnippets) {
+      for (const reference4 of references) {
+        let pages = this.snippetToPages.get(reference4);
+        if (pages == null) {
+          pages = /* @__PURE__ */ new Set();
+          this.snippetToPages.set(reference4, pages);
+        }
+        pages.add(page);
+      }
+    }
+  }
   /**
    * Find all markdown files in the docs workspace directory
    */
@@ -876078,10 +876136,16 @@ async function runAppPreviewServer({ initialProject, reloadProject, validateProj
     context3.logger.info("Reloading docs...");
     const startTime = Date.now();
     void debugLogger.logCliReloadStart();
+    const contentOnlyEdit = isContentOnlyEdit(editedAbsoluteFilepaths2);
     try {
-      project = await reloadProject();
-      await snippetTracker.buildDependencyMap(project);
-      if (!isContentOnlyEdit(editedAbsoluteFilepaths2)) {
+      if (contentOnlyEdit) {
+        context3.logger.debug("Content-only edit; reusing loaded project (skipping full reload).");
+        await snippetTracker.updateDependencyMapForFiles(editedAbsoluteFilepaths2 ?? [], project);
+      } else {
+        project = await reloadProject();
+        await snippetTracker.buildDependencyMap(project);
+      }
+      if (!contentOnlyEdit) {
         const validationStartTime = Date.now();
         void validateProject(project).then(() => {
           const validationTime = Date.now() - validationStartTime;
@@ -904909,7 +904973,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.23.3-1507-g3fdf51652f8",
+        cliVersion: "5.23.3-1514-g653125ed301",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -952132,13 +952196,15 @@ var ComputedProperty = class extends AstNode8 {
 var DocComment2 = class _DocComment extends AstNode8 {
   summary;
   description;
+  codeExample;
   parameters;
   returns;
   throws;
-  constructor({ summary, description, parameters: parameters2, returns, throws }) {
+  constructor({ summary, description, codeExample, parameters: parameters2, returns, throws }) {
     super();
-    this.summary = _DocComment.sanitizeText(summary);
+    this.summary = summary != null ? _DocComment.sanitizeText(summary) : void 0;
     this.description = description != null ? _DocComment.sanitizeText(description) : void 0;
+    this.codeExample = codeExample != null ? _DocComment.sanitizeText(codeExample) : void 0;
     this.parameters = (parameters2 ?? []).map((param) => ({
       name: param.name,
       description: _DocComment.sanitizeText(param.description)
@@ -952147,15 +952213,34 @@ var DocComment2 = class _DocComment extends AstNode8 {
     this.throws = (throws ?? []).map((t3) => _DocComment.sanitizeText(t3));
   }
   write(writer2) {
-    this.writeMultilineText(writer2, this.summary);
+    let hasPrecedingSection = false;
+    if (this.summary != null) {
+      this.writeMultilineText(writer2, this.summary);
+      hasPrecedingSection = true;
+    }
     if (this.description != null) {
-      writer2.write("///");
-      writer2.newLine();
+      if (hasPrecedingSection) {
+        writer2.write("///");
+        writer2.newLine();
+      }
       this.writeMultilineText(writer2, this.description);
+      hasPrecedingSection = true;
+    }
+    if (this.codeExample != null) {
+      if (hasPrecedingSection) {
+        writer2.write("///");
+        writer2.newLine();
+      }
+      this.writeMultilineText(writer2, `\`\`\`swift
+${this.codeExample}
+\`\`\``);
+      hasPrecedingSection = true;
     }
     if (this.parameters.length > 0) {
-      writer2.write("///");
-      writer2.newLine();
+      if (hasPrecedingSection) {
+        writer2.write("///");
+        writer2.newLine();
+      }
       for (const param of this.parameters) {
         const paramLines = param.description.split("\n");
         paramLines.forEach((line, lineIdx) => {
@@ -952204,8 +952289,12 @@ var DocComment2 = class _DocComment extends AstNode8 {
   writeMultilineText(writer2, sanitizedText) {
     const lines = sanitizedText.split("\n");
     for (const line of lines) {
-      writer2.write("/// ");
-      writer2.write(line);
+      if (line === "") {
+        writer2.write("///");
+      } else {
+        writer2.write("/// ");
+        writer2.write(line);
+      }
       writer2.newLine();
     }
   }
@@ -971797,7 +971886,7 @@ function getAutomationContextFromEnv() {
     config_branch: process.env.FERN_CONFIG_BRANCH,
     config_pr_number: process.env.FERN_CONFIG_PR_NUMBER,
     trigger: process.env.GITHUB_EVENT_NAME,
-    cli_version: "5.23.3-1507-g3fdf51652f8"
+    cli_version: "5.23.3-1514-g653125ed301"
   };
 }
 function isAutomationMode() {
@@ -972629,7 +972718,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.23.3-1507-g3fdf51652f8";
+    return "5.23.3-1514-g653125ed301";
   }
   getCliName() {
     if (false) {

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "5.23.3-1507-g3fdf51652f8",
+  "version": "5.23.3-1514-g653125ed301",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",