fix: replace referenced markdown (#4191)

* fix: replace referenced markdown

* add dry test

* fix

packages/cli/docs-resolver/src/DocsDefinitionResolver.ts

@@ -89,6 +89,10 @@ export class DocsDefinitionResolver {
                 absolutePathToMdx: this.resolveFilepath(relativePath),
                 context: this.taskContext
             });
+        }
+
+        // replaces all instances of <Code src="path/to/file.js" /> with the content of the referenced code file
+        for (const [relativePath, markdown] of Object.entries(this.parsedDocsConfig.pages)) {
             this.parsedDocsConfig.pages[RelativeFilePath.of(relativePath)] = await replaceReferencedCode({
                 markdown,
                 absolutePathToFernFolder: this.docsWorkspace.absoluteFilepath,

packages/cli/docs-resolver/src/__test__/__snapshots__/dry.test.ts.snap

@@ -0,0 +1,138 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`converts to api reference node 1`] = `
+"# Relative Path
+
+### Snippet
+
+Hello, I'm a snippet.
+
+
+\`\`\`js title="fibonacci.js"
+function fibonacci(num) {
+    let n1 = 0, n2 = 1, nextTerm;
+
+    console.log('Fibonacci Sequence:');
+    for (let i = 1; i <= num; i++) {
+        console.log(n1);
+        nextTerm = n1 + n2;
+        n1 = n2;
+        n2 = nextTerm;
+    }
+}
+
+// Example: Log the first 10 terms of the Fibonacci sequence
+fibonacci(10);
+
+\`\`\`
+
+
+# Relative Path 2
+
+### Snippet
+
+Hello, I'm a snippet.
+
+
+\`\`\`js title="fibonacci.js"
+function fibonacci(num) {
+    let n1 = 0, n2 = 1, nextTerm;
+
+    console.log('Fibonacci Sequence:');
+    for (let i = 1; i <= num; i++) {
+        console.log(n1);
+        nextTerm = n1 + n2;
+        n1 = n2;
+        n2 = nextTerm;
+    }
+}
+
+// Example: Log the first 10 terms of the Fibonacci sequence
+fibonacci(10);
+
+\`\`\`
+
+
+# Relative Path 3
+
+### Snippet
+
+Hello, I'm a snippet.
+
+
+\`\`\`js title="fibonacci.js"
+function fibonacci(num) {
+    let n1 = 0, n2 = 1, nextTerm;
+
+    console.log('Fibonacci Sequence:');
+    for (let i = 1; i <= num; i++) {
+        console.log(n1);
+        nextTerm = n1 + n2;
+        n1 = n2;
+        n2 = nextTerm;
+    }
+}
+
+// Example: Log the first 10 terms of the Fibonacci sequence
+fibonacci(10);
+
+\`\`\`
+
+
+# Absolute Path
+
+### Snippet
+
+Hello, I'm a snippet.
+
+
+\`\`\`js title="fibonacci.js"
+function fibonacci(num) {
+    let n1 = 0, n2 = 1, nextTerm;
+
+    console.log('Fibonacci Sequence:');
+    for (let i = 1; i <= num; i++) {
+        console.log(n1);
+        nextTerm = n1 + n2;
+        n1 = n2;
+        n2 = nextTerm;
+    }
+}
+
+// Example: Log the first 10 terms of the Fibonacci sequence
+fibonacci(10);
+
+\`\`\`
+
+
+# Indented
+
+<div>
+
+    ### Snippet
+    
+    Hello, I'm a snippet.
+    
+    
+    \`\`\`js title="fibonacci.js"
+    function fibonacci(num) {
+        let n1 = 0, n2 = 1, nextTerm;
+    
+        console.log('Fibonacci Sequence:');
+        for (let i = 1; i <= num; i++) {
+            console.log(n1);
+            nextTerm = n1 + n2;
+            n1 = n2;
+            n2 = nextTerm;
+        }
+    }
+    
+    // Example: Log the first 10 terms of the Fibonacci sequence
+    fibonacci(10);
+    
+    \`\`\`
+
+
+</div>
+"
+`;

packages/cli/docs-resolver/src/__test__/dry.test.ts

@@ -0,0 +1,32 @@
+import { docsYml } from "@fern-api/configuration";
+import { AbsoluteFilePath, resolve } from "@fern-api/fs-utils";
+import { createMockTaskContext } from "@fern-api/task-context";
+import { loadDocsWorkspace } from "@fern-api/workspace-loader";
+import { DocsDefinitionResolver } from "../DocsDefinitionResolver";
+
+const context = createMockTaskContext();
+
+it("converts to api reference node", async () => {
+    const docsWorkspace = await loadDocsWorkspace({
+        fernDirectory: resolve(AbsoluteFilePath.of(__dirname), "fixtures/dry/fern"),
+        context
+    });
+
+    if (docsWorkspace == null) {
+        throw new Error("Workspace is null");
+    }
+
+    const resolver = new DocsDefinitionResolver(
+        "domain",
+        docsWorkspace,
+        [],
+        context,
+        undefined,
+        async (_files) => [],
+        async (_opts) => ""
+    );
+
+    const resolved = await resolver.resolve();
+
+    expect(resolved.pages["page.mdx"]?.markdown).toMatchSnapshot();
+});

packages/cli/docs-resolver/src/__test__/fixtures/dry/fern/docs.yml

@@ -0,0 +1,4 @@
+instances: []
+navigation:
+  - page: Testing Page
+    path: ./page.mdx

packages/cli/docs-resolver/src/__test__/fixtures/dry/fern/fibonacci.js

@@ -0,0 +1,14 @@
+function fibonacci(num) {
+    let n1 = 0, n2 = 1, nextTerm;
+
+    console.log('Fibonacci Sequence:');
+    for (let i = 1; i <= num; i++) {
+        console.log(n1);
+        nextTerm = n1 + n2;
+        n1 = n2;
+        n2 = nextTerm;
+    }
+}
+
+// Example: Log the first 10 terms of the Fibonacci sequence
+fibonacci(10);

packages/cli/docs-resolver/src/__test__/fixtures/dry/fern/page.mdx

@@ -0,0 +1,33 @@
+# Relative Path
+
+<Markdown src="./snippet.md" />
+
+<Code src="./fibonacci.js" />
+
+# Relative Path 2
+
+<Markdown src="snippet.md" />
+
+<Code src="fibonacci.js" />
+
+# Relative Path 3
+
+<Markdown src="../fern/snippet.md" />
+
+<Code src="../fern/fibonacci.js" />
+
+# Absolute Path
+
+<Markdown src="/snippet.md" />
+
+<Code src="/fibonacci.js" />
+
+# Indented
+
+<div>
+
+    <Markdown src="./snippet.md" />
+
+    <Code src="./fibonacci.js" />
+
+</div>

packages/cli/docs-resolver/src/__test__/fixtures/dry/fern/snippet.md

@@ -0,0 +1,3 @@
+### Snippet
+
+Hello, I'm a snippet.